@nvidia-elements/core 2.20.1 → 2.20.3

package/dist/input/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","names":[],"sources":["../../src/input/input.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  --padding: 0 var(--nve-ref-size-200);\n  --font-size: var(--nve-ref-font-size-100);\n  --height: var(--nve-ref-size-800);\n  --background: var(--nve-sys-interaction-field-background);\n  --color: var(--nve-sys-interaction-field-color);\n  --border-radius: var(--nve-ref-border-radius-sm);\n  --border: var(--nve-ref-border-width-md) solid transparent;\n  --border-bottom: var(--border);\n  --cursor: text;\n  --font-weight: normal;\n  --_icon-height: var(--height);\n  --_font-size: var(--font-size);\n  --width: 100%;\n  --max-width: 100%;\n  --min-width: initial;\n  width: var(--width);\n  max-width: var(--max-width);\n  min-width: var(--min-width);\n}\n\n[input] {\n  height: var(--height);\n  background: var(--background);\n  border: var(--border);\n  border-bottom: var(--border-bottom);\n  border-radius: var(--border-radius);\n  color: var(--color);\n  cursor: var(--cursor);\n  width: var(--control-width);\n  display: flex;\n  align-content: stretch;\n}\n\n::slotted(input) {\n  /* https://web.dev/accent-color/#guaranteeing-contrast */\n  accent-color: var(--accent-color) !important;\n  cursor: var(--cursor) !important;\n  padding: var(--padding) !important;\n  font-size: var(--font-size) !important;\n  color: var(--color) !important;\n  line-height: var(--height) !important;\n  border: 0 !important;\n  background: none !important;\n  display: block !important;\n  width: 100% !important;\n  font-weight: var(--font-weight) !important;\n}\n\nnve-icon-button,\n::slotted(nve-icon-button) {\n  --height: var(--_icon-height);\n  align-self: center;\n}\n\n::slotted(nve-button:not([slot])) {\n  --font-size: var(--_font-size);\n  --padding: 0 var(--nve-ref-size-200);\n  --color: var(--label-color);\n  --height: 100%;\n}\n\n:host([rounded]) {\n  --border-radius: var(--nve-ref-border-radius-full);\n}\n\n:host([status='error']),\n:host(:state(invalid)),\n:host(:state(error)) {\n  --border: var(--nve-ref-border-width-md) solid var(--nve-sys-support-danger-emphasis-color);\n}\n\n:host([status='success']),\n:host(:state(success)) {\n  --border: var(--nve-ref-border-width-md) solid var(--nve-sys-support-success-emphasis-color);\n}\n\n:host(:state(disabled)) {\n  --border: var(--nve-ref-border-width-md) solid transparent;\n}\n\n:host([container='flat']) {\n  --border-radius: 0;\n  --box-shadow: none;\n  --border-bottom: var(--nve-ref-border-width-md) solid var(--nve-ref-border-color-muted);\n}\n\n:host([container='flat']) [input] {\n  background: inherit;\n}\n\n:host([container='flat']:focus-within) {\n  --border-bottom: var(--nve-ref-border-width-md) solid var(--nve-ref-border-color-emphasis);\n}\n\n:host([container='flat']:focus-within) [input] {\n  outline: 0 !important;\n}\n"],"mappings":""}
+{"version":3,"file":"input.js","names":["input_default"],"sources":["../../src/input/input.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  --padding: 0 var(--nve-ref-size-200);\n  --font-size: var(--nve-ref-font-size-100);\n  --height: var(--nve-ref-size-800);\n  --background: var(--nve-sys-interaction-field-background);\n  --color: var(--nve-sys-interaction-field-color);\n  --border-radius: var(--nve-ref-border-radius-sm);\n  --border: var(--nve-ref-border-width-md) solid transparent;\n  --border-bottom: var(--border);\n  --cursor: text;\n  --font-weight: normal;\n  --_icon-height: var(--height);\n  --_font-size: var(--font-size);\n  --width: 100%;\n  --max-width: 100%;\n  --min-width: initial;\n  width: var(--width);\n  max-width: var(--max-width);\n  min-width: var(--min-width);\n}\n\n[input] {\n  height: var(--height);\n  background: var(--background);\n  border: var(--border);\n  border-bottom: var(--border-bottom);\n  border-radius: var(--border-radius);\n  color: var(--color);\n  cursor: var(--cursor);\n  width: var(--control-width);\n  display: flex;\n  align-content: stretch;\n}\n\n::slotted(input) {\n  /* https://web.dev/accent-color/#guaranteeing-contrast */\n  accent-color: var(--accent-color) !important;\n  cursor: var(--cursor) !important;\n  padding: var(--padding) !important;\n  font-size: var(--font-size) !important;\n  color: var(--color) !important;\n  line-height: var(--height) !important;\n  border: 0 !important;\n  background: none !important;\n  display: block !important;\n  width: 100% !important;\n  font-weight: var(--font-weight) !important;\n}\n\nnve-icon-button,\n::slotted(nve-icon-button) {\n  --height: var(--_icon-height);\n  align-self: center;\n}\n\n::slotted(nve-button:not([slot])) {\n  --font-size: var(--_font-size);\n  --padding: 0 var(--nve-ref-size-200);\n  --color: var(--label-color);\n  --height: 100%;\n}\n\n:host([rounded]) {\n  --border-radius: var(--nve-ref-border-radius-full);\n}\n\n:host([status='error']),\n:host(:state(invalid)),\n:host(:state(error)) {\n  --border: var(--nve-ref-border-width-md) solid var(--nve-sys-support-danger-emphasis-color);\n}\n\n:host([status='success']),\n:host(:state(success)) {\n  --border: var(--nve-ref-border-width-md) solid var(--nve-sys-support-success-emphasis-color);\n}\n\n:host(:state(disabled)) {\n  --border: var(--nve-ref-border-width-md) solid transparent;\n}\n\n:host([container='flat']) {\n  --border-radius: 0;\n  --box-shadow: none;\n  --border-bottom: var(--nve-ref-border-width-md) solid var(--nve-ref-border-color-muted);\n}\n\n:host([container='flat']) [input] {\n  background: inherit;\n}\n\n:host([container='flat']:focus-within) {\n  --border-bottom: var(--nve-ref-border-width-md) solid var(--nve-ref-border-color-emphasis);\n}\n\n:host([container='flat']:focus-within) [input] {\n  outline: 0 !important;\n}\n"],"mappings":""}

package/dist/input/input2.js

@@ -1,9 +1,9 @@
 import { useStyles as e } from "../internal/styles/index.js";
-import t from "../_virtual/_@oxc-project_runtime@0.147.0/helpers/esm/decorate.js";
+import t from "../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/decorate.js";
 import { Control as n } from "../forms/control/control2.js";
 import r from "./input.js";
 import { property as i } from "lit/decorators/property.js";
