@arcgis/map-components 4.34.0-next.41 → 4.34.0-next.43

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-06-29T04:36:58",
+  "timestamp": "2025-07-01T04:43:43",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.34.0-next.41",
+    "version": "4.34.0-next.43",
     "typescriptVersion": "5.8.3"
   },
   "schemaVersion": "1.0.0",
@@ -4449,7 +4449,7 @@
           "customElement": true,
           "name": "ArcgisBookmarks",
           "tagName": "arcgis-bookmarks",
-          "description": "The Bookmarks component allow end users to quickly navigate to a particular area of interest. It displays a list of [bookmarks](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html), which are typically defined inside the [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks).",
+          "description": "The Bookmarks component allows end users to quickly navigate to a particular area of interest.\nIt displays a list of [bookmarks](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html),\nwhich are typically defined inside the [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks).\n\nEach bookmark may contain the following properties: `name`, `thumbnail`, `viewpoint` (defines rotation, scale, and target geometry), and `timeExtent`.\nWhen a bookmark with a timeExtent is selected, the [arcgis-map.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#timeExtent) of the Map will be set to the timeExtent of the selected bookmark.\nTo disable time capability in the Bookmarks component, set [timeDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#timeDisabled) to `true`.\n\nThe Bookmarks component can be used to create, edit, reorder, and delete bookmarks.\nTo enable these features, set the following properties to `true`:\n[showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showAddBookmarkButton), [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showEditBookmarkButton), and [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#dragEnabled).\n\n**Note:** Bookmarks are supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) only if they come from a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks) or are [provided manually](#bookmarks). [Presentation](https://developers.arcgis.com/javascript/latest/api-reference/esri-webscene-Presentation.html) provides a similar experience for [WebScenes](https://developers.arcgis.com/javascript/latest/api-reference/esri-webscene-Presentation.html).",
           "demos": [
             {
               "description": "Docs",
@@ -4460,6 +4460,16 @@
               "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-bookmarks--demo&singleStory=true"
             }
           ],
+          "docsTags": [
+            {
+              "name": "since",
+              "text": "4.28"
+            },
+            {
+              "name": "see",
+              "text": "[Sample - Bookmarks component](https://developers.arcgis.com/javascript/latest/sample-code/bookmarks/)"
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "@arcgis/lumina"
@@ -4486,7 +4496,7 @@
             {
               "kind": "field",
               "name": "bookmarks",
-              "description": "A collection of [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html)s.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#bookmarks)",
+              "description": "A collection of [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html)s. These are typically defined inside of a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks), but can also be defined manually, as shown in the code snippet below.",
               "type": {
                 "text": "Collection<Bookmark>",
                 "references": [
@@ -4507,7 +4517,13 @@
                     "end": 19
                   }
                 ]
-              }
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\nconst bookmarksElement = document.querySelector(\"arcgis-bookmarks\");\n// define bookmarks manually\nbookmarksElement.bookmarks = [\n  new Bookmark({\n    name: \"Angeles National Forest\",\n    viewpoint: {\n      targetGeometry: {\n        type: \"extent\",\n        spatialReference: {\n          wkid: 102100\n        },\n        xmin: -13139131.948889678,\n        ymin: 4047767.23531948,\n        xmax: -13092887.54677721,\n        ymax: 4090610.189673263\n      }\n    }\n  }),\n  new Bookmark({\n    name: \"Crystal Lake\",\n    viewpoint: {\n      targetGeometry: {\n        type: \"extent\",\n        spatialReference: {\n          wkid: 102100\n        },\n        xmin: -13125852.551697943,\n        ymin: 4066904.1101411926,\n        xmax: -13114291.451169826,\n        ymax: 4077614.8487296384\n      },\n      rotation: 90\n    }\n  })\n];"
+                }
+              ]
             },
             {
               "kind": "field",
@@ -4522,13 +4538,7 @@
                 ]
               },
               "default": "false",
