@feltmaps/js-sdk 1.5.0-next.15 → 1.5.0-next.16

package/dist/{types-PSY3LPGC.d.cts → types-C0CJJN-7.d.cts}

@@ -14,21 +14,314 @@ type zInfer<T extends {
     shape: ZodRawShape;
 }> = objectOutputType<T["shape"], ZodTypeAny, "strip">;
 
-declare const PlaceCreateSchema: z.ZodObject<Omit<{
-    symbol: z.ZodOptional<z.ZodString>;
-    type: z.ZodLiteral<"Place">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+/**
+ * Represents a point in world coordinates.
+ */
+interface LatLng {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * A tuple representing a longitude and latitude coordinate.
+ *
+ * This is used hen serializing geometry because that's the standard used in
+ * GeoJSON.
+ */
+type LngLatTuple = [longitude: number, latitude: number];
+/**
+ * A GeoJSON properties object.
+ */
+type GeoJsonProperties = Record<string, unknown>;
+/**
+ * A GeoJSON feature object, compliant with:
+ * https://datatracker.ietf.org/doc/html/rfc7946#section-3.2
+ *
+ * @interface
+ */
+type GeoJsonFeature = {
+    type: "Feature";
+    /**
+     * The bounding box of the feature in [west, south, east, north] order.
+     */
+    bbox?: FeltBoundary;
+    /**
+     * The feature's geometry
+     */
+    geometry: GeoJsonGeometry;
+    /**
+     * A value that uniquely identifies this feature in a
+     * https://tools.ietf.org/html/rfc7946#section-3.2.
+     */
+    id?: string | number | undefined;
+    /**
+     * Properties associated with this feature.
+     */
+    properties: GeoJsonProperties;
+};
+interface PointGeometry {
+    type: "Point";
+    coordinates: LngLatTuple;
+}
+/**
+ * A GeoJSON multi-point geometry.
+ *
+ * @remarks
+ * You shouldn't expect this to come from Felt - it is here for completeness
+ * of the GeoJSON spec.
+ */
+interface MultiPointGeometry {
+    type: "MultiPoint";
+    coordinates: PointGeometry["coordinates"][];
+}
+interface PolygonGeometry extends zInfer<typeof PolygonGeometrySchema> {
+}
+/**
+ * A GeoJSON polygon geometry.
+ */
+declare const PolygonGeometrySchema: z.ZodObject<{
+    type: z.ZodLiteral<"Polygon">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "Polygon";
+    coordinates: [number, number][][];
+}, {
+    type: "Polygon";
+    coordinates: [number, number][][];
+}>;
+/**
+ * A GeoJSON multi-polygon geometry.
+ *
+ * @interface
+ */
+type MultiPolygonGeometry = {
+    type: "MultiPolygon";
+    coordinates: PolygonGeometry["coordinates"][];
+};
+/**
+ * A GeoJSON line string geometry.
+ *
+ * @interface
+ */
+type LineStringGeometry = {
+    type: "LineString";
+    coordinates: LngLatTuple[];
+};
+/**
+ * A GeoJSON multi-line string geometry.
+ *
+ * @interface
+ */
+type MultiLineStringGeometry = {
+    type: "MultiLineString";
+    coordinates: LineStringGeometry["coordinates"][];
+};
+/**
+ * A GeoJSON geometry of any type
+ */
+type GeoJsonGeometry = PointGeometry | PolygonGeometry | LineStringGeometry | MultiLineStringGeometry | MultiPolygonGeometry | MultiPointGeometry;
+/**
+ * @ignore
+ * @internal
+ */
+declare const FeltZoomSchema: z.ZodNumber;
+/**
+ * The zoom level of the map.
+ *
+ * It is a floating-point number between 1 and 23, where 1 is the most
+ * zoomed out and 23 is the most zoomed in.
+ *
+ * @group Types
+ * @public
+ */
+type FeltZoom = z.infer<typeof FeltZoomSchema>;
+/**
+ * @ignore
+ * @internal
+ */
+declare const FeltBoundarySchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+/**
+ * The edges of the map in the form of a bounding box.
+ *
+ * The boundary is a tuple of the form `[west, south, east, north]`.
+ *
+ * @group Types
+ * @public
+ */
+type FeltBoundary = z.infer<typeof FeltBoundarySchema>;
+/**
+ * The parameters for the methods that change the visibility of entities.
+ *
+ * @public
+ * @category Visibility
+ */
+interface SetVisibilityRequest extends zInfer<typeof SetVisibilityRequestSchema> {
+}
+/**
+ * @internal
+ */
+declare const SetVisibilityRequestSchema: z.ZodObject<{
+    /**
+     * The ids of the entities you want to change the visibility of.
+     */
+    show: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    hide: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    show?: string[] | undefined;
+    hide?: string[] | undefined;
+}, {
+    show?: string[] | undefined;
+    hide?: string[] | undefined;
+}>;
+/**
+ * Specifies the direction to sort data in
+ *
+ * @group Types
+ */
+type SortDirection = z.infer<typeof SortDirectionSchema>;
+/** @ignore */
+declare const SortDirectionSchema: z.ZodEnum<["asc", "desc"]>;
+/**
+ * Configuration for sorting data by a specific attribute
+ *
+ * @group Types
+ */
+interface SortConfig extends zInfer<typeof SortConfigSchema> {
+    direction: SortDirection;
+}
+/** @ignore */
+declare const SortConfigSchema: z.ZodObject<{
+    /**
+     * The attribute to sort by. What this represents depends on the context.
+     * For instance, when sorting features in a data table, the attribute is
+     * the column to sort by.
+     */
+    attribute: z.ZodString;
+    /**
+     * The direction to sort in
+     */
+    direction: z.ZodEnum<["asc", "desc"]>;
+}, "strip", z.ZodTypeAny, {
+    attribute: string;
+    direction: "asc" | "desc";
+}, {
+    attribute: string;
+    direction: "asc" | "desc";
+}>;
+
+declare const PlaceCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodLiteral<"Place">>;
+    coordinates: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    symbol: z.ZodOptional<z.ZodString>;
     frame: z.ZodOptional<z.ZodNullable<z.ZodEnum<["frame-circle", "frame-square"]>>>;
     hideLabel: z.ZodOptional<z.ZodBoolean>;
-}, "id">, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    type: z.ZodLiteral<"Place">;
+    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The symbol that is rendered for the Place.
+     *
+     * This can be an emoji by using colon-enclosed characters (e.g. `":smiley:"`)
+     * or one of the symbols available in Felt's symbol library.
+     *
+     * You can see the available symbols in the Felt UI when editing a Place
+     * by hovering a symbol and converting the tooltip to kebab-case. For example,
+     * the "Oil barrel" symbol is `oil-barrel`.
+     */
+    symbol: z.ZodString;
+    /**
+     * The frame that is rendered around the Place's symbol. This is
+     * only available for non-emoji symbols.
+     */
+    frame: z.ZodNullable<z.ZodEnum<["frame-circle", "frame-square"]>>;
+    /**
+     * Whether the element's label is hidden on the map. This allows you
+     * to add a name to the element and can show in popups, but not have
+     * it visible on the map.
+     *
+     * This will also hide the faint placeholder label that is shown when
+     * an editable Place is selected.
+     *
+     * @default false
+     */
+    hideLabel: z.ZodBoolean;
+}>, "type" | "coordinates">>, "id">, "strip", z.ZodTypeAny, {
     type: "Place";
     coordinates: [number, number];
     symbol?: string | undefined;
@@ -55,24 +348,138 @@ declare const PlaceCreateSchema: z.ZodObject<Omit<{
     frame?: "frame-circle" | "frame-square" | null | undefined;
     hideLabel?: boolean | undefined;
 }>;
-declare const PathCreateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Path">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const PathCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     strokeOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     strokeStyle: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+    type: z.ZodOptional<z.ZodLiteral<"Path">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     distanceMarker: z.ZodOptional<z.ZodBoolean>;
-    endCaps: z.ZodOptional<z.ZodBoolean>;
     routingMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<["driving", "cycling", "walking", "flying"]>>>;
-}, "id">, "strip", z.ZodTypeAny, {
+    endCaps: z.ZodOptional<z.ZodBoolean>;
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
+    strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
+    strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
+    strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
+}>, {
+    type: z.ZodLiteral<"Path">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * Whether a distance marker is shown at the midpoint of the path.
+     *
+     * @default false
+     */
+    distanceMarker: z.ZodBoolean;
+    /**
+     * Whether this represents a route, and if so, what mode of transport
+     * is used.
+     *
+     * If this is `null`, the path is not considered to be a route, so while it
+     * can have a `distanceMarker`, it will does not have a start or end cap.
+     *
+     * @default null
+     */
+    routingMode: z.ZodNullable<z.ZodEnum<["driving", "cycling", "walking", "flying"]>>;
+    /**
+     * Whether or not to show Start and End caps on the path. This is
+     * only available if the `routingMode` is set.
+     *
+     * @default false
+     */
+    endCaps: z.ZodBoolean;
+}>, "type" | "coordinates">>, "id">, "strip", z.ZodTypeAny, {
     type: "Path";
     coordinates: [number, number][][];
     groupId?: string | null | undefined;
@@ -86,8 +493,8 @@ declare const PathCreateSchema: z.ZodObject<Omit<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     distanceMarker?: boolean | undefined;
-    endCaps?: boolean | undefined;
     routingMode?: "driving" | "cycling" | "walking" | "flying" | null | undefined;
+    endCaps?: boolean | undefined;
 }, {
     type: "Path";
     coordinates: [number, number][][];
@@ -102,26 +509,129 @@ declare const PathCreateSchema: z.ZodObject<Omit<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     distanceMarker?: boolean | undefined;
-    endCaps?: boolean | undefined;
     routingMode?: "driving" | "cycling" | "walking" | "flying" | null | undefined;
+    endCaps?: boolean | undefined;
 }>;
