@astryxdesign/core 0.5.0-canary.9ebd45f → 0.5.0-canary.a5f4b03

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 (120) hide show
  1. package/dist/Badge/Badge.d.ts.map +1 -1
  2. package/dist/Badge/Badge.js +26 -2
  3. package/dist/Banner/Banner.d.ts +10 -1
  4. package/dist/Banner/Banner.d.ts.map +1 -1
  5. package/dist/Banner/Banner.js +11 -2
  6. package/dist/ComplexSelector/ComplexSelector.d.ts +10 -2
  7. package/dist/ComplexSelector/ComplexSelector.d.ts.map +1 -1
  8. package/dist/ComplexSelector/ComplexSelector.js +12 -5
  9. package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  10. package/dist/DropdownMenu/DropdownMenu.js +4 -13
  11. package/dist/Field/InputClearButton.d.ts +9 -3
  12. package/dist/Field/InputClearButton.d.ts.map +1 -1
  13. package/dist/Field/InputClearButton.js +14 -3
  14. package/dist/Icon/Icon.d.ts +4 -2
  15. package/dist/Icon/Icon.d.ts.map +1 -1
  16. package/dist/Icon/defaultIcons.d.ts +3 -2
  17. package/dist/Icon/defaultIcons.d.ts.map +1 -1
  18. package/dist/Icon/defaultIcons.js +7 -0
  19. package/dist/Icon/globalIconRegistry.d.ts +13 -0
  20. package/dist/Icon/globalIconRegistry.d.ts.map +1 -1
  21. package/dist/Icon/globalIconRegistry.js +34 -6
  22. package/dist/Icon/index.d.ts +1 -1
  23. package/dist/Icon/index.d.ts.map +1 -1
  24. package/dist/Icon/useIcon.d.ts +5 -2
  25. package/dist/Icon/useIcon.d.ts.map +1 -1
  26. package/dist/Icon/useIcon.js +3 -0
  27. package/dist/Layer/gestureCounter.d.ts +8 -0
  28. package/dist/Layer/gestureCounter.d.ts.map +1 -0
  29. package/dist/Layer/gestureCounter.js +53 -0
  30. package/dist/Layer/useLayer.d.ts +23 -13
  31. package/dist/Layer/useLayer.d.ts.map +1 -1
  32. package/dist/Layer/useLayer.js +128 -8
  33. package/dist/MultiSelector/MultiSelector.d.ts.map +1 -1
  34. package/dist/MultiSelector/MultiSelector.js +10 -4
  35. package/dist/MultiSelector/hooks.d.ts +7 -1
  36. package/dist/MultiSelector/hooks.d.ts.map +1 -1
  37. package/dist/MultiSelector/hooks.js +3 -2
  38. package/dist/NumberInput/NumberInput.js +2 -2
  39. package/dist/Popover/Popover.d.ts.map +1 -1
  40. package/dist/Popover/Popover.js +8 -14
  41. package/dist/Popover/usePopover.d.ts +15 -41
  42. package/dist/Popover/usePopover.d.ts.map +1 -1
  43. package/dist/Popover/usePopover.js +26 -7
  44. package/dist/Resizable/useResizable.d.ts +19 -1
  45. package/dist/Resizable/useResizable.d.ts.map +1 -1
  46. package/dist/Resizable/useResizable.js +101 -37
  47. package/dist/Selector/Selector.d.ts +1 -1
  48. package/dist/Selector/Selector.d.ts.map +1 -1
  49. package/dist/Selector/Selector.js +10 -4
  50. package/dist/Selector/hooks.d.ts +7 -1
  51. package/dist/Selector/hooks.d.ts.map +1 -1
  52. package/dist/Selector/hooks.js +3 -2
  53. package/dist/SideNav/SideNav.d.ts +6 -1
  54. package/dist/SideNav/SideNav.d.ts.map +1 -1
  55. package/dist/SideNav/SideNav.js +57 -27
  56. package/dist/Spinner/Spinner.d.ts +3 -1
  57. package/dist/Spinner/Spinner.d.ts.map +1 -1
  58. package/dist/Spinner/Spinner.js +199 -20
  59. package/dist/astryx.css +24 -5
  60. package/dist/theme/defineTheme.d.ts +9 -3
  61. package/dist/theme/defineTheme.d.ts.map +1 -1
  62. package/dist/theme/defineTheme.js +5 -0
  63. package/locales/en.json +5 -1
  64. package/locales/pseudo.json +3 -0
  65. package/package.json +2 -2
  66. package/src/Badge/Badge.doc.mjs +3 -2
  67. package/src/Badge/Badge.test.tsx +32 -3
  68. package/src/Badge/Badge.tsx +42 -1
  69. package/src/Banner/Banner.doc.mjs +9 -0
  70. package/src/Banner/Banner.test.tsx +76 -11
  71. package/src/Banner/Banner.tsx +21 -2
  72. package/src/ComplexSelector/ComplexSelector.doc.mjs +7 -0
  73. package/src/ComplexSelector/ComplexSelector.test.tsx +183 -0
  74. package/src/ComplexSelector/ComplexSelector.tsx +20 -5
  75. package/src/DropdownMenu/DropdownMenu.test.tsx +44 -10
  76. package/src/DropdownMenu/DropdownMenu.tsx +4 -13
  77. package/src/Field/InputClearButton.test.tsx +15 -1
  78. package/src/Field/InputClearButton.tsx +28 -4
  79. package/src/Icon/Icon.test.tsx +55 -1
  80. package/src/Icon/Icon.tsx +5 -3
  81. package/src/Icon/defaultIcons.tsx +11 -2
  82. package/src/Icon/globalIconRegistry.test.tsx +16 -3
  83. package/src/Icon/globalIconRegistry.tsx +37 -6
  84. package/src/Icon/index.ts +1 -0
  85. package/src/Icon/useIcon.ts +9 -2
  86. package/src/Layer/gestureCounter.ts +57 -0
  87. package/src/Layer/useLayer.test.tsx +262 -1
  88. package/src/Layer/useLayer.tsx +164 -8
  89. package/src/Layout/__tests__/edgeCompensation.test.tsx +1 -1
  90. package/src/MultiSelector/MultiSelector.test.tsx +34 -0
  91. package/src/MultiSelector/MultiSelector.tsx +9 -4
  92. package/src/MultiSelector/hooks.ts +9 -2
  93. package/src/NumberInput/NumberInput.test.tsx +29 -0
  94. package/src/NumberInput/NumberInput.tsx +2 -2
  95. package/src/Popover/Popover.doc.mjs +2 -2
  96. package/src/Popover/Popover.test.tsx +38 -0
  97. package/src/Popover/Popover.tsx +28 -66
  98. package/src/Popover/usePopover.tsx +44 -5
  99. package/src/Resizable/Resizable.doc.mjs +2 -2
  100. package/src/Resizable/useResizable.doc.mjs +21 -2
  101. package/src/Resizable/useResizable.test.ts +402 -0
  102. package/src/Resizable/useResizable.ts +130 -47
  103. package/src/Selector/Selector.test.tsx +35 -0
  104. package/src/Selector/Selector.tsx +9 -5
  105. package/src/Selector/hooks.ts +17 -2
  106. package/src/SideNav/SideNav.doc.mjs +2 -2
  107. package/src/SideNav/SideNav.test.tsx +364 -1
  108. package/src/SideNav/SideNav.tsx +109 -38
  109. package/src/Spinner/Spinner.doc.mjs +17 -5
  110. package/src/Spinner/Spinner.test.tsx +164 -0
  111. package/src/Spinner/Spinner.tsx +252 -22
  112. package/src/hooks/useAnnounce.doc.mjs +96 -0
  113. package/src/hooks/useDevWarning.doc.mjs +96 -0
  114. package/src/hooks/useIndicatorFocusRing.doc.mjs +104 -0
  115. package/src/hooks/useInputStatusIcon.doc.mjs +142 -0
  116. package/src/hooks/useInteractiveRole.doc.mjs +119 -0
  117. package/src/hooks/useLongPress.doc.mjs +123 -0
  118. package/src/hooks/useTypeahead.doc.mjs +153 -0
  119. package/src/theme/defineTheme.ts +12 -3
  120. package/src/theme/derivedVarRegistry.test.ts +57 -0
