@nvidia-elements/core 2.0.1 → 2.0.2

package/dist/internal/index.js

@@ -12,32 +12,23 @@ import { KeynavCode as N, appendAnchorName as P, appendRootNodeStyle as F, apply
 import { KeyNavigationGridController as _e, getNextKeyGridItem as ve, keyNavigationGrid as ye } from "./controllers/keynav-grid.controller.js";
 import { KeyNavigationListController as be, getNextKeyListItem as xe, keyNavigationList as Se } from "./controllers/keynav-list.controller.js";
 import { associateAriaDescribedBy as Ce, associateAriaLabel as we, associateControlGroup as Te, associateDataList as Ee, associateLabel as De, attachInternals as Oe } from "./utils/a11y.js";
-import { StateActiveController as ke, stateActive as Ae } from "./controllers/state-active.controller.js";
-import { StateCurrentController as je, stateCurrent as Me } from "./controllers/state-current.controller.js";
-import { StateDisabledController as Ne, stateDisabled as Pe } from "./controllers/state-disabled.controller.js";
-import { StateExpandedController as Fe, stateExpanded as Ie } from "./controllers/state-expanded.controller.js";
-import { StateHighlightedController as Le, stateHighlighted as Re } from "./controllers/state-highlighted.controller.js";
-import { StateScrollController as ze, stateScroll as Be } from "./controllers/state-scroll.controller.js";
-import { StateSelectedController as Ve, stateSelected as He } from "./controllers/state-selected.controller.js";
-import { StatePressedController as Ue, statePressed as We } from "./controllers/state-pressed.controller.js";
-import { TypeAnchorController as Ge, typeAnchor as Ke } from "./controllers/type-anchor.controller.js";
-import { TypeClosableController as qe } from "./controllers/type-closable.controller.js";
-import { TypeCommandController as Je, typeCommand as Ye } from "./controllers/type-command.controller.js";
-import { TypeInterestController as Xe, typeInterest as Ze } from "./controllers/type-interest.controller.js";
-import { TypeExpandableController as Qe } from "./controllers/type-expandable.controller.js";
-import { TypeSelectableController as $e } from "./controllers/type-selectable.controller.js";
-import { TypeButtonController as et, typeButton as tt } from "./controllers/type-button.controller.js";
-import { TypeNativePopoverTriggerController as nt, typeNativePopoverTrigger as rt } from "./controllers/type-native-popover-trigger.controller.js";
-import { TypeNativePopoverController as it } from "./controllers/type-native-popover.controller.js";
-import { TypeSSRController as at, typeSSR as ot } from "./controllers/type-ssr.controller.js";
-import { createLightDismiss as st, onKeys as ct } from "./utils/keynav.js";
-import { TypeSubmitController as lt, typeSubmit as ut } from "./controllers/type-submit.controller.js";
-import { NveTouchEvent as dt, TypeTouchController as ft, typeTouch as pt } from "./controllers/type-touch.controller.js";
-import { hostAttr as mt } from "./decorators/host-attr.js";
-import { scopedRegistry as ht } from "./decorators/scoped-registry.js";
-import { colorStateStyles as gt, statusStateStyles as _t, supportStateStyles as vt, useStyles as yt } from "./styles/index.js";
-import { supportsCSSLegacyInsetArea as bt, supportsCSSPositionArea as xt, supportsNativeCSSAnchorPosition as St } from "./utils/supports.js";
-import { popoverStyles as Ct } from "./styles/popover2.js";
-import { TransitionService as wt } from "./services/transition.service.js";
-import { statusIcons as Tt } from "./types/index.js";
-export { p as AuditController, e as DOCS_URL, l as GlobalState, u as GlobalStateService, v as I18nController, g as I18nService, _ as I18nService_, _e as KeyNavigationGridController, be as KeyNavigationListController, N as KeynavCode, w as LogService, dt as NveTouchEvent, ke as StateActiveController, je as StateCurrentController, Ne as StateDisabledController, Fe as StateExpandedController, Le as StateHighlightedController, Ue as StatePressedController, ze as StateScrollController, Ve as StateSelectedController, wt as TransitionService, Ge as TypeAnchorController, et as TypeButtonController, qe as TypeClosableController, Je as TypeCommandController, Qe as TypeExpandableController, Xe as TypeInterestController, it as TypeNativePopoverController, nt as TypeNativePopoverTriggerController, at as TypeSSRController, $e as TypeSelectableController, lt as TypeSubmitController, ft as TypeTouchController, P as appendAnchorName, F as appendRootNodeStyle, I as applySlotContentStates, Ce as associateAriaDescribedBy, we as associateAriaLabel, Te as associateControlGroup, Ee as associateDataList, De as associateLabel, Oe as attachInternals, m as audit, d as auditParentElement, f as auditSlots, L as clickOutsideElementBounds, gt as colorStateStyles, R as createGhostElement, st as createLightDismiss, b as debounce, r as deepMerge, z as define, B as defineElement, V as endOfScrollBox, h as excessiveInstanceLimit, T as focusElement, E as focusElementTimeout, t as formatFileSize, i as formatStandardNumber, H as generateId, D as getActiveElement, U as getAnchorNames, W as getAttributeChanges, G as getAttributeListChanges, K as getChildren, a as getDifference, q as getDisplayValue, J as getElementUpdate, Y as getFlattenedDOMTree, X as getFlattenedFocusableItems, ve as getNextKeyGridItem, xe as getNextKeyListItem, Z as getPropertyChanges, Q as getThemeTokens, $ as hasHorizontalScrollBar, ee as hasInvalidDOMGrid, te as hasScrollBar, mt as hostAttr, y as i18n, O as initializeKeyListItems, ne as isContextMenuClick, k as isFocusable, o as isObject, s as isObjectLiteral, A as isSimpleFocusable, ye as keyNavigationGrid, Se as keyNavigationList, re as matchesElementName, x as onChildListMutation, ct as onKeys, j as onListboxActivate, ie as openEyeDropper, ae as parseTokenNumber, c as parseVersion, Ct as popoverStyles, oe as removeAnchorName, se as removeEmptySlotWhitespace, ce as removeEmptyTextNode, le as sameOrderedStringArray, ue as sameRenderRoot, ht as scopedRegistry, de as scrollBarWidth, M as setActiveKeyListItem, n as shiftLeft, fe as slotContainsOnlyWhitespace, Ae as stateActive, Me as stateCurrent, Pe as stateDisabled, Ie as stateExpanded, Re as stateHighlighted, We as statePressed, Be as stateScroll, He as stateSelected, Tt as statusIcons, _t as statusStateStyles, S as stopEvent, pe as styleSheetToString, vt as supportStateStyles, bt as supportsCSSLegacyInsetArea, xt as supportsCSSPositionArea, St as supportsNativeCSSAnchorPosition, me as supportsScopedRegistry, C as throttle, Ke as typeAnchor, tt as typeButton, Ye as typeCommand, Ze as typeInterest, rt as typeNativePopoverTrigger, ot as typeSSR, ut as typeSubmit, pt as typeTouch, he as uniqueNonEmptyStrings, yt as useStyles, ge as validKeyNavigationCode };
+import { StateExpandedController as ke, stateExpanded as Ae } from "./controllers/state-expanded.controller.js";
+import { StateHighlightedController as je, stateHighlighted as Me } from "./controllers/state-highlighted.controller.js";
+import { StateScrollController as Ne, stateScroll as Pe } from "./controllers/state-scroll.controller.js";
+import { StateSelectedController as Fe, stateSelected as Ie } from "./controllers/state-selected.controller.js";
+import { TypeAnchorController as Le, typeAnchor as Re } from "./controllers/type-anchor.controller.js";
+import { TypeClosableController as ze } from "./controllers/type-closable.controller.js";
+import { TypeExpandableController as Be } from "./controllers/type-expandable.controller.js";
+import { TypeSelectableController as Ve } from "./controllers/type-selectable.controller.js";
+import { TypeNativePopoverController as He } from "./controllers/type-native-popover.controller.js";
+import { TypeSSRController as Ue, typeSSR as We } from "./controllers/type-ssr.controller.js";
+import { NveTouchEvent as Ge, TypeTouchController as Ke, typeTouch as qe } from "./controllers/type-touch.controller.js";
+import { hostAttr as Je } from "./decorators/host-attr.js";
+import { scopedRegistry as Ye } from "./decorators/scoped-registry.js";
+import { colorStateStyles as Xe, statusStateStyles as Ze, supportStateStyles as Qe, useStyles as $e } from "./styles/index.js";
+import { supportsCSSLegacyInsetArea as et, supportsCSSPositionArea as tt, supportsNativeCSSAnchorPosition as nt } from "./utils/supports.js";
+import { popoverStyles as rt } from "./styles/popover2.js";
+import { TransitionService as it } from "./services/transition.service.js";
+import { statusIcons as at } from "./types/index.js";
+import { createLightDismiss as ot, onKeys as st } from "./utils/keynav.js";
+export { p as AuditController, e as DOCS_URL, l as GlobalState, u as GlobalStateService, v as I18nController, g as I18nService, _ as I18nService_, _e as KeyNavigationGridController, be as KeyNavigationListController, N as KeynavCode, w as LogService, Ge as NveTouchEvent, ke as StateExpandedController, je as StateHighlightedController, Ne as StateScrollController, Fe as StateSelectedController, it as TransitionService, Le as TypeAnchorController, ze as TypeClosableController, Be as TypeExpandableController, He as TypeNativePopoverController, Ue as TypeSSRController, Ve as TypeSelectableController, Ke as TypeTouchController, P as appendAnchorName, F as appendRootNodeStyle, I as applySlotContentStates, Ce as associateAriaDescribedBy, we as associateAriaLabel, Te as associateControlGroup, Ee as associateDataList, De as associateLabel, Oe as attachInternals, m as audit, d as auditParentElement, f as auditSlots, L as clickOutsideElementBounds, Xe as colorStateStyles, R as createGhostElement, ot as createLightDismiss, b as debounce, r as deepMerge, z as define, B as defineElement, V as endOfScrollBox, h as excessiveInstanceLimit, T as focusElement, E as focusElementTimeout, t as formatFileSize, i as formatStandardNumber, H as generateId, D as getActiveElement, U as getAnchorNames, W as getAttributeChanges, G as getAttributeListChanges, K as getChildren, a as getDifference, q as getDisplayValue, J as getElementUpdate, Y as getFlattenedDOMTree, X as getFlattenedFocusableItems, ve as getNextKeyGridItem, xe as getNextKeyListItem, Z as getPropertyChanges, Q as getThemeTokens, $ as hasHorizontalScrollBar, ee as hasInvalidDOMGrid, te as hasScrollBar, Je as hostAttr, y as i18n, O as initializeKeyListItems, ne as isContextMenuClick, k as isFocusable, o as isObject, s as isObjectLiteral, A as isSimpleFocusable, ye as keyNavigationGrid, Se as keyNavigationList, re as matchesElementName, x as onChildListMutation, st as onKeys, j as onListboxActivate, ie as openEyeDropper, ae as parseTokenNumber, c as parseVersion, rt as popoverStyles, oe as removeAnchorName, se as removeEmptySlotWhitespace, ce as removeEmptyTextNode, le as sameOrderedStringArray, ue as sameRenderRoot, Ye as scopedRegistry, de as scrollBarWidth, M as setActiveKeyListItem, n as shiftLeft, fe as slotContainsOnlyWhitespace, Ae as stateExpanded, Me as stateHighlighted, Pe as stateScroll, Ie as stateSelected, at as statusIcons, Ze as statusStateStyles, S as stopEvent, pe as styleSheetToString, Qe as supportStateStyles, et as supportsCSSLegacyInsetArea, tt as supportsCSSPositionArea, nt as supportsNativeCSSAnchorPosition, me as supportsScopedRegistry, C as throttle, Re as typeAnchor, We as typeSSR, qe as typeTouch, he as uniqueNonEmptyStrings, $e as useStyles, ge as validKeyNavigationCode };

package/dist/internal/services/global.service.js

@@ -19,7 +19,7 @@ var a = class {
 				i18nRegistry: {},
 				audit: {}
 			}
-		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.0.1"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.0.1"] = i(), globalThis.NVE_ELEMENTS.state.versions.length > 1 && globalThis.NVE_ELEMENTS.state.env !== "production" && console.warn(e(), `\n\n${JSON.stringify(globalThis.NVE_ELEMENTS.state.versions, null, 2)}`);
+		}, globalThis.NVE_ELEMENTS.state.versions = Array.from(new Set([...globalThis.NVE_ELEMENTS.state.versions, "2.0.2"])), globalThis.NVE_ELEMENTS.state.scopedRegistry ??= {}, globalThis.NVE_ELEMENTS.state.scopedRegistry["2.0.2"] = i(), globalThis.NVE_ELEMENTS.state.versions.length > 1 && globalThis.NVE_ELEMENTS.state.env !== "production" && console.warn(e(), `\n\n${JSON.stringify(globalThis.NVE_ELEMENTS.state.versions, null, 2)}`);
 	}
 	get state() {
 		return globalThis.NVE_ELEMENTS.state;

package/dist/internal/services/log.service.js

@@ -11,7 +11,7 @@ var t = "@nve: ", n = class {
 		e.state.env !== "production" && (console.error(`${t}${n}`, ...r), this.#e("error", n, ...r));
 	}
 	static #e(e, t, ...n) {
-		globalThis.document.dispatchEvent(new CustomEvent("NVE_ELEMENTS_LOG", { detail: {
+		globalThis.document?.dispatchEvent(new CustomEvent("NVE_ELEMENTS_LOG", { detail: {
 			type: e,
 			value: t,
 			args: n

package/dist/internal/services/log.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.service.js","names":["#dispatch"],"sources":["../../../src/internal/services/log.service.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from './global.service.js';\n\nconst prefix = '@nve: ';\n\nexport class LogService {\n  static log(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.log(`${prefix}${value}`, ...args);\n    }\n  }\n\n  static warn(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.warn(`${prefix}${value}`, ...args);\n      this.#dispatch('warn', value, ...args);\n    }\n  }\n\n  static error(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.error(`${prefix}${value}`, ...args);\n      this.#dispatch('error', value, ...args);\n    }\n  }\n\n  static #dispatch(type: 'warn' | 'error', value: string, ...args: unknown[]) {\n    globalThis.document.dispatchEvent(new CustomEvent('NVE_ELEMENTS_LOG', { detail: { type, value, args } }));\n  }\n}\n"],"mappings":";;AAKA,IAAM,IAAS,UAEF,IAAb,MAAwB;CACtB,OAAO,IAAI,GAAe,GAAG,GAAiB;EAC5C,AAAI,EAAmB,MAAM,QAAQ,gBACnC,QAAQ,IAAI,GAAG,IAAS,KAAS,GAAG,CAAI;CAE5C;CAEA,OAAO,KAAK,GAAe,GAAG,GAAiB;EAC7C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,KAAK,GAAG,IAAS,KAAS,GAAG,CAAI,GACzC,KAAKA,GAAU,QAAQ,GAAO,GAAG,CAAI;CAEzC;CAEA,OAAO,MAAM,GAAe,GAAG,GAAiB;EAC9C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,MAAM,GAAG,IAAS,KAAS,GAAG,CAAI,GAC1C,KAAKA,GAAU,SAAS,GAAO,GAAG,CAAI;CAE1C;CAEA,OAAOA,GAAU,GAAwB,GAAe,GAAG,GAAiB;EAC1E,WAAW,SAAS,cAAc,IAAI,YAAY,oBAAoB,EAAE,QAAQ;GAAE;GAAM;GAAO;EAAK,EAAE,CAAC,CAAC;CAC1G;AACF"}
+{"version":3,"file":"log.service.js","names":["#dispatch"],"sources":["../../../src/internal/services/log.service.ts"],"sourcesContent":["// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { GlobalStateService } from './global.service.js';\n\nconst prefix = '@nve: ';\n\nexport class LogService {\n  static log(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.log(`${prefix}${value}`, ...args);\n    }\n  }\n\n  static warn(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.warn(`${prefix}${value}`, ...args);\n      this.#dispatch('warn', value, ...args);\n    }\n  }\n\n  static error(value: string, ...args: unknown[]) {\n    if (GlobalStateService.state.env !== 'production') {\n      console.error(`${prefix}${value}`, ...args);\n      this.#dispatch('error', value, ...args);\n    }\n  }\n\n  static #dispatch(type: 'warn' | 'error', value: string, ...args: unknown[]) {\n    globalThis.document?.dispatchEvent(new CustomEvent('NVE_ELEMENTS_LOG', { detail: { type, value, args } }));\n  }\n}\n"],"mappings":";;AAKA,IAAM,IAAS,UAEF,IAAb,MAAwB;CACtB,OAAO,IAAI,GAAe,GAAG,GAAiB;EAC5C,AAAI,EAAmB,MAAM,QAAQ,gBACnC,QAAQ,IAAI,GAAG,IAAS,KAAS,GAAG,CAAI;CAE5C;CAEA,OAAO,KAAK,GAAe,GAAG,GAAiB;EAC7C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,KAAK,GAAG,IAAS,KAAS,GAAG,CAAI,GACzC,KAAKA,GAAU,QAAQ,GAAO,GAAG,CAAI;CAEzC;CAEA,OAAO,MAAM,GAAe,GAAG,GAAiB;EAC9C,AAAI,EAAmB,MAAM,QAAQ,iBACnC,QAAQ,MAAM,GAAG,IAAS,KAAS,GAAG,CAAI,GAC1C,KAAKA,GAAU,SAAS,GAAO,GAAG,CAAI;CAE1C;CAEA,OAAOA,GAAU,GAAwB,GAAe,GAAG,GAAiB;EAC1E,WAAW,UAAU,cAAc,IAAI,YAAY,oBAAoB,EAAE,QAAQ;GAAE;GAAM;GAAO;EAAK,EAAE,CAAC,CAAC;CAC3G;AACF"}

package/dist/internal/types/index.d.ts

@@ -66,6 +66,9 @@ export type TaskStatus = 'scheduled' | 'queued' | 'pending' | 'starting' | 'runn
  * - `hint` no light dismiss, no auto focus, open/close on hover/focus
  */
 export type PopoverType = 'auto' | 'manual' | 'hint' | 'inline';
+export type InterestEvent = Event & {
+    source: HTMLElement;
+};
 /** Controls how the popover aligns along the edge of its anchor element.
  * - `start` - Aligns the popover to the beginning edge of the anchor for left or top alignment.
  * - `end` - Aligns the popover to the ending edge of the anchor for right or bottom alignment.

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

@@ -1 +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/** 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  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  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":";AA4YA,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,SAAS;AACX"}
+{"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\nexport type InterestEvent = Event & {\n  source: HTMLElement;\n};\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/** 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  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  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":";AAgZA,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,SAAS;AACX"}

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

@@ -11,7 +11,7 @@ export declare function getAttributeListChanges(element: HTMLElement, attrs: str
 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 getPropertyChanges(element: HTMLElement, key: string, callback: (value: unknown) => void): (() => void) | undefined;
 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 */

package/dist/internal/utils/dom.js

@@ -1,7 +1,8 @@
 import { GlobalStateService as e } from "../services/global.service.js";
-import { isFocusable as t } from "./focus.js";
+import { LogService as t } from "../services/log.service.js";
+import { isFocusable as n } from "./focus.js";
 //#region src/internal/utils/dom.ts
-function n(e) {
+function r(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) {
@@ -9,10 +10,10 @@ function n(e) {
 		return t.length ? t : Array.from(e.children);
 	} else return Array.from(e.children);
 }
-function r() {
+function i() {
 	return `_${self.crypto.getRandomValues(new Uint32Array(1))[0].toString(16)}`;
 }
-function i(e, t, n) {
+function a(e, t, n) {
 	n(e.getAttribute(t));
 	let r = new MutationObserver((e) => {
 		e.forEach((e) => {
@@ -24,7 +25,7 @@ function i(e, t, n) {
 		subtree: !0
 	}), r;
 }
-function a(e, t, n) {
+function o(e, t, n) {
 	let r = new MutationObserver((e) => {
 		e.forEach((e) => {
 			e.attributeName && t.includes(e.attributeName) && n(e);
@@ -35,87 +36,103 @@ function a(e, t, n) {
 		subtree: !0
 	}), r;
 }
-function o(e, t) {
+function s(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;
+	return r.adoptedStyleSheets && (r.adoptedStyleSheets.map((e) => c(e)).find((e) => e === c(n)) || (r.adoptedStyleSheets = [...Array.from(r.adoptedStyleSheets), n])), n;
 }
-function s(e) {
+function c(e) {
 	return e.cssRules ? Array.from(e.cssRules).map((e) => e.cssText || "").join("\n") : "";
 }
-function c(e, t, n) {
+function l(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, {
+	if (!(i && i.configurable === !1)) return Object.defineProperty(e, t, {
 		configurable: !0,
 		get: r.get,
 		set: (t) => {
 			r.set.call(e, t), n(t);
 		}
-	});
+	}), () => {
+		if (i) {
+			Object.defineProperty(e, t, i);
+			return;
+		}
+		Reflect.deleteProperty(e, 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, n) {
+	e.hasAttribute(t) ? n(e.getAttribute(t)) : e[t] !== void 0 && n(e[t]);
+	let r = l(e, t, n), i = a(e, t, (e) => n(e)), o = i.disconnect.bind(i);
+	return i.disconnect = () => {
+		r?.(), o();
+	}, i;
 }
-function u(e, t) {
+function d(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) {
+function f(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) {
+var p = globalThis.CustomElementRegistry && "initialize" in CustomElementRegistry.prototype;
+function m(t, n) {
 	Object.entries(t.elementDefinitions ?? {}).filter(([e, t]) => !n.get(t.metadata.tag)).forEach(([e, t]) => {
-		p(t, n);
+		m(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) {
+function h(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)));
+	p && !customElements.get(t.metadata.tag) ? (customElements.define(t.metadata.tag, t), e.dispatch("NVE_ELEMENT_DEFINE", { elementRegistry: { [t.metadata.tag]: t.metadata.version } })) : m(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) {
+function g(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);
+	return v(e, t).filter((e) => n(e));
+}
+function v(e, t = 10) {
+	return Array.from(r(e)).reduce((e, n) => [...e, [n, [...Array.from(r(n)).map((e) => [e, v(e, t)])]]], []).flat(t);
 }
-function v(e) {
-	return b.has(e.code);
+function y(e) {
+	return x.has(e.code);
 }
-var y = /* @__PURE__ */ function(e) {
+var b = /* @__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) {
+}({}), x = new Set(Object.values(b));
+function S(e) {
 	return e.some((t) => t.children.length !== e[0].children.length);
 }
-function S(e) {
+function C(e) {
 	e?.wholeText?.trim() === "" && e.remove();
 }
-function C() {
+function w() {
 	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) {
+function T(e) {
 	return e.scrollHeight > e.clientHeight;
 }
-function T(e) {
+function E(e) {
 	return e.scrollWidth > e.clientWidth;
 }
-function E(e, t = 0) {
+function D(e, t = 0) {
 	return e.scrollTop + e.offsetHeight + t >= e.scrollHeight;
 }
-async function D() {
-	return await new globalThis.EyeDropper().open().then((e) => e.sRGBHex);
+async function O() {
+	let e = globalThis.EyeDropper;
+	if (!e) return t.warn("EyeDropper API is unavailable"), "";
+	try {
+		return (await new e().open()).sRGBHex;
+	} catch (e) {
+		return t.warn(`EyeDropper selection failed: ${e.message}`), "";
+	}
 }
-function O(e = globalThis.document.querySelector(":root")) {
+function k(e = globalThis.document.querySelector(":root")) {
 	let t = getComputedStyle(e), n = [];
 	try {
 		n = Array.from(globalThis.parent.document.styleSheets);
@@ -134,48 +151,48 @@ function O(e = globalThis.document.querySelector(":root")) {
 		[n[0]]: t.getPropertyValue(n[0])
 	}), {});
 }
-function k(e) {
-	A(e) && e.assignedNodes().forEach((e) => e.parentNode?.removeChild(e));
-}
 function A(e) {
+	j(e) && e.assignedNodes().forEach((e) => e.parentNode?.removeChild(e));
+}
+function j(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) {
+function M(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) {
+function N(e) {
 	return e?.label || e?.value || "";
 }
-function N(e, t) {
+function P(e, t) {
 	return e.localName === t.metadata.tag;
 }
-function P(e) {
+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 F(e, 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 I(e) {
+function L(e) {
 	return e.style.anchorName?.split(",")?.map((e) => e.trim())?.filter((e) => e !== "none" && e !== "") ?? [];
 }
-function L(e, t) {
-	let n = I(e);
-	e.style.anchorName = n.filter((e) => e !== t).join(",");
-}
 function R(e, t) {
-	e.style.anchorName = Array.from(new Set([...I(e), t])).join(",");
+	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(",");
+}
+function B(e, t) {
 	return e.length === t.length && e.every((e, n) => e === t[n]);
 }
-function B(e) {
+function V(e) {
 	return Array.from(new Set(Array.from(e).filter((e) => typeof e == "string" && e.length > 0)));
 }
 //#endregion
-export { y as KeynavCode, R as appendAnchorName, o as appendRootNodeStyle, j as applySlotContentStates, u as clickOutsideElementBounds, P as createGhostElement, m as define, p as defineElement, E as endOfScrollBox, r as generateId, I 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, N as matchesElementName, D as openEyeDropper, d as parseTokenNumber, L as removeAnchorName, k as removeEmptySlotWhitespace, S as removeEmptyTextNode, z as sameOrderedStringArray, F as sameRenderRoot, C as scrollBarWidth, A as slotContainsOnlyWhitespace, s as styleSheetToString, f as supportsScopedRegistry, B as uniqueNonEmptyStrings, v as validKeyNavigationCode };
+export { b as KeynavCode, z as appendAnchorName, s as appendRootNodeStyle, M as applySlotContentStates, d as clickOutsideElementBounds, F as createGhostElement, h as define, m as defineElement, D as endOfScrollBox, i as generateId, L as getAnchorNames, a as getAttributeChanges, o as getAttributeListChanges, r as getChildren, N as getDisplayValue, u as getElementUpdate, v as getFlattenedDOMTree, _ as getFlattenedFocusableItems, l as getPropertyChanges, k as getThemeTokens, E as hasHorizontalScrollBar, S as hasInvalidDOMGrid, T as hasScrollBar, g as isContextMenuClick, P as matchesElementName, O as openEyeDropper, f as parseTokenNumber, R as removeAnchorName, A as removeEmptySlotWhitespace, C as removeEmptyTextNode, B as sameOrderedStringArray, I as sameRenderRoot, w as scrollBarWidth, j as slotContainsOnlyWhitespace, c as styleSheetToString, p as supportsScopedRegistry, V as uniqueNonEmptyStrings, y as validKeyNavigationCode };
 
 //# sourceMappingURL=dom.js.map

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

@@ -1 +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/** determines if HTML element matches the given component tag */\nexport function matchesElementName(element: Partial<HTMLElement>, component: { metadata: { tag: string } }) {\n  return element.localName === component.metadata.tag;\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\n/**\n * Returns true when both arrays have the same length and each index is strictly equal (`===`).\n */\nexport function sameOrderedStringArray(a: readonly string[], b: readonly string[]): boolean {\n  return a.length === b.length && a.every((value, index) => value === b[index]);\n}\n\n/**\n * Returns unique non-empty strings in first-seen order (insertion order of a `Set` over the filtered list).\n */\nexport function uniqueNonEmptyStrings(values: Iterable<string | null | undefined>): string[] {\n  return Array.from(\n    new Set(Array.from(values).filter((value): value is string => typeof value === 'string' && value.length > 0))\n  );\n}\n"],"mappings":"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"}
+{"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 { LogService } from '../services/log.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  return () => {\n    if (own) {\n      Object.defineProperty(element, key, own);\n      return;\n    }\n\n    Reflect.deleteProperty(element, key);\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  const cleanupPropertyChanges = getPropertyChanges(element, key, callback);\n  const observer = getAttributeChanges(element, key, val => callback(val));\n  const disconnect = observer.disconnect.bind(observer);\n\n  observer.disconnect = () => {\n    cleanupPropertyChanges?.();\n    disconnect();\n  };\n\n  return observer;\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  const EyeDropperConstructor = (\n    globalThis as unknown as { EyeDropper?: new () => { open: () => Promise<{ sRGBHex: string }> } }\n  ).EyeDropper;\n\n  if (!EyeDropperConstructor) {\n    LogService.warn('EyeDropper API is unavailable');\n    return '';\n  }\n\n  try {\n    return (await new EyeDropperConstructor().open()).sRGBHex;\n  } catch (e) {\n    LogService.warn(`EyeDropper selection failed: ${(e as Error).message}`);\n    return '';\n  }\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/** determines if HTML element matches the given component tag */\nexport function matchesElementName(element: Partial<HTMLElement>, component: { metadata: { tag: string } }) {\n  return element.localName === component.metadata.tag;\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\n/**\n * Returns true when both arrays have the same length and each index is strictly equal (`===`).\n */\nexport function sameOrderedStringArray(a: readonly string[], b: readonly string[]): boolean {\n  return a.length === b.length && a.every((value, index) => value === b[index]);\n}\n\n/**\n * Returns unique non-empty strings in first-seen order (insertion order of a `Set` over the filtered list).\n */\nexport function uniqueNonEmptyStrings(values: Iterable<string | null | undefined>): string[] {\n  return Array.from(\n    new Set(Array.from(values).filter((value): value is string => typeof value === 'string' && value.length > 0))\n  );\n}\n"],"mappings":"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"}