-//#region src/input/input.ts
+// src/input/input.ts
 var a = r, o = class extends n {
 	constructor(...e) {
 		super(...e), this.rounded = !1;
@@ -14,7 +14,7 @@ var a = r, o = class extends n {
 	static {
 		this.metadata = {
 			tag: "nve-input",
-			version: "2.20.1"
+			version: "2.20.3"
 		};
 	}
 };
@@ -25,7 +25,6 @@ t([i({
 	type: Boolean,
 	reflect: !0
 })], o.prototype, "rounded", void 0);
-//#endregion
 export { o as Input, a as inputStyles };
 
 //# sourceMappingURL=input2.js.map

package/dist/input/input2.js.map

@@ -1 +1 @@
-{"version":3,"file":"input2.js","names":[],"sources":["../../src/input/input.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { CSSResult } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport type { ContainerElement } from '@nvidia-elements/core/internal';\nimport { useStyles } from '@nvidia-elements/core/internal';\nimport { Control } from '@nvidia-elements/core/forms';\nimport styles from './input.css?inline';\n\nexport const inputStyles = styles;\n\n/**\n * @element nve-input\n * @description An input is a control that enables users to enter text.\n * @documentation https://nvidia.github.io/elements/docs/elements/input/\n * @since 0.3.0\n * @entrypoint \\@nvidia-elements/core/input\n * @cssprop --padding\n * @cssprop --font-size\n * @cssprop --height\n * @cssprop --background\n * @cssprop --border-radius\n * @cssprop --border\n * @cssprop --cursor\n * @cssprop --color\n * @cssprop --font-weight\n * @cssprop --width\n * @cssprop --min-width\n * @cssprop --max-width\n * @cssprop --border-bottom\n * @cssprop --box-shadow\n * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input\n */\nexport class Input extends Control implements ContainerElement {\n  /**\n   * Reduces the visual container for a minimal borderless appearance while preserving whitespace bounds.\n   * Use when embedding within another container such as a toolbar.\n   */\n  @property({ type: String, reflect: true }) container?: 'flat';\n\n  /**\n   * Sets the rounded visual style of the input.\n   */\n  @property({ type: Boolean, reflect: true }) rounded = false;\n\n  static styles: CSSResult[] = useStyles([...Control.styles, styles]);\n\n  static readonly metadata = {\n    tag: 'nve-input',\n    version: '0.0.0'\n  };\n}\n"],"mappings":";;;;;;AAUA,IAAa,IAAc,GAwBd,IAAb,cAA2B,EAAoC;;EAUP,aAAA,KAAA,UAAA;;;EAEzB,KAAA,SAAA,EAAU,CAAC,GAAG,EAAQ,QAAQ,CAAM,CAAC;;;EAEvC,KAAA,WAAA;GACzB,KAAK;GACL,SAAS;EACX;;AACF;AAbG,EAAA,CAAA,EAAS;CAAE,MAAM;CAAQ,SAAS;AAAK,CAAC,CAAA,GAAA,EAAA,WAAA,aAAA,KAAA,CAAA,GAKxC,EAAA,CAAA,EAAS;CAAE,MAAM;CAAS,SAAS;AAAK,CAAC,CAAA,GAAA,EAAA,WAAA,WAAA,KAAA,CAAA"}
+{"version":3,"file":"input2.js","names":["styles","_decorate","__decorate","input_default","inputStyles","Input","Control","_args","useStyles","property"],"sources":["../../src/input/input.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { CSSResult } from 'lit';\nimport { property } from 'lit/decorators/property.js';\nimport type { ContainerElement } from '@nvidia-elements/core/internal';\nimport { useStyles } from '@nvidia-elements/core/internal';\nimport { Control } from '@nvidia-elements/core/forms';\nimport styles from './input.css?inline';\n\nexport const inputStyles = styles;\n\n/**\n * @element nve-input\n * @description An input is a control that enables users to enter text.\n * @documentation https://nvidia.github.io/elements/docs/elements/input/\n * @since 0.3.0\n * @entrypoint \\@nvidia-elements/core/input\n * @cssprop --padding\n * @cssprop --font-size\n * @cssprop --height\n * @cssprop --background\n * @cssprop --border-radius\n * @cssprop --border\n * @cssprop --cursor\n * @cssprop --color\n * @cssprop --font-weight\n * @cssprop --width\n * @cssprop --min-width\n * @cssprop --max-width\n * @cssprop --border-bottom\n * @cssprop --box-shadow\n * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input\n */\nexport class Input extends Control implements ContainerElement {\n  /**\n   * Reduces the visual container for a minimal borderless appearance while preserving whitespace bounds.\n   * Use when embedding within another container such as a toolbar.\n   */\n  @property({ type: String, reflect: true }) container?: 'flat';\n\n  /**\n   * Sets the rounded visual style of the input.\n   */\n  @property({ type: Boolean, reflect: true }) rounded = false;\n\n  static styles: CSSResult[] = useStyles([...Control.styles, styles]);\n\n  static readonly metadata = {\n    tag: 'nve-input',\n    version: '0.0.0'\n  };\n}\n"],"mappings":";;;;;;AAUA,IAAaI,IAAcJ,GAwBdK,IAAb,cAA2BC,EAAoC;;EAUP,A,aAAA,KAAA,UAAA;;;EAEzB,KAAA,SAAAE,EAAU,CAAC,GAAGF,EAAQ,QAAQN,CAAM,CAAC;;;EAEvC,KAAA,WAAA;GACzB,KAAK;GACL,SAAS;EACX;;AACF;AAbGC,EAAA,CAAAQ,EAAS;CAAE,MAAM;CAAQ,SAAS;AAAK,CAAC,CAAA,GAAAJ,EAAA,WAAA,aAAA,KAAA,CAAA,GAKxCJ,EAAA,CAAAQ,EAAS;CAAE,MAAM;CAAS,SAAS;AAAK,CAAC,CAAA,GAAAJ,EAAA,WAAA,WAAA,KAAA,CAAA"}

package/dist/internal/controllers/audit.controller.js

@@ -2,7 +2,7 @@ import { LogService as e } from "../services/log.service.js";
 import { auditParentElement as t } from "../utils/audit.js";
 import { getExcessiveInstanceLimitWarning as n, getInvalidParentWarning as r, getMultiplePageWarning as i } from "../utils/audit-logs.js";
 import { GlobalStateService as a } from "@nvidia-elements/foundations/internal/state";
-//#region src/internal/controllers/audit.controller.ts
+// src/internal/controllers/audit.controller.ts
 var o = 50;
 function s(e = {}) {
 	return (t) => t.addInitializer((t) => new c(t, e));
@@ -60,7 +60,6 @@ var c = class {
 		}
 	}
 };
-//#endregion
 export { c as AuditController, s as audit, o as excessiveInstanceLimit };
 
 //# sourceMappingURL=audit.controller.js.map

package/dist/internal/controllers/audit.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.controller.js","names":[],"sources":["../../../src/internal/controllers/audit.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveElement } from 'lit';\nimport type { LegacyDecoratorTarget } from '../types/index.js';\nimport { GlobalStateService } from '@nvidia-elements/foundations/internal/state';\nimport { LogService } from '../services/log.service.js';\nimport { auditParentElement } from '../utils/audit.js';\nimport {\n  getExcessiveInstanceLimitWarning,\n  getInvalidParentWarning,\n  getMultiplePageWarning\n} from '../utils/audit-logs.js';\n\nexport const excessiveInstanceLimit = 50;\n\nexport interface AuditOptions {\n  excessiveInstanceLimit?: number;\n  alternates?: { name: string; use: string }[];\n}\n\nexport interface AuditMetadata {\n  parents?: string[];\n}\n\ninterface AuditRegistry {\n  [key: string]: {\n    count?: number;\n    excessiveInstanceLimitAudited?: boolean;\n  };\n}\n\nexport function audit<T extends Audit>(options: AuditOptions = {}): ClassDecorator {\n  return (target: LegacyDecoratorTarget) =>\n    target.addInitializer!((instance: T) => new AuditController(instance, options));\n}\n\nexport type Audit = ReactiveElement;\n\nexport class AuditController<T extends Audit> implements ReactiveController {\n  #counted = false;\n\n  get #hostAuditState() {\n    return GlobalStateService.state.audit[this.host.localName] ?? { count: 0 };\n  }\n\n  get #production() {\n    return GlobalStateService.state.env === 'production';\n  }\n\n  get #hostMetadata() {\n    return (this.host.constructor as unknown as { metadata: AuditMetadata }).metadata;\n  }\n\n  constructor(\n    private host: T,\n    private options: AuditOptions\n  ) {\n    if (!this.#production) {\n      this.host.addController(this);\n      this.#initializeAudit();\n    }\n  }\n\n  async hostConnected() {\n    if (!this.#production) this.#auditExcessiveInstanceLimit();\n    await this.host.updateComplete;\n    if (!this.#production && this.host.isConnected) {\n      this.#auditParentElement();\n    }\n  }\n\n  hostDisconnected() {\n    this.#cleanupExcessiveInstanceLimit();\n  }\n\n  #initializeAudit() {\n    if (!GlobalStateService.state.audit[this.host.localName]) {\n      this.#update({ [this.host.localName]: { count: 0 } });\n    }\n  }\n\n  #auditExcessiveInstanceLimit() {\n    const limit = this.options.excessiveInstanceLimit;\n    if (limit === undefined || this.#counted) return;\n\n    this.#counted = true;\n    const count = (this.#hostAuditState.count ?? 0) + 1;\n    const audited = this.#hostAuditState.excessiveInstanceLimitAudited ?? false;\n    const shouldWarn = count > limit && !audited;\n    this.#update({ [this.host.localName]: { count, excessiveInstanceLimitAudited: audited || shouldWarn } });\n\n    if (shouldWarn && this.#counted) {\n      LogService.warn(\n        this.host.localName === 'nve-page'\n          ? getMultiplePageWarning(count)\n          : getExcessiveInstanceLimitWarning(count, this.host.localName)\n      );\n    }\n  }\n\n  #cleanupExcessiveInstanceLimit() {\n    const limit = this.options.excessiveInstanceLimit;\n    if (limit === undefined || !this.#counted) return;\n\n    this.#counted = false;\n    const count = Math.max(0, (this.#hostAuditState.count ?? 0) - 1);\n    this.#update({\n      [this.host.localName]: {\n        count,\n        excessiveInstanceLimitAudited: count > limit && this.#hostAuditState.excessiveInstanceLimitAudited\n      }\n    });\n  }\n\n  #update(registry: AuditRegistry) {\n    GlobalStateService.dispatch('NVE_ELEMENTS_AUDIT_UPDATE', { audit: registry });\n  }\n\n  #auditParentElement() {\n    if (this.#hostMetadata.parents) {\n      const [valid, validParents] = auditParentElement(this.host);\n      if (!valid) {\n        LogService.warn(getInvalidParentWarning(this.host.localName, validParents.join(', ')));\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAcA,IAAa,IAAyB;AAkBtC,SAAgB,EAAuB,IAAwB,CAAC,GAAmB;CACjF,QAAQ,MACN,EAAO,gBAAiB,MAAgB,IAAI,EAAgB,GAAU,CAAO,CAAC;AAClF;AAIA,IAAa,IAAb,MAA4E;CAC1E,KAAW;CAEX,IAAI,KAAkB;EACpB,OAAO,EAAmB,MAAM,MAAM,KAAK,KAAK,cAAc,EAAE,OAAO,EAAE;CAC3E;CAEA,IAAI,KAAc;EAChB,OAAO,EAAmB,MAAM,QAAQ;CAC1C;CAEA,IAAI,KAAgB;EAClB,OAAQ,KAAK,KAAK,YAAuD;CAC3E;CAEA,YACE,GACA,GACA;EACA,AAHQ,KAAA,OAAA,GACA,KAAA,UAAA,GAEH,KAAK,OACR,KAAK,KAAK,cAAc,IAAI,GAC5B,KAAK,GAAiB;CAE1B;CAEA,MAAM,gBAAgB;EAGpB,AAFK,KAAK,MAAa,KAAK,GAA6B,GACzD,MAAM,KAAK,KAAK,gBACZ,CAAC,KAAK,MAAe,KAAK,KAAK,eACjC,KAAK,GAAoB;CAE7B;CAEA,mBAAmB;EACjB,KAAK,GAA+B;CACtC;CAEA,KAAmB;EACjB,AAAK,EAAmB,MAAM,MAAM,KAAK,KAAK,cAC5C,KAAK,GAAQ,GAAG,KAAK,KAAK,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;CAExD;CAEA,KAA+B;EAC7B,IAAM,IAAQ,KAAK,QAAQ;EAC3B,IAAI,MAAU,KAAA,KAAa,KAAK,IAAU;EAE1C,KAAK,KAAW;EAChB,IAAM,KAAS,KAAK,GAAgB,SAAS,KAAK,GAC5C,IAAU,KAAK,GAAgB,iCAAiC,IAChE,IAAa,IAAQ,KAAS,CAAC;EAGrC,AAFA,KAAK,GAAQ,GAAG,KAAK,KAAK,YAAY;GAAE;GAAO,+BAA+B,KAAW;EAAW,EAAE,CAAC,GAEnG,KAAc,KAAK,MACrB,EAAW,KACT,KAAK,KAAK,cAAc,aACpB,EAAuB,CAAK,IAC5B,EAAiC,GAAO,KAAK,KAAK,SAAS,CACjE;CAEJ;CAEA,KAAiC;EAC/B,IAAM,IAAQ,KAAK,QAAQ;EAC3B,IAAI,MAAU,KAAA,KAAa,CAAC,KAAK,IAAU;EAE3C,KAAK,KAAW;EAChB,IAAM,IAAQ,KAAK,IAAI,IAAI,KAAK,GAAgB,SAAS,KAAK,CAAC;EAC/D,KAAK,GAAQ,GACV,KAAK,KAAK,YAAY;GACrB;GACA,+BAA+B,IAAQ,KAAS,KAAK,GAAgB;EACvE,EACF,CAAC;CACH;CAEA,GAAQ,GAAyB;EAC/B,EAAmB,SAAS,6BAA6B,EAAE,OAAO,EAAS,CAAC;CAC9E;CAEA,KAAsB;EACpB,IAAI,KAAK,GAAc,SAAS;GAC9B,IAAM,CAAC,GAAO,KAAgB,EAAmB,KAAK,IAAI;GAC1D,AAAK,KACH,EAAW,KAAK,EAAwB,KAAK,KAAK,WAAW,EAAa,KAAK,IAAI,CAAC,CAAC;EAEzF;CACF;AACF"}
+{"version":3,"file":"audit.controller.js","names":["excessiveInstanceLimit","audit","target","AuditController","instance","options","#hostAuditState","GlobalStateService","#production","#hostMetadata","host","#initializeAudit","#auditExcessiveInstanceLimit","#auditParentElement","#cleanupExcessiveInstanceLimit","#update","limit","#counted","count","audited","shouldWarn","LogService","getMultiplePageWarning","getExcessiveInstanceLimitWarning","registry","valid","validParents","auditParentElement","getInvalidParentWarning"],"sources":["../../../src/internal/controllers/audit.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveElement } from 'lit';\nimport type { LegacyDecoratorTarget } from '../types/index.js';\nimport { GlobalStateService } from '@nvidia-elements/foundations/internal/state';\nimport { LogService } from '../services/log.service.js';\nimport { auditParentElement } from '../utils/audit.js';\nimport {\n  getExcessiveInstanceLimitWarning,\n  getInvalidParentWarning,\n  getMultiplePageWarning\n} from '../utils/audit-logs.js';\n\nexport const excessiveInstanceLimit = 50;\n\nexport interface AuditOptions {\n  excessiveInstanceLimit?: number;\n  alternates?: { name: string; use: string }[];\n}\n\nexport interface AuditMetadata {\n  parents?: string[];\n}\n\ninterface AuditRegistry {\n  [key: string]: {\n    count?: number;\n    excessiveInstanceLimitAudited?: boolean;\n  };\n}\n\nexport function audit<T extends Audit>(options: AuditOptions = {}): ClassDecorator {\n  return (target: LegacyDecoratorTarget) =>\n    target.addInitializer!((instance: T) => new AuditController(instance, options));\n}\n\nexport type Audit = ReactiveElement;\n\nexport class AuditController<T extends Audit> implements ReactiveController {\n  #counted = false;\n\n  get #hostAuditState() {\n    return GlobalStateService.state.audit[this.host.localName] ?? { count: 0 };\n  }\n\n  get #production() {\n    return GlobalStateService.state.env === 'production';\n  }\n\n  get #hostMetadata() {\n    return (this.host.constructor as unknown as { metadata: AuditMetadata }).metadata;\n  }\n\n  constructor(\n    private host: T,\n    private options: AuditOptions\n  ) {\n    if (!this.#production) {\n      this.host.addController(this);\n      this.#initializeAudit();\n    }\n  }\n\n  async hostConnected() {\n    if (!this.#production) this.#auditExcessiveInstanceLimit();\n    await this.host.updateComplete;\n    if (!this.#production && this.host.isConnected) {\n      this.#auditParentElement();\n    }\n  }\n\n  hostDisconnected() {\n    this.#cleanupExcessiveInstanceLimit();\n  }\n\n  #initializeAudit() {\n    if (!GlobalStateService.state.audit[this.host.localName]) {\n      this.#update({ [this.host.localName]: { count: 0 } });\n    }\n  }\n\n  #auditExcessiveInstanceLimit() {\n    const limit = this.options.excessiveInstanceLimit;\n    if (limit === undefined || this.#counted) return;\n\n    this.#counted = true;\n    const count = (this.#hostAuditState.count ?? 0) + 1;\n    const audited = this.#hostAuditState.excessiveInstanceLimitAudited ?? false;\n    const shouldWarn = count > limit && !audited;\n    this.#update({ [this.host.localName]: { count, excessiveInstanceLimitAudited: audited || shouldWarn } });\n\n    if (shouldWarn && this.#counted) {\n      LogService.warn(\n        this.host.localName === 'nve-page'\n          ? getMultiplePageWarning(count)\n          : getExcessiveInstanceLimitWarning(count, this.host.localName)\n      );\n    }\n  }\n\n  #cleanupExcessiveInstanceLimit() {\n    const limit = this.options.excessiveInstanceLimit;\n    if (limit === undefined || !this.#counted) return;\n\n    this.#counted = false;\n    const count = Math.max(0, (this.#hostAuditState.count ?? 0) - 1);\n    this.#update({\n      [this.host.localName]: {\n        count,\n        excessiveInstanceLimitAudited: count > limit && this.#hostAuditState.excessiveInstanceLimitAudited\n      }\n    });\n  }\n\n  #update(registry: AuditRegistry) {\n    GlobalStateService.dispatch('NVE_ELEMENTS_AUDIT_UPDATE', { audit: registry });\n  }\n\n  #auditParentElement() {\n    if (this.#hostMetadata.parents) {\n      const [valid, validParents] = auditParentElement(this.host);\n      if (!valid) {\n        LogService.warn(getInvalidParentWarning(this.host.localName, validParents.join(', ')));\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAcA,IAAaA,IAAyB;AAkBtC,SAAgBC,EAAuB,IAAwB,CAAC,GAAmB;CACjF,QAAQ,MACNC,EAAO,gBAAiB,MAAgB,IAAIC,EAAgBC,GAAUC,CAAO,CAAC;AAClF;AAIA,IAAaF,IAAb,MAA4E;CAC1E,KAAW;CAEX,IAAIG,KAAkB;EACpB,OAAOC,EAAmB,MAAM,MAAM,KAAK,KAAK,cAAc,EAAE,OAAO,EAAE;CAC3E;CAEA,IAAIC,KAAc;EAChB,OAAOD,EAAmB,MAAM,QAAQ;CAC1C;CAEA,IAAIE,KAAgB;EAClB,OAAQ,KAAK,KAAK,YAAuD;CAC3E;CAEA,YACE,GACA,GACA;EACA,AAHQ,KAAA,OAAAC,GACA,KAAA,UAAAL,GAEH,KAAKG,OACR,KAAK,KAAK,cAAc,IAAI,GAC5B,KAAKG,GAAiB;CAE1B;CAEA,MAAM,gBAAgB;EAGpB,AAFK,KAAKH,MAAa,KAAKI,GAA6B,GACzD,MAAM,KAAK,KAAK,gBACZ,CAAC,KAAKJ,MAAe,KAAK,KAAK,eACjC,KAAKK,GAAoB;CAE7B;CAEA,mBAAmB;EACjB,KAAKC,GAA+B;CACtC;CAEA,KAAmB;EACjB,AAAKP,EAAmB,MAAM,MAAM,KAAK,KAAK,cAC5C,KAAKQ,GAAQ,GAAG,KAAK,KAAK,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC;CAExD;CAEA,KAA+B;EAC7B,IAAMC,IAAQ,KAAK,QAAQ;EAC3B,IAAIA,MAAU,KAAA,KAAa,KAAKC,IAAU;EAE1C,KAAKA,KAAW;EAChB,IAAMC,KAAS,KAAKZ,GAAgB,SAAS,KAAK,GAC5Ca,IAAU,KAAKb,GAAgB,iCAAiC,IAChEc,IAAaF,IAAQF,KAAS,CAACG;EAGrC,AAFA,KAAKJ,GAAQ,GAAG,KAAK,KAAK,YAAY;GAAE;GAAO,+BAA+BI,KAAWC;EAAW,EAAE,CAAC,GAEnGA,KAAc,KAAKH,MACrBI,EAAW,KACT,KAAK,KAAK,cAAc,aACpBC,EAAuBJ,CAAK,IAC5BK,EAAiCL,GAAO,KAAK,KAAK,SAAS,CACjE;CAEJ;CAEA,KAAiC;EAC/B,IAAMF,IAAQ,KAAK,QAAQ;EAC3B,IAAIA,MAAU,KAAA,KAAa,CAAC,KAAKC,IAAU;EAE3C,KAAKA,KAAW;EAChB,IAAMC,IAAQ,KAAK,IAAI,IAAI,KAAKZ,GAAgB,SAAS,KAAK,CAAC;EAC/D,KAAKS,GAAQ,GACV,KAAK,KAAK,YAAY;GACrB;GACA,+BAA+BG,IAAQF,KAAS,KAAKV,GAAgB;EACvE,EACF,CAAC;CACH;CAEA,GAAQ,GAAyB;EAC/B,EAAmB,SAAS,6BAA6B,EAAE,OAAOkB,EAAS,CAAC;CAC9E;CAEA,KAAsB;EACpB,IAAI,KAAKf,GAAc,SAAS;GAC9B,IAAM,CAACgB,GAAOC,KAAgBC,EAAmB,KAAK,IAAI;GAC1D,AAAKF,KACHJ,EAAW,KAAKO,EAAwB,KAAK,KAAK,WAAWF,EAAa,KAAK,IAAI,CAAC,CAAC;EAEzF;CACF;AACF"}

package/dist/internal/controllers/gesture.controller.examples.js

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

package/dist/internal/controllers/gesture.controller.examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"gesture.controller.examples.js","names":[],"sources":["../../../src/internal/controllers/gesture.controller.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { css, html, LitElement } from 'lit';\nimport { GestureController } from '@nvidia-elements/core/internal';\n\nexport default {\n  title: 'Internal/Controllers'\n};\n\nclass GestureDemoElement extends LitElement {\n  readonly #gestureController = new GestureController(this, {});\n\n  static styles = css`\n    :host {\n      cursor: grab;\n      display: grid;\n      height: 64px;\n      place-items: center;\n      width: 64px;\n    }\n\n    :host([data-active]) {\n      cursor: grabbing;\n    }\n  `;\n\n  constructor() {\n    super();\n    this.#gestureController.target = this;\n  }\n\n  render() {\n    return html`drag`;\n  }\n}\n\nif (!customElements.get('gesture-controller-demo-element')) {\n  customElements.define('gesture-controller-demo-element', GestureDemoElement);\n}\n\n/**\n * @summary Synchronously claimed pointer input produces drag gestures while preserving start and end input. Use this pattern when a control owns a pointer sequence.\n * @tags test-case\n */\nexport const Drag = {\n  render: () => html`\n<gesture-controller-demo-element></gesture-controller-demo-element>\n<script type=\"module\">\n  const element = document.querySelector('gesture-controller-demo-element');\n  let x = 0;\n  let y = 0;\n\n  element.addEventListener('nve-gesture-input', ({ detail }) => {\n    if (detail.kind === 'pointerdown' && detail.claim({ kind: 'drag' })) element.dataset.active = '';\n    if (detail.kind === 'pointerend') delete element.dataset.active;\n  });\n\n  element.addEventListener('nve-gesture', ({ detail }) => {\n    if (detail.kind !== 'drag') return;\n    x += detail.movementX;\n    y += detail.movementY;\n    element.style.translate = x + 'px ' + y + 'px';\n  });\n</script>\n`\n};\n"],"mappings":";AAGA,IAAA,IAAc"}
+{"version":3,"file":"gesture.controller.examples.js","names":["gesture_controller_examples_default"],"sources":["../../../src/internal/controllers/gesture.controller.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { css, html, LitElement } from 'lit';\nimport { GestureController } from '@nvidia-elements/core/internal';\n\nexport default {\n  title: 'Internal/Controllers'\n};\n\nclass GestureDemoElement extends LitElement {\n  readonly #gestureController = new GestureController(this, {});\n\n  static styles = css`\n    :host {\n      cursor: grab;\n      display: grid;\n      height: 64px;\n      place-items: center;\n      width: 64px;\n    }\n\n    :host([data-active]) {\n      cursor: grabbing;\n    }\n  `;\n\n  constructor() {\n    super();\n    this.#gestureController.target = this;\n  }\n\n  render() {\n    return html`drag`;\n  }\n}\n\nif (!customElements.get('gesture-controller-demo-element')) {\n  customElements.define('gesture-controller-demo-element', GestureDemoElement);\n}\n\n/**\n * @summary Synchronously claimed pointer input produces drag gestures while preserving start and end input. Use this pattern when a control owns a pointer sequence.\n * @tags test-case\n */\nexport const Drag = {\n  render: () => html`\n<gesture-controller-demo-element></gesture-controller-demo-element>\n<script type=\"module\">\n  const element = document.querySelector('gesture-controller-demo-element');\n  let x = 0;\n  let y = 0;\n\n  element.addEventListener('nve-gesture-input', ({ detail }) => {\n    if (detail.kind === 'pointerdown' && detail.claim({ kind: 'drag' })) element.dataset.active = '';\n    if (detail.kind === 'pointerend') delete element.dataset.active;\n  });\n\n  element.addEventListener('nve-gesture', ({ detail }) => {\n    if (detail.kind !== 'drag') return;\n    x += detail.movementX;\n    y += detail.movementY;\n    element.style.translate = x + 'px ' + y + 'px';\n  });\n</script>\n`\n};\n"],"mappings":";AAGA,IAAAA,IAAc"}

package/dist/internal/controllers/gesture.controller.js

@@ -1,4 +1,4 @@
-//#region src/internal/controllers/gesture.controller.ts
+// src/internal/controllers/gesture.controller.ts
 var e = [
 	"contextmenu",
 	"dragstart",
@@ -71,25 +71,7 @@ var e = [
 	};
 	#f = (e) => {
 		let t = this.#a;
-		if (!(!t || e.currentTarget !== t)) {
-			if (e.type === "contextmenu" && e instanceof MouseEvent) {
-				this.#m(e);
-				return;
-			}
-			if (e.type === "selectstart") {
-				this.#h(e);
-				return;
-			}
-			if (e instanceof WheelEvent) {
-				this.#_(e);
-				return;
-			}
-			if (e instanceof PointerEvent) {
-				this.#g(e);
-				return;
-			}
-			this.#p(e);
-		}
+		t && e.currentTarget === t && (e.type === "contextmenu" && e instanceof MouseEvent ? this.#m(e) : e.type === "selectstart" ? this.#h(e) : e instanceof WheelEvent ? this.#_(e) : e instanceof PointerEvent ? this.#g(e) : this.#p(e));
 	};
 	#p(e) {
 		e.type !== "dragstart" || this.#t.shouldIgnoreEvent?.(e) || this.#t.suppressNativeDrag && e.preventDefault();
@@ -102,11 +84,7 @@ var e = [
 	}
 	#g(e) {
 		let t = l(e);
-		if (t !== void 0) {
-			this.#n.has(e.pointerId) && this.#S(e, t);
-			return;
-		}
-		e.type === "pointerdown" ? this.#t.shouldIgnoreEvent?.(e) || this.#v(e) : e.type === "pointermove" && this.#n.has(e.pointerId) && this.#y(e);
+		t === void 0 ? e.type === "pointerdown" ? this.#t.shouldIgnoreEvent?.(e) || this.#v(e) : e.type === "pointermove" && this.#n.has(e.pointerId) && this.#y(e) : this.#n.has(e.pointerId) && this.#S(e, t);
 	}
 	#_(e) {
 		let t = this.#a;
@@ -157,7 +135,7 @@ var e = [
 	}
 	#y(e) {
 		let t = this.#b(e);
-		t && (e.stopPropagation(), (t.movementX !== 0 || t.movementY !== 0) && (this.#n.size >= 2 && this.#C(e) || t.gestureKind !== void 0 && (e.preventDefault(), this.#x(e, t, t.gestureKind))));
+		t && (e.stopPropagation(), t.movementX === 0 && t.movementY === 0 || this.#n.size >= 2 && this.#C(e) || t.gestureKind !== void 0 && (e.preventDefault(), this.#x(e, t, t.gestureKind)));
 	}
 	#b(e) {
 		let t = this.#n.get(e.pointerId);
@@ -180,7 +158,7 @@ var e = [
 	#S(e, t) {
 		let n = this.#n.get(e.pointerId);
 		if (!n) return;
-		let r = u(t), i = r ? n.clientX : e.clientX, a = r ? n.clientY : e.clientY;
+		let r = u(t, e), i = r ? n.clientX : e.clientX, a = r ? n.clientY : e.clientY;
 		e.stopPropagation(), this.#I({
 			clientX: i,
 			clientY: a,
@@ -264,19 +242,15 @@ var e = [
 			startCenterClientX: s(n.clientX, r.clientX),
 			startCenterClientY: s(n.clientY, r.clientY)
 		}, o = t(a);
-		if (!o) {
-			this.#i = {
-				firstPointerId: e.firstPointerId,
-				secondPointerId: e.secondPointerId,
-				status: "declined"
-			};
-			return;
-		}
-		this.#i = {
+		this.#i = o ? {
 			context: o.context,
 			distance: i,
 			status: "active",
 			...a
+		} : {
+			firstPointerId: e.firstPointerId,
+			secondPointerId: e.secondPointerId,
+			status: "declined"
 		};
 	}
 	#D() {
@@ -300,7 +274,7 @@ var e = [
 	}
 	#A() {
 		let e = this.#o;
-		this.#o = void 0, !(!e || e.target.style.getPropertyValue("touch-action") !== e.applied) && (e.value ? e.target.style.setProperty("touch-action", e.value, e.priority) : e.target.style.removeProperty("touch-action"));
+		this.#o = void 0, e && e.target.style.getPropertyValue("touch-action") === e.applied && (e.value ? e.target.style.setProperty("touch-action", e.value, e.priority) : e.target.style.removeProperty("touch-action"));
 	}
 	#j() {
 		let e = this.#a;
