@arkyn/components 3.0.1-beta.10 → 3.0.1-beta.100

package/dist/components/table/tableHeader/index.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import "./styles.css";
+/**
+ * TableHeader component - used to render the header section of a table with automatic spacing
+ *
+ * @param props - TableHeader component properties
+ *
+ * **...All valid HTML properties for thead element**
+ *
+ * @returns TableHeader JSX element
+ *
+ * @example
+ * ```tsx
+ * // Basic table header
+ * <TableHeader>
+ *   <th>Name</th>
+ *   <th>Email</th>
+ *   <th>Actions</th>
+ * </TableHeader>
+ *
+ * // Table header with custom styling
+ * <TableHeader className="custom-header">
+ *   <th>Product</th>
+ *   <th>Price</th>
+ *   <th>Stock</th>
+ * </TableHeader>
+ *
+ * // Complete table usage
+ * <TableContainer>
+ *   <TableHeader>
+ *     <th>ID</th>
+ *     <th>User</th>
+ *     <th>Status</th>
+ *   </TableHeader>
+ *   <TableBody>
+ *     // table rows...
+ *   </TableBody>
+ * </TableContainer>
+ * ```
+ */
+function TableHeader(props) {
+    const { className: baseClassName, children, ...rest } = props;
+    const className = `arkynTableHeader ${baseClassName}`;
+    return (_jsxs("thead", { className: className.trim(), ...rest, children: [_jsx("tr", { children: children }), _jsx("tr", { className: "spacingRow" })] }));
+}
+export { TableHeader };

package/dist/components/textarea/index.d.ts

