@nvidia-elements/core 0.0.1 → 0.0.3

package/dist/internal/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/internal/types/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { TemplateResult } from 'lit';\nimport type { IconName } from '@nvidia-elements/core/icon';\nimport type { I18nStrings } from '../services/i18n.service.js';\n\nexport type Color =\n  | 'red-cardinal'\n  | 'gray-slate'\n  | 'gray-denim'\n  | 'blue-indigo'\n  | 'blue-cobalt'\n  | 'blue-sky'\n  | 'teal-cyan'\n  | 'green-mint'\n  | 'teal-seafoam'\n  | 'green-grass'\n  | 'yellow-amber'\n  | 'orange-pumpkin'\n  | 'red-tomato'\n  | 'pink-magenta'\n  | 'purple-plum'\n  | 'purple-violet'\n  | 'purple-lavender'\n  | 'pink-rose'\n  | 'green-jade'\n  | 'lime-pear'\n  | 'yellow-nova'\n  | 'brand-green';\n\n/** Controls the visual scale of an element to match its importance and available space.\n * - `sm` - Compact size for dense layouts or secondary elements with less visual prominence.\n * - `md` - Standard size that works well in most contexts and provides balanced visibility.\n * - `lg` - Larger size for emphasizing important elements or improving touch targets in spacious layouts.\n */\nexport type Size = 'sm' | 'md' | 'lg';\n\n/** Controls the visual scale of an element to match its importance and available space.\n * - `xs` - Extra small size for minimal elements or highly dense layouts.\n * - `sm` - Compact size for dense layouts or secondary elements with less visual prominence.\n * - `md` - Standard size that works well in most contexts and provides balanced visibility.\n * - `lg` - Larger size for emphasizing important elements or improving touch targets in spacious layouts.\n * - `xl` - Extra large size for emphasizing elements or sparse layouts.\n */\nexport type SizeExpanded = 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n\n/** Controls the visual prominence to establish hierarchy and guide user attention.\n * - `emphasis` - Increases visual weight to draw attention and highlight important elements.\n * - `muted` - Reduces visual weight for supporting content that should remain subtle and unobtrusive.\n */\nexport type Prominence = 'emphasis' | 'muted';\n\n/**\n * Determines the container bounds of the element\n * - `flat` Element has white space bounds but reduced visual container.\n * - `inline` Element container reduces to fit within inline content such as a block of text.\n * - `inset` Element container optimizes for embedding or inset placement inside another containing element.\n * - `full` Element container optimizes for filling its container bounds.\n * - `condensed` Element container optimizes for small, summarized or contained spaces.\n */\nexport type Container = 'inline' | 'flat' | 'inset' | 'full' | 'condensed';\n\n/** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n * - `accent` - Highlights important actions or draws attention to primary interactive elements.\n * - `warning` - Indicates cautionary actions that require careful consideration before proceeding.\n * - `success` - Represents positive outcomes, confirmations, or constructive actions.\n * - `danger` - Signals destructive or irreversible actions that need extra attention and confirmation.\n */\nexport type SupportStatus = 'accent' | 'warning' | 'success' | 'danger';\n\n/** Controls how the chart connects intermediate values between points in a data series.\n * - `linear` - Connects points with straight line segments.\n * - `smooth` - Connects points with smooth bezier curves.\n * - `step` - Connects points with horizontal and vertical step segments.\n */\nexport type Interpolation = 'linear' | 'smooth' | 'step';\n\n/** Determines the orientation of an element. */\nexport type Orientation = 'vertical' | 'horizontal';\n\n/** Communicates the current state of a task or process to keep users informed of progress and outcomes.\n * - `scheduled` - Task has a scheduled future execution at a specific time.\n * - `queued` - Task is waiting in line to begin after other tasks complete.\n * - `pending` - Task is awaiting approval, user input, or external conditions before proceeding.\n * - `starting` - Task is initializing and preparing to begin active execution.\n * - `running` - Task is actively executing and making progress.\n * - `restarting` - Task restarts after an interruption or reset.\n * - `stopping` - Task is gracefully shutting down and completing cleanup operations.\n * - `finished` - Task has completed successfully with the expected outcome.\n * - `failed` - Task encountered an error and did not complete as intended.\n * - `unknown` - Task status remains unknown or unavailable.\n * - `ignored` - Task was intentionally skipped or excluded from execution.\n */\nexport type TaskStatus =\n  | 'scheduled'\n  | 'queued'\n  | 'pending'\n  | 'starting'\n  | 'running'\n  | 'restarting'\n  | 'stopping'\n  | 'finished'\n  | 'failed'\n  | 'unknown'\n  | 'ignored';\n\n/**\n * https://open-ui.org/components/popup.research.explainer#api-shape\n * - `auto` light dismiss, focus on open, return to trigger\n * - `manual` no light dismiss, no auto focus\n * - `hint` no light dismiss, no auto focus, open/close on hover/focus\n */\nexport type PopoverType = 'auto' | 'manual' | 'hint' | 'inline';\n\n/** Controls how the popover aligns along the edge of its anchor element.\n * - `start` - Aligns the popover to the beginning edge of the anchor for left or top alignment.\n * - `end` - Aligns the popover to the ending edge of the anchor for right or bottom alignment.\n * - `center` - Centers the popover along the anchor's edge for balanced positioning.\n */\nexport type PopoverAlign = 'start' | 'end' | 'center';\n\n/** Determines the popover position relative to its assigned anchor and alignment.\n * - `top` - Positions the popover above the anchor element.\n * - `bottom` - Positions the popover below the anchor element.\n * - `left` - Positions the popover to the left side of the anchor element.\n * - `right` - Positions the popover to the right side of the anchor element.\n */\nexport type PopoverSides = 'top' | 'bottom' | 'left' | 'right';\n\n/** Controls the placement of the popover relative to its anchor element.\n * - `center` - Centers the popover directly over the anchor element.\n * - `top` - Positions the popover above the anchor element.\n * - `bottom` - Positions the popover below the anchor element.\n * - `left` - Positions the popover to the left side of the anchor element.\n * - `right` - Positions the popover to the right side of the anchor element.\n */\nexport type PopoverPosition = 'center' | 'top' | 'bottom' | 'left' | 'right';\n\n/** Determines the position of an element relative to its anchor */\nexport type Placement = PopoverPosition | `${PopoverSides}-${PopoverAlign}`;\n\n/** Controls the directional arrangement and spacing behavior of the element's content.\n * - `vertical` - Arranges content in a vertical stack with block-level spacing.\n * - `vertical-inline` - Arranges content vertically with compact inline spacing for dense layouts.\n * - `horizontal` - Arranges content in a horizontal row with block-level spacing.\n * - `horizontal-inline` - Arranges content horizontally with compact inline spacing.\n */\nexport type ControlLayout = 'vertical' | 'vertical-inline' | 'horizontal' | 'horizontal-inline';\n\n/** Indicates the element that represents the user's current location or position within a set. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)\n * - `page` - Marks the current page within a set of navigation links.\n * - `step` - Marks the current step within a multi-step process or workflow.\n */\nexport type Current = 'page' | 'step';\n\n/** Controls how data points are visually encoded in a sparkline chart.\n * - `line` - Renders data as a connected line to emphasize macro trend.\n * - `area` - Renders data as a filled area beneath a line to emphasize magnitude over time.\n * - `gradient` - Renders a line with gradient color treatment to communicate value intensity across the series.\n * - `column` - Renders data as vertical columns for easy comparison of discrete values.\n * - `winloss` - Renders outcomes as binary or ternary bars to highlight wins, losses, and optional ties.\n */\nexport type SparklineMark = 'line' | 'area' | 'gradient' | 'column' | 'winloss';\n\nexport interface NveElement {\n  /**\n   * This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled)\n   * - `true` - The element has a disabled state and does not accept interaction.\n   * - `false` - The element has an enabled state and accepts interaction.\n   */\n  disabled?: boolean;\n\n  /** Indicates whether the element is currently actively engaged through user interaction. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/:active)\n   * - `true` - The user is pressing or activating the element (mousedown, keydown, or touch).\n   * - `false` - No active user engagement on the element.\n   */\n  active?: boolean;\n\n  /** Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)\n   * - `true` - The associated content expands and becomes visible to the user.\n   * - `false` - The associated content collapses and hides from the user.\n   */\n  expanded?: boolean;\n\n  /** Indicates the current state of a toggle button that switches on or off. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)\n   * - `true` - The button is in the pressed (on) state and the associated action or setting is active.\n   * - `false` - The button is in the unpressed (off) state and the associated action or setting is inactive.\n   */\n  pressed?: boolean;\n\n  /** Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)\n   * - `true` - The element holds selection and represents the user's current choice within the group.\n   * - `false` - The element does not hold selection and the user can choose it.\n   */\n  selected?: boolean;\n\n  /** Indicates whether the user can change the element's value while it remains visible and focusable. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)\n   * - `true` - The element has a readonly state: the user cannot change its value, but can still focus and copy it.\n   * - `false` - The element allows editing and the user can change its value through interaction.\n   */\n  readonly?: boolean;\n\n  /** Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#value) */\n  value?: string;\n\n  /** The name of the element, submitted as a pair with the element value as part of the form data. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-name) */\n  name?: string;\n\n  /** Indicates whether the user can dismiss or close the element.\n   * - `true` - The element displays a close control and the user can dismiss it.\n   * - `false` - The user cannot close the element and must dismiss it programmatically.\n   */\n  closable?: boolean;\n\n  /** Enables updating internal string values for internationalization. */\n  i18n?: Partial<I18nStrings & { __set: boolean }>;\n\n  /** Indicates the element that represents the user's current location or position within a set. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)\n   * - `page` - Marks the current page within a set of navigation links.\n   * - `step` - Marks the current step within a multi-step process or workflow.\n   */\n  current?: 'page' | 'step';\n\n  /** Controls the horizontal alignment of the element within its container, respecting the text direction. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout/Box_alignment_in_grid_layout#the_two_axes_of_a_grid_layout)\n   * - `start` - Aligns the element to the beginning of the inline axis (left in LTR, right in RTL).\n   * - `center` - Centers the element along the inline axis for balanced visual positioning.\n   * - `end` - Aligns the element to the end of the inline axis (right in LTR, left in RTL).\n   */\n  inlinePosition?: 'start' | 'center' | 'end';\n\n  /** Controls the vertical alignment of the element within its container. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout/Box_alignment_in_grid_layout#the_two_axes_of_a_grid_layout)\n   * - `start` - Aligns the element to the top of the block axis for top-aligned positioning.\n   * - `center` - Centers the element along the block axis for balanced vertical positioning.\n   * - `end` - Aligns the element to the bottom of the block axis for bottom-aligned positioning.\n   */\n  blockPosition?: 'start' | 'center' | 'end';\n\n  /** Controls the directional arrangement and spacing behavior of the element's content.\n   * - `vertical` - Arranges content in a vertical stack with block-level spacing.\n   * - `vertical-inline` - Arranges content vertically with compact inline spacing for dense layouts.\n   * - `horizontal` - Arranges content in a horizontal row with block-level spacing.\n   * - `horizontal-inline` - Arranges content horizontally with compact inline spacing.\n   */\n  layout?: 'vertical' | 'vertical-inline' | 'horizontal' | 'horizontal-inline';\n\n  /** Controls the directional flow of the element's layout and interaction pattern.\n   * - `vertical` - Element orients vertically with top-to-bottom flow.\n   * - `horizontal` - Element orients horizontally with left-to-right flow.\n   */\n  orientation?: 'vertical' | 'horizontal';\n\n  /** Controls the visual prominence to establish hierarchy and guide user attention.\n   * - `emphasis` - Increases visual weight to draw attention and highlight important elements.\n   * - `muted` - Reduces visual weight for supporting content that should remain subtle and unobtrusive.\n   */\n  prominence?: 'emphasis' | 'muted';\n\n  /** The Interaction type provides a way to show the intent of an interactive element. This can help users quickly understand what each interaction does and reduce the potential for confusion or errors.\n   * - `emphasis` Shows the interaction targets emphasis or highlighting primary actions.\n   * - `destructive` Shows the interaction targets destructive actions such as deleting or removing.\n   */\n  interaction?: 'emphasis' | 'destructive';\n\n  /** Defines a base color from the theme color palette */\n  color?:\n    | 'red-cardinal'\n    | 'gray-slate'\n    | 'gray-denim'\n    | 'blue-indigo'\n    | 'blue-cobalt'\n    | 'blue-sky'\n    | 'teal-cyan'\n    | 'green-mint'\n    | 'teal-seafoam'\n    | 'green-grass'\n    | 'yellow-amber'\n    | 'orange-pumpkin'\n    | 'red-tomato'\n    | 'pink-magenta'\n    | 'purple-plum'\n    | 'purple-violet'\n    | 'purple-lavender'\n    | 'pink-rose'\n    | 'green-jade'\n    | 'lime-pear'\n    | 'yellow-nova'\n    | 'brand-green';\n\n  /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n   * - `accent` - Highlights important actions or draws attention to primary interactive elements.\n   * - `warning` - Indicates cautionary actions that require careful consideration before proceeding.\n   * - `success` - Represents positive outcomes, confirmations, or constructive actions.\n   * - `danger` - Signals destructive or irreversible actions that need extra attention and confirmation.\n   */\n  status?: 'accent' | 'warning' | 'success' | 'danger';\n\n  /** Controls the visual scale of an element to match its importance and available space.\n   * - `sm` - Compact size for dense layouts or secondary elements with less visual prominence.\n   * - `md` - Standard size that works well in most contexts and provides balanced visibility.\n   * - `lg` - Larger size for emphasizing important elements or improving touch targets in spacious layouts.\n   */\n  size?: 'sm' | 'md' | 'lg';\n\n  /**\n   * Demonstrates different container styles to accommodate visual weight and context.\n   * - `flat` Element has white space bounds but reduced visual container.\n   * - `inline` Element container reduces to fit within inline content such as a block of text.\n   * - `inset` Element container optimizes for embedding or inset placement inside another containing element.\n   * - `full` Element container optimizes for filling its container bounds.\n   */\n  container?: 'inline' | 'flat' | 'inset' | 'full';\n\n  /** Determines the position of an element along both inline and block axis. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_grid_layout/Box_alignment_in_grid_layout#the_two_axes_of_a_grid_layout) */\n  position?:\n    | 'top-start'\n    | 'top-end'\n    | 'top-center'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'bottom-center'\n    | 'left-start'\n    | 'left-end'\n    | 'left-center'\n    | 'right-start'\n    | 'right-end'\n    | 'right-center';\n\n  /** Determines the alignment of the popover relative to the provided anchor element. */\n  alignment?: 'start' | 'end' | 'center';\n\n  /** Provides the element that the popover should position relative to. Anchor can accept a idref string within the same render root or a HTMLElement DOM reference. */\n  anchor?: string | HTMLElement;\n\n  /** Defines what element triggers an `open` interaction event. A trigger can accept a idref string within the same render root or a HTMLElement DOM reference. */\n  trigger?: string | HTMLElement;\n\n  /** Defines named content areas where users can insert custom markup into the element.\n   * - `default` - The primary content area for the element.\n   * - `prefix` - Content that appears before the main element content.\n   * - `suffix` - Content that appears after the main element content.\n   * - `header` - Content that appears at the top of the element, used for titles or introductory information.\n   * - `footer` - Content that appears at the bottom of the element, used for supplementary information or actions.\n   * - `actions` - Content area specifically for interactive controls like buttons or links.\n   * - `icon` - Content area for displaying an icon that represents the element's purpose or state.\n   */\n  slots?: 'default' | 'prefix' | 'suffix' | 'header' | 'footer' | 'actions' | 'icon';\n\n  /**\n   * Sets the automatic dismissal time in milliseconds before the element emits a `close` event. Allow ~200-250ms per word for comfortable reading.\n   * - `0` - Warning or error messages requiring immediate acknowledgment.\n   * - `3000` - Brief success or confirmation messages.\n   * - `7000` - Standard informational messages.\n   * - `10000` - Messages with actions or requiring user decision.\n   */\n  closeTimeout?: number;\n\n  /**\n   * Sets the delay in milliseconds before the element emits a `open` event.\n   * - `0` - Keyboard focus interactions (always immediate for accessibility).\n   * - `500` - Dense interfaces with many tooltips to reduce visual noise and prevent accidental triggers.\n   */\n  openDelay?: number;\n\n  /** @private An instance of `ElementInternals` that decorators/controllers set dynamically */\n  _internals: ElementInternals;\n\n  render: TemplateResult;\n}\n\n/** Defines named content areas where users can insert custom markup into the element.\n * - `default` - The primary content area for the element.\n * - `prefix` - Content that appears before the main element content.\n * - `suffix` - Content that appears after the main element content.\n * - `header` - Content that appears at the top of the element, used for titles or introductory information.\n * - `footer` - Content that appears at the bottom of the element, used for supplementary information or actions.\n * - `actions` - Content area specifically for interactive controls like buttons or links.\n * - `icon` - Content area for displaying an icon that represents the element's purpose or state.\n */\nexport type SlotName = 'default' | 'prefix' | 'suffix' | 'header' | 'footer' | 'actions' | 'icon';\n\n/** @deprecated Determines the flat container element interaction. */\nexport type FlatInteraction = 'flat' | 'flat-emphasize' | `${'flat'}-${Interaction}`;\n\n/** @deprecated Determines if an element renders with an inverse contrast. */\nexport type Inverse = 'inverse';\n\n/** @deprecated Determines the trend status of an element. Should convey the trend of a metric. */\nexport type TrendStatus = 'trend-down' | 'trend-up' | 'trend-neutral';\n\n/** The Interaction type provides a way to show the intent of an interactive element. This can help users quickly understand what each interaction does and reduce the potential for confusion or errors.\n * - `emphasis` Shows the interaction targets emphasis or highlighting primary actions.\n * - `destructive` Shows the interaction targets destructive actions such as deleting or removing.\n */\nexport type Interaction = 'emphasis' | 'destructive';\n\nexport interface ContainerElement {\n  container?: Partial<Container>;\n}\n\n/** An element that renders complex data structures (e.g., arrays, series, matrices) rather than composable UI content and values expressible with primitive attributes. */\nexport interface DataElement<T extends unknown[] | Record<string, unknown>> {\n  data?: T;\n}\n\nexport const statusIcons: { [key: string]: IconName } = {\n  '': 'information-circle-stroke',\n  undefined: 'information-circle-stroke',\n  default: 'information-circle-stroke',\n  accent: 'information-circle-stroke',\n  warning: 'exclamation-triangle',\n  success: 'checkmark-circle',\n  danger: 'exclamation-circle',\n  scheduled: 'clock',\n  failed: 'x-circle',\n  finished: 'checkmark-circle',\n  unknown: 'question-mark-circle',\n  queued: 'bar-pill-stack',\n  running: 'running',\n  restarting: 'refresh',\n  stopping: 'stop-sign',\n  pending: 'circle-dash',\n  starting: 'circle-dot',\n  'trend-up': 'trend-up',\n  'trend-down': 'trend-down',\n  'trend-neutral': 'minus',\n  ignored: 'circle-angled-line'\n} as const;\n\ndeclare global {\n  var NVE_ELEMENTS: {\n    state: {\n      bundle: boolean;\n      env: 'watch' | 'production' | 'development';\n      pageHost: string;\n      moduleHost: string;\n      versions: string[];\n      scopedRegistry: { [key: string]: CustomElementRegistry };\n      elementRegistry: Readonly<{ [key: string]: string }>;\n      i18nRegistry: Readonly<{ [key: string]: string }>;\n      audit: Readonly<{\n        [key: string]: {\n          count?: number;\n          excessiveInstanceLimitAudited?: boolean;\n        };\n      }>;\n    };\n    debug: (log?: (...args: unknown[]) => void) => void;\n  };\n\n  /** @deprecated use NVE_ELEMENTS */\n  var MLV_ELEMENTS: typeof NVE_ELEMENTS;\n\n  interface HTMLElement {\n    'nve-text': string;\n    'nve-layout': string;\n  }\n\n  interface CustomElementRegistry {\n    initialize(root: ShadowRoot | Document): void;\n  }\n\n  var CustomElementRegistry: {\n    new (): CustomElementRegistry;\n    prototype: CustomElementRegistry;\n  };\n}\n\nexport interface ElementDefinition extends CustomElementConstructor {\n  metadata: { version: string; tag: string };\n  elementDefinitions?: { [key: string]: ElementDefinition };\n  shadowRootOptions?: { customElementRegistry?: CustomElementRegistry | null };\n}\n\nexport interface Point {\n  x: number;\n  y: number;\n}\n\nexport interface OffsetPoint {\n  offsetX: number;\n  offsetY: number;\n}\n\nexport interface Dimensions {\n  width: number;\n  height: number;\n}\n\nexport type Rect = Point & Dimensions;\n\nexport interface Scale {\n  min: number;\n  max: number;\n}\n\n/** https://github.com/tc39/proposal-decorators */\n// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\nexport type LegacyDecoratorTarget = Function & {\n  addInitializer?: (initializer: (instance: any) => void) => void; // eslint-disable-line @typescript-eslint/no-explicit-any\n};\n"],"mappings":";AAqZA,IAAa,IAA2C;CACtD,IAAI;CACJ,WAAW;CACX,SAAS;CACT,QAAQ;CACR,SAAS;CACT,SAAS;CACT,QAAQ;CACR,WAAW;CACX,QAAQ;CACR,UAAU;CACV,SAAS;CACT,QAAQ;CACR,SAAS;CACT,YAAY;CACZ,UAAU;CACV,SAAS;CACT,UAAU;CACV,YAAY;CACZ,cAAc;CACd,iBAAiB;CACjB,SAAS;CACV"}

