@nvidia-elements/core 2.10.0 → 2.11.0

package/dist/custom-elements.json

@@ -30620,6 +30620,14 @@
             "module": "home/runner/work/elements/elements/projects/core/src/menu/menu.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "home/runner/work/elements/elements/projects/core/src/menu/menu-group.js"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -30630,6 +30638,260 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "/src/menu/menu-group.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Organizes related menu items under a disclosure header that can show or hide one child menu.",
+          "name": "MenuGroup",
+          "cssProperties": [
+            {
+              "name": "--background",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
+            },
+            {
+              "name": "--font-size",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
+            },
+            {
+              "name": "--padding",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/padding)"
+            },
+            {
+              "name": "--gap",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/gap)"
+            },
+            {
+              "name": "--border-radius",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)"
+            },
+            {
+              "name": "--color",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
+            },
+            {
+              "name": "--width",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
+            },
+            {
+              "name": "--min-height",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height)"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Label content for the disclosure header.",
+              "name": ""
+            },
+            {
+              "description": "Non-interactive content before the header label, such as an icon or avatar.",
+              "name": "prefix"
+            },
+            {
+              "description": "Non-interactive content after the header label, such as a badge or count.",
+              "name": "suffix"
+            },
+            {
+              "description": "One `nve-menu` containing the grouped menu items. Direct menus use this slot automatically in browsers; server-rendered menus must set `slot=\"menu\"` explicitly.",
+              "name": "menu"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": "The associated content expands and becomes visible to the user."
+                  },
+                  {
+                    "value": "false",
+                    "description": "The associated content collapses and hides from the user."
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)\n- `true` The associated content expands and becomes visible to the user.\n\n- `false` The associated content collapses and hides from the user.",
+              "attribute": "expanded",
+              "reflects": true,
+              "descriptionText": "Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": "The element has a disabled state and does not accept interaction."
+                  },
+                  {
+                    "value": "false",
+                    "description": "The element has an enabled state and accepts interaction."
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled)\n- `true` The element has a disabled state and does not accept interaction.\n\n- `false` The element has an enabled state and accepts interaction.",
+              "attribute": "disabled",
+              "reflects": true,
+              "descriptionText": "This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled)"
+            },
+            {
+              "kind": "field",
+              "name": "behaviorExpand",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "Determines whether user activation automatically updates the expanded state.",
+              "attribute": "behavior-expand"
+            }
+          ],
+          "events": [
+            {
+              "description": "Dispatched when the user requests that the menu group open.",
+              "name": "open"
+            },
+            {
+              "description": "Dispatched when the user requests that the menu group close.",
+              "name": "close"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "expanded",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": "The associated content expands and becomes visible to the user."
+                  },
+                  {
+                    "value": "false",
+                    "description": "The associated content collapses and hides from the user."
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)\n- `true` The associated content expands and becomes visible to the user.\n\n- `false` The associated content collapses and hides from the user.",
+              "fieldName": "expanded",
+              "descriptionText": "Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": "The element has a disabled state and does not accept interaction."
+                  },
+                  {
+                    "value": "false",
+                    "description": "The element has an enabled state and accepts interaction."
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled)\n- `true` The element has a disabled state and does not accept interaction.\n\n- `false` The element has an enabled state and accepts interaction.",
+              "fieldName": "disabled",
+              "descriptionText": "This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled)"
+            },
+            {
+              "name": "behavior-expand",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "Determines whether user activation automatically updates the expanded state.",
+              "fieldName": "behaviorExpand"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nve-menu-group",
+          "customElement": true,
+          "metadata": {
+            "unitTests": true,
+            "apiReview": true,
+            "performance": true,
+            "stable": false,
+            "vqa": true,
+            "responsive": true,
+            "themes": true,
+            "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/",
+            "entrypoint": "@nvidia-elements/core/menu",
+            "example": "",
+            "package": true,
+            "documentation": "https://nvidia.github.io/elements/docs/elements/menu/",
+            "since": "0.0.0",
+            "status": "beta",
+            "behavior": "container",
+            "markdown": "## nve-menu-group\n\nOrganizes related menu items under a disclosure header that can show or hide one child menu.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Label content for the disclosure header. |\n| menu | `string` | One `nve-menu` containing the grouped menu items. Direct menus use this slot automatically in browsers; server-rendered menus must set `slot=\"menu\"` explicitly. |\n| prefix | `string` | Non-interactive content before the header label, such as an icon or avatar. |\n| suffix | `string` | Non-interactive content after the header label, such as a badge or count. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| behaviorExpand (behavior-expand) | `boolean` | Determines whether user activation automatically updates the expanded state. |\n| disabled | `boolean` | This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://mdn.dev/ARIA/Attributes/aria-disabled) - `true` The element has a disabled state and does not accept interaction. - `false` The element has an enabled state and accepts interaction. |\n| expanded | `boolean` | Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://mdn.dev/ARIA/Attributes/aria-expanded) - `true` The associated content expands and becomes visible to the user. - `false` The associated content collapses and hides from the user. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| close | `CustomEvent` | Dispatched when the user requests that the menu group close. |\n| open | `CustomEvent` | Dispatched when the user requests that the menu group open. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --close | `CommandEvent` | Closes the menu group. |\n| --open | `CommandEvent` | Opens the menu group. |\n| --toggle | `CommandEvent` | Toggles the menu group. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
+          },
+          "commands": [
+            {
+              "name": "--open",
+              "description": "Opens the menu group."
+            },
+            {
+              "name": "--close",
+              "description": "Closes the menu group."
+            },
+            {
+              "name": "--toggle",
+              "description": "Toggles the menu group."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "MenuGroup",
+          "declaration": {
+            "name": "MenuGroup",
+            "module": "/src/menu/menu-group.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "/src/menu/menu-item.js",
@@ -30701,6 +30963,10 @@
               "description": "Label and supporting content for the menu option.",
               "name": ""
             },
+            {
+              "description": "slot for prefix icon",
+              "name": "prefix"
+            },
             {
               "description": "slot for suffix icon",
               "name": "suffix"
@@ -31407,7 +31673,7 @@
             "since": "0.11.0",
             "status": "stable",
             "behavior": "button",
-            "markdown": "## nve-menu-item\n\nRepresents a selectable option within a menu, providing an interactive button for navigation or actions.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Label and supporting content for the menu option. |\n| suffix | `string` | slot for suffix icon |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| command | `string` | The command to execute on the element. https://mdn.dev/Invoker_Commands_API |\n| commandForElement (commandfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| current | `'page' \\| 'step'` | Indicates the element that represents the user's current location or position within a set. [MDN](https://mdn.dev/ARIA/Attributes/aria-current) - `page` Marks the current page within a set of navigation links. - `step` Marks the current step within a multi-step process or workflow. |\n| disabled | `boolean` | This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://mdn.dev/ARIA/Attributes/aria-disabled) - `true` The element has a disabled state and does not accept interaction. - `false` The element has an enabled state and accepts interaction. |\n| expanded | `boolean` | Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://mdn.dev/ARIA/Attributes/aria-expanded) - `true` The associated content expands and becomes visible to the user. - `false` The associated content collapses and hides from the user. |\n| form | property: `string \\| HTMLFormElement \\| null`; attribute: `string` | Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only the form ID. Reading the property returns the associated form element or `null`. https://mdn.dev/ElementInternals/form |\n| interestForElement (interestfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n| name | `string` | The name of the button, submitted as a pair with the button value as part of the form data. https://mdn.dev/HTML/Element/button#attr-name |\n| popoverTargetAction (popovertargetaction) | `'show' \\| 'hide' \\| 'toggle'` | The popover target action to perform on the popover target element. https://mdn.dev/HTMLInputElement/popoverTargetAction |\n| popoverTargetElement (popovertarget) | property: `HTMLElement \\| null`; attribute: `string` | Establishes a relationship between a popover and its invoker button. https://mdn.dev/HTMLInputElement/popoverTargetElement |\n| pressed | `boolean` | Indicates the current state of a toggle button that switches on or off. [MDN](https://mdn.dev/ARIA/Attributes/aria-pressed) - `true` The button is in the pressed (on) state and the associated action or setting is active. - `false` The button is in the unpressed (off) state and the associated action or setting is inactive. |\n| readOnly (readonly) | `boolean` | Indicates whether the element is a noninteractive visual treatment instead of a button. https://mdn.dev/HTML/Attributes/readonly |\n| selected | `boolean` | Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://mdn.dev/ARIA/Attributes/aria-selected) - `true` The element holds selection and represents the user's current choice within the group. - `false` The element does not hold selection and the user can choose it. |\n| status | `'danger'` | Applies danger styling to destructive or high-risk menu actions. |\n| type | `'button' \\| 'submit' \\| 'reset'` | Defines the button behavior when associated within a form element. https://mdn.dev/HTML/Element/button#attr-type |\n| value | `string` | Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://mdn.dev/HTML/Element/input#value) |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-background | `string` |  |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --line-height | `string` | [MDN](https://mdn.dev/CSS/line-height) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --opacity | `string` | [MDN](https://mdn.dev/CSS/opacity) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
+            "markdown": "## nve-menu-item\n\nRepresents a selectable option within a menu, providing an interactive button for navigation or actions.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Label and supporting content for the menu option. |\n| prefix | `string` | slot for prefix icon |\n| suffix | `string` | slot for suffix icon |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| command | `string` | The command to execute on the element. https://mdn.dev/Invoker_Commands_API |\n| commandForElement (commandfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| current | `'page' \\| 'step'` | Indicates the element that represents the user's current location or position within a set. [MDN](https://mdn.dev/ARIA/Attributes/aria-current) - `page` Marks the current page within a set of navigation links. - `step` Marks the current step within a multi-step process or workflow. |\n| disabled | `boolean` | This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://mdn.dev/ARIA/Attributes/aria-disabled) - `true` The element has a disabled state and does not accept interaction. - `false` The element has an enabled state and accepts interaction. |\n| expanded | `boolean` | Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://mdn.dev/ARIA/Attributes/aria-expanded) - `true` The associated content expands and becomes visible to the user. - `false` The associated content collapses and hides from the user. |\n| form | property: `string \\| HTMLFormElement \\| null`; attribute: `string` | Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only the form ID. Reading the property returns the associated form element or `null`. https://mdn.dev/ElementInternals/form |\n| interestForElement (interestfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n| name | `string` | The name of the button, submitted as a pair with the button value as part of the form data. https://mdn.dev/HTML/Element/button#attr-name |\n| popoverTargetAction (popovertargetaction) | `'show' \\| 'hide' \\| 'toggle'` | The popover target action to perform on the popover target element. https://mdn.dev/HTMLInputElement/popoverTargetAction |\n| popoverTargetElement (popovertarget) | property: `HTMLElement \\| null`; attribute: `string` | Establishes a relationship between a popover and its invoker button. https://mdn.dev/HTMLInputElement/popoverTargetElement |\n| pressed | `boolean` | Indicates the current state of a toggle button that switches on or off. [MDN](https://mdn.dev/ARIA/Attributes/aria-pressed) - `true` The button is in the pressed (on) state and the associated action or setting is active. - `false` The button is in the unpressed (off) state and the associated action or setting is inactive. |\n| readOnly (readonly) | `boolean` | Indicates whether the element is a noninteractive visual treatment instead of a button. https://mdn.dev/HTML/Attributes/readonly |\n| selected | `boolean` | Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://mdn.dev/ARIA/Attributes/aria-selected) - `true` The element holds selection and represents the user's current choice within the group. - `false` The element does not hold selection and the user can choose it. |\n| status | `'danger'` | Applies danger styling to destructive or high-risk menu actions. |\n| type | `'button' \\| 'submit' \\| 'reset'` | Defines the button behavior when associated within a form element. https://mdn.dev/HTML/Element/button#attr-type |\n| value | `string` | Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://mdn.dev/HTML/Element/input#value) |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-background | `string` |  |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --line-height | `string` | [MDN](https://mdn.dev/CSS/line-height) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --opacity | `string` | [MDN](https://mdn.dev/CSS/opacity) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
           }
         }
       ],
@@ -31462,13 +31728,62 @@
               "name": ""
             }
           ],
