@deephaven/components 0.73.1-beta.0 → 0.74.1-beta.1

package/dist/spectrum/picker/PickerNormalized.js

@@ -0,0 +1,88 @@
+var _excluded = ["normalizedItems", "tooltip", "selectedKey", "defaultSelectedKey", "disabledKeys", "UNSAFE_className", "getInitialScrollPosition", "onChange", "onOpenChange", "onScroll", "onSelectionChange"];
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import { useMemo } from 'react';
+import { Picker as SpectrumPicker } from '@adobe/react-spectrum';
+import cl from 'classnames';
+import { EMPTY_FUNCTION } from '@deephaven/utils';
+import { Section } from "../shared.js";
+import { getItemKey, isNormalizedSection, normalizeTooltipOptions, useRenderNormalizedItem, useStringifiedSelection } from "../utils/index.js";
+import usePickerScrollOnOpen from "./usePickerScrollOnOpen.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Picker that takes an array of `NormalizedItem` or `NormalizedSection` items
+ * as children and uses a render item function to render the items. This is
+ * necessary to support windowed data.
+ */
+export function PickerNormalized(_ref) {
+  var {
+      normalizedItems,
+      tooltip = true,
+      selectedKey,
+      defaultSelectedKey,
+      disabledKeys,
+      UNSAFE_className,
+      getInitialScrollPosition,
+      onChange,
+      onOpenChange,
+      onScroll = EMPTY_FUNCTION,
+      onSelectionChange
+    } = _ref,
+    props = _objectWithoutProperties(_ref, _excluded);
+  var tooltipOptions = useMemo(() => normalizeTooltipOptions(tooltip), [tooltip]);
+  var renderNormalizedItem = useRenderNormalizedItem(tooltipOptions);
+  var {
+    ref: scrollRef,
+    onOpenChange: onOpenChangeInternal
+  } = usePickerScrollOnOpen({
+    getInitialScrollPosition,
+    onScroll,
+    onOpenChange
+  });
+
+  // Spectrum Picker treats keys as strings if the `key` prop is explicitly
+  // set on `Item` elements. Since we do this in `renderItem`, we need to
+  // map original key types to and from strings so that selection works.
+  var {
+    selectedStringKey,
+    defaultSelectedStringKey,
+    disabledStringKeys,
+    onStringSelectionChange
+  } = useStringifiedSelection({
+    normalizedItems,
+    selectedKey,
+    defaultSelectedKey,
+    disabledKeys,
+    onChange: onChange !== null && onChange !== void 0 ? onChange : onSelectionChange
+  });
+  return /*#__PURE__*/_jsx(SpectrumPicker
+  // eslint-disable-next-line react/jsx-props-no-spreading
+  , _objectSpread(_objectSpread({}, props), {}, {
+    ref: scrollRef,
+    UNSAFE_className: cl('dh-picker', 'dh-picker-normalized', UNSAFE_className),
+    items: normalizedItems,
+    selectedKey: selectedStringKey,
+    defaultSelectedKey: defaultSelectedStringKey,
+    disabledKeys: disabledStringKeys,
+    onSelectionChange: onStringSelectionChange,
+    onOpenChange: onOpenChangeInternal,
+    children: itemOrSection => {
+      if (isNormalizedSection(itemOrSection)) {
+        var _itemOrSection$item, _itemOrSection$item2;
+        return /*#__PURE__*/_jsx(Section, {
+          title: (_itemOrSection$item = itemOrSection.item) === null || _itemOrSection$item === void 0 ? void 0 : _itemOrSection$item.title,
+          items: (_itemOrSection$item2 = itemOrSection.item) === null || _itemOrSection$item2 === void 0 ? void 0 : _itemOrSection$item2.items,
+          children: renderNormalizedItem
+        }, getItemKey(itemOrSection));
+      }
+      return renderNormalizedItem(itemOrSection);
+    }
+  }));
+}
+export default PickerNormalized;
+//# sourceMappingURL=PickerNormalized.js.map