-declare const PolygonCreateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const PolygonCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     strokeOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     strokeStyle: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+    type: z.ZodOptional<z.ZodLiteral<"Polygon">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     fillOpacity: z.ZodOptional<z.ZodNumber>;
     areaMarker: z.ZodOptional<z.ZodBoolean>;
-}, "id">, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
+    strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
+    strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
+    strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
+}>, {
+    type: z.ZodLiteral<"Polygon">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The opacity of the polygon's fill, between 0 and 1.
+     *
+     * @default 0.25
+     */
+    fillOpacity: z.ZodNumber;
+    /**
+     * Whether to show an area marker on the polygon.
+     *
+     * @default false
+     */
+    areaMarker: z.ZodBoolean;
+}>, "type" | "coordinates">>, "id">, "strip", z.ZodTypeAny, {
     type: "Polygon";
     coordinates: [number, number][][];
     groupId?: string | null | undefined;
@@ -152,28 +662,155 @@ declare const PolygonCreateSchema: z.ZodObject<Omit<{
     fillOpacity?: number | undefined;
     areaMarker?: boolean | undefined;
 }>;
-declare const CircleCreateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Circle">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+declare const CircleCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     strokeOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     strokeStyle: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
-    fillOpacity: z.ZodOptional<z.ZodNumber>;
-    radius: z.ZodNumber;
+    type: z.ZodOptional<z.ZodLiteral<"Circle">>;
+    center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    radius: z.ZodOptional<z.ZodNumber>;
+    radiusMarker: z.ZodOptional<z.ZodBoolean>;
     radiusDisplayAngle: z.ZodOptional<z.ZodNumber>;
     radiusDisplayUnit: z.ZodOptional<z.ZodNullable<z.ZodEnum<["meter", "kilometer", "foot", "mile"]>>>;
-    radiusMarker: z.ZodOptional<z.ZodBoolean>;
-}, "id">, "strip", z.ZodTypeAny, {
+    fillOpacity: z.ZodOptional<z.ZodNumber>;
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
+    strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
+    strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
+    strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
+}>, {
+    type: z.ZodLiteral<"Circle">;
+    /**
+     * The center of the circle.
+     */
+    center: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The radius of the circle in meters.
+     */
+    radius: z.ZodNumber;
+    /**
+     * Whether to show a marker on the circle that indicates the radius
+     *
+     * @default false
+     */
+    radiusMarker: z.ZodBoolean;
+    /**
+     * The angle at which the control point for setting the radius is displayed,
+     * in degrees. When the `radiusMarker` is `true`, there is a dotted line rendered
+     * from the center of the circle to the control point, and the marker is shown
+     * at the midpoint of this line.
+     *
+     * @default 90
+     */
+    radiusDisplayAngle: z.ZodNumber;
+    /**
+     * The unit of the radius used when the `radiusMarker` is `true`.
+     *
+     * A value of `null` means that the unit matches the user's locale.
+     *
+     * @default null
+     */
+    radiusDisplayUnit: z.ZodNullable<z.ZodEnum<["meter", "kilometer", "foot", "mile"]>>;
+    /**
+     * The opacity of the circle's fill.
+     *
+     * @default 0.25
+     */
+    fillOpacity: z.ZodNumber;
+}>, "type" | "center" | "radius">>, "id">, "strip", z.ZodTypeAny, {
     type: "Circle";
-    coordinates: [number, number];
+    center: [number, number];
     radius: number;
     groupId?: string | null | undefined;
     color?: string | undefined;
@@ -186,12 +823,12 @@ declare const CircleCreateSchema: z.ZodObject<Omit<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     fillOpacity?: number | undefined;
+    radiusMarker?: boolean | undefined;
     radiusDisplayAngle?: number | undefined;
     radiusDisplayUnit?: "meter" | "kilometer" | "foot" | "mile" | null | undefined;
-    radiusMarker?: boolean | undefined;
 }, {
     type: "Circle";
-    coordinates: [number, number];
+    center: [number, number];
     radius: number;
     groupId?: string | null | undefined;
     color?: string | undefined;
@@ -204,24 +841,112 @@ declare const CircleCreateSchema: z.ZodObject<Omit<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     fillOpacity?: number | undefined;
+    radiusMarker?: boolean | undefined;
     radiusDisplayAngle?: number | undefined;
     radiusDisplayUnit?: "meter" | "kilometer" | "foot" | "mile" | null | undefined;
-    radiusMarker?: boolean | undefined;
 }>;
-declare const MarkerCreateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Marker">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const MarkerCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
+    type: z.ZodOptional<z.ZodLiteral<"Marker">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     opacity: z.ZodOptional<z.ZodNumber>;
     size: z.ZodOptional<z.ZodNumber>;
     zoom: z.ZodOptional<z.ZodNumber>;
