@gateweb/react-utils 0.0.1

package/dist/cjs/useCountdown-client-CNjGBIUB.js

@@ -0,0 +1,68 @@
+'use client';
+var react = require('react');
+
+/**
+ * 倒數計時器
+ *
+ * 可以透過 start() 來啟動倒數計時器
+ * 可以透過 stop() 來停止倒數計時器
+ * 可以透過 reset() 來重置倒數計時器
+ *
+ * @param initialCountdown 倒數計時器初始值
+ * @param enableReinitialize 允許重設初始值
+ */ const useCountdown = (initialCountdown, enableReinitialize = false)=>{
+    const [countdown, setCountdown] = react.useState(initialCountdown);
+    const [isCounting, setIsCounting] = react.useState(false);
+    const initialValues = react.useRef(initialCountdown);
+    const isMounted = react.useRef(false);
+    react.useEffect(()=>{
+        isMounted.current = true;
+        return ()=>{
+            isMounted.current = false;
+        };
+    }, []);
+    react.useEffect(()=>{
+        if (isMounted.current && initialValues.current !== initialCountdown && enableReinitialize) {
+            initialValues.current = initialCountdown;
+            setCountdown(initialCountdown);
+        }
+    }, [
+        initialCountdown,
+        enableReinitialize
+    ]);
+    react.useEffect(()=>{
+        let timer;
+        if (isCounting && countdown > 0) {
+            timer = setTimeout(()=>{
+                setCountdown(countdown - 1);
+            }, 1000);
+        } else {
+            setIsCounting(false);
+        }
+        return ()=>{
+            if (timer) clearTimeout(timer);
+        };
+    }, [
+        countdown,
+        isCounting
+    ]);
+    const start = ()=>{
+        setIsCounting(true);
+    };
+    const stop = ()=>{
+        setIsCounting(false);
+    };
+    const reset = ()=>{
+        setCountdown(initialValues.current);
+        setIsCounting(false);
+    };
+    return {
+        countdown,
+        isCounting,
+        start,
+        stop,
+        reset
+    };
+};
+
+exports.useCountdown = useCountdown;

package/dist/cjs/webStorage-client-BGQKUfrO.js

@@ -0,0 +1,53 @@
+'use client';
+/**
+ * 從 localStorage 取得資料，支援槽狀取值
+ *
+ * @param key 鍵值
+ * @param deCode 是否解碼
+ * @returns 取得的資料
+ * @example
+ * const data = getLocalStorage('key');
+ *
+ * const data = getLocalStorage('key.subKey');
+ */ const getLocalStorage = (key, deCode = true)=>{
+    const keys = key.split('.');
+    const storage = localStorage.getItem(keys[0]);
+    if (!storage) return undefined;
+    let currentObject;
+    try {
+        if (deCode) {
+            currentObject = JSON.parse(window.atob(storage));
+        } else {
+            currentObject = JSON.parse(storage);
+        }
+    } catch (error) {
+        return undefined;
+    }
+    // let currentObject = JSON.parse(storage);
+    if (keys.length === 1) {
+        return currentObject;
+    }
+    keys.shift();
+    while(keys.length > 0){
+        const currentKey = keys.shift();
+        if (!currentKey) break;
+        currentObject = currentObject[currentKey];
+        if (!currentObject) break;
+    }
+    return currentObject;
+};
+/**
+ * 將資料存入 localStorage
+ * @param key 鍵值
+ * @param value 可序列化的資料
+ * @param enCode 是否編碼
+ */ const setLocalStorage = (key, value, enCode = true)=>{
+    if (enCode) {
+        localStorage.setItem(key, window.btoa(JSON.stringify(value)));
+    } else {
+        localStorage.setItem(key, JSON.stringify(value));
+    }
+};
+
+exports.getLocalStorage = getLocalStorage;
+exports.setLocalStorage = setLocalStorage;

package/dist/es/download-client-CnaJ0p_f.mjs

@@ -0,0 +1,27 @@
+'use client';
+/**
+ * Downloads a file from a given source.
+ *
+ * @param source - The source of the file to be downloaded. It can be a URL string or a Blob object.
+ * @param filename - The name of the file to be downloaded. Defaults to the current timestamp if not provided.
+ * @param fileExtension - The file extension to be appended to the filename. Optional.
+ *
+ * @example
+ * downloadFile('http://example.com/file.txt', 'testfile', 'txt');
+ * downloadFile(new Blob(['test content'], { type: 'text/plain' }), 'testfile', 'txt');
+ */ const downloadFile = (source, filename = new Date().getTime().toString(), fileExtension)=>{
+    const url = typeof source === 'string' ? source : URL.createObjectURL(source);
+    const link = document.createElement('a');
+    link.id = `download-${new Date().getTime()}`;
+    document.body.appendChild(link);
+    if (!fileExtension) {
+        link.download = filename;
+    } else {
+        link.download = `${filename}.${fileExtension}`;
+    }
+    link.href = url;
+    link.target = '_blank';
+    link.click();
+};
+
+export { downloadFile as d };