package/dist/internal/utils/a11y.d.ts

@@ -0,0 +1,8 @@
+export declare function attachInternals(element: HTMLElement & {
+    _internals?: ElementInternals;
+}): void;
+export declare function associateLabel(label: HTMLLabelElement, input: HTMLInputElement): void;
+export declare function associateAriaLabel(label: HTMLElement, element: HTMLElement): void;
+export declare function associateAriaDescribedBy(messages: HTMLElement[], element: HTMLElement): void;
+export declare function associateDataList(datalist: HTMLDataListElement, element: HTMLInputElement): void;
+export declare function associateControlGroup(elements: HTMLInputElement[]): void;

package/dist/internal/utils/a11y.js

@@ -0,0 +1,30 @@
+import { generateId as e } from "./dom.js";
+//#region src/internal/utils/a11y.ts
+function t(e) {
+	e._internals === void 0 && (e._internals = e.attachInternals());
+}
+function n(t, n) {
+	t && n && (n.id = n.id ? n.id : e(), t.htmlFor = n.id);
+}
+function r(t, n) {
+	t && n && (t.id = t.id ? t.id : e(), n.setAttribute("aria-labelledby", t.id));
+}
+function i(t, n) {
+	if (t.length && n) {
+		let r = t.map((t) => t.id = e()).join(" ");
+		n.setAttribute("aria-describedby", r);
+	}
+}
+function a(t, n) {
+	t && (t.id = t.id?.length ? t.id : e(), n.setAttribute("list", t.id));
+}
+function o(t) {
+	if (!t.find((e) => e?.name?.length)) {
+		let n = e();
+		t.forEach((e) => e.name = n);
+	}
+}
+//#endregion
+export { i as associateAriaDescribedBy, r as associateAriaLabel, o as associateControlGroup, a as associateDataList, n as associateLabel, t as attachInternals };
+
+//# sourceMappingURL=a11y.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","names":[],"sources":["../../../src/internal/utils/a11y.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { generateId } from './dom.js';\n\nexport function attachInternals(element: HTMLElement & { _internals?: ElementInternals }) {\n  if (element._internals === undefined) {\n    element._internals = element.attachInternals() as unknown as ElementInternals;\n  }\n}\n\nexport function associateLabel(label: HTMLLabelElement, input: HTMLInputElement) {\n  if (label && input) {\n    input.id = input.id ? input.id : generateId();\n    label.htmlFor = input.id;\n  }\n}\n\nexport function associateAriaLabel(label: HTMLElement, element: HTMLElement) {\n  if (label && element) {\n    label.id = label.id ? label.id : generateId();\n    element.setAttribute('aria-labelledby', label.id);\n  }\n}\n\nexport function associateAriaDescribedBy(messages: HTMLElement[], element: HTMLElement) {\n  if (messages.length && element) {\n    const ids = messages.map(m => (m.id = generateId())).join(' ');\n    element.setAttribute('aria-describedby', ids);\n  }\n}\n\nexport function associateDataList(datalist: HTMLDataListElement, element: HTMLInputElement) {\n  if (datalist) {\n    datalist.id = datalist.id?.length ? datalist.id : generateId();\n    element.setAttribute('list', datalist.id);\n  }\n}\n\nexport function associateControlGroup(elements: HTMLInputElement[]) {\n  if (!elements.find(e => e?.name?.length)) {\n    const name = generateId();\n    elements.forEach(e => (e.name = name));\n  }\n}\n"],"mappings":";;AAKA,SAAgB,EAAgB,GAA0D;AACxF,CAAI,EAAQ,eAAe,KAAA,MACzB,EAAQ,aAAa,EAAQ,iBAAiB;;AAIlD,SAAgB,EAAe,GAAyB,GAAyB;AAC/E,CAAI,KAAS,MACX,EAAM,KAAK,EAAM,KAAK,EAAM,KAAK,GAAY,EAC7C,EAAM,UAAU,EAAM;;AAI1B,SAAgB,EAAmB,GAAoB,GAAsB;AAC3E,CAAI,KAAS,MACX,EAAM,KAAK,EAAM,KAAK,EAAM,KAAK,GAAY,EAC7C,EAAQ,aAAa,mBAAmB,EAAM,GAAG;;AAIrD,SAAgB,EAAyB,GAAyB,GAAsB;AACtF,KAAI,EAAS,UAAU,GAAS;EAC9B,IAAM,IAAM,EAAS,KAAI,MAAM,EAAE,KAAK,GAAY,CAAE,CAAC,KAAK,IAAI;AAC9D,IAAQ,aAAa,oBAAoB,EAAI;;;AAIjD,SAAgB,EAAkB,GAA+B,GAA2B;AAC1F,CAAI,MACF,EAAS,KAAK,EAAS,IAAI,SAAS,EAAS,KAAK,GAAY,EAC9D,EAAQ,aAAa,QAAQ,EAAS,GAAG;;AAI7C,SAAgB,EAAsB,GAA8B;AAClE,KAAI,CAAC,EAAS,MAAK,MAAK,GAAG,MAAM,OAAO,EAAE;EACxC,IAAM,IAAO,GAAY;AACzB,IAAS,SAAQ,MAAM,EAAE,OAAO,EAAM"}