-}, "id">, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    type: z.ZodLiteral<"Marker">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The opacity of the marker, between 0 and 1.
+     *
+     * @default 1
+     */
+    opacity: z.ZodNumber;
+    /**
+     * The size of the marker, used in conjunction with the `zoom` to determine
+     * the actual size of the marker.
+     *
+     * @default 10
+     */
+    size: z.ZodNumber;
+    /**
+     * The zoom level at which the marker was created. This is combined with
+     * the `size` to determine the actual size of the marker.
+     *
+     * When creating a marker, if you don't supply this value it defaults to
+     * the current zoom of the map when you call `createElement`.
+     */
+    zoom: z.ZodNumber;
+}>, "type" | "coordinates">>, "id">, "strip", z.ZodTypeAny, {
     type: "Marker";
     coordinates: [number, number][][];
     groupId?: string | null | undefined;
@@ -246,20 +971,106 @@ declare const MarkerCreateSchema: z.ZodObject<Omit<{
     size?: number | undefined;
     zoom?: number | undefined;
 }>;
-declare const HighlighterCreateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Highlighter">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const HighlighterCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
+    type: z.ZodOptional<z.ZodLiteral<"Highlighter">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">, "many">>;
+    renderHoles: z.ZodOptional<z.ZodBoolean>;
     opacity: z.ZodOptional<z.ZodNumber>;
-}, "id">, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    type: z.ZodLiteral<"Highlighter">;
+    /**
+     * A multipolygon describing the area that is highlighted.
+     *
+     * If `renderHoles` is set to false, only the outer ring of each polygon
+     * will be rendered, filling in the area inside the highlighted region.
+     */
+    coordinates: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">, "many">;
+    /**
+     * Whether to render the holes of the highlighted area.
+     *
+     * @default false
+     */
+    renderHoles: z.ZodBoolean;
+    /**
+     * The opacity of the highlighter, between 0 and 1.
+     *
+     * @default 0.5
+     */
+    opacity: z.ZodNumber;
+}>, "type" | "coordinates">>, "id">, "strip", z.ZodTypeAny, {
     type: "Highlighter";
-    coordinates: [number, number][][];
+    coordinates: [number, number][][][];
     groupId?: string | null | undefined;
     color?: string | undefined;
     name?: string | null | undefined;
@@ -267,9 +1078,10 @@ declare const HighlighterCreateSchema: z.ZodObject<Omit<{
     attributes?: Record<string, unknown> | undefined;
     interaction?: "default" | "locked" | undefined;
     opacity?: number | undefined;
+    renderHoles?: boolean | undefined;
 }, {
     type: "Highlighter";
-    coordinates: [number, number][][];
+    coordinates: [number, number][][][];
     groupId?: string | null | undefined;
     color?: string | undefined;
     name?: string | null | undefined;
@@ -277,25 +1089,29 @@ declare const HighlighterCreateSchema: z.ZodObject<Omit<{
     attributes?: Record<string, unknown> | undefined;
     interaction?: "default" | "locked" | undefined;
     opacity?: number | undefined;
+    renderHoles?: boolean | undefined;
 }>;
-declare const TextCreateSchema: z.ZodObject<Omit<Omit<{
-    type: z.ZodLiteral<"Text">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const TextCreateSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
-    zoom: z.ZodOptional<z.ZodNumber>;
     position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     rotation: z.ZodOptional<z.ZodNumber>;
     scale: z.ZodOptional<z.ZodNumber>;
-    text: z.ZodString;
+    zoom: z.ZodOptional<z.ZodNumber>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
+    text: z.ZodOptional<z.ZodString>;
     align: z.ZodOptional<z.ZodEnum<["left", "center", "right"]>>;
     style: z.ZodOptional<z.ZodEnum<["italic", "light", "regular", "caps"]>>;
-}, "id">, "coordinates" | "name">, "strip", z.ZodTypeAny, {
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodLiteral<"Text">>;
+}, "type" | "coordinates" | "id" | "name">, {
+    type: z.ZodLiteral<"Text">;
+    text: z.ZodString;
+}>, "strip", z.ZodTypeAny, {
     type: "Text";
     text: string;
     groupId?: string | null | undefined;
@@ -307,7 +1123,7 @@ declare const TextCreateSchema: z.ZodObject<Omit<Omit<{
     position?: [number, number] | undefined;
     rotation?: number | undefined;
     scale?: number | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
 }, {
     type: "Text";
@@ -321,28 +1137,31 @@ declare const TextCreateSchema: z.ZodObject<Omit<Omit<{
     position?: [number, number] | undefined;
     rotation?: number | undefined;
     scale?: number | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
 }>;
-declare const NoteCreateSchema: z.ZodObject<Omit<Omit<{
-    type: z.ZodLiteral<"Note">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const NoteCreateSchema: z.ZodObject<z.objectUtil.extendShape<Omit<{
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
-    zoom: z.ZodOptional<z.ZodNumber>;
     position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     rotation: z.ZodOptional<z.ZodNumber>;
     scale: z.ZodOptional<z.ZodNumber>;
-    text: z.ZodString;
+    zoom: z.ZodOptional<z.ZodNumber>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
+    text: z.ZodOptional<z.ZodString>;
     align: z.ZodOptional<z.ZodEnum<["left", "center", "right"]>>;
     style: z.ZodOptional<z.ZodEnum<["italic", "light", "regular", "caps"]>>;
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodLiteral<"Note">>;
     widthScale: z.ZodOptional<z.ZodNumber>;
-}, "id">, "coordinates" | "name">, "strip", z.ZodTypeAny, {
+}, "type" | "coordinates" | "id" | "name">, {
+    type: z.ZodLiteral<"Note">;
+    text: z.ZodString;
+}>, "strip", z.ZodTypeAny, {
     type: "Note";
     text: string;
     groupId?: string | null | undefined;
@@ -354,7 +1173,7 @@ declare const NoteCreateSchema: z.ZodObject<Omit<Omit<{
     position?: [number, number] | undefined;
     rotation?: number | undefined;
     scale?: number | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
     widthScale?: number | undefined;
 }, {
@@ -369,22 +1188,99 @@ declare const NoteCreateSchema: z.ZodObject<Omit<Omit<{
     position?: [number, number] | undefined;
     rotation?: number | undefined;
     scale?: number | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
     widthScale?: number | undefined;
 }>;
-declare const ImageCreateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Image">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+declare const ImageCreateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
+    type: z.ZodOptional<z.ZodLiteral<"Image">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
-    imageUrl: z.ZodString;
+    imageUrl: z.ZodOptional<z.ZodString>;
     opacity: z.ZodOptional<z.ZodNumber>;
-}, "id">, "strip", z.ZodTypeAny, {
+}, Pick<Omit<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    type: z.ZodLiteral<"Image">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The URL of the image that is rendered in this element
+     */
+    imageUrl: z.ZodString;
+    /**
+     * The opacity of the image, between 0 and 1.
+     *
+     * @default 1
+     */
+    opacity: z.ZodNumber;
+}>, "color">, "type" | "coordinates" | "imageUrl">>, "id">, "strip", z.ZodTypeAny, {
     type: "Image";
     coordinates: [number, number][][];
     imageUrl: string;
@@ -406,20 +1302,103 @@ declare const ImageCreateSchema: z.ZodObject<Omit<{
     opacity?: number | undefined;
 }>;
 declare const PlaceReadSchema: z.ZodObject<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
     imageUrl: z.ZodNullable<z.ZodString>;
 }>, {
     type: z.ZodLiteral<"Place">;
     coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The symbol that is rendered for the Place.
+     *
+     * This can be an emoji by using colon-enclosed characters (e.g. `":smiley:"`)
+     * or one of the symbols available in Felt's symbol library.
+     *
+     * You can see the available symbols in the Felt UI when editing a Place
+     * by hovering a symbol and converting the tooltip to kebab-case. For example,
+     * the "Oil barrel" symbol is `oil-barrel`.
+     */
     symbol: z.ZodString;
+    /**
+     * The frame that is rendered around the Place's symbol. This is
+     * only available for non-emoji symbols.
+     */
     frame: z.ZodNullable<z.ZodEnum<["frame-circle", "frame-square"]>>;
+    /**
+     * Whether the element's label is hidden on the map. This allows you
+     * to add a name to the element and can show in popups, but not have
+     * it visible on the map.
+     *
+     * This will also hide the faint placeholder label that is shown when
+     * an editable Place is selected.
+     *
+     * @default false
+     */
     hideLabel: z.ZodBoolean;
 }>, "strip", z.ZodTypeAny, {
     symbol: string;
@@ -451,25 +1430,119 @@ declare const PlaceReadSchema: z.ZodObject<z.objectUtil.extendShape<z.objectUtil
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const PathReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
     imageUrl: z.ZodNullable<z.ZodString>;
 }>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
     strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
     strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
     strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
 }>, {
     type: z.ZodLiteral<"Path">;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * Whether a distance marker is shown at the midpoint of the path.
+     *
+     * @default false
+     */
     distanceMarker: z.ZodBoolean;
-    endCaps: z.ZodBoolean;
+    /**
+     * Whether this represents a route, and if so, what mode of transport
+     * is used.
+     *
+     * If this is `null`, the path is not considered to be a route, so while it
+     * can have a `distanceMarker`, it will does not have a start or end cap.
+     *
+     * @default null
+     */
     routingMode: z.ZodNullable<z.ZodEnum<["driving", "cycling", "walking", "flying"]>>;
+    /**
+     * Whether or not to show Start and End caps on the path. This is
+     * only available if the `routingMode` is set.
+     *
+     * @default false
+     */
+    endCaps: z.ZodBoolean;
 }>, "coordinates">, "strip", z.ZodTypeAny, {
     type: "Path";
     id: string;
@@ -483,8 +1556,8 @@ declare const PathReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     strokeWidth: number;
     strokeStyle: "solid" | "dashed" | "dotted";
     distanceMarker: boolean;
-    endCaps: boolean;
     routingMode: "driving" | "cycling" | "walking" | "flying" | null;
+    endCaps: boolean;
     interaction?: "default" | "locked" | undefined;
 }, {
     type: "Path";
@@ -499,28 +1572,112 @@ declare const PathReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     strokeWidth: number;
     strokeStyle: "solid" | "dashed" | "dotted";
     distanceMarker: boolean;
-    endCaps: boolean;
     routingMode: "driving" | "cycling" | "walking" | "flying" | null;
+    endCaps: boolean;
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const PolygonReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
     imageUrl: z.ZodNullable<z.ZodString>;
 }>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
     strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
     strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
     strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
 }>, {
     type: z.ZodLiteral<"Polygon">;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The opacity of the polygon's fill, between 0 and 1.
+     *
+     * @default 0.25
+     */
     fillOpacity: z.ZodNumber;
+    /**
+     * Whether to show an area marker on the polygon.
+     *
+     * @default false
+     */
     areaMarker: z.ZodBoolean;
 }>, "coordinates">, "strip", z.ZodTypeAny, {
     type: "Polygon";
@@ -554,30 +1711,134 @@ declare const PolygonReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.obj
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const CircleReadSchema: z.ZodObject<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
     imageUrl: z.ZodNullable<z.ZodString>;
 }>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
     strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
     strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
     strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
 }>, {
     type: z.ZodLiteral<"Circle">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The center of the circle.
+     */
+    center: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The radius of the circle in meters.
+     */
     radius: z.ZodNumber;
+    /**
+     * Whether to show a marker on the circle that indicates the radius
+     *
+     * @default false
+     */
+    radiusMarker: z.ZodBoolean;
+    /**
+     * The angle at which the control point for setting the radius is displayed,
+     * in degrees. When the `radiusMarker` is `true`, there is a dotted line rendered
+     * from the center of the circle to the control point, and the marker is shown
+     * at the midpoint of this line.
+     *
+     * @default 90
+     */
     radiusDisplayAngle: z.ZodNumber;
+    /**
+     * The unit of the radius used when the `radiusMarker` is `true`.
+     *
+     * A value of `null` means that the unit matches the user's locale.
+     *
+     * @default null
+     */
     radiusDisplayUnit: z.ZodNullable<z.ZodEnum<["meter", "kilometer", "foot", "mile"]>>;
+    /**
+     * The opacity of the circle's fill.
+     *
+     * @default 0.25
+     */
     fillOpacity: z.ZodNumber;
-    radiusMarker: z.ZodBoolean;
 }>, "strip", z.ZodTypeAny, {
     type: "Circle";
-    coordinates: [number, number];
     id: string;
     groupId: string | null;
     color: string;
@@ -589,14 +1850,14 @@ declare const CircleReadSchema: z.ZodObject<z.objectUtil.extendShape<z.objectUti
     strokeWidth: number;
     strokeStyle: "solid" | "dashed" | "dotted";
     fillOpacity: number;
+    center: [number, number];
     radius: number;
+    radiusMarker: boolean;
     radiusDisplayAngle: number;
     radiusDisplayUnit: "meter" | "kilometer" | "foot" | "mile" | null;
-    radiusMarker: boolean;
     interaction?: "default" | "locked" | undefined;
 }, {
     type: "Circle";
-    coordinates: [number, number];
     id: string;
     groupId: string | null;
     color: string;
@@ -608,25 +1869,100 @@ declare const CircleReadSchema: z.ZodObject<z.objectUtil.extendShape<z.objectUti
     strokeWidth: number;
     strokeStyle: "solid" | "dashed" | "dotted";
     fillOpacity: number;
+    center: [number, number];
     radius: number;
+    radiusMarker: boolean;
     radiusDisplayAngle: number;
     radiusDisplayUnit: "meter" | "kilometer" | "foot" | "mile" | null;
-    radiusMarker: boolean;
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const MarkerReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
     type: z.ZodLiteral<"Marker">;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The opacity of the marker, between 0 and 1.
+     *
+     * @default 1
+     */
     opacity: z.ZodNumber;
+    /**
+     * The size of the marker, used in conjunction with the `zoom` to determine
+     * the actual size of the marker.
+     *
+     * @default 10
+     */
     size: z.ZodNumber;
+    /**
+     * The zoom level at which the marker was created. This is combined with
+     * the `size` to determine the actual size of the marker.
+     *
+     * When creating a marker, if you don't supply this value it defaults to
+     * the current zoom of the map when you call `createElement`.
+     */
     zoom: z.ZodNumber;
 }>, "coordinates">, "strip", z.ZodTypeAny, {
     type: "Marker";
@@ -654,16 +1990,89 @@ declare const MarkerReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const HighlighterReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
     type: z.ZodLiteral<"Highlighter">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * A multipolygon describing the area that is highlighted.
+     *
+     * If `renderHoles` is set to false, only the outer ring of each polygon
+     * will be rendered, filling in the area inside the highlighted region.
+     */
+    coordinates: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">, "many">;
+    /**
+     * Whether to render the holes of the highlighted area.
+     *
+     * @default false
+     */
+    renderHoles: z.ZodBoolean;
+    /**
+     * The opacity of the highlighter, between 0 and 1.
+     *
+     * @default 0.5
+     */
     opacity: z.ZodNumber;
 }>, "coordinates">, "strip", z.ZodTypeAny, {
     type: "Highlighter";
@@ -674,6 +2083,7 @@ declare const HighlighterReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     description: string | null;
     attributes: Record<string, unknown>;
     opacity: number;
+    renderHoles: boolean;
     interaction?: "default" | "locked" | undefined;
 }, {
     type: "Highlighter";
@@ -684,15 +2094,72 @@ declare const HighlighterReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     description: string | null;
     attributes: Record<string, unknown>;
     opacity: number;
+    renderHoles: boolean;
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const TextReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
     position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
@@ -701,9 +2168,28 @@ declare const TextReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     zoom: z.ZodNumber;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
 }>, {
+    /**
+     * The text in the element.
+     */
     text: z.ZodString;
+    /**
+     * The alignment of the text, either `left`, `center` or `right`.
+     *
+     * @default "center"
+     */
     align: z.ZodEnum<["left", "center", "right"]>;
+    /**
+     * The style of the text, either `italic`, `light`, `regular` or `caps`.
+     *
+     * @default "regular"
+     */
     style: z.ZodEnum<["italic", "light", "regular", "caps"]>;
+    /**
+     * The text shown in the element, which is identical to the `text` property.
+     *
+     * @remarks This is added for consistency with other elements that have a `name`
+     * property.
+     */
     name: z.ZodString;
 }>, {
     type: z.ZodLiteral<"Text">;
@@ -720,7 +2206,7 @@ declare const TextReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     rotation: number;
     scale: number;
     text: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
     interaction?: "default" | "locked" | undefined;
 }, {
@@ -736,17 +2222,73 @@ declare const TextReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     rotation: number;
     scale: number;
     text: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const NoteReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
     position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
@@ -755,9 +2297,28 @@ declare const NoteReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     zoom: z.ZodNumber;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
 }>, {
+    /**
+     * The text in the element.
+     */
     text: z.ZodString;
+    /**
+     * The alignment of the text, either `left`, `center` or `right`.
+     *
+     * @default "center"
+     */
     align: z.ZodEnum<["left", "center", "right"]>;
+    /**
+     * The style of the text, either `italic`, `light`, `regular` or `caps`.
+     *
+     * @default "regular"
+     */
     style: z.ZodEnum<["italic", "light", "regular", "caps"]>;
+    /**
+     * The text shown in the element, which is identical to the `text` property.
+     *
+     * @remarks This is added for consistency with other elements that have a `name`
+     * property.
+     */
     name: z.ZodString;
 }>, {
     type: z.ZodLiteral<"Note">;
@@ -775,7 +2336,7 @@ declare const NoteReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     rotation: number;
     scale: number;
     text: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
     widthScale: number;
     interaction?: "default" | "locked" | undefined;
@@ -792,23 +2353,87 @@ declare const NoteReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<z.object
     rotation: number;
     scale: number;
     text: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
     widthScale: number;
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const ImageReadSchema: z.ZodObject<Omit<Omit<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
     type: z.ZodLiteral<"Image">;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The URL of the image that is rendered in this element
+     */
     imageUrl: z.ZodString;
+    /**
+     * The opacity of the image, between 0 and 1.
+     *
+     * @default 1
+     */
     opacity: z.ZodNumber;
 }>, "color">, "coordinates">, "strip", z.ZodTypeAny, {
     type: "Image";
@@ -832,16 +2457,75 @@ declare const ImageReadSchema: z.ZodObject<Omit<Omit<z.objectUtil.extendShape<{
     interaction?: "default" | "locked" | undefined;
 }>;
 declare const LinkReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
     id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
     groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
     color: z.ZodString;
-    name: z.ZodUnion<[z.ZodString, z.ZodNull]>;
-    description: z.ZodUnion<[z.ZodString, z.ZodNull]>;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
     interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
 }, {
     type: z.ZodLiteral<"Link">;
     coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The URL of the link that is rendered in this element.
+     */
     url: z.ZodString;
 }>, "coordinates">, "strip", z.ZodTypeAny, {
     type: "Link";
@@ -864,21 +2548,120 @@ declare const LinkReadSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
     url: string;
     interaction?: "default" | "locked" | undefined;
 }>;
-declare const PlaceUpdateSchema: z.ZodObject<{
-    symbol: z.ZodOptional<z.ZodString>;
-    type: z.ZodLiteral<"Place">;
-    coordinates: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-    id: z.ZodString;
+declare const PlaceUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodLiteral<"Place">>;
+    coordinates: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    symbol: z.ZodOptional<z.ZodString>;
     frame: z.ZodOptional<z.ZodNullable<z.ZodEnum<["frame-circle", "frame-square"]>>>;
     hideLabel: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    type: z.ZodLiteral<"Place">;
+    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The symbol that is rendered for the Place.
+     *
+     * This can be an emoji by using colon-enclosed characters (e.g. `":smiley:"`)
+     * or one of the symbols available in Felt's symbol library.
+     *
+     * You can see the available symbols in the Felt UI when editing a Place
+     * by hovering a symbol and converting the tooltip to kebab-case. For example,
+     * the "Oil barrel" symbol is `oil-barrel`.
+     */
+    symbol: z.ZodString;
+    /**
+     * The frame that is rendered around the Place's symbol. This is
+     * only available for non-emoji symbols.
+     */
+    frame: z.ZodNullable<z.ZodEnum<["frame-circle", "frame-square"]>>;
+    /**
+     * Whether the element's label is hidden on the map. This allows you
+     * to add a name to the element and can show in popups, but not have
+     * it visible on the map.
+     *
+     * This will also hide the faint placeholder label that is shown when
+     * an editable Place is selected.
+     *
+     * @default false
+     */
+    hideLabel: z.ZodBoolean;
+}>, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Place";
     id: string;
     symbol?: string | undefined;
@@ -907,24 +2690,138 @@ declare const PlaceUpdateSchema: z.ZodObject<{
     frame?: "frame-circle" | "frame-square" | null | undefined;
     hideLabel?: boolean | undefined;
 }>;
-declare const PathUpdateSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Path">;
-    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+declare const PathUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     strokeOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     strokeStyle: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+    type: z.ZodOptional<z.ZodLiteral<"Path">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     distanceMarker: z.ZodOptional<z.ZodBoolean>;
-    endCaps: z.ZodOptional<z.ZodBoolean>;
     routingMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<["driving", "cycling", "walking", "flying"]>>>;
-}, "strip", z.ZodTypeAny, {
+    endCaps: z.ZodOptional<z.ZodBoolean>;
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
+    strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
+    strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
+    strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
+}>, {
+    type: z.ZodLiteral<"Path">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * Whether a distance marker is shown at the midpoint of the path.
+     *
+     * @default false
+     */
+    distanceMarker: z.ZodBoolean;
+    /**
+     * Whether this represents a route, and if so, what mode of transport
+     * is used.
+     *
+     * If this is `null`, the path is not considered to be a route, so while it
+     * can have a `distanceMarker`, it will does not have a start or end cap.
+     *
+     * @default null
+     */
+    routingMode: z.ZodNullable<z.ZodEnum<["driving", "cycling", "walking", "flying"]>>;
+    /**
+     * Whether or not to show Start and End caps on the path. This is
+     * only available if the `routingMode` is set.
+     *
+     * @default false
+     */
+    endCaps: z.ZodBoolean;
+}>, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Path";
     id: string;
     coordinates?: [number, number][][] | undefined;
@@ -939,8 +2836,8 @@ declare const PathUpdateSchema: z.ZodObject<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     distanceMarker?: boolean | undefined;
-    endCaps?: boolean | undefined;
     routingMode?: "driving" | "cycling" | "walking" | "flying" | null | undefined;
+    endCaps?: boolean | undefined;
 }, {
     type: "Path";
     id: string;
@@ -956,26 +2853,129 @@ declare const PathUpdateSchema: z.ZodObject<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     distanceMarker?: boolean | undefined;
-    endCaps?: boolean | undefined;
     routingMode?: "driving" | "cycling" | "walking" | "flying" | null | undefined;
+    endCaps?: boolean | undefined;
 }>;
