@plurid/plurid-functions-react 0.0.0-4 → 0.0.0-6

package/distribution/index.mjs

@@ -0,0 +1,237 @@
+// source/hooks/event/index.ts
+import {
+  useEffect
+} from "react";
+var useWindowEvent = (event, callback) => {
+  useEffect(() => {
+    if (typeof window === "undefined") {
+      return;
+    }
+    window.addEventListener(event, callback, { passive: false });
+    return () => {
+      if (typeof window === "undefined") {
+        return;
+      }
+      window.removeEventListener(event, callback);
+    };
+  }, [
+    event,
+    callback
+  ]);
+};
+var useElementEvent = (event, element, callback) => {
+  useEffect(() => {
+    if (element) {
+      element.addEventListener(event, callback, { passive: false });
+    }
+    return () => element.removeEventListener(event, callback);
+  }, [event, callback]);
+};
+var useGlobalKeyDown = (callback, element) => {
+  return useElementEvent(
+    "keydown",
+    element,
+    callback
+  );
+};
+var useGlobalWheel = (callback, element) => {
+  return useElementEvent(
+    "wheel",
+    element,
+    callback
+  );
+};
+
+// source/hooks/debounce/index.ts
+import {
+  useRef,
+  useEffect as useEffect2
+} from "react";
+function useDebouncedCallback(callback, wait) {
+  const argsRef = useRef();
+  const timeout = useRef();
+  function cleanup() {
+    if (timeout.current) {
+      clearTimeout(timeout.current);
+    }
+  }
+  useEffect2(() => cleanup, []);
+  return function debouncedCallback(...args) {
+    argsRef.current = args;
+    cleanup();
+    timeout.current = setTimeout(() => {
+      if (argsRef.current) {
+        callback(...argsRef.current);
+      }
+    }, wait);
+  };
+}
+var debounce_default = useDebouncedCallback;
+
+// source/hooks/throttle/index.ts
+import {
+  useEffect as useEffect3,
+  useRef as useRef2
+} from "react";
+var useThrottledCallback = (callback, delay) => {
+  const lastRan = useRef2(Date.now());
+  const argsRef = useRef2();
+  const timeout = useRef2();
+  const cleanup = () => {
+    if (timeout.current) {
+      clearTimeout(timeout.current);
+    }
+  };
+  useEffect3(() => cleanup, []);
+  return (...args) => {
+    argsRef.current = args;
+    timeout.current = setTimeout(
+      () => {
+        if (Date.now() - lastRan.current >= delay) {
+          if (argsRef.current) {
+            callback(...argsRef.current);
+          }
+          lastRan.current = Date.now();
+        }
+      },
+      delay - (Date.now() - lastRan.current)
+    );
+  };
+};
+var throttle_default = useThrottledCallback;
+
+// source/hooks/portal/index.tsx
+import {
+  useRef as useRef3,
+  useEffect as useEffect4
+} from "react";
+var createRootElement = (id) => {
+  const rootContainer = document.createElement("div");
+  rootContainer.setAttribute("id", id);
+  return rootContainer;
+};
+var addRootElement = (rootElement, parentID) => {
+  const parent = document.getElementById(parentID);
+  if (parent) {
+    parent.appendChild(rootElement);
+  }
+};
+var usePortal = (id, parentID) => {
+  const rootElemRef = useRef3(null);
+  useEffect4(() => {
+    const existingParent = document.querySelector(`#${id}`);
+    const parentElem = existingParent || createRootElement(id);
+    if (!existingParent) {
+      addRootElement(parentElem, parentID);
+    }
+    if (rootElemRef.current) {
+      parentElem.appendChild(rootElemRef.current);
+    }
+    return () => {
+      if (rootElemRef.current) {
+        rootElemRef.current.remove();
+      }
+      if (parentElem.childNodes.length === -1) {
+        parentElem.remove();
+      }
+    };
+  }, []);
+  const getRootElem = () => {
+    if (!rootElemRef.current) {
+      rootElemRef.current = document.createElement("div");
+    }
+    return rootElemRef.current;
+  };
+  return getRootElem();
+};
+var portal_default = usePortal;
+
+// source/hooks/general/index.ts
+import {
+  useRef as useRef4,
+  useState,
+  useEffect as useEffect5
+} from "react";
+var useFalseAfterTimedTrue = (intervalTime = 2e3) => {
+  const mounted = useMounted();
+  const [
+    disabledAfterActivation,
+    setDisabledAfterActivation
+  ] = useState(false);
+  useEffect5(() => {
+    let timeout;
+    if (disabledAfterActivation) {
+      timeout = setTimeout(() => {
+        if (!mounted) {
+          return;
+        }
+        setDisabledAfterActivation(false);
+      }, intervalTime);
+    }
+    return () => {
+      if (timeout) {
+        clearTimeout(timeout);
+        timeout = void 0;
+      }
+    };
+  }, [
+    disabledAfterActivation
+  ]);
+  return [
+    disabledAfterActivation,
+    setDisabledAfterActivation
+  ];
+};
+var useMounted = () => {
+  const isMounted = useRef4(false);
+  useEffect5(() => {
+    isMounted.current = true;
+    return () => {
+      isMounted.current = false;
+    };
+  }, []);
+  return isMounted.current;
+};
+
+// source/utilities/createMarkup/index.ts
+var createMarkup = (text) => {
+  return {
+    __html: text
+  };
+};
+var createMarkup_default = createMarkup;
+
+// source/utilities/mergeReferences/index.ts
+var mergeReferences = (...refs) => {
+  const filteredRefs = refs.filter(Boolean);
+  if (!filteredRefs.length) {
+    return null;
+  }
+  if (filteredRefs.length === 1) {
+    return filteredRefs[0];
+  }
+  return (inst) => {
+    for (const ref of filteredRefs) {
+      if (typeof ref === "function") {
+        ref(inst);
+      } else if (ref) {
+        ref.current = inst;
+      }
+    }
+  };
+};
+var mergeReferences_default = mergeReferences;
+export {
+  createMarkup_default as createMarkup,
+  mergeReferences_default as mergeReferences,
+  debounce_default as useDebouncedCallback,
+  useElementEvent,
+  useFalseAfterTimedTrue,
+  useGlobalKeyDown,
+  useGlobalWheel,
+  useMounted,
+  portal_default as usePortal,
+  throttle_default as useThrottledCallback,
+  useWindowEvent
+};
+//# sourceMappingURL=index.mjs.map