-              "attribute": "closed",
-              "docsTags": [
-                {
-                  "name": "since",
-                  "text": "4.33"
-                }
-              ]
+              "attribute": "closed"
             },
             {
               "kind": "method",
@@ -4564,7 +4574,7 @@
             {
               "kind": "field",
               "name": "defaultCreateOptions",
-              "description": "Specifies how new bookmarks will be created if [visibleElements.addBookmarkButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#VisibleElements) is set to `true`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#defaultCreateOptions)",
+              "description": "Specifies how new bookmarks will be created if [showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showAddBookmarkButton) is set to `true`.\nCan be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current\nview when a bookmark is created. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel-BookmarkOptions.html)\nfor the full list of options.",
               "type": {
                 "text": "BookmarkOptions",
                 "references": [
@@ -4577,12 +4587,18 @@
                     "end": 15
                   }
                 ]
-              }
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\nconst bookmarksElement = document.querySelector(\"arcgis-bookmarks\");\nbookmarksElement.showAddBookmarkButton = true;\nbookmarksElement.defaultCreateOptions = {\n  // whenever a new bookmark is created, a 100x100 px\n  // screenshot of the view will be taken and the rotation, scale, and extent\n  // of the view will not be set as the viewpoint of the new bookmark\n  takeScreenshot: true,\n  captureViewpoint: false,\n  captureTimeExtent: false, // the time extent will not be saved in the bookmark\n  screenshotSettings: {\n    width: 100,\n    height: 100\n  }\n};\n```"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "defaultEditOptions",
-              "description": "Specifies how bookmarks will be edited, if [visibleElements.editBookmarkButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#VisibleElements) is set to `true`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#defaultEditOptions)",
+              "description": "Specifies how bookmarks will be edited, if [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showEditBookmarkButton) is set to `true`.\nCan be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current\nview when a bookmark is edited. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel-BookmarkOptions.html)\nfor the full list of options.",
               "type": {
                 "text": "BookmarkOptions",
                 "references": [
@@ -4621,7 +4637,7 @@
             {
               "kind": "field",
               "name": "disabled",
-              "description": "When true, the widget is visually withdrawn and cannot be interacted with.",
+              "description": "When true, the component is visually withdrawn and cannot be interacted with.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4631,8 +4647,7 @@
                 ]
               },
               "default": "false",
-              "attribute": "disabled",
-              "reflects": true
+              "attribute": "disabled"
             },
             {
               "kind": "field",
@@ -4647,12 +4662,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "drag-enabled"
+              "attribute": "drag-enabled",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.29"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "filterPlaceholder",
-              "description": "Defines the text used as a placeholder when visibleElements.filter is set to `true`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterPlaceholder)",
+              "description": "Defines the text used as a placeholder when [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showFilter) is set to `true`.",
               "type": {
                 "text": "string",
                 "values": [
@@ -4661,12 +4682,19 @@
                   }
                 ]
               },
-              "attribute": "filter-placeholder"
+              "default": "\"\"",
+              "attribute": "filter-placeholder",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.29"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "filterText",
-              "description": "Defines the text used to filter the bookmarks when visibleElements.filter is set to `true`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterText)",
+              "description": "Defines the text used to filter the bookmarks when [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showFilter) is set to `true`.",
               "type": {
                 "text": "string",
                 "values": [
@@ -4675,25 +4703,111 @@
                   }
                 ]
               },
-              "attribute": "filter-text"
+              "default": "\"\"",
+              "attribute": "filter-text",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.29"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "goTo",
+              "description": "Zoom to a specific bookmark.",
+              "parameters": [
+                {
+                  "name": "bookmark",
+                  "type": {
+                    "text": "Bookmark",
+                    "references": [
+                      {
+                        "name": "Bookmark",
+                        "package": "@arcgis/core",
+                        "module": "interfaces.d.ts",
+                        "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html",
+                        "start": 0,
+                        "end": 8
+                      }
+                    ]
+                  }
+                }
+              ],
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "typescript",
+                      "module": "lib/lib.es5.d.ts",
+                      "start": 0,
+                      "end": 7
+                    }
+                  ]
+                }
+              },
+              "signature": "(bookmark: __esri.Bookmark): Promise<void>"
             },
             {
               "kind": "field",
               "name": "goToOverride",
-              "description": "This function provides the ability to override either the\n[MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or\n[SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#goToOverride)",
+              "description": "This function provides the ability to override either the\n[MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or\n[SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel.html#goToOverride)",
               "type": {
                 "text": "(((view: MapView | SceneView, goToParameters: GoToParameters) => void))"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "headingLevel",
+              "description": "Indicates the heading level to use for the message \"No bookmarks\" when no bookmarks\nare available. By default, this message is rendered\nas a level 2 heading (e.g. `<h2>No bookmarks</h2>`). Depending on the component's placement\nin your app, you may need to adjust this heading for proper semantics. This is\nimportant for meeting accessibility standards.",
+              "type": {
+                "text": "1 | 2 | 3 | 4 | 5 | 6",
+                "values": [
+                  {
+                    "value": "1",
+                    "type": "number"
+                  },
+                  {
+                    "value": "2",
+                    "type": "number"
+                  },
+                  {
+                    "value": "3",
+                    "type": "number"
+                  },
+                  {
+                    "value": "4",
+                    "type": "number"
+                  },
+                  {
+                    "value": "5",
+                    "type": "number"
+                  },
+                  {
+                    "value": "6",
+                    "type": "number"
+                  }
+                ]
               },
+              "default": "2",
+              "attribute": "heading-level",
               "docsTags": [
                 {
-                  "name": "since",
-                  "text": "4.33"
+                  "name": "see",
+                  "text": "[Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)"
+                },
+                {
+                  "name": "example",
+                  "text": "```js\n// \"No bookmarks\" will render as an <h3>\nbookmarksElement.headingLevel = 3;\n```"
                 }
               ]
             },
             {
               "kind": "field",
               "name": "hideFlow",
+              "description": "Determines whether the component should be rendered within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4703,11 +4817,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "hide-flow"
+              "attribute": "hide-flow",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "hideThumbnail",
+              "description": "Indicates whether the thumbnail associated with the bookmark is hidden.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4717,11 +4838,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "hide-thumbnail"
+              "attribute": "hide-thumbnail",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "hideTime",
+              "description": "Indicates whether the time (`h:m:s`) displayed next to the date is hidden if the bookmark has a time extent defined.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4731,12 +4859,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "hide-time"
+              "attribute": "hide-time",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -4745,7 +4879,7 @@
                   }
                 ]
               },