package/dist/internal/utils/audit-logs.d.ts

@@ -0,0 +1,10 @@
+export declare const DOCS_LOG_URL: string;
+export declare function getExcessiveInstanceLimitWarning(count: number, localName: string): string;
+export declare function getInvalidSlottedChildrenWarning(localName: string, allowed: Array<string>): string;
+export declare function getInvalidParentWarning(localName: string, allowedParent: string): string;
+export declare function getIdMatchNotFoundWarning(id: string): string;
+export declare function getSSRMismatchWarning(localName: string): string;
+export declare function getCrossShadowRootAnchorWarning(localName: string): string;
+export declare function getDuplicatePackageVersionWarning(localName: string, version: string): string;
+export declare function getDuplicatePackageGlobalVersionWarning(): string;
+export declare function getEsmHostedWarning(): string;

package/dist/internal/utils/audit-logs.js

@@ -0,0 +1,31 @@
+import { DOCS_URL as e } from "./strings.js";
+//#region src/internal/utils/audit-logs.ts
+var t = `${e}docs/api-design/logs/`;
+function n(e, n) {
+	return `Excessive rendering of ${e} ${n} were detected in DOM. Recycle/reuse elements when possible to improve application performance. ${t}#excessive-instance-limit`;
+}
+function r(e, n) {
+	return `Invalid slotted elements detected in ${e}. Allowed: ${n.join(", ")}. ${t}#invalid-slotted-children`;
+}
+function i(e, n) {
+	return `Element ${e} can only be used as a direct child of ${n}. ${t}#invalid-parent`;
+}
+function a(e) {
+	return `Provided id "${e}" not found in DOM. ${t}#id-match-not-found`;
+}
+function o(e) {
+	return `${e} rendered on the client with mismatched SSR content. ${t}#ssr-mismatch`;
+}
+function s(e, n) {
+	return `@nve: Element ${e} version ${n} already defined, please check for duplicate package versions. ${t}#duplicate-package-version`;
+}
+function c() {
+	return `@nve: Multiple versions of Elements loaded, please check for duplicate package versions. ${t}#duplicate-package-version`;
+}
+function l() {
+	return "@nve: Using esm.sh is not supported for production use.";
+}
+//#endregion
+export { c as getDuplicatePackageGlobalVersionWarning, s as getDuplicatePackageVersionWarning, l as getEsmHostedWarning, n as getExcessiveInstanceLimitWarning, a as getIdMatchNotFoundWarning, i as getInvalidParentWarning, r as getInvalidSlottedChildrenWarning, o as getSSRMismatchWarning };
+
+//# sourceMappingURL=audit-logs.js.map