@@ -0,0 +1,105 @@
+import { TextareaHTMLAttributes } from "react";
+import "./styles.css";
+type TextareaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "name" | "value" | "defaultValue"> & {
+    name: string;
+    label?: string;
+    showAsterisk?: boolean;
+    errorMessage?: string;
+    size?: "md" | "lg";
+    variant?: "solid" | "outline";
+    value?: string | null;
+    defaultValue?: string | null;
+};
+/**
+ * Textarea component - used for multi-line text input with customizable styling and validation
+ *
+ * @param props - Textarea component properties
+ * @param props.name - Required field name for form handling and textarea identification
+ * @param props.label - Optional label text to display above the textarea
+ * @param props.showAsterisk - Whether to show asterisk on label for required fields
+ * @param props.errorMessage - Error message to display below the textarea
+ * @param props.size - Size variant of the textarea. Default: "md"
+ * @param props.variant - Visual variant of the textarea. Default: "solid"
+ *
+ * **...Other valid HTML properties for textarea element (except name)**
+ *
+ * @returns Textarea JSX element wrapped in FieldWrapper with optional label and error message
+ *
+ * @example
+ * ```tsx
+ * // Basic textarea
+ * <Textarea name="description" placeholder="Enter description..." />
+ *
+ * // Textarea with label and validation
+ * <Textarea
+ *   name="bio"
+ *   label="Biography"
+ *   showAsterisk
+ *   placeholder="Tell us about yourself"
+ *   errorMessage="Biography is required"
+ * />
+ *
+ * // Large textarea with outline variant
+ * <Textarea
+ *   name="comments"
+ *   label="Comments"
+ *   size="lg"
+ *   variant="outline"
+ *   placeholder="Enter your comments here..."
+ *   rows={6}
+ * />
+ *
+ * // Textarea with character limit and custom styling
+ * <Textarea
+ *   name="feedback"
+ *   label="Feedback"
+ *   placeholder="Share your feedback (max 500 characters)"
+ *   maxLength={500}
+ *   rows={4}
+ *   className="feedback-textarea"
+ * />
+ *
+ * // Read-only textarea for display
+ * <Textarea
+ *   name="terms"
+ *   label="Terms and Conditions"
+ *   value={termsContent}
+ *   readOnly
+ *   rows={10}
+ *   variant="outline"
+ * />
+ *
+ * // Disabled textarea
+ * <Textarea
+ *   name="disabled_field"
+ *   label="Disabled Field"
+ *   value="This field is disabled"
+ *   disabled
+ *   placeholder="Cannot edit this field"
+ * />
+ *
+ * // Textarea with controlled value and change handler
+ * <Textarea
+ *   name="message"
+ *   label="Message"
+ *   value={message}
+ *   onChange={(e) => setMessage(e.target.value)}
+ *   placeholder="Type your message..."
+ *   rows={5}
+ *   showAsterisk
+ * />
+ *
+ * // Textarea with resize control
+ * <Textarea
+ *   name="notes"
+ *   label="Notes"
+ *   placeholder="Enter your notes..."
+ *   style={{ resize: 'vertical' }}
+ *   rows={3}
+ *   cols={50}
+ * />
+ * ```
+ */
+declare function Textarea(props: TextareaProps): import("react/jsx-runtime").JSX.Element;
+export { Textarea };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/textarea/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EAIvB,MAAM,OAAO,CAAC;AAOf,OAAO,cAAc,CAAC;AAEtB,KAAK,aAAa,GAAG,IAAI,CACvB,sBAAsB,CAAC,mBAAmB,CAAC,EAC3C,MAAM,GAAG,OAAO,GAAG,cAAc,CAClC,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAEH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,2CAmFrC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/components/textarea/index.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useRef, useState, } from "react";
+import { useForm } from "../../hooks/useForm";
+import { FieldLabel } from "../fieldLabel";
+import { FieldWrapper } from "../fieldWrapper";
+import { FieldError } from "../fieldError";
+import "./styles.css";
+/**
+ * Textarea component - used for multi-line text input with customizable styling and validation
+ *
+ * @param props - Textarea component properties
+ * @param props.name - Required field name for form handling and textarea identification
+ * @param props.label - Optional label text to display above the textarea
+ * @param props.showAsterisk - Whether to show asterisk on label for required fields
+ * @param props.errorMessage - Error message to display below the textarea
+ * @param props.size - Size variant of the textarea. Default: "md"
+ * @param props.variant - Visual variant of the textarea. Default: "solid"
+ *
+ * **...Other valid HTML properties for textarea element (except name)**
+ *
+ * @returns Textarea JSX element wrapped in FieldWrapper with optional label and error message
+ *
+ * @example
+ * ```tsx
+ * // Basic textarea
+ * <Textarea name="description" placeholder="Enter description..." />
+ *
+ * // Textarea with label and validation
+ * <Textarea
+ *   name="bio"
+ *   label="Biography"
+ *   showAsterisk
+ *   placeholder="Tell us about yourself"
+ *   errorMessage="Biography is required"
+ * />
+ *
+ * // Large textarea with outline variant
+ * <Textarea
+ *   name="comments"
+ *   label="Comments"
+ *   size="lg"
+ *   variant="outline"
+ *   placeholder="Enter your comments here..."
+ *   rows={6}
+ * />
+ *
+ * // Textarea with character limit and custom styling
+ * <Textarea
+ *   name="feedback"
+ *   label="Feedback"
+ *   placeholder="Share your feedback (max 500 characters)"
+ *   maxLength={500}
+ *   rows={4}
+ *   className="feedback-textarea"
+ * />
+ *
+ * // Read-only textarea for display
+ * <Textarea
+ *   name="terms"
+ *   label="Terms and Conditions"
+ *   value={termsContent}
+ *   readOnly
+ *   rows={10}
+ *   variant="outline"
+ * />
+ *
+ * // Disabled textarea
+ * <Textarea
+ *   name="disabled_field"
+ *   label="Disabled Field"
+ *   value="This field is disabled"
+ *   disabled
+ *   placeholder="Cannot edit this field"
+ * />
+ *
+ * // Textarea with controlled value and change handler
+ * <Textarea
+ *   name="message"
+ *   label="Message"
+ *   value={message}
+ *   onChange={(e) => setMessage(e.target.value)}
+ *   placeholder="Type your message..."
+ *   rows={5}
+ *   showAsterisk
+ * />
+ *
+ * // Textarea with resize control
+ * <Textarea
+ *   name="notes"
+ *   label="Notes"
+ *   placeholder="Enter your notes..."
+ *   style={{ resize: 'vertical' }}
+ *   rows={3}
+ *   cols={50}
+ * />
+ * ```
+ */
+function Textarea(props) {
+    const { variant = "solid", size = "md", className: wrapperClassName, errorMessage: baseErrorMessage, disabled = false, readOnly = false, label, showAsterisk, name, onFocus, onBlur, title, style, value, defaultValue, placeholder, id, ...rest } = props;
+    const { fieldErrors } = useForm();
+    const [isFocused, setIsFocused] = useState(false);
+    const textareaRef = useRef(null);
+    const textareaId = id || useId();
+    const errorMessage = baseErrorMessage || fieldErrors?.[name];
+    const isError = !!errorMessage;
+    const errorClass = isError ? "errorTrue" : "errorFalse";
+    const opacityClass = disabled || readOnly ? "opacityTrue" : "opacityFalse";
+    const focusedClass = isFocused ? "focusedTrue" : "focusedFalse";
+    const className = `arkynTextarea ${variant} ${size} ${opacityClass} ${errorClass} ${focusedClass}`;
+    function handleSectionClick() {
+        if (disabled || !textareaRef?.current)
+            return;
+        setIsFocused(true);
+        textareaRef.current.focus();
+    }
+    function handleFocus(e) {
+        setIsFocused(true);
+        if (onFocus)
+            onFocus(e);
+    }
+    function handleBlur(e) {
+        setIsFocused(false);
+        if (onBlur)
+            onBlur(e);
+    }
+    return (_jsxs(FieldWrapper, { className: wrapperClassName, children: [label && (_jsx(FieldLabel, { htmlFor: textareaId, showAsterisk: showAsterisk, children: label })), _jsx("section", { title: title, style: style, onClick: handleSectionClick, className: className, children: _jsx("textarea", { id: textareaId, disabled: disabled, readOnly: readOnly, ref: textareaRef, name: name, onFocus: handleFocus, onBlur: handleBlur, defaultValue: defaultValue || "", placeholder: disabled ? value || placeholder : placeholder, value: disabled ? undefined : value, ...rest }) }), errorMessage && _jsx(FieldError, { children: errorMessage })] }));
+}
+export { Textarea };