-              "default": "\"bookmark\"",
+              "default": "\"icon\"",
               "attribute": "icon",
               "docsTags": [
                 {
@@ -4757,7 +4891,7 @@
             {
               "kind": "field",
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -4768,6 +4902,14 @@
               },
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "messageOverrides",
+              "description": "Replace localized message strings with your own strings.\n\n_**Note**: Individual message keys may change between releases._",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            },
             {
               "kind": "field",
               "name": "position",
@@ -4812,8 +4954,9 @@
                   }
                 ]
               },
-              "default": "\"bottom-left\"",
-              "attribute": "position"
+              "default": "\"top-left\"",
+              "attribute": "position",
+              "reflects": true
             },
             {
               "kind": "field",
@@ -4870,6 +5013,7 @@
             {
               "kind": "field",
               "name": "showAddBookmarkButton",
+              "description": "Indicates whether to display the button to add a new bookmark.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4879,11 +5023,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "show-add-bookmark-button"
+              "attribute": "show-add-bookmark-button",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "showCloseButton",
+              "description": "Indicates whether to display the close button.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4893,11 +5044,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "show-close-button"
+              "attribute": "show-close-button",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "showCollapseButton",
+              "description": "Indicates whether to display the collapse button.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4907,11 +5065,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "show-collapse-button"
+              "attribute": "show-collapse-button",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "showEditBookmarkButton",
+              "description": "Indicates whether to display the button to edit a bookmark.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4921,11 +5086,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "show-edit-bookmark-button"
+              "attribute": "show-edit-bookmark-button",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "showFilter",
+              "description": "Indicates whether to display the bookmark filter.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4935,11 +5107,18 @@
                 ]
               },
               "default": "false",
