pre-installations and preparations

2024-05-05 11:21:00 +03:30
1 parent 3e5a0329cb
commit 201d621ac3
@@ -0,0 +1,28 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _useCompoundParent = require("./useCompoundParent");
+Object.keys(_useCompoundParent).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useCompoundParent[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useCompoundParent[key];
+    }
+  });
+});
+var _useCompoundItem = require("./useCompoundItem");
+Object.keys(_useCompoundItem).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useCompoundItem[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useCompoundItem[key];
+    }
+  });
+});
@@ -0,0 +1,46 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useCompoundItem = useCompoundItem;
+var React = _interopRequireWildcard(require("react"));
+var _utils = require("@mui/utils");
+var _useCompoundParent = require("./useCompoundParent");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/**
+ * Registers a child component with the parent component.
+ *
+ * @param id A unique key for the child component. If the `id` is `undefined`, the registration logic will not run (this can sometimes be the case during SSR).
+ *   This can be either a value, or a function that generates a value based on already registered siblings' ids.
+ *   If a function, it's called with the set of the ids of all the items that have already been registered.
+ *   Return `existingKeys.size` if you want to use the index of the new item as the id.
+ * @param itemMetadata Arbitrary metadata to pass to the parent component. This should be a stable reference (for example a memoized object), to avoid unnecessary re-registrations.
+ *
+ * @ignore - internal hook.
+ */
+function useCompoundItem(id, itemMetadata) {
+  const context = React.useContext(_useCompoundParent.CompoundComponentContext);
+  if (context === null) {
+    throw new Error('useCompoundItem must be used within a useCompoundParent');
+  }
+  const {
+    registerItem
+  } = context;
+  const [registeredId, setRegisteredId] = React.useState(typeof id === 'function' ? undefined : id);
+  (0, _utils.unstable_useEnhancedEffect)(() => {
+    const {
+      id: returnedId,
+      deregister
+    } = registerItem(id, itemMetadata);
+    setRegisteredId(returnedId);
+    return deregister;
+  }, [registerItem, itemMetadata, id]);
+  return {
+    id: registeredId,
+    index: registeredId !== undefined ? context.getItemIndex(registeredId) : -1,
+    totalItemCount: context.totalSubitemCount
+  };
+}
@@ -0,0 +1,94 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CompoundComponentContext = void 0;
+exports.useCompoundParent = useCompoundParent;
+var React = _interopRequireWildcard(require("react"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const CompoundComponentContext = exports.CompoundComponentContext = /*#__PURE__*/React.createContext(null);
+if (process.env.NODE_ENV !== 'production') {
+  CompoundComponentContext.displayName = 'CompoundComponentContext';
+}
+/**
+ * Sorts the subitems by their position in the DOM.
+ */
+function sortSubitems(subitems) {
+  const subitemsArray = Array.from(subitems.keys()).map(key => {
+    const subitem = subitems.get(key);
+    return {
+      key,
+      subitem
+    };
+  });
+  subitemsArray.sort((a, b) => {
+    const aNode = a.subitem.ref.current;
+    const bNode = b.subitem.ref.current;
+    if (aNode === null || bNode === null || aNode === bNode) {
+      return 0;
+    }
+
+    // eslint-disable-next-line no-bitwise
+    return aNode.compareDocumentPosition(bNode) & Node.DOCUMENT_POSITION_PRECEDING ? 1 : -1;
+  });
+  return new Map(subitemsArray.map(item => [item.key, item.subitem]));
+}
+
+/**
+ * Provides a way for a component to know about its children.
+ *
+ * Child components register themselves with the `useCompoundItem` hook, passing in arbitrary metadata to the parent.
+ *
+ * This is a more powerful altervantive to `children` traversal, as child components don't have to be placed
+ * directly inside the parent component. They can be anywhere in the tree (and even rendered by other components).
+ *
+ * The downside is that this doesn't work with SSR as it relies on the useEffect hook.
+ *
+ * @ignore - internal hook.
+ */
+function useCompoundParent() {
+  const [subitems, setSubitems] = React.useState(new Map());
+  const subitemKeys = React.useRef(new Set());
+  const deregisterItem = React.useCallback(function deregisterItem(id) {
+    subitemKeys.current.delete(id);
+    setSubitems(previousState => {
+      const newState = new Map(previousState);
+      newState.delete(id);
+      return newState;
+    });
+  }, []);
+  const registerItem = React.useCallback(function registerItem(id, item) {
+    let providedOrGeneratedId;
+    if (typeof id === 'function') {
+      providedOrGeneratedId = id(subitemKeys.current);
+    } else {
+      providedOrGeneratedId = id;
+    }
+    subitemKeys.current.add(providedOrGeneratedId);
+    setSubitems(previousState => {
+      const newState = new Map(previousState);
+      newState.set(providedOrGeneratedId, item);
+      return newState;
+    });
+    return {
+      id: providedOrGeneratedId,
+      deregister: () => deregisterItem(providedOrGeneratedId)
+    };
+  }, [deregisterItem]);
+  const sortedSubitems = React.useMemo(() => sortSubitems(subitems), [subitems]);
+  const getItemIndex = React.useCallback(function getItemIndex(id) {
+    return Array.from(sortedSubitems.keys()).indexOf(id);
+  }, [sortedSubitems]);
+  const contextValue = React.useMemo(() => ({
+    getItemIndex,
+    registerItem,
+    totalSubitemCount: subitems.size
+  }), [getItemIndex, registerItem, subitems.size]);
+  return {
+    contextValue,
+    subitems: sortedSubitems
+  };
+}