@@ -325,7 +299,7 @@ var e = [
 	}
 	#P() {
 		let e = this.#s;
-		this.#s = void 0, !(!e || e.target.style.getPropertyValue("user-select") !== e.applied || e.target.style.getPropertyPriority("user-select") !== e.appliedPriority) && (e.value ? e.target.style.setProperty("user-select", e.value, e.priority) : e.target.style.removeProperty("user-select"));
+		this.#s = void 0, e && e.target.style.getPropertyValue("user-select") === e.applied && e.target.style.getPropertyPriority("user-select") === e.appliedPriority && (e.value ? e.target.style.setProperty("user-select", e.value, e.priority) : e.target.style.removeProperty("user-select"));
 	}
 	#F(e) {
 		this.#e.dispatchEvent(new CustomEvent("nve-gesture", {
@@ -362,13 +336,12 @@ function l(e) {
 	if (e.type === "lostpointercapture") return "lost-capture";
 	if (e.type === "pointermove" && e.buttons === 0) return "buttons-released";
 }
-function u(e) {
-	return e === "cancel" || e === "lost-capture";
+function u(e, t) {
+	return e === "cancel" || e === "lost-capture" && t.buttons !== 0;
 }
 function d(e, t, n = 1) {
 	return t === WheelEvent.DOM_DELTA_LINE ? e * r : t === WheelEvent.DOM_DELTA_PAGE ? e * n : e;
 }
-//#endregion
 export { a as GestureController };
 
 //# sourceMappingURL=gesture.controller.js.map

package/dist/internal/controllers/gesture.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"gesture.controller.js","names":[],"sources":["../../../src/internal/controllers/gesture.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\nconst GESTURE_EVENT_TYPES = [\n  'contextmenu',\n  'dragstart',\n  'lostpointercapture',\n  'pointercancel',\n  'pointerdown',\n  'pointermove',\n  'pointerup',\n  'selectstart',\n  'wheel'\n] as const;\n\nconst WHEEL_ZOOM_EXPONENT_PER_PIXEL = 0.002;\n\n/**\n * Browsers expose trackpad pinch as Ctrl-modified wheel input, so Ctrl-wheel uses a higher zoom gain.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/ctrlKey\n */\nconst CTRL_WHEEL_ZOOM_GAIN = 10;\n\nconst WHEEL_LINE_PIXELS = 16;\n\ninterface PointerState {\n  clientX: number;\n  clientY: number;\n  gestureKind: PointerClaimOptions['kind'];\n  movementX: number;\n  movementY: number;\n  pinchCandidate: boolean;\n  readonly pointerType: string;\n  readonly startClientX: number;\n  readonly startClientY: number;\n}\n\nexport interface PointerClaimOptions {\n  readonly kind?: 'drag' | 'pan';\n  readonly pinchCandidate?: boolean;\n}\n\nexport interface PinchStartDecision<TContext> {\n  readonly context: TContext;\n}\n\n/** Coordinates and deltas use CSS pixels; movement is sample-relative and total displacement is start-relative. */\nexport interface PointerMovementGesture {\n  readonly event: PointerEvent;\n  readonly clientX: number;\n  readonly clientY: number;\n  readonly movementX: number;\n  readonly movementY: number;\n  readonly startClientX: number;\n  readonly startClientY: number;\n  readonly totalDisplacementX: number;\n  readonly totalDisplacementY: number;\n}\n\nexport interface PinchStart {\n  readonly firstPointerId: number;\n  readonly firstPointerType: string;\n  readonly firstStartClientX: number;\n  readonly firstStartClientY: number;\n  readonly secondPointerId: number;\n  readonly secondPointerType: string;\n  readonly secondStartClientX: number;\n  readonly secondStartClientY: number;\n  readonly startCenterClientX: number;\n  readonly startCenterClientY: number;\n}\n\nexport interface PinchGesture<TContext> extends PinchStart {\n  readonly kind: 'pinch';\n  readonly event: PointerEvent;\n  readonly context: TContext;\n  /** Current pointer distance divided by the starting pointer distance. */\n  readonly scale: number;\n  readonly centerClientX: number;\n  readonly centerClientY: number;\n}\n\n/**\n * Per-event wheel input normalized to CSS pixels.\n *\n * Modifier-assisted trackpad pinch remains wheel input: consumers can classify it using the native event's\n * `ctrlKey` or `metaKey` without conflating it with the start-relative lifecycle of a two-pointer pinch.\n */\nexport interface WheelGesture {\n  readonly kind: 'wheel';\n  readonly event: WheelEvent;\n  readonly clientX: number;\n  readonly clientY: number;\n  readonly deltaX: number;\n  readonly deltaY: number;\n}\n\nexport type PointerEndReason = 'up' | 'cancel' | 'lost-capture' | 'buttons-released';\n\nexport interface PointerEndGesture extends PointerMovementGesture {\n  readonly kind: 'pointerend';\n  /** Whether the pointer session ended without an observed physical release. */\n  readonly interrupted: boolean;\n  readonly reason: PointerEndReason;\n}\n\nexport type Gesture<TPinchContext> =\n  | (PointerMovementGesture & { readonly kind: 'drag' })\n  | (PointerMovementGesture & { readonly kind: 'pan' })\n  | PinchGesture<TPinchContext>;\n\nexport interface PointerDownInput {\n  readonly event: PointerEvent;\n  readonly kind: 'pointerdown';\n  /**\n   * Claims this pointer sequence once during the synchronous input dispatch and suppresses native text selection for\n   * its lifetime; returns `false` after that window.\n   */\n  readonly claim: (options?: PointerClaimOptions) => boolean;\n}\n\nexport interface WheelGestureInput extends WheelGesture {\n  /** Claims and prevents this wheel event during the synchronous input dispatch; returns `false` afterward. */\n  readonly claim: () => boolean;\n}\n\n/** Claimable starts, claimed pointer terminals, and normalized claimable wheel input. */\nexport type GestureInput = PointerDownInput | PointerEndGesture | WheelGestureInput;\n\n/** Precedence policy for claims among nested GestureController targets. */\nexport type GestureClaimPriority = 'self-first' | 'descendant-first';\n\nexport interface GestureControllerOptions<TPinchContext = undefined> {\n  /**\n   * Skips admission of a new pointer sequence or a stateless native event.\n   * The controller does not consult it again after a pointerdown claim.\n   */\n  readonly shouldIgnoreEvent?: (event: Event) => boolean;\n  /**\n   * Consulted once when the controller first observes two claimed pinch candidates.\n   * Returning `undefined` declines that pair; otherwise the controller retains the context for its pinch lifetime.\n   * The pair remains locked until fewer than two pinch candidates remain.\n   */\n  readonly beginPinch?: (start: PinchStart) => PinchStartDecision<TPinchContext> | undefined;\n  /** Consulted independently for each context-menu event. */\n  readonly shouldPreventContextMenu?: (event: MouseEvent) => boolean;\n  /**\n   * Determines precedence among nested GestureController targets.\n   *\n   * `self-first` is appropriate for a dedicated interaction surface.\n   * `descendant-first` lets nested controllers claim input before this controller.\n   *\n   * Defaults to `self-first`.\n   */\n  readonly claimPriority?: GestureClaimPriority;\n  /**\n   * Consulted during native pointerdown capture before descendant handlers.\n   *\n   * Returning true calls preventDefault() on the pointerdown, but does not\n   * claim the pointer, capture it, stop propagation, create pointer state,\n   * suppress selection, or start a gesture.\n   *\n   * This is meaningful with `claimPriority: 'descendant-first'`. It lets an\n   * activated higher-level interaction mode reserve a sequence for ordinary\n   * target-phase application code while preserving nested GestureController\n   * claim priority.\n   */\n  readonly shouldReservePointerDown?: (event: PointerEvent) => boolean;\n  /** Prevents native HTML drag competition on a dedicated interaction surface. */\n  readonly suppressNativeDrag?: boolean;\n  /**\n   * Inline `touch-action` for a dedicated interaction surface. The controller reevaluates a callback after host updates.\n   * Restores the target's prior inline value afterward.\n   * Avoid applying it to a general root that contains native interactive content.\n   */\n  readonly touchAction?: string | (() => string | undefined);\n}\n\ninterface PinchPair {\n  readonly firstPointerId: number;\n  readonly secondPointerId: number;\n}\n\ninterface PendingPinchState extends PinchPair {\n  readonly status: 'pending';\n}\n\ninterface DeclinedPinchState extends PinchPair {\n  readonly status: 'declined';\n}\n\ninterface ActivePinchState<TPinchContext> extends PinchPair, PinchStart {\n  readonly context: TPinchContext;\n  readonly distance: number;\n  readonly status: 'active';\n}\n\ntype PinchState<TPinchContext> = PendingPinchState | DeclinedPinchState | ActivePinchState<TPinchContext>;\n\ninterface TouchActionState {\n  readonly applied: string;\n  readonly priority: string;\n  readonly target: HTMLElement;\n  readonly value: string;\n}\n\ninterface UserSelectState {\n  readonly applied: string;\n  readonly appliedPriority: string;\n  readonly priority: string;\n  readonly target: HTMLElement;\n  readonly value: string;\n}\n\nclass SynchronousClaim<TOptions = void> {\n  #action?: (options?: TOptions) => void;\n\n  constructor(action: (options?: TOptions) => void) {\n    this.#action = action;\n  }\n\n  readonly claim = (options?: TOptions): boolean => {\n    const action = this.#action;\n    if (!action) return false;\n    this.#action = undefined;\n    action(options);\n    return true;\n  };\n\n  close(): void {\n    this.#action = undefined;\n  }\n}\n\ntype GestureHost = EventTarget & ReactiveControllerHost;\n\n/**\n * Normalizes claimable platform pointer and wheel input on a dynamically assigned target.\n * A pointer claim owns native input competition for its lifetime: the controller prevents claimed movement and text\n * selection, and can suppress native drag when configured.\n */\nexport class GestureController<TPinchContext = undefined> implements ReactiveController {\n  readonly #host: GestureHost;\n  readonly #options: GestureControllerOptions<TPinchContext>;\n  readonly #pointerStates = new Map<number, PointerState>();\n  #connected = false;\n  #pinch?: PinchState<TPinchContext>;\n  #target?: HTMLElement;\n  #touchActionState?: TouchActionState;\n  #userSelectState?: UserSelectState;\n\n  constructor(host: GestureHost, options: GestureControllerOptions<TPinchContext>) {\n    this.#host = host;\n    this.#options = options;\n    host.addController(this);\n  }\n\n  getWheelZoomFactor(input: Pick<WheelGesture, 'deltaY' | 'event'>): number {\n    const gain = input.event.ctrlKey ? CTRL_WHEEL_ZOOM_GAIN : 1;\n    return 2 ** (-input.deltaY * WHEEL_ZOOM_EXPONENT_PER_PIXEL * gain);\n  }\n\n  set target(target: HTMLElement | undefined) {\n    if (target === this.#target) return;\n    this.#removeTargetListeners();\n    this.#resetGestureState();\n    this.#target = target;\n    this.#addTargetListeners();\n  }\n\n  hostConnected(): void {\n    this.#connected = true;\n    this.#addTargetListeners();\n  }\n\n  hostDisconnected(): void {\n    this.#removeTargetListeners();\n    this.#resetGestureState();\n    this.#connected = false;\n  }\n\n  hostUpdated(): void {\n    this.#syncTouchAction();\n  }\n\n  #addTargetListeners(): void {\n    const target = this.#target;\n    if (!this.#connected || !target) return;\n    const capture = this.#options.claimPriority !== 'descendant-first';\n    for (const type of GESTURE_EVENT_TYPES) target.addEventListener(type, this.#handleEvent, capture);\n    if (this.#shouldListenForPointerDownReservation()) {\n      target.addEventListener('pointerdown', this.#handlePointerDownReservation, true);\n    }\n    this.#applyTouchAction(target);\n  }\n\n  #removeTargetListeners(): void {\n    const target = this.#target;\n    if (!this.#connected || !target) return;\n    const capture = this.#options.claimPriority !== 'descendant-first';\n    for (const type of GESTURE_EVENT_TYPES) target.removeEventListener(type, this.#handleEvent, capture);\n    if (this.#shouldListenForPointerDownReservation()) {\n      target.removeEventListener('pointerdown', this.#handlePointerDownReservation, true);\n    }\n    this.#restoreTouchAction();\n  }\n\n  #shouldListenForPointerDownReservation(): boolean {\n    return this.#options.claimPriority === 'descendant-first' && this.#options.shouldReservePointerDown !== undefined;\n  }\n\n  #handlePointerDownReservation = (event: PointerEvent): void => {\n    const target = this.#target;\n    if (\n      !target ||\n      event.currentTarget !== target ||\n      event.defaultPrevented ||\n      this.#options.shouldIgnoreEvent?.(event)\n    ) {\n      return;\n    }\n    if (this.#options.shouldReservePointerDown?.(event)) event.preventDefault();\n  };\n\n  #handleEvent = (event: Event): void => {\n    const target = this.#target;\n    if (!target || event.currentTarget !== target) return;\n    if (event.type === 'contextmenu' && event instanceof MouseEvent) {\n      this.#handleContextMenu(event);\n      return;\n    }\n    if (event.type === 'selectstart') {\n      this.#handleSelectStart(event);\n      return;\n    }\n    if (event instanceof WheelEvent) {\n      this.#handleWheel(event);\n      return;\n    }\n    if (event instanceof PointerEvent) {\n      this.#handlePointerEvent(event);\n      return;\n    }\n    this.#handleNativeDrag(event);\n  };\n\n  #handleNativeDrag(event: Event): void {\n    if (event.type !== 'dragstart' || this.#options.shouldIgnoreEvent?.(event)) return;\n    if (this.#options.suppressNativeDrag) event.preventDefault();\n  }\n\n  #handleContextMenu(event: MouseEvent): void {\n    if (this.#options.shouldIgnoreEvent?.(event)) return;\n    if (this.#options.shouldPreventContextMenu?.(event)) event.preventDefault();\n  }\n\n  #handleSelectStart(event: Event): void {\n    if (this.#pointerStates.size > 0) event.preventDefault();\n  }\n\n  #handlePointerEvent(event: PointerEvent): void {\n    const reason = getPointerEndReason(event);\n    if (reason !== undefined) {\n      if (this.#pointerStates.has(event.pointerId)) this.#endPointer(event, reason);\n      return;\n    }\n    if (event.type === 'pointerdown') {\n      if (!this.#options.shouldIgnoreEvent?.(event)) this.#handlePointerDown(event);\n    } else if (event.type === 'pointermove' && this.#pointerStates.has(event.pointerId)) {\n      this.#handlePointerMove(event);\n    }\n  }\n\n  #handleWheel(event: WheelEvent): void {\n    const target = this.#target;\n    if (!target || this.#options.shouldIgnoreEvent?.(event)) return;\n    const pageBounds = event.deltaMode === WheelEvent.DOM_DELTA_PAGE ? target.getBoundingClientRect() : undefined;\n    const deltaX = normalizeWheelDelta(event.deltaX, event.deltaMode, pageBounds?.width);\n    const deltaY = normalizeWheelDelta(event.deltaY, event.deltaMode, pageBounds?.height);\n    const claimWindow = new SynchronousClaim(() => {\n      event.preventDefault();\n      event.stopPropagation();\n    });\n    try {\n      this.#dispatchGestureInput({\n        claim: claimWindow.claim,\n        clientX: event.clientX,\n        clientY: event.clientY,\n        deltaX,\n        deltaY,\n        event,\n        kind: 'wheel'\n      });\n    } finally {\n      claimWindow.close();\n    }\n  }\n\n  #handlePointerDown(event: PointerEvent): void {\n    const claimWindow = new SynchronousClaim<PointerClaimOptions>(options => {\n      this.#pointerStates.set(event.pointerId, {\n        clientX: event.clientX,\n        clientY: event.clientY,\n        gestureKind: options?.kind,\n        movementX: 0,\n        movementY: 0,\n        pinchCandidate: options?.pinchCandidate ?? false,\n        pointerType: event.pointerType,\n        startClientX: event.clientX,\n        startClientY: event.clientY\n      });\n      const target = this.#target;\n      if (target) this.#applyUserSelect(target);\n      event.stopPropagation();\n      this.#capturePointer(event.pointerId);\n    });\n    try {\n      this.#dispatchGestureInput({ claim: claimWindow.claim, event, kind: 'pointerdown' });\n    } finally {\n      claimWindow.close();\n    }\n    this.#startPinchIfNeeded();\n  }\n\n  #handlePointerMove(event: PointerEvent): void {\n    const pointerState = this.#updatePointerPosition(event);\n    if (!pointerState) return;\n    event.stopPropagation();\n    if (pointerState.movementX === 0 && pointerState.movementY === 0) return;\n    if (this.#pointerStates.size >= 2 && this.#handlePinch(event)) return;\n    if (pointerState.gestureKind === undefined) return;\n    event.preventDefault();\n    this.#dispatchPointerMovementGesture(event, pointerState, pointerState.gestureKind);\n  }\n\n  #updatePointerPosition(event: PointerEvent): PointerState | undefined {\n    const pointerState = this.#pointerStates.get(event.pointerId);\n    if (!pointerState) return undefined;\n    pointerState.movementX = calculateDisplacement(event.clientX, pointerState.clientX);\n    pointerState.movementY = calculateDisplacement(event.clientY, pointerState.clientY);\n    pointerState.clientX = event.clientX;\n    pointerState.clientY = event.clientY;\n    return pointerState;\n  }\n\n  #dispatchPointerMovementGesture(event: PointerEvent, pointerState: PointerState, kind: 'drag' | 'pan'): void {\n    this.#dispatchGesture({\n      clientX: pointerState.clientX,\n      clientY: pointerState.clientY,\n      event,\n      kind,\n      movementX: pointerState.movementX,\n      movementY: pointerState.movementY,\n      startClientX: pointerState.startClientX,\n      startClientY: pointerState.startClientY,\n      totalDisplacementX: calculateDisplacement(pointerState.clientX, pointerState.startClientX),\n      totalDisplacementY: calculateDisplacement(pointerState.clientY, pointerState.startClientY)\n    });\n  }\n\n  #endPointer(event: PointerEvent, reason: PointerEndReason): void {\n    const pointerState = this.#pointerStates.get(event.pointerId);\n    if (!pointerState) return;\n    const interrupted = isPointerEndInterrupted(reason);\n    const clientX = interrupted ? pointerState.clientX : event.clientX;\n    const clientY = interrupted ? pointerState.clientY : event.clientY;\n    event.stopPropagation();\n    this.#dispatchGestureInput({\n      clientX,\n      clientY,\n      event,\n      interrupted,\n      kind: 'pointerend',\n      movementX: calculateDisplacement(clientX, pointerState.clientX),\n      movementY: calculateDisplacement(clientY, pointerState.clientY),\n      startClientX: pointerState.startClientX,\n      startClientY: pointerState.startClientY,\n      totalDisplacementX: calculateDisplacement(clientX, pointerState.startClientX),\n      totalDisplacementY: calculateDisplacement(clientY, pointerState.startClientY),\n      reason\n    });\n    this.#pointerStates.delete(event.pointerId);\n    if (this.#pointerStates.size === 0) this.#restoreUserSelect();\n    if (this.#countPinchCandidates() < 2) this.#pinch = undefined;\n  }\n\n  #handlePinch(event: PointerEvent): boolean {\n    this.#startPinchIfNeeded();\n    this.#beginPendingPinchIfPossible();\n    const pinch = this.#pinch;\n    const pointerState = this.#pointerStates.get(event.pointerId);\n    if (!pinch || !pointerState?.pinchCandidate) return false;\n    const isPairPointer = event.pointerId === pinch.firstPointerId || event.pointerId === pinch.secondPointerId;\n    if (pinch.status === 'pending') return true;\n    if (pinch.status === 'declined') return !isPairPointer;\n    if (!isPairPointer) return true;\n    return this.#dispatchActivePinch(event, pinch);\n  }\n\n  #dispatchActivePinch(event: PointerEvent, pinch: ActivePinchState<TPinchContext>): boolean {\n    const first = this.#pointerStates.get(pinch.firstPointerId);\n    const second = this.#pointerStates.get(pinch.secondPointerId);\n    if (!first || !second) return true;\n    const distance = calculatePointerDistance(first, second);\n    if (distance <= 0) return true;\n    const centerClientX = calculateMidpoint(first.clientX, second.clientX);\n    const centerClientY = calculateMidpoint(first.clientY, second.clientY);\n    event.preventDefault();\n    this.#dispatchGesture({\n      centerClientX,\n      centerClientY,\n      context: pinch.context,\n      event,\n      firstPointerId: pinch.firstPointerId,\n      firstPointerType: pinch.firstPointerType,\n      firstStartClientX: pinch.firstStartClientX,\n      firstStartClientY: pinch.firstStartClientY,\n      kind: 'pinch',\n      scale: distance / pinch.distance,\n      secondPointerId: pinch.secondPointerId,\n      secondPointerType: pinch.secondPointerType,\n      secondStartClientX: pinch.secondStartClientX,\n      secondStartClientY: pinch.secondStartClientY,\n      startCenterClientX: pinch.startCenterClientX,\n      startCenterClientY: pinch.startCenterClientY\n    });\n    return true;\n  }\n\n  #startPinchIfNeeded(): void {\n    const beginPinch = this.#options.beginPinch;\n    if (this.#pinch || this.#pointerStates.size < 2 || !beginPinch) return;\n    let firstPointerId: number | undefined;\n    let secondPointerId: number | undefined;\n    for (const pointerId of this.#pointerStates.keys()) {\n      if (!this.#pointerStates.get(pointerId)?.pinchCandidate) continue;\n      if (firstPointerId === undefined) firstPointerId = pointerId;\n      else {\n        secondPointerId = pointerId;\n        break;\n      }\n    }\n    if (firstPointerId === undefined || secondPointerId === undefined) return;\n    this.#pinch = { firstPointerId, secondPointerId, status: 'pending' };\n    this.#beginPendingPinchIfPossible();\n  }\n\n  #beginPendingPinchIfPossible(): void {\n    const pinch = this.#pinch;\n    const beginPinch = this.#options.beginPinch;\n    if (pinch?.status !== 'pending' || !beginPinch) return;\n    const first = this.#pointerStates.get(pinch.firstPointerId);\n    const second = this.#pointerStates.get(pinch.secondPointerId);\n    if (!first || !second) return;\n    const distance = calculatePointerDistance(first, second);\n    if (distance <= 0) return;\n    const start: PinchStart = {\n      firstPointerId: pinch.firstPointerId,\n      firstPointerType: first.pointerType,\n      firstStartClientX: first.startClientX,\n      firstStartClientY: first.startClientY,\n      secondPointerId: pinch.secondPointerId,\n      secondPointerType: second.pointerType,\n      secondStartClientX: second.startClientX,\n      secondStartClientY: second.startClientY,\n      startCenterClientX: calculateMidpoint(first.clientX, second.clientX),\n      startCenterClientY: calculateMidpoint(first.clientY, second.clientY)\n    };\n    const decision = beginPinch(start);\n    if (!decision) {\n      this.#pinch = {\n        firstPointerId: pinch.firstPointerId,\n        secondPointerId: pinch.secondPointerId,\n        status: 'declined'\n      };\n      return;\n    }\n    this.#pinch = {\n      context: decision.context,\n      distance,\n      status: 'active',\n      ...start\n    };\n  }\n\n  #countPinchCandidates(): number {\n    let count = 0;\n    for (const pointerState of this.#pointerStates.values()) {\n      if (pointerState.pinchCandidate) count += 1;\n    }\n    return count;\n  }\n\n  #capturePointer(pointerId: number): void {\n    try {\n      this.#target?.setPointerCapture?.(pointerId);\n    } catch {\n      // Synthetic test events and browser implementations may not have an active pointer to capture.\n    }\n  }\n\n  #applyTouchAction(target: HTMLElement): void {\n    const touchAction = this.#getTouchAction();\n    if (touchAction === undefined) return;\n    this.#touchActionState = {\n      applied: touchAction,\n      priority: target.style.getPropertyPriority('touch-action'),\n      target,\n      value: target.style.getPropertyValue('touch-action')\n    };\n    target.style.setProperty('touch-action', touchAction);\n  }\n\n  #restoreTouchAction(): void {\n    const state = this.#touchActionState;\n    this.#touchActionState = undefined;\n    if (!state || state.target.style.getPropertyValue('touch-action') !== state.applied) return;\n    if (state.value) {\n      state.target.style.setProperty('touch-action', state.value, state.priority);\n    } else {\n      state.target.style.removeProperty('touch-action');\n    }\n  }\n\n  #syncTouchAction(): void {\n    const target = this.#target;\n    if (!this.#connected || !target) return;\n    const touchAction = this.#getTouchAction();\n    if (touchAction === this.#touchActionState?.applied) return;\n    this.#restoreTouchAction();\n    if (touchAction !== undefined) this.#applyTouchAction(target);\n  }\n\n  #getTouchAction(): string | undefined {\n    const touchAction = this.#options.touchAction;\n    return typeof touchAction === 'function' ? touchAction() : touchAction;\n  }\n\n  #applyUserSelect(target: HTMLElement): void {\n    if (this.#userSelectState) return;\n    const applied = 'none';\n    const appliedPriority = '';\n    this.#userSelectState = {\n      applied,\n      appliedPriority,\n      priority: target.style.getPropertyPriority('user-select'),\n      target,\n      value: target.style.getPropertyValue('user-select')\n    };\n    target.style.setProperty('user-select', applied, appliedPriority);\n  }\n\n  #restoreUserSelect(): void {\n    const state = this.#userSelectState;\n    this.#userSelectState = undefined;\n    if (\n      !state ||\n      state.target.style.getPropertyValue('user-select') !== state.applied ||\n      state.target.style.getPropertyPriority('user-select') !== state.appliedPriority\n    ) {\n      return;\n    }\n    if (state.value) {\n      state.target.style.setProperty('user-select', state.value, state.priority);\n    } else {\n      state.target.style.removeProperty('user-select');\n    }\n  }\n\n  #dispatchGesture(gesture: Gesture<TPinchContext>): void {\n    this.#host.dispatchEvent(\n      new CustomEvent<Gesture<TPinchContext>>('nve-gesture', {\n        bubbles: false,\n        cancelable: false,\n        composed: false,\n        detail: gesture\n      })\n    );\n  }\n\n  #dispatchGestureInput(input: GestureInput): void {\n    this.#host.dispatchEvent(\n      new CustomEvent<GestureInput>('nve-gesture-input', {\n        bubbles: false,\n        cancelable: false,\n        composed: false,\n        detail: input\n      })\n    );\n  }\n\n  #resetGestureState(): void {\n    this.#pointerStates.clear();\n    this.#pinch = undefined;\n    this.#restoreUserSelect();\n  }\n}\n\nfunction calculateDisplacement(position: number, origin: number): number {\n  return position - origin;\n}\n\nfunction calculateMidpoint(first: number, second: number): number {\n  return (first + second) / 2;\n}\n\nfunction calculatePointerDistance(first: PointerState, second: PointerState): number {\n  return Math.hypot(first.clientX - second.clientX, first.clientY - second.clientY);\n}\n\nfunction getPointerEndReason(event: PointerEvent): PointerEndReason | undefined {\n  if (event.type === 'pointerup') return 'up';\n  if (event.type === 'pointercancel') return 'cancel';\n  if (event.type === 'lostpointercapture') return 'lost-capture';\n  if (event.type === 'pointermove' && event.buttons === 0) return 'buttons-released';\n  return undefined;\n}\n\nfunction isPointerEndInterrupted(reason: PointerEndReason): boolean {\n  return reason === 'cancel' || reason === 'lost-capture';\n}\n\nfunction normalizeWheelDelta(delta: number, deltaMode: number, pagePixels = 1): number {\n  if (deltaMode === WheelEvent.DOM_DELTA_LINE) return delta * WHEEL_LINE_PIXELS;\n  if (deltaMode === WheelEvent.DOM_DELTA_PAGE) return delta * pagePixels;\n  return delta;\n}\n"],"mappings":"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"}
+{"version":3,"file":"gesture.controller.js","names":["GESTURE_EVENT_TYPES","WHEEL_ZOOM_EXPONENT_PER_PIXEL","CTRL_WHEEL_ZOOM_GAIN","WHEEL_LINE_PIXELS","SynchronousClaim","action","#action","options","GestureController","#host","host","#options","gain","input","target","#target","#removeTargetListeners","#resetGestureState","#addTargetListeners","#connected","#syncTouchAction","capture","type","#handleEvent","#shouldListenForPointerDownReservation","#handlePointerDownReservation","#applyTouchAction","#restoreTouchAction","event","#handleContextMenu","#handleSelectStart","#handleWheel","#handlePointerEvent","#handleNativeDrag","#pointerStates","reason","getPointerEndReason","#handlePointerDown","#handlePointerMove","#endPointer","pageBounds","deltaX","normalizeWheelDelta","deltaY","claimWindow","#dispatchGestureInput","#applyUserSelect","#capturePointer","#startPinchIfNeeded","pointerState","#updatePointerPosition","#handlePinch","#dispatchPointerMovementGesture","calculateDisplacement","#dispatchGesture","interrupted","isPointerEndInterrupted","clientX","clientY","#restoreUserSelect","#countPinchCandidates","#pinch","#beginPendingPinchIfPossible","pinch","isPairPointer","#dispatchActivePinch","first","second","distance","calculatePointerDistance","centerClientX","calculateMidpoint","centerClientY","beginPinch","firstPointerId","secondPointerId","pointerId","start","decision","count","touchAction","#getTouchAction","#touchActionState","state","#userSelectState","applied","gesture","position","origin","deltaMode","delta","pagePixels"],"sources":["../../../src/internal/controllers/gesture.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\nconst GESTURE_EVENT_TYPES = [\n  'contextmenu',\n  'dragstart',\n  'lostpointercapture',\n  'pointercancel',\n  'pointerdown',\n  'pointermove',\n  'pointerup',\n  'selectstart',\n  'wheel'\n] as const;\n\nconst WHEEL_ZOOM_EXPONENT_PER_PIXEL = 0.002;\n\n/**\n * Browsers expose trackpad pinch as Ctrl-modified wheel input, so Ctrl-wheel uses a higher zoom gain.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/ctrlKey\n */\nconst CTRL_WHEEL_ZOOM_GAIN = 10;\n\nconst WHEEL_LINE_PIXELS = 16;\n\ninterface PointerState {\n  clientX: number;\n  clientY: number;\n  gestureKind: PointerClaimOptions['kind'];\n  movementX: number;\n  movementY: number;\n  pinchCandidate: boolean;\n  readonly pointerType: string;\n  readonly startClientX: number;\n  readonly startClientY: number;\n}\n\nexport interface PointerClaimOptions {\n  readonly kind?: 'drag' | 'pan';\n  readonly pinchCandidate?: boolean;\n}\n\nexport interface PinchStartDecision<TContext> {\n  readonly context: TContext;\n}\n\n/** Coordinates and deltas use CSS pixels; movement is sample-relative and total displacement is start-relative. */\nexport interface PointerMovementGesture {\n  readonly event: PointerEvent;\n  readonly clientX: number;\n  readonly clientY: number;\n  readonly movementX: number;\n  readonly movementY: number;\n  readonly startClientX: number;\n  readonly startClientY: number;\n  readonly totalDisplacementX: number;\n  readonly totalDisplacementY: number;\n}\n\nexport interface PinchStart {\n  readonly firstPointerId: number;\n  readonly firstPointerType: string;\n  readonly firstStartClientX: number;\n  readonly firstStartClientY: number;\n  readonly secondPointerId: number;\n  readonly secondPointerType: string;\n  readonly secondStartClientX: number;\n  readonly secondStartClientY: number;\n  readonly startCenterClientX: number;\n  readonly startCenterClientY: number;\n}\n\nexport interface PinchGesture<TContext> extends PinchStart {\n  readonly kind: 'pinch';\n  readonly event: PointerEvent;\n  readonly context: TContext;\n  /** Current pointer distance divided by the starting pointer distance. */\n  readonly scale: number;\n  readonly centerClientX: number;\n  readonly centerClientY: number;\n}\n\n/**\n * Per-event wheel input normalized to CSS pixels.\n *\n * Modifier-assisted trackpad pinch remains wheel input: consumers can classify it using the native event's\n * `ctrlKey` or `metaKey` without conflating it with the start-relative lifecycle of a two-pointer pinch.\n */\nexport interface WheelGesture {\n  readonly kind: 'wheel';\n  readonly event: WheelEvent;\n  readonly clientX: number;\n  readonly clientY: number;\n  readonly deltaX: number;\n  readonly deltaY: number;\n}\n\nexport type PointerEndReason = 'up' | 'cancel' | 'lost-capture' | 'buttons-released';\n\nexport interface PointerEndGesture extends PointerMovementGesture {\n  readonly kind: 'pointerend';\n  /** Whether the pointer session ended without an observed physical release. */\n  readonly interrupted: boolean;\n  readonly reason: PointerEndReason;\n}\n\nexport type Gesture<TPinchContext> =\n  | (PointerMovementGesture & { readonly kind: 'drag' })\n  | (PointerMovementGesture & { readonly kind: 'pan' })\n  | PinchGesture<TPinchContext>;\n\nexport interface PointerDownInput {\n  readonly event: PointerEvent;\n  readonly kind: 'pointerdown';\n  /**\n   * Claims this pointer sequence once during the synchronous input dispatch and suppresses native text selection for\n   * its lifetime; returns `false` after that window.\n   */\n  readonly claim: (options?: PointerClaimOptions) => boolean;\n}\n\nexport interface WheelGestureInput extends WheelGesture {\n  /** Claims and prevents this wheel event during the synchronous input dispatch; returns `false` afterward. */\n  readonly claim: () => boolean;\n}\n\n/** Claimable starts, claimed pointer terminals, and normalized claimable wheel input. */\nexport type GestureInput = PointerDownInput | PointerEndGesture | WheelGestureInput;\n\n/** Precedence policy for claims among nested GestureController targets. */\nexport type GestureClaimPriority = 'self-first' | 'descendant-first';\n\nexport interface GestureControllerOptions<TPinchContext = undefined> {\n  /**\n   * Skips admission of a new pointer sequence or a stateless native event.\n   * The controller does not consult it again after a pointerdown claim.\n   */\n  readonly shouldIgnoreEvent?: (event: Event) => boolean;\n  /**\n   * Consulted once when the controller first observes two claimed pinch candidates.\n   * Returning `undefined` declines that pair; otherwise the controller retains the context for its pinch lifetime.\n   * The pair remains locked until fewer than two pinch candidates remain.\n   */\n  readonly beginPinch?: (start: PinchStart) => PinchStartDecision<TPinchContext> | undefined;\n  /** Consulted independently for each context-menu event. */\n  readonly shouldPreventContextMenu?: (event: MouseEvent) => boolean;\n  /**\n   * Determines precedence among nested GestureController targets.\n   *\n   * `self-first` is appropriate for a dedicated interaction surface.\n   * `descendant-first` lets nested controllers claim input before this controller.\n   *\n   * Defaults to `self-first`.\n   */\n  readonly claimPriority?: GestureClaimPriority;\n  /**\n   * Consulted during native pointerdown capture before descendant handlers.\n   *\n   * Returning true calls preventDefault() on the pointerdown, but does not\n   * claim the pointer, capture it, stop propagation, create pointer state,\n   * suppress selection, or start a gesture.\n   *\n   * This is meaningful with `claimPriority: 'descendant-first'`. It lets an\n   * activated higher-level interaction mode reserve a sequence for ordinary\n   * target-phase application code while preserving nested GestureController\n   * claim priority.\n   */\n  readonly shouldReservePointerDown?: (event: PointerEvent) => boolean;\n  /** Prevents native HTML drag competition on a dedicated interaction surface. */\n  readonly suppressNativeDrag?: boolean;\n  /**\n   * Inline `touch-action` for a dedicated interaction surface. The controller reevaluates a callback after host updates.\n   * Restores the target's prior inline value afterward.\n   * Avoid applying it to a general root that contains native interactive content.\n   */\n  readonly touchAction?: string | (() => string | undefined);\n}\n\ninterface PinchPair {\n  readonly firstPointerId: number;\n  readonly secondPointerId: number;\n}\n\ninterface PendingPinchState extends PinchPair {\n  readonly status: 'pending';\n}\n\ninterface DeclinedPinchState extends PinchPair {\n  readonly status: 'declined';\n}\n\ninterface ActivePinchState<TPinchContext> extends PinchPair, PinchStart {\n  readonly context: TPinchContext;\n  readonly distance: number;\n  readonly status: 'active';\n}\n\ntype PinchState<TPinchContext> = PendingPinchState | DeclinedPinchState | ActivePinchState<TPinchContext>;\n\ninterface TouchActionState {\n  readonly applied: string;\n  readonly priority: string;\n  readonly target: HTMLElement;\n  readonly value: string;\n}\n\ninterface UserSelectState {\n  readonly applied: string;\n  readonly appliedPriority: string;\n  readonly priority: string;\n  readonly target: HTMLElement;\n  readonly value: string;\n}\n\nclass SynchronousClaim<TOptions = void> {\n  #action?: (options?: TOptions) => void;\n\n  constructor(action: (options?: TOptions) => void) {\n    this.#action = action;\n  }\n\n  readonly claim = (options?: TOptions): boolean => {\n    const action = this.#action;\n    if (!action) return false;\n    this.#action = undefined;\n    action(options);\n    return true;\n  };\n\n  close(): void {\n    this.#action = undefined;\n  }\n}\n\ntype GestureHost = EventTarget & ReactiveControllerHost;\n\n/**\n * Normalizes claimable platform pointer and wheel input on a dynamically assigned target.\n * A pointer claim owns native input competition for its lifetime: the controller prevents claimed movement and text\n * selection, and can suppress native drag when configured.\n */\nexport class GestureController<TPinchContext = undefined> implements ReactiveController {\n  readonly #host: GestureHost;\n  readonly #options: GestureControllerOptions<TPinchContext>;\n  readonly #pointerStates = new Map<number, PointerState>();\n  #connected = false;\n  #pinch?: PinchState<TPinchContext>;\n  #target?: HTMLElement;\n  #touchActionState?: TouchActionState;\n  #userSelectState?: UserSelectState;\n\n  constructor(host: GestureHost, options: GestureControllerOptions<TPinchContext>) {\n    this.#host = host;\n    this.#options = options;\n    host.addController(this);\n  }\n\n  getWheelZoomFactor(input: Pick<WheelGesture, 'deltaY' | 'event'>): number {\n    const gain = input.event.ctrlKey ? CTRL_WHEEL_ZOOM_GAIN : 1;\n    return 2 ** (-input.deltaY * WHEEL_ZOOM_EXPONENT_PER_PIXEL * gain);\n  }\n\n  set target(target: HTMLElement | undefined) {\n    if (target === this.#target) return;\n    this.#removeTargetListeners();\n    this.#resetGestureState();\n    this.#target = target;\n    this.#addTargetListeners();\n  }\n\n  hostConnected(): void {\n    this.#connected = true;\n    this.#addTargetListeners();\n  }\n\n  hostDisconnected(): void {\n    this.#removeTargetListeners();\n    this.#resetGestureState();\n    this.#connected = false;\n  }\n\n  hostUpdated(): void {\n    this.#syncTouchAction();\n  }\n\n  #addTargetListeners(): void {\n    const target = this.#target;\n    if (!this.#connected || !target) return;\n    const capture = this.#options.claimPriority !== 'descendant-first';\n    for (const type of GESTURE_EVENT_TYPES) target.addEventListener(type, this.#handleEvent, capture);\n    if (this.#shouldListenForPointerDownReservation()) {\n      target.addEventListener('pointerdown', this.#handlePointerDownReservation, true);\n    }\n    this.#applyTouchAction(target);\n  }\n\n  #removeTargetListeners(): void {\n    const target = this.#target;\n    if (!this.#connected || !target) return;\n    const capture = this.#options.claimPriority !== 'descendant-first';\n    for (const type of GESTURE_EVENT_TYPES) target.removeEventListener(type, this.#handleEvent, capture);\n    if (this.#shouldListenForPointerDownReservation()) {\n      target.removeEventListener('pointerdown', this.#handlePointerDownReservation, true);\n    }\n    this.#restoreTouchAction();\n  }\n\n  #shouldListenForPointerDownReservation(): boolean {\n    return this.#options.claimPriority === 'descendant-first' && this.#options.shouldReservePointerDown !== undefined;\n  }\n\n  #handlePointerDownReservation = (event: PointerEvent): void => {\n    const target = this.#target;\n    if (\n      !target ||\n      event.currentTarget !== target ||\n      event.defaultPrevented ||\n      this.#options.shouldIgnoreEvent?.(event)\n    ) {\n      return;\n    }\n    if (this.#options.shouldReservePointerDown?.(event)) event.preventDefault();\n  };\n\n  #handleEvent = (event: Event): void => {\n    const target = this.#target;\n    if (!target || event.currentTarget !== target) return;\n    if (event.type === 'contextmenu' && event instanceof MouseEvent) {\n      this.#handleContextMenu(event);\n      return;\n    }\n    if (event.type === 'selectstart') {\n      this.#handleSelectStart(event);\n      return;\n    }\n    if (event instanceof WheelEvent) {\n      this.#handleWheel(event);\n      return;\n    }\n    if (event instanceof PointerEvent) {\n      this.#handlePointerEvent(event);\n      return;\n    }\n    this.#handleNativeDrag(event);\n  };\n\n  #handleNativeDrag(event: Event): void {\n    if (event.type !== 'dragstart' || this.#options.shouldIgnoreEvent?.(event)) return;\n    if (this.#options.suppressNativeDrag) event.preventDefault();\n  }\n\n  #handleContextMenu(event: MouseEvent): void {\n    if (this.#options.shouldIgnoreEvent?.(event)) return;\n    if (this.#options.shouldPreventContextMenu?.(event)) event.preventDefault();\n  }\n\n  #handleSelectStart(event: Event): void {\n    if (this.#pointerStates.size > 0) event.preventDefault();\n  }\n\n  #handlePointerEvent(event: PointerEvent): void {\n    const reason = getPointerEndReason(event);\n    if (reason !== undefined) {\n      if (this.#pointerStates.has(event.pointerId)) this.#endPointer(event, reason);\n      return;\n    }\n    if (event.type === 'pointerdown') {\n      if (!this.#options.shouldIgnoreEvent?.(event)) this.#handlePointerDown(event);\n    } else if (event.type === 'pointermove' && this.#pointerStates.has(event.pointerId)) {\n      this.#handlePointerMove(event);\n    }\n  }\n\n  #handleWheel(event: WheelEvent): void {\n    const target = this.#target;\n    if (!target || this.#options.shouldIgnoreEvent?.(event)) return;\n    const pageBounds = event.deltaMode === WheelEvent.DOM_DELTA_PAGE ? target.getBoundingClientRect() : undefined;\n    const deltaX = normalizeWheelDelta(event.deltaX, event.deltaMode, pageBounds?.width);\n    const deltaY = normalizeWheelDelta(event.deltaY, event.deltaMode, pageBounds?.height);\n    const claimWindow = new SynchronousClaim(() => {\n      event.preventDefault();\n      event.stopPropagation();\n    });\n    try {\n      this.#dispatchGestureInput({\n        claim: claimWindow.claim,\n        clientX: event.clientX,\n        clientY: event.clientY,\n        deltaX,\n        deltaY,\n        event,\n        kind: 'wheel'\n      });\n    } finally {\n      claimWindow.close();\n    }\n  }\n\n  #handlePointerDown(event: PointerEvent): void {\n    const claimWindow = new SynchronousClaim<PointerClaimOptions>(options => {\n      this.#pointerStates.set(event.pointerId, {\n        clientX: event.clientX,\n        clientY: event.clientY,\n        gestureKind: options?.kind,\n        movementX: 0,\n        movementY: 0,\n        pinchCandidate: options?.pinchCandidate ?? false,\n        pointerType: event.pointerType,\n        startClientX: event.clientX,\n        startClientY: event.clientY\n      });\n      const target = this.#target;\n      if (target) this.#applyUserSelect(target);\n      event.stopPropagation();\n      this.#capturePointer(event.pointerId);\n    });\n    try {\n      this.#dispatchGestureInput({ claim: claimWindow.claim, event, kind: 'pointerdown' });\n    } finally {\n      claimWindow.close();\n    }\n    this.#startPinchIfNeeded();\n  }\n\n  #handlePointerMove(event: PointerEvent): void {\n    const pointerState = this.#updatePointerPosition(event);\n    if (!pointerState) return;\n    event.stopPropagation();\n    if (pointerState.movementX === 0 && pointerState.movementY === 0) return;\n    if (this.#pointerStates.size >= 2 && this.#handlePinch(event)) return;\n    if (pointerState.gestureKind === undefined) return;\n    event.preventDefault();\n    this.#dispatchPointerMovementGesture(event, pointerState, pointerState.gestureKind);\n  }\n\n  #updatePointerPosition(event: PointerEvent): PointerState | undefined {\n    const pointerState = this.#pointerStates.get(event.pointerId);\n    if (!pointerState) return undefined;\n    pointerState.movementX = calculateDisplacement(event.clientX, pointerState.clientX);\n    pointerState.movementY = calculateDisplacement(event.clientY, pointerState.clientY);\n    pointerState.clientX = event.clientX;\n    pointerState.clientY = event.clientY;\n    return pointerState;\n  }\n\n  #dispatchPointerMovementGesture(event: PointerEvent, pointerState: PointerState, kind: 'drag' | 'pan'): void {\n    this.#dispatchGesture({\n      clientX: pointerState.clientX,\n      clientY: pointerState.clientY,\n      event,\n      kind,\n      movementX: pointerState.movementX,\n      movementY: pointerState.movementY,\n      startClientX: pointerState.startClientX,\n      startClientY: pointerState.startClientY,\n      totalDisplacementX: calculateDisplacement(pointerState.clientX, pointerState.startClientX),\n      totalDisplacementY: calculateDisplacement(pointerState.clientY, pointerState.startClientY)\n    });\n  }\n\n  #endPointer(event: PointerEvent, reason: PointerEndReason): void {\n    const pointerState = this.#pointerStates.get(event.pointerId);\n    if (!pointerState) return;\n    const interrupted = isPointerEndInterrupted(reason, event);\n    const clientX = interrupted ? pointerState.clientX : event.clientX;\n    const clientY = interrupted ? pointerState.clientY : event.clientY;\n    event.stopPropagation();\n    this.#dispatchGestureInput({\n      clientX,\n      clientY,\n      event,\n      interrupted,\n      kind: 'pointerend',\n      movementX: calculateDisplacement(clientX, pointerState.clientX),\n      movementY: calculateDisplacement(clientY, pointerState.clientY),\n      startClientX: pointerState.startClientX,\n      startClientY: pointerState.startClientY,\n      totalDisplacementX: calculateDisplacement(clientX, pointerState.startClientX),\n      totalDisplacementY: calculateDisplacement(clientY, pointerState.startClientY),\n      reason\n    });\n    this.#pointerStates.delete(event.pointerId);\n    if (this.#pointerStates.size === 0) this.#restoreUserSelect();\n    if (this.#countPinchCandidates() < 2) this.#pinch = undefined;\n  }\n\n  #handlePinch(event: PointerEvent): boolean {\n    this.#startPinchIfNeeded();\n    this.#beginPendingPinchIfPossible();\n    const pinch = this.#pinch;\n    const pointerState = this.#pointerStates.get(event.pointerId);\n    if (!pinch || !pointerState?.pinchCandidate) return false;\n    const isPairPointer = event.pointerId === pinch.firstPointerId || event.pointerId === pinch.secondPointerId;\n    if (pinch.status === 'pending') return true;\n    if (pinch.status === 'declined') return !isPairPointer;\n    if (!isPairPointer) return true;\n    return this.#dispatchActivePinch(event, pinch);\n  }\n\n  #dispatchActivePinch(event: PointerEvent, pinch: ActivePinchState<TPinchContext>): boolean {\n    const first = this.#pointerStates.get(pinch.firstPointerId);\n    const second = this.#pointerStates.get(pinch.secondPointerId);\n    if (!first || !second) return true;\n    const distance = calculatePointerDistance(first, second);\n    if (distance <= 0) return true;\n    const centerClientX = calculateMidpoint(first.clientX, second.clientX);\n    const centerClientY = calculateMidpoint(first.clientY, second.clientY);\n    event.preventDefault();\n    this.#dispatchGesture({\n      centerClientX,\n      centerClientY,\n      context: pinch.context,\n      event,\n      firstPointerId: pinch.firstPointerId,\n      firstPointerType: pinch.firstPointerType,\n      firstStartClientX: pinch.firstStartClientX,\n      firstStartClientY: pinch.firstStartClientY,\n      kind: 'pinch',\n      scale: distance / pinch.distance,\n      secondPointerId: pinch.secondPointerId,\n      secondPointerType: pinch.secondPointerType,\n      secondStartClientX: pinch.secondStartClientX,\n      secondStartClientY: pinch.secondStartClientY,\n      startCenterClientX: pinch.startCenterClientX,\n      startCenterClientY: pinch.startCenterClientY\n    });\n    return true;\n  }\n\n  #startPinchIfNeeded(): void {\n    const beginPinch = this.#options.beginPinch;\n    if (this.#pinch || this.#pointerStates.size < 2 || !beginPinch) return;\n    let firstPointerId: number | undefined;\n    let secondPointerId: number | undefined;\n    for (const pointerId of this.#pointerStates.keys()) {\n      if (!this.#pointerStates.get(pointerId)?.pinchCandidate) continue;\n      if (firstPointerId === undefined) firstPointerId = pointerId;\n      else {\n        secondPointerId = pointerId;\n        break;\n      }\n    }\n    if (firstPointerId === undefined || secondPointerId === undefined) return;\n    this.#pinch = { firstPointerId, secondPointerId, status: 'pending' };\n    this.#beginPendingPinchIfPossible();\n  }\n\n  #beginPendingPinchIfPossible(): void {\n    const pinch = this.#pinch;\n    const beginPinch = this.#options.beginPinch;\n    if (pinch?.status !== 'pending' || !beginPinch) return;\n    const first = this.#pointerStates.get(pinch.firstPointerId);\n    const second = this.#pointerStates.get(pinch.secondPointerId);\n    if (!first || !second) return;\n    const distance = calculatePointerDistance(first, second);\n    if (distance <= 0) return;\n    const start: PinchStart = {\n      firstPointerId: pinch.firstPointerId,\n      firstPointerType: first.pointerType,\n      firstStartClientX: first.startClientX,\n      firstStartClientY: first.startClientY,\n      secondPointerId: pinch.secondPointerId,\n      secondPointerType: second.pointerType,\n      secondStartClientX: second.startClientX,\n      secondStartClientY: second.startClientY,\n      startCenterClientX: calculateMidpoint(first.clientX, second.clientX),\n      startCenterClientY: calculateMidpoint(first.clientY, second.clientY)\n    };\n    const decision = beginPinch(start);\n    if (!decision) {\n      this.#pinch = {\n        firstPointerId: pinch.firstPointerId,\n        secondPointerId: pinch.secondPointerId,\n        status: 'declined'\n      };\n      return;\n    }\n    this.#pinch = {\n      context: decision.context,\n      distance,\n      status: 'active',\n      ...start\n    };\n  }\n\n  #countPinchCandidates(): number {\n    let count = 0;\n    for (const pointerState of this.#pointerStates.values()) {\n      if (pointerState.pinchCandidate) count += 1;\n    }\n    return count;\n  }\n\n  #capturePointer(pointerId: number): void {\n    try {\n      this.#target?.setPointerCapture?.(pointerId);\n    } catch {\n      // Synthetic test events and browser implementations may not have an active pointer to capture.\n    }\n  }\n\n  #applyTouchAction(target: HTMLElement): void {\n    const touchAction = this.#getTouchAction();\n    if (touchAction === undefined) return;\n    this.#touchActionState = {\n      applied: touchAction,\n      priority: target.style.getPropertyPriority('touch-action'),\n      target,\n      value: target.style.getPropertyValue('touch-action')\n    };\n    target.style.setProperty('touch-action', touchAction);\n  }\n\n  #restoreTouchAction(): void {\n    const state = this.#touchActionState;\n    this.#touchActionState = undefined;\n    if (!state || state.target.style.getPropertyValue('touch-action') !== state.applied) return;\n    if (state.value) {\n      state.target.style.setProperty('touch-action', state.value, state.priority);\n    } else {\n      state.target.style.removeProperty('touch-action');\n    }\n  }\n\n  #syncTouchAction(): void {\n    const target = this.#target;\n    if (!this.#connected || !target) return;\n    const touchAction = this.#getTouchAction();\n    if (touchAction === this.#touchActionState?.applied) return;\n    this.#restoreTouchAction();\n    if (touchAction !== undefined) this.#applyTouchAction(target);\n  }\n\n  #getTouchAction(): string | undefined {\n    const touchAction = this.#options.touchAction;\n    return typeof touchAction === 'function' ? touchAction() : touchAction;\n  }\n\n  #applyUserSelect(target: HTMLElement): void {\n    if (this.#userSelectState) return;\n    const applied = 'none';\n    const appliedPriority = '';\n    this.#userSelectState = {\n      applied,\n      appliedPriority,\n      priority: target.style.getPropertyPriority('user-select'),\n      target,\n      value: target.style.getPropertyValue('user-select')\n    };\n    target.style.setProperty('user-select', applied, appliedPriority);\n  }\n\n  #restoreUserSelect(): void {\n    const state = this.#userSelectState;\n    this.#userSelectState = undefined;\n    if (\n      !state ||\n      state.target.style.getPropertyValue('user-select') !== state.applied ||\n      state.target.style.getPropertyPriority('user-select') !== state.appliedPriority\n    ) {\n      return;\n    }\n    if (state.value) {\n      state.target.style.setProperty('user-select', state.value, state.priority);\n    } else {\n      state.target.style.removeProperty('user-select');\n    }\n  }\n\n  #dispatchGesture(gesture: Gesture<TPinchContext>): void {\n    this.#host.dispatchEvent(\n      new CustomEvent<Gesture<TPinchContext>>('nve-gesture', {\n        bubbles: false,\n        cancelable: false,\n        composed: false,\n        detail: gesture\n      })\n    );\n  }\n\n  #dispatchGestureInput(input: GestureInput): void {\n    this.#host.dispatchEvent(\n      new CustomEvent<GestureInput>('nve-gesture-input', {\n        bubbles: false,\n        cancelable: false,\n        composed: false,\n        detail: input\n      })\n    );\n  }\n\n  #resetGestureState(): void {\n    this.#pointerStates.clear();\n    this.#pinch = undefined;\n    this.#restoreUserSelect();\n  }\n}\n\nfunction calculateDisplacement(position: number, origin: number): number {\n  return position - origin;\n}\n\nfunction calculateMidpoint(first: number, second: number): number {\n  return (first + second) / 2;\n}\n\nfunction calculatePointerDistance(first: PointerState, second: PointerState): number {\n  return Math.hypot(first.clientX - second.clientX, first.clientY - second.clientY);\n}\n\nfunction getPointerEndReason(event: PointerEvent): PointerEndReason | undefined {\n  if (event.type === 'pointerup') return 'up';\n  if (event.type === 'pointercancel') return 'cancel';\n  if (event.type === 'lostpointercapture') return 'lost-capture';\n  if (event.type === 'pointermove' && event.buttons === 0) return 'buttons-released';\n  return undefined;\n}\n\nfunction isPointerEndInterrupted(reason: PointerEndReason, event: PointerEvent): boolean {\n  return reason === 'cancel' || (reason === 'lost-capture' && event.buttons !== 0);\n}\n\nfunction normalizeWheelDelta(delta: number, deltaMode: number, pagePixels = 1): number {\n  if (deltaMode === WheelEvent.DOM_DELTA_LINE) return delta * WHEEL_LINE_PIXELS;\n  if (deltaMode === WheelEvent.DOM_DELTA_PAGE) return delta * pagePixels;\n  return delta;\n}\n"],"mappings":"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"}