-              "attribute": "show-filter"
+              "attribute": "show-filter",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
               "name": "showHeading",
+              "description": "Indicates whether to display the heading.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -4949,7 +5128,13 @@
                 ]
               },
               "default": "false",
-              "attribute": "show-heading"
+              "attribute": "show-heading",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.30"
+                }
+              ]
             },
             {
               "kind": "field",
@@ -4973,6 +5158,27 @@
               "attribute": "state",
               "reflects": true,
               "docsOnlyReadonly": true
+            },
+            {
+              "kind": "field",
+              "name": "timeDisabled",
+              "description": "Indicates whether to disable the time capability of the Bookmarks component.",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "attribute": "time-disabled",
+              "docsTags": [
+                {
+                  "name": "since",
+                  "text": "4.34"
+                }
+              ]
             }
           ],
           "attributes": [
@@ -5006,7 +5212,7 @@
             },
             {
               "name": "disabled",
-              "description": "When true, the widget is visually withdrawn and cannot be interacted with.",
+              "description": "When true, the component is visually withdrawn and cannot be interacted with.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5034,7 +5240,7 @@
             },
             {
               "name": "filter-placeholder",
-              "description": "Defines the text used as a placeholder when visibleElements.filter is set to `true`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterPlaceholder)",
+              "description": "Defines the text used as a placeholder when [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showFilter) is set to `true`.",
               "type": {
                 "text": "string",
                 "values": [
@@ -5043,11 +5249,12 @@
                   }
                 ]
               },
+              "default": "\"\"",
               "fieldName": "filterPlaceholder"
             },
             {
               "name": "filter-text",
-              "description": "Defines the text used to filter the bookmarks when visibleElements.filter is set to `true`.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterText)",
+              "description": "Defines the text used to filter the bookmarks when [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showFilter) is set to `true`.",
               "type": {
                 "text": "string",
                 "values": [
@@ -5056,10 +5263,47 @@
                   }
                 ]
               },
+              "default": "\"\"",
               "fieldName": "filterText"
             },
+            {
+              "name": "heading-level",
+              "description": "Indicates the heading level to use for the message \"No bookmarks\" when no bookmarks\nare available. By default, this message is rendered\nas a level 2 heading (e.g. `<h2>No bookmarks</h2>`). Depending on the component's placement\nin your app, you may need to adjust this heading for proper semantics. This is\nimportant for meeting accessibility standards.",
+              "type": {
+                "text": "1 | 2 | 3 | 4 | 5 | 6",
+                "values": [
+                  {
+                    "value": "1",
+                    "type": "number"
+                  },
+                  {
+                    "value": "2",
+                    "type": "number"
+                  },
+                  {
+                    "value": "3",
+                    "type": "number"
+                  },
+                  {
+                    "value": "4",
+                    "type": "number"
+                  },
+                  {
+                    "value": "5",
+                    "type": "number"
+                  },
+                  {
+                    "value": "6",
+                    "type": "number"
+                  }
+                ]
+              },
+              "default": "2",
+              "fieldName": "headingLevel"
+            },
             {
               "name": "hide-flow",
+              "description": "Determines whether the component should be rendered within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5073,6 +5317,7 @@
             },
             {
               "name": "hide-thumbnail",
+              "description": "Indicates whether the thumbnail associated with the bookmark is hidden.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5086,6 +5331,7 @@
             },
             {
               "name": "hide-time",
+              "description": "Indicates whether the time (`h:m:s`) displayed next to the date is hidden if the bookmark has a time extent defined.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5099,7 +5345,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -5108,12 +5354,12 @@
                   }
                 ]
               },
-              "default": "\"bookmark\"",
+              "default": "\"icon\"",
               "fieldName": "icon"
             },
             {
               "name": "label",
-              "description": "The widget's default label.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#label)",
+              "description": "The component's default label.",
               "type": {
                 "text": "string",
                 "values": [
@@ -5167,7 +5413,7 @@
                   }
                 ]
               },