package/dist/components/tooltip/index.d.ts

@@ -0,0 +1,80 @@
+import { HTMLAttributes, ReactNode } from "react";
+import "./styles.css";
+type TooltipProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+    text: string;
+    children: ReactNode;
+    orientation?: "top" | "right" | "bottom" | "left";
+    size?: "md" | "lg";
+};
+/**
+ * Tooltip component - displays contextual information on hover with smart positioning
+ *
+ * @param props - Tooltip component properties
+ * @param props.text - Text content to display in the tooltip
+ * @param props.children - Element that triggers the tooltip on hover
+ * @param props.orientation - Preferred tooltip position relative to trigger element. Default: "top"
+ * @param props.size - Tooltip size variant. Default: "lg"
+ *
+ * **...Other valid HTML properties for div element**
+ *
+ * @returns Tooltip JSX element
+ *
+ * @example
+ * ```tsx
+ * // Basic tooltip
+ * <Tooltip text="This is a helpful tip">
+ *   <button>Hover me</button>
+ * </Tooltip>
+ *
+ * // Tooltip with different orientations
+ * <Tooltip text="Left tooltip" orientation="left">
+ *   <span>Hover for left tooltip</span>
+ * </Tooltip>
+ *
+ * <Tooltip text="Right tooltip" orientation="right">
+ *   <span>Hover for right tooltip</span>
+ * </Tooltip>
+ *
+ * // Different sizes
+ * <Tooltip text="Small tooltip" size="md">
+ *   <button>Small tooltip</button>
+ * </Tooltip>
+ *
+ * <Tooltip text="Large tooltip" size="lg">
+ *   <button>Large tooltip</button>
+ * </Tooltip>
+ *
+ * // Smart positioning - automatically adjusts if doesn't fit
+ * <Tooltip text="This tooltip will auto-adjust position" orientation="left">
+ *   <button className="near-edge">Smart positioning</button>
+ * </Tooltip>
+ *
+ * // Complete example with custom styling
+ * <Tooltip
+ *   text="Save your changes before proceeding"
+ *   orientation="bottom"
+ *   size="lg"
+ *   className="custom-tooltip"
+ * >
+ *   <IconButton icon={SaveIcon} />
+ * </Tooltip>
+ *
+ * // Multiple tooltips on same page
+ * <div className="toolbar">
+ *   <Tooltip text="Create new file" orientation="bottom">
+ *     <IconButton icon={PlusIcon} />
+ *   </Tooltip>
+ *
+ *   <Tooltip text="Open existing file" orientation="bottom">
+ *     <IconButton icon={FolderIcon} />
+ *   </Tooltip>
+ *
+ *   <Tooltip text="Delete selected file" orientation="bottom">
+ *     <IconButton icon={TrashIcon} />
+ *   </Tooltip>
+ * </div>
+ * ```
+ */
+declare function Tooltip(props: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export { Tooltip };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,SAAS,EAKV,MAAM,OAAO,CAAC;AACf,OAAO,cAAc,CAAC;AAEtB,KAAK,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH,iBAAS,OAAO,CAAC,KAAK,EAAE,YAAY,2CAqFnC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/components/tooltip/index.js

@@ -0,0 +1,135 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useRef, useState, } from "react";
+import "./styles.css";
+/**
+ * Tooltip component - displays contextual information on hover with smart positioning
+ *
+ * @param props - Tooltip component properties
+ * @param props.text - Text content to display in the tooltip
+ * @param props.children - Element that triggers the tooltip on hover
+ * @param props.orientation - Preferred tooltip position relative to trigger element. Default: "top"
+ * @param props.size - Tooltip size variant. Default: "lg"
+ *
+ * **...Other valid HTML properties for div element**
+ *
+ * @returns Tooltip JSX element
+ *
+ * @example
+ * ```tsx
+ * // Basic tooltip
+ * <Tooltip text="This is a helpful tip">
+ *   <button>Hover me</button>
+ * </Tooltip>
+ *
+ * // Tooltip with different orientations
+ * <Tooltip text="Left tooltip" orientation="left">
+ *   <span>Hover for left tooltip</span>
+ * </Tooltip>
+ *
+ * <Tooltip text="Right tooltip" orientation="right">
+ *   <span>Hover for right tooltip</span>
+ * </Tooltip>
+ *
+ * // Different sizes
+ * <Tooltip text="Small tooltip" size="md">
+ *   <button>Small tooltip</button>
+ * </Tooltip>
+ *
+ * <Tooltip text="Large tooltip" size="lg">
+ *   <button>Large tooltip</button>
+ * </Tooltip>
+ *
+ * // Smart positioning - automatically adjusts if doesn't fit
+ * <Tooltip text="This tooltip will auto-adjust position" orientation="left">
+ *   <button className="near-edge">Smart positioning</button>
+ * </Tooltip>
+ *
+ * // Complete example with custom styling
+ * <Tooltip
+ *   text="Save your changes before proceeding"
+ *   orientation="bottom"
+ *   size="lg"
+ *   className="custom-tooltip"
+ * >
+ *   <IconButton icon={SaveIcon} />
+ * </Tooltip>
+ *
+ * // Multiple tooltips on same page
+ * <div className="toolbar">
+ *   <Tooltip text="Create new file" orientation="bottom">
+ *     <IconButton icon={PlusIcon} />
+ *   </Tooltip>
+ *
+ *   <Tooltip text="Open existing file" orientation="bottom">
+ *     <IconButton icon={FolderIcon} />
+ *   </Tooltip>
+ *
+ *   <Tooltip text="Delete selected file" orientation="bottom">
+ *     <IconButton icon={TrashIcon} />
+ *   </Tooltip>
+ * </div>
+ * ```
+ */
+function Tooltip(props) {
+    const { text, size = "lg", children, orientation = "top", className: baseClassName = "", ...rest } = props;
+    const tooltipId = useId();
+    const tooltipRef = useRef(null);
+    const [adjustedOrientation, setAdjustedOrientation] = useState(orientation);
+    useEffect(() => {
+        const checkTooltipPosition = () => {
+            if (!tooltipRef.current)
+                return;
+            const tooltipText = document.getElementById(tooltipId);
+            if (!tooltipText)
+                return;
+            setAdjustedOrientation(orientation);
+            requestAnimationFrame(() => {
+                const rect = tooltipText.getBoundingClientRect();
+                const viewportWidth = window.innerWidth;
+                const viewportHeight = window.innerHeight;
+                let newOrientation = orientation;
+                if (orientation === "left" && rect.left < 0) {
+                    newOrientation = "right";
+                }
+                else if (orientation === "right" && rect.right > viewportWidth) {
+                    newOrientation = "left";
+                }
+                else if (orientation === "top" && rect.top < 0) {
+                    newOrientation = "bottom";
+                }
+                else if (orientation === "bottom" && rect.bottom > viewportHeight) {
+                    newOrientation = "top";
+                }
+                if (newOrientation === "right" && rect.right > viewportWidth) {
+                    newOrientation = "left";
+                }
+                else if (newOrientation === "left" && rect.left < 0) {
+                    newOrientation = "right";
+                }
+                else if (newOrientation === "bottom" &&
+                    rect.bottom > viewportHeight) {
+                    newOrientation = "top";
+                }
+                else if (newOrientation === "top" && rect.top < 0) {
+                    newOrientation = "bottom";
+                }
+                setAdjustedOrientation(newOrientation);
+            });
+        };
+        const tooltip = tooltipRef.current;
+        if (!tooltip)
+            return;
+        const handleMouseEnter = () => {
+            setTimeout(checkTooltipPosition, 1);
+        };
+        tooltip.addEventListener("mouseenter", handleMouseEnter);
+        window.addEventListener("resize", checkTooltipPosition);
+        return () => {
+            tooltip.removeEventListener("mouseenter", handleMouseEnter);
+            window.removeEventListener("resize", checkTooltipPosition);
+        };
+    }, [orientation, tooltipId]);
+    const className = `arkynTooltip ${size} ${adjustedOrientation} ${baseClassName}`;
+    return (_jsxs("div", { className: className.trim(), ...rest, ref: tooltipRef, children: [children, _jsx("div", { className: "arkynTooltipText", id: tooltipId, dangerouslySetInnerHTML: { __html: text } })] }));
+}
+export { Tooltip };