-          "members": [],
+          "members": [
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "'compact' | 'default' | undefined",
+                "_sourceAliases": [
+                  "Density"
+                ],
+                "values": [
+                  {
+                    "value": "compact",
+                    "description": "Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence."
+                  },
+                  {
+                    "value": "default",
+                    "description": "Standard size that works well in most contexts and provides balanced visibility."
+                  }
+                ]
+              },
+              "description": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.\n- `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.\n\n- `default` Standard size that works well in most contexts and provides balanced visibility.",
+              "attribute": "density",
+              "reflects": true,
+              "descriptionText": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot."
+            }
+          ],
           "events": [
             {
               "description": "Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.",
               "name": "scroll"
             }
           ],
+          "attributes": [
+            {
+              "name": "density",
+              "type": {
+                "text": "'compact' | 'default' | undefined",
+                "_sourceAliases": [
+                  "Density"
+                ],
+                "values": [
+                  {
+                    "value": "compact",
+                    "description": "Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence."
+                  },
+                  {
+                    "value": "default",
+                    "description": "Standard size that works well in most contexts and provides balanced visibility."
+                  }
+                ]
+              },
+              "description": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.\n- `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.\n\n- `default` Standard size that works well in most contexts and provides balanced visibility.",
+              "fieldName": "density",
+              "descriptionText": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot."
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
@@ -31491,7 +31806,7 @@
             "since": "0.11.0",
             "status": "stable",
             "behavior": "navigation",