package/dist/internal/controllers/key-state.controller.js

@@ -1,4 +1,4 @@
-//#region src/internal/controllers/key-state.controller.ts
+// src/internal/controllers/key-state.controller.ts
 var e = class {
 	#e;
 	#t = /* @__PURE__ */ new Set();
@@ -78,7 +78,6 @@ var r = class {
 		e !== this.#i && (this.#i?.unsubscribe(this.#t), this.#i = e, this.#i?.subscribe(this.#t));
 	}
 };
-//#endregion
 export { r as KeyStateController };
 
 //# sourceMappingURL=key-state.controller.js.map

package/dist/internal/controllers/key-state.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"key-state.controller.js","names":[],"sources":["../../../src/internal/controllers/key-state.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\nexport interface KeyStateControllerOptions {\n  readonly watchedCodes: ReadonlyArray<string>;\n}\n\ntype KeyStateHost = ReactiveControllerHost & Pick<HTMLElement, 'ownerDocument'>;\n\ninterface KeyStateSubscriber {\n  readonly watchedCodes: ReadonlySet<string>;\n  readonly requestUpdate: () => void;\n}\n\n/** Owns the keyboard state and global listeners shared by active controllers in one document. */\nclass DocumentKeyStateSource {\n  readonly #document: Document;\n  readonly #pressedCodes = new Set<string>();\n  readonly #subscribers = new Set<KeyStateSubscriber>();\n\n  constructor(document: Document) {\n    this.#document = document;\n  }\n\n  subscribe(subscriber: KeyStateSubscriber): void {\n    if (this.#subscribers.has(subscriber)) return;\n    if (this.#subscribers.size === 0) this.#addListeners();\n    this.#subscribers.add(subscriber);\n  }\n\n  unsubscribe(subscriber: KeyStateSubscriber): void {\n    if (!this.#subscribers.delete(subscriber) || this.#subscribers.size > 0) return;\n    this.#removeListeners();\n    this.#pressedCodes.clear();\n  }\n\n  isPressed(code: string): boolean {\n    return this.#pressedCodes.has(code);\n  }\n\n  #addListeners(): void {\n    const view = this.#document.defaultView;\n    view?.addEventListener('keydown', this.#handleKeyDown, true);\n    view?.addEventListener('keyup', this.#handleKeyUp, true);\n    view?.addEventListener('blur', this.#clear);\n    this.#document.addEventListener('visibilitychange', this.#handleVisibilityChange);\n  }\n\n  #removeListeners(): void {\n    const view = this.#document.defaultView;\n    view?.removeEventListener('keydown', this.#handleKeyDown, true);\n    view?.removeEventListener('keyup', this.#handleKeyUp, true);\n    view?.removeEventListener('blur', this.#clear);\n    this.#document.removeEventListener('visibilitychange', this.#handleVisibilityChange);\n  }\n\n  #handleKeyDown = (event: KeyboardEvent): void => {\n    if (this.#pressedCodes.has(event.code)) return;\n    this.#pressedCodes.add(event.code);\n    this.#notifySubscribers(event.code);\n  };\n\n  #handleKeyUp = (event: KeyboardEvent): void => {\n    if (!this.#pressedCodes.delete(event.code)) return;\n    this.#notifySubscribers(event.code);\n  };\n\n  #handleVisibilityChange = (): void => {\n    if (this.#document.visibilityState === 'hidden') this.#clear();\n  };\n\n  #clear = (): void => {\n    if (this.#pressedCodes.size === 0) return;\n    const changedCodes = [...this.#pressedCodes];\n    this.#pressedCodes.clear();\n    for (const subscriber of this.#subscribers) {\n      if (changedCodes.some(code => subscriber.watchedCodes.has(code))) subscriber.requestUpdate();\n    }\n  };\n\n  #notifySubscribers(code: string): void {\n    for (const subscriber of this.#subscribers) {\n      if (subscriber.watchedCodes.has(code)) subscriber.requestUpdate();\n    }\n  }\n}\n\nconst documentKeyStateSources = new WeakMap<Document, DocumentKeyStateSource>();\n\nfunction keyStateSourceFor(document: Document): DocumentKeyStateSource {\n  let source = documentKeyStateSources.get(document);\n  if (!source) {\n    source = new DocumentKeyStateSource(document);\n    documentKeyStateSources.set(document, source);\n  }\n  return source;\n}\n\n/** Provides host-scoped access to shared raw keyboard state without assigning interaction semantics to any key. */\nexport class KeyStateController implements ReactiveController {\n  readonly #host: KeyStateHost;\n  readonly #subscriber: KeyStateSubscriber;\n  #connected = false;\n  #enabled = false;\n  #source?: DocumentKeyStateSource;\n\n  constructor(host: KeyStateHost, { watchedCodes }: KeyStateControllerOptions) {\n    this.#host = host;\n    this.#subscriber = {\n      watchedCodes: new Set(watchedCodes),\n      requestUpdate: () => host.requestUpdate()\n    };\n    host.addController(this);\n  }\n\n  /** Enables shared keyboard tracking during the host's connected lifecycle. */\n  get enabled(): boolean {\n    return this.#enabled;\n  }\n\n  set enabled(value: boolean) {\n    if (value === this.#enabled) return;\n    this.#enabled = value;\n    this.#syncSubscription();\n  }\n\n  /** Returns whether a key identified by `KeyboardEvent.code` is currently held. */\n  isPressed(code: string): boolean {\n    return this.#source?.isPressed(code) ?? false;\n  }\n\n  hostConnected(): void {\n    this.#connected = true;\n    this.#syncSubscription();\n  }\n\n  hostDisconnected(): void {\n    this.#connected = false;\n    this.#syncSubscription();\n  }\n\n  #syncSubscription(): void {\n    const source = this.#connected && this.#enabled ? keyStateSourceFor(this.#host.ownerDocument) : undefined;\n    if (source === this.#source) return;\n    this.#source?.unsubscribe(this.#subscriber);\n    this.#source = source;\n    this.#source?.subscribe(this.#subscriber);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"key-state.controller.js","names":["DocumentKeyStateSource","#document","document","#subscribers","subscriber","#addListeners","#removeListeners","#pressedCodes","code","view","#handleKeyDown","#handleKeyUp","#clear","#handleVisibilityChange","event","#notifySubscribers","changedCodes","documentKeyStateSources","keyStateSourceFor","source","KeyStateController","#host","host","#subscriber","watchedCodes","#enabled","value","#syncSubscription","#source","#connected"],"sources":["../../../src/internal/controllers/key-state.controller.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\nexport interface KeyStateControllerOptions {\n  readonly watchedCodes: ReadonlyArray<string>;\n}\n\ntype KeyStateHost = ReactiveControllerHost & Pick<HTMLElement, 'ownerDocument'>;\n\ninterface KeyStateSubscriber {\n  readonly watchedCodes: ReadonlySet<string>;\n  readonly requestUpdate: () => void;\n}\n\n/** Owns the keyboard state and global listeners shared by active controllers in one document. */\nclass DocumentKeyStateSource {\n  readonly #document: Document;\n  readonly #pressedCodes = new Set<string>();\n  readonly #subscribers = new Set<KeyStateSubscriber>();\n\n  constructor(document: Document) {\n    this.#document = document;\n  }\n\n  subscribe(subscriber: KeyStateSubscriber): void {\n    if (this.#subscribers.has(subscriber)) return;\n    if (this.#subscribers.size === 0) this.#addListeners();\n    this.#subscribers.add(subscriber);\n  }\n\n  unsubscribe(subscriber: KeyStateSubscriber): void {\n    if (!this.#subscribers.delete(subscriber) || this.#subscribers.size > 0) return;\n    this.#removeListeners();\n    this.#pressedCodes.clear();\n  }\n\n  isPressed(code: string): boolean {\n    return this.#pressedCodes.has(code);\n  }\n\n  #addListeners(): void {\n    const view = this.#document.defaultView;\n    view?.addEventListener('keydown', this.#handleKeyDown, true);\n    view?.addEventListener('keyup', this.#handleKeyUp, true);\n    view?.addEventListener('blur', this.#clear);\n    this.#document.addEventListener('visibilitychange', this.#handleVisibilityChange);\n  }\n\n  #removeListeners(): void {\n    const view = this.#document.defaultView;\n    view?.removeEventListener('keydown', this.#handleKeyDown, true);\n    view?.removeEventListener('keyup', this.#handleKeyUp, true);\n    view?.removeEventListener('blur', this.#clear);\n    this.#document.removeEventListener('visibilitychange', this.#handleVisibilityChange);\n  }\n\n  #handleKeyDown = (event: KeyboardEvent): void => {\n    if (this.#pressedCodes.has(event.code)) return;\n    this.#pressedCodes.add(event.code);\n    this.#notifySubscribers(event.code);\n  };\n\n  #handleKeyUp = (event: KeyboardEvent): void => {\n    if (!this.#pressedCodes.delete(event.code)) return;\n    this.#notifySubscribers(event.code);\n  };\n\n  #handleVisibilityChange = (): void => {\n    if (this.#document.visibilityState === 'hidden') this.#clear();\n  };\n\n  #clear = (): void => {\n    if (this.#pressedCodes.size === 0) return;\n    const changedCodes = [...this.#pressedCodes];\n    this.#pressedCodes.clear();\n    for (const subscriber of this.#subscribers) {\n      if (changedCodes.some(code => subscriber.watchedCodes.has(code))) subscriber.requestUpdate();\n    }\n  };\n\n  #notifySubscribers(code: string): void {\n    for (const subscriber of this.#subscribers) {\n      if (subscriber.watchedCodes.has(code)) subscriber.requestUpdate();\n    }\n  }\n}\n\nconst documentKeyStateSources = new WeakMap<Document, DocumentKeyStateSource>();\n\nfunction keyStateSourceFor(document: Document): DocumentKeyStateSource {\n  let source = documentKeyStateSources.get(document);\n  if (!source) {\n    source = new DocumentKeyStateSource(document);\n    documentKeyStateSources.set(document, source);\n  }\n  return source;\n}\n\n/** Provides host-scoped access to shared raw keyboard state without assigning interaction semantics to any key. */\nexport class KeyStateController implements ReactiveController {\n  readonly #host: KeyStateHost;\n  readonly #subscriber: KeyStateSubscriber;\n  #connected = false;\n  #enabled = false;\n  #source?: DocumentKeyStateSource;\n\n  constructor(host: KeyStateHost, { watchedCodes }: KeyStateControllerOptions) {\n    this.#host = host;\n    this.#subscriber = {\n      watchedCodes: new Set(watchedCodes),\n      requestUpdate: () => host.requestUpdate()\n    };\n    host.addController(this);\n  }\n\n  /** Enables shared keyboard tracking during the host's connected lifecycle. */\n  get enabled(): boolean {\n    return this.#enabled;\n  }\n\n  set enabled(value: boolean) {\n    if (value === this.#enabled) return;\n    this.#enabled = value;\n    this.#syncSubscription();\n  }\n\n  /** Returns whether a key identified by `KeyboardEvent.code` is currently held. */\n  isPressed(code: string): boolean {\n    return this.#source?.isPressed(code) ?? false;\n  }\n\n  hostConnected(): void {\n    this.#connected = true;\n    this.#syncSubscription();\n  }\n\n  hostDisconnected(): void {\n    this.#connected = false;\n    this.#syncSubscription();\n  }\n\n  #syncSubscription(): void {\n    const source = this.#connected && this.#enabled ? keyStateSourceFor(this.#host.ownerDocument) : undefined;\n    if (source === this.#source) return;\n    this.#source?.unsubscribe(this.#subscriber);\n    this.#source = source;\n    this.#source?.subscribe(this.#subscriber);\n  }\n}\n"],"mappings":"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"}

package/dist/internal/controllers/keynav-grid.controller.examples.js

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

package/dist/internal/controllers/keynav-grid.controller.examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"keynav-grid.controller.examples.js","names":[],"sources":["../../../src/internal/controllers/keynav-grid.controller.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { css, html, LitElement } from 'lit';\nimport { state } from 'lit/decorators/state.js';\nimport { keyNavigationGrid } from '@nvidia-elements/core/internal';\n\nexport default {\n  title: 'Internal/Controllers'\n}\n\nconst styles = css`\n  section {\n    display: grid;\n    gap: 4px;\n    grid-template-columns: repeat(10, 50px);\n  }\n\n  .vertical {\n    grid-template-rows: repeat(10, 1fr);\n    grid-template-columns: 50px;\n  }\n\n  .row {\n    display: contents;\n  }\n\n  button {\n    width: 100%;\n    height: 30px;\n    min-width: 30px;\n    display: block;\n  }\n\n  button[selected] {\n    background: green;\n    color: white;\n  }\n`;\n\n@keyNavigationGrid<DemoKeyNavigationGridController>()\nclass DemoKeyNavigationGridController extends LitElement {\n  get keynavGridConfig() {\n    return {\n      rows: this.shadowRoot.querySelectorAll<HTMLElement>('.row'),\n      cells: this.shadowRoot.querySelectorAll<HTMLElement>('.cell')\n    }\n  }\n\n  @state() private selected = '0,0';\n  @state() private active = '';\n\n  static styles = [styles];\n\n  render() {\n    return html`\n      <p nve-text=\"body\">Selected: ${this.selected}</p>\n      <p nve-text=\"body\">Active: ${this.active}</p>\n      <section @nve-key-change=${e => (this.active = e.detail.activeItem.textContent)}>\n        ${Array.from(Array(10).keys()).map(() => Array.from(Array(10).keys())).map((r, ri) => html`<div class=\"row\">\n          ${r.map(c => html`<div class=\"cell\">\n            <button ?selected=${this.selected === `${ri}-${c}`} @click=${e => (this.selected = e.target.innerText)}>${ri}-${c}</button>\n          </div>`)}\n        </div>`)}\n      </section>\n    `;\n  }\n}\n\ncustomElements.get('demo-key-navigation-grid') || customElements.define('demo-key-navigation-grid', DemoKeyNavigationGridController);\n\n/**\n * @summary Grid-based keyboard navigation controller with arrow key support across rows and columns.\n * @tags test-case\n */\nexport const GridDemo = {\n  render: () => html`<demo-key-navigation-grid></demo-key-navigation-grid>`\n};\n"],"mappings":";AAGA,IAAA,IAAc"}
+{"version":3,"file":"keynav-grid.controller.examples.js","names":["keynav_grid_controller_examples_default"],"sources":["../../../src/internal/controllers/keynav-grid.controller.examples.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { css, html, LitElement } from 'lit';\nimport { state } from 'lit/decorators/state.js';\nimport { keyNavigationGrid } from '@nvidia-elements/core/internal';\n\nexport default {\n  title: 'Internal/Controllers'\n}\n\nconst styles = css`\n  section {\n    display: grid;\n    gap: 4px;\n    grid-template-columns: repeat(10, 50px);\n  }\n\n  .vertical {\n    grid-template-rows: repeat(10, 1fr);\n    grid-template-columns: 50px;\n  }\n\n  .row {\n    display: contents;\n  }\n\n  button {\n    width: 100%;\n    height: 30px;\n    min-width: 30px;\n    display: block;\n  }\n\n  button[selected] {\n    background: green;\n    color: white;\n  }\n`;\n\n@keyNavigationGrid<DemoKeyNavigationGridController>()\nclass DemoKeyNavigationGridController extends LitElement {\n  get keynavGridConfig() {\n    return {\n      rows: this.shadowRoot.querySelectorAll<HTMLElement>('.row'),\n      cells: this.shadowRoot.querySelectorAll<HTMLElement>('.cell')\n    }\n  }\n\n  @state() private selected = '0,0';\n  @state() private active = '';\n\n  static styles = [styles];\n\n  render() {\n    return html`\n      <p nve-text=\"body\">Selected: ${this.selected}</p>\n      <p nve-text=\"body\">Active: ${this.active}</p>\n      <section @nve-key-change=${e => (this.active = e.detail.activeItem.textContent)}>\n        ${Array.from(Array(10).keys()).map(() => Array.from(Array(10).keys())).map((r, ri) => html`<div class=\"row\">\n          ${r.map(c => html`<div class=\"cell\">\n            <button ?selected=${this.selected === `${ri}-${c}`} @click=${e => (this.selected = e.target.innerText)}>${ri}-${c}</button>\n          </div>`)}\n        </div>`)}\n      </section>\n    `;\n  }\n}\n\ncustomElements.get('demo-key-navigation-grid') || customElements.define('demo-key-navigation-grid', DemoKeyNavigationGridController);\n\n/**\n * @summary Grid-based keyboard navigation controller with arrow key support across rows and columns.\n * @tags test-case\n */\nexport const GridDemo = {\n  render: () => html`<demo-key-navigation-grid></demo-key-navigation-grid>`\n};\n"],"mappings":";AAGA,IAAAA,IAAc"}