package/dist/internal/utils/audit-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logs.js","names":[],"sources":["../../../src/internal/utils/audit-logs.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { DOCS_URL } from './strings.js';\n\nexport const DOCS_LOG_URL = `${DOCS_URL}docs/api-design/logs/`;\n\nexport function getExcessiveInstanceLimitWarning(count: number, localName: string) {\n  return `Excessive rendering of ${count} ${localName} were detected in DOM. Recycle/reuse elements when possible to improve application performance. ${DOCS_LOG_URL}#excessive-instance-limit`;\n}\n\nexport function getInvalidSlottedChildrenWarning(localName: string, allowed: Array<string>) {\n  return `Invalid slotted elements detected in ${localName}. Allowed: ${allowed.join(', ')}. ${DOCS_LOG_URL}#invalid-slotted-children`;\n}\n\nexport function getInvalidParentWarning(localName: string, allowedParent: string) {\n  return `Element ${localName} can only be used as a direct child of ${allowedParent}. ${DOCS_LOG_URL}#invalid-parent`;\n}\n\nexport function getIdMatchNotFoundWarning(id: string) {\n  return `Provided id \"${id}\" not found in DOM. ${DOCS_LOG_URL}#id-match-not-found`;\n}\n\nexport function getSSRMismatchWarning(localName: string) {\n  return `${localName} rendered on the client with mismatched SSR content. ${DOCS_LOG_URL}#ssr-mismatch`;\n}\n\nexport function getCrossShadowRootAnchorWarning(localName: string) {\n  return `(deprecated) ${localName} provided an anchor outside of its render root. ${DOCS_LOG_URL}#cross-shadow-root-anchor`;\n}\n\nexport function getDuplicatePackageVersionWarning(localName: string, version: string) {\n  return `@nve: Element ${localName} version ${version} already defined, please check for duplicate package versions. ${DOCS_LOG_URL}#duplicate-package-version`;\n}\n\nexport function getDuplicatePackageGlobalVersionWarning() {\n  return `@nve: Multiple versions of Elements loaded, please check for duplicate package versions. ${DOCS_LOG_URL}#duplicate-package-version`;\n}\n\nexport function getEsmHostedWarning() {\n  return '@nve: Using esm.sh is not supported for production use.';\n}\n"],"mappings":";;AAKA,IAAa,IAAe,GAAG,EAAS;AAExC,SAAgB,EAAiC,GAAe,GAAmB;AACjF,QAAO,0BAA0B,EAAM,GAAG,EAAU,kGAAkG,EAAa;;AAGrK,SAAgB,EAAiC,GAAmB,GAAwB;AAC1F,QAAO,wCAAwC,EAAU,aAAa,EAAQ,KAAK,KAAK,CAAC,IAAI,EAAa;;AAG5G,SAAgB,EAAwB,GAAmB,GAAuB;AAChF,QAAO,WAAW,EAAU,yCAAyC,EAAc,IAAI,EAAa;;AAGtG,SAAgB,EAA0B,GAAY;AACpD,QAAO,gBAAgB,EAAG,sBAAsB,EAAa;;AAG/D,SAAgB,EAAsB,GAAmB;AACvD,QAAO,GAAG,EAAU,uDAAuD,EAAa;;AAO1F,SAAgB,EAAkC,GAAmB,GAAiB;AACpF,QAAO,iBAAiB,EAAU,WAAW,EAAQ,iEAAiE,EAAa;;AAGrI,SAAgB,IAA0C;AACxD,QAAO,4FAA4F,EAAa;;AAGlH,SAAgB,IAAsB;AACpC,QAAO"}

package/dist/internal/utils/audit.d.ts

@@ -0,0 +1,15 @@
+export declare function auditSlots(host: HTMLElement & {
+    constructor: {
+        metadata?: {
+            children?: string[];
+            disallowedChildren?: string[];
+        };
+    };
+}): [Element[], string[]];
+export declare function auditParentElement(host: HTMLElement & {
+    constructor: {
+        metadata?: {
+            parents?: string[];
+        };
+    };
+}): [boolean, string[]];

package/dist/internal/utils/audit.js

@@ -0,0 +1,13 @@
+//#region src/internal/utils/audit.ts
+function e(e) {
+	let t = ["template", ...e.constructor.metadata?.children ?? []].filter((e) => typeof e == "string");
+	return [Array.from(e.shadowRoot.querySelectorAll("slot")).flatMap((e) => e.assignedElements().filter((e) => !t.map((e) => e).includes(e.localName))), t];
+}
+function t(e) {
+	let t = e.constructor.metadata?.parents ?? [];
+	return t.length ? [!!t.find((t) => e.parentElement?.localName === t), t] : [!0, []];
+}
+//#endregion
+export { t as auditParentElement, e as auditSlots };
+
+//# sourceMappingURL=audit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","names":[],"sources":["../../../src/internal/utils/audit.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function auditSlots(\n  host: HTMLElement & { constructor: { metadata?: { children?: string[]; disallowedChildren?: string[] } } }\n): [Element[], string[]] {\n  const validElements = ['template', ...(host.constructor.metadata?.children ?? [])].filter(c => typeof c === 'string');\n  const invalidElements = Array.from(host.shadowRoot!.querySelectorAll('slot')).flatMap(slot =>\n    slot.assignedElements().filter(e => !validElements.map(i => i).includes(e.localName))\n  );\n  return [invalidElements, validElements];\n}\n\nexport function auditParentElement(\n  host: HTMLElement & { constructor: { metadata?: { parents?: string[] } } }\n): [boolean, string[]] {\n  const validParentTags = host.constructor.metadata?.parents ?? [];\n  return validParentTags.length\n    ? [!!validParentTags.find(p => host.parentElement?.localName === p), validParentTags]\n    : [true, []];\n}\n"],"mappings":";AAGA,SAAgB,EACd,GACuB;CACvB,IAAM,IAAgB,CAAC,YAAY,GAAI,EAAK,YAAY,UAAU,YAAY,EAAE,CAAE,CAAC,QAAO,MAAK,OAAO,KAAM,SAAS;AAIrH,QAAO,CAHiB,MAAM,KAAK,EAAK,WAAY,iBAAiB,OAAO,CAAC,CAAC,SAAQ,MACpF,EAAK,kBAAkB,CAAC,QAAO,MAAK,CAAC,EAAc,KAAI,MAAK,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CACtF,EACwB,EAAc;;AAGzC,SAAgB,EACd,GACqB;CACrB,IAAM,IAAkB,EAAK,YAAY,UAAU,WAAW,EAAE;AAChE,QAAO,EAAgB,SACnB,CAAC,CAAC,CAAC,EAAgB,MAAK,MAAK,EAAK,eAAe,cAAc,EAAE,EAAE,EAAgB,GACnF,CAAC,IAAM,EAAE,CAAC"}

package/dist/internal/utils/dom.d.ts

