@cyberskill/shared 3.10.0 → 3.12.0

package/dist/react/apollo-error/apollo-error.component.js

@@ -27,7 +27,10 @@ function c() {
 	};
 	if (!c) return null;
 	let p = "locations" in c || "path" in c || "extensions" in c, m = "message" in c ? c.message : "Unknown error occurred";
-	return /* @__PURE__ */ r.createElement("div", { className: n["modal-backdrop"] }, /* @__PURE__ */ r.createElement("div", {
+	return /* @__PURE__ */ r.createElement("div", {
+		className: n["modal-backdrop"],
+		onClick: l
+	}, /* @__PURE__ */ r.createElement("div", {
 		ref: u,
 		className: n["modal-content"],
 		role: "dialog",
@@ -35,7 +38,8 @@ function c() {
 		"aria-labelledby": "apollo-error-title",
 		"aria-describedby": "apollo-error-details",
 		tabIndex: -1,
-		onKeyDown: f
+		onKeyDown: f,
+		onClick: (e) => e.stopPropagation()
 	}, /* @__PURE__ */ r.createElement("button", {
 		type: "button",
 		className: n["btn-close"],

package/dist/react/apollo-error/apollo-error.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-error.component.js","names":[],"sources":["../../../src/react/apollo-error/apollo-error.component.tsx"],"sourcesContent":["import * as React from 'react';\nimport { use, useEffect, useRef } from 'react';\n\nimport { validate } from '#util/validate/validate.util.js';\n\nimport { ApolloErrorContext } from './apollo-error.context.js';\nimport style from './apollo-error.module.scss';\n\nconst FOCUSABLE_SELECTORS = 'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * Apollo Error Component that displays detailed error information in a modal.\n * This component provides a comprehensive error display interface that shows\n * GraphQL errors and other error types with detailed information for debugging purposes.\n *\n * Features:\n * - Modal overlay with backdrop for focus\n * - Detailed error categorization and display\n * - Reload functionality for error recovery\n * - Close button to dismiss the error modal\n * - Structured display of different error types\n * - Extra information display for debugging\n *\n * @returns A modal component displaying Apollo error details, or null if no error is present.\n */\nexport function ApolloErrorComponent() {\n    const context = use(ApolloErrorContext);\n    const { error, hideError } = context ?? {};\n    const dialogRef = useRef<HTMLDivElement>(null);\n    const previousFocusRef = useRef<HTMLElement | null>(null);\n\n    useEffect(() => {\n        if (!error || !hideError)\n            return;\n\n        const handleKeyDown = (event: KeyboardEvent) => {\n            if (event.key === 'Escape') {\n                hideError();\n            }\n        };\n\n        window.addEventListener('keydown', handleKeyDown);\n\n        return () => {\n            window.removeEventListener('keydown', handleKeyDown);\n        };\n    }, [error, hideError]);\n\n    useEffect(() => {\n        if (error && dialogRef.current) {\n            previousFocusRef.current = document.activeElement as HTMLElement;\n            dialogRef.current.focus();\n        }\n        else if (!error && previousFocusRef.current) {\n            previousFocusRef.current.focus();\n            previousFocusRef.current = null;\n        }\n    }, [error]);\n\n    const handleFocusTrap = (event: React.KeyboardEvent<HTMLDivElement>) => {\n        if (event.key !== 'Tab' || !dialogRef.current)\n            return;\n\n        const focusableElements = [...dialogRef.current.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTORS)].filter(el => !el.hasAttribute('disabled'));\n\n        if (focusableElements.length === 0)\n            return;\n\n        const firstElement = focusableElements[0];\n        const lastElement = focusableElements.at(-1);\n\n        if (!firstElement || !lastElement)\n            return;\n\n        if (event.shiftKey) {\n            if (document.activeElement === firstElement) {\n                event.preventDefault();\n                lastElement.focus();\n            }\n        }\n        else if (document.activeElement === lastElement) {\n            event.preventDefault();\n            firstElement.focus();\n        }\n    };\n\n    if (!error) {\n        return null;\n    }\n\n    const isGraphQLError = 'locations' in error || 'path' in error || 'extensions' in error;\n    const errorMessage = 'message' in error ? error.message : 'Unknown error occurred';\n\n    return (\n        <div className={style['modal-backdrop']}>\n            <div\n                ref={dialogRef}\n                className={style['modal-content']}\n                role=\"dialog\"\n                aria-modal=\"true\"\n                aria-labelledby=\"apollo-error-title\"\n                aria-describedby=\"apollo-error-details\"\n                tabIndex={-1}\n                onKeyDown={handleFocusTrap}\n            >\n                <button\n                    type=\"button\"\n                    className={style['btn-close']}\n                    onClick={hideError}\n                    aria-label=\"Close error details (Esc)\"\n                    aria-keyshortcuts=\"Escape\"\n                    title=\"Close error details (Esc)\"\n                >\n                    ✕\n                </button>\n                <div className={style['error-title']}>\n                    <button\n                        type=\"button\"\n                        className={style['btn-retry']}\n                        onClick={() => window.location.reload()}\n                        aria-label=\"Reload page\"\n                    >\n                        Reload\n                    </button>\n                    {' '}\n                    <span id=\"apollo-error-title\">\n                        {errorMessage || 'Error details'}\n                    </span>\n                </div>\n                <div id=\"apollo-error-details\" className={style['error-details']}>\n                    {isGraphQLError && 'locations' in error && error.locations && (\n                        <pre className=\"locations\">\n                            <strong>Locations:</strong>\n                            {' '}\n                            {JSON.stringify(error.locations, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'path' in error && error.path && (\n                        <pre className=\"path\">\n                            <strong>Path:</strong>\n                            {' '}\n                            {JSON.stringify(error.path, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'extensions' in error && error.extensions && (\n                        <pre className=\"extensions\">\n                            <strong>Extensions:</strong>\n                            {' '}\n                            {JSON.stringify(error.extensions, null, 4)}\n                        </pre>\n                    )}\n                    {!isGraphQLError && (\n                        <pre className=\"error-details\">\n                            <strong>Error Details:</strong>\n                            {' '}\n                            {validate.isEmpty(error) ? errorMessage : JSON.stringify(error, null, 4)}\n                        </pre>\n                    )}\n                </div>\n            </div>\n        </div>\n    );\n}\n"],"mappings":"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"}
+{"version":3,"file":"apollo-error.component.js","names":[],"sources":["../../../src/react/apollo-error/apollo-error.component.tsx"],"sourcesContent":["import * as React from 'react';\nimport { use, useEffect, useRef } from 'react';\n\nimport { validate } from '#util/validate/validate.util.js';\n\nimport { ApolloErrorContext } from './apollo-error.context.js';\nimport style from './apollo-error.module.scss';\n\nconst FOCUSABLE_SELECTORS = 'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * Apollo Error Component that displays detailed error information in a modal.\n * This component provides a comprehensive error display interface that shows\n * GraphQL errors and other error types with detailed information for debugging purposes.\n *\n * Features:\n * - Modal overlay with backdrop for focus\n * - Detailed error categorization and display\n * - Reload functionality for error recovery\n * - Close button to dismiss the error modal\n * - Structured display of different error types\n * - Extra information display for debugging\n *\n * @returns A modal component displaying Apollo error details, or null if no error is present.\n */\nexport function ApolloErrorComponent() {\n    const context = use(ApolloErrorContext);\n    const { error, hideError } = context ?? {};\n    const dialogRef = useRef<HTMLDivElement>(null);\n    const previousFocusRef = useRef<HTMLElement | null>(null);\n\n    useEffect(() => {\n        if (!error || !hideError)\n            return;\n\n        const handleKeyDown = (event: KeyboardEvent) => {\n            if (event.key === 'Escape') {\n                hideError();\n            }\n        };\n\n        window.addEventListener('keydown', handleKeyDown);\n\n        return () => {\n            window.removeEventListener('keydown', handleKeyDown);\n        };\n    }, [error, hideError]);\n\n    useEffect(() => {\n        if (error && dialogRef.current) {\n            previousFocusRef.current = document.activeElement as HTMLElement;\n            dialogRef.current.focus();\n        }\n        else if (!error && previousFocusRef.current) {\n            previousFocusRef.current.focus();\n            previousFocusRef.current = null;\n        }\n    }, [error]);\n\n    const handleFocusTrap = (event: React.KeyboardEvent<HTMLDivElement>) => {\n        if (event.key !== 'Tab' || !dialogRef.current)\n            return;\n\n        const focusableElements = [...dialogRef.current.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTORS)].filter(el => !el.hasAttribute('disabled'));\n\n        if (focusableElements.length === 0)\n            return;\n\n        const firstElement = focusableElements[0];\n        const lastElement = focusableElements.at(-1);\n\n        if (!firstElement || !lastElement)\n            return;\n\n        if (event.shiftKey) {\n            if (document.activeElement === firstElement) {\n                event.preventDefault();\n                lastElement.focus();\n            }\n        }\n        else if (document.activeElement === lastElement) {\n            event.preventDefault();\n            firstElement.focus();\n        }\n    };\n\n    if (!error) {\n        return null;\n    }\n\n    const isGraphQLError = 'locations' in error || 'path' in error || 'extensions' in error;\n    const errorMessage = 'message' in error ? error.message : 'Unknown error occurred';\n\n    return (\n        <div className={style['modal-backdrop']} onClick={hideError}>\n            <div\n                ref={dialogRef}\n                className={style['modal-content']}\n                role=\"dialog\"\n                aria-modal=\"true\"\n                aria-labelledby=\"apollo-error-title\"\n                aria-describedby=\"apollo-error-details\"\n                tabIndex={-1}\n                onKeyDown={handleFocusTrap}\n                onClick={e => e.stopPropagation()}\n            >\n                <button\n                    type=\"button\"\n                    className={style['btn-close']}\n                    onClick={hideError}\n                    aria-label=\"Close error details (Esc)\"\n                    aria-keyshortcuts=\"Escape\"\n                    title=\"Close error details (Esc)\"\n                >\n                    ✕\n                </button>\n                <div className={style['error-title']}>\n                    <button\n                        type=\"button\"\n                        className={style['btn-retry']}\n                        onClick={() => window.location.reload()}\n                        aria-label=\"Reload page\"\n                    >\n                        Reload\n                    </button>\n                    {' '}\n                    <span id=\"apollo-error-title\">\n                        {errorMessage || 'Error details'}\n                    </span>\n                </div>\n                <div id=\"apollo-error-details\" className={style['error-details']}>\n                    {isGraphQLError && 'locations' in error && error.locations && (\n                        <pre className=\"locations\">\n                            <strong>Locations:</strong>\n                            {' '}\n                            {JSON.stringify(error.locations, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'path' in error && error.path && (\n                        <pre className=\"path\">\n                            <strong>Path:</strong>\n                            {' '}\n                            {JSON.stringify(error.path, null, 4)}\n                        </pre>\n                    )}\n                    {isGraphQLError && 'extensions' in error && error.extensions && (\n                        <pre className=\"extensions\">\n                            <strong>Extensions:</strong>\n                            {' '}\n                            {JSON.stringify(error.extensions, null, 4)}\n                        </pre>\n                    )}\n                    {!isGraphQLError && (\n                        <pre className=\"error-details\">\n                            <strong>Error Details:</strong>\n                            {' '}\n                            {validate.isEmpty(error) ? errorMessage : JSON.stringify(error, null, 4)}\n                        </pre>\n                    )}\n                </div>\n            </div>\n        </div>\n    );\n}\n"],"mappings":"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"}

package/dist/react/apollo-error/index.d.ts

@@ -1,6 +1 @@
-export * from './apollo-error.component.js';
-export * from './apollo-error.context.js';
-export * from './apollo-error.hook.js';
-export * from './apollo-error.provider.js';
-export * from './apollo-error.type.js';
-export * from './apollo-error.util.js';
+export {}

package/dist/react/i18next/index.d.ts

@@ -1,2 +1 @@
-export * from './i18next.hook.js';
-export * from './i18next.util.js';
+export {}

package/dist/react/loading/index.d.ts

@@ -1,5 +1 @@
-export * from './loading.component.js';
-export * from './loading.context.js';
-export * from './loading.hook.js';
-export * from './loading.provider.js';
-export * from './loading.type.js';
+export {}

package/dist/react/log/index.d.ts

@@ -1,2 +1 @@
-export * from './log.type.js';
-export * from './log.util.js';
+export {}

package/dist/react/next-intl/index.d.ts

@@ -1,6 +1 @@
-export * from './next-intl.constant.js';
-export * from './next-intl.context.js';
-export * from './next-intl.hoc.js';
-export * from './next-intl.hook.js';
-export * from './next-intl.provider.js';
-export * from './next-intl.type.js';
+export {}

package/dist/react/storage/index.d.ts

@@ -1,2 +1 @@
-export * from './storage.hook.js';
-export * from './storage.util.js';
+export {}

package/dist/react/storage/storage.hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.hook.js","names":[],"sources":["../../../src/react/storage/storage.hook.tsx"],"sourcesContent":["import { useCallback, useEffect, useState } from 'react';\n\nimport type { I_Serializer } from '#util/serializer/index.js';\n\nimport { serializer as defaultSerializer } from '#util/serializer/index.js';\n\nimport { catchError } from '../log/index.js';\nimport { storage } from './storage.util.js';\n\n/**\n * React hook that provides persistent storage functionality with automatic serialization.\n * This hook manages state that persists across browser sessions using localForage,\n * with automatic serialization/deserialization of complex data types. It provides\n * a React-friendly interface for storage operations with proper error handling.\n *\n * Features:\n * - Automatic data serialization and deserialization\n * - Persistent storage across browser sessions\n * - Initial value handling and fallback\n * - Error handling with graceful degradation\n * - Automatic storage synchronization\n * - Support for complex data types via custom serializers\n *\n * @param key - The unique storage key for the data.\n * @param initialValue - Optional initial value to use if no stored value exists.\n * @param serializer - Optional custom serializer for complex data types (defaults to JSON serializer).\n * @returns An object containing the current value, set function, and remove function.\n */\nexport function useStorage<T>(\n    key: string,\n    initialValue?: T,\n    serializer: I_Serializer<T> = defaultSerializer as I_Serializer<T>,\n) {\n    const [value, setValue] = useState<T | undefined>(initialValue);\n    const [isLoaded, setIsLoaded] = useState(false);\n\n    useEffect(() => {\n        let isMounted = true;\n\n        const loadValue = async () => {\n            try {\n                const valueFound = await storage.get<string>(key);\n\n                if (isMounted) {\n                    if (valueFound !== null) {\n                        const parsedValue = serializer.deserialize(valueFound);\n                        setValue(parsedValue);\n                    }\n                    else if (initialValue !== undefined) {\n                        const serialized = serializer.serialize(initialValue);\n                        await storage.set(key, serialized);\n                        setValue(initialValue);\n                    }\n                    else {\n                        setValue(undefined);\n                    }\n                }\n            }\n            catch (error) {\n                catchError(error);\n\n                if (isMounted) {\n                    setValue(initialValue);\n                }\n            }\n            finally {\n                if (isMounted)\n                    setIsLoaded(true);\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            isMounted = false;\n            setIsLoaded(false);\n        };\n    }, [key, initialValue, serializer]);\n\n    useEffect(() => {\n        if (!isLoaded)\n            return;\n\n        const saveValue = async () => {\n            try {\n                if (value !== undefined) {\n                    const serialized = serializer.serialize(value);\n                    await storage.set(key, serialized);\n                }\n            }\n            catch (error) {\n                catchError(error);\n            }\n        };\n\n        saveValue();\n    }, [value, key, serializer, isLoaded]);\n\n    const set = useCallback(\n        (newValue: T | ((val: T | undefined) => T)) => {\n            setValue((prev) => {\n                if (typeof newValue === 'function') {\n                    return (newValue as (val: T | undefined) => T)(prev);\n                }\n                return newValue;\n            });\n        },\n        [],\n    );\n\n    const remove = useCallback(async () => {\n        try {\n            await storage.remove(key);\n            setValue(undefined);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    }, [key]);\n\n    return { value, set, remove };\n}\n"],"mappings":";;;;;AA4BA,SAAgB,EACZ,GACA,GACA,IAA8B,GAChC;CACE,IAAM,CAAC,GAAO,KAAY,EAAwB,EAAa,EACzD,CAAC,GAAU,KAAe,EAAS,GAAM;AAsF/C,QApFA,QAAgB;EACZ,IAAI,IAAY;AAoChB,UAlCkB,YAAY;AAC1B,OAAI;IACA,IAAM,IAAa,MAAM,EAAQ,IAAY,EAAI;AAEjD,QAAI,EACA,KAAI,MAAe,KAEf,GADoB,EAAW,YAAY,EAAW,CACjC;aAEhB,MAAiB,KAAA,GAAW;KACjC,IAAM,IAAa,EAAW,UAAU,EAAa;AAErD,KADA,MAAM,EAAQ,IAAI,GAAK,EAAW,EAClC,EAAS,EAAa;UAGtB,GAAS,KAAA,EAAU;YAIxB,GAAO;AAGV,IAFA,EAAW,EAAM,EAEb,KACA,EAAS,EAAa;aAGtB;AACJ,IAAI,KACA,EAAY,GAAK;;MAIlB,QAEE;AAET,GADA,IAAY,IACZ,EAAY,GAAM;;IAEvB;EAAC;EAAK;EAAc;EAAW,CAAC,EAEnC,QAAgB;AACP,QAGa,YAAY;AAC1B,OAAI;AACA,QAAI,MAAU,KAAA,GAAW;KACrB,IAAM,IAAa,EAAW,UAAU,EAAM;AAC9C,WAAM,EAAQ,IAAI,GAAK,EAAW;;YAGnC,GAAO;AACV,MAAW,EAAM;;MAId;IACZ;EAAC;EAAO;EAAK;EAAY;EAAS,CAAC,EAwB/B;EAAE;EAAO,KAtBJ,GACP,MAA8C;AAC3C,MAAU,MACF,OAAO,KAAa,aACZ,EAAuC,EAAK,GAEjD,EACT;KAEN,EAAE,CACL;EAYoB,QAVN,EAAY,YAAY;AACnC,OAAI;AAEA,IADA,MAAM,EAAQ,OAAO,EAAI,EACzB,EAAS,KAAA,EAAU;YAEhB,GAAO;AACV,MAAW,EAAM;;KAEtB,CAAC,EAAI,CAAC;EAEoB"}
+{"version":3,"file":"storage.hook.js","names":[],"sources":["../../../src/react/storage/storage.hook.tsx"],"sourcesContent":["import { useCallback, useEffect, useState } from 'react';\n\nimport type { I_Serializer } from '#util/serializer/index.js';\n\nimport { serializer as defaultSerializer } from '#util/serializer/index.js';\n\nimport { catchError } from '../log/index.js';\nimport { storage } from './storage.util.js';\n\n/**\n * React hook that provides persistent storage functionality with automatic serialization.\n * This hook manages state that persists across browser sessions using localStorage,\n * with automatic serialization/deserialization of complex data types. It provides\n * a React-friendly interface for storage operations with proper error handling.\n *\n * Features:\n * - Automatic data serialization and deserialization\n * - Persistent storage across browser sessions\n * - Initial value handling and fallback\n * - Error handling with graceful degradation\n * - Automatic storage synchronization\n * - Support for complex data types via custom serializers\n *\n * @param key - The unique storage key for the data.\n * @param initialValue - Optional initial value to use if no stored value exists.\n * @param serializer - Optional custom serializer for complex data types (defaults to JSON serializer).\n * @returns An object containing the current value, set function, and remove function.\n */\nexport function useStorage<T>(\n    key: string,\n    initialValue?: T,\n    serializer: I_Serializer<T> = defaultSerializer as I_Serializer<T>,\n) {\n    const [value, setValue] = useState<T | undefined>(initialValue);\n    const [isLoaded, setIsLoaded] = useState(false);\n\n    useEffect(() => {\n        let isMounted = true;\n\n        const loadValue = async () => {\n            try {\n                const valueFound = await storage.get<string>(key);\n\n                if (isMounted) {\n                    if (valueFound !== null) {\n                        const parsedValue = serializer.deserialize(valueFound);\n                        setValue(parsedValue);\n                    }\n                    else if (initialValue !== undefined) {\n                        const serialized = serializer.serialize(initialValue);\n                        await storage.set(key, serialized);\n                        setValue(initialValue);\n                    }\n                    else {\n                        setValue(undefined);\n                    }\n                }\n            }\n            catch (error) {\n                catchError(error);\n\n                if (isMounted) {\n                    setValue(initialValue);\n                }\n            }\n            finally {\n                if (isMounted)\n                    setIsLoaded(true);\n            }\n        };\n\n        loadValue();\n\n        return () => {\n            isMounted = false;\n            setIsLoaded(false);\n        };\n    }, [key, initialValue, serializer]);\n\n    useEffect(() => {\n        if (!isLoaded)\n            return;\n\n        const saveValue = async () => {\n            try {\n                if (value !== undefined) {\n                    const serialized = serializer.serialize(value);\n                    await storage.set(key, serialized);\n                }\n            }\n            catch (error) {\n                catchError(error);\n            }\n        };\n\n        saveValue();\n    }, [value, key, serializer, isLoaded]);\n\n    const set = useCallback(\n        (newValue: T | ((val: T | undefined) => T)) => {\n            setValue((prev) => {\n                if (typeof newValue === 'function') {\n                    return (newValue as (val: T | undefined) => T)(prev);\n                }\n                return newValue;\n            });\n        },\n        [],\n    );\n\n    const remove = useCallback(async () => {\n        try {\n            await storage.remove(key);\n            setValue(undefined);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    }, [key]);\n\n    return { value, set, remove };\n}\n"],"mappings":";;;;;AA4BA,SAAgB,EACZ,GACA,GACA,IAA8B,GAChC;CACE,IAAM,CAAC,GAAO,KAAY,EAAwB,EAAa,EACzD,CAAC,GAAU,KAAe,EAAS,GAAM;AAsF/C,QApFA,QAAgB;EACZ,IAAI,IAAY;AAoChB,UAlCkB,YAAY;AAC1B,OAAI;IACA,IAAM,IAAa,MAAM,EAAQ,IAAY,EAAI;AAEjD,QAAI,EACA,KAAI,MAAe,KAEf,GADoB,EAAW,YAAY,EAAW,CACjC;aAEhB,MAAiB,KAAA,GAAW;KACjC,IAAM,IAAa,EAAW,UAAU,EAAa;AAErD,KADA,MAAM,EAAQ,IAAI,GAAK,EAAW,EAClC,EAAS,EAAa;UAGtB,GAAS,KAAA,EAAU;YAIxB,GAAO;AAGV,IAFA,EAAW,EAAM,EAEb,KACA,EAAS,EAAa;aAGtB;AACJ,IAAI,KACA,EAAY,GAAK;;MAIlB,QAEE;AAET,GADA,IAAY,IACZ,EAAY,GAAM;;IAEvB;EAAC;EAAK;EAAc;EAAW,CAAC,EAEnC,QAAgB;AACP,QAGa,YAAY;AAC1B,OAAI;AACA,QAAI,MAAU,KAAA,GAAW;KACrB,IAAM,IAAa,EAAW,UAAU,EAAM;AAC9C,WAAM,EAAQ,IAAI,GAAK,EAAW;;YAGnC,GAAO;AACV,MAAW,EAAM;;MAId;IACZ;EAAC;EAAO;EAAK;EAAY;EAAS,CAAC,EAwB/B;EAAE;EAAO,KAtBJ,GACP,MAA8C;AAC3C,MAAU,MACF,OAAO,KAAa,aACZ,EAAuC,EAAK,GAEjD,EACT;KAEN,EAAE,CACL;EAYoB,QAVN,EAAY,YAAY;AACnC,OAAI;AAEA,IADA,MAAM,EAAQ,OAAO,EAAI,EACzB,EAAS,KAAA,EAAU;YAEhB,GAAO;AACV,MAAW,EAAM;;KAEtB,CAAC,EAAI,CAAC;EAEoB"}

package/dist/react/storage/storage.util.js

@@ -1,37 +1,42 @@
 import { catchError as e } from "../log/log.util.js";
-import t from "localforage";
 //#region src/react/storage/storage.util.ts
-var n = {
-	async get(n) {
+var t = {
+	async get(t) {
 		try {
-			return await t.getItem(n);
+			let e = localStorage.getItem(t);
+			return e === null ? null : JSON.parse(e);
 		} catch (t) {
 			return e(t, { returnValue: null });
 		}
 	},
-	async set(n, r) {
+	async set(t, n) {
 		try {
-			await t.setItem(n, r);
+			localStorage.setItem(t, JSON.stringify(n));
 		} catch (t) {
 			e(t);
 		}
 	},
-	async remove(n) {
+	async remove(t) {
 		try {
-			await t.removeItem(n);
+			localStorage.removeItem(t);
 		} catch (t) {
 			e(t);
 		}
 	},
 	async keys() {
 		try {
-			return await t.keys() ?? [];
+			let e = [];
+			for (let t = 0; t < localStorage.length; t++) {
+				let n = localStorage.key(t);
+				n !== null && e.push(n);
+			}
+			return e;
 		} catch (t) {
 			return e(t, { returnValue: [] });
 		}
 	}
 };
 //#endregion
-export { n as storage };
+export { t as storage };
 
 //# sourceMappingURL=storage.util.js.map

package/dist/react/storage/storage.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.util.js","names":[],"sources":["../../../src/react/storage/storage.util.ts"],"sourcesContent":["import localForage from 'localforage';\n\nimport { catchError } from '../log/index.js';\n\n/**\n * Browser storage utility object using localForage for cross-browser compatibility.\n * This object provides a unified interface for browser storage operations using localForage,\n * which automatically chooses the best available storage method (IndexedDB, WebSQL, or localStorage)\n * based on browser capabilities. It includes comprehensive error handling and type safety.\n */\nexport const storage = {\n    /**\n     * Retrieves a value from browser storage by key.\n     * This method fetches data that was previously stored using the set method.\n     * Returns null if the key doesn't exist or if an error occurs during retrieval.\n     *\n     * @param key - The unique identifier for the stored value.\n     * @returns A promise that resolves to the stored value or null if not found.\n     */\n    async get<T = unknown>(key: string): Promise<T | null> {\n        try {\n            return await localForage.getItem<T>(key);\n        }\n        catch (error) {\n            return catchError(error, { returnValue: null });\n        }\n    },\n    /**\n     * Stores a value in browser storage with a unique key.\n     * This method saves data that can be retrieved later using the get method.\n     * The data is automatically handled by localForage which chooses the optimal\n     * storage method for the browser environment.\n     *\n     * @param key - The unique identifier for the value to store.\n     * @param value - The data to store (will be automatically handled by localForage).\n     * @returns A promise that resolves when the storage operation is complete.\n     */\n    async set<T = unknown>(key: string, value: T): Promise<void> {\n        try {\n            await localForage.setItem(key, value);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Removes a value from browser storage by key.\n     * This method permanently deletes the stored data associated with the specified key.\n     * If the key doesn't exist, the operation completes successfully without error.\n     *\n     * @param key - The unique identifier of the value to remove.\n     * @returns A promise that resolves when the removal operation is complete.\n     */\n    async remove(key: string): Promise<void> {\n        try {\n            await localForage.removeItem(key);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Retrieves all storage keys.\n     * This method returns an array of all keys that currently have stored values.\n     * Returns an empty array if no keys exist or if an error occurs during retrieval.\n     *\n     * @returns A promise that resolves to an array of storage keys.\n     */\n    async keys(): Promise<string[]> {\n        try {\n            const keys = await localForage.keys();\n\n            return keys ?? [];\n        }\n        catch (error) {\n            return catchError(error, { returnValue: [] });\n        }\n    },\n};\n"],"mappings":";;;AAUA,IAAa,IAAU;CASnB,MAAM,IAAiB,GAAgC;AACnD,MAAI;AACA,UAAO,MAAM,EAAY,QAAW,EAAI;WAErC,GAAO;AACV,UAAO,EAAW,GAAO,EAAE,aAAa,MAAM,CAAC;;;CAavD,MAAM,IAAiB,GAAa,GAAyB;AACzD,MAAI;AACA,SAAM,EAAY,QAAQ,GAAK,EAAM;WAElC,GAAO;AACV,KAAW,EAAM;;;CAWzB,MAAM,OAAO,GAA4B;AACrC,MAAI;AACA,SAAM,EAAY,WAAW,EAAI;WAE9B,GAAO;AACV,KAAW,EAAM;;;CAUzB,MAAM,OAA0B;AAC5B,MAAI;AAGA,UAFa,MAAM,EAAY,MAAM,IAEtB,EAAE;WAEd,GAAO;AACV,UAAO,EAAW,GAAO,EAAE,aAAa,EAAE,EAAE,CAAC;;;CAGxD"}
+{"version":3,"file":"storage.util.js","names":[],"sources":["../../../src/react/storage/storage.util.ts"],"sourcesContent":["import { catchError } from '../log/index.js';\n\n/**\n * Browser storage utility object using native localStorage.\n * This object provides a unified interface for browser storage operations\n * with comprehensive error handling and type safety.\n * Values are stored as JSON strings for consistent serialization.\n */\nexport const storage = {\n    /**\n     * Retrieves a value from browser storage by key.\n     * This method fetches data that was previously stored using the set method.\n     * Returns null if the key doesn't exist or if an error occurs during retrieval.\n     *\n     * @param key - The unique identifier for the stored value.\n     * @returns A promise that resolves to the stored value or null if not found.\n     */\n    async get<T = unknown>(key: string): Promise<T | null> {\n        try {\n            const raw = localStorage.getItem(key);\n\n            if (raw === null) {\n                return null;\n            }\n\n            return JSON.parse(raw) as T;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: null });\n        }\n    },\n    /**\n     * Stores a value in browser storage with a unique key.\n     * This method saves data that can be retrieved later using the get method.\n     * The data is automatically serialized to JSON.\n     *\n     * @param key - The unique identifier for the value to store.\n     * @param value - The data to store (will be automatically serialized to JSON).\n     * @returns A promise that resolves when the storage operation is complete.\n     */\n    async set<T = unknown>(key: string, value: T): Promise<void> {\n        try {\n            localStorage.setItem(key, JSON.stringify(value));\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Removes a value from browser storage by key.\n     * This method permanently deletes the stored data associated with the specified key.\n     * If the key doesn't exist, the operation completes successfully without error.\n     *\n     * @param key - The unique identifier of the value to remove.\n     * @returns A promise that resolves when the removal operation is complete.\n     */\n    async remove(key: string): Promise<void> {\n        try {\n            localStorage.removeItem(key);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    },\n    /**\n     * Retrieves all storage keys.\n     * This method returns an array of all keys that currently have stored values.\n     * Returns an empty array if no keys exist or if an error occurs during retrieval.\n     *\n     * @returns A promise that resolves to an array of storage keys.\n     */\n    async keys(): Promise<string[]> {\n        try {\n            const keys: string[] = [];\n\n            for (let i = 0; i < localStorage.length; i++) {\n                const key = localStorage.key(i);\n\n                if (key !== null) {\n                    keys.push(key);\n                }\n            }\n\n            return keys;\n        }\n        catch (error) {\n            return catchError(error, { returnValue: [] });\n        }\n    },\n};\n"],"mappings":";;AAQA,IAAa,IAAU;CASnB,MAAM,IAAiB,GAAgC;AACnD,MAAI;GACA,IAAM,IAAM,aAAa,QAAQ,EAAI;AAMrC,UAJI,MAAQ,OACD,OAGJ,KAAK,MAAM,EAAI;WAEnB,GAAO;AACV,UAAO,EAAW,GAAO,EAAE,aAAa,MAAM,CAAC;;;CAYvD,MAAM,IAAiB,GAAa,GAAyB;AACzD,MAAI;AACA,gBAAa,QAAQ,GAAK,KAAK,UAAU,EAAM,CAAC;WAE7C,GAAO;AACV,KAAW,EAAM;;;CAWzB,MAAM,OAAO,GAA4B;AACrC,MAAI;AACA,gBAAa,WAAW,EAAI;WAEzB,GAAO;AACV,KAAW,EAAM;;;CAUzB,MAAM,OAA0B;AAC5B,MAAI;GACA,IAAM,IAAiB,EAAE;AAEzB,QAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;IAC1C,IAAM,IAAM,aAAa,IAAI,EAAE;AAE/B,IAAI,MAAQ,QACR,EAAK,KAAK,EAAI;;AAItB,UAAO;WAEJ,GAAO;AACV,UAAO,EAAW,GAAO,EAAE,aAAa,EAAE,EAAE,CAAC;;;CAGxD"}

package/dist/react/toast/index.d.ts

@@ -1 +1 @@
-export { toast, Toaster } from 'react-hot-toast';
+export {}

package/dist/react/userback/index.d.ts

@@ -1,2 +1 @@
-export * from './userback.component.js';
-export * from './userback.type.js';
+export {}

package/dist/src/config/commitlint/index.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    extends: string[];
+    ignores: ((message: string) => boolean)[];
+};
+export default _default;

package/dist/{config → src/config}/config.type.d.ts

@@ -1,4 +1,4 @@
-import { T_Object } from '../typescript/index.js';
+import { T_Object } from '../../typescript/index.js';
 export declare enum E_ConfigType {
     ESLINT = "eslint",
     COMMITLINT = "commitlint",

package/dist/{config → src/config}/config.util.d.ts

@@ -1,4 +1,4 @@
-import { T_Object } from '../typescript/index.js';
+import { T_Object } from '../../typescript/index.js';
 import { T_ConfigType } from './config.type.js';
 /**
  * Merges configurations based on the specified type.

package/dist/src/config/env/index.d.ts

@@ -0,0 +1,3 @@
+export * from './env.constant.js';
+export * from './env.type.js';
+export * from './env.util.js';