-            "markdown": "## nve-menu\n\nA menu offers a list of choices to the user, such as a set of actions or functions. Choosing an item in a menu typically opens a sub menu, or invokes a command.\n\n### Example\n\n```html\n<nve-menu>\n  <nve-menu-item>item 1</nve-menu-item>\n  <nve-menu-item>item 2</nve-menu-item>\n  <nve-menu-item>item 3</nve-menu-item>\n  <nve-menu-item>item 4</nve-menu-item>\n</nve-menu>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for `nve-menu-item` |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| scroll | `CustomEvent` | Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --max-height | `string` | [MDN](https://mdn.dev/CSS/max-height) |\n| --max-width | `string` | [MDN](https://mdn.dev/CSS/max-width) |\n| --min-width | `string` | [MDN](https://mdn.dev/CSS/min-width) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
+            "markdown": "## nve-menu\n\nA menu offers a list of choices to the user, such as a set of actions or functions. Choosing an item in a menu typically opens a sub menu, or invokes a command.\n\n### Example\n\n```html\n<nve-menu>\n  <nve-menu-item>item 1</nve-menu-item>\n  <nve-menu-item>item 2</nve-menu-item>\n  <nve-menu-item>item 3</nve-menu-item>\n  <nve-menu-item>item 4</nve-menu-item>\n</nve-menu>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for `nve-menu-item` |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| density | `'compact' \\| 'default' \\| undefined` | Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot. - `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence. - `default` Standard size that works well in most contexts and provides balanced visibility. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| scroll | `CustomEvent` | Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --max-height | `string` | [MDN](https://mdn.dev/CSS/max-height) |\n| --max-width | `string` | [MDN](https://mdn.dev/CSS/max-width) |\n| --min-width | `string` | [MDN](https://mdn.dev/CSS/min-width) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
           }
         }
       ],
@@ -51067,6 +51382,14 @@
             "module": "home/runner/work/elements/elements/projects/core/src/viewport/viewport-gridlines.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "home/runner/work/elements/elements/projects/core/src/viewport/viewport-minimap.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ViewportAnimationOptions",