package/dist/hooks/useAutomation.d.ts

@@ -1,3 +1,42 @@
-declare function useAutomation(): void;
+/**
+ * Hook for automating actions based on form response data.
+ *
+ * This hook automates the closing of modals and the display of toast notifications
+ * based on the properties provided in the form response data object.
+ *
+ * @param {Object} formResponseData - Object containing form response data for automation
+ * @param {boolean} [formResponseData.closeModal] - If true, closes all open modals
+ * @param {string} [formResponseData.message] - Message to be displayed in the toast notification
+ * @param {string} [formResponseData.name] - Response name used to check against known error responses
+ * @param {"success" | "danger"} [formResponseData.type] - Type of toast notification to be displayed
+ *
+ * @example
+ * ```tsx
+ * // Complete usage with success notification
+ * const responseData = {
+ *   closeModal: true,
+ *   message: "Operation completed successfully!",
+ *   type: "success"
+ * };
+ *
+ * useAutomation(responseData);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Close modal only
+ * useAutomation({ closeModal: true });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Display error notification
+ * useAutomation({
+ *   message: "Error processing request",
+ *   type: "danger"
+ * });
+ * ```
+ */
+declare function useAutomation(formResponseData: any): void;
 export { useAutomation };
 //# sourceMappingURL=useAutomation.d.ts.map