-declare const PolygonUpdateSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+declare const PolygonUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     strokeOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     strokeStyle: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+    type: z.ZodOptional<z.ZodLiteral<"Polygon">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     fillOpacity: z.ZodOptional<z.ZodNumber>;
     areaMarker: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
+    strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
+    strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
+    strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
+}>, {
+    type: z.ZodLiteral<"Polygon">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The opacity of the polygon's fill, between 0 and 1.
+     *
+     * @default 0.25
+     */
+    fillOpacity: z.ZodNumber;
+    /**
+     * Whether to show an area marker on the polygon.
+     *
+     * @default false
+     */
+    areaMarker: z.ZodBoolean;
+}>, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Polygon";
     id: string;
     coordinates?: [number, number][][] | undefined;
@@ -1008,29 +3008,155 @@ declare const PolygonUpdateSchema: z.ZodObject<{
     fillOpacity?: number | undefined;
     areaMarker?: boolean | undefined;
 }>;
-declare const CircleUpdateSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Circle">;
-    coordinates: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-    id: z.ZodString;
+declare const CircleUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     strokeOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     strokeStyle: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
-    fillOpacity: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodLiteral<"Circle">>;
+    center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     radius: z.ZodOptional<z.ZodNumber>;
+    radiusMarker: z.ZodOptional<z.ZodBoolean>;
     radiusDisplayAngle: z.ZodOptional<z.ZodNumber>;
     radiusDisplayUnit: z.ZodOptional<z.ZodNullable<z.ZodEnum<["meter", "kilometer", "foot", "mile"]>>>;