@@ -0,0 +1,79 @@
+import { ElementDefinition } from '../types/index.js';
+export declare function getChildren(node: Document | Node | HTMLElement): Element[];
+export declare function generateId(): string;
+export declare function getAttributeChanges(element: HTMLElement, attr: string, fn: (attrValue: string | null) => void): MutationObserver;
+export declare function getAttributeListChanges(element: HTMLElement, attrs: string[], fn: (mutation: MutationRecord) => void): MutationObserver;
+/**
+ * Appends styles to the render root of a given element. This is useful for
+ * styles that apply outside the scope of the element's shadow
+ * root such as UA styles --webkit-* that won't work in a ::slotted selector
+ */
+export declare function appendRootNodeStyle(host: HTMLElement, styles: string): CSSStyleSheet;
+export declare function styleSheetToString(stylesheet: CSSStyleSheet): string;
+/** Intercepts a property setter on an element so `callback` fires on every assignment. Does not use a MutationObserver. */
+export declare function getPropertyChanges(element: HTMLElement, key: string, callback: (value: unknown) => void): void;
+export declare function getElementUpdate(element: HTMLElement, key: string, callback: (value: unknown) => void): MutationObserver;
+export declare function clickOutsideElementBounds(event: PointerEvent | MouseEvent, element: HTMLElement): boolean;
+/** parses number out of basic calc generated by the design tokens */
+export declare function parseTokenNumber(value: string): number;
+/** true if the browser supports scoped custom element registries */
+export declare const supportsScopedRegistry: boolean;
+/** defines an element with the given custom element registry */
+export declare function defineElement(element: ElementDefinition, customElementRegistry: CustomElementRegistry): void;
+/** defines an element with the global custom element registry */
+export declare function define(element: ElementDefinition): void;
+export declare function isContextMenuClick(event: MouseEvent): boolean;
+export declare function getFlattenedFocusableItems(element: Node, depth?: number): HTMLElement[];
+/**
+ * Preserves visual DOM ordering when using slots within Shadow DOM
+ * See more information/resources on Shadow DOM linear traversal
+ * https://nolanlawson.com/2021/02/13/managing-focus-in-the-shadow-dom/
+ * https://www.abeautifulsite.net/posts/querying-through-shadow-roots/
+ */
+export declare function getFlattenedDOMTree(node: Node, depth?: number): HTMLElement[];
+export declare function validKeyNavigationCode(e: KeyboardEvent): boolean;
+export declare enum KeynavCode {
+    End = "End",
+    Home = "Home",
+    PageUp = "PageUp",
+    PageDown = "PageDown",
+    ArrowUp = "ArrowUp",
+    ArrowDown = "ArrowDown",
+    ArrowLeft = "ArrowLeft",
+    ArrowRight = "ArrowRight"
+}
+export declare function hasInvalidDOMGrid(rows: HTMLElement[]): boolean;
+export declare function removeEmptyTextNode(node: Node): void;
+export declare function scrollBarWidth(): number;
+export declare function hasScrollBar(el: HTMLElement): boolean;
+export declare function hasHorizontalScrollBar(el: HTMLElement): boolean;
+export declare function endOfScrollBox(element: HTMLElement, offset?: number): boolean;
+export declare function openEyeDropper(): Promise<string>;
+/**
+ * provides a object with key/value of the currently applied design tokens
+ */
+export declare function getThemeTokens(element?: Element): {
+    [x: string]: string;
+};
+export declare function removeEmptySlotWhitespace(slot: HTMLSlotElement): void;
+export declare function slotContainsOnlyWhitespace(slot: HTMLSlotElement): boolean;
+export declare function applySlotContentStates(slot: HTMLSlotElement, element: HTMLElement & {
+    _internals: ElementInternals;
+}): void;
+export declare function getDisplayValue(option?: {
+    label?: string;
+    value?: string;
+}): string;
+/** returns a combination of nve and mlv for a prefixed tag selector */
+export declare function tagSelector(selector: string): string;
+/** determines if HTML element matches the given component tag */
+export declare function matchesElementName(element: Partial<HTMLElement>, component: {
+    metadata: {
+        tag: string;
+    };
+}): boolean;
+export declare function createGhostElement(sourceElement: HTMLElement): HTMLDivElement;
+export declare function sameRenderRoot(element1: HTMLElement, element2: HTMLElement): boolean;
+export declare function getAnchorNames(element: HTMLElement): string[];
+export declare function removeAnchorName(element: HTMLElement, name: string): void;
+export declare function appendAnchorName(element: HTMLElement, name: string): void;

package/dist/internal/utils/dom.js