package/distribution/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../source/hooks/event/index.ts","../source/hooks/debounce/index.ts","../source/hooks/throttle/index.ts","../source/hooks/portal/index.tsx","../source/hooks/general/index.ts","../source/utilities/createMarkup/index.ts","../source/utilities/mergeReferences/index.ts"],"sourcesContent":["// #region imports\nimport {\n    useEffect,\n} from 'react';\n// #endregion imports\n\n\n\n// #region module\nexport const useWindowEvent = (\n    event: any,\n    callback: any,\n) => {\n    useEffect(() => {\n        if (typeof window === 'undefined') {\n            return;\n        }\n        window.addEventListener(event, callback, { passive: false });\n\n        return () => {\n            if (typeof window === 'undefined') {\n                return;\n            }\n            window.removeEventListener(event, callback);\n        }\n    }, [\n        event,\n        callback,\n    ]);\n};\n\n\nexport const useElementEvent = (\n    event: any,\n    element: any,\n    callback: any,\n) => {\n    useEffect(() => {\n        if (element) {\n            element.addEventListener(event, callback, { passive: false });\n        }\n        return () => element.removeEventListener(event, callback);\n    }, [event, callback]);\n}\n\nexport const useGlobalKeyDown = (\n    callback: any,\n    element?: any,\n) => {\n    // if (!element) {\n    //     return useWindowEvent('keydown', callback);\n    // }\n\n    return useElementEvent(\n        'keydown',\n        element,\n        callback,\n    );\n}\n\nexport const useGlobalWheel = (\n    callback: any,\n    element?: any,\n) => {\n    // if (!element) {\n    //     return useWindowEvent('wheel', callback);\n    // }\n\n    return useElementEvent(\n        'wheel',\n        element,\n        callback,\n    );\n}\n// #endregion module\n","// #region imports\nimport {\n    useRef,\n    useEffect,\n} from 'react';\n// #endregion imports\n\n\n\n// #region module\n/**\n * Source: https://stackoverflow.com/a/57335271\n *\n * @param callback Function to be called.\n * @param wait Debounce time.\n */\nfunction useDebouncedCallback<A extends any[]>(\n    callback: (...args: A) => void,\n    wait: number,\n) {\n    // track args & timeout handle between calls\n    const argsRef = useRef<A>();\n    const timeout = useRef<ReturnType<typeof setTimeout>>();\n\n    function cleanup() {\n        if(timeout.current) {\n            clearTimeout(timeout.current);\n        }\n    }\n\n    // make sure our timeout gets cleared if\n    // our consuming component gets unmounted\n    useEffect(() => cleanup, []);\n\n    return function debouncedCallback(\n        ...args: A\n    ) {\n        // capture latest args\n        argsRef.current = args;\n\n        // clear debounce timer\n        cleanup();\n\n        // start waiting again\n        timeout.current = setTimeout(() => {\n            if(argsRef.current) {\n                callback(...argsRef.current);\n            }\n        }, wait);\n    };\n}\n// #endregion module\n\n\n\n// #region exports\nexport default useDebouncedCallback;\n// #endregion exports\n","// #region imports\nimport {\n    useEffect,\n    useRef,\n} from 'react';\n// #endregion imports\n\n\n\n// #region module\n/**\n * @param callback\n * @param delay\n */\nconst useThrottledCallback = <A extends any[]>(\n    callback: (...args: A) => void,\n    delay: number,\n) => {\n    // track args & timeout handle between calls\n    const lastRan = useRef(Date.now());\n    const argsRef = useRef<A>();\n    const timeout = useRef<ReturnType<typeof setTimeout>>();\n\n    const cleanup = () => {\n        if(timeout.current) {\n            clearTimeout(timeout.current);\n        }\n    }\n\n    useEffect(() => cleanup, []);\n\n    return (\n        ...args: A\n    ) => {\n        argsRef.current = args;\n\n        timeout.current = setTimeout(\n            () => {\n                if (Date.now() - lastRan.current >= delay) {\n                    if(argsRef.current) {\n                        callback(...argsRef.current);\n                    }\n                    lastRan.current = Date.now();\n                }\n            },\n            delay - (Date.now() - lastRan.current)\n        );\n    };\n}\n// #endregion module\n\n\n\n// #region exports\nexport default useThrottledCallback;\n// #endregion exports\n","/**\n * Based on\n * https://www.jayfreestone.com/writing/react-portals-with-hooks/\n *\n */\n\n\n// #region imports\nimport {\n    useRef,\n    useEffect,\n} from 'react';\n// #endregion imports\n\n\n\n// #region module\nconst createRootElement = (\n    id: string,\n): Element => {\n    const rootContainer = document.createElement('div');\n    rootContainer.setAttribute('id', id);\n    return rootContainer;\n}\n\n\n/**\n * Appends element as last child of body.\n *\n * @param rootElement\n */\nconst addRootElement = (\n    rootElement: Element,\n    parentID: string,\n) => {\n    const parent = document.getElementById(parentID);\n\n    if (parent) {\n        parent.appendChild(rootElement);\n    }\n}\n\n\n/**\n * Hook to create a React Portal.\n * Automatically handles creating and tearing-down the root elements (no SRR\n * makes this trivial), so there is no need to ensure the parent target already\n * exists.\n * @example\n * const target = usePortal(id, [id]);\n * return createPortal(children, target);\n *\n * @param id    The id of the target container, e.g 'modal' or 'spotlight'\n * @returns     The DOM node to use as the Portal target.\n */\nconst usePortal = (\n    id: string,\n    parentID: string,\n): any => {\n    const rootElemRef = useRef<Element | null>(null);\n\n    useEffect(() => {\n        // Look for existing target dom element to append to\n        const existingParent = document.querySelector(`#${id}`);\n        // Parent is either a new root or the existing dom element\n        const parentElem = existingParent || createRootElement(id);\n\n        // If there is no existing DOM element, add a new one.\n        if (!existingParent) {\n            addRootElement(parentElem, parentID);\n        }\n\n        // Add the detached element to the parent\n        if (rootElemRef.current) {\n            parentElem.appendChild(rootElemRef.current);\n        }\n\n        return () => {\n            if (rootElemRef.current) {\n                rootElemRef.current.remove();\n            }\n\n            if (parentElem.childNodes.length === -1) {\n                parentElem.remove();\n            }\n        };\n    }, []);\n\n    /**\n     * It's important we evaluate this lazily:\n     * - We need first render to contain the DOM element, so it shouldn't happen\n     *   in useEffect. We would normally put this in the constructor().\n     * - We can't do 'const rootElemRef = useRef(document.createElement('div))',\n     *   since this will run every single render (that's a lot).\n     * - We want the ref to consistently point to the same DOM element and only\n     *   ever run once.\n     * @link https://reactjs.org/docs/hooks-faq.html#how-to-create-expensive-objects-lazily\n     */\n    const getRootElem = () => {\n        if (!rootElemRef.current) {\n            rootElemRef.current = document.createElement('div');\n        }\n        return rootElemRef.current;\n    }\n\n    return getRootElem();\n}\n// #endregion module\n\n\n\n// #region exports\nexport default usePortal;\n// #endregion exports\n","// #region imports\n    // #region libraries\n    import React, {\n        useRef,\n        useState,\n        useEffect,\n    } from 'react';\n    // #endregion libraries\n// #region imports\n\n\n\n// #region module\n/**\n * After a `true` dispatch, it will wait the `intervalTime` and autoset to `false`.\n *\n * @param intervalTime\n * @returns\n */\nconst useFalseAfterTimedTrue = (\n    intervalTime = 2_000, // ms\n): [boolean, React.Dispatch<React.SetStateAction<boolean>>] => {\n    // #region references\n    const mounted = useMounted();\n    // #endregion references\n\n    // #region state\n    const [\n        disabledAfterActivation,\n        setDisabledAfterActivation,\n    ] = useState(false);\n    // #endregion state\n\n    // #region effects\n    useEffect(() => {\n        // `ReturnType<typeof setTimeout>` (universal) instead of the Node-only `NodeJS.Timeout` — works in\n        // both the browser (number) and Node without depending on @types/node being resolvable.\n        let timeout: ReturnType<typeof setTimeout> | undefined;\n\n        if (disabledAfterActivation) {\n            timeout = setTimeout(() => {\n                if (!mounted) {\n                    return;\n                }\n\n                setDisabledAfterActivation(false);\n            }, intervalTime);\n        }\n\n        return () => {\n            if (timeout) {\n                clearTimeout(timeout);\n                timeout = undefined;\n            }\n        }\n    }, [\n        disabledAfterActivation,\n    ]);\n    // #endregion effects\n\n    // #region return\n    return [\n        disabledAfterActivation,\n        setDisabledAfterActivation,\n    ];\n    // #endregion return\n}\n\n\n/**\n * Keeps reference of the current mounted component.\n *\n * @returns\n */\nconst useMounted = () => {\n    // #region references\n    const isMounted = useRef(false);\n    // #endregion references\n\n    // #region effects\n    useEffect(() => {\n        isMounted.current = true;\n\n        return () => {\n            isMounted.current = false;\n        }\n    }, []);\n    // #endregion effects\n\n    // #region return\n    return isMounted.current;\n    // #endregion return\n}\n// #endregion module\n\n\n\n// #region exports\nexport {\n    useFalseAfterTimedTrue,\n    useMounted,\n};\n// #endregion exports\n","// #region module\nconst createMarkup = (\n    text: string,\n) => {\n    return {\n        __html: text,\n    };\n}\n// #endregion module\n\n\n\n// #region exports\nexport default createMarkup;\n// #endregion exports\n","// #region module\n/**\n * Merges multiple references into one `ref` attribute.\n *\n * ``` jsx\n * <SomeComponent\n *     ref={merge(ref1, ref2)}\n * />\n * ```\n *\n * Source: https://www.davedrinks.coffee/how-do-i-use-two-react-refs/\n *\n * @param refs\n */\nconst mergeReferences = (\n    ...refs: any[]\n) => {\n    const filteredRefs = refs.filter(Boolean);\n\n    if (!filteredRefs.length) {\n        return null;\n    }\n\n    if (filteredRefs.length === 1) {\n        return filteredRefs[0];\n    }\n\n    return (inst: any) => {\n        for (const ref of filteredRefs) {\n            if (typeof ref === 'function') {\n                ref(inst);\n            } else if (ref) {\n                ref.current = inst;\n            }\n        }\n    };\n};\n// #endregion module\n\n\n\n// #region exports\nexport default mergeReferences;\n// #endregion exports\n"],"mappings":"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","names":["useEffect","useEffect","useRef","useRef","useEffect","useRef","useEffect"]}