-    radiusMarker: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
+    fillOpacity: z.ZodOptional<z.ZodNumber>;
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    /**
+     * The URL of an image that has been added to the element.
+     */
+    imageUrl: z.ZodNullable<z.ZodString>;
+}>, {
+    /**
+     * A value between 0 and 1 that describes the opacity of the element's stroke.
+     *
+     * @default 1
+     */
+    strokeOpacity: z.ZodNumber;
+    /**
+     * The width of the element's stroke in pixels.
+     *
+     * @default 2
+     */
+    strokeWidth: z.ZodNumber;
+    /**
+     * The style of the element's stroke.
+     *
+     * @default "solid"
+     */
+    strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
+}>, {
+    type: z.ZodLiteral<"Circle">;
+    /**
+     * The center of the circle.
+     */
+    center: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * The radius of the circle in meters.
+     */
+    radius: z.ZodNumber;
+    /**
+     * Whether to show a marker on the circle that indicates the radius
+     *
+     * @default false
+     */
+    radiusMarker: z.ZodBoolean;
+    /**
+     * The angle at which the control point for setting the radius is displayed,
+     * in degrees. When the `radiusMarker` is `true`, there is a dotted line rendered
+     * from the center of the circle to the control point, and the marker is shown
+     * at the midpoint of this line.
+     *
+     * @default 90
+     */
+    radiusDisplayAngle: z.ZodNumber;
+    /**
+     * The unit of the radius used when the `radiusMarker` is `true`.
+     *
+     * A value of `null` means that the unit matches the user's locale.
+     *
+     * @default null
+     */
+    radiusDisplayUnit: z.ZodNullable<z.ZodEnum<["meter", "kilometer", "foot", "mile"]>>;
+    /**
+     * The opacity of the circle's fill.
+     *
+     * @default 0.25
+     */
+    fillOpacity: z.ZodNumber;
+}>, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Circle";
     id: string;
-    coordinates?: [number, number] | undefined;
     groupId?: string | null | undefined;
     color?: string | undefined;
     name?: string | null | undefined;
@@ -1042,14 +3168,14 @@ declare const CircleUpdateSchema: z.ZodObject<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     fillOpacity?: number | undefined;
+    center?: [number, number] | undefined;
     radius?: number | undefined;
+    radiusMarker?: boolean | undefined;
     radiusDisplayAngle?: number | undefined;
     radiusDisplayUnit?: "meter" | "kilometer" | "foot" | "mile" | null | undefined;
-    radiusMarker?: boolean | undefined;
 }, {
     type: "Circle";
     id: string;
-    coordinates?: [number, number] | undefined;
     groupId?: string | null | undefined;
     color?: string | undefined;
     name?: string | null | undefined;
@@ -1061,25 +3187,114 @@ declare const CircleUpdateSchema: z.ZodObject<{
     strokeWidth?: number | undefined;
     strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
     fillOpacity?: number | undefined;
+    center?: [number, number] | undefined;
     radius?: number | undefined;
+    radiusMarker?: boolean | undefined;
     radiusDisplayAngle?: number | undefined;
     radiusDisplayUnit?: "meter" | "kilometer" | "foot" | "mile" | null | undefined;
-    radiusMarker?: boolean | undefined;
 }>;
-declare const MarkerUpdateSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Marker">;
-    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+declare const MarkerUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
+    type: z.ZodOptional<z.ZodLiteral<"Marker">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     opacity: z.ZodOptional<z.ZodNumber>;
     size: z.ZodOptional<z.ZodNumber>;
     zoom: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    type: z.ZodLiteral<"Marker">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The opacity of the marker, between 0 and 1.
+     *
+     * @default 1
+     */
+    opacity: z.ZodNumber;
+    /**
+     * The size of the marker, used in conjunction with the `zoom` to determine
+     * the actual size of the marker.
+     *
+     * @default 10
+     */
+    size: z.ZodNumber;
+    /**
+     * The zoom level at which the marker was created. This is combined with
+     * the `size` to determine the actual size of the marker.
+     *
+     * When creating a marker, if you don't supply this value it defaults to
+     * the current zoom of the map when you call `createElement`.
+     */
+    zoom: z.ZodNumber;
+}>, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Marker";
     id: string;
     coordinates?: [number, number][][] | undefined;
@@ -1106,21 +3321,107 @@ declare const MarkerUpdateSchema: z.ZodObject<{
     size?: number | undefined;
     zoom?: number | undefined;
 }>;
-declare const HighlighterUpdateSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Highlighter">;
-    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+declare const HighlighterUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
+    type: z.ZodOptional<z.ZodLiteral<"Highlighter">>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">, "many">>;
+    renderHoles: z.ZodOptional<z.ZodBoolean>;
     opacity: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    type: z.ZodLiteral<"Highlighter">;
+    /**
+     * A multipolygon describing the area that is highlighted.
+     *
+     * If `renderHoles` is set to false, only the outer ring of each polygon
+     * will be rendered, filling in the area inside the highlighted region.
+     */
+    coordinates: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">, "many">;
+    /**
+     * Whether to render the holes of the highlighted area.
+     *
+     * @default false
+     */
+    renderHoles: z.ZodBoolean;
+    /**
+     * The opacity of the highlighter, between 0 and 1.
+     *
+     * @default 0.5
+     */
+    opacity: z.ZodNumber;
+}>, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Highlighter";
     id: string;
-    coordinates?: [number, number][][] | undefined;
+    coordinates?: [number, number][][][] | undefined;
     groupId?: string | null | undefined;
     color?: string | undefined;
     name?: string | null | undefined;
