@nvidia-elements/core 2.8.1 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/dist/accordion/accordion2.js +4 -4
  3. package/dist/alert/alert-group2.js +1 -1
  4. package/dist/alert/alert2.js +1 -1
  5. package/dist/avatar/avatar-group2.js +1 -1
  6. package/dist/avatar/avatar2.js +1 -1
  7. package/dist/badge/badge2.js +1 -1
  8. package/dist/breadcrumb/breadcrumb2.js +1 -1
  9. package/dist/bundle.d.ts +2 -0
  10. package/dist/bundles/index.d.ts +205 -0
  11. package/dist/bundles/index.js +6 -6
  12. package/dist/button/button2.js +1 -1
  13. package/dist/button-group/button-group2.js +1 -1
  14. package/dist/card/card2.js +4 -4
  15. package/dist/chat-message/chat-message2.js +1 -1
  16. package/dist/checkbox/checkbox-group2.js +1 -1
  17. package/dist/checkbox/checkbox2.js +1 -1
  18. package/dist/color/color2.js +1 -1
  19. package/dist/combobox/combobox2.js +1 -1
  20. package/dist/copy-button/copy-button2.js +1 -1
  21. package/dist/custom-elements-jsx.d.ts +109 -0
  22. package/dist/custom-elements-vue.d.ts +107 -0
  23. package/dist/custom-elements.json +3321 -66
  24. package/dist/data.html.json +94 -0
  25. package/dist/data.snippets.json +45 -45
  26. package/dist/date/date2.js +1 -1
  27. package/dist/datetime/datetime2.js +1 -1
  28. package/dist/dialog/dialog-footer2.js +1 -1
  29. package/dist/dialog/dialog-header2.js +1 -1
  30. package/dist/dialog/dialog2.js +1 -1
  31. package/dist/divider/divider2.js +1 -1
  32. package/dist/dot/dot2.js +1 -1
  33. package/dist/drawer/drawer-content2.js +1 -1
  34. package/dist/drawer/drawer-footer2.js +1 -1
  35. package/dist/drawer/drawer-header2.js +1 -1
  36. package/dist/drawer/drawer2.js +1 -1
  37. package/dist/dropdown/dropdown-footer2.js +1 -1
  38. package/dist/dropdown/dropdown-header2.js +1 -1
  39. package/dist/dropdown/dropdown2.js +1 -1
  40. package/dist/dropdown-group/dropdown-group.js +1 -1
  41. package/dist/dropzone/dropzone2.js +1 -1
  42. package/dist/file/file2.js +1 -1
  43. package/dist/format-bytes/format-bytes2.js +1 -1
  44. package/dist/format-datetime/format-datetime2.js +1 -1
  45. package/dist/format-number/format-number2.js +1 -1
  46. package/dist/format-relative-time/format-relative-time2.js +1 -1
  47. package/dist/format-truncate/format-truncate2.js +1 -1
  48. package/dist/forms/control/control2.js +1 -1
  49. package/dist/forms/control-group/control-group2.js +1 -1
  50. package/dist/forms/control-message/control-message2.js +1 -1
  51. package/dist/gauge/gauge2.js +1 -1
  52. package/dist/grid/cell/cell2.js +1 -1
  53. package/dist/grid/column/column2.js +1 -1
  54. package/dist/grid/footer/footer2.js +1 -1
  55. package/dist/grid/grid2.js +1 -1
  56. package/dist/grid/header/header2.js +1 -1
  57. package/dist/grid/placeholder/placeholder2.js +1 -1
  58. package/dist/grid/row/row2.js +1 -1
  59. package/dist/icon/icon2.js +2 -2
  60. package/dist/icon-button/icon-button2.js +1 -1
  61. package/dist/index.js +1 -1
  62. package/dist/input/input-group2.js +1 -1
  63. package/dist/input/input2.js +1 -1
  64. package/dist/internal/controllers/gesture.controller.d.ts +122 -42
  65. package/dist/internal/controllers/gesture.controller.examples.js.map +1 -1
  66. package/dist/internal/controllers/gesture.controller.examples.json +2 -2
  67. package/dist/internal/controllers/gesture.controller.js +300 -159
  68. package/dist/internal/controllers/gesture.controller.js.map +1 -1
  69. package/dist/internal/controllers/key-state.controller.d.ts +18 -0
  70. package/dist/internal/controllers/key-state.controller.js +84 -0
  71. package/dist/internal/controllers/key-state.controller.js.map +1 -0
  72. package/dist/internal/controllers/keynav-spatial.controller.d.ts +4 -1
  73. package/dist/internal/controllers/keynav-spatial.controller.js +7 -6
  74. package/dist/internal/controllers/keynav-spatial.controller.js.map +1 -1
  75. package/dist/internal/index.d.ts +2 -0
  76. package/dist/internal/index.js +29 -27
  77. package/dist/internal/services/global.service.js +1 -1
  78. package/dist/internal/utils/dom.d.ts +1 -0
  79. package/dist/internal/utils/dom.js +42 -38
  80. package/dist/internal/utils/dom.js.map +1 -1
  81. package/dist/internal/utils/focus.d.ts +2 -0
  82. package/dist/internal/utils/focus.js +14 -7
  83. package/dist/internal/utils/focus.js.map +1 -1
  84. package/dist/internal/utils/numeric.d.ts +3 -0
  85. package/dist/internal/utils/numeric.js +14 -0
  86. package/dist/internal/utils/numeric.js.map +1 -0
  87. package/dist/logo/logo2.js +1 -1
  88. package/dist/menu/menu-item2.js +1 -1
  89. package/dist/menu/menu2.js +1 -1
  90. package/dist/month/month2.js +1 -1
  91. package/dist/notification/notification-group2.js +1 -1
  92. package/dist/notification/notification2.js +1 -1
  93. package/dist/page/page-panel/page-panel-content2.js +1 -1
  94. package/dist/page/page-panel/page-panel-footer2.js +1 -1
  95. package/dist/page/page-panel/page-panel-header2.js +1 -1
  96. package/dist/page/page-panel/page-panel2.js +1 -1
  97. package/dist/page/page2.js +1 -1
  98. package/dist/page-header/page-header2.js +1 -1
  99. package/dist/page-loader/page-loader2.js +1 -1
  100. package/dist/pagination/pagination2.js +1 -1
  101. package/dist/panel/panel2.js +4 -4
  102. package/dist/password/password2.js +1 -1
  103. package/dist/preferences-input/preferences-input2.js +1 -1
  104. package/dist/progress-bar/progress-bar2.js +1 -1
  105. package/dist/progress-ring/progress-ring2.js +1 -1
  106. package/dist/progressive-filter-chip/progressive-filter-chip2.js +1 -1
  107. package/dist/pulse/pulse2.js +1 -1
  108. package/dist/radio/radio-group2.js +1 -1
  109. package/dist/radio/radio2.js +1 -1
  110. package/dist/range/range2.js +1 -1
  111. package/dist/resize-handle/resize-handle2.js +6 -10
  112. package/dist/resize-handle/resize-handle2.js.map +1 -1
  113. package/dist/search/search2.js +1 -1
  114. package/dist/select/select2.js +1 -1
  115. package/dist/skeleton/skeleton2.js +1 -1
  116. package/dist/sort-button/sort-button2.js +1 -1
  117. package/dist/sparkline/sparkline2.js +1 -1
  118. package/dist/star-rating/star-rating2.js +1 -1
  119. package/dist/steps/steps2.js +2 -2
  120. package/dist/switch/switch-group2.js +1 -1
  121. package/dist/switch/switch2.js +1 -1
  122. package/dist/tabs/tabs-group2.js +1 -1
  123. package/dist/tabs/tabs2.js +2 -2
  124. package/dist/tag/tag2.js +1 -1
  125. package/dist/textarea/textarea2.js +1 -1
  126. package/dist/time/time2.js +1 -1
  127. package/dist/toast/toast2.js +1 -1
  128. package/dist/toggletip/toggletip-footer2.js +1 -1
  129. package/dist/toggletip/toggletip-header2.js +1 -1
  130. package/dist/toggletip/toggletip2.js +1 -1
  131. package/dist/toolbar/toolbar2.js +1 -1
  132. package/dist/tooltip/tooltip2.js +1 -1
  133. package/dist/tree/tree-node2.js +1 -1
  134. package/dist/tree/tree2.js +1 -1
  135. package/dist/viewport/define.d.ts +7 -0
  136. package/dist/viewport/define.js +7 -0
  137. package/dist/viewport/define.js.map +1 -0
  138. package/dist/viewport/index.d.ts +3 -0
  139. package/dist/viewport/index.js +3 -0
  140. package/dist/viewport/viewport-animation.controller.d.ts +21 -0
  141. package/dist/viewport/viewport-animation.controller.js +93 -0
  142. package/dist/viewport/viewport-animation.controller.js.map +1 -0
  143. package/dist/viewport/viewport-autofit.controller.d.ts +18 -0
  144. package/dist/viewport/viewport-autofit.controller.js +105 -0
  145. package/dist/viewport/viewport-autofit.controller.js.map +1 -0
  146. package/dist/viewport/viewport-fitting.utils.d.ts +36 -0
  147. package/dist/viewport/viewport-fitting.utils.js +35 -0
  148. package/dist/viewport/viewport-fitting.utils.js.map +1 -0
  149. package/dist/viewport/viewport-gesture-navigation.controller.d.ts +29 -0
  150. package/dist/viewport/viewport-gesture-navigation.controller.js +311 -0
  151. package/dist/viewport/viewport-gesture-navigation.controller.js.map +1 -0
  152. package/dist/viewport/viewport-gridlines.d.ts +38 -0
  153. package/dist/viewport/viewport-gridlines.js +6 -0
  154. package/dist/viewport/viewport-gridlines.js.map +1 -0
  155. package/dist/viewport/viewport-gridlines.utils.d.ts +11 -0
  156. package/dist/viewport/viewport-gridlines.utils.js +54 -0
  157. package/dist/viewport/viewport-gridlines.utils.js.map +1 -0
  158. package/dist/viewport/viewport-gridlines2.js +154 -0
  159. package/dist/viewport/viewport-gridlines2.js.map +1 -0
  160. package/dist/viewport/viewport-navigation.controller.d.ts +27 -0
  161. package/dist/viewport/viewport-navigation.controller.js +142 -0
  162. package/dist/viewport/viewport-navigation.controller.js.map +1 -0
  163. package/dist/viewport/viewport-navigation.types.d.ts +9 -0
  164. package/dist/viewport/viewport-projection.utils.d.ts +7 -0
  165. package/dist/viewport/viewport-projection.utils.js +25 -0
  166. package/dist/viewport/viewport-projection.utils.js.map +1 -0
  167. package/dist/viewport/viewport.d.ts +92 -0
  168. package/dist/viewport/viewport.examples.js +6 -0
  169. package/dist/viewport/viewport.examples.js.map +1 -0
  170. package/dist/viewport/viewport.examples.json +60 -0
  171. package/dist/viewport/viewport.js +6 -0
  172. package/dist/viewport/viewport.js.map +1 -0
  173. package/dist/viewport/viewport.types.d.ts +66 -0
  174. package/dist/viewport/viewport2.js +375 -0
  175. package/dist/viewport/viewport2.js.map +1 -0
  176. package/dist/week/week2.js +1 -1
  177. package/package.json +13 -1