@@ -0,0 +1,178 @@
+import { GlobalStateService as e } from "../services/global.service.js";
+import { isFocusable as t } from "./focus.js";
+//#region src/internal/utils/dom.ts
+function n(e) {
+	if (e instanceof Document && e.documentElement) return Array.from(e.documentElement.children);
+	if (e instanceof HTMLElement && e.shadowRoot) return Array.from(e.shadowRoot.children);
+	if (e instanceof HTMLSlotElement && e.assignedElements) {
+		let t = e.assignedElements();
+		return t.length ? t : Array.from(e.children);
+	} else return Array.from(e.children);
+}
+function r() {
+	return `_${self.crypto.getRandomValues(new Uint32Array(1))[0].toString(16)}`;
+}
+function i(e, t, n) {
+	n(e.getAttribute(t));
+	let r = new MutationObserver((e) => {
+		e.forEach((e) => {
+			e.attributeName === t && n(e.target.getAttribute(t));
+		});
+	});
+	return r.observe(e, {
+		attributes: !0,
+		subtree: !0
+	}), r;
+}
+function a(e, t, n) {
+	let r = new MutationObserver((e) => {
+		e.forEach((e) => {
+			e.attributeName && t.includes(e.attributeName) && n(e);
+		});
+	});
+	return r.observe(e, {
+		attributes: !0,
+		subtree: !0
+	}), r;
+}
+function o(e, t) {
+	let n = new CSSStyleSheet();
+	n.replaceSync(t);
+	let r = e.getRootNode();
+	return r.adoptedStyleSheets && (r.adoptedStyleSheets.map((e) => s(e)).find((e) => e === s(n)) || (r.adoptedStyleSheets = [...Array.from(r.adoptedStyleSheets), n])), n;
+}
+function s(e) {
+	return e.cssRules ? Array.from(e.cssRules).map((e) => e.cssText || "").join("\n") : "";
+}
+function c(e, t, n) {
+	let r = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(e), t);
+	if (!r) return;
+	let i = Object.getOwnPropertyDescriptor(e, t);
+	i && i.configurable === !1 || Object.defineProperty(e, t, {
+		configurable: !0,
+		get: r.get,
+		set: (t) => {
+			r.set.call(e, t), n(t);
+		}
+	});
+}
+function l(e, t, n) {
+	return e.hasAttribute(t) ? n(e.getAttribute(t)) : e[t] !== void 0 && n(e[t]), c(e, t, n), i(e, t, (e) => n(e));
+}
+function u(e, t) {
+	let { left: n, right: r, top: i, bottom: a } = t.getBoundingClientRect();
+	return e.clientX < n || e.clientX > r || e.clientY < i || e.clientY > a;
+}
+function d(e) {
+	return parseInt(e.includes("calc") ? e.split("*")[1].replace("px)", "").trim() : e, 10) || 0;
+}
+var f = globalThis.CustomElementRegistry && "initialize" in CustomElementRegistry.prototype;
+function p(t, n) {
+	Object.entries(t.elementDefinitions ?? {}).filter(([e, t]) => !n.get(t.metadata.tag)).forEach(([e, t]) => {
+		p(t, n);
+	}), n.get(t.metadata.tag) || (n.define(t.metadata.tag, t), n === customElements && e.dispatch("NVE_ELEMENT_DEFINE", { elementRegistry: { [t.metadata.tag]: t.metadata.version } }));
+}
+function m(t) {
+	let { version: n } = t.metadata;
+	f && !customElements.get(t.metadata.tag) ? (customElements.define(t.metadata.tag, t), e.dispatch("NVE_ELEMENT_DEFINE", { elementRegistry: { [t.metadata.tag]: t.metadata.version } })) : p(t, customElements), e.state.elementRegistry[t.metadata.tag] !== n && globalThis?.location?.hostname === "localhost" && import("./audit-logs.js").then((e) => console.warn(e.getDuplicatePackageVersionWarning(t.metadata.tag, n)));
+}
+function h(e) {
+	return e.buttons === 2 && !e.ctrlKey || e.buttons === 1 && e.ctrlKey;
+}
+function g(e, n = 10) {
+	return _(e, n).filter((e) => t(e));
+}
+function _(e, t = 10) {
+	return Array.from(n(e)).reduce((e, r) => [...e, [r, [...Array.from(n(r)).map((e) => [e, _(e, t)])]]], []).flat(t);
+}
+function v(e) {
+	return b.has(e.code);
+}
+var y = /* @__PURE__ */ function(e) {
+	return e.End = "End", e.Home = "Home", e.PageUp = "PageUp", e.PageDown = "PageDown", e.ArrowUp = "ArrowUp", e.ArrowDown = "ArrowDown", e.ArrowLeft = "ArrowLeft", e.ArrowRight = "ArrowRight", e;
+}({}), b = new Set(Object.values(y));
+function x(e) {
+	return e.some((t) => t.children.length !== e[0].children.length);
+}
+function S(e) {
+	e?.wholeText?.trim() === "" && e.remove();
+}
+function C() {
+	let e = globalThis.document.createElement("div");
+	e.style.setProperty("width", "100px"), e.style.setProperty("height", "100px"), e.style.setProperty("overflow", "scroll"), e.style.setProperty("position", "absolute"), e.style.setProperty("top", "-9999px"), globalThis.document.body.appendChild(e);
+	let t = e.offsetWidth - e.clientWidth;
+	return globalThis.document.body.removeChild(e), t;
+}
+function w(e) {
+	return e.scrollHeight > e.clientHeight;
+}
+function T(e) {
+	return e.scrollWidth > e.clientWidth;
+}
+function E(e, t = 0) {
+	return e.scrollTop + e.offsetHeight + t >= e.scrollHeight;
+}
+async function D() {
+	return await new globalThis.EyeDropper().open().then((e) => e.sRGBHex);
+}
+function O(e = globalThis.document.querySelector(":root")) {
+	let t = getComputedStyle(e), n = [];
+	try {
+		n = Array.from(globalThis.parent.document.styleSheets);
+	} catch {}
+	return [...n, ...Array.from(globalThis.document.styleSheets)].reduce((e, t) => {
+		let n = [];
+		try {
+			n = [...t.cssRules];
+		} catch {}
+		return e.concat(n.filter((e) => e.type === 1).reduce((e, t) => {
+			let n = [...t.style].filter((e) => e.trim().includes("--nve")).map((e) => [e.trim(), t.style.getPropertyValue(e).trim()]);
+			return [...e, ...n];
+		}, []));
+	}, []).reduce((e, n) => ({
+		...e,
+		[n[0]]: t.getPropertyValue(n[0])
+	}), {});
+}
+function k(e) {
+	A(e) && e.assignedNodes().forEach((e) => e.parentNode?.removeChild(e));
+}
+function A(e) {
+	let t = !e.assignedNodes().find((e) => e.nodeType !== Node.TEXT_NODE), n = !e.assignedNodes().find((e) => e.nodeType === Node.TEXT_NODE && (e.textContent ?? "").trim() !== "");
+	return t && n;
+}
+function j(e, t) {
+	let n = e.assignedNodes(), r = e.name ?? "slot";
+	n.length ? t._internals.states.add(`has-${r}`) : t._internals.states.delete(`has-${r}`);
+}
+function M(e) {
+	return e?.label || e?.value || "";
+}
+function N(e) {
+	return `${e.replaceAll("nve-", "nve-")}, ${e.replaceAll("nve-", "nve-")}`;
+}
+function P(e, t) {
+	return e.localName === t.metadata.tag.replace("nve-", "nve-") || e.localName === t.metadata.tag.replace("nve-", "nve-");
+}
+function F(e) {
+	let t = globalThis.document.createElement("div"), { width: n } = e.getBoundingClientRect();
+	return t.setAttribute("nve-ghost", ""), t.style.minWidth = `${n}px`, t.style.maxWidth = `${n}px`, t.style.height = "1px", t.slot = e.slot, t;
+}
+function I(e, t) {
+	let n = e.getRootNode(), r = t.getRootNode(), i = n instanceof ShadowRoot && r instanceof ShadowRoot && n === r, a = n === globalThis.document && r === globalThis.document;
+	return i || a || n === r;
+}
+function L(e) {
+	return e.style.anchorName?.split(",")?.map((e) => e.trim())?.filter((e) => e !== "none" && e !== "") ?? [];
+}
+function R(e, t) {
+	let n = L(e);
+	e.style.anchorName = n.filter((e) => e !== t).join(",");
+}
+function z(e, t) {
+	e.style.anchorName = Array.from(new Set([...L(e), t])).join(",");
+}
+//#endregion
+export { y as KeynavCode, z as appendAnchorName, o as appendRootNodeStyle, j as applySlotContentStates, u as clickOutsideElementBounds, F as createGhostElement, m as define, p as defineElement, E as endOfScrollBox, r as generateId, L as getAnchorNames, i as getAttributeChanges, a as getAttributeListChanges, n as getChildren, M as getDisplayValue, l as getElementUpdate, _ as getFlattenedDOMTree, g as getFlattenedFocusableItems, c as getPropertyChanges, O as getThemeTokens, T as hasHorizontalScrollBar, x as hasInvalidDOMGrid, w as hasScrollBar, h as isContextMenuClick, P as matchesElementName, D as openEyeDropper, d as parseTokenNumber, R as removeAnchorName, k as removeEmptySlotWhitespace, S as removeEmptyTextNode, I as sameRenderRoot, C as scrollBarWidth, A as slotContainsOnlyWhitespace, s as styleSheetToString, f as supportsScopedRegistry, N as tagSelector, v as validKeyNavigationCode };
+
+//# sourceMappingURL=dom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","names":[],"sources":["../../../src/internal/utils/dom.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from '../services/global.service.js';\nimport type { ElementDefinition } from '../types/index.js';\nimport { isFocusable } from './focus.js';\n\nexport function getChildren(node: Document | Node | HTMLElement): Element[] {\n  if (node instanceof Document && node.documentElement) {\n    return Array.from(node.documentElement.children); // root document children\n  } else if (node instanceof HTMLElement && node.shadowRoot) {\n    return Array.from(node.shadowRoot.children); // shadow root direct children\n  } else if (node instanceof HTMLSlotElement && node.assignedElements) {\n    const slotted = node.assignedElements(); // slotted elements\n    return slotted.length ? slotted : Array.from(node.children); // slot fallback\n  } else {\n    return Array.from((node as HTMLElement).children); // light DOM direct children\n  }\n}\n\nexport function generateId() {\n  const uint32 = self.crypto.getRandomValues(new Uint32Array(1))[0]!;\n  return `_${uint32.toString(16)}`;\n}\n\nexport function getAttributeChanges(element: HTMLElement, attr: string, fn: (attrValue: string | null) => void) {\n  fn(element.getAttribute(attr));\n  const observer = new MutationObserver(mutations => {\n    mutations.forEach(mutation => {\n      if (mutation.attributeName === attr) {\n        fn((mutation.target as HTMLElement).getAttribute(attr));\n      }\n    });\n  });\n  observer.observe(element, { attributes: true, subtree: true });\n  return observer;\n}\n\nexport function getAttributeListChanges(element: HTMLElement, attrs: string[], fn: (mutation: MutationRecord) => void) {\n  const observer = new MutationObserver(mutations => {\n    mutations.forEach(mutation => {\n      if (mutation.attributeName && attrs.includes(mutation.attributeName)) {\n        fn(mutation);\n      }\n    });\n  });\n  observer.observe(element, { attributes: true, subtree: true });\n  return observer;\n}\n\n/**\n * Appends styles to the render root of a given element. This is useful for\n * styles that apply outside the scope of the element's shadow\n * root such as UA styles --webkit-* that won't work in a ::slotted selector\n */\nexport function appendRootNodeStyle(host: HTMLElement, styles: string) {\n  const stylesheet = new CSSStyleSheet();\n  stylesheet.replaceSync(styles);\n  const root = host.getRootNode() as Document | ShadowRoot;\n  if (root.adoptedStyleSheets) {\n    const hasStyleSheet = root.adoptedStyleSheets\n      .map(s => styleSheetToString(s))\n      .find(s => s === styleSheetToString(stylesheet));\n    if (!hasStyleSheet) {\n      root.adoptedStyleSheets = [...Array.from(root.adoptedStyleSheets), stylesheet];\n    }\n  }\n  return stylesheet;\n}\n\nexport function styleSheetToString(stylesheet: CSSStyleSheet) {\n  return stylesheet.cssRules\n    ? Array.from(stylesheet.cssRules)\n        .map(rule => rule.cssText || '')\n        .join('\\n')\n    : '';\n}\n\n/** Intercepts a property setter on an element so `callback` fires on every assignment. Does not use a MutationObserver. */\nexport function getPropertyChanges(element: HTMLElement, key: string, callback: (value: unknown) => void) {\n  const proto = Object.getPrototypeOf(element);\n  const descriptor = Object.getOwnPropertyDescriptor(proto, key);\n  if (!descriptor) return;\n  const own = Object.getOwnPropertyDescriptor(element, key);\n  if (own && own.configurable === false) return;\n  Object.defineProperty(element, key, {\n    configurable: true,\n    get: descriptor.get,\n    set: (val: unknown) => {\n      descriptor.set!.call(element, val);\n      callback(val);\n    }\n  });\n}\n\n/* used for cases of needing to know a property update outside of lit, example a native input value prop change */\nexport function getElementUpdate(element: HTMLElement, key: string, callback: (value: unknown) => void) {\n  if (element.hasAttribute(key)) {\n    callback(element.getAttribute(key));\n  } else if ((element as unknown as Record<string, unknown>)[key] !== undefined) {\n    callback((element as unknown as Record<string, unknown>)[key]);\n  }\n\n  getPropertyChanges(element, key, callback);\n  return getAttributeChanges(element, key, val => callback(val));\n}\n\nexport function clickOutsideElementBounds(event: PointerEvent | MouseEvent, element: HTMLElement) {\n  const { left, right, top, bottom } = element.getBoundingClientRect();\n  return event.clientX < left || event.clientX > right || event.clientY < top || event.clientY > bottom;\n}\n\n/** parses number out of basic calc generated by the design tokens */\nexport function parseTokenNumber(value: string) {\n  return parseInt(value.includes('calc') ? value.split('*')[1]!.replace('px)', '').trim() : value, 10) || 0;\n}\n\n/** true if the browser supports scoped custom element registries */\nexport const supportsScopedRegistry =\n  globalThis.CustomElementRegistry && 'initialize' in CustomElementRegistry.prototype;\n\n/** defines an element with the given custom element registry */\nexport function defineElement(element: ElementDefinition, customElementRegistry: CustomElementRegistry) {\n  Object.entries(element.elementDefinitions ?? {})\n    .filter(([_tag, e]) => !customElementRegistry.get(e.metadata.tag))\n    .forEach(([_tag, e]) => {\n      defineElement(e, customElementRegistry);\n    });\n\n  if (!customElementRegistry.get(element.metadata.tag)) {\n    customElementRegistry.define(element.metadata.tag, element);\n\n    if (customElementRegistry === customElements) {\n      GlobalStateService.dispatch('NVE_ELEMENT_DEFINE', {\n        elementRegistry: { [element.metadata.tag]: element.metadata.version }\n      });\n    }\n  }\n}\n\n/** defines an element with the global custom element registry */\nexport function define(element: ElementDefinition) {\n  const { version } = element.metadata;\n\n  // if scoped registry supported, register only the root element to global registry\n  if (supportsScopedRegistry && !customElements.get(element.metadata.tag)) {\n    customElements.define(element.metadata.tag, element);\n    GlobalStateService.dispatch('NVE_ELEMENT_DEFINE', {\n      elementRegistry: { [element.metadata.tag]: element.metadata.version }\n    });\n  } else {\n    // if scoped registry not supported, register the element and all its children to the global registry\n    defineElement(element, customElements);\n  }\n\n  // warn on duplicate version\n  if (\n    GlobalStateService.state.elementRegistry[element.metadata.tag] !== version &&\n    globalThis?.location?.hostname === 'localhost'\n  ) {\n    void import('./audit-logs.js').then(m =>\n      console.warn(m.getDuplicatePackageVersionWarning(element.metadata.tag, version))\n    );\n  }\n}\n\nexport function isContextMenuClick(event: MouseEvent) {\n  return (event.buttons === 2 && !event.ctrlKey) || (event.buttons === 1 && event.ctrlKey);\n}\n\nexport function getFlattenedFocusableItems(element: Node, depth = 10) {\n  return getFlattenedDOMTree(element, depth).filter((e: HTMLElement) => isFocusable(e)) as HTMLElement[];\n}\n\n/**\n * Preserves visual DOM ordering when using slots within Shadow DOM\n * See more information/resources on Shadow DOM linear traversal\n * https://nolanlawson.com/2021/02/13/managing-focus-in-the-shadow-dom/\n * https://www.abeautifulsite.net/posts/querying-through-shadow-roots/\n */\nexport function getFlattenedDOMTree(node: Node, depth = 10): HTMLElement[] {\n  return (\n    Array.from(getChildren(node)).reduce(\n      (p: unknown[], n: Node) => [\n        ...p,\n        [n, [...Array.from(getChildren(n)).map(i => [i, getFlattenedDOMTree(i, depth)])]]\n      ],\n      []\n    ) as unknown as HTMLElement[]\n  ).flat(depth);\n}\n\nexport function validKeyNavigationCode(e: KeyboardEvent) {\n  return keynavCodes.has(e.code);\n}\n\nexport enum KeynavCode {\n  End = 'End',\n  Home = 'Home',\n  PageUp = 'PageUp',\n  PageDown = 'PageDown',\n  ArrowUp = 'ArrowUp',\n  ArrowDown = 'ArrowDown',\n  ArrowLeft = 'ArrowLeft',\n  ArrowRight = 'ArrowRight'\n}\n\nconst keynavCodes: Set<string> = new Set(Object.values(KeynavCode));\n\nexport function hasInvalidDOMGrid(rows: HTMLElement[]) {\n  return rows.some(row => row.children.length !== rows[0]!.children.length);\n}\n\nexport function removeEmptyTextNode(node: Node) {\n  if ((node as Text)?.wholeText?.trim() === '') {\n    (node as Text).remove();\n  }\n}\n\nexport function scrollBarWidth() {\n  const div = globalThis.document.createElement('div');\n  div.style.setProperty('width', '100px');\n  div.style.setProperty('height', '100px');\n  div.style.setProperty('overflow', 'scroll');\n  div.style.setProperty('position', 'absolute');\n  div.style.setProperty('top', '-9999px');\n  globalThis.document.body.appendChild(div);\n  const width = div.offsetWidth - div.clientWidth;\n  globalThis.document.body.removeChild(div);\n  return width;\n}\n\nexport function hasScrollBar(el: HTMLElement) {\n  return el.scrollHeight > el.clientHeight;\n}\n\nexport function hasHorizontalScrollBar(el: HTMLElement) {\n  return el.scrollWidth > el.clientWidth;\n}\n\nexport function endOfScrollBox(element: HTMLElement, offset = 0) {\n  return element.scrollTop + element.offsetHeight + offset >= element.scrollHeight;\n}\n\nexport async function openEyeDropper(): Promise<string> {\n  return await new (\n    globalThis as unknown as { EyeDropper: new () => { open: () => Promise<{ sRGBHex: string }> } }\n  ).EyeDropper()\n    .open()\n    .then((color: { sRGBHex: string }) => color.sRGBHex);\n}\n\n/**\n * provides a object with key/value of the currently applied design tokens\n */\nexport function getThemeTokens(element = globalThis.document.querySelector(':root')!) {\n  // default root or provided element\n  const styles = getComputedStyle(element);\n  let parent: CSSStyleSheet[] = [];\n\n  // check for parent iframe, same domain iframes change how the browser accesses style sheets\n  try {\n    parent = Array.from(globalThis.parent.document.styleSheets);\n  } catch {\n    // if not accessible, skip\n  }\n\n  return [...parent, ...Array.from(globalThis.document.styleSheets)]\n    .reduce((finalArr: string[][], sheet) => {\n      let rules: CSSRule[] = [];\n      try {\n        rules = [...sheet.cssRules];\n      } catch {\n        // if the style sheet is not accessible, skip\n      }\n      return finalArr.concat(\n        rules\n          .filter(rule => rule.type === 1)\n          .reduce((propValArr: string[][], rule) => {\n            const props = [...(rule as CSSStyleRule).style]\n              .filter((p: string) => p.trim().includes('--nve'))\n              .map((propName: string) => [\n                propName.trim(),\n                (rule as CSSStyleRule).style.getPropertyValue(propName).trim()\n              ]);\n            return [...propValArr, ...props];\n          }, [])\n      );\n    }, [])\n    .reduce(\n      (p: Record<string, string>, token: string[]) => ({ ...p, [token[0]!]: styles.getPropertyValue(token[0]!) }),\n      {}\n    );\n}\n\nexport function removeEmptySlotWhitespace(slot: HTMLSlotElement) {\n  if (slotContainsOnlyWhitespace(slot)) {\n    slot.assignedNodes().forEach((node: Node) => node.parentNode?.removeChild(node));\n  }\n}\n\nexport function slotContainsOnlyWhitespace(slot: HTMLSlotElement) {\n  const hasNoElements = !slot.assignedNodes().find(i => i.nodeType !== Node.TEXT_NODE);\n  const hasOnlyEmptyTextNodes = !slot\n    .assignedNodes()\n    .find(i => i.nodeType === Node.TEXT_NODE && (i.textContent ?? '').trim() !== '');\n  return hasNoElements && hasOnlyEmptyTextNodes;\n}\n\nexport function applySlotContentStates(slot: HTMLSlotElement, element: HTMLElement & { _internals: ElementInternals }) {\n  const nodes = slot.assignedNodes();\n  const name = slot.name ?? 'slot';\n\n  if (nodes.length) {\n    element._internals.states.add(`has-${name}`);\n  } else {\n    element._internals.states.delete(`has-${name}`);\n  }\n}\n\nexport function getDisplayValue(option?: { label?: string; value?: string }): string {\n  return option?.label || option?.value || '';\n}\n\n/** returns a combination of nve and mlv for a prefixed tag selector */\nexport function tagSelector(selector: string) {\n  return `${selector.replaceAll('nve-', 'nve-')}, ${selector.replaceAll('nve-', 'nve-')}`;\n}\n\n/** determines if HTML element matches the given component tag */\nexport function matchesElementName(element: Partial<HTMLElement>, component: { metadata: { tag: string } }) {\n  return (\n    element.localName === component.metadata.tag.replace('nve-', 'nve-') ||\n    element.localName === component.metadata.tag.replace('nve-', 'nve-')\n  );\n}\n\nexport function createGhostElement(sourceElement: HTMLElement) {\n  const ghost = globalThis.document.createElement('div');\n  const { width } = sourceElement.getBoundingClientRect();\n  ghost.setAttribute('nve-ghost', '');\n  ghost.style.minWidth = `${width}px`;\n  ghost.style.maxWidth = `${width}px`;\n  ghost.style.height = '1px';\n  ghost.slot = sourceElement.slot;\n  return ghost;\n}\n\nexport function sameRenderRoot(element1: HTMLElement, element2: HTMLElement) {\n  const root1 = element1.getRootNode();\n  const root2 = element2.getRootNode();\n  const sameShadowRoot = root1 instanceof ShadowRoot && root2 instanceof ShadowRoot && root1 === root2;\n  const sameDocumentRoot = root1 === globalThis.document && root2 === globalThis.document;\n  const sameUnattachedRoot = root1 === root2;\n  return sameShadowRoot || sameDocumentRoot || sameUnattachedRoot;\n}\n\nexport function getAnchorNames(element: HTMLElement): string[] {\n  return (\n    element.style.anchorName\n      ?.split(',')\n      ?.map(name => name.trim())\n      ?.filter(name => name !== 'none' && name !== '') ?? []\n  );\n}\n\nexport function removeAnchorName(element: HTMLElement, name: string) {\n  const anchorNames = getAnchorNames(element);\n  element.style.anchorName = anchorNames.filter(i => i !== name).join(',');\n}\n\nexport function appendAnchorName(element: HTMLElement, name: string) {\n  element.style.anchorName = Array.from(new Set([...getAnchorNames(element), name])).join(',');\n}\n"],"mappings":"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"}