@@ -1128,10 +3429,11 @@ declare const HighlighterUpdateSchema: z.ZodObject<{
     attributes?: Record<string, unknown> | undefined;
     interaction?: "default" | "locked" | undefined;
     opacity?: number | undefined;
+    renderHoles?: boolean | undefined;
 }, {
     type: "Highlighter";
     id: string;
-    coordinates?: [number, number][][] | undefined;
+    coordinates?: [number, number][][][] | undefined;
     groupId?: string | null | undefined;
     color?: string | undefined;
     name?: string | null | undefined;
@@ -1139,25 +3441,122 @@ declare const HighlighterUpdateSchema: z.ZodObject<{
     attributes?: Record<string, unknown> | undefined;
     interaction?: "default" | "locked" | undefined;
     opacity?: number | undefined;
+    renderHoles?: boolean | undefined;
 }>;
-declare const TextUpdateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Text">;
-    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+declare const TextUpdateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
-    zoom: z.ZodOptional<z.ZodNumber>;
     position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     rotation: z.ZodOptional<z.ZodNumber>;
     scale: z.ZodOptional<z.ZodNumber>;
+    zoom: z.ZodOptional<z.ZodNumber>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     text: z.ZodOptional<z.ZodString>;
     align: z.ZodOptional<z.ZodEnum<["left", "center", "right"]>>;
     style: z.ZodOptional<z.ZodEnum<["italic", "light", "regular", "caps"]>>;
-}, "coordinates" | "name">, "strip", z.ZodTypeAny, {
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodLiteral<"Text">>;
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    rotation: z.ZodNumber;
+    scale: z.ZodNumber;
+    zoom: z.ZodNumber;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+}>, {
+    /**
+     * The text in the element.
+     */
+    text: z.ZodString;
+    /**
+     * The alignment of the text, either `left`, `center` or `right`.
+     *
+     * @default "center"
+     */
+    align: z.ZodEnum<["left", "center", "right"]>;
+    /**
+     * The style of the text, either `italic`, `light`, `regular` or `caps`.
+     *
+     * @default "regular"
+     */
+    style: z.ZodEnum<["italic", "light", "regular", "caps"]>;
+    /**
+     * The text shown in the element, which is identical to the `text` property.
+     *
+     * @remarks This is added for consistency with other elements that have a `name`
+     * property.
+     */
+    name: z.ZodString;
+}>, {
+    type: z.ZodLiteral<"Text">;
+}>, "type" | "id">>, "coordinates" | "name">, "strip", z.ZodTypeAny, {
     type: "Text";
     id: string;
     groupId?: string | null | undefined;
@@ -1170,7 +3569,7 @@ declare const TextUpdateSchema: z.ZodObject<Omit<{
     rotation?: number | undefined;
     scale?: number | undefined;
     text?: string | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
 }, {
     type: "Text";
@@ -1185,28 +3584,125 @@ declare const TextUpdateSchema: z.ZodObject<Omit<{
     rotation?: number | undefined;
     scale?: number | undefined;
     text?: string | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
 }>;
-declare const NoteUpdateSchema: z.ZodObject<Omit<{
-    type: z.ZodLiteral<"Note">;
-    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+declare const NoteUpdateSchema: z.ZodObject<Omit<z.objectUtil.extendShape<{
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     color: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
-    zoom: z.ZodOptional<z.ZodNumber>;
     position: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     rotation: z.ZodOptional<z.ZodNumber>;
     scale: z.ZodOptional<z.ZodNumber>;
+    zoom: z.ZodOptional<z.ZodNumber>;
+    coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
     text: z.ZodOptional<z.ZodString>;
     align: z.ZodOptional<z.ZodEnum<["left", "center", "right"]>>;
     style: z.ZodOptional<z.ZodEnum<["italic", "light", "regular", "caps"]>>;
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodLiteral<"Note">>;
     widthScale: z.ZodOptional<z.ZodNumber>;
-}, "coordinates" | "name">, "strip", z.ZodTypeAny, {
+}, Pick<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    rotation: z.ZodNumber;
+    scale: z.ZodNumber;
+    zoom: z.ZodNumber;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+}>, {
+    /**
+     * The text in the element.
+     */
+    text: z.ZodString;
+    /**
+     * The alignment of the text, either `left`, `center` or `right`.
+     *
+     * @default "center"
+     */
+    align: z.ZodEnum<["left", "center", "right"]>;
+    /**
+     * The style of the text, either `italic`, `light`, `regular` or `caps`.
+     *
+     * @default "regular"
+     */
+    style: z.ZodEnum<["italic", "light", "regular", "caps"]>;
+    /**
+     * The text shown in the element, which is identical to the `text` property.
+     *
+     * @remarks This is added for consistency with other elements that have a `name`
+     * property.
+     */
+    name: z.ZodString;
+}>, {
+    type: z.ZodLiteral<"Note">;
+    widthScale: z.ZodNumber;
+}>, "type" | "id">>, "coordinates" | "name">, "strip", z.ZodTypeAny, {
     type: "Note";
     id: string;
     groupId?: string | null | undefined;
@@ -1219,7 +3715,7 @@ declare const NoteUpdateSchema: z.ZodObject<Omit<{
     rotation?: number | undefined;
     scale?: number | undefined;
     text?: string | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
     widthScale?: number | undefined;
 }, {
@@ -1235,22 +3731,99 @@ declare const NoteUpdateSchema: z.ZodObject<Omit<{
     rotation?: number | undefined;
     scale?: number | undefined;
     text?: string | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "center" | "left" | "right" | undefined;
     style?: "italic" | "light" | "regular" | "caps" | undefined;
     widthScale?: number | undefined;
 }>;
-declare const ImageUpdateSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Image">;
+declare const ImageUpdateSchema: z.ZodObject<z.objectUtil.extendShape<{
+    type: z.ZodOptional<z.ZodLiteral<"Image">>;
     coordinates: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">>;
-    id: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
     groupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    name: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     interaction: z.ZodOptional<z.ZodOptional<z.ZodEnum<["default", "locked"]>>>;
     imageUrl: z.ZodOptional<z.ZodString>;
     opacity: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
+}, Pick<Omit<z.objectUtil.extendShape<{
+    /**
+     * The unique identifier for the element.
+     */
+    id: z.ZodString;
+    /**
+     * The ID of the element group that the element belongs to.
+     * For elements that are not part of a group, this will be null.
+     */
+    groupId: z.ZodNullable<z.ZodString>;
+    /**
+     * The color of the element in some CSS-like format.
+     *
+     * @example
+     * ```typescript
+     * "#ABC123";
+     * "rgb(255, 0, 0)";
+     * "hsl(200, 100%, 50%)";
+     * ```
+     *
+     * @default "#C93535"
+     */
+    color: z.ZodString;
+    /**
+     * The element's name. For elements that can show a label or text on
+     * the map (e.g. a Place or Text element) this is the text that will be shown.
+     *
+     * For elements such as Polygons or Paths, the name is what is shown when
+     * the element is selected by clicking on it.
+     */
+    name: z.ZodNullable<z.ZodString>;
+    /**
+     * Text describing the element, which is shown in an element's popup when it
+     * is selected.
+     *
+     * Note that some elements are not selectable on the map, such as Notes, Text
+     * and Markers, so their description will not be shown.
+     */
+    description: z.ZodNullable<z.ZodString>;
+    /**
+     * A set of key-value pairs that can be used to store arbitrary data about the element.
+     *
+     * This is most useful for associating additional data with an element that is not
+     * part of the element's core data, such as a Place's address or some other
+     * data.
+     */
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /**
+     * Whether the element is interactive.
+     *
+     * The `default` interaction mode means that the element can be selected and edited by
+     * the user, if it was created by the SDK or by the user using a tool.
+     *
+     * If the interaction mode is `locked`, the element will not be editable by the user,
+     * which is often used for elements that you don't want the user to edit or move by
+     * accident.
+     *
+     * Elements that were created by the map author (i.e. not during an SDK "session") are
+     * not editable and have special behaviour depending on their name, description and
+     * attributes.
+     *
+     * @default "default"
+     */
+    interaction: z.ZodOptional<z.ZodEnum<["default", "locked"]>>;
+}, {
+    type: z.ZodLiteral<"Image">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    /**
+     * The URL of the image that is rendered in this element
+     */
+    imageUrl: z.ZodString;
+    /**
+     * The opacity of the image, between 0 and 1.
+     *
+     * @default 1
+     */
+    opacity: z.ZodNumber;
+}>, "color">, "type" | "id">>, "strip", z.ZodTypeAny, {
     type: "Image";
     id: string;
     coordinates?: [number, number][][] | undefined;
@@ -1274,16 +3847,22 @@ declare const ImageUpdateSchema: z.ZodObject<{
     opacity?: number | undefined;
 }>;
 interface PlaceElementCreate extends zInfer<typeof PlaceCreateSchema> {
+    coordinates: LngLatTuple;
 }
 interface PathElementCreate extends zInfer<typeof PathCreateSchema> {
+    coordinates: LngLatTuple[][];
 }
 interface PolygonElementCreate extends zInfer<typeof PolygonCreateSchema> {
+    coordinates: LngLatTuple[][];
 }
 interface CircleElementCreate extends zInfer<typeof CircleCreateSchema> {
+    center: LngLatTuple;
 }
 interface MarkerElementCreate extends zInfer<typeof MarkerCreateSchema> {
+    coordinates: LngLatTuple[][];
 }
 interface HighlighterElementCreate extends zInfer<typeof HighlighterCreateSchema> {
+    coordinates: LngLatTuple[][][];
 }
 interface TextElementCreate extends zInfer<typeof TextCreateSchema> {
 }
@@ -1292,36 +3871,46 @@ interface NoteElementCreate extends zInfer<typeof NoteCreateSchema> {
 interface ImageElementCreate extends zInfer<typeof ImageCreateSchema> {
 }
 interface PlaceElementRead extends zInfer<typeof PlaceReadSchema> {
+    coordinates: LngLatTuple;
 }
 interface PathElementRead extends zInfer<typeof PathReadSchema> {
 }
 interface PolygonElementRead extends zInfer<typeof PolygonReadSchema> {
 }
 interface CircleElementRead extends zInfer<typeof CircleReadSchema> {
+    center: LngLatTuple;
 }
 interface MarkerElementRead extends zInfer<typeof MarkerReadSchema> {
 }
 interface HighlighterElementRead extends zInfer<typeof HighlighterReadSchema> {
 }
 interface TextElementRead extends zInfer<typeof TextReadSchema> {
+    position: LngLatTuple;
 }
 interface NoteElementRead extends zInfer<typeof NoteReadSchema> {
+    position: LngLatTuple;
 }
 interface ImageElementRead extends zInfer<typeof ImageReadSchema> {
 }
 interface LinkElementRead extends zInfer<typeof LinkReadSchema> {
 }
 interface PlaceElementUpdate extends zInfer<typeof PlaceUpdateSchema> {
+    coordinates?: LngLatTuple;
 }
 interface PathElementUpdate extends zInfer<typeof PathUpdateSchema> {
+    coordinates?: LngLatTuple[][];
 }
 interface PolygonElementUpdate extends zInfer<typeof PolygonUpdateSchema> {
+    coordinates?: LngLatTuple[][];
 }
 interface CircleElementUpdate extends zInfer<typeof CircleUpdateSchema> {
+    center?: LngLatTuple;
 }
 interface MarkerElementUpdate extends zInfer<typeof MarkerUpdateSchema> {
+    coordinates?: LngLatTuple[][];
 }
 interface HighlighterElementUpdate extends zInfer<typeof HighlighterUpdateSchema> {
+    coordinates?: LngLatTuple[][][];
 }
 interface TextElementUpdate extends zInfer<typeof TextUpdateSchema> {
 }
@@ -1355,7 +3944,7 @@ interface ElementGroup {
      * The ids of the elements in the element group.
      *
      * @remarks
-     * You can use these ids to get the full element objects via the `getElements` method.
+     * You can use these ids to get the full element objects via the {@link ElementsController.getElements | `getElements`} method.
      */
     elementIds: Array<string>;
     /**
@@ -1405,7 +3994,7 @@ declare const GetElementGroupsConstraintSchema: z.ZodObject<{
     ids?: string[] | undefined;
 }>;
 /**
- * The parameters for the `onElementChange` and the `onElementCreate` listeners.
+ * The parameters for the {@link ElementsController.onElementChange | `onElementChange`} and the {@link ElementsController.onElementCreate | `onElementCreate`} listeners.
  *
  * @group Elements
  */
@@ -1432,7 +4021,7 @@ interface ElementChangeCallbackParams {
     isBeingCreated: boolean;
 }
 /**
- * The parameters for the `onElementGroupChange` listener.
+ * The parameters for the {@link ElementsController.onElementGroupChange | `onElementGroupChange`} listener.
  *
  * @group Element Groups
  */
@@ -1440,210 +4029,6 @@ interface ElementGroupChangeCallbackParams {
     elementGroup: ElementGroup | null;
 }
 
-/**
- * Represents a point in world coordinates.
- */
-interface LatLng {
-    latitude: number;
-    longitude: number;
-}
-/**
- * A tuple representing a longitude and latitude coordinate.
- *
- * This is used hen serializing geometry because that's the standard used in
- * GeoJSON.
- */
-type LngLatTuple = [longitude: number, latitude: number];
-/**
- * A GeoJSON properties object.
- */
-type GeoJsonProperties = Record<string, unknown>;
-/**
- * A GeoJSON feature object, compliant with:
- * https://datatracker.ietf.org/doc/html/rfc7946#section-3.2
- *
- * @interface
- */
-type GeoJsonFeature = {
-    type: "Feature";
-    /**
-     * The bounding box of the feature.
-     */
-    bbox?: FeltBoundary;
-    /**
-     * The feature's geometry
-     */
-    geometry: GeoJsonGeometry;
-    /**
-     * A value that uniquely identifies this feature in a
-     * https://tools.ietf.org/html/rfc7946#section-3.2.
-     */
-    id?: string | number | undefined;
-    /**
-     * Properties associated with this feature.
-     */
-    properties: GeoJsonProperties;
-};
-interface PointGeometry extends zInfer<typeof PointGeometrySchema> {
-}
-/**
- * A GeoJSON point geometry.
- */
-declare const PointGeometrySchema: z.ZodObject<{
-    type: z.ZodLiteral<"Point">;
-    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
-}, "strip", z.ZodTypeAny, {
-    type: "Point";
-    coordinates: [number, number];
-}, {
-    type: "Point";
-    coordinates: [number, number];
-}>;
-/**
- * A GeoJSON multi-point geometry.
- *
- * @remarks
- * You shouldn't expect this to come from Felt - it is here for completeness
- * of the GeoJSON spec.
- */
-interface MultiPointGeometry {
-    type: "MultiPoint";
-    coordinates: PointGeometry["coordinates"][];
-}
-interface PolygonGeometry extends zInfer<typeof PolygonGeometrySchema> {
-}
-/**
- * A GeoJSON polygon geometry.
- */
-declare const PolygonGeometrySchema: z.ZodObject<{
-    type: z.ZodLiteral<"Polygon">;
-    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
-}, "strip", z.ZodTypeAny, {
-    type: "Polygon";
-    coordinates: [number, number][][];
-}, {
-    type: "Polygon";
-    coordinates: [number, number][][];
-}>;
-/**
- * A GeoJSON multi-polygon geometry.
- *
- * @interface
- */
-type MultiPolygonGeometry = {
-    type: "MultiPolygon";
-    coordinates: PolygonGeometry["coordinates"][];
-};
-/**
- * A GeoJSON line string geometry.
- *
- * @interface
- */
-type LineStringGeometry = {
-    type: "LineString";
-    coordinates: LngLatTuple[];
-};
-/**
- * A GeoJSON multi-line string geometry.
- *
- * @interface
- */
-type MultiLineStringGeometry = {
-    type: "MultiLineString";
-    coordinates: LineStringGeometry["coordinates"][];
-};
-/**
- * A GeoJSON geometry of any type
- */
-type GeoJsonGeometry = PointGeometry | PolygonGeometry | LineStringGeometry | MultiLineStringGeometry | MultiPolygonGeometry | MultiPointGeometry;
-/**
- * @ignore
- * @internal
- */
-declare const FeltZoomSchema: z.ZodNumber;
-/**
- * The zoom level of the map.
- *
- * It is a floating-point number between 1 and 23, where 1 is the most
- * zoomed out and 23 is the most zoomed in.
- *
- * @group Types
- * @public
- */
-type FeltZoom = z.infer<typeof FeltZoomSchema>;
-/**
- * @ignore
- * @internal
- */
-declare const FeltBoundarySchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
-/**
- * The edges of the map in the form of a bounding box.
- *
- * The boundary is a tuple of the form `[west, south, east, north]`.
- *
- * @group Types
- * @public
- */
-type FeltBoundary = z.infer<typeof FeltBoundarySchema>;
-/**
- * The parameters for the methods that change the visibility of entities.
- *
- * @public
- * @category Visibility
- */
-interface SetVisibilityRequest extends zInfer<typeof SetVisibilityRequestSchema> {
-}
-/**
- * @internal
- */
-declare const SetVisibilityRequestSchema: z.ZodObject<{
-    /**
-     * The ids of the entities you want to change the visibility of.
-     */
-    show: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    hide: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    show?: string[] | undefined;
-    hide?: string[] | undefined;
-}, {
-    show?: string[] | undefined;
-    hide?: string[] | undefined;
-}>;
-/**
- * Specifies the direction to sort data in
- *
- * @group Types
- */
-type SortDirection = z.infer<typeof SortDirectionSchema>;
-/** @ignore */
-declare const SortDirectionSchema: z.ZodEnum<["asc", "desc"]>;
-/**
- * Configuration for sorting data by a specific attribute
- *
- * @group Types
- */
-interface SortConfig extends zInfer<typeof SortConfigSchema> {
-}
-/** @ignore */
-declare const SortConfigSchema: z.ZodObject<{
-    /**
-     * The attribute to sort by. What this represents depends on the context.
-     * For instance, when sorting features in a data table, the attribute is
-     * the column to sort by.
-     */
-    attribute: z.ZodString;
-    /**
-     * The direction to sort in
-     */
-    direction: z.ZodEnum<["asc", "desc"]>;
-}, "strip", z.ZodTypeAny, {
-    attribute: string;
-    direction: "asc" | "desc";
-}, {
-    attribute: string;
-    direction: "asc" | "desc";
-}>;
-
 /**
  * A LayerFeature is a single geographical item in a layer.
  *
@@ -1791,8 +4176,11 @@ interface Layer {
      */
     geometryType: string | null;
     /**
-     * The bounding box of the layer. If the layer is processing, or the bounds have otherwise
-     * not been calculated or are not available, this will be `null`.
+     * The bounding box of the layer in [west, south, east, north] order
+     *
+     * There are cases where the bounds are not available, such as for layers added to the map
+     * from URL sources, as these are not (depending on their type) processed and analyzed by
+     * Felt.
      *
      * {@link FeltBoundary}
      */
@@ -1818,7 +4206,7 @@ interface LayerGroup {
      * The ids of the layers in the layer group.
      *
      * @remarks
-     * You can use these ids to get the full layer objects via the `getLayers` method.
+     * You can use these ids to get the full layer objects via the {@link LayersController.getLayers | `getLayers`} method.
      */
     layerIds: Array<string>;
     /**
@@ -1830,7 +4218,7 @@ interface LayerGroup {
      */
     shownInLegend: boolean;
     /**
-     * The bounding box of the layer group.
+     * The bounding box of the layer group in [west, south, east, north] order.
      *
      * {@link FeltBoundary}
      */
@@ -1877,7 +4265,7 @@ declare const GetLayerGroupsFilterSchema: z.ZodObject<{
     ids?: string[] | undefined;
 }>;
 /**
- * The parameters for the `onLayerChange` listener.
+ * The parameters for the {@link LayersController.onLayerChange | `onLayerChange`} listener.
  *
  * @group Layers
  */
@@ -1888,7 +4276,7 @@ interface LayerChangeCallbackParams {
     layer: Layer | null;
 }
 /**
- * The parameters for the `onLayerGroupChange` listener.
+ * The parameters for the {@link LayersController.onLayerGroupChange | `onLayerGroupChange`} listener.
  *
  * @group Layer Groups
  */
@@ -1908,10 +4296,10 @@ interface LegendItem extends LegendItemIdentifier {
     title: string | Array<string>;
     /**
      * Whether the title depends on the zoom level or not. If it does, you
-     * need to call `getLegendItem` when the zoom level changes.
+     * need to call {@link LayersController.getLegendItem | `getLegendItem`} when the zoom level changes.
      *
-     * Note that as the zoom level changes, the `onLegendItemChange` handler
-     * will not be called, so you need to call `getLegendItem` yourself.
+     * Note that as the zoom level changes, the {@link LayersController.onLegendItemChange | `onLegendItemChange`} handler
+     * will not be called, so you need to call {@link LayersController.getLegendItem | `getLegendItem`} yourself.
      */
     titleDependsOnZoom: boolean;
     /**
@@ -1990,7 +4378,7 @@ declare const LegendItemsConstraintSchema: z.ZodObject<{
     layerIds?: string[] | undefined;
 }>;
 /**
- * The parameters for the `onLegendItemChange` listener.
+ * The parameters for the {@link LayersController.onLegendItemChange | `onLegendItemChange`} listener.
  *
  * @group Legend Items
  */
@@ -2001,7 +4389,7 @@ interface LegendItemChangeCallbackParams {
     legendItem: LegendItem | null;
 }
 /**
- * Constraints for the `getRenderedFeatures` method. This can include layer constriants, spatial constraints, or both. If no constraints are
+ * Constraints for the {@link LayersController.getRenderedFeatures | `getRenderedFeatures`} method. This can include layer constriants, spatial constraints, or both. If no constraints are
  * provided, all rendered features will be returned.
  *
  * @group Layers
@@ -2440,7 +4828,7 @@ type FilterTernary = [
 /**
  *
  * Filters can be used to change which features in a layer are rendered. Filters can be
- * applied to a layer by the `setLayerFilters` method on the Felt controller.
+ * applied to a layer by the {@link LayersController.setLayerFilters | `setLayerFilters`} method on the Felt controller.
  *
  * Filters use a tree structure for combining expressions with logical operators, called a
  * {@link FilterTernary}. When combining three or more conditions, you must use proper nesting
@@ -2569,7 +4957,7 @@ interface LayerFilters {
     /**
      * Filters that are set ephemerally by viewers in their own session.
      *
-     * These are the filters that are set when the `setLayerFilters` method is
+     * These are the filters that are set when the {@link LayersController.setLayerFilters | `setLayerFilters`} method is
      * called. There is no way to set these in the Felt UI - they can only be
      * set using the SDK.
      */
@@ -3337,7 +5725,7 @@ interface PinToolSettings extends zInfer<typeof PinToolSettingsSchema> {
      *
      * - `"enter name"`: Enter a name for the Place, focusing the name input.
      * - `"add another"`: Add another Place, leaving the tool still selected.
-     * - `"none"`: Puts the tool down and selects the new Place element.
+     * - `"select"`: Puts the tool down and selects the new Place element.
      *
      * @defaultValue `"enter name"`
      */
@@ -3370,24 +5758,24 @@ declare const RouteToolSettingsSchema: z.ZodObject<{
     strokeWidth: z.ZodNumber;
     strokeStyle: z.ZodEnum<["solid", "dashed", "dotted"]>;
     distanceMarker: z.ZodBoolean;
-    endCaps: z.ZodBoolean;
     routingMode: z.ZodNullable<z.ZodEnum<["driving", "cycling", "walking", "flying"]>>;
+    endCaps: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     color: string;
     strokeOpacity: number;
     strokeWidth: number;
     strokeStyle: "solid" | "dashed" | "dotted";
     distanceMarker: boolean;
-    endCaps: boolean;
     routingMode: "driving" | "cycling" | "walking" | "flying" | null;
+    endCaps: boolean;
 }, {
     color: string;
     strokeOpacity: number;
     strokeWidth: number;
     strokeStyle: "solid" | "dashed" | "dotted";
     distanceMarker: boolean;
-    endCaps: boolean;
     routingMode: "driving" | "cycling" | "walking" | "flying" | null;
+    endCaps: boolean;
 }>;
 interface RouteToolSettings extends zInfer<typeof RouteToolSettingsSchema> {
 }
@@ -3457,15 +5845,18 @@ interface MarkerToolSettings extends zInfer<typeof MarkerToolSettingsSchema> {
 declare const HighlighterToolSettingsSchema: z.ZodObject<{
     color: z.ZodString;
     opacity: z.ZodNumber;
+    renderHoles: z.ZodBoolean;
     size: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     color: string;
     opacity: number;
     size: number;
+    renderHoles: boolean;
 }, {
     color: string;
     opacity: number;
     size: number;
+    renderHoles: boolean;
 }>;
 interface HighlighterToolSettings extends zInfer<typeof HighlighterToolSettingsSchema> {
 }
@@ -3475,11 +5866,11 @@ declare const TextToolSettingsSchema: z.ZodObject<{
     style: z.ZodEnum<["italic", "light", "regular", "caps"]>;
 }, "strip", z.ZodTypeAny, {
     color: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
 }, {
     color: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
 }>;
 interface TextToolSettings extends zInfer<typeof TextToolSettingsSchema> {
@@ -3490,11 +5881,11 @@ declare const NoteToolSettingsSchema: z.ZodObject<{
     style: z.ZodEnum<["italic", "light", "regular", "caps"]>;
 }, "strip", z.ZodTypeAny, {
     color: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
 }, {
     color: string;
-    align: "left" | "center" | "right";
+    align: "center" | "left" | "right";
     style: "italic" | "light" | "regular" | "caps";
 }>;
 interface NoteToolSettings extends zInfer<typeof NoteToolSettingsSchema> {
@@ -3585,17 +5976,17 @@ declare const ViewportCenterZoomSchema: z.ZodObject<{
     }>;
     zoom: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    zoom: number;
     center: {
         latitude: number;
         longitude: number;
     };
-}, {
     zoom: number;
+}, {
     center: {
         latitude: number;
         longitude: number;
     };
+    zoom: number;
 }>;
 /**
  * The current state of the viewport, including the derived bounds.
@@ -3616,7 +6007,7 @@ interface ViewportState {
      */
     zoom: FeltZoom;
     /**
-     * The bounding box of the viewport.
+     * The bounding box of the viewport in [west, south, east, north] order.
      *
      * This is derived, and depends on the center and zoom of the viewport, as
      * well as its size.
@@ -3626,7 +6017,7 @@ interface ViewportState {
     bounds: FeltBoundary;
 }
 /**
- * The parameters for the `setViewport` method.
+ * The parameters for the {@link ViewportController.setViewport | `setViewport`} method.
  *
  * @group Types
  */
@@ -3645,17 +6036,17 @@ declare const SetViewportCenterZoomParamsSchema: z.ZodObject<{
     }>>;
     zoom: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    zoom?: number | undefined;
     center?: {
         latitude: number;
         longitude: number;
     } | undefined;
-}, {
     zoom?: number | undefined;
+}, {
     center?: {
         latitude: number;
         longitude: number;
     } | undefined;
+    zoom?: number | undefined;
 }>;
 /**
  * The constraints for the viewport. Used to ensure that the viewport stays
@@ -3684,7 +6075,7 @@ interface ViewportConstraints {
     bounds: FeltBoundary | null;
 }
 /**
- * The parameters for the `fitViewportToBounds` method.
+ * The parameters for the {@link ViewportController.fitViewportToBounds | `fitViewportToBounds`} method.
  *
  * @group Types
  */