@fluentui/react-utilities 9.9.4 → 9.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.json CHANGED
@@ -2,7 +2,30 @@
2
2
  "name": "@fluentui/react-utilities",
3
3
  "entries": [
4
4
  {
5
- "date": "Mon, 26 Jun 2023 09:51:06 GMT",
5
+ "date": "Wed, 28 Jun 2023 11:08:37 GMT",
6
+ "tag": "@fluentui/react-utilities_v9.10.0",
7
+ "version": "9.10.0",
8
+ "comments": {
9
+ "none": [
10
+ {
11
+ "author": "martinhochel@microsoft.com",
12
+ "package": "@fluentui/react-utilities",
13
+ "commit": "fbe878e9c9785588197481f172c42c2c0a230292",
14
+ "comment": "fix: update .npmignore to unify v8 packages and exclude project.json"
15
+ }
16
+ ],
17
+ "minor": [
18
+ {
19
+ "author": "bernardo.sunderhus@gmail.com",
20
+ "package": "@fluentui/react-utilities",
21
+ "commit": "f154811cb3580595c319de809ea51a798dfd4555",
22
+ "comment": "feat: creates useSelection hook"
23
+ }
24
+ ]
25
+ }
26
+ },
27
+ {
28
+ "date": "Mon, 26 Jun 2023 09:53:54 GMT",
6
29
  "tag": "@fluentui/react-utilities_v9.9.4",
7
30
  "version": "9.9.4",
8
31
  "comments": {
package/CHANGELOG.md CHANGED
@@ -1,12 +1,21 @@
1
1
  # Change Log - @fluentui/react-utilities
2
2
 
3
- This log was last generated on Mon, 26 Jun 2023 09:51:06 GMT and should not be manually modified.
3
+ This log was last generated on Wed, 28 Jun 2023 11:08:37 GMT and should not be manually modified.
4
4
 
5
5
  <!-- Start content -->
6
6
 
7
+ ## [9.10.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-utilities_v9.10.0)
8
+
9
+ Wed, 28 Jun 2023 11:08:37 GMT
10
+ [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-utilities_v9.9.4..@fluentui/react-utilities_v9.10.0)
11
+
12
+ ### Minor changes
13
+
14
+ - feat: creates useSelection hook ([PR #28335](https://github.com/microsoft/fluentui/pull/28335) by bernardo.sunderhus@gmail.com)
15
+
7
16
  ## [9.9.4](https://github.com/microsoft/fluentui/tree/@fluentui/react-utilities_v9.9.4)
8
17
 
9
- Mon, 26 Jun 2023 09:51:06 GMT
18
+ Mon, 26 Jun 2023 09:53:54 GMT
10
19
  [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-utilities_v9.9.3..@fluentui/react-utilities_v9.9.4)
11
20
 
12
21
  ### Patches
package/dist/index.d.ts CHANGED
@@ -363,6 +363,12 @@ declare type ObscureEventName = 'onLostPointerCaptureCapture';
363
363
  */
364
364
  export declare function omit<TObj extends Record<string, any>, Exclusions extends (keyof TObj)[]>(obj: TObj, exclusions: Exclusions): Omit<TObj, Exclusions[number]>;
365
365
 
366
+ export declare type OnSelectionChangeCallback = (event: React_2.SyntheticEvent, selectedItems: Set<SelectionItemId>) => void;
367
+
368
+ export declare type OnSelectionChangeData = {
369
+ selectedItems: Set<SelectionItemId>;
370
+ };
371
+
366
372
  /**
367
373
  * @internal
368
374
  */
@@ -439,6 +445,36 @@ export declare type ResolveShorthandOptions<Props, Required extends boolean = fa
439
445
  defaultProps?: Props;
440
446
  };
441
447
 
448
+ export declare type SelectionHookParams = {
449
+ selectionMode: SelectionMode_2;
450
+ /**
451
+ * Used in uncontrolled mode to set initial selected items on mount
452
+ */
453
+ defaultSelectedItems?: Iterable<SelectionItemId>;
454
+ /**
455
+ * Used to control selected items
456
+ */
457
+ selectedItems?: Iterable<SelectionItemId>;
458
+ /**
459
+ * Called when selection changes
460
+ */
461
+ onSelectionChange?(event: React_2.SyntheticEvent, data: OnSelectionChangeData): void;
462
+ };
463
+
464
+ export declare type SelectionItemId = string | number;
465
+
466
+ export declare interface SelectionMethods {
467
+ toggleItem(event: React_2.SyntheticEvent, id: SelectionItemId): void;
468
+ selectItem(event: React_2.SyntheticEvent, id: SelectionItemId): void;
469
+ deselectItem(event: React_2.SyntheticEvent, id: SelectionItemId): void;
470
+ clearItems(event: React_2.SyntheticEvent): void;
471
+ isSelected(id: SelectionItemId): boolean;
472
+ toggleAllItems(event: React_2.SyntheticEvent, itemIds: SelectionItemId[]): void;
473
+ }
474
+
475
+ declare type SelectionMode_2 = 'single' | 'multiselect';
476
+ export { SelectionMode_2 as SelectionMode }
477
+
442
478
  /**
443
479
  * The props type and shorthand value for a slot. Type is either a single intrinsic element like `'div'`,
444
480
  * or a component like `typeof Button`.
@@ -707,6 +743,8 @@ declare interface UseScrollbarWidthOptions {
707
743
  force?: boolean;
708
744
  }
709
745
 
746
+ export declare function useSelection(params: SelectionHookParams): readonly [Set<SelectionItemId>, SelectionMethods];
747
+
710
748
  /**
711
749
  * @internal
712
750
  * Helper to manage a browser timeout.
package/lib/index.js CHANGED
@@ -4,3 +4,4 @@ export { canUseDOM, useIsSSR, SSRProvider } from './ssr/index';
4
4
  export { clamp, getNativeElementProps, getPartitionedNativeProps, getRTLSafeKey, mergeCallbacks, isHTMLElement, isInteractiveHTMLElement, omit, createPriorityQueue } from './utils/index';
5
5
  export { applyTriggerPropsToChildren, getTriggerChild, isFluentTrigger } from './trigger/index';
6
6
  export { isTouchEvent, isMouseEvent, getEventClientCoords } from './events/index';
7
+ export { useSelection } from './selection/index';
package/lib/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["index.ts"],"sourcesContent":["export {\n getSlots,\n getSlotsNext,\n resolveShorthand,\n isResolvedShorthand,\n SLOT_RENDER_FUNCTION_SYMBOL,\n} from './compose/index';\nexport type {\n ExtractSlotProps,\n ComponentProps,\n ComponentState,\n ForwardRefComponent,\n ResolveShorthandFunction,\n ResolveShorthandOptions,\n Slot,\n Slots,\n SlotClassNames,\n SlotPropsRecord,\n SlotRenderFunction,\n SlotShorthandValue,\n UnknownSlotProps,\n} from './compose/index';\n\nexport {\n IdPrefixProvider,\n resetIdsForTests,\n useControllableState,\n useEventCallback,\n useFirstMount,\n useForceUpdate,\n useId,\n useIsomorphicLayoutEffect,\n useMergedRefs,\n useOnClickOutside,\n useOnScrollOutside,\n usePrevious,\n useScrollbarWidth,\n useTimeout,\n} from './hooks/index';\nexport type { RefObjectFunction, UseControllableStateOptions, UseOnClickOrScrollOutsideOptions } from './hooks/index';\n\nexport { canUseDOM, useIsSSR, SSRProvider } from './ssr/index';\n\nexport {\n clamp,\n getNativeElementProps,\n getPartitionedNativeProps,\n getRTLSafeKey,\n mergeCallbacks,\n isHTMLElement,\n isInteractiveHTMLElement,\n omit,\n createPriorityQueue,\n} from './utils/index';\n\nexport type { PriorityQueue } from './utils/priorityQueue';\n\nexport { applyTriggerPropsToChildren, getTriggerChild, isFluentTrigger } from './trigger/index';\n\nexport type { FluentTriggerComponent, TriggerProps } from './trigger/index';\n\n/**\n * Event utils\n */\nexport type { NativeTouchOrMouseEvent, ReactTouchOrMouseEvent, TouchOrMouseEvent } from './events/index';\nexport { isTouchEvent, isMouseEvent, getEventClientCoords } from './events/index';\n"],"names":["getSlots","getSlotsNext","resolveShorthand","isResolvedShorthand","SLOT_RENDER_FUNCTION_SYMBOL","IdPrefixProvider","resetIdsForTests","useControllableState","useEventCallback","useFirstMount","useForceUpdate","useId","useIsomorphicLayoutEffect","useMergedRefs","useOnClickOutside","useOnScrollOutside","usePrevious","useScrollbarWidth","useTimeout","canUseDOM","useIsSSR","SSRProvider","clamp","getNativeElementProps","getPartitionedNativeProps","getRTLSafeKey","mergeCallbacks","isHTMLElement","isInteractiveHTMLElement","omit","createPriorityQueue","applyTriggerPropsToChildren","getTriggerChild","isFluentTrigger","isTouchEvent","isMouseEvent","getEventClientCoords"],"mappings":"AAAA,SACEA,QAAQ,EACRC,YAAY,EACZC,gBAAgB,EAChBC,mBAAmB,EACnBC,2BAA2B,QACtB,kBAAkB;AAiBzB,SACEC,gBAAgB,EAChBC,gBAAgB,EAChBC,oBAAoB,EACpBC,gBAAgB,EAChBC,aAAa,EACbC,cAAc,EACdC,KAAK,EACLC,yBAAyB,EACzBC,aAAa,EACbC,iBAAiB,EACjBC,kBAAkB,EAClBC,WAAW,EACXC,iBAAiB,EACjBC,UAAU,QACL,gBAAgB;AAGvB,SAASC,SAAS,EAAEC,QAAQ,EAAEC,WAAW,QAAQ,cAAc;AAE/D,SACEC,KAAK,EACLC,qBAAqB,EACrBC,yBAAyB,EACzBC,aAAa,EACbC,cAAc,EACdC,aAAa,EACbC,wBAAwB,EACxBC,IAAI,EACJC,mBAAmB,QACd,gBAAgB;AAIvB,SAASC,2BAA2B,EAAEC,eAAe,EAAEC,eAAe,QAAQ,kBAAkB;AAQhG,SAASC,YAAY,EAAEC,YAAY,EAAEC,oBAAoB,QAAQ,iBAAiB"}
1
+ {"version":3,"sources":["index.ts"],"sourcesContent":["export {\n getSlots,\n getSlotsNext,\n resolveShorthand,\n isResolvedShorthand,\n SLOT_RENDER_FUNCTION_SYMBOL,\n} from './compose/index';\nexport type {\n ExtractSlotProps,\n ComponentProps,\n ComponentState,\n ForwardRefComponent,\n ResolveShorthandFunction,\n ResolveShorthandOptions,\n Slot,\n Slots,\n SlotClassNames,\n SlotPropsRecord,\n SlotRenderFunction,\n SlotShorthandValue,\n UnknownSlotProps,\n} from './compose/index';\n\nexport {\n IdPrefixProvider,\n resetIdsForTests,\n useControllableState,\n useEventCallback,\n useFirstMount,\n useForceUpdate,\n useId,\n useIsomorphicLayoutEffect,\n useMergedRefs,\n useOnClickOutside,\n useOnScrollOutside,\n usePrevious,\n useScrollbarWidth,\n useTimeout,\n} from './hooks/index';\nexport type { RefObjectFunction, UseControllableStateOptions, UseOnClickOrScrollOutsideOptions } from './hooks/index';\n\nexport { canUseDOM, useIsSSR, SSRProvider } from './ssr/index';\n\nexport {\n clamp,\n getNativeElementProps,\n getPartitionedNativeProps,\n getRTLSafeKey,\n mergeCallbacks,\n isHTMLElement,\n isInteractiveHTMLElement,\n omit,\n createPriorityQueue,\n} from './utils/index';\n\nexport type { PriorityQueue } from './utils/priorityQueue';\n\nexport { applyTriggerPropsToChildren, getTriggerChild, isFluentTrigger } from './trigger/index';\n\nexport type { FluentTriggerComponent, TriggerProps } from './trigger/index';\n\n/**\n * Event utils\n */\nexport type { NativeTouchOrMouseEvent, ReactTouchOrMouseEvent, TouchOrMouseEvent } from './events/index';\nexport { isTouchEvent, isMouseEvent, getEventClientCoords } from './events/index';\n\nexport type {\n SelectionMode,\n OnSelectionChangeCallback,\n OnSelectionChangeData,\n SelectionItemId,\n SelectionHookParams,\n SelectionMethods,\n} from './selection/index';\nexport { useSelection } from './selection/index';\n"],"names":["getSlots","getSlotsNext","resolveShorthand","isResolvedShorthand","SLOT_RENDER_FUNCTION_SYMBOL","IdPrefixProvider","resetIdsForTests","useControllableState","useEventCallback","useFirstMount","useForceUpdate","useId","useIsomorphicLayoutEffect","useMergedRefs","useOnClickOutside","useOnScrollOutside","usePrevious","useScrollbarWidth","useTimeout","canUseDOM","useIsSSR","SSRProvider","clamp","getNativeElementProps","getPartitionedNativeProps","getRTLSafeKey","mergeCallbacks","isHTMLElement","isInteractiveHTMLElement","omit","createPriorityQueue","applyTriggerPropsToChildren","getTriggerChild","isFluentTrigger","isTouchEvent","isMouseEvent","getEventClientCoords","useSelection"],"mappings":"AAAA,SACEA,QAAQ,EACRC,YAAY,EACZC,gBAAgB,EAChBC,mBAAmB,EACnBC,2BAA2B,QACtB,kBAAkB;AAiBzB,SACEC,gBAAgB,EAChBC,gBAAgB,EAChBC,oBAAoB,EACpBC,gBAAgB,EAChBC,aAAa,EACbC,cAAc,EACdC,KAAK,EACLC,yBAAyB,EACzBC,aAAa,EACbC,iBAAiB,EACjBC,kBAAkB,EAClBC,WAAW,EACXC,iBAAiB,EACjBC,UAAU,QACL,gBAAgB;AAGvB,SAASC,SAAS,EAAEC,QAAQ,EAAEC,WAAW,QAAQ,cAAc;AAE/D,SACEC,KAAK,EACLC,qBAAqB,EACrBC,yBAAyB,EACzBC,aAAa,EACbC,cAAc,EACdC,aAAa,EACbC,wBAAwB,EACxBC,IAAI,EACJC,mBAAmB,QACd,gBAAgB;AAIvB,SAASC,2BAA2B,EAAEC,eAAe,EAAEC,eAAe,QAAQ,kBAAkB;AAQhG,SAASC,YAAY,EAAEC,YAAY,EAAEC,oBAAoB,QAAQ,iBAAiB;AAUlF,SAASC,YAAY,QAAQ,oBAAoB"}
@@ -0,0 +1,2 @@
1
+ export * from './types';
2
+ export * from './useSelection';
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["index.ts"],"sourcesContent":["export * from './types';\nexport * from './useSelection';\n"],"names":[],"mappings":"AAAA,cAAc,UAAU;AACxB,cAAc,iBAAiB"}
@@ -0,0 +1 @@
1
+ import * as React from 'react';
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["types.ts"],"sourcesContent":["import * as React from 'react';\n\nexport type SelectionMode = 'single' | 'multiselect';\n\nexport interface SelectionMethods {\n toggleItem(event: React.SyntheticEvent, id: SelectionItemId): void;\n selectItem(event: React.SyntheticEvent, id: SelectionItemId): void;\n deselectItem(event: React.SyntheticEvent, id: SelectionItemId): void;\n clearItems(event: React.SyntheticEvent): void;\n isSelected(id: SelectionItemId): boolean;\n toggleAllItems(event: React.SyntheticEvent, itemIds: SelectionItemId[]): void;\n}\n\nexport type SelectionItemId = string | number;\n\nexport type OnSelectionChangeCallback = (event: React.SyntheticEvent, selectedItems: Set<SelectionItemId>) => void;\n\nexport type OnSelectionChangeData = {\n selectedItems: Set<SelectionItemId>;\n};\n\nexport type SelectionHookParams = {\n selectionMode: SelectionMode;\n /**\n * Used in uncontrolled mode to set initial selected items on mount\n */\n defaultSelectedItems?: Iterable<SelectionItemId>;\n /**\n * Used to control selected items\n */\n selectedItems?: Iterable<SelectionItemId>;\n /**\n * Called when selection changes\n */\n onSelectionChange?(event: React.SyntheticEvent, data: OnSelectionChangeData): void;\n};\n"],"names":["React"],"mappings":"AAAA,YAAYA,WAAW,QAAQ"}
@@ -0,0 +1,113 @@
1
+ import * as React from 'react';
2
+ import { useControllableState } from '../hooks/useControllableState';
3
+ import { createSetFromIterable } from '../utils/createSetFromIterable';
4
+ function useSingleSelection(params) {
5
+ const [selected, setSelected] = useControllableState({
6
+ initialState: new Set(),
7
+ defaultState: React.useMemo(()=>params.defaultSelectedItems && createSetFromIterable(params.defaultSelectedItems), [
8
+ params.defaultSelectedItems
9
+ ]),
10
+ state: React.useMemo(()=>params.selectedItems && createSetFromIterable(params.selectedItems), [
11
+ params.selectedItems
12
+ ])
13
+ });
14
+ const changeSelection = (event, nextSelectedItems)=>{
15
+ var _params_onSelectionChange;
16
+ (_params_onSelectionChange = params.onSelectionChange) === null || _params_onSelectionChange === void 0 ? void 0 : _params_onSelectionChange.call(params, event, {
17
+ selectedItems: nextSelectedItems
18
+ });
19
+ if (!event.isDefaultPrevented()) {
20
+ setSelected(nextSelectedItems);
21
+ }
22
+ };
23
+ var _selected_has;
24
+ const methods = {
25
+ deselectItem: (event)=>changeSelection(event, new Set()),
26
+ selectItem: (event, itemId)=>changeSelection(event, new Set([
27
+ itemId
28
+ ])),
29
+ toggleAllItems: ()=>{
30
+ if (process.env.NODE_ENV !== 'production') {
31
+ throw new Error('[react-utilities]: `toggleAllItems` should not be used in single selection mode');
32
+ }
33
+ },
34
+ toggleItem: (event, itemId)=>changeSelection(event, new Set([
35
+ itemId
36
+ ])),
37
+ clearItems: (event)=>changeSelection(event, new Set()),
38
+ isSelected: (itemId)=>(_selected_has = selected.has(itemId)) !== null && _selected_has !== void 0 ? _selected_has : false
39
+ };
40
+ return [
41
+ selected,
42
+ methods
43
+ ];
44
+ }
45
+ function useMultipleSelection(params) {
46
+ const [selected, setSelected] = useControllableState({
47
+ initialState: new Set(),
48
+ defaultState: React.useMemo(()=>params.defaultSelectedItems && createSetFromIterable(params.defaultSelectedItems), [
49
+ params.defaultSelectedItems
50
+ ]),
51
+ state: React.useMemo(()=>params.selectedItems && createSetFromIterable(params.selectedItems), [
52
+ params.selectedItems
53
+ ])
54
+ });
55
+ const changeSelection = (event, nextSelectedItems)=>{
56
+ var _params_onSelectionChange;
57
+ (_params_onSelectionChange = params.onSelectionChange) === null || _params_onSelectionChange === void 0 ? void 0 : _params_onSelectionChange.call(params, event, {
58
+ selectedItems: nextSelectedItems
59
+ });
60
+ if (!event.isDefaultPrevented()) {
61
+ setSelected(nextSelectedItems);
62
+ }
63
+ };
64
+ const methods = {
65
+ toggleItem: (event, itemId)=>{
66
+ const nextSelectedItems = new Set(selected);
67
+ if (selected.has(itemId)) {
68
+ nextSelectedItems.delete(itemId);
69
+ } else {
70
+ nextSelectedItems.add(itemId);
71
+ }
72
+ changeSelection(event, nextSelectedItems);
73
+ },
74
+ selectItem: (event, itemId)=>{
75
+ const nextSelectedItems = new Set(selected);
76
+ nextSelectedItems.add(itemId);
77
+ changeSelection(event, nextSelectedItems);
78
+ },
79
+ deselectItem: (event, itemId)=>{
80
+ const nextSelectedItems = new Set(selected);
81
+ nextSelectedItems.delete(itemId);
82
+ changeSelection(event, nextSelectedItems);
83
+ },
84
+ clearItems: (event)=>{
85
+ changeSelection(event, new Set());
86
+ },
87
+ isSelected: (itemId)=>selected.has(itemId),
88
+ toggleAllItems: (event, itemIds)=>{
89
+ const allItemsSelected = itemIds.every((itemId)=>selected.has(itemId));
90
+ const nextSelectedItems = new Set(selected);
91
+ if (allItemsSelected) {
92
+ nextSelectedItems.clear();
93
+ } else {
94
+ itemIds.forEach((itemId)=>nextSelectedItems.add(itemId));
95
+ }
96
+ changeSelection(event, nextSelectedItems);
97
+ }
98
+ };
99
+ return [
100
+ selected,
101
+ methods
102
+ ];
103
+ }
104
+ export function useSelection(params) {
105
+ if (params.selectionMode === 'multiselect') {
106
+ // selectionMode is a static value, so we can safely ignore rules-of-hooks
107
+ // eslint-disable-next-line react-hooks/rules-of-hooks
108
+ return useMultipleSelection(params);
109
+ }
110
+ // selectionMode is a static value, so we can safely ignore rules-of-hooks
111
+ // eslint-disable-next-line react-hooks/rules-of-hooks
112
+ return useSingleSelection(params);
113
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["useSelection.ts"],"sourcesContent":["import * as React from 'react';\nimport { SelectionHookParams, SelectionItemId, SelectionMethods } from './types';\nimport { useControllableState } from '../hooks/useControllableState';\nimport { createSetFromIterable } from '../utils/createSetFromIterable';\n\nfunction useSingleSelection(params: Omit<SelectionHookParams, 'selectionMode'>) {\n const [selected, setSelected] = useControllableState<Set<SelectionItemId>>({\n initialState: new Set(),\n defaultState: React.useMemo(\n () => params.defaultSelectedItems && createSetFromIterable(params.defaultSelectedItems),\n [params.defaultSelectedItems],\n ),\n state: React.useMemo(\n () => params.selectedItems && createSetFromIterable(params.selectedItems),\n [params.selectedItems],\n ),\n });\n const changeSelection = (event: React.SyntheticEvent, nextSelectedItems: Set<SelectionItemId>) => {\n params.onSelectionChange?.(event, { selectedItems: nextSelectedItems });\n if (!event.isDefaultPrevented()) {\n setSelected(nextSelectedItems);\n }\n };\n const methods: SelectionMethods = {\n deselectItem: event => changeSelection(event, new Set()),\n selectItem: (event, itemId) => changeSelection(event, new Set([itemId])),\n toggleAllItems: () => {\n if (process.env.NODE_ENV !== 'production') {\n throw new Error('[react-utilities]: `toggleAllItems` should not be used in single selection mode');\n }\n },\n toggleItem: (event, itemId) => changeSelection(event, new Set([itemId])),\n clearItems: event => changeSelection(event, new Set()),\n isSelected: itemId => selected.has(itemId) ?? false,\n };\n return [selected, methods] as const;\n}\n\nfunction useMultipleSelection(params: Omit<SelectionHookParams, 'selectionMode'>) {\n const [selected, setSelected] = useControllableState<Set<SelectionItemId>>({\n initialState: new Set(),\n defaultState: React.useMemo(\n () => params.defaultSelectedItems && createSetFromIterable(params.defaultSelectedItems),\n [params.defaultSelectedItems],\n ),\n state: React.useMemo(\n () => params.selectedItems && createSetFromIterable(params.selectedItems),\n [params.selectedItems],\n ),\n });\n const changeSelection = (event: React.SyntheticEvent, nextSelectedItems: Set<SelectionItemId>) => {\n params.onSelectionChange?.(event, { selectedItems: nextSelectedItems });\n if (!event.isDefaultPrevented()) {\n setSelected(nextSelectedItems);\n }\n };\n const methods: SelectionMethods = {\n toggleItem: (event, itemId) => {\n const nextSelectedItems = new Set(selected);\n if (selected.has(itemId)) {\n nextSelectedItems.delete(itemId);\n } else {\n nextSelectedItems.add(itemId);\n }\n changeSelection(event, nextSelectedItems);\n },\n selectItem: (event, itemId) => {\n const nextSelectedItems = new Set(selected);\n nextSelectedItems.add(itemId);\n changeSelection(event, nextSelectedItems);\n },\n deselectItem: (event, itemId) => {\n const nextSelectedItems = new Set(selected);\n nextSelectedItems.delete(itemId);\n changeSelection(event, nextSelectedItems);\n },\n clearItems: event => {\n changeSelection(event, new Set());\n },\n isSelected: itemId => selected.has(itemId),\n toggleAllItems: (event, itemIds) => {\n const allItemsSelected = itemIds.every(itemId => selected.has(itemId));\n const nextSelectedItems = new Set(selected);\n if (allItemsSelected) {\n nextSelectedItems.clear();\n } else {\n itemIds.forEach(itemId => nextSelectedItems.add(itemId));\n }\n changeSelection(event, nextSelectedItems);\n },\n };\n return [selected, methods] as const;\n}\n\nexport function useSelection(params: SelectionHookParams) {\n if (params.selectionMode === 'multiselect') {\n // selectionMode is a static value, so we can safely ignore rules-of-hooks\n // eslint-disable-next-line react-hooks/rules-of-hooks\n return useMultipleSelection(params);\n }\n // selectionMode is a static value, so we can safely ignore rules-of-hooks\n // eslint-disable-next-line react-hooks/rules-of-hooks\n return useSingleSelection(params);\n}\n"],"names":["React","useControllableState","createSetFromIterable","useSingleSelection","params","selected","setSelected","initialState","Set","defaultState","useMemo","defaultSelectedItems","state","selectedItems","changeSelection","event","nextSelectedItems","onSelectionChange","isDefaultPrevented","methods","deselectItem","selectItem","itemId","toggleAllItems","process","env","NODE_ENV","Error","toggleItem","clearItems","isSelected","has","useMultipleSelection","delete","add","itemIds","allItemsSelected","every","clear","forEach","useSelection","selectionMode"],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Creates a set from a given iterable, in case the iterable is a set itself, returns the given set instead.
3
+ */ export function createSetFromIterable(iterable) {
4
+ return iterable instanceof Set ? iterable : new Set(iterable);
5
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["createSetFromIterable.ts"],"sourcesContent":["/**\n * Creates a set from a given iterable, in case the iterable is a set itself, returns the given set instead.\n */\nexport function createSetFromIterable<V>(iterable: Iterable<V>): Set<V> {\n return iterable instanceof Set ? iterable : new Set(iterable);\n}\n"],"names":["createSetFromIterable","iterable","Set"],"mappings":"AAAA;;CAEC,GACD,OAAO,SAASA,sBAAyBC,QAAqB,EAAU;IACtE,OAAOA,oBAAoBC,MAAMD,WAAW,IAAIC,IAAID,SAAS;AAC/D,CAAC"}
@@ -45,7 +45,8 @@ _export(exports, {
45
45
  isFluentTrigger: ()=>_index4.isFluentTrigger,
46
46
  isTouchEvent: ()=>_index5.isTouchEvent,
47
47
  isMouseEvent: ()=>_index5.isMouseEvent,
48
- getEventClientCoords: ()=>_index5.getEventClientCoords
48
+ getEventClientCoords: ()=>_index5.getEventClientCoords,
49
+ useSelection: ()=>_index6.useSelection
49
50
  });
50
51
  const _index = require("./compose/index");
51
52
  const _index1 = require("./hooks/index");
@@ -53,3 +54,4 @@ const _index2 = require("./ssr/index");
53
54
  const _index3 = require("./utils/index");
54
55
  const _index4 = require("./trigger/index");
55
56
  const _index5 = require("./events/index");
57
+ const _index6 = require("./selection/index");
@@ -1 +1 @@
1
- {"version":3,"sources":["index.js"],"sourcesContent":["export { getSlots, getSlotsNext, resolveShorthand, isResolvedShorthand, SLOT_RENDER_FUNCTION_SYMBOL } from './compose/index';\nexport { IdPrefixProvider, resetIdsForTests, useControllableState, useEventCallback, useFirstMount, useForceUpdate, useId, useIsomorphicLayoutEffect, useMergedRefs, useOnClickOutside, useOnScrollOutside, usePrevious, useScrollbarWidth, useTimeout } from './hooks/index';\nexport { canUseDOM, useIsSSR, SSRProvider } from './ssr/index';\nexport { clamp, getNativeElementProps, getPartitionedNativeProps, getRTLSafeKey, mergeCallbacks, isHTMLElement, isInteractiveHTMLElement, omit, createPriorityQueue } from './utils/index';\nexport { applyTriggerPropsToChildren, getTriggerChild, isFluentTrigger } from './trigger/index';\nexport { isTouchEvent, isMouseEvent, getEventClientCoords } from './events/index';\n"],"names":["getSlots","getSlotsNext","resolveShorthand","isResolvedShorthand","SLOT_RENDER_FUNCTION_SYMBOL","IdPrefixProvider","resetIdsForTests","useControllableState","useEventCallback","useFirstMount","useForceUpdate","useId","useIsomorphicLayoutEffect","useMergedRefs","useOnClickOutside","useOnScrollOutside","usePrevious","useScrollbarWidth","useTimeout","canUseDOM","useIsSSR","SSRProvider","clamp","getNativeElementProps","getPartitionedNativeProps","getRTLSafeKey","mergeCallbacks","isHTMLElement","isInteractiveHTMLElement","omit","createPriorityQueue","applyTriggerPropsToChildren","getTriggerChild","isFluentTrigger","isTouchEvent","isMouseEvent","getEventClientCoords"],"mappings":";;;;;;;;;;;IAASA,QAAQ,MAARA,eAAQ;IAAEC,YAAY,MAAZA,mBAAY;IAAEC,gBAAgB,MAAhBA,uBAAgB;IAAEC,mBAAmB,MAAnBA,0BAAmB;IAAEC,2BAA2B,MAA3BA,kCAA2B;IAC1FC,gBAAgB,MAAhBA,wBAAgB;IAAEC,gBAAgB,MAAhBA,wBAAgB;IAAEC,oBAAoB,MAApBA,4BAAoB;IAAEC,gBAAgB,MAAhBA,wBAAgB;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,cAAc,MAAdA,sBAAc;IAAEC,KAAK,MAALA,aAAK;IAAEC,yBAAyB,MAAzBA,iCAAyB;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,iBAAiB,MAAjBA,yBAAiB;IAAEC,kBAAkB,MAAlBA,0BAAkB;IAAEC,WAAW,MAAXA,mBAAW;IAAEC,iBAAiB,MAAjBA,yBAAiB;IAAEC,UAAU,MAAVA,kBAAU;IAC7OC,SAAS,MAATA,iBAAS;IAAEC,QAAQ,MAARA,gBAAQ;IAAEC,WAAW,MAAXA,mBAAW;IAChCC,KAAK,MAALA,aAAK;IAAEC,qBAAqB,MAArBA,6BAAqB;IAAEC,yBAAyB,MAAzBA,iCAAyB;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,cAAc,MAAdA,sBAAc;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,wBAAwB,MAAxBA,gCAAwB;IAAEC,IAAI,MAAJA,YAAI;IAAEC,mBAAmB,MAAnBA,2BAAmB;IAC1JC,2BAA2B,MAA3BA,mCAA2B;IAAEC,eAAe,MAAfA,uBAAe;IAAEC,eAAe,MAAfA,uBAAe;IAC7DC,YAAY,MAAZA,oBAAY;IAAEC,YAAY,MAAZA,oBAAY;IAAEC,oBAAoB,MAApBA,4BAAoB;;uBALkD;wBACmJ;wBAC7M;wBAC0H;wBAC7F;wBACb"}
1
+ {"version":3,"sources":["index.js"],"sourcesContent":["export { getSlots, getSlotsNext, resolveShorthand, isResolvedShorthand, SLOT_RENDER_FUNCTION_SYMBOL } from './compose/index';\nexport { IdPrefixProvider, resetIdsForTests, useControllableState, useEventCallback, useFirstMount, useForceUpdate, useId, useIsomorphicLayoutEffect, useMergedRefs, useOnClickOutside, useOnScrollOutside, usePrevious, useScrollbarWidth, useTimeout } from './hooks/index';\nexport { canUseDOM, useIsSSR, SSRProvider } from './ssr/index';\nexport { clamp, getNativeElementProps, getPartitionedNativeProps, getRTLSafeKey, mergeCallbacks, isHTMLElement, isInteractiveHTMLElement, omit, createPriorityQueue } from './utils/index';\nexport { applyTriggerPropsToChildren, getTriggerChild, isFluentTrigger } from './trigger/index';\nexport { isTouchEvent, isMouseEvent, getEventClientCoords } from './events/index';\nexport { useSelection } from './selection/index';\n"],"names":["getSlots","getSlotsNext","resolveShorthand","isResolvedShorthand","SLOT_RENDER_FUNCTION_SYMBOL","IdPrefixProvider","resetIdsForTests","useControllableState","useEventCallback","useFirstMount","useForceUpdate","useId","useIsomorphicLayoutEffect","useMergedRefs","useOnClickOutside","useOnScrollOutside","usePrevious","useScrollbarWidth","useTimeout","canUseDOM","useIsSSR","SSRProvider","clamp","getNativeElementProps","getPartitionedNativeProps","getRTLSafeKey","mergeCallbacks","isHTMLElement","isInteractiveHTMLElement","omit","createPriorityQueue","applyTriggerPropsToChildren","getTriggerChild","isFluentTrigger","isTouchEvent","isMouseEvent","getEventClientCoords","useSelection"],"mappings":";;;;;;;;;;;IAASA,QAAQ,MAARA,eAAQ;IAAEC,YAAY,MAAZA,mBAAY;IAAEC,gBAAgB,MAAhBA,uBAAgB;IAAEC,mBAAmB,MAAnBA,0BAAmB;IAAEC,2BAA2B,MAA3BA,kCAA2B;IAC1FC,gBAAgB,MAAhBA,wBAAgB;IAAEC,gBAAgB,MAAhBA,wBAAgB;IAAEC,oBAAoB,MAApBA,4BAAoB;IAAEC,gBAAgB,MAAhBA,wBAAgB;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,cAAc,MAAdA,sBAAc;IAAEC,KAAK,MAALA,aAAK;IAAEC,yBAAyB,MAAzBA,iCAAyB;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,iBAAiB,MAAjBA,yBAAiB;IAAEC,kBAAkB,MAAlBA,0BAAkB;IAAEC,WAAW,MAAXA,mBAAW;IAAEC,iBAAiB,MAAjBA,yBAAiB;IAAEC,UAAU,MAAVA,kBAAU;IAC7OC,SAAS,MAATA,iBAAS;IAAEC,QAAQ,MAARA,gBAAQ;IAAEC,WAAW,MAAXA,mBAAW;IAChCC,KAAK,MAALA,aAAK;IAAEC,qBAAqB,MAArBA,6BAAqB;IAAEC,yBAAyB,MAAzBA,iCAAyB;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,cAAc,MAAdA,sBAAc;IAAEC,aAAa,MAAbA,qBAAa;IAAEC,wBAAwB,MAAxBA,gCAAwB;IAAEC,IAAI,MAAJA,YAAI;IAAEC,mBAAmB,MAAnBA,2BAAmB;IAC1JC,2BAA2B,MAA3BA,mCAA2B;IAAEC,eAAe,MAAfA,uBAAe;IAAEC,eAAe,MAAfA,uBAAe;IAC7DC,YAAY,MAAZA,oBAAY;IAAEC,YAAY,MAAZA,oBAAY;IAAEC,oBAAoB,MAApBA,4BAAoB;IAChDC,YAAY,MAAZA,oBAAY;;uBANsF;wBACmJ;wBAC7M;wBAC0H;wBAC7F;wBACb;wBACpC"}
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ const _exportStar = require("@swc/helpers/lib/_export_star.js").default;
6
+ _exportStar(require("./types"), exports);
7
+ _exportStar(require("./useSelection"), exports);
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["index.js"],"sourcesContent":["export * from './types';\nexport * from './useSelection';\n"],"names":[],"mappings":";;;;;oBAAc;oBACA"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ const _interopRequireWildcard = require("@swc/helpers/lib/_interop_require_wildcard.js").default;
6
+ const _react = /*#__PURE__*/ _interopRequireWildcard(require("react"));
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["types.js"],"sourcesContent":["import * as React from 'react';\n"],"names":[],"mappings":";;;;;6DAAuB"}
@@ -0,0 +1,122 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ Object.defineProperty(exports, "useSelection", {
6
+ enumerable: true,
7
+ get: ()=>useSelection
8
+ });
9
+ const _interopRequireWildcard = require("@swc/helpers/lib/_interop_require_wildcard.js").default;
10
+ const _react = /*#__PURE__*/ _interopRequireWildcard(require("react"));
11
+ const _useControllableState = require("../hooks/useControllableState");
12
+ const _createSetFromIterable = require("../utils/createSetFromIterable");
13
+ function useSingleSelection(params) {
14
+ const [selected, setSelected] = (0, _useControllableState.useControllableState)({
15
+ initialState: new Set(),
16
+ defaultState: _react.useMemo(()=>params.defaultSelectedItems && (0, _createSetFromIterable.createSetFromIterable)(params.defaultSelectedItems), [
17
+ params.defaultSelectedItems
18
+ ]),
19
+ state: _react.useMemo(()=>params.selectedItems && (0, _createSetFromIterable.createSetFromIterable)(params.selectedItems), [
20
+ params.selectedItems
21
+ ])
22
+ });
23
+ const changeSelection = (event, nextSelectedItems)=>{
24
+ var _params_onSelectionChange;
25
+ (_params_onSelectionChange = params.onSelectionChange) === null || _params_onSelectionChange === void 0 ? void 0 : _params_onSelectionChange.call(params, event, {
26
+ selectedItems: nextSelectedItems
27
+ });
28
+ if (!event.isDefaultPrevented()) {
29
+ setSelected(nextSelectedItems);
30
+ }
31
+ };
32
+ var _selected_has;
33
+ const methods = {
34
+ deselectItem: (event)=>changeSelection(event, new Set()),
35
+ selectItem: (event, itemId)=>changeSelection(event, new Set([
36
+ itemId
37
+ ])),
38
+ toggleAllItems: ()=>{
39
+ if (process.env.NODE_ENV !== 'production') {
40
+ throw new Error('[react-utilities]: `toggleAllItems` should not be used in single selection mode');
41
+ }
42
+ },
43
+ toggleItem: (event, itemId)=>changeSelection(event, new Set([
44
+ itemId
45
+ ])),
46
+ clearItems: (event)=>changeSelection(event, new Set()),
47
+ isSelected: (itemId)=>(_selected_has = selected.has(itemId)) !== null && _selected_has !== void 0 ? _selected_has : false
48
+ };
49
+ return [
50
+ selected,
51
+ methods
52
+ ];
53
+ }
54
+ function useMultipleSelection(params) {
55
+ const [selected, setSelected] = (0, _useControllableState.useControllableState)({
56
+ initialState: new Set(),
57
+ defaultState: _react.useMemo(()=>params.defaultSelectedItems && (0, _createSetFromIterable.createSetFromIterable)(params.defaultSelectedItems), [
58
+ params.defaultSelectedItems
59
+ ]),
60
+ state: _react.useMemo(()=>params.selectedItems && (0, _createSetFromIterable.createSetFromIterable)(params.selectedItems), [
61
+ params.selectedItems
62
+ ])
63
+ });
64
+ const changeSelection = (event, nextSelectedItems)=>{
65
+ var _params_onSelectionChange;
66
+ (_params_onSelectionChange = params.onSelectionChange) === null || _params_onSelectionChange === void 0 ? void 0 : _params_onSelectionChange.call(params, event, {
67
+ selectedItems: nextSelectedItems
68
+ });
69
+ if (!event.isDefaultPrevented()) {
70
+ setSelected(nextSelectedItems);
71
+ }
72
+ };
73
+ const methods = {
74
+ toggleItem: (event, itemId)=>{
75
+ const nextSelectedItems = new Set(selected);
76
+ if (selected.has(itemId)) {
77
+ nextSelectedItems.delete(itemId);
78
+ } else {
79
+ nextSelectedItems.add(itemId);
80
+ }
81
+ changeSelection(event, nextSelectedItems);
82
+ },
83
+ selectItem: (event, itemId)=>{
84
+ const nextSelectedItems = new Set(selected);
85
+ nextSelectedItems.add(itemId);
86
+ changeSelection(event, nextSelectedItems);
87
+ },
88
+ deselectItem: (event, itemId)=>{
89
+ const nextSelectedItems = new Set(selected);
90
+ nextSelectedItems.delete(itemId);
91
+ changeSelection(event, nextSelectedItems);
92
+ },
93
+ clearItems: (event)=>{
94
+ changeSelection(event, new Set());
95
+ },
96
+ isSelected: (itemId)=>selected.has(itemId),
97
+ toggleAllItems: (event, itemIds)=>{
98
+ const allItemsSelected = itemIds.every((itemId)=>selected.has(itemId));
99
+ const nextSelectedItems = new Set(selected);
100
+ if (allItemsSelected) {
101
+ nextSelectedItems.clear();
102
+ } else {
103
+ itemIds.forEach((itemId)=>nextSelectedItems.add(itemId));
104
+ }
105
+ changeSelection(event, nextSelectedItems);
106
+ }
107
+ };
108
+ return [
109
+ selected,
110
+ methods
111
+ ];
112
+ }
113
+ function useSelection(params) {
114
+ if (params.selectionMode === 'multiselect') {
115
+ // selectionMode is a static value, so we can safely ignore rules-of-hooks
116
+ // eslint-disable-next-line react-hooks/rules-of-hooks
117
+ return useMultipleSelection(params);
118
+ }
119
+ // selectionMode is a static value, so we can safely ignore rules-of-hooks
120
+ // eslint-disable-next-line react-hooks/rules-of-hooks
121
+ return useSingleSelection(params);
122
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["useSelection.js"],"sourcesContent":["import * as React from 'react';\nimport { useControllableState } from '../hooks/useControllableState';\nimport { createSetFromIterable } from '../utils/createSetFromIterable';\nfunction useSingleSelection(params) {\n const [selected, setSelected] = useControllableState({\n initialState: new Set(),\n defaultState: React.useMemo(()=>params.defaultSelectedItems && createSetFromIterable(params.defaultSelectedItems), [\n params.defaultSelectedItems\n ]),\n state: React.useMemo(()=>params.selectedItems && createSetFromIterable(params.selectedItems), [\n params.selectedItems\n ])\n });\n const changeSelection = (event, nextSelectedItems)=>{\n var _params_onSelectionChange;\n (_params_onSelectionChange = params.onSelectionChange) === null || _params_onSelectionChange === void 0 ? void 0 : _params_onSelectionChange.call(params, event, {\n selectedItems: nextSelectedItems\n });\n if (!event.isDefaultPrevented()) {\n setSelected(nextSelectedItems);\n }\n };\n var _selected_has;\n const methods = {\n deselectItem: (event)=>changeSelection(event, new Set()),\n selectItem: (event, itemId)=>changeSelection(event, new Set([\n itemId\n ])),\n toggleAllItems: ()=>{\n if (process.env.NODE_ENV !== 'production') {\n throw new Error('[react-utilities]: `toggleAllItems` should not be used in single selection mode');\n }\n },\n toggleItem: (event, itemId)=>changeSelection(event, new Set([\n itemId\n ])),\n clearItems: (event)=>changeSelection(event, new Set()),\n isSelected: (itemId)=>(_selected_has = selected.has(itemId)) !== null && _selected_has !== void 0 ? _selected_has : false\n };\n return [\n selected,\n methods\n ];\n}\nfunction useMultipleSelection(params) {\n const [selected, setSelected] = useControllableState({\n initialState: new Set(),\n defaultState: React.useMemo(()=>params.defaultSelectedItems && createSetFromIterable(params.defaultSelectedItems), [\n params.defaultSelectedItems\n ]),\n state: React.useMemo(()=>params.selectedItems && createSetFromIterable(params.selectedItems), [\n params.selectedItems\n ])\n });\n const changeSelection = (event, nextSelectedItems)=>{\n var _params_onSelectionChange;\n (_params_onSelectionChange = params.onSelectionChange) === null || _params_onSelectionChange === void 0 ? void 0 : _params_onSelectionChange.call(params, event, {\n selectedItems: nextSelectedItems\n });\n if (!event.isDefaultPrevented()) {\n setSelected(nextSelectedItems);\n }\n };\n const methods = {\n toggleItem: (event, itemId)=>{\n const nextSelectedItems = new Set(selected);\n if (selected.has(itemId)) {\n nextSelectedItems.delete(itemId);\n } else {\n nextSelectedItems.add(itemId);\n }\n changeSelection(event, nextSelectedItems);\n },\n selectItem: (event, itemId)=>{\n const nextSelectedItems = new Set(selected);\n nextSelectedItems.add(itemId);\n changeSelection(event, nextSelectedItems);\n },\n deselectItem: (event, itemId)=>{\n const nextSelectedItems = new Set(selected);\n nextSelectedItems.delete(itemId);\n changeSelection(event, nextSelectedItems);\n },\n clearItems: (event)=>{\n changeSelection(event, new Set());\n },\n isSelected: (itemId)=>selected.has(itemId),\n toggleAllItems: (event, itemIds)=>{\n const allItemsSelected = itemIds.every((itemId)=>selected.has(itemId));\n const nextSelectedItems = new Set(selected);\n if (allItemsSelected) {\n nextSelectedItems.clear();\n } else {\n itemIds.forEach((itemId)=>nextSelectedItems.add(itemId));\n }\n changeSelection(event, nextSelectedItems);\n }\n };\n return [\n selected,\n methods\n ];\n}\nexport function useSelection(params) {\n if (params.selectionMode === 'multiselect') {\n // selectionMode is a static value, so we can safely ignore rules-of-hooks\n // eslint-disable-next-line react-hooks/rules-of-hooks\n return useMultipleSelection(params);\n }\n // selectionMode is a static value, so we can safely ignore rules-of-hooks\n // eslint-disable-next-line react-hooks/rules-of-hooks\n return useSingleSelection(params);\n}\n"],"names":["useSelection","useSingleSelection","params","selected","setSelected","useControllableState","initialState","Set","defaultState","React","useMemo","defaultSelectedItems","createSetFromIterable","state","selectedItems","changeSelection","event","nextSelectedItems","_params_onSelectionChange","onSelectionChange","call","isDefaultPrevented","_selected_has","methods","deselectItem","selectItem","itemId","toggleAllItems","process","env","NODE_ENV","Error","toggleItem","clearItems","isSelected","has","useMultipleSelection","delete","add","itemIds","allItemsSelected","every","clear","forEach","selectionMode"],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Creates a set from a given iterable, in case the iterable is a set itself, returns the given set instead.
3
+ */ "use strict";
4
+ Object.defineProperty(exports, "__esModule", {
5
+ value: true
6
+ });
7
+ Object.defineProperty(exports, "createSetFromIterable", {
8
+ enumerable: true,
9
+ get: ()=>createSetFromIterable
10
+ });
11
+ function createSetFromIterable(iterable) {
12
+ return iterable instanceof Set ? iterable : new Set(iterable);
13
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["createSetFromIterable.js"],"sourcesContent":["/**\n * Creates a set from a given iterable, in case the iterable is a set itself, returns the given set instead.\n */ export function createSetFromIterable(iterable) {\n return iterable instanceof Set ? iterable : new Set(iterable);\n}\n"],"names":["createSetFromIterable","iterable","Set"],"mappings":"AAAA;;CAEC;;;;+BAAmBA;;aAAAA;;AAAT,SAASA,sBAAsBC,QAAQ,EAAE;IAChD,OAAOA,oBAAoBC,MAAMD,WAAW,IAAIC,IAAID,SAAS;AACjE"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fluentui/react-utilities",
3
- "version": "9.9.4",
3
+ "version": "9.10.0",
4
4
  "description": "A set of general React-specific utilities.",
5
5
  "main": "lib-commonjs/index.js",
6
6
  "module": "lib/index.js",