@nvidia-elements/core 2.20.1 → 2.20.3

package/dist/internal/utils/focus.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus.js","names":[],"sources":["../../../src/internal/utils/focus.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function isFocusable(element: Element) {\n  return (\n    element.matches(\n      [\n        'a[href]',\n        'area[href]',\n        'input',\n        'button',\n        'select',\n        'textarea',\n        'iframe',\n        'object',\n        'embed',\n        '*[tabindex]',\n        '*[contenteditable=true]',\n        '[role=button]'\n      ].join(',')\n    ) &&\n    element.matches(':not([disabled], [inert])') &&\n    !element.closest(`[inert]`) &&\n    !element.closest('[popover]')?.matches(':not(:popover-open)')\n  );\n}\n\n/** returns interactive elements that does not require advanced keyboard interactions like arrow/navigation */\nexport function isSimpleFocusable(element: Element) {\n  return element.matches(\n    [\n      'a[href]',\n      'button:not([disabled])',\n      'input[type=checkbox]',\n      'input[type=radio]',\n      'object',\n      'embed',\n      '*[tabindex]',\n      '[role=button]:not([disabled])'\n    ].join(',')\n  );\n}\n\nexport function getActiveElement(root: Document | ShadowRoot = globalThis.document): Element | null {\n  if (root.activeElement && root.activeElement.shadowRoot) {\n    return getActiveElement(root.activeElement.shadowRoot) ?? root.activeElement;\n  } else {\n    return root.activeElement;\n  }\n}\n\n/** Returns whether an element itself owns focus in its immediate document or shadow root. */\nexport function isImmediateRootActiveElement(element: Element): boolean {\n  const root = element.getRootNode();\n  return hasActiveElement(root) && root.activeElement === element;\n}\n\nfunction hasActiveElement(root: Node): root is Node & { readonly activeElement: Element | null } {\n  return 'activeElement' in root;\n}\n\nexport function focusElement(element: HTMLElement) {\n  if (element && !isFocusable(element)) {\n    element.setAttribute('tabindex', '-1');\n    element.focus();\n    element.addEventListener('blur', () => element.removeAttribute('tabindex'), { once: true });\n  } else {\n    element?.focus();\n  }\n}\n\nexport function focusElementTimeout(element: HTMLElement) {\n  setTimeout(() => focusElement(element));\n}\n\nexport function setActiveKeyListItem(items: NodeListOf<HTMLElement> | HTMLElement[], item: HTMLElement) {\n  items.forEach(i => (i.tabIndex = -1));\n  item.tabIndex = 0;\n}\n\nexport function initializeKeyListItems(items: NodeListOf<HTMLElement> | HTMLElement[]) {\n  items.forEach(i => (i.tabIndex = -1));\n  items[0] && (items[0].tabIndex = 0);\n}\n\n/** determines if user interaction is a valid interaction for activating a listbox type */\nexport function onListboxActivate(\n  element: HTMLElement & { disabled?: boolean },\n  fn: (event: KeyboardEvent | PointerEvent) => void\n) {\n  const validKey = (e: KeyboardEvent) => e.code === 'Space' || e.code === 'ArrowUp' || e.code === 'ArrowDown';\n\n  element.addEventListener('pointerdown', (e: PointerEvent) => {\n    e.preventDefault();\n  });\n\n  // Chrome's LightDismissFromClick runs auto-popover light dismiss from click;\n  // opening on pointerup can close immediately in the same gesture.\n  // https://issues.chromium.org/issues/408010435\n  element.addEventListener('click', (e: PointerEvent) => {\n    e.preventDefault();\n\n    if (!element.disabled) {\n      fn(e);\n    }\n  });\n\n  element.addEventListener('keyup', (e: KeyboardEvent) => {\n    if (validKey(e) && !element.disabled) {\n      fn(e);\n    }\n  });\n\n  element.addEventListener('keydown', (e: KeyboardEvent) => {\n    if (validKey(e) && !element.disabled) {\n      e.preventDefault();\n    }\n  });\n}\n"],"mappings":";AAGA,SAAgB,EAAY,GAAkB;CAC5C,OACE,EAAQ,QACN;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,GAAG,CACZ,KACA,EAAQ,QAAQ,2BAA2B,KAC3C,CAAC,EAAQ,QAAQ,SAAS,KAC1B,CAAC,EAAQ,QAAQ,WAAW,CAAC,EAAE,QAAQ,qBAAqB;AAEhE;AAGA,SAAgB,EAAkB,GAAkB;CAClD,OAAO,EAAQ,QACb;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,GAAG,CACZ;AACF;AAEA,SAAgB,EAAiB,IAA8B,WAAW,UAA0B;CAIhG,OAHE,EAAK,iBAAiB,EAAK,cAAc,aACpC,EAAiB,EAAK,cAAc,UAAU,KAAK,EAAK,gBAExD,EAAK;AAEhB;AAGA,SAAgB,EAA6B,GAA2B;CACtE,IAAM,IAAO,EAAQ,YAAY;CACjC,OAAO,EAAiB,CAAI,KAAK,EAAK,kBAAkB;AAC1D;AAEA,SAAS,EAAiB,GAAuE;CAC/F,OAAO,mBAAmB;AAC5B;AAEA,SAAgB,EAAa,GAAsB;CACjD,AAAI,KAAW,CAAC,EAAY,CAAO,KACjC,EAAQ,aAAa,YAAY,IAAI,GACrC,EAAQ,MAAM,GACd,EAAQ,iBAAiB,cAAc,EAAQ,gBAAgB,UAAU,GAAG,EAAE,MAAM,GAAK,CAAC,KAE1F,GAAS,MAAM;AAEnB;AAEA,SAAgB,EAAoB,GAAsB;CACxD,iBAAiB,EAAa,CAAO,CAAC;AACxC;AAEA,SAAgB,EAAqB,GAAgD,GAAmB;CAEtG,AADA,EAAM,SAAQ,MAAM,EAAE,WAAW,EAAG,GACpC,EAAK,WAAW;AAClB;AAEA,SAAgB,EAAuB,GAAgD;CAErF,AADA,EAAM,SAAQ,MAAM,EAAE,WAAW,EAAG,GACpC,EAAM,OAAO,EAAM,EAAE,CAAC,WAAW;AACnC;AAGA,SAAgB,EACd,GACA,GACA;CACA,IAAM,KAAY,MAAqB,EAAE,SAAS,WAAW,EAAE,SAAS,aAAa,EAAE,SAAS;CAuBhG,AArBA,EAAQ,iBAAiB,gBAAgB,MAAoB;EAC3D,EAAE,eAAe;CACnB,CAAC,GAKD,EAAQ,iBAAiB,UAAU,MAAoB;EAGrD,AAFA,EAAE,eAAe,GAEZ,EAAQ,YACX,EAAG,CAAC;CAER,CAAC,GAED,EAAQ,iBAAiB,UAAU,MAAqB;EACtD,AAAI,EAAS,CAAC,KAAK,CAAC,EAAQ,YAC1B,EAAG,CAAC;CAER,CAAC,GAED,EAAQ,iBAAiB,YAAY,MAAqB;EACxD,AAAI,EAAS,CAAC,KAAK,CAAC,EAAQ,YAC1B,EAAE,eAAe;CAErB,CAAC;AACH"}
+{"version":3,"file":"focus.js","names":["isFocusable","element","isSimpleFocusable","getActiveElement","root","isImmediateRootActiveElement","hasActiveElement","focusElement","focusElementTimeout","setActiveKeyListItem","items","initializeKeyListItems","onListboxActivate","validKey","e","fn"],"sources":["../../../src/internal/utils/focus.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function isFocusable(element: Element) {\n  return (\n    element.matches(\n      [\n        'a[href]',\n        'area[href]',\n        'input',\n        'button',\n        'select',\n        'textarea',\n        'iframe',\n        'object',\n        'embed',\n        '*[tabindex]',\n        '*[contenteditable=true]',\n        '[role=button]'\n      ].join(',')\n    ) &&\n    element.matches(':not([disabled], [inert])') &&\n    !element.closest(`[inert]`) &&\n    !element.closest('[popover]')?.matches(':not(:popover-open)')\n  );\n}\n\n/** returns interactive elements that does not require advanced keyboard interactions like arrow/navigation */\nexport function isSimpleFocusable(element: Element) {\n  return element.matches(\n    [\n      'a[href]',\n      'button:not([disabled])',\n      'input[type=checkbox]',\n      'input[type=radio]',\n      'object',\n      'embed',\n      '*[tabindex]',\n      '[role=button]:not([disabled])'\n    ].join(',')\n  );\n}\n\nexport function getActiveElement(root: Document | ShadowRoot = globalThis.document): Element | null {\n  if (root.activeElement && root.activeElement.shadowRoot) {\n    return getActiveElement(root.activeElement.shadowRoot) ?? root.activeElement;\n  } else {\n    return root.activeElement;\n  }\n}\n\n/** Returns whether an element itself owns focus in its immediate document or shadow root. */\nexport function isImmediateRootActiveElement(element: Element): boolean {\n  const root = element.getRootNode();\n  return hasActiveElement(root) && root.activeElement === element;\n}\n\nfunction hasActiveElement(root: Node): root is Node & { readonly activeElement: Element | null } {\n  return 'activeElement' in root;\n}\n\nexport function focusElement(element: HTMLElement) {\n  if (element && !isFocusable(element)) {\n    element.setAttribute('tabindex', '-1');\n    element.focus();\n    element.addEventListener('blur', () => element.removeAttribute('tabindex'), { once: true });\n  } else {\n    element?.focus();\n  }\n}\n\nexport function focusElementTimeout(element: HTMLElement) {\n  setTimeout(() => focusElement(element));\n}\n\nexport function setActiveKeyListItem(items: NodeListOf<HTMLElement> | HTMLElement[], item: HTMLElement) {\n  items.forEach(i => (i.tabIndex = -1));\n  item.tabIndex = 0;\n}\n\nexport function initializeKeyListItems(items: NodeListOf<HTMLElement> | HTMLElement[]) {\n  items.forEach(i => (i.tabIndex = -1));\n  items[0] && (items[0].tabIndex = 0);\n}\n\n/** determines if user interaction is a valid interaction for activating a listbox type */\nexport function onListboxActivate(\n  element: HTMLElement & { disabled?: boolean },\n  fn: (event: KeyboardEvent | PointerEvent) => void\n) {\n  const validKey = (e: KeyboardEvent) => e.code === 'Space' || e.code === 'ArrowUp' || e.code === 'ArrowDown';\n\n  element.addEventListener('pointerdown', (e: PointerEvent) => {\n    e.preventDefault();\n  });\n\n  // Chrome's LightDismissFromClick runs auto-popover light dismiss from click;\n  // opening on pointerup can close immediately in the same gesture.\n  // https://issues.chromium.org/issues/408010435\n  element.addEventListener('click', (e: PointerEvent) => {\n    e.preventDefault();\n\n    if (!element.disabled) {\n      fn(e);\n    }\n  });\n\n  element.addEventListener('keyup', (e: KeyboardEvent) => {\n    if (validKey(e) && !element.disabled) {\n      fn(e);\n    }\n  });\n\n  element.addEventListener('keydown', (e: KeyboardEvent) => {\n    if (validKey(e) && !element.disabled) {\n      e.preventDefault();\n    }\n  });\n}\n"],"mappings":";AAGA,SAAgBA,EAAY,GAAkB;CAC5C,OACEC,EAAQ,QACN,uHAcF,KACAA,EAAQ,QAAQ,2BAA2B,KAC3C,CAACA,EAAQ,QAAQ,SAAS,KAC1B,CAACA,EAAQ,QAAQ,WAAW,CAAC,EAAE,QAAQ,qBAAqB;AAEhE;AAGA,SAAgBC,EAAkB,GAAkB;CAClD,OAAOD,EAAQ,QACb,8HAUF;AACF;AAEA,SAAgBE,EAAiB,IAA8B,WAAW,UAA0B;CAIhG,OAHEC,EAAK,iBAAiBA,EAAK,cAAc,aACpCD,EAAiBC,EAAK,cAAc,UAAU,KAAKA,EAAK,gBAExDA,EAAK;AAEhB;AAGA,SAAgBC,EAA6B,GAA2B;CACtE,IAAMD,IAAOH,EAAQ,YAAY;CACjC,OAAOK,EAAiBF,CAAI,KAAKA,EAAK,kBAAkBH;AAC1D;AAEA,SAASK,EAAiB,GAAuE;CAC/F,OAAO,mBAAmBF;AAC5B;AAEA,SAAgBG,EAAa,GAAsB;CACjD,AAAIN,KAAW,CAACD,EAAYC,CAAO,KACjCA,EAAQ,aAAa,YAAY,IAAI,GACrCA,EAAQ,MAAM,GACdA,EAAQ,iBAAiB,cAAcA,EAAQ,gBAAgB,UAAU,GAAG,EAAE,MAAM,GAAK,CAAC,KAE1FA,GAAS,MAAM;AAEnB;AAEA,SAAgBO,EAAoB,GAAsB;CACxD,iBAAiBD,EAAaN,CAAO,CAAC;AACxC;AAEA,SAAgBQ,EAAqB,GAAgD,GAAmB;CAEtG,AADAC,EAAM,SAAQ,MAAM,EAAE,WAAW,EAAG,GACpC,EAAK,WAAW;AAClB;AAEA,SAAgBC,EAAuB,GAAgD;CAErF,AADAD,EAAM,SAAQ,MAAM,EAAE,WAAW,EAAG,GACpCA,EAAM,OAAO,EAAM,EAAE,CAAC,WAAW;AACnC;AAGA,SAAgBE,EACd,GACA,GACA;CACA,IAAMC,KAAY,MAAqB,EAAE,SAAS,WAAW,EAAE,SAAS,aAAa,EAAE,SAAS;CAuBhG,AArBAZ,EAAQ,iBAAiB,gBAAgB,MAAoB;EAC3D,EAAE,eAAe;CACnB,CAAC,GAKDA,EAAQ,iBAAiB,UAAU,MAAoB;EAGrD,AAFAa,EAAE,eAAe,GAEZb,EAAQ,YACXc,EAAGD,CAAC;CAER,CAAC,GAEDb,EAAQ,iBAAiB,UAAU,MAAqB;EACtD,AAAIY,EAASC,CAAC,KAAK,CAACb,EAAQ,YAC1Bc,EAAGD,CAAC;CAER,CAAC,GAEDb,EAAQ,iBAAiB,YAAY,MAAqB;EACxD,AAAIY,EAASC,CAAC,KAAK,CAACb,EAAQ,YAC1Ba,EAAE,eAAe;CAErB,CAAC;AACH"}

package/dist/internal/utils/keynav.js

@@ -1,6 +1,6 @@
 import { focusElementTimeout as e } from "./focus.js";
 import { clickOutsideElementBounds as t } from "./dom.js";
-//#region src/internal/utils/keynav.ts
+// src/internal/utils/keynav.ts
 function n(e, t, n) {
 	e.includes(t.code) && n();
 }
@@ -12,7 +12,6 @@ function r(n, r) {
 		!n.element.hidden && t.code === "Escape" && (t.preventDefault(), e(n.focusElement), r());
 	}, i);
 }
-//#endregion
 export { r as createLightDismiss, n as onKeys };
 
 //# sourceMappingURL=keynav.js.map

package/dist/internal/utils/keynav.js.map