@@ -1 +1 @@
1
- {"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../src/Badge/Badge.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAW5C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,SAAS,CAAC;AAwF7C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,UAAW,SAAQ,SAAS,CAAC,eAAe,CAAC;IAC5D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,EACpB,OAAmB,EACnB,KAAK,EACL,IAAI,EACJ,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,KAAK,EACT,EAAE,UAAU,+BAeZ;yBAxBe,KAAK"}
1
+ {"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../src/Badge/Badge.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAW5C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,SAAS,CAAC;AA0G7C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,UAAW,SAAQ,SAAS,CAAC,eAAe,CAAC;IAC5D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,EACpB,OAAmB,EACnB,KAAK,EACL,IAAI,EACJ,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,KAAK,EACT,EAAE,UAAU,+BAsCZ;yBA/Ce,KAAK"}
@@ -19,7 +19,7 @@ import "../theme/tokens.stylex.js";
19
19
  import { colorVars, spacingVars, radiusVars, fontWeightVars, typeScaleVars } from "../theme/tokens.stylex.js";
20
20
  import { mergeProps } from "../utils/index.js";
21
21
  import { themeProps } from "../utils/themeProps.js";
22
- import { jsxs as _jsxs } from "react/jsx-runtime";
22
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
23
23
  /**
24
24
  * Base badge styles
25
25
  */
@@ -38,6 +38,8 @@ const styles = {
38
38
  kLWn49: "x1ltkj2j",
39
39
  k63SB2: "x1e4wzip",
40
40
  khDVqt: "xuxw1ft",
41
+ ks0D6T: "x193iq5w",
42
+ k7Eaqz: "xeuugli",
41
43
  $$css: true
42
44
  }
43
45
  };
@@ -148,13 +150,35 @@ export function Badge({
148
150
  ref,
149
151
  ...props
150
152
  }) {
153
+ // Clipping a label makes its tail unrecoverable, so the full text has to
154
+ // stay reachable somewhere. `title` is the half of that answer which costs
155
+ // nothing: no measurement, no hook, so `Badge` renders the same on the
156
+ // server and stays usable in a server component. It follows the shape
157
+ // `BaseTable` already uses for a truncated header cell (BaseTable.tsx) —
158
+ // string content only, and only when there is something to show.
159
+ //
160
+ // A rich label is left alone: it is a subtree whose text would have to be
161
+ // flattened to a string, and flattening renders a guess — an icon, a
162
+ // `<strong>`, a nested element all read differently.
163
+ //
164
+ // It is set whether or not the label actually fits, because knowing that
165
+ // requires measuring. The refinement — a tooltip only when the text is
166
+ // really cut, reachable by hover and by focus — needs that measurement and
167
+ // a client component, so it is tracked in #5585.
168
+ const labelTitle = typeof label === 'number' ? String(label) : typeof label === 'string' && label.length > 0 ? label : undefined;
151
169
  return /*#__PURE__*/_jsxs("span", {
152
170
  ref: ref,
153
171
  ...mergeProps(themeProps('badge', {
154
172
  variant
155
173
  }), stylex.props(styles.base, variants[variant], xstyle), className, style),
174
+ title: labelTitle,
156
175
  ...props,
157
- children: [icon, label]
176
+ children: [icon, /*#__PURE__*/_jsx("span", {
177
+ ...{
178
+ className: "xb3r6kr xlyipyv xeuugli"
179
+ },
180
+ children: label
181
+ })]
158
182
  });
159
183
  }
