@react-fabric/data 1.0.0-beta.9 → 1.0.2

package/dist/cjs/tree/useTree.js

@@ -2,98 +2,240 @@
 
 var _defineProperty = require('@babel/runtime/helpers/defineProperty');
 var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
+var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
 var core = require('@react-fabric/core');
 var utilities = require('@react-fabric/utilities');
-var memoizeOne = require('memoize-one');
+var memoize = require('memoize-one');
 var react = require('react');
 var utils = require('./utils.js');
 
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var createItemList = memoizeOne(function (items) {
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var createItemList = memoize(function (items) {
   return items;
 });
-var useTree = function useTree(_ref) {
+function useTree(_ref) {
   var _ref$items = _ref.items,
     items = _ref$items === void 0 ? utilities.EMPTY_ARRAY : _ref$items,
     _ref$checked = _ref.checked,
     checked = _ref$checked === void 0 ? utilities.EMPTY_ARRAY : _ref$checked,
     selected = _ref.selected,
+    multiple = _ref.multiple,
+    sorter = _ref.sorter,
     matcher = _ref.matcher,
+    onLoad = _ref.onLoad,
+    onQuery = _ref.onQuery,
     onSelect = _ref.onSelect,
-    onChecked = _ref.onChecked;
-  var componentEvents = react.useRef({
-    onSelect: onSelect,
-    onChecked: onChecked
-  });
+    onChecked = _ref.onChecked,
+    defaultExpanded = _ref.defaultExpanded,
+    onExpandToggle = _ref.onExpandToggle;
+  var eventSelect = onSelect !== null && onSelect !== void 0 ? onSelect : function () {
+    return undefined;
+  };
+  var eventChecked = onChecked !== null && onChecked !== void 0 ? onChecked : function () {
+    return undefined;
+  };
+  var intialExpandRef = react.useRef(_toConsumableArray(defaultExpanded !== null && defaultExpanded !== void 0 ? defaultExpanded : utilities.EMPTY_ARRAY));
   var itemList = createItemList(items);
+  var fireExpandToggle = react.useCallback(function (itemMap) {
+    var expandedList = itemMap.filter(function (node) {
+      return node.open;
+    }).map(function (node) {
+      return node.id;
+    });
+    setTimeout(function () {
+      return onExpandToggle === null || onExpandToggle === void 0 ? void 0 : onExpandToggle(expandedList);
+    }, 100);
+  }, [onExpandToggle]);
+  var loadChildren = react.useCallback(function (node) {
+    var _node$children;
+    if (node.open && !node.leaf && !((_node$children = node.children) !== null && _node$children !== void 0 && _node$children.length)) {
+      node.loading = true;
+      // delay onload callback to avoid state issues
+      setTimeout(function () {
+        void Promise.resolve(onLoad === null || onLoad === void 0 ? void 0 : onLoad(node.id)).then(function () {
+          var resp = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : utilities.EMPTY_ARRAY;
+          node.children = utils.refactorTree(resp, {
+            sorter: sorter,
+            defaultExpanded: defaultExpanded
+          }, {
+            level: node.level + 1,
+            parent: node.id
+          });
+        })["finally"](function () {
+          var _intialExpandRef$curr;
+          node.loading = false;
+          dispatch({
+            type: "loaded"
+          });
+          if (((_intialExpandRef$curr = intialExpandRef.current) === null || _intialExpandRef$curr === void 0 ? void 0 : _intialExpandRef$curr.length) > 0) dispatch({
+            type: "expand",
+            id: intialExpandRef.current.shift()
+          });
+        });
+      }, 100);
+    } else {
+      var _intialExpandRef$curr2;
+      dispatch({
+        type: "loaded"
+      });
+      if (((_intialExpandRef$curr2 = intialExpandRef.current) === null || _intialExpandRef$curr2 === void 0 ? void 0 : _intialExpandRef$curr2.length) > 0) dispatch({
+        type: "expand",
+        id: intialExpandRef.current.shift()
+      });
+    }
+  },
+  // eslint-disable-next-line @eslint-react/exhaustive-deps
+  [onLoad]);
+  var fireSelected = core.useDebounce(function (nodeId, data) {
+    eventSelect(nodeId, data);
+  }, []);
+  var fireChecked = core.useDebounce(function (leafs, nodes, partials) {
+    eventChecked(leafs, nodes, partials);
+  }, []);
+  var fireQuery = core.useDebounce(function (query) {
+    onQuery === null || onQuery === void 0 || onQuery(query);
+  }, [onQuery]);
   var _useReducer = react.useReducer(function (state, action) {
       if (action.type === "load") {
-        state.items = utils.refactorTree(action.items);
+        state.items = utils.refactorTree(action.items, {
+          sorter: sorter,
+          defaultExpanded: defaultExpanded
+        });
         state.itemMap = utils.makeTreeMap(state.items);
         state.tree = utils.flattenTree(state.items);
+        state.selected = undefined;
+        state.checked = undefined;
+        state.query = "";
         return _objectSpread({}, state);
       }
       if (action.type === "toggleExpand") {
         var node = state.itemMap.get(action.id);
-        node && (node.open = !node.open);
+        if (node && !node.leaf) {
+          if (node) node.open = !node.open;
+          loadChildren(node);
+          return _objectSpread({}, state);
+        }
+      }
+      if (action.type === "loaded") {
+        var _state$checked;
+        state.itemMap = utils.makeTreeMap(state.items);
+        fireExpandToggle(Array.from(state.itemMap.values()));
         state.tree = utils.flattenTree(state.items);
+        state.selected = selected;
+        utils.updateSelection({
+          nodes: state.itemMap,
+          multiple: multiple,
+          selected: selected
+        });
+        (_state$checked = state.checked) === null || _state$checked === void 0 || _state$checked.forEach(function (id) {
+          return utils.updateChecked(state.itemMap, id, 1);
+        });
         return _objectSpread({}, state);
       }
       if (action.type === "expand") {
-        // TODO: check if children available, if not call onLoad to fetch node children
         var _node = state.itemMap.get(action.id);
-        _node && (_node.open = true);
-        state.tree = utils.flattenTree(state.items);
-        return _objectSpread({}, state);
+        if (_node && !_node.leaf) {
+          _node.open = true;
+          var parentId = _node.parent;
+          while (parentId) {
+            var _node2 = state.itemMap.get(parentId);
+            if (_node2) _node2.open = true;
+            parentId = _node2 === null || _node2 === void 0 ? void 0 : _node2.parent;
+          }
+          loadChildren(_node);
+          return _objectSpread({}, state);
+        }
       }
       if (action.type === "expandAll") {
-        // TODO: prevent opening dynamic nodes that dont have children
         state.itemMap.forEach(function (node) {
-          !node.leaf && (node.open = true);
+          var _node$children2;
+          if (!node.leaf && (_node$children2 = node.children) !== null && _node$children2 !== void 0 && _node$children2.length) node.open = true;
         });
+        fireExpandToggle(Array.from(state.itemMap.values()));
         state.tree = utils.flattenTree(state.items);
         return _objectSpread({}, state);
       }
       if (action.type === "collapseAll") {
         state.itemMap.forEach(function (node) {
-          !node.leaf && (node.open = false);
+          if (!node.leaf) node.open = false;
         });
+        fireExpandToggle([]);
         state.tree = utils.flattenTree(state.items);
         return _objectSpread({}, state);
       }
       if (action.type === "filter") {
-        utils.filterTree(state.itemMap, action.query, matcher);
+        if (onQuery) {
+          // TODO: onQuery should provide new tree listing
+          // save current tree state as preQueryState
+          // on clearing filter restore preQueryState
+          if (!utilities.isEmpty(action.query)) {
+            // state.prevItems = state.items;
+            fireQuery(action.query);
+          }
+        } else {
+          utils.filterTree(state.itemMap, action.query, matcher);
+          state.tree = utils.flattenTree(state.items);
+        }
+        return _objectSpread(_objectSpread({}, state), {}, {
+          query: action.query
+        });
+      }
+      if (action.type === "toggleSelect") {
+        var _state$itemMap$get;
+        if (multiple) {
+          var _state$selected, _state$selected$filte, _state$selected2, _state$selected3;
+          var isSelected = (_state$selected = state.selected) === null || _state$selected === void 0 ? void 0 : _state$selected.includes(action.id);
+          // @ts-expect-error ignore
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call
+          if (action.shiftKey && isSelected) state.selected = (_state$selected$filte = (_state$selected2 = state.selected) === null || _state$selected2 === void 0 ? void 0 : _state$selected2.filter(function (id) {
+            return id !== action.id;
+          })) !== null && _state$selected$filte !== void 0 ? _state$selected$filte : [];else if (action.shiftKey && !isSelected) state.selected = [].concat(_toConsumableArray((_state$selected3 = state.selected) !== null && _state$selected3 !== void 0 ? _state$selected3 : []), [action.id]);else state.selected = [action.id];
+        } else {
+          state.selected = action.id;
+        }
+        utils.updateSelection({
+          nodes: state.itemMap,
+          selected: state.selected,
+          multiple: multiple
+        });
         state.tree = utils.flattenTree(state.items);
+        fireSelected(state.selected, (_state$itemMap$get = state.itemMap.get(action.id)) === null || _state$itemMap$get === void 0 ? void 0 : _state$itemMap$get.data);
         return _objectSpread({}, state);
       }
       if (action.type === "select") {
-        var _componentEvents$curr, _componentEvents$curr2;
-        if (state.selected) {
-          utils.updateSelection(state.itemMap, state.selected);
-        }
-        utils.updateSelection(state.itemMap, action.id, true);
-        state.tree = utils.flattenTree(state.items);
-        (_componentEvents$curr = (_componentEvents$curr2 = componentEvents.current).onSelect) === null || _componentEvents$curr === void 0 || _componentEvents$curr.call(_componentEvents$curr2, action.id);
-        return _objectSpread(_objectSpread({}, state), {}, {
+        state.selected = action.id;
+        utils.updateSelection({
+          nodes: state.itemMap,
+          multiple: multiple,
           selected: action.id
         });
+        state.tree = utils.flattenTree(state.items);
+        return _objectSpread({}, state);
       }
       if (action.type === "toggleCheck") {
-        var _componentEvents$curr3, _componentEvents$curr4;
         utils.updateChecked(state.itemMap, action.id);
-        var checkList = [[], []];
+        var checkList = [[], [], []];
         Array.from(state.itemMap.values()).filter(function (node) {
-          return node.checked === 1;
+          return node.checked !== 0;
         }).forEach(function (node) {
-          return checkList[node.leaf ? 0 : 1].push(node.id);
+          return checkList[node.leaf ? 0 : node.checked].push(node.id);
+        });
+        fireChecked(checkList[0],
+        // leafs
+        checkList[1],
+        // nodes
+        checkList[2]);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          checked: checkList[0]
         });
-        (_componentEvents$curr3 = (_componentEvents$curr4 = componentEvents.current).onChecked) === null || _componentEvents$curr3 === void 0 || _componentEvents$curr3.call(_componentEvents$curr4, checkList[0], checkList[1]);
-        return _objectSpread({}, state);
       }
       if (action.type === "checked") {
+        state.itemMap.forEach(function (item) {
+          return item.checked = 0;
+        });
         action.id.forEach(function (id) {
-          return utils.updateChecked(state.itemMap, id);
+          return utils.updateChecked(state.itemMap, id, 1);
         });
         return _objectSpread(_objectSpread({}, state), {}, {
           checked: action.id
@@ -104,31 +246,40 @@ var useTree = function useTree(_ref) {
       itemMap: new Map(),
       items: [],
       tree: [],
-      checked: []
+      checked: [],
+      query: ""
     }),
     _useReducer2 = _slicedToArray(_useReducer, 2),
     state = _useReducer2[0],
     dispatch = _useReducer2[1];
   react.useEffect(function () {
-    componentEvents.current = {
-      onSelect: onSelect,
-      onChecked: onChecked
-    };
-  }, [onSelect, onChecked]);
-  react.useEffect(function () {
+    var _intialExpandRef$curr3;
     dispatch({
       type: "load",
       items: itemList
     });
+    if (itemList.length && ((_intialExpandRef$curr3 = intialExpandRef.current) === null || _intialExpandRef$curr3 === void 0 ? void 0 : _intialExpandRef$curr3.length) > 0) dispatch({
+      type: "expand",
+      id: intialExpandRef.current.shift()
+    });
+    if (selected) dispatch({
+      type: "select",
+      id: selected
+    });
+    if (checked) dispatch({
+      type: "checked",
+      id: checked
+    });
+    // eslint-disable-next-line @eslint-react/exhaustive-deps
   }, [itemList]);
   react.useEffect(function () {
-    selected && dispatch({
+    if (selected) dispatch({
       type: "select",
       id: selected
     });
   }, [selected]);
   react.useEffect(function () {
-    checked && dispatch({
+    if (checked) dispatch({
       type: "checked",
       id: checked
     });
@@ -146,9 +297,11 @@ var useTree = function useTree(_ref) {
     });
   }, []);
   var select = react.useCallback(function (id) {
+    var shiftKey = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
     dispatch({
-      type: "select",
-      id: id
+      type: "toggleSelect",
+      id: id,
+      shiftKey: shiftKey
     });
   }, []);
   var expand = react.useCallback(function (id) {
@@ -157,6 +310,15 @@ var useTree = function useTree(_ref) {
       id: id
     });
   }, []);
+  var expandAndLoad = react.useCallback(function (expandList) {
+    if (expandList.length > 0) {
+      intialExpandRef.current = _toConsumableArray(expandList);
+      dispatch({
+        type: "expand",
+        id: intialExpandRef.current.shift()
+      });
+    }
+  }, []);
   var expandAll = react.useCallback(function () {
     dispatch({
       type: "expandAll"
@@ -172,17 +334,20 @@ var useTree = function useTree(_ref) {
       type: "filter",
       query: query
     });
-  }, []);
+  }, [], 300);
   return {
     tree: state.tree,
+    query: state.query,
+    selected: state.selected,
     toggleExpand: toggleExpand,
     expandAll: expandAll,
     collapseAll: collapseAll,
     toggleCheck: toggleCheck,
+    expandAndLoad: expandAndLoad,
     select: select,
     expand: expand,
     onFilter: onFilter
   };
-};
+}
 
 exports.useTree = useTree;

package/dist/cjs/tree/utils.js

@@ -5,18 +5,18 @@ var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
 var utilities = require('@react-fabric/utilities');
 
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var sorter = function sorter(a, b) {
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function defaultSorter(a, b) {
   if (!!a.leaf !== !!b.leaf) return a.leaf ? 1 : -1;
   return utilities.compareValues()(a.label, b.label);
-};
-var getChildren = function getChildren() {
+}
+function getChildren() {
   var list = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   return list.map(function (item) {
     return [item].concat(_toConsumableArray(getChildren(item.children)));
   }).flat(99).filter(Boolean);
-};
-var getIntermediate = function getIntermediate() {
+}
+function getIntermediate() {
   var list = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   var checks = list.map(function (item) {
     return item.checked;
@@ -25,18 +25,24 @@ var getIntermediate = function getIntermediate() {
   var someInt = checks.includes(2);
   var someOn = checks.includes(1);
   return someOff && someOn || someInt ? 2 : someOn ? 1 : 0;
-};
+}
 
 // convert node item to internal node used by the tree
-var refactorTree = function refactorTree(nodes) {
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+function refactorTree(nodes, _ref) {
+  var _ref$sorter = _ref.sorter,
+    sorter = _ref$sorter === void 0 ? defaultSorter : _ref$sorter,
+    _ref$defaultExpanded = _ref.defaultExpanded,
+    defaultExpanded = _ref$defaultExpanded === void 0 ? [] : _ref$defaultExpanded;
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {
     level: 0,
     parent: undefined
   };
   var list = [];
-  nodes.sort(sorter).forEach(function (node) {
+  if (sorter !== false) nodes = nodes.sort(sorter);
+  nodes.forEach(function (node) {
+    var _node$children;
     list.push(_objectSpread(_objectSpread({
-      open: false,
+      open: defaultExpanded.includes(node.id) && !!((_node$children = node.children) !== null && _node$children !== void 0 && _node$children.length),
       level: options.level,
       parent: options.parent,
       checked: 0,
@@ -47,71 +53,92 @@ var refactorTree = function refactorTree(nodes) {
     }, node), {}, {
       leaf: !!node.leaf,
       children: node.children && refactorTree(node.children, {
+        sorter: sorter,
+        defaultExpanded: defaultExpanded
+      }, {
         level: options.level + 1,
         parent: node.id
       })
     }));
   });
   return list;
-};
-var makeTreeMap = function makeTreeMap(nodes) {
+}
+function makeTreeMap(nodes) {
   var map = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : new Map();
   nodes.forEach(function (node) {
     if (map.has(node.id)) throw new Error("Node with id [".concat(node.id, "] already exists, please make sure all ids are unique"));
     map.set(node.id, node);
-    node.children && makeTreeMap(node.children, map);
+    if (node.children) makeTreeMap(node.children, map);
   });
   return map;
-};
+}
 
 // make flat list to be rendered by virtual list
-var flattenTree = function flattenTree(nodes) {
+function flattenTree(nodes) {
   var lines = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
   var list = [];
   var filtered = nodes.filter(function (node) {
     return !node.filtered;
   });
   filtered.forEach(function (node, idx) {
+    var _node$children2;
     node.lines = [].concat(_toConsumableArray(lines), [idx === filtered.length - 1 ? 2 : 3]);
     list.push(node);
-    (node.open || node.childFiltered) && node.children && list.push.apply(list, _toConsumableArray(flattenTree(node.children.filter(function (child) {
+    if ((node.open || node.childFiltered) && node.children) list.push.apply(list, _toConsumableArray(flattenTree(node.children.filter(function (child) {
       return !child.filtered;
     }), [].concat(_toConsumableArray(lines), [idx === filtered.length - 1 ? 0 : 1]))));
+    if (node.open && ((_node$children2 = node.children) === null || _node$children2 === void 0 ? void 0 : _node$children2.length) === 0) list.push({
+      empty: true,
+      leaf: true,
+      lines: [].concat(_toConsumableArray(lines), [idx === filtered.length - 1 ? 0 : 1, 2])
+    });
   });
   return list;
-};
-var updateSelection = function updateSelection(nodes, id, selected) {
-  var node = nodes.get(id);
+}
+function selectNode(nodes, id) {
+  var node = nodes.get(id !== null && id !== void 0 ? id : "");
   if (node) {
     // change selection
-    node.selected = selected;
+    node.selected = true;
     // update all parent childSelected flag
     var parent = node.parent;
     while (parent) {
       var parentNode = nodes.get(parent);
-      parentNode && (parentNode.childSelected = selected);
-      selected && parentNode && (parentNode.open = true);
+      if (parentNode) parentNode.childSelected = true;
+      // selected && parentNode && (parentNode.open = true);
       parent = parentNode === null || parentNode === void 0 ? void 0 : parentNode.parent;
     }
   }
-};
-var updateChecked = function updateChecked(list, id) {
+}
+function updateSelection(_ref2) {
+  var nodes = _ref2.nodes,
+    multiple = _ref2.multiple,
+    selected = _ref2.selected;
+  nodes.forEach(function (node) {
+    node.selected = undefined;
+    node.childSelected = undefined;
+  });
+  if (multiple && utilities.isArray(selected)) selected === null || selected === void 0 || selected.forEach(function (id) {
+    return selectNode(nodes, id);
+  });else selectNode(nodes, selected);
+}
+function updateChecked(list, id, checked) {
   var node = list.get(id);
   if (node) {
-    node.checked = node.checked === 1 ? 0 : 1;
+    node.checked = (checked !== null && checked !== void 0 ? checked : node.checked === 0) ? 1 : 0;
     // check all children
-    node.children && getChildren(node.children).forEach(function (child) {
+    if (node.children) getChildren(node.children).forEach(function (child) {
       return child.checked = node.checked;
     });
     var parent = node.parent;
     while (parent) {
       var parentNode = list.get(parent);
-      parentNode && (parentNode.checked = getIntermediate(parentNode.children));
+      if (parentNode) parentNode.checked = getIntermediate(parentNode.children);
       parent = parentNode === null || parentNode === void 0 ? void 0 : parentNode.parent;
     }
   }
-};
-var filterTree = function filterTree(nodes, query, matcher) {
+}
+function filterTree(nodes, query, matcher) {
   nodes.forEach(function (node) {
     if (query) {
       if (node.parentFiltered) return;
@@ -120,11 +147,13 @@ var filterTree = function filterTree(nodes, query, matcher) {
         var parent = node.parent;
         while (parent) {
           var parentNode = nodes.get(parent);
-          parentNode && (parentNode.filtered = false);
-          parentNode && (parentNode.childFiltered = true);
+          if (parentNode) {
+            parentNode.filtered = false;
+            parentNode.childFiltered = true;
+          }
           parent = parentNode === null || parentNode === void 0 ? void 0 : parentNode.parent;
         }
-        node.children && getChildren(node.children).forEach(function (child) {
+        if (node.children) getChildren(node.children).forEach(function (child) {
           child.parentFiltered = true;
           child.filtered = false;
         });
@@ -135,7 +164,7 @@ var filterTree = function filterTree(nodes, query, matcher) {
       node.parentFiltered = undefined;
     }
   });
-};
+}
 
 exports.filterTree = filterTree;
 exports.flattenTree = flattenTree;

package/dist/cjs/utils/getColor.js

@@ -0,0 +1,58 @@
+'use strict';
+
+var utilities = require('@react-fabric/utilities');
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+
+/**
+ * Resolves a color value to a CSS color string.
+ *
+ * If the input is a valid CSS color (e.g., `"#ff0000"`, `"rgb(255,0,0)"`), it is returned as-is.
+ * Otherwise, it is treated as a design token name and resolved to a CSS custom property
+ * (e.g., `"primary-500"` → `"var(--color-primary-500)"`).
+ *
+ * @param {ColorUnion} color - The color value to resolve. Accepts CSS color strings or design token names.
+ * @returns The resolved CSS color string, or `undefined` if color is falsy.
+ *
+ * @example
+ * ```ts
+ * getColor("primary-500");    // "var(--color-primary-500)"
+ * getColor("#ff0000");       // "#ff0000"
+ * getColor("red");           // "var(--color-red)"
+ * getColor(undefined);       // undefined
+ * ```
+ */
+function getColor(color) {
+  if (!color) return undefined;
+  if (color && utilities.isColor(color)) {
+    return color;
+  }
+  if (color.startsWith("--")) return "var(".concat(color, ")");
+  return "var(--color-".concat(color, ")");
+}
+
+exports.getColor = getColor;