@@ -1 +1 @@
-{"version":3,"file":"keynav.js","names":[],"sources":["../../../src/internal/utils/keynav.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { clickOutsideElementBounds } from './dom.js';\nimport { focusElementTimeout } from './focus.js';\n\nexport function onKeys(events: string[], event: KeyboardEvent, fn: () => void) {\n  if (events.includes(event.code)) {\n    fn();\n  }\n}\n\nexport function createLightDismiss(\n  options: { element: HTMLElement; focusElement?: HTMLElement; signal?: AbortSignal },\n  fn: () => void\n) {\n  const listenerOptions = options.signal ? { signal: options.signal } : undefined;\n\n  globalThis.document.addEventListener(\n    'pointerup',\n    (e: PointerEvent) => {\n      if (\n        !options.element.hidden &&\n        clickOutsideElementBounds(e, options.element) &&\n        clickOutsideElementBounds(e, options.focusElement!)\n      ) {\n        fn();\n      }\n    },\n    listenerOptions\n  );\n\n  options.element.addEventListener(\n    'keydown',\n    (e: KeyboardEvent) => {\n      if (!options.element.hidden && e.code === 'Escape') {\n        e.preventDefault();\n        focusElementTimeout(options.focusElement!);\n        fn();\n      }\n    },\n    listenerOptions\n  );\n}\n"],"mappings":";;;AAMA,SAAgB,EAAO,GAAkB,GAAsB,GAAgB;CAC7E,AAAI,EAAO,SAAS,EAAM,IAAI,KAC5B,EAAG;AAEP;AAEA,SAAgB,EACd,GACA,GACA;CACA,IAAM,IAAkB,EAAQ,SAAS,EAAE,QAAQ,EAAQ,OAAO,IAAI,KAAA;CAgBtE,AAdA,WAAW,SAAS,iBAClB,cACC,MAAoB;EACnB,AACE,CAAC,EAAQ,QAAQ,UACjB,EAA0B,GAAG,EAAQ,OAAO,KAC5C,EAA0B,GAAG,EAAQ,YAAa,KAElD,EAAG;CAEP,GACA,CACF,GAEA,EAAQ,QAAQ,iBACd,YACC,MAAqB;EACpB,AAAI,CAAC,EAAQ,QAAQ,UAAU,EAAE,SAAS,aACxC,EAAE,eAAe,GACjB,EAAoB,EAAQ,YAAa,GACzC,EAAG;CAEP,GACA,CACF;AACF"}
+{"version":3,"file":"keynav.js","names":["onKeys","events","event","fn","createLightDismiss","listenerOptions","options","clickOutsideElementBounds","e","focusElementTimeout"],"sources":["../../../src/internal/utils/keynav.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { clickOutsideElementBounds } from './dom.js';\nimport { focusElementTimeout } from './focus.js';\n\nexport function onKeys(events: string[], event: KeyboardEvent, fn: () => void) {\n  if (events.includes(event.code)) {\n    fn();\n  }\n}\n\nexport function createLightDismiss(\n  options: { element: HTMLElement; focusElement?: HTMLElement; signal?: AbortSignal },\n  fn: () => void\n) {\n  const listenerOptions = options.signal ? { signal: options.signal } : undefined;\n\n  globalThis.document.addEventListener(\n    'pointerup',\n    (e: PointerEvent) => {\n      if (\n        !options.element.hidden &&\n        clickOutsideElementBounds(e, options.element) &&\n        clickOutsideElementBounds(e, options.focusElement!)\n      ) {\n        fn();\n      }\n    },\n    listenerOptions\n  );\n\n  options.element.addEventListener(\n    'keydown',\n    (e: KeyboardEvent) => {\n      if (!options.element.hidden && e.code === 'Escape') {\n        e.preventDefault();\n        focusElementTimeout(options.focusElement!);\n        fn();\n      }\n    },\n    listenerOptions\n  );\n}\n"],"mappings":";;;AAMA,SAAgBA,EAAO,GAAkB,GAAsB,GAAgB;CAC7E,AAAIC,EAAO,SAASC,EAAM,IAAI,KAC5BC,EAAG;AAEP;AAEA,SAAgBC,EACd,GACA,GACA;CACA,IAAMC,IAAkBC,EAAQ,SAAS,EAAE,QAAQA,EAAQ,OAAO,IAAI,KAAA;CAgBtE,AAdA,WAAW,SAAS,iBAClB,cACC,MAAoB;EACnB,AACE,CAACA,EAAQ,QAAQ,UACjBC,EAA0B,GAAGD,EAAQ,OAAO,KAC5CC,EAA0B,GAAGD,EAAQ,YAAa,KAElDH,EAAG;CAEP,GACAE,CACF,GAEAC,EAAQ,QAAQ,iBACd,YACC,MAAqB;EACpB,AAAI,CAACA,EAAQ,QAAQ,UAAUE,EAAE,SAAS,aACxCA,EAAE,eAAe,GACjBC,EAAoBH,EAAQ,YAAa,GACzCH,EAAG;CAEP,GACAE,CACF;AACF"}

package/dist/internal/utils/numeric.js

@@ -1,4 +1,4 @@
-//#region src/internal/utils/numeric.ts
+// src/internal/utils/numeric.ts
 function e(e, t) {
 	return e !== void 0 && Number.isFinite(e) ? e : t;
 }