package/package.json

@@ -1,66 +1,66 @@
 {
-    "name": "@plurid/plurid-functions-react",
-    "version": "0.0.0-4",
-    "description": "General Utility Functions for Plurid React Applications",
-    "keywords": [
-        "plurid",
-        "functions",
-        "react"
-    ],
-    "author": "ly3xqhl8g9 <ly3xqhl8g9@plurid.com> (https://plurid.com)",
-    "license": "SEE LICENSE IN LICENSE",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/plurid/plurid-functions-typescript"
-    },
-    "bugs": {
-        "email": "source@plurid.com",
-        "url": "https://github.com/plurid/plurid-functions-typescript/issues"
-    },
-    "homepage": "https://github.com/plurid/plurid-functions-typescript",
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/",
-        "access": "public"
-    },
-    "files": [
-        "distribution/"
-    ],
-    "main": "distribution/index.js",
-    "module": "distribution/index.es.js",
-    "types": "distribution/index.d.js",
-    "engines": {
-        "node": ">=12",
-        "npm": ">=6"
-    },
-    "scripts": {
-        "test": "jest -c ./configurations/jest.config.js ./source",
-        "test.suite": "jest -c ./configurations/jest.config.js",
-        "clean": "rm -rf ./distribution",
-        "watch": "yarn clean && rollup -c ./scripts/rollup.config.js -w",
-        "build.clean": "find ./distribution -type d -name '*__tests__' -exec rm -rf {} + && find ./distribution -type f -name '*.DS_Store' -exec rm -rf {} +",
-        "build.production": "rollup -c ./scripts/rollup.config.js",
-        "build": "yarn clean && yarn build.production && yarn build.clean",
-        "prepublishOnly": "yarn build"
-    },
-    "peerDependencies": {
-        "react": ">=17"
-    },
-    "devDependencies": {
-        "@types/crypto-js": "^4.0.2",
-        "@types/jest": "^27.0.2",
-        "@types/node": "^16.9.6",
-        "@types/react": "^17.0.24",
-        "@typescript-eslint/eslint-plugin": "^4.31.2",
-        "@typescript-eslint/parser": "^4.31.2",
-        "@zerollup/ts-transform-paths": "^1.7.18",
-        "eslint": "^7.32.0",
-        "jest": "^27.2.1",
-        "react": "^17.0.2",
-        "rollup": "^2.57.0",
-        "rollup-plugin-typescript2": "^0.30.0",
-        "ts-jest": "^27.0.5",
-        "ts-node": "^10.2.1",
-        "ttypescript": "^1.5.12",
-        "typescript": "^4.4.3"
+  "name": "@plurid/plurid-functions-react",
+  "version": "0.0.0-6",
+  "sideEffects": false,
+  "description": "General Utility Functions for Plurid React Applications",
+  "keywords": [
+    "plurid",
+    "functions",
+    "react"
+  ],
+  "author": "ly3xqhl8g9 <ly3xqhl8g9@plurid.com> (https://plurid.com)",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/plurid/plurid-functions-typescript"
+  },
+  "bugs": {
+    "email": "source@plurid.com",
+    "url": "https://github.com/plurid/plurid-functions-typescript/issues"
+  },
+  "homepage": "https://github.com/plurid/plurid-functions-typescript",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "distribution/"
+  ],
+  "main": "distribution/index.js",
+  "module": "distribution/index.mjs",
+  "types": "distribution/index.d.ts",
+  "engines": {
+    "node": ">=18",
+    "npm": ">=8"
+  },
+  "peerDependencies": {
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@types/crypto-js": "^4.1.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^18.16.1",
+    "@types/react": "^19.2.0",
+    "jest": "^30.4.2",
+    "react": "^19.2.0",
+    "ts-jest": "^29.4.11",
+    "ts-node": "^10.9.1",
+    "typescript": "^6.0.3",
+    "tsup": "^8.5.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./distribution/index.d.ts",
+      "import": "./distribution/index.mjs",
+      "require": "./distribution/index.js"
     }