package/dist/hooks/useAutomation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAutomation.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutomation.ts"],"names":[],"mappings":"AAwBA,iBAAS,aAAa,SAqDrB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"useAutomation.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutomation.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,GAAG,QAmB3C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/hooks/useAutomation.js

@@ -1,61 +1,67 @@
-import { useContext, useEffect } from "react";
-import { useActionData, useFetchers, useLocation, useNavigate, } from "react-router";
-import { animateScroll } from "react-scroll";
-import { ModalContext } from "../context/ModalContext";
-import { useScopedParams } from "./useScopedParams";
+import { useEffect } from "react";
+import { useModal } from "./useModal";
 import { useToast } from "./useToast";
-function isToastProps(obj) {
-    return (obj &&
-        typeof obj.title === "string" &&
-        typeof obj.message === "string" &&
-        (obj.size === undefined || obj.size === "md" || obj.size === "lg") &&
-        (obj.type === "success" || obj.type === "danger"));
-}
-function useAutomation() {
-    const actionData = useActionData();
-    const { closeModal, closeAll, modalIsOpen } = useContext(ModalContext);
+import { badResponses } from "../templates/badResponses";
+import { successResponses } from "../templates/successResponses";
+/**
+ * Hook for automating actions based on form response data.
+ *
+ * This hook automates the closing of modals and the display of toast notifications
+ * based on the properties provided in the form response data object.
+ *
+ * @param {Object} formResponseData - Object containing form response data for automation
+ * @param {boolean} [formResponseData.closeModal] - If true, closes all open modals
+ * @param {string} [formResponseData.message] - Message to be displayed in the toast notification
+ * @param {string} [formResponseData.name] - Response name used to check against known error responses
+ * @param {"success" | "danger"} [formResponseData.type] - Type of toast notification to be displayed
+ *
+ * @example
+ * ```tsx
+ * // Complete usage with success notification
+ * const responseData = {
+ *   closeModal: true,
+ *   message: "Operation completed successfully!",
+ *   type: "success"
+ * };
+ *
+ * useAutomation(responseData);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Close modal only
+ * useAutomation({ closeModal: true });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Display error notification
+ * useAutomation({
+ *   message: "Error processing request",
+ *   type: "danger"
+ * });
+ * ```
+ */
+function useAutomation(formResponseData) {
+    const { closeAll } = useModal();
     const { showToast } = useToast();
-    const { getParam } = useScopedParams();
-    const { pathname } = useLocation();
-    const navigate = useNavigate();
-    const closeAllModals = getParam("closeAllModals");
-    const fetchers = useFetchers();
-    useEffect(() => {
-        const modalKey = fetchers[0]?.data?.closeModalKey || "";
-        const isOpen = modalIsOpen(modalKey);
-        if (modalKey && isOpen)
-            closeModal(modalKey);
-    }, [fetchers]);
+    const closeModal = formResponseData?.closeModal;
+    const message = formResponseData?.message;
+    const name = formResponseData?.name;
+    const type = formResponseData?.type;
     useEffect(() => {
-        if (closeAllModals === "true") {
+        if (closeModal)
             closeAll();
-            navigate(pathname);
-        }
-    }, [closeAllModals]);
-    useEffect(() => {
-        const closeModalKey = actionData?.closeModalKey;
-        if (closeModalKey)
-            closeModal(closeModalKey);
-    }, [actionData]);
-    useEffect(() => {
-        const closeAllModals = actionData?.closeAllModals;
-        if (typeof closeAllModals === "boolean" && closeAllModals)
-            closeAll();
-    }, [actionData]);
-    useEffect(() => {
-        const existsToast = actionData?.toast;
-        const existsMessage = actionData?.message;
-        if (isToastProps(existsToast))
-            showToast(existsToast);
-        if (!isToastProps(existsToast) && existsMessage) {
-            showToast({ message: existsMessage, type: "danger" });
-        }
-    }, [actionData]);
-    useEffect(() => {
-        if (typeof actionData?.data?.scrollTo === "string") {
-            const element = document.getElementById(actionData?.data?.scrollTo);
-            element && animateScroll.scrollTo(element.offsetTop - 200);
+        if (message) {
+            if (type === "success")
+                showToast({ message, type: "success" });
+            if (type === "danger")
+                showToast({ message, type: "danger" });
+            if (badResponses.includes(name))
+                showToast({ message, type: "danger" });
+            if (successResponses.includes(name))
+                showToast({ message, type: "success" });
         }
-    }, [actionData]);
+    }, [formResponseData]);
 }
 export { useAutomation };