package/dist/spectrum/picker/PickerNormalized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickerNormalized.js","names":["useMemo","Picker","SpectrumPicker","cl","EMPTY_FUNCTION","Section","getItemKey","isNormalizedSection","normalizeTooltipOptions","useRenderNormalizedItem","useStringifiedSelection","usePickerScrollOnOpen","jsx","_jsx","PickerNormalized","_ref","normalizedItems","tooltip","selectedKey","defaultSelectedKey","disabledKeys","UNSAFE_className","getInitialScrollPosition","onChange","onOpenChange","onScroll","onSelectionChange","props","_objectWithoutProperties","_excluded","tooltipOptions","renderNormalizedItem","ref","scrollRef","onOpenChangeInternal","selectedStringKey","defaultSelectedStringKey","disabledStringKeys","onStringSelectionChange","_objectSpread","items","children","itemOrSection","_itemOrSection$item","_itemOrSection$item2","title","item"],"sources":["../../../src/spectrum/picker/PickerNormalized.tsx"],"sourcesContent":["import { useMemo } from 'react';\nimport { Picker as SpectrumPicker } from '@adobe/react-spectrum';\nimport type { DOMRef } from '@react-types/shared';\nimport cl from 'classnames';\nimport { EMPTY_FUNCTION } from '@deephaven/utils';\nimport { Section } from '../shared';\nimport type { PickerProps as PickerBaseProps } from './Picker';\n\nimport {\n  getItemKey,\n  isNormalizedSection,\n  NormalizedItem,\n  NormalizedSection,\n  normalizeTooltipOptions,\n  useRenderNormalizedItem,\n  useStringifiedSelection,\n} from '../utils';\nimport usePickerScrollOnOpen from './usePickerScrollOnOpen';\n\nexport interface PickerNormalizedProps\n  extends Omit<PickerBaseProps, 'children'> {\n  normalizedItems: (NormalizedItem | NormalizedSection)[];\n  getInitialScrollPosition?: () => Promise<number | null | undefined>;\n  onScroll?: (event: Event) => void;\n}\n\n/**\n * Picker that takes an array of `NormalizedItem` or `NormalizedSection` items\n * as children and uses a render item function to render the items. This is\n * necessary to support windowed data.\n */\nexport function PickerNormalized({\n  normalizedItems,\n  tooltip = true,\n  selectedKey,\n  defaultSelectedKey,\n  disabledKeys,\n  UNSAFE_className,\n  getInitialScrollPosition,\n  onChange,\n  onOpenChange,\n  onScroll = EMPTY_FUNCTION,\n  onSelectionChange,\n  ...props\n}: PickerNormalizedProps): JSX.Element {\n  const tooltipOptions = useMemo(\n    () => normalizeTooltipOptions(tooltip),\n    [tooltip]\n  );\n\n  const renderNormalizedItem = useRenderNormalizedItem(tooltipOptions);\n\n  const { ref: scrollRef, onOpenChange: onOpenChangeInternal } =\n    usePickerScrollOnOpen({\n      getInitialScrollPosition,\n      onScroll,\n      onOpenChange,\n    });\n\n  // Spectrum Picker treats keys as strings if the `key` prop is explicitly\n  // set on `Item` elements. Since we do this in `renderItem`, we need to\n  // map original key types to and from strings so that selection works.\n  const {\n    selectedStringKey,\n    defaultSelectedStringKey,\n    disabledStringKeys,\n    onStringSelectionChange,\n  } = useStringifiedSelection({\n    normalizedItems,\n    selectedKey,\n    defaultSelectedKey,\n    disabledKeys,\n    onChange: onChange ?? onSelectionChange,\n  });\n\n  return (\n    <SpectrumPicker\n      // eslint-disable-next-line react/jsx-props-no-spreading\n      {...props}\n      ref={scrollRef as DOMRef<HTMLDivElement>}\n      UNSAFE_className={cl(\n        'dh-picker',\n        'dh-picker-normalized',\n        UNSAFE_className\n      )}\n      items={normalizedItems}\n      selectedKey={selectedStringKey}\n      defaultSelectedKey={defaultSelectedStringKey}\n      disabledKeys={disabledStringKeys}\n      onSelectionChange={onStringSelectionChange}\n      onOpenChange={onOpenChangeInternal}\n    >\n      {itemOrSection => {\n        if (isNormalizedSection(itemOrSection)) {\n          return (\n            <Section\n              key={getItemKey(itemOrSection)}\n              title={itemOrSection.item?.title}\n              items={itemOrSection.item?.items}\n            >\n              {renderNormalizedItem}\n            </Section>\n          );\n        }\n\n        return renderNormalizedItem(itemOrSection);\n      }}\n    </SpectrumPicker>\n  );\n}\n\nexport default PickerNormalized;\n"],"mappings":";;;;;;;;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,MAAM,IAAIC,cAAc,QAAQ,uBAAuB;AAEhE,OAAOC,EAAE,MAAM,YAAY;AAC3B,SAASC,cAAc,QAAQ,kBAAkB;AAAC,SACzCC,OAAO;AAAA,SAIdC,UAAU,EACVC,mBAAmB,EAGnBC,uBAAuB,EACvBC,uBAAuB,EACvBC,uBAAuB;AAAA,OAElBC,qBAAqB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAS5B;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAAC,IAAA,EAaO;EAAA,IAbN;MAC/BC,eAAe;MACfC,OAAO,GAAG,IAAI;MACdC,WAAW;MACXC,kBAAkB;MAClBC,YAAY;MACZC,gBAAgB;MAChBC,wBAAwB;MACxBC,QAAQ;MACRC,YAAY;MACZC,QAAQ,GAAGrB,cAAc;MACzBsB;IAEqB,CAAC,GAAAX,IAAA;IADnBY,KAAK,GAAAC,wBAAA,CAAAb,IAAA,EAAAc,SAAA;EAER,IAAMC,cAAc,GAAG9B,OAAO,CAC5B,MAAMQ,uBAAuB,CAACS,OAAO,CAAC,EACtC,CAACA,OAAO,CACV,CAAC;EAED,IAAMc,oBAAoB,GAAGtB,uBAAuB,CAACqB,cAAc,CAAC;EAEpE,IAAM;IAAEE,GAAG,EAAEC,SAAS;IAAET,YAAY,EAAEU;EAAqB,CAAC,GAC1DvB,qBAAqB,CAAC;IACpBW,wBAAwB;IACxBG,QAAQ;IACRD;EACF,CAAC,CAAC;;EAEJ;EACA;EACA;EACA,IAAM;IACJW,iBAAiB;IACjBC,wBAAwB;IACxBC,kBAAkB;IAClBC;EACF,CAAC,GAAG5B,uBAAuB,CAAC;IAC1BM,eAAe;IACfE,WAAW;IACXC,kBAAkB;IAClBC,YAAY;IACZG,QAAQ,EAAEA,QAAQ,aAARA,QAAQ,cAARA,QAAQ,GAAIG;EACxB,CAAC,CAAC;EAEF,oBACEb,IAAA,CAACX;EACC;EAAA,EAAAqC,aAAA,CAAAA,aAAA,KACIZ,KAAK;IACTK,GAAG,EAAEC,SAAoC;IACzCZ,gBAAgB,EAAElB,EAAE,CAClB,WAAW,EACX,sBAAsB,EACtBkB,gBACF,CAAE;IACFmB,KAAK,EAAExB,eAAgB;IACvBE,WAAW,EAAEiB,iBAAkB;IAC/BhB,kBAAkB,EAAEiB,wBAAyB;IAC7ChB,YAAY,EAAEiB,kBAAmB;IACjCX,iBAAiB,EAAEY,uBAAwB;IAC3Cd,YAAY,EAAEU,oBAAqB;IAAAO,QAAA,EAElCC,aAAa,IAAI;MAChB,IAAInC,mBAAmB,CAACmC,aAAa,CAAC,EAAE;QAAA,IAAAC,mBAAA,EAAAC,oBAAA;QACtC,oBACE/B,IAAA,CAACR,OAAO;UAENwC,KAAK,GAAAF,mBAAA,GAAED,aAAa,CAACI,IAAI,cAAAH,mBAAA,uBAAlBA,mBAAA,CAAoBE,KAAM;UACjCL,KAAK,GAAAI,oBAAA,GAAEF,aAAa,CAACI,IAAI,cAAAF,oBAAA,uBAAlBA,oBAAA,CAAoBJ,KAAM;UAAAC,QAAA,EAEhCV;QAAoB,GAJhBzB,UAAU,CAACoC,aAAa,CAKtB,CAAC;MAEd;MAEA,OAAOX,oBAAoB,CAACW,aAAa,CAAC;IAC5C;EAAC,EACa,CAAC;AAErB;AAEA,eAAe5B,gBAAgB"}

package/dist/spectrum/picker/index.d.ts

@@ -1,2 +1,4 @@
 export * from './Picker';
+export * from './PickerNormalized';
+export * from './usePickerScrollOnOpen';
 //# sourceMappingURL=index.d.ts.map

package/dist/spectrum/picker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spectrum/picker/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spectrum/picker/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/spectrum/picker/index.js

@@ -1,2 +1,4 @@
 export * from "./Picker.js";
+export * from "./PickerNormalized.js";
+export * from "./usePickerScrollOnOpen.js";
 //# sourceMappingURL=index.js.map

package/dist/spectrum/picker/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/spectrum/picker/index.ts"],"sourcesContent":["export * from './Picker';\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/spectrum/picker/index.ts"],"sourcesContent":["export * from './Picker';\nexport * from './PickerNormalized';\nexport * from './usePickerScrollOnOpen';\n"],"mappings":""}

package/dist/spectrum/picker/usePickerScrollOnOpen.d.ts

@@ -0,0 +1,22 @@
+import type { DOMRef } from '@react-types/shared';
+export interface UsePickerScrollOnOpenOptions {
+    getInitialScrollPosition?: () => Promise<number | null | undefined>;
+    onScroll: (event: Event) => void;
+    onOpenChange?: (isOpen: boolean) => void;
+}
+export interface UsePickerScrollOnOpenResult {
+    ref: DOMRef<HTMLElement>;
+    onOpenChange: (isOpen: boolean) => void;
+}
+/**
+ * Handle scroll event registration and scrolling to initial scroll position
+ * whenever a Picker popover is opened.
+ * @param getInitialScrollPosition Function to get the initial scroll position.
+ * @param onScroll Callback for scroll events.
+ * @param onOpenChange Callback for open change events.
+ * @return A ref to attach to the Picker and a callback to handle open change
+ * events for the Picker.
+ */
+export declare function usePickerScrollOnOpen({ getInitialScrollPosition, onScroll, onOpenChange, }: UsePickerScrollOnOpenOptions): UsePickerScrollOnOpenResult;
+export default usePickerScrollOnOpen;
+//# sourceMappingURL=usePickerScrollOnOpen.d.ts.map

package/dist/spectrum/picker/usePickerScrollOnOpen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePickerScrollOnOpen.d.ts","sourceRoot":"","sources":["../../../src/spectrum/picker/usePickerScrollOnOpen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD,MAAM,WAAW,4BAA4B;IAC3C,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACpE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,wBAAwB,EACxB,QAAQ,EACR,YAAY,GACb,EAAE,4BAA4B,GAAG,2BAA2B,CAqB5D;AAED,eAAe,qBAAqB,CAAC"}

package/dist/spectrum/picker/usePickerScrollOnOpen.js

@@ -0,0 +1,33 @@
+import { useCallback } from 'react';
+import { findSpectrumPickerScrollArea, usePopoverOnScrollRef } from '@deephaven/react-hooks';
+/**
+ * Handle scroll event registration and scrolling to initial scroll position
+ * whenever a Picker popover is opened.
+ * @param getInitialScrollPosition Function to get the initial scroll position.
+ * @param onScroll Callback for scroll events.
+ * @param onOpenChange Callback for open change events.
+ * @return A ref to attach to the Picker and a callback to handle open change
+ * events for the Picker.
+ */
+export function usePickerScrollOnOpen(_ref) {
+  var {
+    getInitialScrollPosition,
+    onScroll,
+    onOpenChange
+  } = _ref;
+  var {
+    ref,
+    onOpenChange: popoverOnOpenChange
+  } = usePopoverOnScrollRef(findSpectrumPickerScrollArea, onScroll, getInitialScrollPosition);
+  var onOpenChangeInternal = useCallback(isOpen => {
+    // Attach scroll event handling
+    popoverOnOpenChange(isOpen);
+    onOpenChange === null || onOpenChange === void 0 ? void 0 : onOpenChange(isOpen);
+  }, [onOpenChange, popoverOnOpenChange]);
+  return {
+    ref,
+    onOpenChange: onOpenChangeInternal
+  };
+}
+export default usePickerScrollOnOpen;
+//# sourceMappingURL=usePickerScrollOnOpen.js.map

package/dist/spectrum/picker/usePickerScrollOnOpen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePickerScrollOnOpen.js","names":["useCallback","findSpectrumPickerScrollArea","usePopoverOnScrollRef","usePickerScrollOnOpen","_ref","getInitialScrollPosition","onScroll","onOpenChange","ref","popoverOnOpenChange","onOpenChangeInternal","isOpen"],"sources":["../../../src/spectrum/picker/usePickerScrollOnOpen.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport type { DOMRef } from '@react-types/shared';\nimport {\n  findSpectrumPickerScrollArea,\n  usePopoverOnScrollRef,\n} from '@deephaven/react-hooks';\n\nexport interface UsePickerScrollOnOpenOptions {\n  getInitialScrollPosition?: () => Promise<number | null | undefined>;\n  onScroll: (event: Event) => void;\n  onOpenChange?: (isOpen: boolean) => void;\n}\n\nexport interface UsePickerScrollOnOpenResult {\n  ref: DOMRef<HTMLElement>;\n  onOpenChange: (isOpen: boolean) => void;\n}\n\n/**\n * Handle scroll event registration and scrolling to initial scroll position\n * whenever a Picker popover is opened.\n * @param getInitialScrollPosition Function to get the initial scroll position.\n * @param onScroll Callback for scroll events.\n * @param onOpenChange Callback for open change events.\n * @return A ref to attach to the Picker and a callback to handle open change\n * events for the Picker.\n */\nexport function usePickerScrollOnOpen({\n  getInitialScrollPosition,\n  onScroll,\n  onOpenChange,\n}: UsePickerScrollOnOpenOptions): UsePickerScrollOnOpenResult {\n  const { ref, onOpenChange: popoverOnOpenChange } = usePopoverOnScrollRef(\n    findSpectrumPickerScrollArea,\n    onScroll,\n    getInitialScrollPosition\n  );\n\n  const onOpenChangeInternal = useCallback(\n    (isOpen: boolean): void => {\n      // Attach scroll event handling\n      popoverOnOpenChange(isOpen);\n\n      onOpenChange?.(isOpen);\n    },\n    [onOpenChange, popoverOnOpenChange]\n  );\n\n  return {\n    ref,\n    onOpenChange: onOpenChangeInternal,\n  };\n}\n\nexport default usePickerScrollOnOpen;\n"],"mappings":"AAAA,SAASA,WAAW,QAAQ,OAAO;AAEnC,SACEC,4BAA4B,EAC5BC,qBAAqB,QAChB,wBAAwB;AAa/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAAC,IAAA,EAIyB;EAAA,IAJxB;IACpCC,wBAAwB;IACxBC,QAAQ;IACRC;EAC4B,CAAC,GAAAH,IAAA;EAC7B,IAAM;IAAEI,GAAG;IAAED,YAAY,EAAEE;EAAoB,CAAC,GAAGP,qBAAqB,CACtED,4BAA4B,EAC5BK,QAAQ,EACRD,wBACF,CAAC;EAED,IAAMK,oBAAoB,GAAGV,WAAW,CACrCW,MAAe,IAAW;IACzB;IACAF,mBAAmB,CAACE,MAAM,CAAC;IAE3BJ,YAAY,aAAZA,YAAY,uBAAZA,YAAY,CAAGI,MAAM,CAAC;EACxB,CAAC,EACD,CAACJ,YAAY,EAAEE,mBAAmB,CACpC,CAAC;EAED,OAAO;IACLD,GAAG;IACHD,YAAY,EAAEG;EAChB,CAAC;AACH;AAEA,eAAeP,qBAAqB"}

package/dist/spectrum/utils/index.d.ts

@@ -1,5 +1,7 @@
 export * from './itemUtils';
+export * from './itemWrapperUtils';
 export * from './themeUtils';
 export * from './useRenderNormalizedItem';
 export * from './useStringifiedMultiSelection';
+export * from './useStringifiedSelection';
 //# sourceMappingURL=index.d.ts.map

package/dist/spectrum/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}

package/dist/spectrum/utils/index.js

@@ -1,5 +1,7 @@
 export * from "./itemUtils.js";
+export * from "./itemWrapperUtils.js";
 export * from "./themeUtils.js";
 export * from "./useRenderNormalizedItem.js";
 export * from "./useStringifiedMultiSelection.js";
+export * from "./useStringifiedSelection.js";
 //# sourceMappingURL=index.js.map

package/dist/spectrum/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/spectrum/utils/index.ts"],"sourcesContent":["export * from './itemUtils';\nexport * from './themeUtils';\nexport * from './useRenderNormalizedItem';\nexport * from './useStringifiedMultiSelection';\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/spectrum/utils/index.ts"],"sourcesContent":["export * from './itemUtils';\nexport * from './itemWrapperUtils';\nexport * from './themeUtils';\nexport * from './useRenderNormalizedItem';\nexport * from './useStringifiedMultiSelection';\nexport * from './useStringifiedSelection';\n"],"mappings":""}

package/dist/spectrum/utils/itemUtils.d.ts

@@ -4,6 +4,11 @@ import type { ItemRenderer } from '@react-types/shared';
 import { KeyedItem, SelectionT } from '@deephaven/utils';
 import { ItemProps, SectionProps } from '../shared';
 import { PopperOptions } from '../../popper';
+/**
+ * `Item.textValue` prop needs to be a non-empty string for accessibility
+ * purposes. This is not displayed in the UI.
+ */
+export declare const ITEM_EMPTY_STRING_TEXT_VALUE = "Empty";
 export declare const INVALID_ITEM_ERROR_MESSAGE = "Items must be strings, numbers, booleans, <Item> or <Section> elements:";
 /**
  * React Spectrum <Section> supports an `ItemRenderer` function as a child. The
@@ -13,7 +18,7 @@ export declare const INVALID_ITEM_ERROR_MESSAGE = "Items must be strings, number
 type SectionPropsNoItemRenderer<T> = Omit<SectionProps<T>, 'children'> & {
     children: Exclude<SectionProps<T>['children'], ItemRenderer<T>>;
 };
-type ItemElement = ReactElement<ItemProps<unknown>>;
+export type ItemElement = ReactElement<ItemProps<unknown>>;
 export type SectionElement = ReactElement<SectionPropsNoItemRenderer<unknown>>;
 export type ItemElementOrPrimitive = number | string | boolean | ItemElement;
 export type ItemOrSection = ItemElementOrPrimitive | SectionElement;
@@ -33,7 +38,7 @@ export type ItemSelectionChangeHandler = (key: ItemKey) => void;
 export interface NormalizedItemData {
     key?: ItemKey;
     content: ReactNode;
-    textValue?: string;
+    textValue: string | undefined;
 }
 export interface NormalizedSectionData {
     key?: Key;
@@ -65,6 +70,20 @@ export type TooltipOptions = {
  * @returns The `key` of the item or section
  */
 export declare function getItemKey<TItem extends NormalizedItem | NormalizedSection, TKey extends TItem extends NormalizedItem ? ItemKey | undefined : TItem extends NormalizedSection ? Key | undefined : undefined>(item: TItem | null | undefined): TKey;
+/**
+ * Get the position of the item with the given selected key in a list of items.
+ * @param items The items to search
+ * @param itemHeight The height of each item
+ * @param selectedKey The key of the selected item
+ * @param topOffset The top offset of the list
+ * @returns The position of the selected item or the top offset if not found
+ */
+export declare function getPositionOfSelectedItemElement<TKey extends string | number | boolean | undefined>({ items, itemHeight, selectedKey, topOffset, }: {
+    items: ItemElement[];
+    selectedKey: TKey | null | undefined;
+    itemHeight: number;
+    topOffset: number;
+}): Promise<number>;
 /**
  * Determine if a node is a Section element.
  * @param node The node to check
@@ -77,6 +96,13 @@ export declare function isSectionElement<T>(node: ReactNode): node is ReactEleme
  * @returns True if the node is an Item element
  */
 export declare function isItemElement<T>(node: ReactNode): node is ReactElement<ItemProps<T>>;
+/**
+ * Determine if a node is an Item element containing a child `Text` element with
+ * a `slot` prop set to `description`.
+ * @param node The node to check
+ * @returns True if the node is an Item element with a description
+ */
+export declare function isItemElementWithDescription<T>(node: ReactNode): node is ReactElement<ItemProps<T>>;
 /**
  * Determine if a node is an array containing normalized items or sections with
  * keys. Note that this only checks the first node in the array.
@@ -116,6 +142,6 @@ export declare function normalizeTooltipOptions(options?: boolean | TooltipOptio
  * @param itemKeys The selection of `ItemKey`s
  * @returns The selection of strings
  */
-export declare function itemSelectionToStringSet(itemKeys?: 'all' | Iterable<ItemKey>): undefined | 'all' | Set<string>;
+export declare function itemSelectionToStringSet<TKeys extends 'all' | Iterable<ItemKey> | undefined, TResult extends TKeys extends 'all' ? 'all' : TKeys extends Iterable<ItemKey> ? Set<string> : undefined>(itemKeys: TKeys): TResult;
 export {};
 //# sourceMappingURL=itemUtils.d.ts.map

package/dist/spectrum/utils/itemUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"itemUtils.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/itemUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"itemUtils.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/itemUtils.ts"],"names":[],"mappings":"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"}

package/dist/spectrum/utils/itemUtils.js

@@ -1,7 +1,17 @@
-import { isValidElement } from 'react';
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
 import Log from '@deephaven/log';
+import { isElementOfType } from '@deephaven/react-hooks';
 import { Item, Section } from "../shared.js";
+import { Text } from "../Text.js";
+import ItemContent from "../ItemContent.js";
 var log = Log.module('itemUtils');
+
+/**
+ * `Item.textValue` prop needs to be a non-empty string for accessibility
+ * purposes. This is not displayed in the UI.
+ */
+export var ITEM_EMPTY_STRING_TEXT_VALUE = 'Empty';
 export var INVALID_ITEM_ERROR_MESSAGE = 'Items must be strings, numbers, booleans, <Item> or <Section> elements:';
 
 /**
@@ -45,13 +55,48 @@ export function getItemKey(item) {
   return (_item$item$key = item === null || item === void 0 ? void 0 : (_item$item = item.item) === null || _item$item === void 0 ? void 0 : _item$item.key) !== null && _item$item$key !== void 0 ? _item$item$key : item === null || item === void 0 ? void 0 : item.key;
 }
 
+/**
+ * Get the position of the item with the given selected key in a list of items.
+ * @param items The items to search
+ * @param itemHeight The height of each item
+ * @param selectedKey The key of the selected item
+ * @param topOffset The top offset of the list
+ * @returns The position of the selected item or the top offset if not found
+ */
+export function getPositionOfSelectedItemElement(_x) {
+  return _getPositionOfSelectedItemElement.apply(this, arguments);
+}
+
 /**
  * Determine if a node is a Section element.
  * @param node The node to check
  * @returns True if the node is a Section element
  */
+function _getPositionOfSelectedItemElement() {
+  _getPositionOfSelectedItemElement = _asyncToGenerator(function* (_ref) {
+    var {
+      items,
+      itemHeight,
+      selectedKey,
+      topOffset
+    } = _ref;
+    var position = topOffset;
+    if (selectedKey == null) {
+      return position;
+    }
+    for (var i = 0; i < items.length; i += 1) {
+      var _item = items[i];
+      if (_item.key === selectedKey) {
+        return position;
+      }
+      position += itemHeight;
+    }
+    return topOffset;
+  });
+  return _getPositionOfSelectedItemElement.apply(this, arguments);
+}
 export function isSectionElement(node) {
-  return /*#__PURE__*/isValidElement(node) && node.type === Section;
+  return isElementOfType(node, Section);
 }
 
 /**
@@ -60,7 +105,28 @@ export function isSectionElement(node) {
  * @returns True if the node is an Item element
  */
 export function isItemElement(node) {
-  return /*#__PURE__*/isValidElement(node) && node.type === Item;
+  return isElementOfType(node, Item);
+}
+
+/**
+ * Determine if a node is an Item element containing a child `Text` element with
+ * a `slot` prop set to `description`.
+ * @param node The node to check
+ * @returns True if the node is an Item element with a description
+ */
+export function isItemElementWithDescription(node) {
+  if (!isItemElement(node)) {
+    return false;
+  }
+
+  // If children are wrapped in `ItemContent`, go down 1 level
+  var children = isElementOfType(node.props.children, ItemContent) ? node.props.children.props.children : node.props.children;
+  var childrenArray = Array.isArray(children) ? children : [children];
+  var result = childrenArray.some(child => {
+    var _child$props;
+    return ((_child$props = child.props) === null || _child$props === void 0 ? void 0 : _child$props.slot) === 'description' && isElementOfType(child, Text);
+  });
+  return result;
 }
 
 /**

package/dist/spectrum/utils/itemUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"itemUtils.js","names":["isValidElement","Log","Item","Section","log","module","INVALID_ITEM_ERROR_MESSAGE","getItemKey","item","_item$item$key","_item$item","key","isSectionElement","node","type","isItemElement","isNormalizedItemsWithKeysList","Array","isArray","length","isItemOrSection","isNormalizedSection","maybeNormalizedSection","normalizeItemKey","itemOrSection","_itemOrSection$props$","props","title","undefined","textValue","children","normalizeTextValue","String","normalizeItem","debug","Error","items","normalizeItemList","filter","childItem","content","itemsOrSections","itemsArray","map","normalizeTooltipOptions","options","placement","arguments","itemSelectionToStringSet","itemKeys","Set"],"sources":["../../../src/spectrum/utils/itemUtils.ts"],"sourcesContent":["import { isValidElement, Key, ReactElement, ReactNode } from 'react';\nimport { SpectrumPickerProps } from '@adobe/react-spectrum';\nimport type { ItemRenderer } from '@react-types/shared';\nimport Log from '@deephaven/log';\nimport { KeyedItem, SelectionT } from '@deephaven/utils';\nimport { Item, ItemProps, Section, SectionProps } from '../shared';\nimport { PopperOptions } from '../../popper';\n\nconst log = Log.module('itemUtils');\n\nexport const INVALID_ITEM_ERROR_MESSAGE =\n  'Items must be strings, numbers, booleans, <Item> or <Section> elements:';\n\n/**\n * React Spectrum <Section> supports an `ItemRenderer` function as a child. The\n * DH picker makes use of this internally, but we don't want to support it as\n * an incoming prop.\n */\ntype SectionPropsNoItemRenderer<T> = Omit<SectionProps<T>, 'children'> & {\n  children: Exclude<SectionProps<T>['children'], ItemRenderer<T>>;\n};\n\ntype ItemElement = ReactElement<ItemProps<unknown>>;\nexport type SectionElement = ReactElement<SectionPropsNoItemRenderer<unknown>>;\n\nexport type ItemElementOrPrimitive = number | string | boolean | ItemElement;\nexport type ItemOrSection = ItemElementOrPrimitive | SectionElement;\n\n/**\n * Augment the Spectrum selection key type to include boolean values.\n * Spectrum collection components already supports this, but the built in types\n * don't reflect it.\n */\nexport type ItemKey = Key | boolean;\n\nexport type ItemSelection = SelectionT<ItemKey>;\n\n/**\n * Augment the Spectrum selection change handler type to include boolean keys.\n * Spectrum components already supports this, but the built in types don't\n * reflect it.\n */\nexport type ItemSelectionChangeHandler = (key: ItemKey) => void;\n\nexport interface NormalizedItemData {\n  key?: ItemKey;\n  content: ReactNode;\n  textValue?: string;\n}\n\nexport interface NormalizedSectionData {\n  key?: Key;\n  title?: ReactNode;\n  items: NormalizedItem[];\n}\n\n/**\n * Spectrum collection components support a variety of item types, including\n * strings, numbers, booleans, and more complex React elements. This type\n * represents a normalized form to make rendering items simpler and keep the\n * logic of transformation in separate util methods. It also adheres to the\n * `KeyedItem` interface to be compatible with Windowed data utils\n * (e.g. `useViewportData`).\n */\nexport type NormalizedItem = KeyedItem<NormalizedItemData, ItemKey | undefined>;\n\nexport type NormalizedSection = KeyedItem<\n  NormalizedSectionData,\n  Key | undefined\n>;\n\nexport type NormalizedItemOrSection<TItemOrSection extends ItemOrSection> =\n  TItemOrSection extends SectionElement ? NormalizedSection : NormalizedItem;\n\nexport type NormalizedSpectrumPickerProps = SpectrumPickerProps<NormalizedItem>;\n\nexport type TooltipOptions = { placement: PopperOptions['placement'] };\n\n/**\n * DH wrappers of Spectrum collection components use a normalized item that\n * includes a `key` prop and an optional `item` prop. This is mostly to support\n * Windowed data where items are created before their data has been loaded (data\n * gets set in the `item` prop). If data has loaded, return its `key`. If not,\n * return the top-level `key` on the normalized item.\n * @param item The normalized item or section\n * @returns The `key` of the item or section\n */\nexport function getItemKey<\n  TItem extends NormalizedItem | NormalizedSection,\n  TKey extends TItem extends NormalizedItem\n    ? ItemKey | undefined\n    : TItem extends NormalizedSection\n    ? Key | undefined\n    : undefined,\n>(item: TItem | null | undefined): TKey {\n  return (item?.item?.key ?? item?.key) as TKey;\n}\n\n/**\n * Determine if a node is a Section element.\n * @param node The node to check\n * @returns True if the node is a Section element\n */\nexport function isSectionElement<T>(\n  node: ReactNode\n): node is ReactElement<SectionProps<T>> {\n  return isValidElement<SectionProps<T>>(node) && node.type === Section;\n}\n\n/**\n * Determine if a node is an Item element.\n * @param node The node to check\n * @returns True if the node is an Item element\n */\nexport function isItemElement<T>(\n  node: ReactNode\n): node is ReactElement<ItemProps<T>> {\n  return isValidElement<ItemProps<T>>(node) && node.type === Item;\n}\n\n/**\n * Determine if a node is an array containing normalized items or sections with\n * keys. Note that this only checks the first node in the array.\n * @param node The node to check\n * @returns True if the node is a normalized item or section with keys array\n */\nexport function isNormalizedItemsWithKeysList<\n  TItemOrSection extends ItemOrSection,\n>(\n  node:\n    | TItemOrSection\n    | TItemOrSection[]\n    | NormalizedItemOrSection<TItemOrSection>[]\n): node is NormalizedItemOrSection<TItemOrSection>[] {\n  if (!Array.isArray(node)) {\n    return false;\n  }\n\n  if (node.length === 0) {\n    return true;\n  }\n\n  return !isItemOrSection(node[0]) && 'key' in node[0];\n}\n\n/**\n * Determine if an object is a normalized section.\n * @param maybeNormalizedSection The object to check\n * @returns True if the object is a normalized section\n */\nexport function isNormalizedSection(\n  maybeNormalizedSection: NormalizedItem | NormalizedSection\n): maybeNormalizedSection is NormalizedSection {\n  return (\n    maybeNormalizedSection.item != null &&\n    'items' in maybeNormalizedSection.item\n  );\n}\n\n/**\n * Determine if a node is an item or section. Valid types include strings,\n * numbers, booleans, Item elements, and Section elements.\n * @param node The node to check\n * @returns True if the node is an item or section\n */\nexport function isItemOrSection(node: ReactNode): node is ItemOrSection {\n  return (\n    typeof node === 'string' ||\n    typeof node === 'number' ||\n    typeof node === 'boolean' ||\n    isItemElement(node) ||\n    isSectionElement(node)\n  );\n}\n\n/**\n * Determine the `key` of an item or section.\n * @param itemOrSection The item or section\n * @returns A `ItemKey` for the item or undefined if a key can't be determined\n */\nfunction normalizeItemKey(item: ItemElementOrPrimitive): ItemKey | undefined;\nfunction normalizeItemKey(section: SectionElement): Key | undefined;\nfunction normalizeItemKey(\n  itemOrSection: ItemElementOrPrimitive | SectionElement\n): Key | ItemKey | undefined {\n  // string, number, or boolean\n  if (typeof itemOrSection !== 'object') {\n    return itemOrSection;\n  }\n\n  // If `key` prop is explicitly set\n  if (itemOrSection.key != null) {\n    return itemOrSection.key;\n  }\n\n  // Section element\n  if (isSectionElement(itemOrSection)) {\n    return typeof itemOrSection.props.title === 'string'\n      ? itemOrSection.props.title\n      : undefined;\n  }\n\n  // Item element\n  return (\n    itemOrSection.props.textValue ??\n    (typeof itemOrSection.props.children === 'string'\n      ? itemOrSection.props.children\n      : undefined)\n  );\n}\n\n/**\n * Get a normalized `textValue` for an item ensuring it is a string.\n * @param item The item\n * @returns A string `textValue` for the item\n */\nfunction normalizeTextValue(item: ItemElementOrPrimitive): string | undefined {\n  if (typeof item !== 'object') {\n    return String(item);\n  }\n\n  if (item.props.textValue != null) {\n    return item.props.textValue;\n  }\n\n  if (typeof item.props.children === 'string') {\n    return item.props.children;\n  }\n\n  return undefined;\n}\n\n/**\n * Normalize an item or section to an object form.\n * @param itemOrSection item to normalize\n * @returns NormalizedItem or NormalizedSection object\n */\nfunction normalizeItem<TItemOrSection extends ItemOrSection>(\n  itemOrSection: TItemOrSection\n): NormalizedItemOrSection<TItemOrSection> {\n  if (!isItemOrSection(itemOrSection)) {\n    log.debug(INVALID_ITEM_ERROR_MESSAGE, itemOrSection);\n    throw new Error(INVALID_ITEM_ERROR_MESSAGE);\n  }\n\n  if (isSectionElement(itemOrSection)) {\n    const key = normalizeItemKey(itemOrSection);\n    const { title } = itemOrSection.props;\n\n    const items = normalizeItemList(itemOrSection.props.children).filter(\n      // We don't support nested section elements\n      childItem => !isSectionElement(childItem)\n    ) as NormalizedItem[];\n\n    return {\n      item: { key, title, items },\n    } as NormalizedItemOrSection<TItemOrSection>;\n  }\n\n  const key = normalizeItemKey(itemOrSection);\n  const content = isItemElement(itemOrSection)\n    ? itemOrSection.props.children\n    : itemOrSection;\n  const textValue = normalizeTextValue(itemOrSection);\n\n  return {\n    item: { key, content, textValue },\n  } as NormalizedItemOrSection<TItemOrSection>;\n}\n\n/**\n * Normalize an item or section or a list of items or sections.\n * @param itemsOrSections An item or section or array of items or sections\n * @returns An array of normalized items or sections\n */\nexport function normalizeItemList<TItemOrSection extends ItemOrSection>(\n  itemsOrSections: TItemOrSection | TItemOrSection[] | NormalizedItem[]\n): NormalizedItemOrSection<TItemOrSection>[] {\n  // If already normalized, just return as-is\n  if (isNormalizedItemsWithKeysList(itemsOrSections)) {\n    return itemsOrSections as NormalizedItemOrSection<TItemOrSection>[];\n  }\n\n  const itemsArray: TItemOrSection[] = Array.isArray(itemsOrSections)\n    ? itemsOrSections\n    : [itemsOrSections];\n\n  return itemsArray.map(normalizeItem);\n}\n\n/**\n * Returns a TooltipOptions object or null if options is false or null.\n * @param options Tooltip options\n * @param placement Default placement for the tooltip if `options` is set\n * explicitly to `true`\n * @returns TooltipOptions or null\n */\nexport function normalizeTooltipOptions(\n  options?: boolean | TooltipOptions | null,\n  placement: TooltipOptions['placement'] = 'right'\n): TooltipOptions | null {\n  if (options == null || options === false) {\n    return null;\n  }\n\n  if (options === true) {\n    return { placement };\n  }\n\n  return options;\n}\n\n/**\n * Convert a selection of `ItemKey`s to a selection of strings.\n * @param itemKeys The selection of `ItemKey`s\n * @returns The selection of strings\n */\nexport function itemSelectionToStringSet(\n  itemKeys?: 'all' | Iterable<ItemKey>\n): undefined | 'all' | Set<string> {\n  if (itemKeys == null || itemKeys === 'all') {\n    return itemKeys as undefined | 'all';\n  }\n\n  return new Set([...itemKeys].map(String));\n}\n"],"mappings":"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"}
+{"version":3,"file":"itemUtils.js","names":["Log","isElementOfType","Item","Section","Text","ItemContent","log","module","ITEM_EMPTY_STRING_TEXT_VALUE","INVALID_ITEM_ERROR_MESSAGE","getItemKey","item","_item$item$key","_item$item","key","getPositionOfSelectedItemElement","_x","_getPositionOfSelectedItemElement","apply","arguments","_asyncToGenerator","_ref","items","itemHeight","selectedKey","topOffset","position","i","length","isSectionElement","node","isItemElement","isItemElementWithDescription","children","props","childrenArray","Array","isArray","result","some","child","_child$props","slot","isNormalizedItemsWithKeysList","isItemOrSection","isNormalizedSection","maybeNormalizedSection","normalizeItemKey","itemOrSection","_itemOrSection$props$","title","undefined","textValue","normalizeTextValue","String","normalizeItem","debug","Error","normalizeItemList","filter","childItem","content","itemsOrSections","itemsArray","map","normalizeTooltipOptions","options","placement","itemSelectionToStringSet","itemKeys","Set"],"sources":["../../../src/spectrum/utils/itemUtils.ts"],"sourcesContent":["import { Key, ReactElement, ReactNode } from 'react';\nimport { SpectrumPickerProps } from '@adobe/react-spectrum';\nimport type { ItemRenderer } from '@react-types/shared';\nimport Log from '@deephaven/log';\nimport { isElementOfType } from '@deephaven/react-hooks';\nimport { KeyedItem, SelectionT } from '@deephaven/utils';\nimport { Item, ItemProps, Section, SectionProps } from '../shared';\nimport { PopperOptions } from '../../popper';\nimport { Text } from '../Text';\nimport ItemContent from '../ItemContent';\n\nconst log = Log.module('itemUtils');\n\n/**\n * `Item.textValue` prop needs to be a non-empty string for accessibility\n * purposes. This is not displayed in the UI.\n */\nexport const ITEM_EMPTY_STRING_TEXT_VALUE = 'Empty';\n\nexport const INVALID_ITEM_ERROR_MESSAGE =\n  'Items must be strings, numbers, booleans, <Item> or <Section> elements:';\n\n/**\n * React Spectrum <Section> supports an `ItemRenderer` function as a child. The\n * DH picker makes use of this internally, but we don't want to support it as\n * an incoming prop.\n */\ntype SectionPropsNoItemRenderer<T> = Omit<SectionProps<T>, 'children'> & {\n  children: Exclude<SectionProps<T>['children'], ItemRenderer<T>>;\n};\n\nexport type ItemElement = ReactElement<ItemProps<unknown>>;\nexport type SectionElement = ReactElement<SectionPropsNoItemRenderer<unknown>>;\n\nexport type ItemElementOrPrimitive = number | string | boolean | ItemElement;\nexport type ItemOrSection = ItemElementOrPrimitive | SectionElement;\n\n/**\n * Augment the Spectrum selection key type to include boolean values.\n * Spectrum collection components already supports this, but the built in types\n * don't reflect it.\n */\nexport type ItemKey = Key | boolean;\n\nexport type ItemSelection = SelectionT<ItemKey>;\n\n/**\n * Augment the Spectrum selection change handler type to include boolean keys.\n * Spectrum components already supports this, but the built in types don't\n * reflect it.\n */\nexport type ItemSelectionChangeHandler = (key: ItemKey) => void;\n\nexport interface NormalizedItemData {\n  key?: ItemKey;\n  content: ReactNode;\n  textValue: string | undefined;\n}\n\nexport interface NormalizedSectionData {\n  key?: Key;\n  title?: ReactNode;\n  items: NormalizedItem[];\n}\n\n/**\n * Spectrum collection components support a variety of item types, including\n * strings, numbers, booleans, and more complex React elements. This type\n * represents a normalized form to make rendering items simpler and keep the\n * logic of transformation in separate util methods. It also adheres to the\n * `KeyedItem` interface to be compatible with Windowed data utils\n * (e.g. `useViewportData`).\n */\nexport type NormalizedItem = KeyedItem<NormalizedItemData, ItemKey | undefined>;\n\nexport type NormalizedSection = KeyedItem<\n  NormalizedSectionData,\n  Key | undefined\n>;\n\nexport type NormalizedItemOrSection<TItemOrSection extends ItemOrSection> =\n  TItemOrSection extends SectionElement ? NormalizedSection : NormalizedItem;\n\nexport type NormalizedSpectrumPickerProps = SpectrumPickerProps<NormalizedItem>;\n\nexport type TooltipOptions = { placement: PopperOptions['placement'] };\n\n/**\n * DH wrappers of Spectrum collection components use a normalized item that\n * includes a `key` prop and an optional `item` prop. This is mostly to support\n * Windowed data where items are created before their data has been loaded (data\n * gets set in the `item` prop). If data has loaded, return its `key`. If not,\n * return the top-level `key` on the normalized item.\n * @param item The normalized item or section\n * @returns The `key` of the item or section\n */\nexport function getItemKey<\n  TItem extends NormalizedItem | NormalizedSection,\n  TKey extends TItem extends NormalizedItem\n    ? ItemKey | undefined\n    : TItem extends NormalizedSection\n    ? Key | undefined\n    : undefined,\n>(item: TItem | null | undefined): TKey {\n  return (item?.item?.key ?? item?.key) as TKey;\n}\n\n/**\n * Get the position of the item with the given selected key in a list of items.\n * @param items The items to search\n * @param itemHeight The height of each item\n * @param selectedKey The key of the selected item\n * @param topOffset The top offset of the list\n * @returns The position of the selected item or the top offset if not found\n */\nexport async function getPositionOfSelectedItemElement<\n  TKey extends string | number | boolean | undefined,\n>({\n  items,\n  itemHeight,\n  selectedKey,\n  topOffset,\n}: {\n  items: ItemElement[];\n  selectedKey: TKey | null | undefined;\n  itemHeight: number;\n  topOffset: number;\n}): Promise<number> {\n  let position = topOffset;\n\n  if (selectedKey == null) {\n    return position;\n  }\n\n  for (let i = 0; i < items.length; i += 1) {\n    const item = items[i];\n    if (item.key === selectedKey) {\n      return position;\n    }\n\n    position += itemHeight;\n  }\n\n  return topOffset;\n}\n\n/**\n * Determine if a node is a Section element.\n * @param node The node to check\n * @returns True if the node is a Section element\n */\nexport function isSectionElement<T>(\n  node: ReactNode\n): node is ReactElement<SectionProps<T>> {\n  return isElementOfType(node, Section);\n}\n\n/**\n * Determine if a node is an Item element.\n * @param node The node to check\n * @returns True if the node is an Item element\n */\nexport function isItemElement<T>(\n  node: ReactNode\n): node is ReactElement<ItemProps<T>> {\n  return isElementOfType(node, Item);\n}\n\n/**\n * Determine if a node is an Item element containing a child `Text` element with\n * a `slot` prop set to `description`.\n * @param node The node to check\n * @returns True if the node is an Item element with a description\n */\nexport function isItemElementWithDescription<T>(\n  node: ReactNode\n): node is ReactElement<ItemProps<T>> {\n  if (!isItemElement(node)) {\n    return false;\n  }\n\n  // If children are wrapped in `ItemContent`, go down 1 level\n  const children = isElementOfType(node.props.children, ItemContent)\n    ? node.props.children.props.children\n    : node.props.children;\n\n  const childrenArray = Array.isArray(children) ? children : [children];\n\n  const result = childrenArray.some(\n    child => child.props?.slot === 'description' && isElementOfType(child, Text)\n  );\n\n  return result;\n}\n\n/**\n * Determine if a node is an array containing normalized items or sections with\n * keys. Note that this only checks the first node in the array.\n * @param node The node to check\n * @returns True if the node is a normalized item or section with keys array\n */\nexport function isNormalizedItemsWithKeysList<\n  TItemOrSection extends ItemOrSection,\n>(\n  node:\n    | TItemOrSection\n    | TItemOrSection[]\n    | NormalizedItemOrSection<TItemOrSection>[]\n): node is NormalizedItemOrSection<TItemOrSection>[] {\n  if (!Array.isArray(node)) {\n    return false;\n  }\n\n  if (node.length === 0) {\n    return true;\n  }\n\n  return !isItemOrSection(node[0]) && 'key' in node[0];\n}\n\n/**\n * Determine if an object is a normalized section.\n * @param maybeNormalizedSection The object to check\n * @returns True if the object is a normalized section\n */\nexport function isNormalizedSection(\n  maybeNormalizedSection: NormalizedItem | NormalizedSection\n): maybeNormalizedSection is NormalizedSection {\n  return (\n    maybeNormalizedSection.item != null &&\n    'items' in maybeNormalizedSection.item\n  );\n}\n\n/**\n * Determine if a node is an item or section. Valid types include strings,\n * numbers, booleans, Item elements, and Section elements.\n * @param node The node to check\n * @returns True if the node is an item or section\n */\nexport function isItemOrSection(node: ReactNode): node is ItemOrSection {\n  return (\n    typeof node === 'string' ||\n    typeof node === 'number' ||\n    typeof node === 'boolean' ||\n    isItemElement(node) ||\n    isSectionElement(node)\n  );\n}\n\n/**\n * Determine the `key` of an item or section.\n * @param itemOrSection The item or section\n * @returns A `ItemKey` for the item or undefined if a key can't be determined\n */\nfunction normalizeItemKey(item: ItemElementOrPrimitive): ItemKey | undefined;\nfunction normalizeItemKey(section: SectionElement): Key | undefined;\nfunction normalizeItemKey(\n  itemOrSection: ItemElementOrPrimitive | SectionElement\n): Key | ItemKey | undefined {\n  // string, number, or boolean\n  if (typeof itemOrSection !== 'object') {\n    return itemOrSection;\n  }\n\n  // If `key` prop is explicitly set\n  if (itemOrSection.key != null) {\n    return itemOrSection.key;\n  }\n\n  // Section element\n  if (isSectionElement(itemOrSection)) {\n    return typeof itemOrSection.props.title === 'string'\n      ? itemOrSection.props.title\n      : undefined;\n  }\n\n  // Item element\n  return (\n    itemOrSection.props.textValue ??\n    (typeof itemOrSection.props.children === 'string'\n      ? itemOrSection.props.children\n      : undefined)\n  );\n}\n\n/**\n * Get a normalized `textValue` for an item ensuring it is a string.\n * @param item The item\n * @returns A string `textValue` for the item\n */\nfunction normalizeTextValue(item: ItemElementOrPrimitive): string | undefined {\n  if (typeof item !== 'object') {\n    return String(item);\n  }\n\n  if (item.props.textValue != null) {\n    return item.props.textValue;\n  }\n\n  if (typeof item.props.children === 'string') {\n    return item.props.children;\n  }\n\n  return undefined;\n}\n\n/**\n * Normalize an item or section to an object form.\n * @param itemOrSection item to normalize\n * @returns NormalizedItem or NormalizedSection object\n */\nfunction normalizeItem<TItemOrSection extends ItemOrSection>(\n  itemOrSection: TItemOrSection\n): NormalizedItemOrSection<TItemOrSection> {\n  if (!isItemOrSection(itemOrSection)) {\n    log.debug(INVALID_ITEM_ERROR_MESSAGE, itemOrSection);\n    throw new Error(INVALID_ITEM_ERROR_MESSAGE);\n  }\n\n  if (isSectionElement(itemOrSection)) {\n    const key = normalizeItemKey(itemOrSection);\n    const { title } = itemOrSection.props;\n\n    const items = normalizeItemList(itemOrSection.props.children).filter(\n      // We don't support nested section elements\n      childItem => !isSectionElement(childItem)\n    ) as NormalizedItem[];\n\n    return {\n      item: { key, title, items },\n    } as NormalizedItemOrSection<TItemOrSection>;\n  }\n\n  const key = normalizeItemKey(itemOrSection);\n  const content = isItemElement(itemOrSection)\n    ? itemOrSection.props.children\n    : itemOrSection;\n  const textValue = normalizeTextValue(itemOrSection);\n\n  return {\n    item: { key, content, textValue },\n  } as NormalizedItemOrSection<TItemOrSection>;\n}\n\n/**\n * Normalize an item or section or a list of items or sections.\n * @param itemsOrSections An item or section or array of items or sections\n * @returns An array of normalized items or sections\n */\nexport function normalizeItemList<TItemOrSection extends ItemOrSection>(\n  itemsOrSections: TItemOrSection | TItemOrSection[] | NormalizedItem[]\n): NormalizedItemOrSection<TItemOrSection>[] {\n  // If already normalized, just return as-is\n  if (isNormalizedItemsWithKeysList(itemsOrSections)) {\n    return itemsOrSections as NormalizedItemOrSection<TItemOrSection>[];\n  }\n\n  const itemsArray: TItemOrSection[] = Array.isArray(itemsOrSections)\n    ? itemsOrSections\n    : [itemsOrSections];\n\n  return itemsArray.map(normalizeItem);\n}\n\n/**\n * Returns a TooltipOptions object or null if options is false or null.\n * @param options Tooltip options\n * @param placement Default placement for the tooltip if `options` is set\n * explicitly to `true`\n * @returns TooltipOptions or null\n */\nexport function normalizeTooltipOptions(\n  options?: boolean | TooltipOptions | null,\n  placement: TooltipOptions['placement'] = 'right'\n): TooltipOptions | null {\n  if (options == null || options === false) {\n    return null;\n  }\n\n  if (options === true) {\n    return { placement };\n  }\n\n  return options;\n}\n\n/**\n * Convert a selection of `ItemKey`s to a selection of strings.\n * @param itemKeys The selection of `ItemKey`s\n * @returns The selection of strings\n */\nexport function itemSelectionToStringSet<\n  TKeys extends 'all' | Iterable<ItemKey> | undefined,\n  TResult extends TKeys extends 'all'\n    ? 'all'\n    : TKeys extends Iterable<ItemKey>\n    ? Set<string>\n    : undefined,\n>(itemKeys: TKeys): TResult {\n  if (itemKeys == null || itemKeys === 'all') {\n    return itemKeys as undefined | 'all' as TResult;\n  }\n\n  return new Set([...itemKeys].map(String)) as TResult;\n}\n"],"mappings":"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"}

package/dist/spectrum/utils/itemWrapperUtils.d.ts

@@ -0,0 +1,12 @@
+import { ItemElement, ItemOrSection, SectionElement, TooltipOptions } from './itemUtils';
+/**
+ * Ensure all primitive children are wrapped in `Item` elements and that all
+ * `Item` element content is wrapped in `ItemContent` elements to handle text
+ * overflow consistently and to support tooltips.
+ * @param itemsOrSections The items or sections to wrap
+ * @param tooltipOptions The tooltip options to use when wrapping items
+ * @returns The wrapped items or sections
+ */
+export declare function wrapItemChildren(itemsOrSections: ItemOrSection | ItemOrSection[], tooltipOptions: TooltipOptions | null): (ItemElement | SectionElement)[];
+export default wrapItemChildren;
+//# sourceMappingURL=itemWrapperUtils.d.ts.map

package/dist/spectrum/utils/itemWrapperUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemWrapperUtils.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/itemWrapperUtils.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,WAAW,EACX,aAAa,EAEb,cAAc,EACd,cAAc,EACf,MAAM,aAAa,CAAC;AAIrB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,aAAa,GAAG,aAAa,EAAE,EAChD,cAAc,EAAE,cAAc,GAAG,IAAI,GACpC,CAAC,WAAW,GAAG,cAAc,CAAC,EAAE,CA8DlC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/spectrum/utils/itemWrapperUtils.js

@@ -0,0 +1,65 @@
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+import { cloneElement } from 'react';
+import { Item } from '@adobe/react-spectrum';
+import { isElementOfType } from '@deephaven/react-hooks';
+import { isItemElement, isSectionElement, ITEM_EMPTY_STRING_TEXT_VALUE } from "./itemUtils.js";
+import ItemContent from "../ItemContent.js";
+/**
+ * Ensure all primitive children are wrapped in `Item` elements and that all
+ * `Item` element content is wrapped in `ItemContent` elements to handle text
+ * overflow consistently and to support tooltips.
+ * @param itemsOrSections The items or sections to wrap
+ * @param tooltipOptions The tooltip options to use when wrapping items
+ * @returns The wrapped items or sections
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export function wrapItemChildren(itemsOrSections, tooltipOptions) {
+  var itemsOrSectionsArray = Array.isArray(itemsOrSections) ? itemsOrSections : [itemsOrSections];
+  return itemsOrSectionsArray.map(item => {
+    if (isItemElement(item)) {
+      var _item$key;
+      // Item content is already wrapped
+      if (isElementOfType(item.props.children, ItemContent)) {
+        return item;
+      }
+      var key = (_item$key = item.key) !== null && _item$key !== void 0 ? _item$key : item.props.textValue;
+      var textValue = item.props.textValue === '' ? ITEM_EMPTY_STRING_TEXT_VALUE : item.props.textValue;
+
+      // Wrap in `ItemContent` so we can support tooltips and handle text
+      // overflow
+      return /*#__PURE__*/cloneElement(item, _objectSpread(_objectSpread({}, item.props), {}, {
+        key,
+        textValue,
+        children: /*#__PURE__*/_jsx(ItemContent, {
+          tooltipOptions: tooltipOptions,
+          children: item.props.children
+        })
+      }));
+    }
+    if (isSectionElement(item)) {
+      var _item$key2;
+      return /*#__PURE__*/cloneElement(item, _objectSpread(_objectSpread({}, item.props), {}, {
+        key: (_item$key2 = item.key) !== null && _item$key2 !== void 0 ? _item$key2 : typeof item.props.title === 'string' ? item.props.title : undefined,
+        children: wrapItemChildren(item.props.children, tooltipOptions)
+      }));
+    }
+    if (typeof item === 'string' || typeof item === 'number' || typeof item === 'boolean') {
+      var text = String(item);
+      var _textValue = text === '' ? ITEM_EMPTY_STRING_TEXT_VALUE : text;
+      return /*#__PURE__*/_jsx(Item, {
+        textValue: _textValue,
+        children: /*#__PURE__*/_jsx(ItemContent, {
+          tooltipOptions: tooltipOptions,
+          children: text
+        })
+      }, text);
+    }
+    return item;
+  });
+}
+export default wrapItemChildren;
+//# sourceMappingURL=itemWrapperUtils.js.map