package/dist/internal/utils/events.d.ts

@@ -0,0 +1,4 @@
+export declare function stopEvent(event: Event): void;
+export declare function onChildListMutation(element: HTMLElement, fn: (mutation?: MutationRecord) => void, options?: MutationObserverInit): MutationObserver;
+export declare function throttle(func: (...args: unknown[]) => void, limit: number): (...args: unknown[]) => void;
+export declare function debounce(func: (...args: unknown[]) => void, timeout?: number): (...args: unknown[]) => void;

package/dist/internal/utils/events.js

@@ -0,0 +1,32 @@
+//#region src/internal/utils/events.ts
+function e(e) {
+	e?.preventDefault(), e?.stopPropagation();
+}
+function t(e, t, n = {}) {
+	let r = new MutationObserver((e) => {
+		for (let r of e) r.type === "childList" && t(r), n.attributes && r.type === "attributes" && t(r);
+	});
+	return r.observe(e, {
+		childList: !0,
+		...n
+	}), r;
+}
+function n(e, t) {
+	let n = !0;
+	return (...r) => {
+		n && (e(...r), n = !1, setTimeout(() => n = !0, t));
+	};
+}
+function r(e, t = 0) {
+	let n;
+	return (...r) => {
+		/* istanbul ignore next */
+		clearTimeout(n), n = setTimeout(() => {
+			e(...r);
+		}, t);
+	};
+}
+//#endregion
+export { r as debounce, t as onChildListMutation, e as stopEvent, n as throttle };
+
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../../src/internal/utils/events.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport function stopEvent(event: Event) {\n  event?.preventDefault();\n  event?.stopPropagation();\n}\n\nexport function onChildListMutation(\n  element: HTMLElement,\n  fn: (mutation?: MutationRecord) => void,\n  options: MutationObserverInit = {}\n) {\n  const observer = new MutationObserver(mutations => {\n    for (const mutation of mutations) {\n      if (mutation.type === 'childList') {\n        fn(mutation);\n      }\n\n      if (options.attributes && mutation.type === 'attributes') {\n        fn(mutation);\n      }\n    }\n  });\n  observer.observe(element, { childList: true, ...options });\n  return observer;\n}\n\nexport function throttle(func: (...args: unknown[]) => void, limit: number) {\n  let wait = true;\n  return (...args: unknown[]) => {\n    if (wait) {\n      func(...args);\n      wait = false;\n      /* istanbul ignore next */\n      setTimeout(() => (wait = true), limit);\n    }\n  };\n}\n\nexport function debounce(func: (...args: unknown[]) => void, timeout = 0) {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return (...args: unknown[]) => {\n    clearTimeout(timer);\n    /* istanbul ignore next */\n    timer = setTimeout(() => {\n      func(...args);\n    }, timeout);\n  };\n}\n"],"mappings":";AAGA,SAAgB,EAAU,GAAc;AAEtC,CADA,GAAO,gBAAgB,EACvB,GAAO,iBAAiB;;AAG1B,SAAgB,EACd,GACA,GACA,IAAgC,EAAE,EAClC;CACA,IAAM,IAAW,IAAI,kBAAiB,MAAa;AACjD,OAAK,IAAM,KAAY,EAKrB,CAJI,EAAS,SAAS,eACpB,EAAG,EAAS,EAGV,EAAQ,cAAc,EAAS,SAAS,gBAC1C,EAAG,EAAS;GAGhB;AAEF,QADA,EAAS,QAAQ,GAAS;EAAE,WAAW;EAAM,GAAG;EAAS,CAAC,EACnD;;AAGT,SAAgB,EAAS,GAAoC,GAAe;CAC1E,IAAI,IAAO;AACX,SAAQ,GAAG,MAAoB;AAC7B,EAAI,MACF,EAAK,GAAG,EAAK,EACb,IAAO,IAEP,iBAAkB,IAAO,IAAO,EAAM;;;AAK5C,SAAgB,EAAS,GAAoC,IAAU,GAAG;CACxE,IAAI;AACJ,SAAQ,GAAG,MAAoB;;AAG7B,EAFA,aAAa,EAAM,EAEnB,IAAQ,iBAAiB;AACvB,KAAK,GAAG,EAAK;KACZ,EAAQ"}