@@ -51085,33 +51408,89 @@
         },
         {
           "kind": "js",
-          "name": "ViewportPanBehavior",
+          "name": "ViewportPanBehavior",
+          "declaration": {
+            "name": "ViewportPanBehavior",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportPanDetail",
+          "declaration": {
+            "name": "ViewportPanDetail",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportPanEndDetail",
+          "declaration": {
+            "name": "ViewportPanEndDetail",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportPanEndReason",
+          "declaration": {
+            "name": "ViewportPanEndReason",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportNavigationSource",
+          "declaration": {
+            "name": "ViewportNavigationSource",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportPanProposal",
+          "declaration": {
+            "name": "ViewportPanProposal",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportPanUpdateProposal",
+          "declaration": {
+            "name": "ViewportPanUpdateProposal",
+            "module": "./viewport.types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ViewportPanEndRequest",
           "declaration": {
-            "name": "ViewportPanBehavior",
+            "name": "ViewportPanEndRequest",
             "module": "./viewport.types.js"
           }
         },
         {
           "kind": "js",
-          "name": "ViewportPanDetail",
+          "name": "ViewportPanSession",
           "declaration": {
-            "name": "ViewportPanDetail",
+            "name": "ViewportPanSession",
             "module": "./viewport.types.js"
           }
         },
         {
           "kind": "js",
-          "name": "ViewportPanEndDetail",
+          "name": "ViewportZoomProposal",
           "declaration": {
-            "name": "ViewportPanEndDetail",
+            "name": "ViewportZoomProposal",
             "module": "./viewport.types.js"
           }
         },
         {
           "kind": "js",
-          "name": "ViewportPanEndReason",
+          "name": "ViewportZoomRequestOptions",
           "declaration": {
-            "name": "ViewportPanEndReason",
+            "name": "ViewportZoomRequestOptions",
             "module": "./viewport.types.js"
           }
         },
@@ -51697,7 +52076,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Coordinates the viewport's opt-in pointer, touch, pinch, and wheel navigation behavior.",
+          "description": "",
           "name": "ViewportGestureNavigationController",
           "members": [
             {
@@ -51874,8 +52253,7 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "description": "Rebase in-progress pointer math synchronously after an independent transform change."
+              }
             },
             {
               "kind": "method",
@@ -51895,15 +52273,7 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "panBehavior",
-                  "type": {
-                    "text": "ViewportPanBehavior"
-                  }
-                }
-              ]
+              }
             },
             {
               "kind": "field",
@@ -52091,18 +52461,18 @@
             },
             {
               "kind": "method",
-              "name": "#dispatchPointerPanAndApplyDefault",
+              "name": "#pointerPanProposal",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "ViewportPanUpdateProposal"
                 }
               },
               "parameters": [
                 {
-                  "name": "pointerId",
+                  "name": "gesture",
                   "type": {
-                    "text": "number"
+                    "text": "PointerMovementGesture & { readonly kind: 'pan' }"
                   }
                 },
                 {
@@ -52110,29 +52480,23 @@
                   "type": {
                     "text": "PointerPanSession"
                   }
-                },
-                {
-                  "name": "detail",
-                  "type": {
-                    "text": "ViewportPointerPanDetail"
-                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "#activatePendingPan",
+              "name": "#activatePointerPan",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "pointerId",
+                  "name": "gesture",
                   "type": {
-                    "text": "number"
+                    "text": "PointerMovementGesture & { readonly kind: 'pan' }"
                   }
                 },
                 {
@@ -52142,9 +52506,9 @@
                   }
                 },
                 {
-                  "name": "gesture",
+                  "name": "proposal",
                   "type": {
-                    "text": "PointerMovementGesture"
+                    "text": "ViewportPanUpdateProposal"
                   }
                 }
               ]
@@ -52602,90 +52966,276 @@
               "reflects": true
             },
             {
-              "kind": "field",
-              "name": "targetSpacing",
-              "type": {
-                "text": "number",
-                "_sourceAliases": [],
-                "values": [
-                  {
-                    "value": "number",
-                    "description": ""
-                  }
-                ]
-              },
-              "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
-              "attribute": "target-spacing",
-              "reflects": true
-            }
-          ],
-          "attributes": [
+              "kind": "field",
+              "name": "targetSpacing",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
+              "attribute": "target-spacing",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "step",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Smallest gridline interval in content-space units.",
+              "fieldName": "step"
+            },
+            {
+              "name": "origin-x",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Content-space x coordinate of the grid origin.",
+              "fieldName": "originX"
+            },
+            {
+              "name": "origin-y",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Content-space y coordinate of the grid origin.",
+              "fieldName": "originY"
+            },
+            {
+              "name": "target-spacing",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
+              "fieldName": "targetSpacing"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nve-viewport-gridlines",
+          "customElement": true,
+          "metadata": {
+            "unitTests": true,
+            "apiReview": true,
+            "performance": true,
+            "stable": true,
+            "vqa": true,
+            "responsive": true,
+            "themes": true,
+            "aria": "#",
+            "entrypoint": "@nvidia-elements/core/viewport",
+            "example": "",
+            "package": true,
+            "documentation": "https://nvidia.github.io/elements/docs/elements/viewport/",
+            "since": "0.0.0",
+            "status": "beta",
+            "behavior": "content",
+            "markdown": "## nve-viewport-gridlines\n\nRenders origin-stable, zoom-adaptive gridlines behind viewport content.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| originX (origin-x) | `number` | Content-space x coordinate of the grid origin. |\n| originY (origin-y) | `number` | Content-space y coordinate of the grid origin. |\n| step | `number` | Smallest gridline interval in content-space units. |\n| targetSpacing (target-spacing) | `number` | Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --color | `string` | Sets the gridline stroke color. [MDN](https://mdn.dev/CSS/color) |\n| --line-width | `string` | Sets the approximate stroke width in CSS pixels. |"
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ViewportGridlines",
+          "declaration": {
+            "name": "ViewportGridlines",
+            "module": "/src/viewport/viewport-gridlines.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/viewport/viewport-gridlines.utils.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "selectGridlineInterval",
+          "return": {
+            "type": {
+              "text": "number"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "text": "GridlineIntervalOptions",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createGridlineCoverage",
+          "return": {
+            "type": {
+              "text": "ViewportRect"
+            }
+          },
+          "parameters": [
+            {
+              "name": "visible",
+              "type": {
+                "text": "ViewportRect",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "gridlineCoverageNeedsUpdate",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "coverage",
+              "type": {
+                "text": "ViewportRect | undefined",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "visible",
+              "type": {
+                "text": "ViewportRect",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "selectGridlineInterval",
+          "declaration": {
+            "name": "selectGridlineInterval",
+            "module": "/src/viewport/viewport-gridlines.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createGridlineCoverage",
+          "declaration": {
+            "name": "createGridlineCoverage",
+            "module": "/src/viewport/viewport-gridlines.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "gridlineCoverageNeedsUpdate",
+          "declaration": {
+            "name": "gridlineCoverageNeedsUpdate",
+            "module": "/src/viewport/viewport-gridlines.utils.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/viewport/viewport-minimap.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Provides a simplified overview and direct navigation for its parent viewport.",
+          "name": "ViewportMinimap",
+          "cssProperties": [
+            {
+              "description": "Color of the surface behind preview geometry. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)",
+              "name": "--background"
+            },
+            {
+              "description": "Color of automatically drawn root rectangles. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)",
+              "name": "--color"
+            },
+            {
+              "description": "Color of the current visible-region indicator.",
+              "name": "--indicator-color"
+            },
             {
-              "name": "step",
-              "type": {
-                "text": "number",
-                "_sourceAliases": [],
-                "values": [
-                  {
-                    "value": "number",
-                    "description": ""
-                  }
-                ]
-              },
-              "description": "Smallest gridline interval in content-space units.",
-              "fieldName": "step"
+              "description": "Corner radius of the minimap. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)",
+              "name": "--border-radius"
             },
             {
-              "name": "origin-x",
-              "type": {
-                "text": "number",
-                "_sourceAliases": [],
-                "values": [
-                  {
-                    "value": "number",
-                    "description": ""
-                  }
-                ]
-              },
-              "description": "Content-space x coordinate of the grid origin.",
-              "fieldName": "originX"
+              "description": "Cursor for clicking the background to center the viewport.",
+              "name": "--recenter-cursor"
             },
             {
-              "name": "origin-y",
-              "type": {
-                "text": "number",
-                "_sourceAliases": [],
-                "values": [
-                  {
-                    "value": "number",
-                    "description": ""
-                  }
-                ]
-              },
-              "description": "Content-space y coordinate of the grid origin.",
-              "fieldName": "originY"
+              "description": "Cursor over a draggable visible region.",
+              "name": "--pan-cursor"
             },
             {
-              "name": "target-spacing",
-              "type": {
-                "text": "number",
-                "_sourceAliases": [],
-                "values": [
-                  {
-                    "value": "number",
-                    "description": ""
-                  }
-                ]
+              "description": "Cursor during a visible-region drag.",
+              "name": "--panning-cursor"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles.",
+              "name": "preview"
+            }
+          ],
+          "members": [
+            {
+              "kind": "method",
+              "name": "refresh",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
-              "fieldName": "targetSpacing"
+              "description": "Remeasures content bounds after preview or viewport roots move without resizing."
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "nve-viewport-gridlines",
+          "tagName": "nve-viewport-minimap",
           "customElement": true,
           "metadata": {
             "unitTests": true,
@@ -52703,38 +53253,38 @@
             "since": "0.0.0",
             "status": "beta",
             "behavior": "content",
-            "markdown": "## nve-viewport-gridlines\n\nRenders origin-stable, zoom-adaptive gridlines behind viewport content.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| originX (origin-x) | `number` | Content-space x coordinate of the grid origin. |\n| originY (origin-y) | `number` | Content-space y coordinate of the grid origin. |\n| step | `number` | Smallest gridline interval in content-space units. |\n| targetSpacing (target-spacing) | `number` | Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --color | `string` | Sets the gridline stroke color. [MDN](https://mdn.dev/CSS/color) |\n| --line-width | `string` | Sets the approximate stroke width in CSS pixels. |"
+            "markdown": "## nve-viewport-minimap\n\nProvides a simplified overview and direct navigation for its parent viewport.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| preview | `string` | Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| refresh | `refresh(): void` | Remeasures content bounds after preview or viewport roots move without resizing. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | Color of the surface behind preview geometry. [MDN](https://mdn.dev/CSS/background) |\n| --border-radius | `string` | Corner radius of the minimap. [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | Color of automatically drawn root rectangles. [MDN](https://mdn.dev/CSS/color) |\n| --indicator-color | `string` | Color of the current visible-region indicator. |\n| --pan-cursor | `string` | Cursor over a draggable visible region. |\n| --panning-cursor | `string` | Cursor during a visible-region drag. |\n| --recenter-cursor | `string` | Cursor for clicking the background to center the viewport. |"
           }
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ViewportGridlines",
+          "name": "ViewportMinimap",
           "declaration": {
-            "name": "ViewportGridlines",
-            "module": "/src/viewport/viewport-gridlines.js"
+            "name": "ViewportMinimap",
+            "module": "/src/viewport/viewport-minimap.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "/src/viewport/viewport-gridlines.utils.js",
+      "path": "/src/viewport/viewport-minimap.utils.js",
       "declarations": [
         {
           "kind": "function",
-          "name": "selectGridlineInterval",
+          "name": "hasPositiveFiniteRect",
           "return": {
             "type": {
-              "text": "number"
+              "text": "boolean"
             }
           },
           "parameters": [
             {
-              "name": "options",
+              "name": "rect",
               "type": {
-                "text": "GridlineIntervalOptions",
+                "text": "ViewportRect",
                 "_sourceAliases": []
               }
             }
@@ -52742,42 +53292,81 @@
         },
         {
           "kind": "function",
-          "name": "createGridlineCoverage",
+          "name": "createViewportMinimapProjection",
           "return": {
             "type": {
-              "text": "ViewportRect"
+              "text": "ViewportMinimapProjection | undefined"
             }
           },
           "parameters": [
+            {
+              "name": "content",
+              "type": {
+                "text": "readonly ViewportRect[]",
+                "_sourceAliases": []
+              }
+            },
             {
               "name": "visible",
               "type": {
                 "text": "ViewportRect",
                 "_sourceAliases": []
               }
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "{ readonly width: number; readonly height: number }",
+                "_sourceAliases": []
+              }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "gridlineCoverageNeedsUpdate",
+          "name": "projectViewportMinimapRect",
           "return": {
             "type": {
-              "text": "boolean"
+              "text": "ViewportRect"
             }
           },
           "parameters": [
             {
-              "name": "coverage",
+              "name": "rect",
               "type": {
-                "text": "ViewportRect | undefined",
+                "text": "ViewportRect",
                 "_sourceAliases": []
               }
             },
             {
-              "name": "visible",
+              "name": "projection",
               "type": {
-                "text": "ViewportRect",
+                "text": "ViewportMinimapProjection",
+                "_sourceAliases": []
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "unprojectViewportMinimapPoint",
+          "return": {
+            "type": {
+              "text": "ViewportPoint"
+            }
+          },
+          "parameters": [
+            {
+              "name": "point",
+              "type": {
+                "text": "ViewportPoint",
+                "_sourceAliases": []
+              }
+            },
+            {
+              "name": "projection",
+              "type": {
+                "text": "ViewportMinimapProjection",
                 "_sourceAliases": []
               }
             }
@@ -52787,26 +53376,34 @@
       "exports": [
         {
           "kind": "js",
-          "name": "selectGridlineInterval",
+          "name": "hasPositiveFiniteRect",
           "declaration": {
-            "name": "selectGridlineInterval",
-            "module": "/src/viewport/viewport-gridlines.utils.js"
+            "name": "hasPositiveFiniteRect",
+            "module": "/src/viewport/viewport-minimap.utils.js"
           }
         },
         {
           "kind": "js",
-          "name": "createGridlineCoverage",
+          "name": "createViewportMinimapProjection",
           "declaration": {
-            "name": "createGridlineCoverage",
-            "module": "/src/viewport/viewport-gridlines.utils.js"
+            "name": "createViewportMinimapProjection",
+            "module": "/src/viewport/viewport-minimap.utils.js"
           }
         },
         {
           "kind": "js",
-          "name": "gridlineCoverageNeedsUpdate",
+          "name": "projectViewportMinimapRect",
           "declaration": {
-            "name": "gridlineCoverageNeedsUpdate",
-            "module": "/src/viewport/viewport-gridlines.utils.js"
+            "name": "projectViewportMinimapRect",
+            "module": "/src/viewport/viewport-minimap.utils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "unprojectViewportMinimapPoint",
+          "declaration": {
+            "name": "unprojectViewportMinimapPoint",
+            "module": "/src/viewport/viewport-minimap.utils.js"
           }
         }
       ]
@@ -52817,7 +53414,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Coordinates the viewport's opt-in keyboard and Invoker navigation behavior.",
+          "description": "",
           "name": "ViewportNavigationController",
           "members": [
             {
@@ -53015,10 +53612,6 @@
         {
           "kind": "variable",
           "name": "next"
-        },
-        {
-          "kind": "variable",
-          "name": "start"
         }
       ],
       "exports": [
@@ -53200,6 +53793,10 @@
             {
               "description": "Custom content rendered behind viewport content and excluded from content fitting",
               "name": "background"
+            },
+            {
+              "description": "Interactive content fixed above the transformed plane and excluded from content fitting",
+              "name": "overlay"
             }
           ],
           "members": [
@@ -53330,6 +53927,46 @@
               "attribute": "behavior-zoom",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "pannable",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Whether the viewport may admit new user-input panning.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "zoomable",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Whether the viewport may admit new user-input zooming.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "autoFit",
@@ -53454,6 +54091,67 @@
               },
               "description": "Returns the visible content-space rectangle."
             },
+            {
+              "kind": "method",
+              "name": "requestPan",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "proposal",
+                  "type": {
+                    "text": "ViewportPanProposal"
+                  }
+                }
+              ],
+              "description": "Requests one discrete user-originated pan. When pannable, the viewport dispatches\na cancelable `pan` and applies the default transform if no listener cancels the event.\nReturns true only when that default changes the transform."
+            },
+            {
+              "kind": "method",
+              "name": "requestZoom",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "proposal",
+                  "type": {
+                    "text": "ViewportZoomProposal"
+                  }
+                },
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "ViewportZoomRequestOptions"
+                  }
+                }
+              ],
+              "description": "Requests one discrete user-originated zoom. When zoomable, the viewport dispatches\na cancelable `zoom` and applies the default transform if no listener cancels the event.\nSet `options.animated` to animate the uncanceled default; the option is absent from the `zoom` detail.\nReturns true when the default changes or schedules a change to the transform."
+            },
+            {
+              "kind": "method",
+              "name": "startPan",
+              "return": {
+                "type": {
+                  "text": "ViewportPanSession | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "proposal",
+                  "type": {
+                    "text": "ViewportPanProposal"
+                  }
+                }
+              ],
+              "description": "Starts a sustained semantic pan after the caller crosses its activation threshold.\nDispatches `panstart`, performs the initial `pan` update, and returns a session for later updates\nand one terminal `panend`. Returns undefined when pannable is false."
+            },
             {
               "kind": "method",
               "name": "animateTo",
@@ -53525,6 +54223,13 @@
             }
           ],
           "events": [
+            {
+              "name": "capabilitieschange",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Dispatched after effective user-input pan or zoom admission changes."
+            },
             {
               "name": "viewportchange",
               "type": {
@@ -53539,19 +54244,19 @@
               }
             },
             {
-              "description": "Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.",
+              "description": "Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session.",
               "name": "panstart"
             },
             {
-              "description": "Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.",
+              "description": "Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation.",
               "name": "pan"
             },
             {
-              "description": "Dispatched when a pointer pan ends, including its terminal reason.",
+              "description": "Dispatched once when a sustained pan ends, including its terminal reason.",
               "name": "panend"
             },
             {
-              "description": "Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.",
+              "description": "Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation.",
               "name": "zoom"
             }
           ],
@@ -53739,13 +54444,13 @@
             "themes": true,
             "aria": "#",
             "entrypoint": "@nvidia-elements/core/viewport",
-            "example": "<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n  <nve-viewport-gridlines></nve-viewport-gridlines>\n  <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"710\" height=\"410\" viewBox=\"0 0 710 410\" style=\"position: absolute; left: 0; top: 0\">\n    <circle cx=\"100\" cy=\"300\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n    <rect x=\"250\" y=\"0\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n    <path d=\"M 600 190 L 710 300 L 600 410 L 490 300 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n  </svg>\n</nve-viewport>",
+            "example": "<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n  <nve-viewport-gridlines></nve-viewport-gridlines>\n  <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"900\" height=\"600\" viewBox=\"0 0 900 600\" style=\"position: absolute; left: 0; top: 0\">\n    <circle cx=\"200\" cy=\"400\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n    <rect x=\"350\" y=\"100\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n    <path d=\"M 700 290 L 810 400 L 700 510 L 590 400 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n    <rect x=\"1\" y=\"1\" width=\"898\" height=\"598\" rx=\"24\" fill=\"none\" stroke=\"var(--nve-ref-border-color-emphasis)\" stroke-width=\"2\" stroke-dasharray=\"32 20\" vector-effect=\"non-scaling-stroke\"></rect>\n  </svg>\n  <nve-viewport-minimap></nve-viewport-minimap>\n</nve-viewport>",
             "package": true,
             "documentation": "https://nvidia.github.io/elements/docs/elements/viewport/",
             "since": "0.0.0",
             "status": "beta",
             "behavior": "content",
-            "markdown": "## nve-viewport\n\nA viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.\n\n### Example\n\n```html\n<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n  <nve-viewport-gridlines></nve-viewport-gridlines>\n  <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"710\" height=\"410\" viewBox=\"0 0 710 410\" style=\"position: absolute; left: 0; top: 0\">\n    <circle cx=\"100\" cy=\"300\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n    <rect x=\"250\" y=\"0\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n    <path d=\"M 600 190 L 710 300 L 600 410 L 490 300 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n  </svg>\n</nve-viewport>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Content positioned in the viewport's infinite content space. |\n| background | `string` | Custom content rendered behind viewport content and excluded from content fitting |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| autoFit | `boolean` | Fits measurable direct default-slot content once after initial layout. |\n| behaviorPan (behavior-pan) | `boolean \\| 'space'` | Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. |\n| behaviorZoom (behavior-zoom) | `boolean` | Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. |\n| dragThreshold (drag-threshold) | `number` | CSS-pixel pointer movement required before a pointer pan begins. |\n| fitInset (fit-inset) | `number` | Default uniform CSS-pixel inset reserved around bounds when fitting content. |\n| maxScale (max-scale) | `number` | Inclusive upper scale limit. |\n| minScale (min-scale) | `number` | Inclusive lower scale limit. |\n| scale | `number` | Content-to-viewport CSS-pixel scale. |\n| x | `number` | Horizontal content-space coordinate at the viewport origin. |\n| y | `number` | Vertical content-space coordinate at the viewport origin. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| pan | `CustomEvent` | Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. |\n| panend | `CustomEvent` | Dispatched when a pointer pan ends, including its terminal reason. |\n| panstart | `CustomEvent` | Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. |\n| type | `CustomEvent` |  |\n| viewportchange | `CustomEvent` | Dispatched once after a render that commits one or more viewport transform changes. |\n| zoom | `CustomEvent` | Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --pan-down | `CommandEvent` | With behavior-pan enabled, pans down by one discrete step. |\n| --pan-left | `CommandEvent` | With behavior-pan enabled, pans left by one discrete step. |\n| --pan-right | `CommandEvent` | With behavior-pan enabled, pans right by one discrete step. |\n| --pan-up | `CommandEvent` | With behavior-pan enabled, pans up by one discrete step. |\n| --zoom-in | `CommandEvent` | With behavior-zoom enabled, animates to the next permitted scale step. |\n| --zoom-out | `CommandEvent` | With behavior-zoom enabled, animates to the previous permitted scale step. |\n| --zoom-reset | `CommandEvent` | With behavior-zoom enabled, animates to 100% scale. |\n| --zoom-to-fit | `CommandEvent` | With behavior-zoom enabled, animates to fit direct default-slot element boxes. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| animateTo | `animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void` | Animates the viewport to the requested partial transform. |\n| fitContents | `fitContents(options?: ViewportRevealOptions): void` | Fits the union of direct default-slot element boxes within the viewport. |\n| getTransform | `getTransform(): ViewportTransform` | Returns the current content-space origin and CSS-pixel scale. |\n| getVisibleRect | `getVisibleRect(): ViewportRect` | Returns the visible content-space rectangle. |\n| reveal | `reveal(region: { x: number; y: number; width?: number; height?: number }, options?: ViewportRevealOptions): void` | Centers or fits a content-space region within the viewport. |\n| toContentCoords | `toContentCoords(viewportX: number, viewportY: number): ViewportPoint` | Converts a viewport CSS-pixel point to content space. |\n| toViewportCoords | `toViewportCoords(contentX: number, contentY: number): ViewportPoint` | Converts a content-space point to viewport CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | Background color of the fixed viewport area. [MDN](https://mdn.dev/CSS/background) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --pan-cursor | `string` | Cursor shown over a background eligible for primary-pointer panning. |\n| --panning-cursor | `string` | Cursor shown while a pointer pan is active. |"
+            "markdown": "## nve-viewport\n\nA viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.\n\n### Example\n\n```html\n<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n  <nve-viewport-gridlines></nve-viewport-gridlines>\n  <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"900\" height=\"600\" viewBox=\"0 0 900 600\" style=\"position: absolute; left: 0; top: 0\">\n    <circle cx=\"200\" cy=\"400\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n    <rect x=\"350\" y=\"100\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n    <path d=\"M 700 290 L 810 400 L 700 510 L 590 400 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n    <rect x=\"1\" y=\"1\" width=\"898\" height=\"598\" rx=\"24\" fill=\"none\" stroke=\"var(--nve-ref-border-color-emphasis)\" stroke-width=\"2\" stroke-dasharray=\"32 20\" vector-effect=\"non-scaling-stroke\"></rect>\n  </svg>\n  <nve-viewport-minimap></nve-viewport-minimap>\n</nve-viewport>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Content positioned in the viewport's infinite content space. |\n| background | `string` | Custom content rendered behind viewport content and excluded from content fitting |\n| overlay | `string` | Interactive content fixed above the transformed plane and excluded from content fitting |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| autoFit | `boolean` | Fits measurable direct default-slot content once after initial layout. |\n| behaviorPan (behavior-pan) | `boolean \\| 'space'` | Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. |\n| behaviorZoom (behavior-zoom) | `boolean` | Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. |\n| dragThreshold (drag-threshold) | `number` | CSS-pixel pointer movement required before a pointer pan begins. |\n| fitInset (fit-inset) | `number` | Default uniform CSS-pixel inset reserved around bounds when fitting content. |\n| maxScale (max-scale) | `number` | Inclusive upper scale limit. |\n| minScale (min-scale) | `number` | Inclusive lower scale limit. |\n| pannable | `boolean` | Whether the viewport may admit new user-input panning. |\n| scale | `number` | Content-to-viewport CSS-pixel scale. |\n| x | `number` | Horizontal content-space coordinate at the viewport origin. |\n| y | `number` | Vertical content-space coordinate at the viewport origin. |\n| zoomable | `boolean` | Whether the viewport may admit new user-input zooming. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| capabilitieschange | `CustomEvent` | Dispatched after effective user-input pan or zoom admission changes. |\n| pan | `CustomEvent` | Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation. |\n| panend | `CustomEvent` | Dispatched once when a sustained pan ends, including its terminal reason. |\n| panstart | `CustomEvent` | Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session. |\n| type | `CustomEvent` |  |\n| viewportchange | `CustomEvent` | Dispatched once after a render that commits one or more viewport transform changes. |\n| zoom | `CustomEvent` | Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --pan-down | `CommandEvent` | With behavior-pan enabled, pans down by one discrete step. |\n| --pan-left | `CommandEvent` | With behavior-pan enabled, pans left by one discrete step. |\n| --pan-right | `CommandEvent` | With behavior-pan enabled, pans right by one discrete step. |\n| --pan-up | `CommandEvent` | With behavior-pan enabled, pans up by one discrete step. |\n| --zoom-in | `CommandEvent` | With behavior-zoom enabled, animates to the next permitted scale step. |\n| --zoom-out | `CommandEvent` | With behavior-zoom enabled, animates to the previous permitted scale step. |\n| --zoom-reset | `CommandEvent` | With behavior-zoom enabled, animates to 100% scale. |\n| --zoom-to-fit | `CommandEvent` | With behavior-zoom enabled, animates to fit direct default-slot element boxes. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| animateTo | `animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void` | Animates the viewport to the requested partial transform. |\n| fitContents | `fitContents(options?: ViewportRevealOptions): void` | Fits the union of direct default-slot element boxes within the viewport. |\n| getTransform | `getTransform(): ViewportTransform` | Returns the current content-space origin and CSS-pixel scale. |\n| getVisibleRect | `getVisibleRect(): ViewportRect` | Returns the visible content-space rectangle. |\n| requestPan | `requestPan(proposal: ViewportPanProposal): boolean` | Requests one discrete user-originated pan. When pannable, the viewport dispatches a cancelable `pan` and applies the default transform if no listener cancels the event. Returns true only when that default changes the transform. |\n| requestZoom | `requestZoom(proposal: ViewportZoomProposal, options?: ViewportZoomRequestOptions): boolean` | Requests one discrete user-originated zoom. When zoomable, the viewport dispatches a cancelable `zoom` and applies the default transform if no listener cancels the event. Set `options.animated` to animate the uncanceled default; the option is absent from the `zoom` detail. Returns true when the default changes or schedules a change to the transform. |\n| reveal | `reveal(region: { x: number; y: number; width?: number; height?: number }, options?: ViewportRevealOptions): void` | Centers or fits a content-space region within the viewport. |\n| startPan | `startPan(proposal: ViewportPanProposal): ViewportPanSession \\| undefined` | Starts a sustained semantic pan after the caller crosses its activation threshold. Dispatches `panstart`, performs the initial `pan` update, and returns a session for later updates and one terminal `panend`. Returns undefined when pannable is false. |\n| toContentCoords | `toContentCoords(viewportX: number, viewportY: number): ViewportPoint` | Converts a viewport CSS-pixel point to content space. |\n| toViewportCoords | `toViewportCoords(contentX: number, contentY: number): ViewportPoint` | Converts a content-space point to viewport CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | Background color of the fixed viewport area. [MDN](https://mdn.dev/CSS/background) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --pan-cursor | `string` | Cursor shown over a background eligible for primary-pointer panning. |\n| --panning-cursor | `string` | Cursor shown while a pointer pan is active. |"
           },
           "commands": [
             {
@@ -53781,6 +54486,14 @@
               "description": "With behavior-zoom enabled, animates to fit direct default-slot element boxes."
             }
           ]
+        },
+        {
+          "kind": "variable",
+          "name": "next"
+        },
+        {
+          "kind": "variable",
+          "name": "source"
         }
       ],
       "exports": [