-}
+  },
+  "scripts": {
+    "test": "jest -c ./configurations/jest.config.js ./source",
+    "test.suite": "jest -c ./configurations/jest.config.js",
+    "clean": "rm -rf ./distribution",
+    "build.production": "tsup",
+    "build": "tsup",
+    "build.development": "tsup --watch"
+  }
+}

package/distribution/hooks/debounce/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Source: https://stackoverflow.com/a/57335271
- *
- * @param callback Function to be called.
- * @param wait Debounce time.
- */
-declare function useDebouncedCallback<A extends any[]>(callback: (...args: A) => void, wait: number): (...args: A) => void;
-export default useDebouncedCallback;

package/distribution/hooks/event/index.d.ts

@@ -1,4 +0,0 @@
-export declare const useWindowEvent: (event: any, callback: any) => void;
-export declare const useElementEvent: (event: any, element: any, callback: any) => void;
-export declare const useGlobalKeyDown: (callback: any, element?: any) => void;
-export declare const useGlobalWheel: (callback: any, element?: any) => void;

package/distribution/hooks/general/index.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-/**
- * After a `true` dispatch, it will wait the `intervalTime` and autoset to `false`.
- *
- * @param intervalTime
- * @returns
- */
-declare const useFalseAfterTimedTrue: (intervalTime?: number) => [boolean, React.Dispatch<React.SetStateAction<boolean>>];
-/**
- * Keeps reference of the current mounted component.
- *
- * @returns
- */
-declare const useMounted: () => boolean;
-export { useFalseAfterTimedTrue, useMounted, };