@@ -8,7 +8,6 @@ function t(e, t) {
 function n(e, t) {
 	return e !== void 0 && Number.isFinite(e) && e > 0 ? e : t;
 }
-//#endregion
 export { e as finiteOr, t as nonnegativeFiniteOr, n as positiveFiniteOr };
 
 //# sourceMappingURL=numeric.js.map

package/dist/internal/utils/numeric.js.map

@@ -1 +1 @@
-{"version":3,"file":"numeric.js","names":[],"sources":["../../../src/internal/utils/numeric.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function finiteOr(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) ? value : fallback;\n}\n\nexport function nonnegativeFiniteOr(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value >= 0 ? value : fallback;\n}\n\nexport function positiveFiniteOr(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;\n}\n"],"mappings":";AAGA,SAAgB,EAAS,GAA2B,GAA0B;CAC5E,OAAO,MAAU,KAAA,KAAa,OAAO,SAAS,CAAK,IAAI,IAAQ;AACjE;AAEA,SAAgB,EAAoB,GAA2B,GAA0B;CACvF,OAAO,MAAU,KAAA,KAAa,OAAO,SAAS,CAAK,KAAK,KAAS,IAAI,IAAQ;AAC/E;AAEA,SAAgB,EAAiB,GAA2B,GAA0B;CACpF,OAAO,MAAU,KAAA,KAAa,OAAO,SAAS,CAAK,KAAK,IAAQ,IAAI,IAAQ;AAC9E"}
+{"version":3,"file":"numeric.js","names":["finiteOr","value","fallback","nonnegativeFiniteOr","positiveFiniteOr"],"sources":["../../../src/internal/utils/numeric.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function finiteOr(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) ? value : fallback;\n}\n\nexport function nonnegativeFiniteOr(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value >= 0 ? value : fallback;\n}\n\nexport function positiveFiniteOr(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;\n}\n"],"mappings":";AAGA,SAAgBA,EAAS,GAA2B,GAA0B;CAC5E,OAAOC,MAAU,KAAA,KAAa,OAAO,SAASA,CAAK,IAAIA,IAAQC;AACjE;AAEA,SAAgBC,EAAoB,GAA2B,GAA0B;CACvF,OAAOF,MAAU,KAAA,KAAa,OAAO,SAASA,CAAK,KAAKA,KAAS,IAAIA,IAAQC;AAC/E;AAEA,SAAgBE,EAAiB,GAA2B,GAA0B;CACpF,OAAOH,MAAU,KAAA,KAAa,OAAO,SAASA,CAAK,KAAKA,IAAQ,IAAIA,IAAQC;AAC9E"}

package/dist/internal/utils/objects.js

@@ -1,4 +1,4 @@
-//#region src/internal/utils/objects.ts
+// src/internal/utils/objects.ts
 function e(e) {
 	return !!e && typeof e == "object" && !Array.isArray(e);
 }
@@ -19,7 +19,6 @@ function n(e) {
 function r(e, t) {
 	return Math.sign(t - e) * Math.abs(e - t);
 }
-//#endregion
 export { n as formatStandardNumber, r as getDifference, e as isObject, t as parseVersion };
 
 //# sourceMappingURL=objects.js.map

package/dist/internal/utils/objects.js.map

@@ -1 +1 @@
-{"version":3,"file":"objects.js","names":[],"sources":["../../../src/internal/utils/objects.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function isObject(item: unknown): item is Record<string, unknown> {\n  return !!item && typeof item === 'object' && !Array.isArray(item);\n}\n\nexport function parseVersion(version: string) {\n  const [major, minor, patch] = version.split('.').map(v => {\n    const n = parseInt(v, 10);\n    return Number.isNaN(n) ? -1 : n;\n  });\n  return { major: major ?? -1, minor: minor ?? -1, patch: patch ?? -1 };\n}\n\nexport function formatStandardNumber(number: number) {\n  return new Intl.NumberFormat().format(number);\n}\n\nexport function getDifference(minuend: number, subtrahend: number) {\n  return Math.sign(subtrahend - minuend) * Math.abs(minuend - subtrahend);\n}\n"],"mappings":";AAGA,SAAgB,EAAS,GAAgD;CACvE,OAAO,CAAC,CAAC,KAAQ,OAAO,KAAS,YAAY,CAAC,MAAM,QAAQ,CAAI;AAClE;AAEA,SAAgB,EAAa,GAAiB;CAC5C,IAAM,CAAC,GAAO,GAAO,KAAS,EAAQ,MAAM,GAAG,CAAC,CAAC,KAAI,MAAK;EACxD,IAAM,IAAI,SAAS,GAAG,EAAE;EACxB,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK;CAChC,CAAC;CACD,OAAO;EAAE,OAAO,KAAS;EAAI,OAAO,KAAS;EAAI,OAAO,KAAS;CAAG;AACtE;AAEA,SAAgB,EAAqB,GAAgB;CACnD,OAAO,IAAI,KAAK,aAAa,CAAC,CAAC,OAAO,CAAM;AAC9C;AAEA,SAAgB,EAAc,GAAiB,GAAoB;CACjE,OAAO,KAAK,KAAK,IAAa,CAAO,IAAI,KAAK,IAAI,IAAU,CAAU;AACxE"}
+{"version":3,"file":"objects.js","names":["isObject","item","parseVersion","major","minor","patch","version","n","v","formatStandardNumber","number","getDifference","subtrahend","minuend"],"sources":["../../../src/internal/utils/objects.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function isObject(item: unknown): item is Record<string, unknown> {\n  return !!item && typeof item === 'object' && !Array.isArray(item);\n}\n\nexport function parseVersion(version: string) {\n  const [major, minor, patch] = version.split('.').map(v => {\n    const n = parseInt(v, 10);\n    return Number.isNaN(n) ? -1 : n;\n  });\n  return { major: major ?? -1, minor: minor ?? -1, patch: patch ?? -1 };\n}\n\nexport function formatStandardNumber(number: number) {\n  return new Intl.NumberFormat().format(number);\n}\n\nexport function getDifference(minuend: number, subtrahend: number) {\n  return Math.sign(subtrahend - minuend) * Math.abs(minuend - subtrahend);\n}\n"],"mappings":";AAGA,SAAgBA,EAAS,GAAgD;CACvE,OAAO,CAAC,CAACC,KAAQ,OAAOA,KAAS,YAAY,CAAC,MAAM,QAAQA,CAAI;AAClE;AAEA,SAAgBC,EAAa,GAAiB;CAC5C,IAAM,CAACC,GAAOC,GAAOC,KAASC,EAAQ,MAAM,GAAG,CAAC,CAAC,KAAI,MAAK;EACxD,IAAMC,IAAI,SAASC,GAAG,EAAE;EACxB,OAAO,OAAO,MAAMD,CAAC,IAAI,KAAKA;CAChC,CAAC;CACD,OAAO;EAAE,OAAOJ,KAAS;EAAI,OAAOC,KAAS;EAAI,OAAOC,KAAS;CAAG;AACtE;AAEA,SAAgBI,EAAqB,GAAgB;CACnD,OAAO,IAAI,KAAK,aAAa,CAAC,CAAC,OAAOC,CAAM;AAC9C;AAEA,SAAgBC,EAAc,GAAiB,GAAoB;CACjE,OAAO,KAAK,KAAKC,IAAaC,CAAO,IAAI,KAAK,IAAIA,IAAUD,CAAU;AACxE"}

package/dist/internal/utils/strings.js

@@ -1,4 +1,4 @@
-//#region src/internal/utils/strings.ts
+// src/internal/utils/strings.ts
 function e(e) {
 	let t = /* @__PURE__ */ new Map([
 		[1024 ** 4, "TB"],
@@ -16,7 +16,6 @@ function t(e) {
 }
 var n = "";
 n = "https://nvidia.github.io/elements";
-//#endregion
 export { n as DOCS_URL, e as formatFileSize, t as shiftLeft };
 
 //# sourceMappingURL=strings.js.map

package/dist/internal/utils/strings.js.map

@@ -1 +1 @@
-{"version":3,"file":"strings.js","names":[],"sources":["../../../src/internal/utils/strings.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\n/** formats a file size in bytes to a human readable string */\nexport function formatFileSize(size: number): string {\n  const thresholds = new Map<number, string>([\n    [1024 ** 4, 'TB'],\n    [1024 ** 3, 'GB'],\n    [1024 ** 2, 'MB'],\n    [1024 ** 1, 'KB'],\n    [1, 'B']\n  ]);\n  for (const [threshold, unit] of thresholds.entries()) {\n    if (size >= threshold) {\n      return `${(size / threshold).toFixed(2)} ${unit}`;\n    }\n  }\n  return `0`;\n}\n\n/** removes leading white space for a multiline string */\nexport function shiftLeft(value: string) {\n  const shift = value.replace(/^\\n|\\n$/g, '').search(/\\S|$/);\n  return value\n    .trim()\n    .split('\\n')\n    .map(line => {\n      return line\n        .split('')\n        .filter((c, i) => i >= shift || c !== ' ')\n        .join('');\n    })\n    .join('\\n');\n}\n\nexport let DOCS_URL = '';\n/* @ts-expect-error -- VITE_BUNDLE_CONFIG is only defined at build time */\nif (!import.meta.env.VITE_BUNDLE_CONFIG) {\n  DOCS_URL = 'https://nvidia.github.io/elements';\n}\n"],"mappings":";AAIA,SAAgB,EAAe,GAAsB;CACnD,IAAM,oBAAa,IAAI,IAAoB;EACzC,CAAC,QAAQ,GAAG,IAAI;EAChB,CAAC,QAAQ,GAAG,IAAI;EAChB,CAAC,QAAQ,GAAG,IAAI;EAChB,CAAC,MAAW,IAAI;EAChB,CAAC,GAAG,GAAG;CACT,CAAC;CACD,KAAK,IAAM,CAAC,GAAW,MAAS,EAAW,QAAQ,GACjD,IAAI,KAAQ,GACV,OAAO,IAAI,IAAO,EAAA,CAAW,QAAQ,CAAC,EAAE,GAAG;CAG/C,OAAO;AACT;AAGA,SAAgB,EAAU,GAAe;CACvC,IAAM,IAAQ,EAAM,QAAQ,YAAY,EAAE,CAAC,CAAC,OAAO,MAAM;CACzD,OAAO,EACJ,KAAK,CAAC,CACN,MAAM,IAAI,CAAC,CACX,KAAI,MACI,EACJ,MAAM,EAAE,CAAC,CACT,QAAQ,GAAG,MAAM,KAAK,KAAS,MAAM,GAAG,CAAC,CACzC,KAAK,EAAE,CACX,CAAC,CACD,KAAK,IAAI;AACd;AAEA,IAAW,IAAW;AAGpB,IAAW"}
+{"version":3,"file":"strings.js","names":["formatFileSize","thresholds","threshold","unit","size","shiftLeft","shift","value","line","i","c","DOCS_URL"],"sources":["../../../src/internal/utils/strings.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\n/** formats a file size in bytes to a human readable string */\nexport function formatFileSize(size: number): string {\n  const thresholds = new Map<number, string>([\n    [1024 ** 4, 'TB'],\n    [1024 ** 3, 'GB'],\n    [1024 ** 2, 'MB'],\n    [1024 ** 1, 'KB'],\n    [1, 'B']\n  ]);\n  for (const [threshold, unit] of thresholds.entries()) {\n    if (size >= threshold) {\n      return `${(size / threshold).toFixed(2)} ${unit}`;\n    }\n  }\n  return `0`;\n}\n\n/** removes leading white space for a multiline string */\nexport function shiftLeft(value: string) {\n  const shift = value.replace(/^\\n|\\n$/g, '').search(/\\S|$/);\n  return value\n    .trim()\n    .split('\\n')\n    .map(line => {\n      return line\n        .split('')\n        .filter((c, i) => i >= shift || c !== ' ')\n        .join('');\n    })\n    .join('\\n');\n}\n\nexport let DOCS_URL = '';\n/* @ts-expect-error -- VITE_BUNDLE_CONFIG is only defined at build time */\nif (!import.meta.env.VITE_BUNDLE_CONFIG) {\n  DOCS_URL = 'https://nvidia.github.io/elements';\n}\n"],"mappings":";AAIA,SAAgBA,EAAe,GAAsB;CACnD,IAAMC,oBAAa,IAAI,IAAoB;EACzC,CAAC,QAAQ,GAAG,IAAI;EAChB,CAAC,QAAQ,GAAG,IAAI;EAChB,CAAC,QAAQ,GAAG,IAAI;EAChB,CAAC,MAAW,IAAI;EAChB,CAAC,GAAG,GAAG;CACT,CAAC;CACD,KAAK,IAAM,CAACC,GAAWC,MAASF,EAAW,QAAQ,GACjD,IAAIG,KAAQF,GACV,OAAO,IAAIE,IAAOF,EAAA,CAAW,QAAQ,CAAC,EAAE,GAAGC;CAG/C,OAAO;AACT;AAGA,SAAgBE,EAAU,GAAe;CACvC,IAAMC,IAAQC,EAAM,QAAQ,YAAY,EAAE,CAAC,CAAC,OAAO,MAAM;CACzD,OAAOA,EACJ,KAAK,CAAC,CACN,MAAM,IAAI,CAAC,CACX,KAAI,MACIC,EACJ,MAAM,EAAE,CAAC,CACT,QAAQ,GAAG,MAAMC,KAAKH,KAASI,MAAM,GAAG,CAAC,CACzC,KAAK,EAAE,CACX,CAAC,CACD,KAAK,IAAI;AACd;AAEA,IAAWC,IAAW;AAGpB,IAAW"}

package/dist/internal/utils/supports.js

@@ -1,4 +1,4 @@
-//#region src/internal/utils/supports.ts
+// src/internal/utils/supports.ts
 function e() {
 	return globalThis.CSS?.supports?.("position-area", "top") || globalThis.CSS?.supports?.("inset-area", "top");
 }
@@ -8,7 +8,6 @@ function t() {
 function n() {
 	return globalThis.CSS?.supports?.("inset-area", "top");
 }
-//#endregion
 export { n as supportsCSSLegacyInsetArea, t as supportsCSSPositionArea, e as supportsNativeCSSAnchorPosition };
 
 //# sourceMappingURL=supports.js.map

package/dist/internal/utils/supports.js.map

@@ -1 +1 @@
-{"version":3,"file":"supports.js","names":[],"sources":["../../../src/internal/utils/supports.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function supportsNativeCSSAnchorPosition() {\n  return globalThis.CSS?.supports?.('position-area', 'top') || globalThis.CSS?.supports?.('inset-area', 'top');\n}\n\nexport function supportsCSSPositionArea() {\n  return globalThis.CSS?.supports?.('position-area', 'top');\n}\n\nexport function supportsCSSLegacyInsetArea() {\n  return globalThis.CSS?.supports?.('inset-area', 'top');\n}\n"],"mappings":";AAGA,SAAgB,IAAkC;CAChD,OAAO,WAAW,KAAK,WAAW,iBAAiB,KAAK,KAAK,WAAW,KAAK,WAAW,cAAc,KAAK;AAC7G;AAEA,SAAgB,IAA0B;CACxC,OAAO,WAAW,KAAK,WAAW,iBAAiB,KAAK;AAC1D;AAEA,SAAgB,IAA6B;CAC3C,OAAO,WAAW,KAAK,WAAW,cAAc,KAAK;AACvD"}
+{"version":3,"file":"supports.js","names":["supportsNativeCSSAnchorPosition","supportsCSSPositionArea","supportsCSSLegacyInsetArea"],"sources":["../../../src/internal/utils/supports.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function supportsNativeCSSAnchorPosition() {\n  return globalThis.CSS?.supports?.('position-area', 'top') || globalThis.CSS?.supports?.('inset-area', 'top');\n}\n\nexport function supportsCSSPositionArea() {\n  return globalThis.CSS?.supports?.('position-area', 'top');\n}\n\nexport function supportsCSSLegacyInsetArea() {\n  return globalThis.CSS?.supports?.('inset-area', 'top');\n}\n"],"mappings":";AAGA,SAAgBA,IAAkC;CAChD,OAAO,WAAW,KAAK,WAAW,iBAAiB,KAAK,KAAK,WAAW,KAAK,WAAW,cAAc,KAAK;AAC7G;AAEA,SAAgBC,IAA0B;CACxC,OAAO,WAAW,KAAK,WAAW,iBAAiB,KAAK;AAC1D;AAEA,SAAgBC,IAA6B;CAC3C,OAAO,WAAW,KAAK,WAAW,cAAc,KAAK;AACvD"}

package/dist/joystick/define.js

@@ -1,7 +1,6 @@
 import { Joystick as e } from "./joystick2.js";
 import { define as t } from "@nvidia-elements/foundations/internal/define";
-//#region src/joystick/define.ts
+// src/joystick/define.ts
 t(e);
-//#endregion
 
 //# sourceMappingURL=define.js.map

package/dist/joystick/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","names":[],"sources":["../../src/joystick/define.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { define } from '@nvidia-elements/foundations/internal/define';\nimport { Joystick } from '@nvidia-elements/core/joystick';\n\ndefine(Joystick);\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'nve-joystick': Joystick;\n  }\n}\n"],"mappings":";;;AAMA,EAAO,CAAQ"}
+{"version":3,"file":"define.js","names":["define","Joystick"],"sources":["../../src/joystick/define.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { define } from '@nvidia-elements/foundations/internal/define';\nimport { Joystick } from '@nvidia-elements/core/joystick';\n\ndefine(Joystick);\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'nve-joystick': Joystick;\n  }\n}\n"],"mappings":";;;AAMAA,EAAOC,CAAQ"}

package/dist/joystick/index.js

@@ -1,2 +1 @@
-import { Joystick as e } from "./joystick2.js";
-export { e as Joystick };
+export { Joystick } from "./joystick2.js";

package/dist/joystick/joystick.examples.js

@@ -1,6 +1,5 @@
-//#region src/joystick/joystick.examples.ts
+// src/joystick/joystick.examples.ts
 var e = "";
-//#endregion
 export { e as default };
 
 //# sourceMappingURL=joystick.examples.js.map

package/dist/joystick/joystick.examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"joystick.examples.js","names":[],"sources":["../../src/joystick/joystick.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html } from 'lit';\nimport '@nvidia-elements/core/joystick/define.js';\nimport '@nvidia-elements/core/button/define.js';\nimport '@nvidia-elements/core/range/define.js';\n\nexport default { title: 'Elements/Joystick', component: 'nve-joystick' };\n\n/**\n * @summary Select a direction and intensity with a circular movement region. Release the pointer or arrow keys to return to center.\n * @description Both axes use normalized values from -1 to 1. Applications can derive length with Math.hypot(x, y) and angle with Math.atan2(-y, x). This angle uses radians from the rightward direction with counterclockwise positive rotation. Use undefined at neutral. Keep these derived quantities outside the writable value. The angle does not describe the robot's heading.\n */\nexport const Default = {\n  render: () => html`<nve-joystick aria-label=\"Movement\"></nve-joystick>`\n};\n\n/**\n * @summary Choose small, medium, or large controls to fit the available space. Each size scales the movement surface and thumb together.\n */\nexport const Size = {\n  render: () => html`\n    <div nve-layout=\"row gap:lg align:wrap\">\n      <nve-joystick aria-label=\"Small movement\" size=\"sm\"></nve-joystick>\n      <nve-joystick aria-label=\"Medium movement\" size=\"md\"></nve-joystick>\n      <nve-joystick aria-label=\"Large movement\" size=\"lg\"></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Overlay a joystick with a translucent background on a checkered scene. Keep the border and thumb at full opacity for contrast.\n * @tags theme\n */\nexport const Opacity = {\n  render: () => html`\n    <div\n      nve-layout=\"row align:center pad:lg\"\n      style=\"\n        width: 100%;\n        min-height: 16rem;\n        background: repeating-conic-gradient(\n            var(--nve-sys-layer-container-background) 0% 25%,\n            var(--nve-sys-layer-canvas-background) 0% 50%\n          )\n          center / 2rem 2rem;\n      \"\n    >\n      <nve-joystick aria-label=\"Movement\" opacity></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Compare circular, square, and single-axis movement regions. Choose a constraint that matches the available commands.\n * @description Circle bounds normalized magnitude to one. Square allows independent full-scale axes and a magnitude of up to Math.SQRT2. Use circle for planar direction and intensity, or square for independent limits such as forward velocity and turning rate. Equally scaled planar velocity axes can produce about 41% greater diagonal speed with square input.\n */\nexport const Constraints = {\n  render: () => html`\n    <div nve-layout=\"row gap:lg align:wrap\">\n      <nve-joystick aria-label=\"Circular movement\"></nve-joystick>\n      <nve-joystick aria-label=\"Independent axes\" constraint=\"square\"></nve-joystick>\n      <nve-joystick aria-label=\"Turn\" constraint=\"horizontal\"></nve-joystick>\n      <nve-joystick aria-label=\"Vertical movement\" constraint=\"vertical\"></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Keep the last position after release for persistent target selection. Press Escape during an interaction to return to center.\n */\nexport const Hold = {\n  render: () => html`<nve-joystick aria-label=\"Persistent target\" release=\"hold\"></nve-joystick>`\n};\n\n/**\n * @summary Display recorded input without generating control events. Use read-only state for inspection and disabled state for unavailable controls.\n * @description Set readOnly to true before assigning recorded vectors through .value. Use undefined for an absent sample and a zero vector for recorded neutral input. The recording layer captures source, sample time, engagement transitions, and mapping configuration. Preserve its clock during replay and avoid applying input shaping to recorded samples again.\n */\nexport const States = {\n  render: () => html`\n    <div nve-layout=\"row gap:lg align:wrap\">\n      <nve-joystick aria-label=\"Recorded input\" readonly value='{\"x\":0.4,\"y\":-0.6}'></nve-joystick>\n      <nve-joystick aria-label=\"Unavailable control\" disabled></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Map travel and turn input to body-frame velocities in meters and radians per second. Engage either joystick to update its command axes.\n * @description Input maps to ROS body axes: x-forward, y-left, z-up, with positive yaw counterclockwise. Travel uses square constraints for independent axis limits; use circle to bound normalized translation magnitude. The illustrative maxima are 1 m/s forward, 0.5 m/s lateral, and 1 rad/s yaw. Each control's :state(active) CSS custom state gates its displayed velocity. Interaction events refresh the readouts. The application chooses its limits and publishes the latest command at its own cadence, including while input remains stationary.\n */\nexport const TravelTurn = {\n  render: () => html`\n    <div id=\"joystick-travel-turn\" nve-layout=\"column gap:lg\">\n      <div nve-layout=\"row gap:lg align:wrap\">\n        <div nve-layout=\"column gap:sm\">\n          <label for=\"joystick-travel\">Travel</label>\n          <nve-joystick id=\"joystick-travel\" constraint=\"square\"></nve-joystick>\n          <output data-travel style=\"width: 170px\">Released: x 0.00, y 0.00</output>\n        </div>\n        <div nve-layout=\"column gap:sm\">\n          <label for=\"joystick-turn\">Turn</label>\n          <nve-joystick id=\"joystick-turn\" constraint=\"horizontal\"></nve-joystick>\n          <output data-turn>Released: x 0.00, y 0.00</output>\n        </div>\n      </div>\n      <output data-command>vx 0.00 m/s, vy 0.00 m/s, wz 0.00 rad/s</output>\n    </div>\n    <script type=\"module\">\n      const group = document.querySelector('#joystick-travel-turn');\n      const travel = group.querySelector('#joystick-travel');\n      const turn = group.querySelector('#joystick-turn');\n      const maxForwardMps = 1;\n      const maxLateralMps = 0.5;\n      const maxYawRadps = 1;\n\n      function describe(control) {\n        const value = control.value;\n        const state = control.matches(':state(active)') ? 'Engaged' : 'Released';\n        return state + ': ' + (value ? 'x ' + value.x.toFixed(2) + ', y ' + value.y.toFixed(2) : 'No sample');\n      }\n\n      function update() {\n        group.querySelector('[data-travel]').textContent = describe(travel);\n        group.querySelector('[data-turn]').textContent = describe(turn);\n        const translation = travel.matches(':state(active)') ? travel.value : undefined;\n        const rotation = turn.matches(':state(active)') ? turn.value : undefined;\n        const command = {\n          vx: -(translation?.y ?? 0) * maxForwardMps,\n          vy: -(translation?.x ?? 0) * maxLateralMps,\n          wz: -(rotation?.x ?? 0) * maxYawRadps\n        };\n        group.querySelector('[data-command]').textContent =\n          'vx ' + command.vx.toFixed(2) + ' m/s, vy ' + command.vy.toFixed(2) + ' m/s, wz ' + command.wz.toFixed(2) + ' rad/s';\n      }\n\n      for (const type of ['input', 'interaction-start', 'interaction-end']) group.addEventListener(type, update);\n      await customElements.whenDefined('nve-joystick');\n      update();\n    </script>\n  `\n};\n\n/**\n * @summary Adjust a radial dead zone and response curve before mapping input to commands. Compare the shaped vector with the unchanged joystick value.\n * @description A dead zone of zero and response exponent of one leave circular input unchanged. The dead zone makes neutral easier to select; a larger exponent provides finer control near neutral. The remaining range scales back to full output at the boundary and preserves direction. Shaping produces a separate command vector without rewriting .value. Map it to physical units afterward. Apply filtering in one input layer to avoid processing hardware or recorded samples twice. [ROS joystick parameters](https://github.com/ros-drivers/joystick_drivers/blob/ros2/joy/README.md)\n */\nexport const InputShaping = {\n  render: () => html`\n    <div id=\"joystick-shaping\" nve-layout=\"column gap:md\">\n      <nve-joystick aria-label=\"Movement\" constraint=\"circle\"></nve-joystick>\n      <nve-range>\n        <label for=\"joystick-deadzone\">Dead zone</label>\n        <input id=\"joystick-deadzone\" type=\"range\" min=\"0\" max=\"0.5\" step=\"0.01\" value=\"0\" />\n      </nve-range>\n      <nve-range>\n        <label for=\"joystick-response\">Response exponent</label>\n        <input id=\"joystick-response\" type=\"range\" min=\"1\" max=\"3\" step=\"0.1\" value=\"1\" />\n      </nve-range>\n      <output data-settings>Dead zone 0.00, response 1.0</output>\n      <output data-raw>Raw: x 0.00, y 0.00</output>\n      <output data-shaped>Shaped: x 0.00, y 0.00</output>\n    </div>\n    <script type=\"module\">\n      const group = document.querySelector('#joystick-shaping');\n      const joystick = group.querySelector('nve-joystick');\n      const deadzone = group.querySelector('#joystick-deadzone');\n      const response = group.querySelector('#joystick-response');\n\n      function shape(value, deadzone, exponent) {\n        const magnitude = Math.hypot(value.x, value.y);\n        if (magnitude <= deadzone) return { x: 0, y: 0 };\n        const strength = ((magnitude - deadzone) / (1 - deadzone)) ** exponent;\n        return { x: value.x / magnitude * strength, y: value.y / magnitude * strength };\n      }\n\n      function update() {\n        const raw = joystick.value ?? { x: 0, y: 0 };\n        const shaped = shape(raw, deadzone.valueAsNumber, response.valueAsNumber);\n        group.querySelector('[data-settings]').textContent =\n          'Dead zone ' + deadzone.valueAsNumber.toFixed(2) + ', response ' + response.valueAsNumber.toFixed(1);\n        group.querySelector('[data-raw]').textContent = 'Raw: x ' + raw.x.toFixed(2) + ', y ' + raw.y.toFixed(2);\n        group.querySelector('[data-shaped]').textContent = 'Shaped: x ' + shaped.x.toFixed(2) + ', y ' + shaped.y.toFixed(2);\n      }\n\n      group.addEventListener('input', update);\n      await customElements.whenDefined('nve-joystick');\n      update();\n    </script>\n  `\n};\n\n/**\n * @summary Submit both axes as separate named fields and restore the declared position with form reset. Use held values when selecting persistent form targets.\n */\nexport const Form = {\n  render: () => html`\n    <form nve-layout=\"column gap:md\">\n      <label for=\"joystick-form\">Target</label>\n      <nve-joystick id=\"joystick-form\" name=\"target\" release=\"hold\" value='{\"x\":0.2,\"y\":-0.3}'></nve-joystick>\n      <nve-button type=\"reset\">Reset target</nve-button>\n    </form>\n  `\n};\n\n/**\n * @summary Override joystickPosition through i18n to localize spoken coordinates while keeping built-in position announcements.\n */\nexport const AccessibleFeedback = {\n  render: () => html`\n    <nve-joystick aria-label=\"Movement\" i18n='{\"joystickPosition\":\"Horizontal {x}, vertical {y}.\"}'></nve-joystick>\n  `\n};\n\n/**\n * @summary Supply application announcements with a labeled output. Disable built-in announcements to avoid duplicate feedback.\n */\nexport const ExternalFeedback = {\n  render: () => html`\n    <div id=\"joystick-external-feedback\" nve-layout=\"column gap:md\">\n      <nve-joystick aria-label=\"Target\" announce=\"off\" release=\"hold\"></nve-joystick>\n      <output aria-live=\"polite\" aria-atomic=\"true\">Target: X 0, Y 0</output>\n    </div>\n    <script type=\"module\">\n      const root = document.querySelector('#joystick-external-feedback');\n      const joystick = root.querySelector('nve-joystick');\n      const output = root.querySelector('output');\n      joystick.addEventListener('change', () => {\n        const value = joystick.value;\n        output.textContent = value ? 'Target: X ' + value.x + ', Y ' + value.y : 'No target';\n      });\n    </script>\n  `\n};\n"],"mappings":";AAGA,IAAA,IAAS"}
+{"version":3,"file":"joystick.examples.js","names":["joystick_examples_default"],"sources":["../../src/joystick/joystick.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html } from 'lit';\nimport '@nvidia-elements/core/joystick/define.js';\nimport '@nvidia-elements/core/button/define.js';\nimport '@nvidia-elements/core/range/define.js';\n\nexport default { title: 'Elements/Joystick', component: 'nve-joystick' };\n\n/**\n * @summary Select a direction and intensity with a circular movement region. Release the pointer or arrow keys to return to center.\n * @description Both axes use normalized values from -1 to 1. Applications can derive length with Math.hypot(x, y) and angle with Math.atan2(-y, x). This angle uses radians from the rightward direction with counterclockwise positive rotation. Use undefined at neutral. Keep these derived quantities outside the writable value. The angle does not describe the robot's heading.\n */\nexport const Default = {\n  render: () => html`<nve-joystick aria-label=\"Movement\"></nve-joystick>`\n};\n\n/**\n * @summary Choose small, medium, or large controls to fit the available space. Each size scales the movement surface and thumb together.\n */\nexport const Size = {\n  render: () => html`\n    <div nve-layout=\"row gap:lg align:wrap\">\n      <nve-joystick aria-label=\"Small movement\" size=\"sm\"></nve-joystick>\n      <nve-joystick aria-label=\"Medium movement\" size=\"md\"></nve-joystick>\n      <nve-joystick aria-label=\"Large movement\" size=\"lg\"></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Overlay a joystick with a translucent background on a checkered scene. Keep the border and thumb at full opacity for contrast.\n * @tags theme\n */\nexport const Opacity = {\n  render: () => html`\n    <div\n      nve-layout=\"row align:center pad:lg\"\n      style=\"\n        width: 100%;\n        min-height: 16rem;\n        background: repeating-conic-gradient(\n            var(--nve-sys-layer-container-background) 0% 25%,\n            var(--nve-sys-layer-canvas-background) 0% 50%\n          )\n          center / 2rem 2rem;\n      \"\n    >\n      <nve-joystick aria-label=\"Movement\" opacity></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Compare circular, square, and single-axis movement regions. Choose a constraint that matches the available commands.\n * @description Circle bounds normalized magnitude to one. Square allows independent full-scale axes and a magnitude of up to Math.SQRT2. Use circle for planar direction and intensity, or square for independent limits such as forward velocity and turning rate. Equally scaled planar velocity axes can produce about 41% greater diagonal speed with square input.\n */\nexport const Constraints = {\n  render: () => html`\n    <div nve-layout=\"row gap:lg align:wrap\">\n      <nve-joystick aria-label=\"Circular movement\"></nve-joystick>\n      <nve-joystick aria-label=\"Independent axes\" constraint=\"square\"></nve-joystick>\n      <nve-joystick aria-label=\"Turn\" constraint=\"horizontal\"></nve-joystick>\n      <nve-joystick aria-label=\"Vertical movement\" constraint=\"vertical\"></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Keep the last position after release for persistent target selection. Press Escape during an interaction to return to center.\n */\nexport const Hold = {\n  render: () => html`<nve-joystick aria-label=\"Persistent target\" release=\"hold\"></nve-joystick>`\n};\n\n/**\n * @summary Display recorded input without generating control events. Use read-only state for inspection and disabled state for unavailable controls.\n * @description Set readOnly to true before assigning recorded vectors through .value. Use undefined for an absent sample and a zero vector for recorded neutral input. The recording layer captures source, sample time, engagement transitions, and mapping configuration. Preserve its clock during replay and avoid applying input shaping to recorded samples again.\n */\nexport const States = {\n  render: () => html`\n    <div nve-layout=\"row gap:lg align:wrap\">\n      <nve-joystick aria-label=\"Recorded input\" readonly value='{\"x\":0.4,\"y\":-0.6}'></nve-joystick>\n      <nve-joystick aria-label=\"Unavailable control\" disabled></nve-joystick>\n    </div>\n  `\n};\n\n/**\n * @summary Map travel and turn input to body-frame velocities in meters and radians per second. Engage either joystick to update its command axes.\n * @description Input maps to ROS body axes: x-forward, y-left, z-up, with positive yaw counterclockwise. Travel uses square constraints for independent axis limits; use circle to bound normalized translation magnitude. The illustrative maxima are 1 m/s forward, 0.5 m/s lateral, and 1 rad/s yaw. Each control's :state(active) CSS custom state gates its displayed velocity. Interaction events refresh the readouts. The application chooses its limits and publishes the latest command at its own cadence, including while input remains stationary.\n */\nexport const TravelTurn = {\n  render: () => html`\n    <div id=\"joystick-travel-turn\" nve-layout=\"column gap:lg\">\n      <div nve-layout=\"row gap:lg align:wrap\">\n        <div nve-layout=\"column gap:sm\">\n          <label for=\"joystick-travel\">Travel</label>\n          <nve-joystick id=\"joystick-travel\" constraint=\"square\"></nve-joystick>\n          <output data-travel style=\"width: 170px\">Released: x 0.00, y 0.00</output>\n        </div>\n        <div nve-layout=\"column gap:sm\">\n          <label for=\"joystick-turn\">Turn</label>\n          <nve-joystick id=\"joystick-turn\" constraint=\"horizontal\"></nve-joystick>\n          <output data-turn>Released: x 0.00, y 0.00</output>\n        </div>\n      </div>\n      <output data-command>vx 0.00 m/s, vy 0.00 m/s, wz 0.00 rad/s</output>\n    </div>\n    <script type=\"module\">\n      const group = document.querySelector('#joystick-travel-turn');\n      const travel = group.querySelector('#joystick-travel');\n      const turn = group.querySelector('#joystick-turn');\n      const maxForwardMps = 1;\n      const maxLateralMps = 0.5;\n      const maxYawRadps = 1;\n\n      function describe(control) {\n        const value = control.value;\n        const state = control.matches(':state(active)') ? 'Engaged' : 'Released';\n        return state + ': ' + (value ? 'x ' + value.x.toFixed(2) + ', y ' + value.y.toFixed(2) : 'No sample');\n      }\n\n      function update() {\n        group.querySelector('[data-travel]').textContent = describe(travel);\n        group.querySelector('[data-turn]').textContent = describe(turn);\n        const translation = travel.matches(':state(active)') ? travel.value : undefined;\n        const rotation = turn.matches(':state(active)') ? turn.value : undefined;\n        const command = {\n          vx: -(translation?.y ?? 0) * maxForwardMps,\n          vy: -(translation?.x ?? 0) * maxLateralMps,\n          wz: -(rotation?.x ?? 0) * maxYawRadps\n        };\n        group.querySelector('[data-command]').textContent =\n          'vx ' + command.vx.toFixed(2) + ' m/s, vy ' + command.vy.toFixed(2) + ' m/s, wz ' + command.wz.toFixed(2) + ' rad/s';\n      }\n\n      for (const type of ['input', 'interaction-start', 'interaction-end']) group.addEventListener(type, update);\n      await customElements.whenDefined('nve-joystick');\n      update();\n    </script>\n  `\n};\n\n/**\n * @summary Adjust a radial dead zone and response curve before mapping input to commands. Compare the shaped vector with the unchanged joystick value.\n * @description A dead zone of zero and response exponent of one leave circular input unchanged. The dead zone makes neutral easier to select; a larger exponent provides finer control near neutral. The remaining range scales back to full output at the boundary and preserves direction. Shaping produces a separate command vector without rewriting .value. Map it to physical units afterward. Apply filtering in one input layer to avoid processing hardware or recorded samples twice. [ROS joystick parameters](https://github.com/ros-drivers/joystick_drivers/blob/ros2/joy/README.md)\n */\nexport const InputShaping = {\n  render: () => html`\n    <div id=\"joystick-shaping\" nve-layout=\"column gap:md\">\n      <nve-joystick aria-label=\"Movement\" constraint=\"circle\"></nve-joystick>\n      <nve-range>\n        <label for=\"joystick-deadzone\">Dead zone</label>\n        <input id=\"joystick-deadzone\" type=\"range\" min=\"0\" max=\"0.5\" step=\"0.01\" value=\"0\" />\n      </nve-range>\n      <nve-range>\n        <label for=\"joystick-response\">Response exponent</label>\n        <input id=\"joystick-response\" type=\"range\" min=\"1\" max=\"3\" step=\"0.1\" value=\"1\" />\n      </nve-range>\n      <output data-settings>Dead zone 0.00, response 1.0</output>\n      <output data-raw>Raw: x 0.00, y 0.00</output>\n      <output data-shaped>Shaped: x 0.00, y 0.00</output>\n    </div>\n    <script type=\"module\">\n      const group = document.querySelector('#joystick-shaping');\n      const joystick = group.querySelector('nve-joystick');\n      const deadzone = group.querySelector('#joystick-deadzone');\n      const response = group.querySelector('#joystick-response');\n\n      function shape(value, deadzone, exponent) {\n        const magnitude = Math.hypot(value.x, value.y);\n        if (magnitude <= deadzone) return { x: 0, y: 0 };\n        const strength = ((magnitude - deadzone) / (1 - deadzone)) ** exponent;\n        return { x: value.x / magnitude * strength, y: value.y / magnitude * strength };\n      }\n\n      function update() {\n        const raw = joystick.value ?? { x: 0, y: 0 };\n        const shaped = shape(raw, deadzone.valueAsNumber, response.valueAsNumber);\n        group.querySelector('[data-settings]').textContent =\n          'Dead zone ' + deadzone.valueAsNumber.toFixed(2) + ', response ' + response.valueAsNumber.toFixed(1);\n        group.querySelector('[data-raw]').textContent = 'Raw: x ' + raw.x.toFixed(2) + ', y ' + raw.y.toFixed(2);\n        group.querySelector('[data-shaped]').textContent = 'Shaped: x ' + shaped.x.toFixed(2) + ', y ' + shaped.y.toFixed(2);\n      }\n\n      group.addEventListener('input', update);\n      await customElements.whenDefined('nve-joystick');\n      update();\n    </script>\n  `\n};\n\n/**\n * @summary Submit both axes as separate named fields and restore the declared position with form reset. Use held values when selecting persistent form targets.\n */\nexport const Form = {\n  render: () => html`\n    <form nve-layout=\"column gap:md\">\n      <label for=\"joystick-form\">Target</label>\n      <nve-joystick id=\"joystick-form\" name=\"target\" release=\"hold\" value='{\"x\":0.2,\"y\":-0.3}'></nve-joystick>\n      <nve-button type=\"reset\">Reset target</nve-button>\n    </form>\n  `\n};\n\n/**\n * @summary Override joystickPosition through i18n to localize spoken coordinates while keeping built-in position announcements.\n */\nexport const AccessibleFeedback = {\n  render: () => html`\n    <nve-joystick aria-label=\"Movement\" i18n='{\"joystickPosition\":\"Horizontal {x}, vertical {y}.\"}'></nve-joystick>\n  `\n};\n\n/**\n * @summary Supply application announcements with a labeled output. Disable built-in announcements to avoid duplicate feedback.\n */\nexport const ExternalFeedback = {\n  render: () => html`\n    <div id=\"joystick-external-feedback\" nve-layout=\"column gap:md\">\n      <nve-joystick aria-label=\"Target\" announce=\"off\" release=\"hold\"></nve-joystick>\n      <output aria-live=\"polite\" aria-atomic=\"true\">Target: X 0, Y 0</output>\n    </div>\n    <script type=\"module\">\n      const root = document.querySelector('#joystick-external-feedback');\n      const joystick = root.querySelector('nve-joystick');\n      const output = root.querySelector('output');\n      joystick.addEventListener('change', () => {\n        const value = joystick.value;\n        output.textContent = value ? 'Target: X ' + value.x + ', Y ' + value.y : 'No target';\n      });\n    </script>\n  `\n};\n"],"mappings":";AAGA,IAAAA,IAAS"}

package/dist/joystick/joystick.js

@@ -1,6 +1,5 @@
-//#region src/joystick/joystick.css?inline
+// src/joystick/joystick.css?inline
 var e = ":host{--_size-scale: 1;--width: calc(8.125rem * var(--_size-scale));--height: calc(8.125rem * var(--_size-scale));--background: var(--nve-sys-interaction-background);--opacity: .6;--border: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);--thumb-width: calc(var(--nve-ref-size-600) * var(--_size-scale));--thumb-height: calc(var(--nve-ref-size-600) * var(--_size-scale));--thumb-background: var(--nve-sys-text-muted-color);--thumb-border: var(--nve-ref-border-width-sm) solid var(--nve-sys-layer-canvas-background);--_axis-size: calc(3rem * var(--_size-scale));display:inline-block;width:var(--width);height:var(--height);user-select:none}[internal-host]{position:relative;box-sizing:border-box;width:100%;height:100%;border:var(--border);border-radius:50%;cursor:grab}.background{position:absolute;inset:0;z-index:0;border-radius:inherit;background:var(--background);pointer-events:none}:host([opacity]) .background{opacity:var(--opacity)}[internal-host]:before,[internal-host]:after{content:\"\";position:absolute;z-index:1}[internal-host]:before{left:50%;top:0;bottom:0;border-left:var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color)}[internal-host]:after{top:50%;left:0;right:0;border-top:var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color)}.travel{position:absolute;inset:calc(var(--thumb-height) / 2) calc(var(--thumb-width) / 2);z-index:2}.thumb{position:absolute;box-sizing:border-box;width:var(--thumb-width);height:var(--thumb-height);border:var(--thumb-border);border-radius:50%;background:var(--thumb-background);transform:translate(-50%,-50%)}:host([constraint=\"square\"]) [internal-host]{border-radius:var(--nve-ref-border-radius-md)}:host([size=\"sm\"]){--_size-scale: .8}:host([size=\"lg\"]){--_size-scale: 1.2}:host([constraint=\"horizontal\"]){--height: var(--_axis-size)}:host([constraint=\"vertical\"]){--width: var(--_axis-size)}:host([constraint=\"horizontal\"]) [internal-host],:host([constraint=\"vertical\"]) [internal-host]{border-radius:var(--nve-ref-border-radius-md)}:host(:focus-visible){outline:none}:host(:focus-visible) [internal-host]{outline:var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background);outline-offset:var(--nve-ref-space-xs)}:host(:state(active)){--thumb-background: var(--nve-sys-accent-secondary-background)}:host(:state(active)) [internal-host]{cursor:grabbing}:host([disabled]){--background: var(--nve-sys-interaction-disabled-background);--thumb-background: var(--nve-sys-interaction-disabled-color)}:host([disabled]) [internal-host],:host([readonly]) [internal-host]{cursor:default}.announcement{position:absolute;width:1px;height:1px;padding:0;margin:0;overflow:hidden;clip-path:inset(50%);white-space:nowrap;border:0}";
-//#endregion
 export { e as default };
 
 //# sourceMappingURL=joystick.js.map

package/dist/joystick/joystick.js.map

@@ -1 +1 @@
-{"version":3,"file":"joystick.js","names":[],"sources":["../../src/joystick/joystick.css?inline"],"sourcesContent":["/* SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. */\n/* SPDX-License-Identifier: Apache-2.0 */\n\n:host {\n  --_size-scale: 1;\n  --width: calc(8.125rem * var(--_size-scale));\n  --height: calc(8.125rem * var(--_size-scale));\n  --background: var(--nve-sys-interaction-background);\n  --opacity: 0.6;\n  --border: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);\n  --thumb-width: calc(var(--nve-ref-size-600) * var(--_size-scale));\n  --thumb-height: calc(var(--nve-ref-size-600) * var(--_size-scale));\n  --thumb-background: var(--nve-sys-text-muted-color);\n  --thumb-border: var(--nve-ref-border-width-sm) solid var(--nve-sys-layer-canvas-background);\n  --_axis-size: calc(3rem * var(--_size-scale));\n  display: inline-block;\n  width: var(--width);\n  height: var(--height);\n  user-select: none;\n}\n\n[internal-host] {\n  position: relative;\n  box-sizing: border-box;\n  width: 100%;\n  height: 100%;\n  border: var(--border);\n  border-radius: 50%;\n  cursor: grab;\n}\n\n.background {\n  position: absolute;\n  inset: 0;\n  z-index: 0;\n  border-radius: inherit;\n  background: var(--background);\n  pointer-events: none;\n}\n\n:host([opacity]) .background {\n  opacity: var(--opacity);\n}\n\n[internal-host]::before,\n[internal-host]::after {\n  content: '';\n  position: absolute;\n  z-index: 1;\n}\n\n[internal-host]::before {\n  left: 50%;\n  top: 0;\n  bottom: 0;\n  border-left: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);\n}\n\n[internal-host]::after {\n  top: 50%;\n  left: 0;\n  right: 0;\n  border-top: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);\n}\n\n.travel {\n  position: absolute;\n  inset: calc(var(--thumb-height) / 2) calc(var(--thumb-width) / 2);\n  z-index: 2;\n}\n\n.thumb {\n  position: absolute;\n  box-sizing: border-box;\n  width: var(--thumb-width);\n  height: var(--thumb-height);\n  border: var(--thumb-border);\n  border-radius: 50%;\n  background: var(--thumb-background);\n  transform: translate(-50%, -50%);\n}\n\n:host([constraint='square']) [internal-host] {\n  border-radius: var(--nve-ref-border-radius-md);\n}\n\n:host([size='sm']) {\n  --_size-scale: 0.8;\n}\n\n:host([size='lg']) {\n  --_size-scale: 1.2;\n}\n\n:host([constraint='horizontal']) {\n  --height: var(--_axis-size);\n}\n\n:host([constraint='vertical']) {\n  --width: var(--_axis-size);\n}\n\n:host([constraint='horizontal']) [internal-host],\n:host([constraint='vertical']) [internal-host] {\n  border-radius: var(--nve-ref-border-radius-md);\n}\n\n:host(:focus-visible) {\n  outline: none;\n}\n\n:host(:focus-visible) [internal-host] {\n  outline: var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background);\n  outline-offset: var(--nve-ref-space-xs);\n}\n\n:host(:state(active)) {\n  --thumb-background: var(--nve-sys-accent-secondary-background);\n}\n\n:host(:state(active)) [internal-host] {\n  cursor: grabbing;\n}\n\n:host([disabled]) {\n  --background: var(--nve-sys-interaction-disabled-background);\n  --thumb-background: var(--nve-sys-interaction-disabled-color);\n}\n\n:host([disabled]) [internal-host],\n:host([readonly]) [internal-host] {\n  cursor: default;\n}\n\n.announcement {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  padding: 0;\n  margin: 0;\n  overflow: hidden;\n  clip-path: inset(50%);\n  white-space: nowrap;\n  border: 0;\n}\n"],"mappings":""}
+{"version":3,"file":"joystick.js","names":["joystick_default"],"sources":["../../src/joystick/joystick.css?inline"],"sourcesContent":["/* SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. */\n/* SPDX-License-Identifier: Apache-2.0 */\n\n:host {\n  --_size-scale: 1;\n  --width: calc(8.125rem * var(--_size-scale));\n  --height: calc(8.125rem * var(--_size-scale));\n  --background: var(--nve-sys-interaction-background);\n  --opacity: 0.6;\n  --border: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);\n  --thumb-width: calc(var(--nve-ref-size-600) * var(--_size-scale));\n  --thumb-height: calc(var(--nve-ref-size-600) * var(--_size-scale));\n  --thumb-background: var(--nve-sys-text-muted-color);\n  --thumb-border: var(--nve-ref-border-width-sm) solid var(--nve-sys-layer-canvas-background);\n  --_axis-size: calc(3rem * var(--_size-scale));\n  display: inline-block;\n  width: var(--width);\n  height: var(--height);\n  user-select: none;\n}\n\n[internal-host] {\n  position: relative;\n  box-sizing: border-box;\n  width: 100%;\n  height: 100%;\n  border: var(--border);\n  border-radius: 50%;\n  cursor: grab;\n}\n\n.background {\n  position: absolute;\n  inset: 0;\n  z-index: 0;\n  border-radius: inherit;\n  background: var(--background);\n  pointer-events: none;\n}\n\n:host([opacity]) .background {\n  opacity: var(--opacity);\n}\n\n[internal-host]::before,\n[internal-host]::after {\n  content: '';\n  position: absolute;\n  z-index: 1;\n}\n\n[internal-host]::before {\n  left: 50%;\n  top: 0;\n  bottom: 0;\n  border-left: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);\n}\n\n[internal-host]::after {\n  top: 50%;\n  left: 0;\n  right: 0;\n  border-top: var(--nve-ref-border-width-sm) solid var(--nve-ref-border-color);\n}\n\n.travel {\n  position: absolute;\n  inset: calc(var(--thumb-height) / 2) calc(var(--thumb-width) / 2);\n  z-index: 2;\n}\n\n.thumb {\n  position: absolute;\n  box-sizing: border-box;\n  width: var(--thumb-width);\n  height: var(--thumb-height);\n  border: var(--thumb-border);\n  border-radius: 50%;\n  background: var(--thumb-background);\n  transform: translate(-50%, -50%);\n}\n\n:host([constraint='square']) [internal-host] {\n  border-radius: var(--nve-ref-border-radius-md);\n}\n\n:host([size='sm']) {\n  --_size-scale: 0.8;\n}\n\n:host([size='lg']) {\n  --_size-scale: 1.2;\n}\n\n:host([constraint='horizontal']) {\n  --height: var(--_axis-size);\n}\n\n:host([constraint='vertical']) {\n  --width: var(--_axis-size);\n}\n\n:host([constraint='horizontal']) [internal-host],\n:host([constraint='vertical']) [internal-host] {\n  border-radius: var(--nve-ref-border-radius-md);\n}\n\n:host(:focus-visible) {\n  outline: none;\n}\n\n:host(:focus-visible) [internal-host] {\n  outline: var(--nve-ref-border-width-md) solid var(--nve-sys-accent-secondary-background);\n  outline-offset: var(--nve-ref-space-xs);\n}\n\n:host(:state(active)) {\n  --thumb-background: var(--nve-sys-accent-secondary-background);\n}\n\n:host(:state(active)) [internal-host] {\n  cursor: grabbing;\n}\n\n:host([disabled]) {\n  --background: var(--nve-sys-interaction-disabled-background);\n  --thumb-background: var(--nve-sys-interaction-disabled-color);\n}\n\n:host([disabled]) [internal-host],\n:host([readonly]) [internal-host] {\n  cursor: default;\n}\n\n.announcement {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  padding: 0;\n  margin: 0;\n  overflow: hidden;\n  clip-path: inset(50%);\n  white-space: nowrap;\n  border: 0;\n}\n"],"mappings":""}

package/dist/joystick/joystick2.js

@@ -1,13 +1,13 @@
 import { GestureController as e } from "../internal/controllers/gesture.controller.js";
 import { useStyles as t } from "../internal/styles/index.js";
-import n from "../_virtual/_@oxc-project_runtime@0.147.0/helpers/esm/decorate.js";
+import n from "../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/decorate.js";
 import r from "./joystick.js";
 import { LitElement as i, html as a, isServer as o } from "lit";
 import { property as s } from "lit/decorators/property.js";
 import { I18nController as c } from "@nvidia-elements/foundations/internal/i18n";
 import { FormControlMixin as l } from "@nvidia-elements/forms/mixins";
 import { styleMap as u } from "lit/directives/style-map.js";
-//#region src/joystick/joystick.ts
+// src/joystick/joystick.ts
 var d = {
 	joystickPosition: "X {x}, Y {y}.",
 	joystickNoPosition: "No position.",
@@ -38,7 +38,7 @@ var d = {
 	static {
 		this.metadata = {
 			tag: "nve-joystick",
-			version: "2.20.1",
+			version: "2.20.3",
 			valueSchema: {
 				type: "object",
 				properties: {
@@ -105,12 +105,12 @@ var d = {
 				return;
 			}
 			let t = f[e.key];
-			!t || !this.#A(e, t) || (e.preventDefault(), this.#s.add(e.key), this.#c || this.#p({
+			t && this.#A(e, t) && (e.preventDefault(), this.#s.add(e.key), this.#c || this.#p({
 				source: "keyboard",
 				changed: !1
 			}), this.#c && this.#O(t));
 		}, this.#j = (e) => {
-			this.#c?.source !== "keyboard" || !this.#s.delete(e.key) || (e.preventDefault(), this.#s.size || this.#h("release"));
+			this.#c?.source === "keyboard" && this.#s.delete(e.key) && (e.preventDefault(), this.#s.size || this.#h("release"));
 		}, this.#M = () => {
 			this.#S(), this.#h("blur"), this.#b();
 		}, this.#N = () => {
@@ -174,7 +174,7 @@ var d = {
 		} catch {
 			return;
 		}
-		n !== void 0 && (!m(n) || !h(n, this.#f(n))) || (this.#h("reset"), this.value = n);
+		(n === void 0 || m(n) && h(n, this.#f(n))) && (this.#h("reset"), this.value = n);
 	}
 	_updateFormState() {
 		if (!this.name || !this.value) {
@@ -270,7 +270,7 @@ var d = {
 			let e = this.#n;
 			if (this.#n = void 0, !e || !this.#v) return;
 			let t = this.#_(e.value), n = e.kind === "return" ? this.i18n.joystickReturnedToCenter?.replaceAll("{position}", t) : t;
-			!n || n === this.#t || (this.#t = n, this.requestUpdate());
+			n && n !== this.#t && (this.#t = n, this.requestUpdate());
 		}, 500)));
 	}
 	#b() {
@@ -341,7 +341,6 @@ function m(e) {
 function h(e, t) {
 	return e !== void 0 && Math.abs(e.x - t.x) < 1e-12 && Math.abs(e.y - t.y) < 1e-12;
 }
-//#endregion
 export { p as Joystick };
 
 //# sourceMappingURL=joystick2.js.map

package/dist/joystick/joystick2.js.map

@@ -1 +1 @@
-{"version":3,"file":"joystick2.js","names":[],"sources":["../../src/joystick/joystick.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, isServer, LitElement, type PropertyValues } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { FormControlMixin } from '@nvidia-elements/forms/mixins';\nimport {\n  GestureController,\n  useStyles,\n  type Gesture,\n  type GestureInput,\n  type Size\n} from '@nvidia-elements/core/internal';\nimport { I18nController, type I18nDefaults } from '@nvidia-elements/foundations/internal/i18n';\nimport styles from './joystick.css?inline';\n\nexport interface JoystickValue {\n  readonly x: number;\n  readonly y: number;\n}\n\nexport type JoystickConstraint = 'circle' | 'square' | 'horizontal' | 'vertical';\nexport type JoystickRelease = 'center' | 'hold';\n\nexport interface JoystickInteractionStart {\n  readonly source: 'pointer' | 'keyboard';\n}\n\nexport interface JoystickInteractionEnd extends JoystickInteractionStart {\n  readonly reason:\n    | 'release'\n    | 'escape'\n    | 'pointer-cancel'\n    | 'lost-capture'\n    | 'blur'\n    | 'hidden'\n    | 'disabled'\n    | 'readonly'\n    | 'configuration-change'\n    | 'reset'\n    | 'disconnect';\n}\n\ntype Session = JoystickInteractionStart & { pointerId?: number; changed: boolean };\n\nconst i18nDefaults = {\n  joystickPosition: 'X {x}, Y {y}.',\n  joystickNoPosition: 'No position.',\n  joystickInstructions:\n    'Use arrow keys to adjust the enabled axes. Release to return to center. Press Escape to cancel.',\n  joystickHoldInstructions:\n    'Use arrow keys to adjust the enabled axes. Release to keep the position. Escape and interruptions return to center.',\n  joystickReturnedToCenter: '{position} Returned to center.'\n} satisfies I18nDefaults;\n\nconst directions: Record<string, JoystickValue> = {\n  ArrowLeft: { x: -1, y: 0 },\n  ArrowRight: { x: 1, y: 0 },\n  ArrowUp: { x: 0, y: -1 },\n  ArrowDown: { x: 0, y: 1 }\n};\n\n/* eslint-disable jsdoc/no-types -- The metadata analyzer needs the inherited generic value type. */\n/**\n * @element nve-joystick\n * @description A joystick selects a normalized two-axis vector with pointer or keyboard input.\n * Applications own physical units, coordinate frames, input shaping, publishing cadence, recording clocks,\n * command-outcome feedback, and alternative controls when needed.\n *\n * Give each joystick an accessible name with a label, aria-label, or aria-labelledby.\n * Editable controls use the application role to receive two-axis keyboard input.\n * The default accessible description includes both normalized coordinates, keyboard instructions, and release behavior.\n * A locked axis stays at zero; an absent value reads \"No position.\" Disabled and read-only controls omit instructions.\n * Coordinates use up to six decimal places and the document language for number formatting.\n * An explicit aria-description or aria-describedby replaces the default focus description through standard ARIA precedence;\n * it does not disable live announcements.\n * @documentation https://nvidia.github.io/elements/docs/elements/joystick/\n * @since 0.0.0\n * @entrypoint \\@nvidia-elements/core/joystick\n * @property {JoystickValue | undefined} value - 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 * @attribute {string} value - A JSON object containing normalized x and y coordinates.\n * @event input - 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 * @event change - Dispatched after a normal interaction completes and produces input. Cancellation sends any necessary neutral input without change.\n * @event interaction-start - Dispatched with the pointer or keyboard source after setting :state(active), including engagement at neutral.\n * @event interaction-end - 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 * @cssprop --width\n * @cssprop --height\n * @cssprop --background\n * @cssprop --opacity - Background opacity when the opacity flag is present. Defaults to 0.6. The border, crosshair, thumb, and focus indicator keep their opacity.\n * @cssprop --border\n * @cssprop --thumb-width\n * @cssprop --thumb-height\n * @cssprop --thumb-background\n * @cssprop --thumb-border\n * @stable false\n */\nexport class Joystick extends FormControlMixin<typeof LitElement, JoystickValue>(LitElement) {\n  static styles = useStyles([styles]);\n\n  static readonly metadata = {\n    tag: 'nve-joystick',\n    version: '0.0.0',\n    valueSchema: {\n      type: 'object' as const,\n      properties: {\n        x: { type: 'number' as const, minimum: -1, maximum: 1 },\n        y: { type: 'number' as const, minimum: -1, maximum: 1 }\n      },\n      required: ['x', 'y'],\n      additionalProperties: false\n    }\n  };\n\n  /**\n   * Constrains the movement region or selects one axis. Circle limits vector magnitude to one;\n   * square permits both axes at full scale and a magnitude of up to Math.SQRT2.\n   * With equally scaled planar velocity axes, square corners allow about 41% greater speed.\n   * Mixed forward-velocity and turning-rate axes have no common physical magnitude.\n   * Changing the constraint projects the current value silently and cancels an active interaction.\n   */\n  @property({ type: String, reflect: true }) constraint: JoystickConstraint = 'circle';\n\n  /** Sets surface and thumb size. At the default font size, sm is 104px, md is 130px, and lg is 156px. */\n  @property({ type: String, reflect: true }) size: Size = 'md';\n\n  /** Enables background transparency using the --opacity CSS custom property. */\n  @property({ type: Boolean, reflect: true }) opacity = false;\n\n  /**\n   * Determines whether normal release returns to center or holds the final vector.\n   * Interrupted interactions return to neutral in either mode. Form reset restores the declared default instead.\n   */\n  @property({ type: String, reflect: true }) release: JoystickRelease = 'center';\n\n  /**\n   * Sets the normalized increment for each arrow key press. Repeated presses continue adjusting;\n   * releasing the final arrow applies the release behavior. Escape cancels the interaction.\n   * Invalid steps fall back to 0.1. Modifier shortcuts and locked-axis directions remain available to the browser.\n   */\n  @property({ type: Number, attribute: 'keyboard-step' }) keyboardStep = 0.1;\n\n  /**\n   * Controls automatic position announcements. Focused user input produces polite announcements at most every 500 ms.\n   * A quick tap in center mode reports the input coordinates and the return to center.\n   * Escape announces the resulting coordinates without a separate cancellation message.\n   * Programmatic writes and read-only playback update the description without live announcements.\n   * Set off when the application supplies spoken output, the position description on focus remains available.\n   */\n  @property({ type: String }) announce: 'polite' | 'off' = 'polite';\n\n  readonly #i18nController: I18nController<this> = new I18nController(this, i18nDefaults);\n\n  /** Enables updating internal string values for internationalization. */\n  @property({ type: Object }) i18n = this.#i18nController.i18n;\n\n  #announcement = '';\n  #pendingFeedback?: { value: JoystickValue; kind: 'position' | 'return' };\n  #announcementTimer?: ReturnType<typeof setTimeout>;\n  #lastInput?: JoystickValue;\n  #writingInput = false;\n\n  readonly #gestureController = new GestureController(this, {\n    touchAction: () => (this.disabled || this.readOnly ? undefined : 'none'),\n    suppressNativeDrag: true\n  });\n  readonly #keys = new Set<string>();\n  #session?: Session;\n  #resetting = false;\n  #ownsTabIndex = false;\n\n  static override get observedAttributes() {\n    return [...super.observedAttributes, 'tabindex'];\n  }\n\n  override attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null) {\n    super.attributeChangedCallback(name, oldValue, newValue);\n    if (name === 'tabindex') this.#ownsTabIndex = false;\n  }\n\n  override get disabled(): boolean {\n    return super.disabled;\n  }\n\n  override set disabled(value: boolean | unknown) {\n    super.disabled = Boolean(value);\n    this.#checkAvailability();\n  }\n\n  override get readOnly(): boolean {\n    return super.readOnly;\n  }\n\n  override set readOnly(value: boolean | unknown) {\n    super.readOnly = Boolean(value);\n    this.#checkAvailability();\n  }\n\n  constructor() {\n    super();\n    this.value = { x: 0, y: 0 };\n  }\n\n  connectedCallback() {\n    const tabIndex = this.getAttribute('tabindex');\n    const ownsTabIndex = this.#ownsTabIndex || tabIndex === null;\n    super.connectedCallback();\n    // The forms mixin assigns tabindex on connection; keep the caller's focus order.\n    if (tabIndex !== null) this.setAttribute('tabindex', tabIndex);\n    this.#ownsTabIndex = ownsTabIndex;\n    if (this.hasUpdated) this.#gestureController.target = this;\n    this.addEventListener('nve-gesture-input', this.#handleGestureInput);\n    this.addEventListener('nve-gesture', this.#handleGesture);\n    this.addEventListener('keydown', this.#handleKeyDown);\n    this.addEventListener('keyup', this.#handleKeyUp);\n    this.addEventListener('blur', this.#handleBlur);\n    globalThis.window?.addEventListener('blur', this.#handleBlur);\n    globalThis.document?.addEventListener('visibilitychange', this.#handleVisibility);\n  }\n\n  disconnectedCallback() {\n    this.#end('disconnect');\n    this.#clearFeedback();\n    this.removeEventListener('nve-gesture-input', this.#handleGestureInput);\n    this.removeEventListener('nve-gesture', this.#handleGesture);\n    this.removeEventListener('keydown', this.#handleKeyDown);\n    this.removeEventListener('keyup', this.#handleKeyUp);\n    this.removeEventListener('blur', this.#handleBlur);\n    globalThis.window?.removeEventListener('blur', this.#handleBlur);\n    globalThis.document?.removeEventListener('visibilitychange', this.#handleVisibility);\n    super.disconnectedCallback();\n  }\n\n  firstUpdated() {\n    this.#gestureController.target = this;\n  }\n\n  willUpdate(changes: PropertyValues<this>) {\n    // Lit SSR converts reactive attributes without invoking the forms mixin callback.\n    if (isServer && this.hasAttribute('value')) this._handleAttributeChange('value', this.getAttribute('value'));\n    this.#checkAvailability();\n    if (this.announce === 'off') this.#clearFeedback();\n    if (changes.has('constraint') || changes.has('release') || changes.has('keyboardStep')) {\n      this.#end('configuration-change');\n      this.#clearFeedback();\n      if (this.value) {\n        const value = this.#constrain(this.value);\n        if (!sameVector(this.value, value)) this.value = value;\n      }\n    }\n  }\n\n  updated() {\n    if (this.#ownsTabIndex || !this.hasAttribute('tabindex')) {\n      this.tabIndex = this.disabled ? -1 : 0;\n      this.#ownsTabIndex = true;\n    }\n    // Editable joysticks own the two-axis keyboard interaction, including release and cancellation.\n    this._internals.role = this.disabled || this.readOnly ? 'group' : 'application';\n    this._internals.ariaLabel = this.ariaLabel || this.composedLabel || null;\n    this._internals.ariaReadOnly = null;\n    this._internals.ariaDescription = this.#description;\n  }\n\n  get #description() {\n    const position = this.#describePosition(this.value);\n    if (this.disabled || this.readOnly) return position;\n    const instructions = this.release === 'hold' ? this.i18n.joystickHoldInstructions : this.i18n.joystickInstructions;\n    return `${position} ${instructions}`;\n  }\n\n  render() {\n    const value = this.value ?? { x: 0, y: 0 };\n    return html`\n      <div internal-host aria-hidden=\"true\">\n        <div class=\"background\"></div>\n        <div class=\"travel\">\n          <div class=\"thumb\" ?hidden=${!this.value} style=${styleMap({ left: `${(value.x + 1) * 50}%`, top: `${(value.y + 1) * 50}%` })}></div>\n        </div>\n      </div>\n      <span class=\"announcement\" role=\"status\" aria-live=${this.announce === 'off' ? 'off' : 'polite'} aria-atomic=\"true\">${this.#announcement}</span>\n    `;\n  }\n\n  override updateValue(value: JoystickValue) {\n    // Only project the default assignment; writes from reset listeners still use strict validation.\n    const nextValue = this.#resetting && isVector(value) ? this.#constrain(value) : value;\n    this.#resetting = false;\n    if (nextValue !== undefined && (!isVector(nextValue) || !sameVector(nextValue, this.#constrain(nextValue)))) {\n      throw new TypeError('Joystick value must contain finite x and y coordinates within its constraint.');\n    }\n    super.updateValue(nextValue);\n    if (!this.#writingInput) {\n      this.#lastInput = undefined;\n      this.#clearFeedback();\n    }\n  }\n\n  override reset() {\n    this.#end('reset');\n    this.#clearFeedback();\n    this.#resetting = true;\n    try {\n      super.reset();\n    } finally {\n      this.#resetting = false;\n    }\n  }\n\n  override formStateRestoreCallback(state: unknown, _reason?: string) {\n    if (typeof state !== 'string') return;\n    let value: unknown;\n    try {\n      value = state === '' ? undefined : JSON.parse(state);\n    } catch {\n      return;\n    }\n    if (value !== undefined && (!isVector(value) || !sameVector(value, this.#constrain(value)))) return;\n    this.#end('reset');\n    this.value = value;\n  }\n\n  override _updateFormState() {\n    if (!this.name || !this.value) {\n      this._internals.setFormValue(null, this.valueAsString);\n      return;\n    }\n    const data = new FormData();\n    data.set(`${this.name}-x`, `${this.value.x}`);\n    data.set(`${this.name}-y`, `${this.value.y}`);\n    this._internals.setFormValue(data, this.valueAsString);\n  }\n\n  #constrain({ x, y }: JoystickValue): JoystickValue {\n    const constraint = this.hasUpdated ? this.constraint : (this.getAttribute('constraint') ?? this.constraint);\n    if (constraint === 'circle') {\n      const length = Math.max(1, Math.hypot(x, y));\n      return { x: x / length, y: y / length };\n    }\n    return {\n      x: constraint === 'vertical' ? 0 : Math.max(-1, Math.min(1, x)),\n      y: constraint === 'horizontal' ? 0 : Math.max(-1, Math.min(1, y))\n    };\n  }\n\n  #begin(session: Session) {\n    this.#session = session;\n    this.#lastInput = undefined;\n    // A later interaction can report identical text after an empty region.\n    this.#announcement = '';\n    this.requestUpdate();\n    this._internals.states.add('active');\n    this.dispatchEvent(\n      new CustomEvent<JoystickInteractionStart>('interaction-start', {\n        bubbles: true,\n        composed: true,\n        detail: { source: session.source }\n      })\n    );\n    this.#checkAvailability();\n  }\n\n  #input(value: JoystickValue) {\n    if (sameVector(this.value, value)) return;\n    this.#writingInput = true;\n    try {\n      this.value = value;\n    } finally {\n      this.#writingInput = false;\n    }\n    if (this.#session) this.#lastInput = value;\n    if (this.#session) this.#session.changed = true;\n    this.dispatchInputEvent();\n    this.#checkAvailability();\n    if (this.#session && this.#lastInput === value) this.#queueFeedback(value, 'position');\n  }\n\n  #end(reason: JoystickInteractionEnd['reason']) {\n    const session = this.#session;\n    if (!session) return;\n    const lastInput = this.#lastInput;\n    this.#session = undefined;\n    this.#keys.clear();\n    this._internals.states.delete('active');\n    this.#releasePointer(session.pointerId);\n    if (reason !== 'reset' && (reason !== 'release' || this.release !== 'hold')) {\n      this.#input({ x: 0, y: 0 });\n    }\n    this.#finishFeedback(reason, this.#lastInput ? lastInput : undefined);\n    if (reason === 'release' && session.changed) this.dispatchChangeEvent();\n    this.dispatchEvent(\n      new CustomEvent<JoystickInteractionEnd>('interaction-end', {\n        bubbles: true,\n        composed: true,\n        detail: { source: session.source, reason }\n      })\n    );\n  }\n\n  #finishFeedback(reason: JoystickInteractionEnd['reason'], lastInput: JoystickValue | undefined) {\n    if (reason === 'escape') {\n      if (sameVector(this.value, { x: 0, y: 0 })) this.#queueFeedback({ x: 0, y: 0 }, 'position');\n    } else if (reason === 'release' && lastInput) {\n      if (this.release === 'hold' && sameVector(this.value, lastInput)) this.#queueFeedback(lastInput, 'position');\n      else if (this.release !== 'hold' && sameVector(this.value, { x: 0, y: 0 }))\n        this.#queueFeedback(lastInput, 'return');\n    } else {\n      this.#clearFeedback();\n    }\n  }\n\n  #describePosition(value: JoystickValue | undefined): string {\n    if (!value) return this.i18n.joystickNoPosition ?? i18nDefaults.joystickNoPosition;\n    let formatter: Intl.NumberFormat;\n    const options = { maximumFractionDigits: 6, useGrouping: false };\n    try {\n      formatter = new Intl.NumberFormat(globalThis.document?.documentElement.lang || undefined, options);\n    } catch {\n      formatter = new Intl.NumberFormat(undefined, options);\n    }\n    const format = (number: number) => formatter.format(Number(number.toFixed(6)) || 0);\n    return (this.i18n.joystickPosition ?? '').replaceAll('{x}', format(value.x)).replaceAll('{y}', format(value.y));\n  }\n\n  get #canAnnounce() {\n    return (\n      this.isConnected &&\n      this.matches(':focus') &&\n      !this.disabled &&\n      !this.readOnly &&\n      this.announce !== 'off' &&\n      !globalThis.document.hidden\n    );\n  }\n\n  #queueFeedback(value: JoystickValue, kind: 'position' | 'return') {\n    if (!this.#canAnnounce) return;\n    this.#pendingFeedback = { value, kind };\n    if (this.#announcementTimer !== undefined) return;\n    this.#announcementTimer = setTimeout(() => {\n      this.#announcementTimer = undefined;\n      const feedback = this.#pendingFeedback;\n      this.#pendingFeedback = undefined;\n      if (!feedback || !this.#canAnnounce) return;\n      const position = this.#describePosition(feedback.value);\n      const message =\n        feedback.kind === 'return' ? this.i18n.joystickReturnedToCenter?.replaceAll('{position}', position) : position;\n      if (!message || message === this.#announcement) return;\n      this.#announcement = message;\n      this.requestUpdate();\n    }, 500);\n  }\n\n  #clearFeedback() {\n    clearTimeout(this.#announcementTimer);\n    this.#announcementTimer = undefined;\n    this.#pendingFeedback = undefined;\n    if (this.#announcement) {\n      this.#announcement = '';\n      this.requestUpdate();\n    }\n  }\n\n  #releasePointer(pointerId: number | undefined) {\n    if (pointerId === undefined) return;\n    if (this.hasPointerCapture(pointerId)) this.releasePointerCapture(pointerId);\n    this.#gestureController.target = undefined;\n    if (this.isConnected && this.hasUpdated) this.#gestureController.target = this;\n  }\n\n  #checkAvailability() {\n    if (this.disabled || this.readOnly) {\n      this.#end(this.disabled ? 'disabled' : 'readonly');\n      this.#clearFeedback();\n    }\n  }\n\n  #movePointer(event: PointerEvent) {\n    const bounds = this.shadowRoot?.querySelector('.travel')?.getBoundingClientRect();\n    if (!bounds || bounds.width <= 0 || bounds.height <= 0) return;\n    this.#input(\n      this.#constrain({\n        x: ((event.clientX - bounds.left) / bounds.width) * 2 - 1,\n        y: ((event.clientY - bounds.top) / bounds.height) * 2 - 1\n      })\n    );\n  }\n\n  #handleGestureInput = (event: Event) => {\n    if (!(event instanceof CustomEvent)) return;\n    const input: GestureInput = event.detail;\n    this.#checkAvailability();\n    if (input.kind === 'pointerdown') {\n      this.#startPointer(input);\n    } else if (input.kind === 'pointerend' && this.#session?.pointerId === input.event.pointerId) {\n      if (!input.interrupted) this.#movePointer(input.event);\n      this.#end(input.interrupted ? (input.reason === 'cancel' ? 'pointer-cancel' : 'lost-capture') : 'release');\n    }\n  };\n\n  #startPointer(input: Extract<GestureInput, { kind: 'pointerdown' }>) {\n    if (!this.hasUpdated || this.disabled || this.readOnly || this.#session || input.event.button !== 0) return;\n    if (!input.claim({ kind: 'drag' })) return;\n    input.event.preventDefault();\n    // Touch controls can operate together without transferring keyboard focus.\n    if (input.event.pointerType !== 'touch') this.focus({ preventScroll: true });\n    this.#begin({ source: 'pointer', pointerId: input.event.pointerId, changed: false });\n    if (this.#session) this.#movePointer(input.event);\n  }\n\n  #handleGesture = (event: Event) => {\n    if (!(event instanceof CustomEvent)) return;\n    const gesture: Gesture<undefined> = event.detail;\n    this.#checkAvailability();\n    if (gesture.kind === 'drag' && this.#session?.pointerId === gesture.event.pointerId) {\n      this.#movePointer(gesture.event);\n    }\n  };\n\n  #handleKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape' && this.#session) {\n      event.preventDefault();\n      this.#end('escape');\n      return;\n    }\n    const direction = directions[event.key];\n    if (!direction || !this.#acceptKey(event, direction)) return;\n    event.preventDefault();\n    this.#keys.add(event.key);\n    if (!this.#session) this.#begin({ source: 'keyboard', changed: false });\n    if (!this.#session) return;\n    this.#moveKey(direction);\n  };\n\n  #moveKey(direction: JoystickValue) {\n    const step = this.#step;\n    const value = this.value ?? { x: 0, y: 0 };\n    this.#input(\n      this.#constrain({\n        x: Number((value.x + direction.x * step).toFixed(6)),\n        y: Number((value.y + direction.y * step).toFixed(6))\n      })\n    );\n  }\n\n  get #step() {\n    return Number.isFinite(this.keyboardStep) && this.keyboardStep > 0 && this.keyboardStep <= 1\n      ? this.keyboardStep\n      : 0.1;\n  }\n\n  #acceptKey(event: KeyboardEvent, direction: JoystickValue) {\n    if (event.altKey || event.ctrlKey || event.metaKey || this.disabled || this.readOnly) return false;\n    if (this.#session?.source === 'pointer') return false;\n    if (this.constraint === 'horizontal') return direction.y === 0;\n    if (this.constraint === 'vertical') return direction.x === 0;\n    return true;\n  }\n\n  #handleKeyUp = (event: KeyboardEvent) => {\n    if (this.#session?.source !== 'keyboard' || !this.#keys.delete(event.key)) return;\n    event.preventDefault();\n    if (!this.#keys.size) this.#end('release');\n  };\n\n  #handleBlur = () => {\n    this.#checkAvailability();\n    this.#end('blur');\n    this.#clearFeedback();\n  };\n  #handleVisibility = () => {\n    if (globalThis.document.hidden) {\n      this.#end('hidden');\n      this.#clearFeedback();\n    }\n  };\n}\n\nfunction isVector(value: unknown): value is JoystickValue {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'x' in value &&\n    'y' in value &&\n    typeof value.x === 'number' &&\n    typeof value.y === 'number' &&\n    Number.isFinite(value.x) &&\n    Number.isFinite(value.y) &&\n    Object.keys(value).length === 2\n  );\n}\n\nfunction sameVector(first: JoystickValue | undefined, second: JoystickValue): boolean {\n  return first !== undefined && Math.abs(first.x - second.x) < 1e-12 && Math.abs(first.y - second.y) < 1e-12;\n}\n"],"mappings":"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"}
+{"version":3,"file":"joystick2.js","names":["styles","_decorate","__decorate","joystick_default","i18nDefaults","directions","Joystick","FormControlMixin","LitElement","useStyles","name","oldValue","newValue","#ownsTabIndex","value","#checkAvailability","#i18nController","I18nController","#announcement","#writingInput","#gestureController","GestureController","#keys","#resetting","#handleGestureInput","event","input","#startPointer","#session","#movePointer","#end","#handleGesture","gesture","#handleKeyDown","direction","#acceptKey","#begin","#moveKey","#handleKeyUp","#handleBlur","#clearFeedback","#handleVisibility","tabIndex","ownsTabIndex","isServer","changes","#constrain","sameVector","#description","position","#describePosition","styleMap","nextValue","isVector","#lastInput","state","data","constraint","length","x","y","session","#queueFeedback","lastInput","#releasePointer","reason","#input","#finishFeedback","formatter","options","format","number","#canAnnounce","#pendingFeedback","#announcementTimer","feedback","message","pointerId","bounds","step","#step","property","first","second"],"sources":["../../src/joystick/joystick.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { html, isServer, LitElement, type PropertyValues } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { FormControlMixin } from '@nvidia-elements/forms/mixins';\nimport {\n  GestureController,\n  useStyles,\n  type Gesture,\n  type GestureInput,\n  type Size\n} from '@nvidia-elements/core/internal';\nimport { I18nController, type I18nDefaults } from '@nvidia-elements/foundations/internal/i18n';\nimport styles from './joystick.css?inline';\n\nexport interface JoystickValue {\n  readonly x: number;\n  readonly y: number;\n}\n\nexport type JoystickConstraint = 'circle' | 'square' | 'horizontal' | 'vertical';\nexport type JoystickRelease = 'center' | 'hold';\n\nexport interface JoystickInteractionStart {\n  readonly source: 'pointer' | 'keyboard';\n}\n\nexport interface JoystickInteractionEnd extends JoystickInteractionStart {\n  readonly reason:\n    | 'release'\n    | 'escape'\n    | 'pointer-cancel'\n    | 'lost-capture'\n    | 'blur'\n    | 'hidden'\n    | 'disabled'\n    | 'readonly'\n    | 'configuration-change'\n    | 'reset'\n    | 'disconnect';\n}\n\ntype Session = JoystickInteractionStart & { pointerId?: number; changed: boolean };\n\nconst i18nDefaults = {\n  joystickPosition: 'X {x}, Y {y}.',\n  joystickNoPosition: 'No position.',\n  joystickInstructions:\n    'Use arrow keys to adjust the enabled axes. Release to return to center. Press Escape to cancel.',\n  joystickHoldInstructions:\n    'Use arrow keys to adjust the enabled axes. Release to keep the position. Escape and interruptions return to center.',\n  joystickReturnedToCenter: '{position} Returned to center.'\n} satisfies I18nDefaults;\n\nconst directions: Record<string, JoystickValue> = {\n  ArrowLeft: { x: -1, y: 0 },\n  ArrowRight: { x: 1, y: 0 },\n  ArrowUp: { x: 0, y: -1 },\n  ArrowDown: { x: 0, y: 1 }\n};\n\n/* eslint-disable jsdoc/no-types -- The metadata analyzer needs the inherited generic value type. */\n/**\n * @element nve-joystick\n * @description A joystick selects a normalized two-axis vector with pointer or keyboard input.\n * Applications own physical units, coordinate frames, input shaping, publishing cadence, recording clocks,\n * command-outcome feedback, and alternative controls when needed.\n *\n * Give each joystick an accessible name with a label, aria-label, or aria-labelledby.\n * Editable controls use the application role to receive two-axis keyboard input.\n * The default accessible description includes both normalized coordinates, keyboard instructions, and release behavior.\n * A locked axis stays at zero; an absent value reads \"No position.\" Disabled and read-only controls omit instructions.\n * Coordinates use up to six decimal places and the document language for number formatting.\n * An explicit aria-description or aria-describedby replaces the default focus description through standard ARIA precedence;\n * it does not disable live announcements.\n * @documentation https://nvidia.github.io/elements/docs/elements/joystick/\n * @since 0.0.0\n * @entrypoint \\@nvidia-elements/core/joystick\n * @property {JoystickValue | undefined} value - 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 * @attribute {string} value - A JSON object containing normalized x and y coordinates.\n * @event input - 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 * @event change - Dispatched after a normal interaction completes and produces input. Cancellation sends any necessary neutral input without change.\n * @event interaction-start - Dispatched with the pointer or keyboard source after setting :state(active), including engagement at neutral.\n * @event interaction-end - 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 * @cssprop --width\n * @cssprop --height\n * @cssprop --background\n * @cssprop --opacity - Background opacity when the opacity flag is present. Defaults to 0.6. The border, crosshair, thumb, and focus indicator keep their opacity.\n * @cssprop --border\n * @cssprop --thumb-width\n * @cssprop --thumb-height\n * @cssprop --thumb-background\n * @cssprop --thumb-border\n * @stable false\n */\nexport class Joystick extends FormControlMixin<typeof LitElement, JoystickValue>(LitElement) {\n  static styles = useStyles([styles]);\n\n  static readonly metadata = {\n    tag: 'nve-joystick',\n    version: '0.0.0',\n    valueSchema: {\n      type: 'object' as const,\n      properties: {\n        x: { type: 'number' as const, minimum: -1, maximum: 1 },\n        y: { type: 'number' as const, minimum: -1, maximum: 1 }\n      },\n      required: ['x', 'y'],\n      additionalProperties: false\n    }\n  };\n\n  /**\n   * Constrains the movement region or selects one axis. Circle limits vector magnitude to one;\n   * square permits both axes at full scale and a magnitude of up to Math.SQRT2.\n   * With equally scaled planar velocity axes, square corners allow about 41% greater speed.\n   * Mixed forward-velocity and turning-rate axes have no common physical magnitude.\n   * Changing the constraint projects the current value silently and cancels an active interaction.\n   */\n  @property({ type: String, reflect: true }) constraint: JoystickConstraint = 'circle';\n\n  /** Sets surface and thumb size. At the default font size, sm is 104px, md is 130px, and lg is 156px. */\n  @property({ type: String, reflect: true }) size: Size = 'md';\n\n  /** Enables background transparency using the --opacity CSS custom property. */\n  @property({ type: Boolean, reflect: true }) opacity = false;\n\n  /**\n   * Determines whether normal release returns to center or holds the final vector.\n   * Interrupted interactions return to neutral in either mode. Form reset restores the declared default instead.\n   */\n  @property({ type: String, reflect: true }) release: JoystickRelease = 'center';\n\n  /**\n   * Sets the normalized increment for each arrow key press. Repeated presses continue adjusting;\n   * releasing the final arrow applies the release behavior. Escape cancels the interaction.\n   * Invalid steps fall back to 0.1. Modifier shortcuts and locked-axis directions remain available to the browser.\n   */\n  @property({ type: Number, attribute: 'keyboard-step' }) keyboardStep = 0.1;\n\n  /**\n   * Controls automatic position announcements. Focused user input produces polite announcements at most every 500 ms.\n   * A quick tap in center mode reports the input coordinates and the return to center.\n   * Escape announces the resulting coordinates without a separate cancellation message.\n   * Programmatic writes and read-only playback update the description without live announcements.\n   * Set off when the application supplies spoken output, the position description on focus remains available.\n   */\n  @property({ type: String }) announce: 'polite' | 'off' = 'polite';\n\n  readonly #i18nController: I18nController<this> = new I18nController(this, i18nDefaults);\n\n  /** Enables updating internal string values for internationalization. */\n  @property({ type: Object }) i18n = this.#i18nController.i18n;\n\n  #announcement = '';\n  #pendingFeedback?: { value: JoystickValue; kind: 'position' | 'return' };\n  #announcementTimer?: ReturnType<typeof setTimeout>;\n  #lastInput?: JoystickValue;\n  #writingInput = false;\n\n  readonly #gestureController = new GestureController(this, {\n    touchAction: () => (this.disabled || this.readOnly ? undefined : 'none'),\n    suppressNativeDrag: true\n  });\n  readonly #keys = new Set<string>();\n  #session?: Session;\n  #resetting = false;\n  #ownsTabIndex = false;\n\n  static override get observedAttributes() {\n    return [...super.observedAttributes, 'tabindex'];\n  }\n\n  override attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null) {\n    super.attributeChangedCallback(name, oldValue, newValue);\n    if (name === 'tabindex') this.#ownsTabIndex = false;\n  }\n\n  override get disabled(): boolean {\n    return super.disabled;\n  }\n\n  override set disabled(value: boolean | unknown) {\n    super.disabled = Boolean(value);\n    this.#checkAvailability();\n  }\n\n  override get readOnly(): boolean {\n    return super.readOnly;\n  }\n\n  override set readOnly(value: boolean | unknown) {\n    super.readOnly = Boolean(value);\n    this.#checkAvailability();\n  }\n\n  constructor() {\n    super();\n    this.value = { x: 0, y: 0 };\n  }\n\n  connectedCallback() {\n    const tabIndex = this.getAttribute('tabindex');\n    const ownsTabIndex = this.#ownsTabIndex || tabIndex === null;\n    super.connectedCallback();\n    // The forms mixin assigns tabindex on connection; keep the caller's focus order.\n    if (tabIndex !== null) this.setAttribute('tabindex', tabIndex);\n    this.#ownsTabIndex = ownsTabIndex;\n    if (this.hasUpdated) this.#gestureController.target = this;\n    this.addEventListener('nve-gesture-input', this.#handleGestureInput);\n    this.addEventListener('nve-gesture', this.#handleGesture);\n    this.addEventListener('keydown', this.#handleKeyDown);\n    this.addEventListener('keyup', this.#handleKeyUp);\n    this.addEventListener('blur', this.#handleBlur);\n    globalThis.window?.addEventListener('blur', this.#handleBlur);\n    globalThis.document?.addEventListener('visibilitychange', this.#handleVisibility);\n  }\n\n  disconnectedCallback() {\n    this.#end('disconnect');\n    this.#clearFeedback();\n    this.removeEventListener('nve-gesture-input', this.#handleGestureInput);\n    this.removeEventListener('nve-gesture', this.#handleGesture);\n    this.removeEventListener('keydown', this.#handleKeyDown);\n    this.removeEventListener('keyup', this.#handleKeyUp);\n    this.removeEventListener('blur', this.#handleBlur);\n    globalThis.window?.removeEventListener('blur', this.#handleBlur);\n    globalThis.document?.removeEventListener('visibilitychange', this.#handleVisibility);\n    super.disconnectedCallback();\n  }\n\n  firstUpdated() {\n    this.#gestureController.target = this;\n  }\n\n  willUpdate(changes: PropertyValues<this>) {\n    // Lit SSR converts reactive attributes without invoking the forms mixin callback.\n    if (isServer && this.hasAttribute('value')) this._handleAttributeChange('value', this.getAttribute('value'));\n    this.#checkAvailability();\n    if (this.announce === 'off') this.#clearFeedback();\n    if (changes.has('constraint') || changes.has('release') || changes.has('keyboardStep')) {\n      this.#end('configuration-change');\n      this.#clearFeedback();\n      if (this.value) {\n        const value = this.#constrain(this.value);\n        if (!sameVector(this.value, value)) this.value = value;\n      }\n    }\n  }\n\n  updated() {\n    if (this.#ownsTabIndex || !this.hasAttribute('tabindex')) {\n      this.tabIndex = this.disabled ? -1 : 0;\n      this.#ownsTabIndex = true;\n    }\n    // Editable joysticks own the two-axis keyboard interaction, including release and cancellation.\n    this._internals.role = this.disabled || this.readOnly ? 'group' : 'application';\n    this._internals.ariaLabel = this.ariaLabel || this.composedLabel || null;\n    this._internals.ariaReadOnly = null;\n    this._internals.ariaDescription = this.#description;\n  }\n\n  get #description() {\n    const position = this.#describePosition(this.value);\n    if (this.disabled || this.readOnly) return position;\n    const instructions = this.release === 'hold' ? this.i18n.joystickHoldInstructions : this.i18n.joystickInstructions;\n    return `${position} ${instructions}`;\n  }\n\n  render() {\n    const value = this.value ?? { x: 0, y: 0 };\n    return html`\n      <div internal-host aria-hidden=\"true\">\n        <div class=\"background\"></div>\n        <div class=\"travel\">\n          <div class=\"thumb\" ?hidden=${!this.value} style=${styleMap({ left: `${(value.x + 1) * 50}%`, top: `${(value.y + 1) * 50}%` })}></div>\n        </div>\n      </div>\n      <span class=\"announcement\" role=\"status\" aria-live=${this.announce === 'off' ? 'off' : 'polite'} aria-atomic=\"true\">${this.#announcement}</span>\n    `;\n  }\n\n  override updateValue(value: JoystickValue) {\n    // Only project the default assignment; writes from reset listeners still use strict validation.\n    const nextValue = this.#resetting && isVector(value) ? this.#constrain(value) : value;\n    this.#resetting = false;\n    if (nextValue !== undefined && (!isVector(nextValue) || !sameVector(nextValue, this.#constrain(nextValue)))) {\n      throw new TypeError('Joystick value must contain finite x and y coordinates within its constraint.');\n    }\n    super.updateValue(nextValue);\n    if (!this.#writingInput) {\n      this.#lastInput = undefined;\n      this.#clearFeedback();\n    }\n  }\n\n  override reset() {\n    this.#end('reset');\n    this.#clearFeedback();\n    this.#resetting = true;\n    try {\n      super.reset();\n    } finally {\n      this.#resetting = false;\n    }\n  }\n\n  override formStateRestoreCallback(state: unknown, _reason?: string) {\n    if (typeof state !== 'string') return;\n    let value: unknown;\n    try {\n      value = state === '' ? undefined : JSON.parse(state);\n    } catch {\n      return;\n    }\n    if (value !== undefined && (!isVector(value) || !sameVector(value, this.#constrain(value)))) return;\n    this.#end('reset');\n    this.value = value;\n  }\n\n  override _updateFormState() {\n    if (!this.name || !this.value) {\n      this._internals.setFormValue(null, this.valueAsString);\n      return;\n    }\n    const data = new FormData();\n    data.set(`${this.name}-x`, `${this.value.x}`);\n    data.set(`${this.name}-y`, `${this.value.y}`);\n    this._internals.setFormValue(data, this.valueAsString);\n  }\n\n  #constrain({ x, y }: JoystickValue): JoystickValue {\n    const constraint = this.hasUpdated ? this.constraint : (this.getAttribute('constraint') ?? this.constraint);\n    if (constraint === 'circle') {\n      const length = Math.max(1, Math.hypot(x, y));\n      return { x: x / length, y: y / length };\n    }\n    return {\n      x: constraint === 'vertical' ? 0 : Math.max(-1, Math.min(1, x)),\n      y: constraint === 'horizontal' ? 0 : Math.max(-1, Math.min(1, y))\n    };\n  }\n\n  #begin(session: Session) {\n    this.#session = session;\n    this.#lastInput = undefined;\n    // A later interaction can report identical text after an empty region.\n    this.#announcement = '';\n    this.requestUpdate();\n    this._internals.states.add('active');\n    this.dispatchEvent(\n      new CustomEvent<JoystickInteractionStart>('interaction-start', {\n        bubbles: true,\n        composed: true,\n        detail: { source: session.source }\n      })\n    );\n    this.#checkAvailability();\n  }\n\n  #input(value: JoystickValue) {\n    if (sameVector(this.value, value)) return;\n    this.#writingInput = true;\n    try {\n      this.value = value;\n    } finally {\n      this.#writingInput = false;\n    }\n    if (this.#session) this.#lastInput = value;\n    if (this.#session) this.#session.changed = true;\n    this.dispatchInputEvent();\n    this.#checkAvailability();\n    if (this.#session && this.#lastInput === value) this.#queueFeedback(value, 'position');\n  }\n\n  #end(reason: JoystickInteractionEnd['reason']) {\n    const session = this.#session;\n    if (!session) return;\n    const lastInput = this.#lastInput;\n    this.#session = undefined;\n    this.#keys.clear();\n    this._internals.states.delete('active');\n    this.#releasePointer(session.pointerId);\n    if (reason !== 'reset' && (reason !== 'release' || this.release !== 'hold')) {\n      this.#input({ x: 0, y: 0 });\n    }\n    this.#finishFeedback(reason, this.#lastInput ? lastInput : undefined);\n    if (reason === 'release' && session.changed) this.dispatchChangeEvent();\n    this.dispatchEvent(\n      new CustomEvent<JoystickInteractionEnd>('interaction-end', {\n        bubbles: true,\n        composed: true,\n        detail: { source: session.source, reason }\n      })\n    );\n  }\n\n  #finishFeedback(reason: JoystickInteractionEnd['reason'], lastInput: JoystickValue | undefined) {\n    if (reason === 'escape') {\n      if (sameVector(this.value, { x: 0, y: 0 })) this.#queueFeedback({ x: 0, y: 0 }, 'position');\n    } else if (reason === 'release' && lastInput) {\n      if (this.release === 'hold' && sameVector(this.value, lastInput)) this.#queueFeedback(lastInput, 'position');\n      else if (this.release !== 'hold' && sameVector(this.value, { x: 0, y: 0 }))\n        this.#queueFeedback(lastInput, 'return');\n    } else {\n      this.#clearFeedback();\n    }\n  }\n\n  #describePosition(value: JoystickValue | undefined): string {\n    if (!value) return this.i18n.joystickNoPosition ?? i18nDefaults.joystickNoPosition;\n    let formatter: Intl.NumberFormat;\n    const options = { maximumFractionDigits: 6, useGrouping: false };\n    try {\n      formatter = new Intl.NumberFormat(globalThis.document?.documentElement.lang || undefined, options);\n    } catch {\n      formatter = new Intl.NumberFormat(undefined, options);\n    }\n    const format = (number: number) => formatter.format(Number(number.toFixed(6)) || 0);\n    return (this.i18n.joystickPosition ?? '').replaceAll('{x}', format(value.x)).replaceAll('{y}', format(value.y));\n  }\n\n  get #canAnnounce() {\n    return (\n      this.isConnected &&\n      this.matches(':focus') &&\n      !this.disabled &&\n      !this.readOnly &&\n      this.announce !== 'off' &&\n      !globalThis.document.hidden\n    );\n  }\n\n  #queueFeedback(value: JoystickValue, kind: 'position' | 'return') {\n    if (!this.#canAnnounce) return;\n    this.#pendingFeedback = { value, kind };\n    if (this.#announcementTimer !== undefined) return;\n    this.#announcementTimer = setTimeout(() => {\n      this.#announcementTimer = undefined;\n      const feedback = this.#pendingFeedback;\n      this.#pendingFeedback = undefined;\n      if (!feedback || !this.#canAnnounce) return;\n      const position = this.#describePosition(feedback.value);\n      const message =\n        feedback.kind === 'return' ? this.i18n.joystickReturnedToCenter?.replaceAll('{position}', position) : position;\n      if (!message || message === this.#announcement) return;\n      this.#announcement = message;\n      this.requestUpdate();\n    }, 500);\n  }\n\n  #clearFeedback() {\n    clearTimeout(this.#announcementTimer);\n    this.#announcementTimer = undefined;\n    this.#pendingFeedback = undefined;\n    if (this.#announcement) {\n      this.#announcement = '';\n      this.requestUpdate();\n    }\n  }\n\n  #releasePointer(pointerId: number | undefined) {\n    if (pointerId === undefined) return;\n    if (this.hasPointerCapture(pointerId)) this.releasePointerCapture(pointerId);\n    this.#gestureController.target = undefined;\n    if (this.isConnected && this.hasUpdated) this.#gestureController.target = this;\n  }\n\n  #checkAvailability() {\n    if (this.disabled || this.readOnly) {\n      this.#end(this.disabled ? 'disabled' : 'readonly');\n      this.#clearFeedback();\n    }\n  }\n\n  #movePointer(event: PointerEvent) {\n    const bounds = this.shadowRoot?.querySelector('.travel')?.getBoundingClientRect();\n    if (!bounds || bounds.width <= 0 || bounds.height <= 0) return;\n    this.#input(\n      this.#constrain({\n        x: ((event.clientX - bounds.left) / bounds.width) * 2 - 1,\n        y: ((event.clientY - bounds.top) / bounds.height) * 2 - 1\n      })\n    );\n  }\n\n  #handleGestureInput = (event: Event) => {\n    if (!(event instanceof CustomEvent)) return;\n    const input: GestureInput = event.detail;\n    this.#checkAvailability();\n    if (input.kind === 'pointerdown') {\n      this.#startPointer(input);\n    } else if (input.kind === 'pointerend' && this.#session?.pointerId === input.event.pointerId) {\n      if (!input.interrupted) this.#movePointer(input.event);\n      this.#end(input.interrupted ? (input.reason === 'cancel' ? 'pointer-cancel' : 'lost-capture') : 'release');\n    }\n  };\n\n  #startPointer(input: Extract<GestureInput, { kind: 'pointerdown' }>) {\n    if (!this.hasUpdated || this.disabled || this.readOnly || this.#session || input.event.button !== 0) return;\n    if (!input.claim({ kind: 'drag' })) return;\n    input.event.preventDefault();\n    // Touch controls can operate together without transferring keyboard focus.\n    if (input.event.pointerType !== 'touch') this.focus({ preventScroll: true });\n    this.#begin({ source: 'pointer', pointerId: input.event.pointerId, changed: false });\n    if (this.#session) this.#movePointer(input.event);\n  }\n\n  #handleGesture = (event: Event) => {\n    if (!(event instanceof CustomEvent)) return;\n    const gesture: Gesture<undefined> = event.detail;\n    this.#checkAvailability();\n    if (gesture.kind === 'drag' && this.#session?.pointerId === gesture.event.pointerId) {\n      this.#movePointer(gesture.event);\n    }\n  };\n\n  #handleKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'Escape' && this.#session) {\n      event.preventDefault();\n      this.#end('escape');\n      return;\n    }\n    const direction = directions[event.key];\n    if (!direction || !this.#acceptKey(event, direction)) return;\n    event.preventDefault();\n    this.#keys.add(event.key);\n    if (!this.#session) this.#begin({ source: 'keyboard', changed: false });\n    if (!this.#session) return;\n    this.#moveKey(direction);\n  };\n\n  #moveKey(direction: JoystickValue) {\n    const step = this.#step;\n    const value = this.value ?? { x: 0, y: 0 };\n    this.#input(\n      this.#constrain({\n        x: Number((value.x + direction.x * step).toFixed(6)),\n        y: Number((value.y + direction.y * step).toFixed(6))\n      })\n    );\n  }\n\n  get #step() {\n    return Number.isFinite(this.keyboardStep) && this.keyboardStep > 0 && this.keyboardStep <= 1\n      ? this.keyboardStep\n      : 0.1;\n  }\n\n  #acceptKey(event: KeyboardEvent, direction: JoystickValue) {\n    if (event.altKey || event.ctrlKey || event.metaKey || this.disabled || this.readOnly) return false;\n    if (this.#session?.source === 'pointer') return false;\n    if (this.constraint === 'horizontal') return direction.y === 0;\n    if (this.constraint === 'vertical') return direction.x === 0;\n    return true;\n  }\n\n  #handleKeyUp = (event: KeyboardEvent) => {\n    if (this.#session?.source !== 'keyboard' || !this.#keys.delete(event.key)) return;\n    event.preventDefault();\n    if (!this.#keys.size) this.#end('release');\n  };\n\n  #handleBlur = () => {\n    this.#checkAvailability();\n    this.#end('blur');\n    this.#clearFeedback();\n  };\n  #handleVisibility = () => {\n    if (globalThis.document.hidden) {\n      this.#end('hidden');\n      this.#clearFeedback();\n    }\n  };\n}\n\nfunction isVector(value: unknown): value is JoystickValue {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'x' in value &&\n    'y' in value &&\n    typeof value.x === 'number' &&\n    typeof value.y === 'number' &&\n    Number.isFinite(value.x) &&\n    Number.isFinite(value.y) &&\n    Object.keys(value).length === 2\n  );\n}\n\nfunction sameVector(first: JoystickValue | undefined, second: JoystickValue): boolean {\n  return first !== undefined && Math.abs(first.x - second.x) < 1e-12 && Math.abs(first.y - second.y) < 1e-12;\n}\n"],"mappings":"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"}

package/dist/logo/define.js

@@ -1,7 +1,6 @@
 import { Logo as e } from "./logo2.js";
 import { define as t } from "@nvidia-elements/foundations/internal/define";
-//#region src/logo/define.ts
+// src/logo/define.ts
 t(e);
-//#endregion
 
 //# sourceMappingURL=define.js.map

package/dist/logo/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","names":[],"sources":["../../src/logo/define.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { define } from '@nvidia-elements/foundations/internal/define';\nimport { Logo } from '@nvidia-elements/core/logo';\n\ndefine(Logo);\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'nve-logo': Logo;\n  }\n}\n"],"mappings":";;;AAMA,EAAO,CAAI"}
+{"version":3,"file":"define.js","names":["define","Logo"],"sources":["../../src/logo/define.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { define } from '@nvidia-elements/foundations/internal/define';\nimport { Logo } from '@nvidia-elements/core/logo';\n\ndefine(Logo);\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'nve-logo': Logo;\n  }\n}\n"],"mappings":";;;AAMAA,EAAOC,CAAI"}

package/dist/logo/index.js

@@ -1,2 +1 @@
-import { Logo as e } from "./logo2.js";
-export { e as Logo };
+export { Logo } from "./logo2.js";

package/dist/logo/logo.examples.js

@@ -1,6 +1,5 @@
-//#region src/logo/logo.examples.ts
+// src/logo/logo.examples.ts
 var e = "";
-//#endregion
 export { e as default };
 
 //# sourceMappingURL=logo.examples.js.map