160
184
  Badge.displayName = 'Badge';
@@ -86,6 +86,15 @@ export interface BannerProps extends BaseProps<HTMLDivElement> {
86
86
  * The banner will hide itself regardless of whether this callback is provided.
87
87
  */
88
88
  onDismiss?: () => void;
89
+ /**
90
+ * Accessible name and visible tooltip for the dismiss button, replacing the default.
91
+ * Pass an already-translated string.
92
+ *
93
+ * The default is "Dismiss {title}" when `title` is a string, so stacked
94
+ * banners are told apart by a screen reader; a non-string `title` falls back
95
+ * to "Dismiss" and should set this.
96
+ */
97
+ dismissLabel?: string;
89
98
  /**
90
99
  * Action button rendered in the header area (end-aligned).
91
100
  * Typically an Button with a secondary or ghost variant.
@@ -191,7 +200,7 @@ export interface BannerProps extends BaseProps<HTMLDivElement> {
191
200
  * </Banner>
192
201
  * ```
193
202
  */
194
- export declare function Banner({ status, title, description, icon, isDismissable, onDismiss, endContent, container, elevation, collapsible, children, xstyle, className, style, ref, onFocusCapture, onPointerDownCapture, ...rest }: BannerProps): import("react").JSX.Element | null;
203
+ export declare function Banner({ status, title, description, icon, isDismissable, onDismiss, dismissLabel, endContent, container, elevation, collapsible, children, xstyle, className, style, ref, onFocusCapture, onPointerDownCapture, ...rest }: BannerProps): import("react").JSX.Element | null;
195
204
  export declare namespace Banner {
196
205
  var displayName: string;
197
206
  }
@@ -1 +1 @@
1
- {"version":3,"file":"Banner.d.ts","sourceRoot":"","sources":["../../src/Banner/Banner.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAA0B,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAgB5C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAI9C,OAAO,KAAK,EAAC,eAAe,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAMjE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,WAAY,SAAQ,SAAS,CAAC,cAAc,CAAC;IAC5D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAmND;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,MAAM,CAAC,EACrB,MAAM,EACN,KAAK,EACL,WAAW,EACX,IAAI,EACJ,aAAqB,EACrB,SAAS,EACT,UAAU,EACV,SAAkB,EAClB,SAAkB,EAClB,WAAkB,EAClB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,cAAc,EACd,oBAAoB,EACpB,GAAG,IAAI,EACR,EAAE,WAAW,sCAoOb;yBAvPe,MAAM"}
1
+ {"version":3,"file":"Banner.d.ts","sourceRoot":"","sources":["../../src/Banner/Banner.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAA0B,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAgB5C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAI9C,OAAO,KAAK,EAAC,eAAe,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAMjE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,WAAY,SAAQ,SAAS,CAAC,cAAc,CAAC;IAC5D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAmND;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,MAAM,CAAC,EACrB,MAAM,EACN,KAAK,EACL,WAAW,EACX,IAAI,EACJ,aAAqB,EACrB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,SAAkB,EAClB,SAAkB,EAClB,WAAkB,EAClB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,cAAc,EACd,oBAAoB,EACpB,GAAG,IAAI,EACR,EAAE,WAAW,sCA6Ob;yBAjQe,MAAM"}
@@ -279,6 +279,7 @@ export function Banner({
279
279
  icon,
280
280
  isDismissable = false,
281
281
  onDismiss,
282
+ dismissLabel,
282
283
  endContent,
283
284
  container = 'card',
284
285
  elevation = 'none',
@@ -328,6 +329,14 @@ export function Banner({
328
329
  const role = statusRole[status] ?? FALLBACK_ROLE;
329
330
  const iconColor = statusIconColor[status];
330
331
  const hasChildren = isRenderable(children);
332
+ // Keep the default tooltip concise while the accessible name identifies
333
+ // the banner; an explicit translated override names both surfaces.
334
+ const dismiss = t('@astryx.banner.dismiss');
335
+ const dismissTooltip = dismissLabel ?? dismiss;
336
+ const dismissName = dismissLabel ?? (typeof title === 'string' ? t('@astryx.banner.dismissTitled', {
337
+ dismiss,
338
+ title
339
+ }) : dismiss);
331
340
  if (isDismissed) {
332
341
  return null;
333
342
  }
@@ -445,8 +454,8 @@ export function Banner({
445
454
  }), isDismissable && /*#__PURE__*/_jsx(Button, {
446
455
  variant: "ghost",
447
456
  size: "sm",
448
- label: t('@astryx.banner.dismiss'),
449
- tooltip: t('@astryx.banner.dismiss'),
457
+ label: dismissName,
458
+ tooltip: dismissTooltip,
450
459
  icon: /*#__PURE__*/_jsx(Icon, {
451
460
  icon: "close",
452
461
  size: "sm",
@@ -36,7 +36,8 @@ export interface ComplexSelectorRenderState {
36
36
  * they respect focus restoration, light dismiss, and Escape. Prefer these
37
37
  * callbacks over mirroring open state in the parent — the selector owns its
38
38
  * visibility, and imperative calls avoid the focus-management pitfalls of
39
- * syncing an external `isOpen` prop.
39
+ * syncing an external `isOpen` prop. Pair with `onOpenChange` to observe every
40
+ * open and close, including the ones the selector performs itself.
40
41
  */
41
42
  export interface ComplexSelectorHandle {
42
43
  /** Open the selector surface. No-op when disabled or already open. */
@@ -103,6 +104,13 @@ export interface ComplexSelectorProps<Value> extends Omit<BaseProps<HTMLDivEleme
103
104
  * state in the parent — the selector owns its visibility.
104
105
  */
105
106
  handleRef?: React.Ref<ComplexSelectorHandle>;
107
+ /**
108
+ * Called whenever the selector surface opens or closes, however it happened
109
+ * — the trigger, the keyboard, a light dismiss, Escape, content that calls
110
+ * `close()`, or the imperative handle. Pair it with `handleRef` to drive the
111
+ * surface from outside without mirroring its state.
112
+ */
113
+ onOpenChange?: (isOpen: boolean) => void;
106
114
  /** StyleX styles for the popup content container. */
107
115
  contentXstyle?: StyleXStyles;
108
116
  /** Test ID for the trigger container. */
@@ -135,7 +143,7 @@ export interface ComplexSelectorProps<Value> extends Omit<BaseProps<HTMLDivEleme
135
143
  * </ComplexSelector>
136
144
  * ```
137
145
  */
138
- export declare function ComplexSelector<Value>({ label, value, onChange, changeAction, children, triggerLabel, placeholder: placeholderFromProps, isLabelHidden, description, isOptional, isRequired, isDisabled, isLoading, status, statusVariant, labelTooltip, size, variant, startIcon, width, placement, alignment, handleRef, contentXstyle, xstyle, className, style, 'data-testid': testId, onClick: onClickProp, ...props }: ComplexSelectorProps<Value>): React.JSX.Element;
146
+ export declare function ComplexSelector<Value>({ label, value, onChange, changeAction, children, triggerLabel, placeholder: placeholderFromProps, isLabelHidden, description, isOptional, isRequired, isDisabled, isLoading, status, statusVariant, labelTooltip, size, variant, startIcon, width, placement, alignment, handleRef, onOpenChange, contentXstyle, xstyle, className, style, 'data-testid': testId, onClick: onClickProp, ...props }: ComplexSelectorProps<Value>): React.JSX.Element;
139
147
  export declare namespace ComplexSelector {
140
148
  var displayName: string;
141
149
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ComplexSelector.d.ts","sourceRoot":"","sources":["../../src/ComplexSelector/ComplexSelector.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ComplexSelector.d.ts","sourceRoot":"","sources":["../../src/ComplexSelector/ComplexSelector.tsx"],"names":[],"mappings":"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"}
@@ -150,7 +150,8 @@ const styles = {
150
150
  * they respect focus restoration, light dismiss, and Escape. Prefer these
151
151
  * callbacks over mirroring open state in the parent — the selector owns its
152
152
  * visibility, and imperative calls avoid the focus-management pitfalls of
153
- * syncing an external `isOpen` prop.
153
+ * syncing an external `isOpen` prop. Pair with `onOpenChange` to observe every
154
+ * open and close, including the ones the selector performs itself.
154
155
  */
155
156
 
156
157
  /**
@@ -204,6 +205,7 @@ export function ComplexSelector({
204
205
  placement = 'below',
205
206
  alignment = 'start',
206
207
  handleRef,
208
+ onOpenChange,
207
209
  contentXstyle,
208
210
  xstyle,
209
211
  className,
@@ -226,24 +228,29 @@ export function ComplexSelector({
226
228
  const statusMessageId = useId();
227
229
  const ariaDescribedBy = [description ? descriptionId : null, status?.message ? statusMessageId : null].filter(id => id != null).join(' ') || undefined;
228
230
  const triggerRef = useRef(null);
229
- const lastHideTimeRef = useRef(0);
230
231
  const [isPending, startTransition] = useTransition();
231
232
  const [optimisticValue, setOptimisticValue] = useOptimistic(value);
232
233
  const isBusy = isLoading || isPending;
234
+ const handlePopoverShow = useCallback(() => {
235
+ onOpenChange?.(true);
236
+ }, [onOpenChange]);
233
237
  const handlePopoverHide = useCallback(() => {
234
- lastHideTimeRef.current = Date.now();
238
+ // Focus is restored first so a consumer that moves focus elsewhere from
239
+ // the callback wins, instead of being overwritten a line later.
235
240
  triggerRef.current?.focus();
236
- }, []);
241
+ onOpenChange?.(false);
242
+ }, [onOpenChange]);
237
243
  const popover = usePopover({
238
244
  dialogLabel: label,
239
245
  hasCloseButton: false,
240
246
  hasAutoFocus: true,
241
247
  surfaceTarget: 'complex-selector-popup',
248
+ onShow: handlePopoverShow,
242
249
  onHide: handlePopoverHide
243
250
  });
244
251
  const isOpen = popover.isOpen;
245
252
  const handleTriggerClick = useCallback(() => {
246
- if (isDisabled || Date.now() - lastHideTimeRef.current < 50) {
253
+ if (isDisabled) {
247
254
  return;
248
255
  }
249
256
  if (popover.isOpen) {
@@ -1 +1 @@
1
- {"version":3,"file":"DropdownMenu.d.ts","sourceRoot":"","sources":["../../src/DropdownMenu/DropdownMenu.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAS,KAAK,WAAW,EAAC,MAAM,WAAW,CAAC;AAInD,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAa9D,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAQtE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAiC5C;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,qBAAqB,EACnB,MAAM,GACN,SAAS,GACT,YAAY,GACZ,SAAS,GACT,aAAa,GACb,YAAY,GACZ,kBAAkB,CACrB;IACC;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAC5B,oBAAoB,GAAG,uBAAuB,GAAG,mBAAmB,CAAC;AAMvE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAEnE,UAAU,qBAAsB,SAAQ,SAAS;IAC/C,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,qBAAsB,SAAQ,qBAAqB;IAC3D,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,yBAA0B,SAAQ,qBAAqB;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAC3B,qBAAqB,GAAG,yBAAyB,CAAC;AA+BpD,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EACZ,SAAS,EACT,OAAO,EACP,UAAiB,EACjB,SAAmB,EACnB,SAAmB,EACnB,SAAS,EACT,KAAK,EACL,MAAM,EACN,aAAa,EAAE,MAAM,EACrB,GAAG,KAAK,EACT,EAAE,iBAAiB,qBA2TnB;yBAzUe,YAAY"}
1
+ {"version":3,"file":"DropdownMenu.d.ts","sourceRoot":"","sources":["../../src/DropdownMenu/DropdownMenu.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,EAOZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAS,KAAK,WAAW,EAAC,MAAM,WAAW,CAAC;AAInD,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAa9D,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAQtE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAiC5C;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,qBAAqB,EACnB,MAAM,GACN,SAAS,GACT,YAAY,GACZ,SAAS,GACT,aAAa,GACb,YAAY,GACZ,kBAAkB,CACrB;IACC;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAC5B,oBAAoB,GAAG,uBAAuB,GAAG,mBAAmB,CAAC;AAMvE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAEnE,UAAU,qBAAsB,SAAQ,SAAS;IAC/C,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,qBAAsB,SAAQ,qBAAqB;IAC3D,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,yBAA0B,SAAQ,qBAAqB;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAC3B,qBAAqB,GAAG,yBAAyB,CAAC;AA+BpD,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EACZ,SAAS,EACT,OAAO,EACP,UAAiB,EACjB,SAAmB,EACnB,SAAmB,EACnB,SAAS,EACT,KAAK,EACL,MAAM,EACN,aAAa,EAAE,MAAM,EACrB,GAAG,KAAK,EACT,EAAE,iBAAiB,qBAkTnB;yBAhUe,YAAY"}
@@ -28,7 +28,7 @@
28
28
  */
29
29
  import React, { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';
30
30
  import * as stylex from '@stylexjs/stylex';
31
- import { usePopover } from "../Popover/usePopover.js";
31
+ import { usePopoverInternal } from "../Popover/usePopover.js";
32
32
  import { Button } from "../Button/index.js";
33
33
  import { Icon } from "../Icon/index.js";
34
34
  import { renderDropdownItems } from "./renderDropdownItems.js";
@@ -161,14 +161,8 @@ export function DropdownMenu({
161
161
  const isControlled = controlledIsOpen !== undefined;
162
162
  const isOpen = isControlled ? controlledIsOpen : internalIsOpen;
163
163
 
164
- // Track when the menu was last hidden so a near-simultaneous trigger
165
- // click — e.g. on iOS Safari where pointerdown fires light-dismiss
166
- // before the trigger's click event — can't immediately re-open it.
167
- const lastHideTimeRef = useRef(0);
168
-
169
164
  // Close menu + return focus to trigger
170
165
  const handleLayerHide = useCallback(() => {
171
- lastHideTimeRef.current = Date.now();
172
166
  onOpenChange?.(false);
173
167
  if (!isControlled) {
174
168
  setInternalIsOpen(false);
@@ -192,7 +186,7 @@ export function DropdownMenu({
192
186
  setInternalIsOpen(true);
193
187
  }
194
188
  }, [isControlled, onOpenChange]);
195
- const popover = usePopover({
189
+ const popover = usePopoverInternal({
196
190
  onHide: handleLayerHide,
197
191
  onShow: handleLayerShow,
198
192
  hasLightDismiss: true,
@@ -303,11 +297,8 @@ export function DropdownMenu({
303
297
  popover.show();
304
298
  }, [popover]);
305
299
  const handleButtonClick = useCallback(e => {
306
- // If the menu was just closed by light dismiss (e.g. iOS Safari fires
307
- // pointerdown → hide before the trigger's click), the click would
308
- // otherwise immediately re-open it. Short-circuit within the guard
309
- // window.
310
- if (Date.now() - lastHideTimeRef.current < 50) {
300
+ // The click that light-dismissed the menu is not a request to reopen it.
301
+ if (popover.wasJustDismissed()) {
311
302
  return;
312
303
  }
313
304
  onClick?.();
@@ -1,8 +1,7 @@
1
1
  /**
2
2
  * @file InputClearButton.tsx
3
3
  * @input Uses React, Button, Icon
4
- * @output Exports InputClearButton, the shared clear (✕) button rendered by
5
- * every clearable input in the family.
4
+ * @output Exports the public InputClearButton and an internal popup-aware variant.
6
5
  * @position Shared primitive. Every input that renders a clear affordance —
7
6
  * TextInput, NumberInput, TimeInput, DateInput, DateTimeInput,
8
7
  * DateRangeInput, Selector, MultiSelector, Typeahead, Tokenizer, FileInput —
@@ -25,8 +24,15 @@ export interface InputClearButtonProps {
25
24
  */
26
25
  iconClassName?: string;
27
26
  }
28
- export declare function InputClearButton({ label, onClick, xstyle, iconClassName, }: InputClearButtonProps): ReactNode;
27
+ interface InternalInputClearButtonProps extends InputClearButtonProps {
28
+ onPointerDown: React.PointerEventHandler<HTMLElement>;
29
+ onClickCapture: React.MouseEventHandler<HTMLElement>;
30
+ }
31
+ export declare function InputClearButton(props: InputClearButtonProps): ReactNode;
29
32
  export declare namespace InputClearButton {
30
33
  var displayName: string;
31
34
  }
35
+ /** Internal variant used while popup-aware clear behavior is rolled out. */
36
+ export declare function InternalInputClearButton(props: InternalInputClearButtonProps): ReactNode;
37
+ export {};
32
38
  //# sourceMappingURL=InputClearButton.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"InputClearButton.d.ts","sourceRoot":"","sources":["../../src/Field/InputClearButton.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAkD3C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;IAC7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,OAAO,EACP,MAAM,EACN,aAAa,GACd,EAAE,qBAAqB,GAAG,SAAS,CA0BnC;yBA/Be,gBAAgB"}
1
+ {"version":3,"file":"InputClearButton.d.ts","sourceRoot":"","sources":["../../src/Field/InputClearButton.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAkD3C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;IAC7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,6BAA8B,SAAQ,qBAAqB;IACnE,aAAa,EAAE,KAAK,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACtD,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;CACtD;AA4CD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAExE;yBAFe,gBAAgB;;;AAIhC,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,SAAS,CAEX"}
@@ -5,8 +5,7 @@
5
5
  /**
6
6
  * @file InputClearButton.tsx
7
7
  * @input Uses React, Button, Icon
8
- * @output Exports InputClearButton, the shared clear (✕) button rendered by
9
- * every clearable input in the family.
8
+ * @output Exports the public InputClearButton and an internal popup-aware variant.
10
9
  * @position Shared primitive. Every input that renders a clear affordance —
11
10
  * TextInput, NumberInput, TimeInput, DateInput, DateTimeInput,
12
11
  * DateRangeInput, Selector, MultiSelector, Typeahead, Tokenizer, FileInput —
@@ -32,9 +31,11 @@ const styles = {
32
31
  $$css: true
33
32
  }
34
33
  };
35
- export function InputClearButton({
34
+ function renderInputClearButton({
36
35
  label,
37
36
  onClick,
37
+ onPointerDown,
38
+ onClickCapture,
38
39
  xstyle,
39
40
  iconClassName
40
41
  }) {
@@ -56,8 +57,18 @@ export function InputClearButton({
56
57
  className: iconClassName != null ? `${iconTargetClassName} ${iconClassName}` : iconTargetClassName
57
58
  }),
58
59
  onClick: onClick,
60
+ onPointerDown: onPointerDown,
61
+ onClickCapture: onClickCapture,
59
62
  isIconOnly: true,
60
63
  xstyle: [styles.button, xstyle]
61
64
  });
62
65
  }
66
+ export function InputClearButton(props) {
67
+ return renderInputClearButton(props);
68
+ }
69
+
70
+ /** Internal variant used while popup-aware clear behavior is rolled out. */
71
+ export function InternalInputClearButton(props) {
72
+ return renderInputClearButton(props);
73
+ }
63
74
  InputClearButton.displayName = 'InputClearButton';
@@ -20,7 +20,7 @@
20
20
  import React, { type ComponentType, type SVGProps } from 'react';
21
21
  import * as stylex from '@stylexjs/stylex';
22
22
  import type { StyleXStyles } from '@stylexjs/stylex';
23
- import type { IconName } from './globalIconRegistry';
23
+ import type { IconName, NamespacedIconName } from './globalIconRegistry';
24
24
  declare const colorStyles: Readonly<{
25
25
  readonly primary: Readonly<{
26
26
  readonly color: stylex.StyleXClassNameFor<"color", "light-dark(#0A1317, #DFE2E5)">;
@@ -124,9 +124,11 @@ export interface IconProps extends Omit<SVGProps<SVGSVGElement>, 'ref' | 'color'
124
124
  /**
125
125
  * Icon to render. Can be:
126
126
  * - A semantic name string (e.g. 'close', 'chevronDown') — resolved from theme or built-in fallback
127
+ * - A namespaced extension key (e.g. 'richtext:bold') for a glyph owned by
128
+ * one component or library — resolved the same way, themeable by key
127
129
  * - An SVG icon component (e.g. from @heroicons/react) — rendered directly
128
130
  */
129
- icon: IconType | IconName;
131
+ icon: IconType | IconName | NamespacedIconName;
130
132
  /**
131
133
  * The color variant of the icon.
132
134
  * @default 'inherit'
@@ -1 +1 @@
1
- {"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../src/Icon/Icon.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,EAAC,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAInD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAqBnD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2Df,CAAC;AAEH;;;;;;;;GAQG;AACH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;EAiBd,CAAC;AAyCH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CACrC,QAAQ,CAAC,aAAa,CAAC,EACvB,KAAK,GAAG,OAAO,CAChB;IACC,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B;;;;OAIG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAiB,EACjB,IAAW,EACX,KAAK,EACL,GAAG,EACH,SAAS,EACT,KAAK,EACL,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,qBA4CX;yBAtDe,IAAI;;;AA+HpB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,QAAQ,EAChC,KAAK,CAAC,EAAE;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAC,GAC3C,KAAK,CAAC,SAAS,CAYjB"}
1
+ {"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../../src/Icon/Icon.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,EAAC,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAInD,OAAO,KAAK,EAAC,QAAQ,EAAE,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAqBvE,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2Df,CAAC;AAEH;;;;;;;;GAQG;AACH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;EAiBd,CAAC;AAyCH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CACrC,QAAQ,CAAC,aAAa,CAAC,EACvB,KAAK,GAAG,OAAO,CAChB;IACC,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B;;;;;;OAMG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,kBAAkB,CAAC;IAC/C;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAiB,EACjB,IAAW,EACX,KAAK,EACL,GAAG,EACH,SAAS,EACT,KAAK,EACL,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,qBA4CX;yBAtDe,IAAI;;;AA+HpB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,QAAQ,EAChC,KAAK,CAAC,EAAE;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAC,GAC3C,KAAK,CAAC,SAAS,CAYjB"}
@@ -20,6 +20,7 @@
20
20
  * - /packages/core/src/Icon/globalIconRegistry.tsx (IconName type if names change)
21
21
  * - /packages/core/src/Icon/Icon.doc.mjs (fallback icon documentation)
22
22
  */
23
- import type { IconRegistry } from './globalIconRegistry';
24
- export declare const defaultIcons: IconRegistry;
23
+ import type { ReactNode } from 'react';
24
+ import type { IconRegistry, NamespacedIconName } from './globalIconRegistry';
25
+ export declare const defaultIcons: IconRegistry & Partial<Record<NamespacedIconName, ReactNode>>;
25
26
  //# sourceMappingURL=defaultIcons.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"defaultIcons.d.ts","sourceRoot":"","sources":["../../src/Icon/defaultIcons.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AA8BvD,eAAO,MAAM,YAAY,EAAE,YA8N1B,CAAC"}
1
+ {"version":3,"file":"defaultIcons.d.ts","sourceRoot":"","sources":["../../src/Icon/defaultIcons.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AA8B3E,eAAO,MAAM,YAAY,EAAE,YAAY,GACrC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAqO9C,CAAC"}
@@ -66,6 +66,13 @@ export const defaultIcons = {
66
66
  d: "M6 9l6 6 6-6"
67
67
  })
68
68
  }),
69
+ /** ⌄ — compact NumberInput stepper chevron */
70
+ 'numberInput:stepperDown': /*#__PURE__*/_jsx("svg", {
71
+ ...svgProps,
72
+ children: /*#__PURE__*/_jsx("path", {
73
+ d: "M7.5 9.75l4.5 4.5 4.5-4.5"
74
+ })
75
+ }),
69
76
  /** ‹ — left chevron */
70
77
  chevronLeft: /*#__PURE__*/_jsx("svg", {
71
78
  ...svgProps,
@@ -16,6 +16,19 @@ import type { DefinedTheme } from '../theme/defineTheme';
16
16
  * visual representation. Themes provide the actual icon components.
17
17
  */
18
18
  export type IconName = 'close' | 'chevronDown' | 'chevronLeft' | 'chevronRight' | 'chevronsLeft' | 'chevronsRight' | 'check' | 'success' | 'error' | 'warning' | 'info' | 'calendar' | 'clock' | 'externalLink' | 'menu' | 'moreHorizontal' | 'search' | 'arrowUp' | 'arrowDown' | 'arrowsUpDown' | 'funnel' | 'eyeSlash' | 'viewColumns' | 'copy' | 'checkDouble' | 'wrench' | 'stop' | 'microphone';
19
+ /**
20
+ * A namespaced extension key, `'<namespace>:<name>'`.
21
+ *
22
+ * This is the tier for a glyph that belongs to one component or library rather
23
+ * than to the system: `'richtext:bold'`, `'numberInput:stepperDown'`. A theme
24
+ * overrides it by key through `registerIcons` or `defineTheme({icons})`,
25
+ * exactly as it overrides a built-in name, and the core {@link IconName} union
26
+ * stays reserved for glyphs the whole system shares.
27
+ *
28
+ * Accepted anywhere a built-in name is, including `<Icon icon>` — which is
29
+ * what lets a namespaced glyph keep `size`, `color` and `xstyle`.
30
+ */
31
+ export type NamespacedIconName = `${string}:${string}`;
19
32
  /**
20
33
  * A semantic icon name — either one of the built-in {@link IconName}s or an
21
34
  * arbitrary string key contributed by a library/app.
@@ -1 +1 @@
1
- {"version":3,"file":"globalIconRegistry.d.ts","sourceRoot":"","sources":["../../src/Icon/globalIconRegistry.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAQvD;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,GACd,eAAe,GACf,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,cAAc,GACd,MAAM,GACN,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,QAAQ,GACR,UAAU,GACV,aAAa,GACb,MAAM,GACN,aAAa,GACb,QAAQ,GACR,MAAM,GACN,YAAY,CAAC;AAEjB;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAsB1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,GAClD,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,QAAQ,CAAC,YAAY,CAAC,CAkBxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,gBAAgB,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAOX;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAQX;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}
1
+ {"version":3,"file":"globalIconRegistry.d.ts","sourceRoot":"","sources":["../../src/Icon/globalIconRegistry.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAQvD;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,GACd,eAAe,GACf,OAAO,GACP,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,cAAc,GACd,MAAM,GACN,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,QAAQ,GACR,UAAU,GACV,aAAa,GACb,MAAM,GACN,aAAa,GACb,QAAQ,GACR,MAAM,GACN,YAAY,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAgC1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,GAClD,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,QAAQ,CAAC,YAAY,CAAC,CAyBxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,gBAAgB,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAOX;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,SAAS,CAQX;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}
@@ -26,6 +26,19 @@ import { warnOnce } from "../utils/devWarning.js";
26
26
  */
27
27
  // SYNC: packages/cli/assets/docs/icons.doc.mjs — update USAGE_HINTS when adding names
28
28
 
29
+ /**
30
+ * A namespaced extension key, `'<namespace>:<name>'`.
31
+ *
32
+ * This is the tier for a glyph that belongs to one component or library rather
33
+ * than to the system: `'richtext:bold'`, `'numberInput:stepperDown'`. A theme
34
+ * overrides it by key through `registerIcons` or `defineTheme({icons})`,
35
+ * exactly as it overrides a built-in name, and the core {@link IconName} union
36
+ * stays reserved for glyphs the whole system shares.
37
+ *
38
+ * Accepted anywhere a built-in name is, including `<Icon icon>` — which is
39
+ * what lets a namespaced glyph keep `size`, `color` and `xstyle`.
40
+ */
41
+
29
42
  /**
30
43
  * A semantic icon name — either one of the built-in {@link IconName}s or an
31
44
  * arbitrary string key contributed by a library/app.
@@ -45,6 +58,16 @@ import { warnOnce } from "../utils/devWarning.js";
45
58
  // =============================================================================
46
59
 
47
60
  let globalRegistry = {};
61
+
62
+ /**
63
+ * A key is namespaced when it carries a `<namespace>:` prefix — the runtime
64
+ * form of {@link NamespacedIconName}, which is how the typed
65
+ * {@link getIconRegistry} snapshot tells a built-in name from a component- or
66
+ * library-owned one.
67
+ */
68
+ function isNamespacedKey(name) {
69
+ return name.includes(':');
70
+ }
48
71
  function getThemeIconOverrides(source) {
49
72
  if (source == null) {
50
73
  return null;
@@ -95,19 +118,24 @@ export function registerIcons(icons) {
95
118
  * resolves against.
96
119
  */
97
120
  export function getIconRegistry(source) {
98
- const registry = {
99
- ...defaultIcons
100
- };
121
+ const registry = {};
101
122
 
102
- // Only surface built-in IconName keys here — extension keys registered by
103
- // libraries are resolved via getIcon/getExtendedIcon and intentionally kept
104
- // out of the typed IconRegistry snapshot.
123
+ // Only surface built-in IconName keys here — namespaced keys, whether
124
+ // contributed by a library or shipped as a component's own default, are
125
+ // resolved via getIcon/getExtendedIcon and intentionally kept out of the
126
+ // typed IconRegistry snapshot.
105
127
  for (const name of Object.keys(defaultIcons)) {
128
+ if (isNamespacedKey(name)) {
129
+ continue;
130
+ }
106
131
  registry[name] = globalRegistry[name] ?? defaultIcons[name];
107
132
  }
108
133
  const themeIcons = getThemeIconOverrides(source);
109
134
  if (themeIcons != null) {
110
135
  for (const name of Object.keys(themeIcons)) {
136
+ if (isNamespacedKey(name)) {
137
+ continue;
138
+ }
111
139
  registry[name] = themeIcons[name] ?? registry[name];
112
140
  }
113
141
  }
@@ -10,5 +10,5 @@ export { Icon, renderIconSlot } from './Icon';
10
10
  export { useIcon } from './useIcon';
11
11
  export type { IconProps, IconColor, IconSize, IconType } from './Icon';
12
12
  export { registerIcons, getIconRegistry, getIcon, getExtendedIcon, resetIcons, } from './globalIconRegistry';
13
- export type { IconName, ExtendedIconName, IconRegistry, IconRegistrySource, } from './globalIconRegistry';
13
+ export type { IconName, ExtendedIconName, NamespacedIconName, IconRegistry, IconRegistrySource, } from './globalIconRegistry';
14
14
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Icon/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,YAAY,EAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGrE,OAAO,EACL,aAAa,EACb,eAAe,EACf,OAAO,EACP,eAAe,EACf,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Icon/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,YAAY,EAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGrE,OAAO,EACL,aAAa,EACb,eAAe,EACf,OAAO,EACP,eAAe,EACf,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}
@@ -5,10 +5,13 @@
5
5
  * @position Client hook for components that render registry icons directly
6
6
  */
7
7
  import type { ReactNode } from 'react';
8
- import { type IconName } from './globalIconRegistry';
8
+ import { type IconName, type NamespacedIconName } from './globalIconRegistry';
9
9
  /**
10
10
  * Resolve a semantic icon name from the nearest Theme, falling back through
11
11
  * root theme registration, global icon overrides, and built-in defaults.
12
+ *
13
+ * Accepts a namespaced extension key (`'richtext:bold'`) as well as a built-in
14
+ * name; both resolve through the same registry.
12
15
  */
13
- export declare function useIcon(name: IconName): ReactNode;
16
+ export declare function useIcon(name: IconName | NamespacedIconName): ReactNode;
14
17
  //# sourceMappingURL=useIcon.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"useIcon.d.ts","sourceRoot":"","sources":["../../src/Icon/useIcon.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,EAAU,KAAK,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAGjD"}
1
+ {"version":3,"file":"useIcon.d.ts","sourceRoot":"","sources":["../../src/Icon/useIcon.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAGtE"}
@@ -14,6 +14,9 @@ import { getIcon } from "./globalIconRegistry.js";
14
14
  /**
15
15
  * Resolve a semantic icon name from the nearest Theme, falling back through
16
16
  * root theme registration, global icon overrides, and built-in defaults.
17
+ *
18
+ * Accepts a namespaced extension key (`'richtext:bold'`) as well as a built-in
19
+ * name; both resolve through the same registry.
17
20
  */
18
21
  export function useIcon(name) {
19
22
  const themeName = useThemeName();
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Identifies the user gesture in flight. Two reads returning the same value
3
+ * happened within one press (or one keystroke).
4
+ */
5
+ export declare function currentGesture(): number;
6
+ /** Whether the click belonging to the current gesture already bubbled. */
7
+ export declare function currentGestureHasClicked(): boolean;
8
+ //# sourceMappingURL=gestureCounter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gestureCounter.d.ts","sourceRoot":"","sources":["../../src/Layer/gestureCounter.ts"],"names":[],"mappings":"AA2CA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD"}