package/dist/internal/utils/focus.d.ts

@@ -0,0 +1,12 @@
+export declare function isFocusable(element: Element): boolean;
+/** returns interactive elements that does not require advanced keyboard interactions like arrow/navigation */
+export declare function isSimpleFocusable(element: Element): boolean;
+export declare function getActiveElement(root?: Document | ShadowRoot): Element | null;
+export declare function focusElement(element: HTMLElement): void;
+export declare function focusElementTimeout(element: HTMLElement): void;
+export declare function setActiveKeyListItem(items: NodeListOf<HTMLElement> | HTMLElement[], item: HTMLElement): void;
+export declare function initializeKeyListItems(items: NodeListOf<HTMLElement> | HTMLElement[]): void;
+/** determines if user interaction is a valid interaction for activating a listbox type */
+export declare function onListboxActivate(element: HTMLElement & {
+    disabled?: boolean;
+}, fn: (event: KeyboardEvent | PointerEvent) => void): void;

package/dist/internal/utils/focus.js

@@ -0,0 +1,60 @@
+//#region src/internal/utils/focus.ts
+function e(e) {
+	return e.matches([
+		"a[href]",
+		"area[href]",
+		"input",
+		"button",
+		"select",
+		"textarea",
+		"iframe",
+		"object",
+		"embed",
+		"*[tabindex]",
+		"*[contenteditable=true]",
+		"[role=button]"
+	].join(",")) && e.matches(":not([disabled], [inert])") && !e.closest("[inert]") && !e.closest("[popover]")?.matches(":not(:popover-open)");
+}
+function t(e) {
+	return e.matches([
+		"a[href]",
+		"button:not([disabled])",
+		"input[type=checkbox]",
+		"input[type=radio]",
+		"object",
+		"embed",
+		"*[tabindex]",
+		"[role=button]:not([disabled])"
+	].join(","));
+}
+function n(e = globalThis.document) {
+	return e.activeElement && e.activeElement.shadowRoot ? n(e.activeElement.shadowRoot) ?? e.activeElement : e.activeElement;
+}
+function r(t) {
+	t && !e(t) ? (t.setAttribute("tabindex", "-1"), t.focus(), t.addEventListener("blur", () => t.removeAttribute("tabindex"), { once: !0 })) : t?.focus();
+}
+function i(e) {
+	setTimeout(() => r(e));
+}
+function a(e, t) {
+	e.forEach((e) => e.tabIndex = -1), t.tabIndex = 0;
+}
+function o(e) {
+	e.forEach((e) => e.tabIndex = -1), e[0] && (e[0].tabIndex = 0);
+}
+function s(e, t) {
+	let n = (e) => e.code === "Space" || e.code === "ArrowUp" || e.code === "ArrowDown";
+	e.addEventListener("pointerdown", (e) => {
+		e.preventDefault();
+	}), e.addEventListener("pointerup", (n) => {
+		n.preventDefault(), e.disabled || t(n);
+	}), e.addEventListener("keyup", (r) => {
+		n(r) && !e.disabled && t(r);
+	}), e.addEventListener("keydown", (t) => {
+		n(t) && !e.disabled && t.preventDefault();
+	});
+}
+//#endregion
+export { r as focusElement, i as focusElementTimeout, n as getActiveElement, o as initializeKeyListItems, e as isFocusable, t as isSimpleFocusable, s as onListboxActivate, a as setActiveKeyListItem };
+
+//# sourceMappingURL=focus.js.map