@nvidia-elements/core 2.19.1 → 2.20.0

package/dist/custom-elements.json

@@ -2787,6 +2787,14 @@
             "package": "@nvidia-elements/core/input"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "@nvidia-elements/core/joystick"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -30681,6 +30689,1187 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "/src/joystick/define.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/joystick/index.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "home/runner/work/elements/elements/projects/core/src/joystick/joystick.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "/src/joystick/joystick.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A joystick selects a normalized two-axis vector with pointer or keyboard input.\nApplications own physical units, coordinate frames, input shaping, publishing cadence, recording clocks,\ncommand-outcome feedback, and alternative controls when needed.\n\nGive each joystick an accessible name with a label, aria-label, or aria-labelledby.\nEditable controls use the application role to receive two-axis keyboard input.\nThe default accessible description includes both normalized coordinates, keyboard instructions, and release behavior.\nA locked axis stays at zero; an absent value reads \"No position.\" Disabled and read-only controls omit instructions.\nCoordinates use up to six decimal places and the document language for number formatting.\nAn explicit aria-description or aria-describedby replaces the default focus description through standard ARIA precedence;\nit does not disable live announcements.",
+          "name": "Joystick",
+          "cssProperties": [
+            {
+              "name": "--width",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
+            },
+            {
+              "name": "--height",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/height)"
+            },
+            {
+              "name": "--background",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
+            },
+            {
+              "description": "Background opacity when the opacity flag is present. Defaults to 0.6. The border, crosshair, thumb, and focus indicator keep their opacity. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/opacity)",
+              "name": "--opacity"
+            },
+            {
+              "name": "--border",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border)"
+            },
+            {
+              "name": "--thumb-width",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
+            },
+            {
+              "name": "--thumb-height",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/height)"
+            },
+            {
+              "name": "--thumb-background",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
+            },
+            {
+              "name": "--thumb-border",
+              "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border)"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "constraint",
+              "type": {
+                "text": "'circle' | 'square' | 'horizontal' | 'vertical'",
+                "_sourceAliases": [
+                  "JoystickConstraint"
+                ],
+                "values": [
+                  {
+                    "value": "circle",
+                    "description": ""
+                  },
+                  {
+                    "value": "square",
+                    "description": ""
+                  },
+                  {
+                    "value": "horizontal",
+                    "description": ""
+                  },
+                  {
+                    "value": "vertical",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'circle'",
+              "description": "Constrains the movement region or selects one axis. Circle limits vector magnitude to one;\nsquare permits both axes at full scale and a magnitude of up to Math.SQRT2.\nWith equally scaled planar velocity axes, square corners allow about 41% greater speed.\nMixed forward-velocity and turning-rate axes have no common physical magnitude.\nChanging the constraint projects the current value silently and cancels an active interaction.",
+              "attribute": "constraint",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md' | 'lg'",
+                "_sourceAliases": [
+                  "Size"
+                ],
+                "values": [
+                  {
+                    "value": "sm",
+                    "description": "Compact size for dense layouts or secondary elements with less visual prominence."
+                  },
+                  {
+                    "value": "md",
+                    "description": "Standard size that works well in most contexts and provides balanced visibility."
+                  },
+                  {
+                    "value": "lg",
+                    "description": "Larger size for emphasizing important elements or improving touch targets in spacious layouts."
+                  }
+                ]
+              },
+              "default": "'md'",
+              "description": "Controls the visual scale of an element to match its importance and available space.\n- `sm` Compact size for dense layouts or secondary elements with less visual prominence.\n\n- `md` Standard size that works well in most contexts and provides balanced visibility.\n\n- `lg` Larger size for emphasizing important elements or improving touch targets in spacious layouts.",
+              "attribute": "size",
+              "reflects": true,
+              "descriptionText": "Controls the visual scale of an element to match its importance and available space."
+            },
+            {
+              "kind": "field",
+              "name": "opacity",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "Enables background transparency using the --opacity CSS custom property.",
+              "attribute": "opacity",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "release",
+              "type": {
+                "text": "'center' | 'hold'",
+                "_sourceAliases": [
+                  "JoystickRelease"
+                ],
+                "values": [
+                  {
+                    "value": "center",
+                    "description": ""
+                  },
+                  {
+                    "value": "hold",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'center'",
+              "description": "Determines whether normal release returns to center or holds the final vector.\nInterrupted interactions return to neutral in either mode. Form reset restores the declared default instead.",
+              "attribute": "release",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "keyboardStep",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "0.1",
+              "description": "Sets the normalized increment for each arrow key press. Repeated presses continue adjusting;\nreleasing the final arrow applies the release behavior. Escape cancels the interaction.\nInvalid steps fall back to 0.1. Modifier shortcuts and locked-axis directions remain available to the browser.",
+              "attribute": "keyboard-step"
+            },
+            {
+              "kind": "field",
+              "name": "announce",
+              "type": {
+                "text": "'polite' | 'off'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "polite",
+                    "description": ""
+                  },
+                  {
+                    "value": "off",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'polite'",
+              "description": "Controls automatic position announcements. Focused user input produces polite announcements at most every 500 ms.\nA quick tap in center mode reports the input coordinates and the return to center.\nEscape announces the resulting coordinates without a separate cancellation message.\nProgrammatic writes and read-only playback update the description without live announcements.\nSet off when the application supplies spoken output, the position description on focus remains available.",
+              "attribute": "announce"
+            },
+            {
+              "kind": "field",
+              "name": "i18n",
+              "description": "Enables updating internal string values for internationalization.",
+              "attribute": "i18n"
+            },
+            {
+              "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."
+                  }
+                ]
+              },
+              "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.",
+              "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)",
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "readOnly",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": "The element has a readonly state: the user cannot change its value, but can still focus and copy it."
+                  },
+                  {
+                    "value": "false",
+                    "description": "The element allows editing and the user can change its value through interaction."
+                  }
+                ]
+              },
+              "description": "Indicates whether the user can change the element's value while it remains visible and focusable. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)\n- `true` The element has a readonly state: the user cannot change its value, but can still focus and copy it.\n\n- `false` The element allows editing and the user can change its value through interaction.",
+              "descriptionText": "Indicates whether the user can change the element's value while it remains visible and focusable. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)",
+              "attribute": "readonly"
+            },
+            {
+              "kind": "method",
+              "name": "updateValue",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "JoystickValue"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "reset",
+              "description": "Resets the control value to its initial value."
+            },
+            {
+              "kind": "method",
+              "name": "formStateRestoreCallback",
+              "parameters": [
+                {
+                  "name": "state",
+                  "type": {
+                    "text": "unknown"
+                  }
+                },
+                {
+                  "name": "_reason",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "JoystickValue | undefined",
+                "_sourceAliases": [],
+                "values": []
+              },
+              "default": "{ x: 0, y: 0 }",
+              "description": "The normalized vector: positive x points right and positive y points down, independent of text direction. Assign a complete finite object within the selected constraint. Invalid vectors throw TypeError without replacing the previous value. Programmatic writes do not dispatch input or change events. Use undefined for an absent sample and a zero vector for recorded neutral input. Set readOnly before assigning replay ownership. User input can replace external writes during an interaction.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The initial value used when the parent form resets.",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Requires a value before the parent form can submit.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "pattern",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the pattern that text values must match.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/pattern",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "pattern",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "min",
+              "type": {
+                "text": "number | null",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  },
+                  {
+                    "value": "null",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the minimum numeric value.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/min",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "min",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "max",
+              "type": {
+                "text": "number | null",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  },
+                  {
+                    "value": "null",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the maximum numeric value.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/max",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "max",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "step",
+              "type": {
+                "text": "number | null",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  },
+                  {
+                    "value": "null",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the value granularity for numeric inputs.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "step",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "minLength",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the minimum text length.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/minlength",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "minlength",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "maxLength",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the maximum text length.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/maxlength",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "maxlength",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The name submitted with the control value as part of the form data.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/name",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "noValidate",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Disables constraint validation for this control.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/novalidate",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "attribute": "novalidate",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "form",
+              "type": {
+                "text": "HTMLFormElement | null",
+                "_sourceAliases": [],
+                "values": []
+              },
+              "description": "The form associated with the control.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "willValidate",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Indicates whether the control participates in constraint validation.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/willValidate",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "validity",
+              "type": {
+                "text": "ValidityState",
+                "_sourceAliases": [],
+                "values": []
+              },
+              "description": "The control validity state.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validity",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "validationMessage",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The validation message shown when the control is invalid.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validationMessage",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "valueAsString",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The current value serialized as a string.",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "valueAsNumber",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The current value parsed as a number.",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The control type.",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "labels",
+              "type": {
+                "text": "NodeList",
+                "_sourceAliases": [],
+                "values": []
+              },
+              "description": "Labels associated with the control.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "composedLabel",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Text content from labels associated with the control.",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "parameters": [],
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Reports whether the control satisfies its constraints.\nhttps://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "parameters": [],
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Checks whether the control satisfies its constraints.\nhttps://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setCustomValidity",
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Sets a custom validation message.\nhttps://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "interaction-start",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Dispatched with the pointer or keyboard source after setting :state(active), including engagement at neutral."
+            },
+            {
+              "name": "interaction-end",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Dispatched with the source and terminal reason after clearing :state(active). Interruption first sends any necessary neutral input. Reset restores the declared default without value events. Detached events cannot bubble to former ancestors."
+            },
+            {
+              "description": "Dispatched after user input changes the vector, including a return to neutral. Read .value for the current vector. A held position does not generate repeated events. Publish commands at an application-controlled cadence.",
+              "name": "input"
+            },
+            {
+              "description": "Dispatched after a normal interaction completes and produces input. Cancellation sends any necessary neutral input without change.",
+              "name": "change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "tabindex"
+            },
+            {
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "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://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#value)",
+              "name": "value"
+            },
+            {
+              "name": "constraint",
+              "type": {
+                "text": "'circle' | 'square' | 'horizontal' | 'vertical'",
+                "_sourceAliases": [
+                  "JoystickConstraint"
+                ],
+                "values": [
+                  {
+                    "value": "circle",
+                    "description": ""
+                  },
+                  {
+                    "value": "square",
+                    "description": ""
+                  },
+                  {
+                    "value": "horizontal",
+                    "description": ""
+                  },
+                  {
+                    "value": "vertical",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'circle'",
+              "description": "Constrains the movement region or selects one axis. Circle limits vector magnitude to one;\nsquare permits both axes at full scale and a magnitude of up to Math.SQRT2.\nWith equally scaled planar velocity axes, square corners allow about 41% greater speed.\nMixed forward-velocity and turning-rate axes have no common physical magnitude.\nChanging the constraint projects the current value silently and cancels an active interaction.",
+              "fieldName": "constraint"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md' | 'lg'",
+                "_sourceAliases": [
+                  "Size"
+                ],
+                "values": [
+                  {
+                    "value": "sm",
+                    "description": "Compact size for dense layouts or secondary elements with less visual prominence."
+                  },
+                  {
+                    "value": "md",
+                    "description": "Standard size that works well in most contexts and provides balanced visibility."
+                  },
+                  {
+                    "value": "lg",
+                    "description": "Larger size for emphasizing important elements or improving touch targets in spacious layouts."
+                  }
+                ]
+              },
+              "default": "'md'",
+              "description": "Controls the visual scale of an element to match its importance and available space.\n- `sm` Compact size for dense layouts or secondary elements with less visual prominence.\n\n- `md` Standard size that works well in most contexts and provides balanced visibility.\n\n- `lg` Larger size for emphasizing important elements or improving touch targets in spacious layouts.",
+              "fieldName": "size",
+              "descriptionText": "Controls the visual scale of an element to match its importance and available space."
+            },
+            {
+              "name": "opacity",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "false",
+              "description": "Enables background transparency using the --opacity CSS custom property.",
+              "fieldName": "opacity"
+            },
+            {
+              "name": "release",
+              "type": {
+                "text": "'center' | 'hold'",
+                "_sourceAliases": [
+                  "JoystickRelease"
+                ],
+                "values": [
+                  {
+                    "value": "center",
+                    "description": ""
+                  },
+                  {
+                    "value": "hold",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'center'",
+              "description": "Determines whether normal release returns to center or holds the final vector.\nInterrupted interactions return to neutral in either mode. Form reset restores the declared default instead.",
+              "fieldName": "release"
+            },
+            {
+              "name": "keyboard-step",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "0.1",
+              "description": "Sets the normalized increment for each arrow key press. Repeated presses continue adjusting;\nreleasing the final arrow applies the release behavior. Escape cancels the interaction.\nInvalid steps fall back to 0.1. Modifier shortcuts and locked-axis directions remain available to the browser.",
+              "fieldName": "keyboardStep"
+            },
+            {
+              "name": "announce",
+              "type": {
+                "text": "'polite' | 'off'",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "polite",
+                    "description": ""
+                  },
+                  {
+                    "value": "off",
+                    "description": ""
+                  }
+                ]
+              },
+              "default": "'polite'",
+              "description": "Controls automatic position announcements. Focused user input produces polite announcements at most every 500 ms.\nA quick tap in center mode reports the input coordinates and the return to center.\nEscape announces the resulting coordinates without a separate cancellation message.\nProgrammatic writes and read-only playback update the description without live announcements.\nSet off when the application supplies spoken output, the position description on focus remains available.",
+              "fieldName": "announce"
+            },
+            {
+              "name": "i18n",
+              "description": "Enables updating internal string values for internationalization.",
+              "fieldName": "i18n"
+            },
+            {
+              "name": "readonly",
+              "fieldName": "readOnly",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Prevents the user from changing the control value.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "disabled",
+              "fieldName": "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."
+                  }
+                ]
+              },
+              "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.",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              },
+              "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": "required",
+              "fieldName": "required",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Requires a value before the parent form can submit.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "pattern",
+              "fieldName": "pattern",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the pattern that text values must match.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/pattern",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "min",
+              "fieldName": "min",
+              "type": {
+                "text": "number | null",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  },
+                  {
+                    "value": "null",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the minimum numeric value.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/min",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "max",
+              "fieldName": "max",
+              "type": {
+                "text": "number | null",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  },
+                  {
+                    "value": "null",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the maximum numeric value.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/max",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "step",
+              "fieldName": "step",
+              "type": {
+                "text": "number | null",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  },
+                  {
+                    "value": "null",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the value granularity for numeric inputs.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "minlength",
+              "fieldName": "minLength",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the minimum text length.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/minlength",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "maxlength",
+              "fieldName": "maxLength",
+              "type": {
+                "text": "number",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "number",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Defines the maximum text length.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/maxlength",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "name",
+              "fieldName": "name",
+              "type": {
+                "text": "string",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "string",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "The name of the element, submitted as a pair with the element value as part of the form data. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-name)",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            },
+            {
+              "name": "novalidate",
+              "fieldName": "noValidate",
+              "type": {
+                "text": "boolean",
+                "_sourceAliases": [],
+                "values": [
+                  {
+                    "value": "true",
+                    "description": ""
+                  },
+                  {
+                    "value": "false",
+                    "description": ""
+                  }
+                ]
+              },
+              "description": "Disables constraint validation for this control.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/novalidate",
+              "inheritedFrom": {
+                "name": "FormControlMixin"
+              }
+            }
+          ],
+          "mixins": [
+            {
+              "name": "FormControlMixin",
+              "package": "@nvidia-elements/forms/mixins"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nve-joystick",
+          "customElement": true,
+          "metadata": {
+            "unitTests": true,
+            "apiReview": true,
+            "performance": true,
+            "stable": false,
+            "vqa": true,
+            "responsive": true,
+            "themes": true,
+            "aria": "https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/attachInternals",
+            "entrypoint": "@nvidia-elements/core/joystick",
+            "example": "<nve-joystick aria-label=\"Movement\"></nve-joystick>",
+            "package": true,
+            "documentation": "https://nvidia.github.io/elements/docs/elements/joystick/",
+            "since": "0.0.0",
+            "status": "beta",
+            "behavior": "form",
+            "markdown": "## nve-joystick\n\nA joystick selects a normalized two-axis vector with pointer or keyboard input.\nApplications own physical units, coordinate frames, input shaping, publishing cadence, recording clocks,\ncommand-outcome feedback, and alternative controls when needed.\n\nGive each joystick an accessible name with a label, aria-label, or aria-labelledby.\nEditable controls use the application role to receive two-axis keyboard input.\nThe default accessible description includes both normalized coordinates, keyboard instructions, and release behavior.\nA locked axis stays at zero; an absent value reads \"No position.\" Disabled and read-only controls omit instructions.\nCoordinates use up to six decimal places and the document language for number formatting.\nAn explicit aria-description or aria-describedby replaces the default focus description through standard ARIA precedence;\nit does not disable live announcements.\n\n### Example\n\n```html\n<nve-joystick aria-label=\"Movement\"></nve-joystick>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/joystick/define.js';\n```\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| announce | `'polite' \\| 'off'` | Controls automatic position announcements. Focused user input produces polite announcements at most every 500 ms. A quick tap in center mode reports the input coordinates and the return to center. Escape announces the resulting coordinates without a separate cancellation message. Programmatic writes and read-only playback update the description without live announcements. Set off when the application supplies spoken output, the position description on focus remains available. |\n| composedLabel | `string` | Text content from labels associated with the control. |\n| constraint | `'circle' \\| 'square' \\| 'horizontal' \\| 'vertical'` | Constrains the movement region or selects one axis. Circle limits vector magnitude to one; square permits both axes at full scale and a magnitude of up to Math.SQRT2. With equally scaled planar velocity axes, square corners allow about 41% greater speed. Mixed forward-velocity and turning-rate axes have no common physical magnitude. Changing the constraint projects the current value silently and cancels an active interaction. |\n| defaultValue | `string` | The initial value used when the parent form resets. |\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| form | `HTMLFormElement \\| null` | The form associated with the control. https://mdn.dev/ElementInternals/form |\n| i18n |  | Enables updating internal string values for internationalization. |\n| keyboardStep (keyboard-step) | `number` | Sets the normalized increment for each arrow key press. Repeated presses continue adjusting; releasing the final arrow applies the release behavior. Escape cancels the interaction. Invalid steps fall back to 0.1. Modifier shortcuts and locked-axis directions remain available to the browser. |\n| labels | `NodeList` | Labels associated with the control. https://mdn.dev/ElementInternals/labels |\n| max | `number \\| null` | Defines the maximum numeric value. https://mdn.dev/HTML/Attributes/max |\n| maxLength (maxlength) | `number` | Defines the maximum text length. https://mdn.dev/HTML/Attributes/maxlength |\n| min | `number \\| null` | Defines the minimum numeric value. https://mdn.dev/HTML/Attributes/min |\n| minLength (minlength) | `number` | Defines the minimum text length. https://mdn.dev/HTML/Attributes/minlength |\n| name | `string` | The name submitted with the control value as part of the form data. https://mdn.dev/HTML/Attributes/name |\n| noValidate (novalidate) | `boolean` | Disables constraint validation for this control. https://mdn.dev/HTML/Attributes/novalidate |\n| opacity | `boolean` | Enables background transparency using the --opacity CSS custom property. |\n| pattern | `string` | Defines the pattern that text values must match. https://mdn.dev/HTML/Attributes/pattern |\n| readOnly (readonly) | `boolean` | Indicates whether the user can change the element's value while it remains visible and focusable. [MDN](https://mdn.dev/HTML/Attributes/readonly) - `true` The element has a readonly state: the user cannot change its value, but can still focus and copy it. - `false` The element allows editing and the user can change its value through interaction. |\n| release | `'center' \\| 'hold'` | Determines whether normal release returns to center or holds the final vector. Interrupted interactions return to neutral in either mode. Form reset restores the declared default instead. |\n| required | `boolean` | Requires a value before the parent form can submit. https://mdn.dev/HTML/Attributes/required |\n| size | `'sm' \\| 'md' \\| 'lg'` | Controls the visual scale of an element to match its importance and available space. - `sm` Compact size for dense layouts or secondary elements with less visual prominence. - `md` Standard size that works well in most contexts and provides balanced visibility. - `lg` Larger size for emphasizing important elements or improving touch targets in spacious layouts. |\n| step | `number \\| null` | Defines the value granularity for numeric inputs. https://mdn.dev/HTML/Attributes/step |\n| type | `string` | The control type. |\n| validationMessage | `string` | The validation message shown when the control is invalid. https://mdn.dev/ElementInternals/validationMessage |\n| validity | `ValidityState` | The control validity state. https://mdn.dev/ElementInternals/validity |\n| value | property: `JoystickValue \\| undefined`; attribute: `string` | The normalized vector: positive x points right and positive y points down, independent of text direction. Assign a complete finite object within the selected constraint. Invalid vectors throw TypeError without replacing the previous value. Programmatic writes do not dispatch input or change events. Use undefined for an absent sample and a zero vector for recorded neutral input. Set readOnly before assigning replay ownership. User input can replace external writes during an interaction. |\n| valueAsNumber | `number` | The current value parsed as a number. |\n| valueAsString | `string` | The current value serialized as a string. |\n| willValidate | `boolean` | Indicates whether the control participates in constraint validation. https://mdn.dev/ElementInternals/willValidate |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| change | `CustomEvent` | Dispatched after a normal interaction completes and produces input. Cancellation sends any necessary neutral input without change. |\n| input | `CustomEvent` | Dispatched after user input changes the vector, including a return to neutral. Read .value for the current vector. A held position does not generate repeated events. Publish commands at an application-controlled cadence. |\n| interaction-end | `CustomEvent` | Dispatched with the source and terminal reason after clearing :state(active). Interruption first sends any necessary neutral input. Reset restores the declared default without value events. Detached events cannot bubble to former ancestors. |\n| interaction-start | `CustomEvent` | Dispatched with the pointer or keyboard source after setting :state(active), including engagement at neutral. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| checkValidity | `checkValidity(): boolean` | Checks whether the control satisfies its constraints. https://mdn.dev/HTMLInputElement/checkValidity |\n| formStateRestoreCallback | `formStateRestoreCallback(state: unknown, _reason?: string): unknown` |  |\n| reportValidity | `reportValidity(): boolean` | Reports whether the control satisfies its constraints. https://mdn.dev/HTMLInputElement/reportValidity |\n| reset | `reset(): unknown` | Resets the control value to its initial value. |\n| setCustomValidity | `setCustomValidity(message: string): void` | Sets a custom validation message. https://mdn.dev/HTMLInputElement/setCustomValidity |\n| updateValue | `updateValue(value: JoystickValue): unknown` |  |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --opacity | `string` | Background opacity when the opacity flag is present. Defaults to 0.6. The border, crosshair, thumb, and focus indicator keep their opacity. [MDN](https://mdn.dev/CSS/opacity) |\n| --thumb-background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --thumb-border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --thumb-height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --thumb-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Joystick",
+          "declaration": {
+            "name": "Joystick",
+            "module": "/src/joystick/joystick.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "/src/logo/define.js",