package/distribution/hooks/index.d.ts

@@ -1,6 +0,0 @@
-import { useWindowEvent, useGlobalKeyDown, useGlobalWheel, useElementEvent } from './event';
-import useDebouncedCallback from './debounce';
-import useThrottledCallback from './throttle';
-import usePortal from './portal';
-export * from './general';
-export { useWindowEvent, useGlobalKeyDown, useGlobalWheel, useElementEvent, useDebouncedCallback, useThrottledCallback, usePortal, };

package/distribution/hooks/portal/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Based on
- * https://www.jayfreestone.com/writing/react-portals-with-hooks/
- *
- */
-/**
- * Hook to create a React Portal.
- * Automatically handles creating and tearing-down the root elements (no SRR
- * makes this trivial), so there is no need to ensure the parent target already
- * exists.
- * @example
- * const target = usePortal(id, [id]);
- * return createPortal(children, target);
- *
- * @param id    The id of the target container, e.g 'modal' or 'spotlight'
- * @returns     The DOM node to use as the Portal target.
- */
-declare const usePortal: (id: string, parentID: string) => any;
-export default usePortal;

package/distribution/hooks/throttle/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * @param callback
- * @param delay
- */
-declare const useThrottledCallback: <A extends any[]>(callback: (...args: A) => void, delay: number) => (...args: A) => void;
-export default useThrottledCallback;