package/dist/spectrum/utils/itemWrapperUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemWrapperUtils.js","names":["cloneElement","Item","isElementOfType","isItemElement","isSectionElement","ITEM_EMPTY_STRING_TEXT_VALUE","ItemContent","jsx","_jsx","wrapItemChildren","itemsOrSections","tooltipOptions","itemsOrSectionsArray","Array","isArray","map","item","_item$key","props","children","key","textValue","_objectSpread","_item$key2","title","undefined","text","String"],"sources":["../../../src/spectrum/utils/itemWrapperUtils.tsx"],"sourcesContent":["import { cloneElement, ReactElement } from 'react';\nimport { Item } from '@adobe/react-spectrum';\nimport { isElementOfType } from '@deephaven/react-hooks';\nimport {\n  isItemElement,\n  isSectionElement,\n  ItemElement,\n  ItemOrSection,\n  ITEM_EMPTY_STRING_TEXT_VALUE,\n  SectionElement,\n  TooltipOptions,\n} from './itemUtils';\nimport { ItemProps } from '../shared';\nimport ItemContent from '../ItemContent';\n\n/**\n * Ensure all primitive children are wrapped in `Item` elements and that all\n * `Item` element content is wrapped in `ItemContent` elements to handle text\n * overflow consistently and to support tooltips.\n * @param itemsOrSections The items or sections to wrap\n * @param tooltipOptions The tooltip options to use when wrapping items\n * @returns The wrapped items or sections\n */\nexport function wrapItemChildren(\n  itemsOrSections: ItemOrSection | ItemOrSection[],\n  tooltipOptions: TooltipOptions | null\n): (ItemElement | SectionElement)[] {\n  const itemsOrSectionsArray = Array.isArray(itemsOrSections)\n    ? itemsOrSections\n    : [itemsOrSections];\n\n  return itemsOrSectionsArray.map(item => {\n    if (isItemElement(item)) {\n      // Item content is already wrapped\n      if (isElementOfType(item.props.children, ItemContent)) {\n        return item;\n      }\n\n      const key = item.key ?? item.props.textValue;\n      const textValue =\n        item.props.textValue === ''\n          ? ITEM_EMPTY_STRING_TEXT_VALUE\n          : item.props.textValue;\n\n      // Wrap in `ItemContent` so we can support tooltips and handle text\n      // overflow\n      return cloneElement(item, {\n        ...item.props,\n        key,\n        textValue,\n        children: (\n          <ItemContent tooltipOptions={tooltipOptions}>\n            {item.props.children}\n          </ItemContent>\n        ),\n      });\n    }\n\n    if (isSectionElement(item)) {\n      return cloneElement(item, {\n        ...item.props,\n        key:\n          item.key ??\n          (typeof item.props.title === 'string' ? item.props.title : undefined),\n        children: wrapItemChildren(\n          item.props.children,\n          tooltipOptions\n        ) as ReactElement<ItemProps<unknown>>[],\n      });\n    }\n\n    if (\n      typeof item === 'string' ||\n      typeof item === 'number' ||\n      typeof item === 'boolean'\n    ) {\n      const text = String(item);\n      const textValue = text === '' ? ITEM_EMPTY_STRING_TEXT_VALUE : text;\n\n      return (\n        <Item key={text} textValue={textValue}>\n          <ItemContent tooltipOptions={tooltipOptions}>{text}</ItemContent>\n        </Item>\n      );\n    }\n\n    return item;\n  });\n}\n\nexport default wrapItemChildren;\n"],"mappings":";;;;;AAAA,SAASA,YAAY,QAAsB,OAAO;AAClD,SAASC,IAAI,QAAQ,uBAAuB;AAC5C,SAASC,eAAe,QAAQ,wBAAwB;AAAC,SAEvDC,aAAa,EACbC,gBAAgB,EAGhBC,4BAA4B;AAAA,OAKvBC,WAAW;AAElB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,SAAAC,GAAA,IAAAC,IAAA;AAQA,OAAO,SAASC,gBAAgBA,CAC9BC,eAAgD,EAChDC,cAAqC,EACH;EAClC,IAAMC,oBAAoB,GAAGC,KAAK,CAACC,OAAO,CAACJ,eAAe,CAAC,GACvDA,eAAe,GACf,CAACA,eAAe,CAAC;EAErB,OAAOE,oBAAoB,CAACG,GAAG,CAACC,IAAI,IAAI;IACtC,IAAIb,aAAa,CAACa,IAAI,CAAC,EAAE;MAAA,IAAAC,SAAA;MACvB;MACA,IAAIf,eAAe,CAACc,IAAI,CAACE,KAAK,CAACC,QAAQ,EAAEb,WAAW,CAAC,EAAE;QACrD,OAAOU,IAAI;MACb;MAEA,IAAMI,GAAG,IAAAH,SAAA,GAAGD,IAAI,CAACI,GAAG,cAAAH,SAAA,cAAAA,SAAA,GAAID,IAAI,CAACE,KAAK,CAACG,SAAS;MAC5C,IAAMA,SAAS,GACbL,IAAI,CAACE,KAAK,CAACG,SAAS,KAAK,EAAE,GACvBhB,4BAA4B,GAC5BW,IAAI,CAACE,KAAK,CAACG,SAAS;;MAE1B;MACA;MACA,oBAAOrB,YAAY,CAACgB,IAAI,EAAAM,aAAA,CAAAA,aAAA,KACnBN,IAAI,CAACE,KAAK;QACbE,GAAG;QACHC,SAAS;QACTF,QAAQ,eACNX,IAAA,CAACF,WAAW;UAACK,cAAc,EAAEA,cAAe;UAAAQ,QAAA,EACzCH,IAAI,CAACE,KAAK,CAACC;QAAQ,CACT;MACd,EACF,CAAC;IACJ;IAEA,IAAIf,gBAAgB,CAACY,IAAI,CAAC,EAAE;MAAA,IAAAO,UAAA;MAC1B,oBAAOvB,YAAY,CAACgB,IAAI,EAAAM,aAAA,CAAAA,aAAA,KACnBN,IAAI,CAACE,KAAK;QACbE,GAAG,GAAAG,UAAA,GACDP,IAAI,CAACI,GAAG,cAAAG,UAAA,cAAAA,UAAA,GACP,OAAOP,IAAI,CAACE,KAAK,CAACM,KAAK,KAAK,QAAQ,GAAGR,IAAI,CAACE,KAAK,CAACM,KAAK,GAAGC,SAAU;QACvEN,QAAQ,EAAEV,gBAAgB,CACxBO,IAAI,CAACE,KAAK,CAACC,QAAQ,EACnBR,cACF;MAAuC,EACxC,CAAC;IACJ;IAEA,IACE,OAAOK,IAAI,KAAK,QAAQ,IACxB,OAAOA,IAAI,KAAK,QAAQ,IACxB,OAAOA,IAAI,KAAK,SAAS,EACzB;MACA,IAAMU,IAAI,GAAGC,MAAM,CAACX,IAAI,CAAC;MACzB,IAAMK,UAAS,GAAGK,IAAI,KAAK,EAAE,GAAGrB,4BAA4B,GAAGqB,IAAI;MAEnE,oBACElB,IAAA,CAACP,IAAI;QAAYoB,SAAS,EAAEA,UAAU;QAAAF,QAAA,eACpCX,IAAA,CAACF,WAAW;UAACK,cAAc,EAAEA,cAAe;UAAAQ,QAAA,EAAEO;QAAI,CAAc;MAAC,GADxDA,IAEL,CAAC;IAEX;IAEA,OAAOV,IAAI;EACb,CAAC,CAAC;AACJ;AAEA,eAAeP,gBAAgB"}

package/dist/spectrum/utils/useRenderNormalizedItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRenderNormalizedItem.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/useRenderNormalizedItem.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAc,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,cAAc,GAAG,IAAI,GACpC,CAAC,cAAc,EAAE,cAAc,KAAK,GAAG,CAAC,OAAO,CA6BjD;AAED,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"useRenderNormalizedItem.d.ts","sourceRoot":"","sources":["../../../src/spectrum/utils/useRenderNormalizedItem.tsx"],"names":[],"mappings":";AAGA,OAAO,EAGL,cAAc,EACd,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,cAAc,GAAG,IAAI,GACpC,CAAC,cAAc,EAAE,cAAc,KAAK,GAAG,CAAC,OAAO,CA+BjD;AAED,eAAe,uBAAuB,CAAC"}