-              "default": "\"bottom-left\"",
+              "default": "\"top-left\"",
               "fieldName": "position"
             },
             {
@@ -5185,6 +5431,7 @@
             },
             {
               "name": "show-add-bookmark-button",
+              "description": "Indicates whether to display the button to add a new bookmark.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5198,6 +5445,7 @@
             },
             {
               "name": "show-close-button",
+              "description": "Indicates whether to display the close button.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5211,6 +5459,7 @@
             },
             {
               "name": "show-collapse-button",
+              "description": "Indicates whether to display the collapse button.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5224,6 +5473,7 @@
             },
             {
               "name": "show-edit-bookmark-button",
+              "description": "Indicates whether to display the button to edit a bookmark.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5237,6 +5487,7 @@
             },
             {
               "name": "show-filter",
+              "description": "Indicates whether to display the bookmark filter.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5250,6 +5501,7 @@
             },
             {
               "name": "show-heading",
+              "description": "Indicates whether to display the heading.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5279,36 +5531,66 @@
               },
               "default": "\"ready\"",
               "fieldName": "state"
+            },
+            {
+              "name": "time-disabled",
+              "description": "Indicates whether to disable the time capability of the Bookmarks component.",
+              "type": {
+                "text": "boolean",
+                "values": [
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "timeDisabled"
             }
           ],
           "events": [
             {
-              "name": "arcgisClose",
-              "description": "Emitted when the component's close button is clicked.",
+              "name": "arcgisBookmarkEdit",
+              "description": "\nFires when a [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html) is edited.",
               "type": {
-                "text": "void"
+                "text": "BookmarksBookmarkEditEvent",
+                "references": [
+                  {
+                    "name": "BookmarksBookmarkEditEvent",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "start": 0,
+                    "end": 26
+                  }
+                ]
               },
               "docsTags": [
                 {
-                  "name": "since",
-                  "text": "4.33"
+                  "name": "example",
+                  "text": "```js\n// once an edit has been made, enable the \"Save Webmap\" button\n//    to allow the user to save their changes\nbookmarksElement.addEventListener(\"arcgisBookmarkEdit\", (event) => {\n   saveBtn.disabled = false;\n});\n```"
                 }
               ]
             },
             {
-              "name": "arcgisEdit",
+              "name": "arcgisBookmarkSelect",
+              "description": "Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html) is selected.",
               "type": {
-                "text": "BookmarksBookmarkEditEvent",
+                "text": "BookmarksBookmarkSelectEvent",
                 "references": [
                   {
-                    "name": "BookmarksBookmarkEditEvent",
+                    "name": "BookmarksBookmarkSelectEvent",
                     "package": "@arcgis/core",
                     "module": "interfaces.d.ts",
                     "start": 0,
-                    "end": 26
+                    "end": 28
                   }
                 ]
-              }
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```html\n<arcgis-expand expanded>\n <arcgis-bookmarks></arcgis-bookmarks>\n</arcgis-expand>\n```\n\n```js\nconst bookmarksElement = document.querySelector(\"arcgis-bookmarks\");\nconst expandElement = document.querySelector(\"arcgis-expand\");\n\n// collapses the associated Expand component\n// when a bookmark is selected\nbookmarksElement.addEventListener(\"arcgisBookmarkSelect\", (event) => {\n  expandElement.expanded = false;\n});\n```"
+                }
+              ]
             },
             {
               "name": "arcgisPropertyChange",
@@ -5323,21 +5605,6 @@
               "type": {
                 "text": "void"
               }
-            },
-            {
-              "name": "arcgisSelect",
-              "type": {
-                "text": "BookmarksBookmarkSelectEvent",
-                "references": [
-                  {
-                    "name": "BookmarksBookmarkSelectEvent",
-                    "package": "@arcgis/core",
-                    "module": "interfaces.d.ts",
-                    "start": 0,
-                    "end": 28
-                  }
-                ]
-              }
             }
           ]
         }