package/dist/internal/controllers/keynav-grid.controller.js

@@ -3,7 +3,7 @@ import { throttle as t } from "../utils/events.js";
 import { focusElement as n, getActiveElement as r, isSimpleFocusable as i, setActiveKeyListItem as a } from "../utils/focus.js";
 import { KeynavCode as o, getFlattenedDOMTree as s, getFlattenedFocusableItems as c, hasInvalidDOMGrid as l, isContextMenuClick as u, validKeyNavigationCode as d } from "../utils/dom.js";
 import { GlobalStateService as f } from "@nvidia-elements/foundations/internal/state";
-//#region src/internal/controllers/keynav-grid.controller.ts
+// src/internal/controllers/keynav-grid.controller.ts
 function p() {
 	return (e) => e.addInitializer((e) => new m(e));
 }
@@ -72,11 +72,8 @@ var m = class {
 		if (!d(t)) return;
 		this.#u();
 		let n = Array.from(this.#o), a = Array.from(this.#s);
-		if (f.state.env !== "production" && l(n)) {
-			e.warn("Invalid grid structure, all rows must have the same number of cells");
-			return;
-		}
-		if (i(r())) {
+		if (f.state.env !== "production" && l(n)) e.warn("Invalid grid structure, all rows must have the same number of cells");
+		else if (i(r())) {
 			let { x: e, y: r } = _(a, n, {
 				code: t.code,
 				ctrlKey: t.ctrlKey,
@@ -156,7 +153,6 @@ function _(e, t, n) {
 		y: u
 	};
 }
-//#endregion
 export { m as KeyNavigationGridController, _ as getNextKeyGridItem, p as keyNavigationGrid };
 
 //# sourceMappingURL=keynav-grid.controller.js.map