@@ -12,7 +12,7 @@ var s = class extends o(r) {
12
12
  static {
13
13
  this.metadata = {
14
14
  tag: "nve-button",
15
- version: "2.8.1"
15
+ version: "2.9.0"
16
16
  };
17
17
  }
18
18
  render() {
@@ -26,7 +26,7 @@ var f = class extends c {
26
26
  static {
27
27
  this.metadata = {
28
28
  tag: "nve-button-group",
29
- version: "2.8.1",
29
+ version: "2.9.0",
30
30
  children: [
31
31
  "nve-button",
32
32
  "nve-icon-button",
@@ -16,7 +16,7 @@ var d = class extends c {
16
16
  static {
17
17
  this.metadata = {
18
18
  tag: "nve-card",
19
- version: "2.8.1"
19
+ version: "2.9.0"
20
20
  };
21
21
  }
22
22
  render() {
@@ -37,7 +37,7 @@ var f = class extends c {
37
37
  static {
38
38
  this.metadata = {
39
39
  tag: "nve-card-header",
40
- version: "2.8.1",
40
+ version: "2.9.0",
41
41
  parents: ["nve-card"]
42
42
  };
43
43
  }
@@ -53,7 +53,7 @@ var p = class extends c {
53
53
  static {
54
54
  this.metadata = {
55
55
  tag: "nve-card-content",
56
- version: "2.8.1",
56
+ version: "2.9.0",
57
57
  parents: ["nve-card"]
58
58
  };
59
59
  }
@@ -72,7 +72,7 @@ var m = class extends c {
72
72
  static {
73
73
  this.metadata = {
74
74
  tag: "nve-card-footer",
75
- version: "2.8.1",
75
+ version: "2.9.0",
76
76
  parents: ["nve-card"]
77
77
  };
78
78
  }
@@ -13,7 +13,7 @@ var l = class extends o {
13
13
  static {
14
14
  this.metadata = {
15
15
  tag: "nve-chat-message",
16
- version: "2.8.1"
16
+ version: "2.9.0"
17
17
  };
18
18
  }
19
19
  render() {
@@ -12,7 +12,7 @@ var o = class extends i {
12
12
  static {
13
13
  this.metadata = {
14
14
  tag: "nve-checkbox-group",
15
- version: "2.8.1",
15
+ version: "2.9.0",
16
16
  children: [
17
17
  "label",
18
18
  "nve-control-message",
@@ -15,7 +15,7 @@ var o = class extends i {
15
15
  static {
16
16
  this.metadata = {
17
17
  tag: "nve-checkbox",
18
- version: "2.8.1",
18
+ version: "2.9.0",
19
19
  children: [
20
20
  "label",
21
21
  "input",
@@ -21,7 +21,7 @@ var f = class extends a {
21
21
  static {
22
22
  this.metadata = {
23
23
  tag: "nve-color",
24
- version: "2.8.1"
24
+ version: "2.9.0"
25
25
  };
26
26
  }
27
27
  static {
@@ -31,7 +31,7 @@ var S = class extends l {
31
31
  static {
32
32
  this.metadata = {
33
33
  tag: "nve-combobox",
34
- version: "2.8.1"
34
+ version: "2.9.0"
35
35
  };
36
36
  }
37
37
  static {
@@ -32,7 +32,7 @@ var p = class extends a {
32
32
  static {
33
33
  this.metadata = {
34
34
  tag: "nve-copy-button",
35
- version: "2.8.1"
35
+ version: "2.9.0"
36
36
  };
37
37
  }
38
38
  static {
@@ -4004,6 +4004,70 @@ export type TreeProps = {
4004
4004
  onselect?: (e: CustomEvent<never>) => void;
4005
4005
  };
4006
4006
 
4007
+ export type ViewportGridlinesProps = {
4008
+ /** Content-space x coordinate of the grid origin. */
4009
+ "origin-x"?: number;
4010
+ /** Content-space y coordinate of the grid origin. */
4011
+ "origin-y"?: number;
4012
+ /** Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. */
4013
+ "target-spacing"?: number;
4014
+ /** Smallest gridline interval in content-space units. */
4015
+ step?: number;
4016
+ /** Content-space x coordinate of the grid origin. */
4017
+ originX?: number;
4018
+ /** Content-space y coordinate of the grid origin. */
4019
+ originY?: number;
4020
+ /** Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. */
4021
+ targetSpacing?: number;
4022
+ };
4023
+
4024
+ export type ViewportProps = {
4025
+ /** Inclusive lower scale limit. */
4026
+ "min-scale"?: number;
4027
+ /** Inclusive upper scale limit. */
4028
+ "max-scale"?: number;
4029
+ /** Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. */
4030
+ "behavior-pan"?: boolean | "space";
4031
+ /** Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. */
4032
+ "behavior-zoom"?: boolean;
4033
+ /** Default uniform CSS-pixel inset reserved around bounds when fitting content. */
4034
+ "fit-inset"?: number;
4035
+ /** CSS-pixel pointer movement required before a pointer pan begins. */
4036
+ "drag-threshold"?: number;
4037
+ /** Horizontal content-space coordinate at the viewport origin. */
4038
+ x?: number;
4039
+ /** Vertical content-space coordinate at the viewport origin. */
4040
+ y?: number;
4041
+ /** Content-to-viewport CSS-pixel scale. */
4042
+ scale?: number;
4043
+ /** Inclusive lower scale limit. */
4044
+ minScale?: number;
4045
+ /** Inclusive upper scale limit. */
4046
+ maxScale?: number;
4047
+ /** Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. */
4048
+ behaviorPan?: boolean | "space";
4049
+ /** Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. */
4050
+ behaviorZoom?: boolean;
4051
+ /** Fits measurable direct default-slot content once after initial layout. */
4052
+ autoFit?: boolean;
4053
+ /** Default uniform CSS-pixel inset reserved around bounds when fitting content. */
4054
+ fitInset?: number;
4055
+ /** CSS-pixel pointer movement required before a pointer pan begins. */
4056
+ dragThreshold?: number;
4057
+ /** Dispatched once after a render that commits one or more viewport transform changes. */
4058
+ onviewportchange?: (e: CustomEvent<CustomEvent>) => void;
4059
+ /** */
4060
+ ontype?: (e: CustomEvent<CustomEvent>) => void;
4061
+ /** Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. */
4062
+ onpanstart?: (e: CustomEvent<never>) => void;
4063
+ /** Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. */
4064
+ onpan?: (e: CustomEvent<never>) => void;
4065
+ /** Dispatched when a pointer pan ends, including its terminal reason. */
4066
+ onpanend?: (e: CustomEvent<never>) => void;
4067
+ /** Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. */
4068
+ onzoom?: (e: CustomEvent<never>) => void;
4069
+ };
4070
+
4007
4071
  export type WeekProps = {
4008
4072
  /** Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select) */
4009
4073
  "fit-text"?: boolean;
@@ -6633,6 +6697,51 @@ export type CustomElements = {
6633
6697
  */
6634
6698
  "nve-tree": Partial<TreeProps & BaseProps & BaseEvents>;
6635
6699
 
6700
+ /**
6701
+ * Renders origin-stable, zoom-adaptive gridlines behind viewport content.
6702
+ * ---
6703
+ *
6704
+ *
6705
+ * ### **CSS Properties:**
6706
+ * - **--color** - Sets the gridline stroke color. _(default: undefined)_
6707
+ * - **--line-width** - Sets the approximate stroke width in CSS pixels. _(default: undefined)_
6708
+ */
6709
+ "nve-viewport-gridlines": Partial<ViewportGridlinesProps & BaseProps & BaseEvents>;
6710
+
6711
+ /**
6712
+ * A viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.
6713
+ * ---
6714
+ *
6715
+ *
6716
+ * ### **Events:**
6717
+ * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
6718
+ * - **type**
6719
+ * - **panstart** - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
6720
+ * - **pan** - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
6721
+ * - **panend** - Dispatched when a pointer pan ends, including its terminal reason.
6722
+ * - **zoom** - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
6723
+ *
6724
+ * ### **Methods:**
6725
+ * - **toViewportCoords(contentX: _number_, contentY: _number_): _ViewportPoint_** - Converts a content-space point to viewport CSS pixels.
6726
+ * - **toContentCoords(viewportX: _number_, viewportY: _number_): _ViewportPoint_** - Converts a viewport CSS-pixel point to content space.
6727
+ * - **getTransform(): _ViewportTransform_** - Returns the current content-space origin and CSS-pixel scale.
6728
+ * - **getVisibleRect(): _ViewportRect_** - Returns the visible content-space rectangle.
6729
+ * - **animateTo(target: _Partial<ViewportTransform>_, options: _ViewportAnimationOptions_): _void_** - Animates the viewport to the requested partial transform.
6730
+ * - **reveal(region: _{ x: number; y: number; width?: number; height?: number }_, options: _ViewportRevealOptions_): _void_** - Centers or fits a content-space region within the viewport.
6731
+ * - **fitContents(options: _ViewportRevealOptions_): _void_** - Fits the union of direct default-slot element boxes within the viewport.
6732
+ *
6733
+ * ### **Slots:**
6734
+ * - _default_ - Content positioned in the viewport's infinite content space.
6735
+ * - **background** - Custom content rendered behind viewport content and excluded from content fitting
6736
+ *
6737
+ * ### **CSS Properties:**
6738
+ * - **--background** - Background color of the fixed viewport area. _(default: undefined)_
6739
+ * - **--min-height** - undefined _(default: undefined)_
6740
+ * - **--pan-cursor** - Cursor shown over a background eligible for primary-pointer panning. _(default: undefined)_
6741
+ * - **--panning-cursor** - Cursor shown while a pointer pan is active. _(default: undefined)_
6742
+ */
6743
+ "nve-viewport": Partial<ViewportProps & BaseProps & BaseEvents>;
6744
+
6636
6745
  /**
6637
6746
  * A week picker is a control that enables users to choose a week value.
6638
6747
  * ---
@@ -3766,6 +3766,68 @@ type TreeProps = {
3766
3766
  onselect?: (e: CustomEvent<never>) => void;
3767
3767
  };
3768
3768
 
3769
+ type ViewportGridlinesProps = {
3770
+ /** Content-space x coordinate of the grid origin. */
3771
+ "origin-x"?: number;
3772
+ /** Content-space y coordinate of the grid origin. */
3773
+ "origin-y"?: number;
3774
+ /** Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. */
3775
+ "target-spacing"?: number;
3776
+ /** Smallest gridline interval in content-space units. */
3777
+ step?: number;
3778
+ /** Content-space x coordinate of the grid origin. */
3779
+ originX?: number;
3780
+ /** Content-space y coordinate of the grid origin. */
3781
+ originY?: number;
3782
+ /** Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. */
3783
+ targetSpacing?: number;
3784
+ };
3785
+
3786
+ type ViewportProps = {
3787
+ /** Inclusive lower scale limit. */
3788
+ "min-scale"?: number;
3789
+ /** Inclusive upper scale limit. */
3790
+ "max-scale"?: number;
3791
+ /** Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. */
3792
+ "behavior-pan"?: boolean | "space";
3793
+ /** Default uniform CSS-pixel inset reserved around bounds when fitting content. */
3794
+ "fit-inset"?: number;
3795
+ /** CSS-pixel pointer movement required before a pointer pan begins. */
3796
+ "drag-threshold"?: number;
3797
+ /** Horizontal content-space coordinate at the viewport origin. */
3798
+ x?: number;
3799
+ /** Vertical content-space coordinate at the viewport origin. */
3800
+ y?: number;
3801
+ /** Content-to-viewport CSS-pixel scale. */
3802
+ scale?: number;
3803
+ /** Inclusive lower scale limit. */
3804
+ minScale?: number;
3805
+ /** Inclusive upper scale limit. */
3806
+ maxScale?: number;
3807
+ /** Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. */
3808
+ behaviorPan?: boolean | "space";
3809
+ /** Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. */
3810
+ behaviorZoom?: boolean;
3811
+ /** Fits measurable direct default-slot content once after initial layout. */
3812
+ autoFit?: boolean;
3813
+ /** Default uniform CSS-pixel inset reserved around bounds when fitting content. */
3814
+ fitInset?: number;
3815
+ /** CSS-pixel pointer movement required before a pointer pan begins. */
3816
+ dragThreshold?: number;
3817
+ /** Dispatched once after a render that commits one or more viewport transform changes. */
3818
+ onviewportchange?: (e: CustomEvent<CustomEvent>) => void;
3819
+ /** */
3820
+ ontype?: (e: CustomEvent<CustomEvent>) => void;
3821
+ /** Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. */
3822
+ onpanstart?: (e: CustomEvent<never>) => void;
3823
+ /** Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. */
3824
+ onpan?: (e: CustomEvent<never>) => void;
3825
+ /** Dispatched when a pointer pan ends, including its terminal reason. */
3826
+ onpanend?: (e: CustomEvent<never>) => void;
3827
+ /** Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. */
3828
+ onzoom?: (e: CustomEvent<never>) => void;
3829
+ };
3830
+
3769
3831
  type WeekProps = {
3770
3832
  /** Reduces the visual container for a minimal borderless appearance while preserving whitespace bounds.
3771
3833
  Use when embedding within another container such as a toolbar. */
@@ -6391,6 +6453,51 @@ export type CustomElements = {
6391
6453
  */
6392
6454
  "nve-tree": DefineComponent<TreeProps>;
6393
6455
 
6456
+ /**
6457
+ * Renders origin-stable, zoom-adaptive gridlines behind viewport content.
6458
+ * ---
6459
+ *
6460
+ *
6461
+ * ### **CSS Properties:**
6462
+ * - **--color** - Sets the gridline stroke color. _(default: undefined)_
6463
+ * - **--line-width** - Sets the approximate stroke width in CSS pixels. _(default: undefined)_
6464
+ */
6465
+ "nve-viewport-gridlines": DefineComponent<ViewportGridlinesProps>;
6466
+
6467
+ /**
6468
+ * A viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.
6469
+ * ---
6470
+ *
6471
+ *
6472
+ * ### **Events:**
6473
+ * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
6474
+ * - **type**
6475
+ * - **panstart** - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
6476
+ * - **pan** - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
6477
+ * - **panend** - Dispatched when a pointer pan ends, including its terminal reason.
6478
+ * - **zoom** - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
6479
+ *
6480
+ * ### **Methods:**
6481
+ * - **toViewportCoords(contentX: _number_, contentY: _number_): _ViewportPoint_** - Converts a content-space point to viewport CSS pixels.
6482
+ * - **toContentCoords(viewportX: _number_, viewportY: _number_): _ViewportPoint_** - Converts a viewport CSS-pixel point to content space.
6483
+ * - **getTransform(): _ViewportTransform_** - Returns the current content-space origin and CSS-pixel scale.
6484
+ * - **getVisibleRect(): _ViewportRect_** - Returns the visible content-space rectangle.
6485
+ * - **animateTo(target: _Partial<ViewportTransform>_, options: _ViewportAnimationOptions_): _void_** - Animates the viewport to the requested partial transform.
6486
+ * - **reveal(region: _{ x: number; y: number; width?: number; height?: number }_, options: _ViewportRevealOptions_): _void_** - Centers or fits a content-space region within the viewport.
6487
+ * - **fitContents(options: _ViewportRevealOptions_): _void_** - Fits the union of direct default-slot element boxes within the viewport.
6488
+ *
6489
+ * ### **Slots:**
6490
+ * - _default_ - Content positioned in the viewport's infinite content space.
6491
+ * - **background** - Custom content rendered behind viewport content and excluded from content fitting
6492
+ *
6493
+ * ### **CSS Properties:**
6494
+ * - **--background** - Background color of the fixed viewport area. _(default: undefined)_
6495
+ * - **--min-height** - undefined _(default: undefined)_
6496
+ * - **--pan-cursor** - Cursor shown over a background eligible for primary-pointer panning. _(default: undefined)_
6497
+ * - **--panning-cursor** - Cursor shown while a pointer pan is active. _(default: undefined)_
6498
+ */
6499
+ "nve-viewport": DefineComponent<ViewportProps>;
6500
+
6394
6501
  /**
6395
6502
  * A week picker is a control that enables users to choose a week value.
6396
6503
  * ---