@isik-kaplan/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Işık Kaplan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @isik-kaplan/core
+
+Everyday TypeScript utilities - the small stuff every project ends up rewriting: object/string
+helpers, date formatting, browser file handling, a couple of React hooks, and some Next.js glue.
+Framework-specific pieces are split into their own entry points so you never pay for peer
+dependencies you don't use.
+
+```typescript
+import { formattedDate, slugify } from '@isik-kaplan/core'
+
+slugify('Café Münster') // 'cafe-munster'
+formattedDate('yyyy-MM-dd', new Date(2026, 0, 5)) // '2026-01-05'
+```
+
+## Install
+
+```sh
+npm install @isik-kaplan/core
+```
+
+See [docs/INDEX.md](docs/INDEX.md) for everything else - every exported utility, its entry point,
+and a usage example.

package/dist/hooks/index.cjs

@@ -0,0 +1,341 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useEffectAfterMount: () => useEffectAfterMount,
+  useElementAttributes: () => useElementAttributes,
+  useFileDragDrop: () => useFileDragDrop,
+  useFilePaste: () => useFilePaste,
+  useFormState: () => useFormState
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_react = require("react");
+function useElementAttributes(attributeKeys) {
+  const ref = (0, import_react.useRef)(null);
+  const [attributeValues, setAttributeValue] = (0, import_react.useState)({});
+  const updateAttribute = (0, import_react.useCallback)(() => {
+    if (ref.current) {
+      const values = {};
+      for (const key of attributeKeys) {
+        Object.defineProperty(values, key, {
+          value: ref.current[key],
+          writable: true,
+          configurable: true,
+          enumerable: true
+        });
+      }
+      setAttributeValue((prevValues) => {
+        const hasChanged = attributeKeys.some((key) => prevValues[key] !== values[key]);
+        return hasChanged ? values : prevValues;
+      });
+    }
+  }, [attributeKeys]);
+  (0, import_react.useEffect)(() => {
+    updateAttribute();
+    window.addEventListener("resize", updateAttribute);
+    if (ref.current) {
+      const observer = new MutationObserver(updateAttribute);
+      observer.observe(ref.current, { attributes: true });
+      return () => {
+        window.removeEventListener("resize", updateAttribute);
+        observer.disconnect();
+      };
+    }
+    return () => {
+      window.removeEventListener("resize", updateAttribute);
+    };
+  }, [updateAttribute]);
+  return { ref, attributeValues };
+}
+function useFormState(initialState) {
+  const [formState, setFormState] = (0, import_react.useState)(initialState);
+  const [formErrors, setFormErrors] = (0, import_react.useState)();
+  function resetFormState() {
+    setFormState(initialState);
+  }
+  function handleFormState({
+    key,
+    inputType
+  }) {
+    return (event) => {
+      let value;
+      if (inputType === "event") {
+        const target = event.target;
+        if (target.type === "checkbox") {
+          value = target.checked;
+        } else if (target.type === "number" || target.type === "range") {
+          value = target.valueAsNumber;
+        } else {
+          value = target.value;
+        }
+      } else {
+        value = event;
+      }
+      setFormState((prev) => ({ ...prev, [key]: value }));
+    };
+  }
+  const handleFormStateValue = (key) => handleFormState({ key, inputType: "value" });
+  const handleFormStateEvent = (key) => handleFormState({ key, inputType: "event" });
+  const handleFormStateOnClick = (key, value) => () => {
+    setFormState((prev) => ({ ...prev, [key]: value }));
+  };
+  return {
+    formState,
+    setFormState,
+    formErrors,
+    setFormErrors,
+    handleFormStateValue,
+    handleFormStateEvent,
+    handleFormStateOnClick,
+    resetFormState
+  };
+}
+function useEffectAfterMount(effect, deps) {
+  const isFirstRender = (0, import_react.useRef)(true);
+  (0, import_react.useEffect)(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+      return;
+    }
+    return effect();
+  }, deps);
+}
+function useFilePaste({
+  acceptedTypes,
+  maxSize,
+  targetElement,
+  enabled = true
+} = {}) {
+  const [files, setFiles] = (0, import_react.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const clearFiles = (0, import_react.useCallback)(() => {
+    setFiles([]);
+    setError(null);
+  }, []);
+  const validateFiles = (0, import_react.useCallback)(
+    (pastedFiles) => {
+      if (acceptedTypes && acceptedTypes.length > 0) {
+        const wildcardAcceptedTypes = acceptedTypes.filter((type) => type.endsWith("/*")).map((type) => type.slice(0, -1));
+        const normalizedAcceptedTypes = acceptedTypes.map((type) => type.endsWith("/*") ? type.slice(0, -2) : type);
+        const invalidFiles = pastedFiles.filter((file) => {
+          const fileType = file.type;
+          return !normalizedAcceptedTypes.includes(fileType) && !wildcardAcceptedTypes.some((wildcardType) => fileType.startsWith(wildcardType));
+        });
+        if (invalidFiles.length > 0) {
+          const invalidFileNames = invalidFiles.map((file) => file.name).join(", ");
+          return {
+            valid: false,
+            error: `Invalid file types: ${invalidFileNames}. Accepted types: ${acceptedTypes.join(", ")}`
+          };
+        }
+      }
+      if (maxSize) {
+        const oversizedFile = pastedFiles.find((file) => file.size > maxSize);
+        if (oversizedFile) {
+          const fileSizeMB = (oversizedFile.size / (1024 * 1024)).toFixed(2);
+          const maxSizeMB = (maxSize / (1024 * 1024)).toFixed(2);
+          return {
+            valid: false,
+            error: `File "${oversizedFile.name}" (${fileSizeMB} MB) exceeds the maximum size of ${maxSizeMB} MB`
+          };
+        }
+      }
+      return { valid: true };
+    },
+    [acceptedTypes, maxSize]
+  );
+  const handlePaste = (0, import_react.useCallback)(
+    (event) => {
+      const { clipboardData } = event;
+      if (!clipboardData) return;
+      const hasFiles = clipboardData.files && clipboardData.files.length > 0;
+      if (!hasFiles) return;
+      event.preventDefault();
+      setIsLoading(true);
+      setError(null);
+      try {
+        const pastedFiles = Array.from(clipboardData.files);
+        const validation = validateFiles(pastedFiles);
+        if (!validation.valid) {
+          setError(validation.error);
+          setFiles([]);
+        } else {
+          setFiles(pastedFiles);
+        }
+      } catch (err) {
+        setError(err instanceof Error ? err.message : "Failed to process pasted files");
+        setFiles([]);
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [validateFiles]
+  );
+  (0, import_react.useEffect)(() => {
+    if (!enabled) return;
+    const target = targetElement || document;
+    target.addEventListener("paste", handlePaste);
+    return () => {
+      target.removeEventListener("paste", handlePaste);
+    };
+  }, [enabled, handlePaste, targetElement]);
+  return { files, isLoading, error, clearFiles };
+}
+function useFileDragDrop(options = {}) {
+  const { onDrop, onDragOver, onDragLeave, acceptedFileTypes, maxFileSize, multiple = true } = options;
+  const [state, setState] = (0, import_react.useState)({
+    isDragging: false,
+    files: null
+  });
+  const ref = (0, import_react.useRef)(null);
+  const dragCounter = (0, import_react.useRef)(0);
+  const handleDragOver = (0, import_react.useCallback)(
+    (e) => {
+      e.preventDefault();
+      e.stopPropagation();
+      onDragOver?.(e);
+    },
+    [onDragOver]
+  );
+  const handleDragEnter = (0, import_react.useCallback)(
+    (e) => {
+      e.preventDefault();
+      e.stopPropagation();
+      dragCounter.current += 1;
+      if (e.dataTransfer.items && e.dataTransfer.items.length > 0) {
+        const hasValidItems = Array.from(e.dataTransfer.items).some((item) => {
+          if (item.kind !== "file") {
+            return false;
+          }
+          if (acceptedFileTypes && acceptedFileTypes.length > 0) {
+            return acceptedFileTypes.some((type) => {
+              if (type.endsWith("/*")) {
+                const category = type.split("/")[0];
+                return item.type.startsWith(`${category}/`);
+              }
+              return item.type === type;
+            });
+          }
+          return true;
+        });
+        if (hasValidItems) {
+          setState((prevState) => ({
+            ...prevState,
+            isDragging: true
+          }));
+        }
+      }
+    },
+    [acceptedFileTypes]
+  );
+  const handleDragLeave = (0, import_react.useCallback)(
+    (e) => {
+      e.preventDefault();
+      e.stopPropagation();
+      dragCounter.current -= 1;
+      if (dragCounter.current === 0) {
+        setState((prevState) => ({
+          ...prevState,
+          isDragging: false
+        }));
+      }
+      onDragLeave?.(e);
+    },
+    [onDragLeave]
+  );
+  const handleDrop = (0, import_react.useCallback)(
+    (e) => {
+      e.preventDefault();
+      e.stopPropagation();
+      dragCounter.current = 0;
+      setState((prevState) => ({
+        ...prevState,
+        isDragging: false
+      }));
+      if (e.dataTransfer.files && e.dataTransfer.files.length > 0) {
+        let validFiles = Array.from(e.dataTransfer.files);
+        if (acceptedFileTypes && acceptedFileTypes.length > 0) {
+          validFiles = validFiles.filter(
+            (file) => acceptedFileTypes.some((type) => {
+              if (type.endsWith("/*")) {
+                const category = type.split("/")[0];
+                return file.type.startsWith(`${category}/`);
+              }
+              return file.type === type;
+            })
+          );
+        }
+        if (maxFileSize) {
+          validFiles = validFiles.filter((file) => file.size <= maxFileSize);
+        }
+        if (!multiple && validFiles.length > 0) {
+          validFiles = [validFiles[0]];
+        }
+        if (validFiles.length > 0) {
+          setState((prevState) => ({
+            ...prevState,
+            files: validFiles
+          }));
+          onDrop?.(validFiles);
+        }
+      }
+    },
+    [onDrop, acceptedFileTypes, maxFileSize, multiple]
+  );
+  (0, import_react.useEffect)(() => {
+    const currentRef = ref.current;
+    if (currentRef) {
+      currentRef.addEventListener("dragover", handleDragOver);
+      currentRef.addEventListener("dragenter", handleDragEnter);
+      currentRef.addEventListener("dragleave", handleDragLeave);
+      currentRef.addEventListener("drop", handleDrop);
+      return () => {
+        currentRef.removeEventListener("dragover", handleDragOver);
+        currentRef.removeEventListener("dragenter", handleDragEnter);
+        currentRef.removeEventListener("dragleave", handleDragLeave);
+        currentRef.removeEventListener("drop", handleDrop);
+      };
+    }
+    return void 0;
+  }, [handleDragOver, handleDragEnter, handleDragLeave, handleDrop]);
+  const reset = (0, import_react.useCallback)(() => {
+    setState({
+      isDragging: false,
+      files: null
+    });
+  }, []);
+  return {
+    ref,
+    isDragging: state.isDragging,
+    files: state.files,
+    reset
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useEffectAfterMount,
+  useElementAttributes,
+  useFileDragDrop,
+  useFilePaste,
+  useFormState
+});
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/index.ts"],"sourcesContent":["import type { ChangeEvent, DependencyList, DragEvent, EffectCallback } from 'react'\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nexport function useElementAttributes<T extends HTMLElement, K extends keyof T>(attributeKeys: K[]) {\n  const ref = useRef<T | null>(null)\n  const [attributeValues, setAttributeValue] = useState<Partial<Pick<T, K>>>({})\n\n  const updateAttribute = useCallback(() => {\n    if (ref.current) {\n      const values = {} as Partial<Pick<T, K>>\n      for (const key of attributeKeys) {\n        // Object.defineProperty (unlike a plain `values[key] = value` assignment) always creates/\n        // overwrites an own property, even if a consumer's T somehow has a key like \"__proto__\" -\n        // matches the same defensive pattern used everywhere else in this package that writes a\n        // non-literal key onto an object.\n        Object.defineProperty(values, key, {\n          value: ref.current[key],\n          writable: true,\n          configurable: true,\n          enumerable: true,\n        })\n      }\n\n      setAttributeValue((prevValues) => {\n        const hasChanged = attributeKeys.some((key) => prevValues[key] !== values[key])\n        return hasChanged ? values : prevValues\n      })\n    }\n  }, [attributeKeys])\n\n  useEffect(() => {\n    updateAttribute()\n    window.addEventListener('resize', updateAttribute)\n\n    if (ref.current) {\n      const observer = new MutationObserver(updateAttribute)\n      observer.observe(ref.current, { attributes: true })\n\n      return () => {\n        window.removeEventListener('resize', updateAttribute)\n        observer.disconnect()\n      }\n    }\n\n    return () => {\n      window.removeEventListener('resize', updateAttribute)\n    }\n  }, [updateAttribute])\n\n  return { ref, attributeValues }\n}\n\ntype InputEventType = ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>\n\nexport function useFormState<T>(initialState: T) {\n  const [formState, setFormState] = useState<T>(initialState)\n  const [formErrors, setFormErrors] = useState<Partial<Record<keyof T, string[]>> & { non_field_errors?: string[] }>()\n\n  function resetFormState() {\n    setFormState(initialState)\n  }\n\n  function handleFormState<K extends keyof T, HandlerInputType>({\n    key,\n    inputType,\n  }: {\n    key: K\n    inputType: 'event' | 'value'\n  }) {\n    return (event: HandlerInputType) => {\n      let value: T[K]\n      if (inputType === 'event') {\n        const target = (event as InputEventType).target\n        if (target.type === 'checkbox') {\n          value = (target as HTMLInputElement).checked as T[K]\n        } else if (target.type === 'number' || target.type === 'range') {\n          value = (target as HTMLInputElement).valueAsNumber as T[K]\n        } else {\n          value = target.value as T[K]\n        }\n      } else {\n        value = event as T[K]\n      }\n      setFormState((prev) => ({ ...prev, [key]: value }))\n    }\n  }\n\n  const handleFormStateValue = <K extends keyof T>(key: K) => handleFormState<K, T[K]>({ key, inputType: 'value' })\n  const handleFormStateEvent = <K extends keyof T>(key: K) =>\n    handleFormState<K, InputEventType>({ key, inputType: 'event' })\n  const handleFormStateOnClick =\n    <K extends keyof T>(key: K, value: T[K]) =>\n    () => {\n      setFormState((prev) => ({ ...prev, [key]: value }))\n    }\n\n  return {\n    formState,\n    setFormState,\n    formErrors,\n    setFormErrors,\n    handleFormStateValue,\n    handleFormStateEvent,\n    handleFormStateOnClick,\n    resetFormState,\n  }\n}\n\nexport function useEffectAfterMount(effect: EffectCallback, deps: DependencyList) {\n  const isFirstRender = useRef(true)\n\n  // No manual \"did deps actually change\" recheck needed here: React's own useEffect already\n  // only re-invokes this callback when a dependency's value changed (shallow-compared against\n  // the last time *this exact effect* ran) - which is exactly the same comparison a hand-rolled\n  // check against a \"previous deps\" ref would be making, just duplicated.\n  useEffect(() => {\n    if (isFirstRender.current) {\n      isFirstRender.current = false\n      return\n    }\n    return effect()\n  }, deps)\n}\n\nexport function useFilePaste({\n  acceptedTypes,\n  maxSize,\n  targetElement,\n  enabled = true,\n}: {\n  acceptedTypes?: string[]\n  maxSize?: number\n  targetElement?: HTMLElement | null\n  enabled?: boolean\n} = {}): {\n  files: File[]\n  isLoading: boolean\n  error: string | null\n  clearFiles: () => void\n} {\n  const [files, setFiles] = useState<File[]>([])\n  const [isLoading, setIsLoading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  const clearFiles = useCallback(() => {\n    setFiles([])\n    setError(null)\n  }, [])\n\n  const validateFiles = useCallback(\n    (pastedFiles: File[]): { valid: true } | { valid: false; error: string } => {\n      if (acceptedTypes && acceptedTypes.length > 0) {\n        const wildcardAcceptedTypes = acceptedTypes\n          .filter((type) => type.endsWith('/*'))\n          .map((type) => type.slice(0, -1))\n        const normalizedAcceptedTypes = acceptedTypes.map((type) => (type.endsWith('/*') ? type.slice(0, -2) : type))\n\n        const invalidFiles = pastedFiles.filter((file) => {\n          const fileType = file.type\n          return (\n            !normalizedAcceptedTypes.includes(fileType) &&\n            !wildcardAcceptedTypes.some((wildcardType) => fileType.startsWith(wildcardType))\n          )\n        })\n        if (invalidFiles.length > 0) {\n          const invalidFileNames = invalidFiles.map((file) => file.name).join(', ')\n          return {\n            valid: false,\n            error: `Invalid file types: ${invalidFileNames}. Accepted types: ${acceptedTypes.join(', ')}`,\n          }\n        }\n      }\n\n      if (maxSize) {\n        const oversizedFile = pastedFiles.find((file) => file.size > maxSize)\n        if (oversizedFile) {\n          const fileSizeMB = (oversizedFile.size / (1024 * 1024)).toFixed(2)\n          const maxSizeMB = (maxSize / (1024 * 1024)).toFixed(2)\n          return {\n            valid: false,\n            error: `File \"${oversizedFile.name}\" (${fileSizeMB} MB) exceeds the maximum size of ${maxSizeMB} MB`,\n          }\n        }\n      }\n\n      return { valid: true }\n    },\n    [acceptedTypes, maxSize]\n  )\n\n  const handlePaste = useCallback(\n    (event: ClipboardEvent) => {\n      const { clipboardData } = event\n      if (!clipboardData) return\n\n      const hasFiles = clipboardData.files && clipboardData.files.length > 0\n      if (!hasFiles) return\n\n      event.preventDefault()\n      setIsLoading(true)\n      setError(null)\n\n      try {\n        const pastedFiles = Array.from(clipboardData.files)\n        const validation = validateFiles(pastedFiles)\n\n        if (!validation.valid) {\n          setError(validation.error)\n          setFiles([])\n        } else {\n          setFiles(pastedFiles)\n        }\n      } catch (err) {\n        setError(err instanceof Error ? err.message : 'Failed to process pasted files')\n        setFiles([])\n      } finally {\n        setIsLoading(false)\n      }\n    },\n    [validateFiles]\n  )\n\n  useEffect(() => {\n    if (!enabled) return\n\n    const target = targetElement || document\n\n    target.addEventListener('paste', handlePaste as EventListener)\n    return () => {\n      target.removeEventListener('paste', handlePaste as EventListener)\n    }\n  }, [enabled, handlePaste, targetElement])\n\n  return { files, isLoading, error, clearFiles }\n}\n\ntype FileDragDropState = {\n  isDragging: boolean\n  files: File[] | null\n}\n\ntype FileDragDropOptions = {\n  onDrop?: (files: File[]) => void\n  onDragOver?: (e: DragEvent<HTMLElement>) => void\n  onDragLeave?: (e: DragEvent<HTMLElement>) => void\n  acceptedFileTypes?: string[]\n  maxFileSize?: number\n  multiple?: boolean\n}\n\nexport function useFileDragDrop<T extends HTMLElement = HTMLDivElement>(options: FileDragDropOptions = {}) {\n  const { onDrop, onDragOver, onDragLeave, acceptedFileTypes, maxFileSize, multiple = true } = options\n\n  const [state, setState] = useState<FileDragDropState>({\n    isDragging: false,\n    files: null,\n  })\n\n  const ref = useRef<T | null>(null)\n  const dragCounter = useRef(0)\n\n  const handleDragOver = useCallback(\n    (e: DragEvent<T>) => {\n      e.preventDefault()\n      e.stopPropagation()\n\n      onDragOver?.(e)\n    },\n    [onDragOver]\n  )\n\n  const handleDragEnter = useCallback(\n    (e: DragEvent<T>) => {\n      e.preventDefault()\n      e.stopPropagation()\n\n      dragCounter.current += 1\n\n      if (e.dataTransfer.items && e.dataTransfer.items.length > 0) {\n        const hasValidItems = Array.from(e.dataTransfer.items).some((item) => {\n          if (item.kind !== 'file') {\n            return false\n          }\n\n          if (acceptedFileTypes && acceptedFileTypes.length > 0) {\n            return acceptedFileTypes.some((type) => {\n              if (type.endsWith('/*')) {\n                const category = type.split('/')[0]\n                return item.type.startsWith(`${category}/`)\n              }\n              return item.type === type\n            })\n          }\n\n          return true\n        })\n\n        if (hasValidItems) {\n          setState((prevState) => ({\n            ...prevState,\n            isDragging: true,\n          }))\n        }\n      }\n    },\n    [acceptedFileTypes]\n  )\n\n  const handleDragLeave = useCallback(\n    (e: DragEvent<T>) => {\n      e.preventDefault()\n      e.stopPropagation()\n\n      dragCounter.current -= 1\n\n      if (dragCounter.current === 0) {\n        setState((prevState) => ({\n          ...prevState,\n          isDragging: false,\n        }))\n      }\n\n      onDragLeave?.(e)\n    },\n    [onDragLeave]\n  )\n\n  const handleDrop = useCallback(\n    (e: DragEvent<T>) => {\n      e.preventDefault()\n      e.stopPropagation()\n\n      dragCounter.current = 0\n      setState((prevState) => ({\n        ...prevState,\n        isDragging: false,\n      }))\n\n      if (e.dataTransfer.files && e.dataTransfer.files.length > 0) {\n        let validFiles = Array.from(e.dataTransfer.files)\n\n        if (acceptedFileTypes && acceptedFileTypes.length > 0) {\n          validFiles = validFiles.filter((file) =>\n            acceptedFileTypes.some((type) => {\n              if (type.endsWith('/*')) {\n                const category = type.split('/')[0]\n                return file.type.startsWith(`${category}/`)\n              }\n              return file.type === type\n            })\n          )\n        }\n\n        if (maxFileSize) {\n          validFiles = validFiles.filter((file) => file.size <= maxFileSize)\n        }\n\n        if (!multiple && validFiles.length > 0) {\n          validFiles = [validFiles[0]]\n        }\n\n        if (validFiles.length > 0) {\n          setState((prevState) => ({\n            ...prevState,\n            files: validFiles,\n          }))\n\n          onDrop?.(validFiles)\n        }\n      }\n    },\n    [onDrop, acceptedFileTypes, maxFileSize, multiple]\n  )\n\n  useEffect(() => {\n    const currentRef = ref.current\n    if (currentRef) {\n      currentRef.addEventListener('dragover', handleDragOver as unknown as EventListener)\n      currentRef.addEventListener('dragenter', handleDragEnter as unknown as EventListener)\n      currentRef.addEventListener('dragleave', handleDragLeave as unknown as EventListener)\n      currentRef.addEventListener('drop', handleDrop as unknown as EventListener)\n\n      return () => {\n        currentRef.removeEventListener('dragover', handleDragOver as unknown as EventListener)\n        currentRef.removeEventListener('dragenter', handleDragEnter as unknown as EventListener)\n        currentRef.removeEventListener('dragleave', handleDragLeave as unknown as EventListener)\n        currentRef.removeEventListener('drop', handleDrop as unknown as EventListener)\n      }\n    }\n    return undefined\n  }, [handleDragOver, handleDragEnter, handleDragLeave, handleDrop])\n\n  const reset = useCallback(() => {\n    setState({\n      isDragging: false,\n      files: null,\n    })\n  }, [])\n\n  return {\n    ref,\n    isDragging: state.isDragging,\n    files: state.files,\n    reset,\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/index.d.cts

@@ -0,0 +1,50 @@
+import * as react from 'react';
+import { EffectCallback, DependencyList, DragEvent, ChangeEvent } from 'react';
+
+declare function useElementAttributes<T extends HTMLElement, K extends keyof T>(attributeKeys: K[]): {
+    ref: react.RefObject<T | null>;
+    attributeValues: Partial<Pick<T, K>>;
+};
+type InputEventType = ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>;
+declare function useFormState<T>(initialState: T): {
+    formState: T;
+    setFormState: react.Dispatch<react.SetStateAction<T>>;
+    formErrors: (Partial<Record<keyof T, string[]>> & {
+        non_field_errors?: string[];
+    }) | undefined;
+    setFormErrors: react.Dispatch<react.SetStateAction<(Partial<Record<keyof T, string[]>> & {
+        non_field_errors?: string[];
+    }) | undefined>>;
+    handleFormStateValue: <K extends keyof T>(key: K) => (event: T[K]) => void;
+    handleFormStateEvent: <K extends keyof T>(key: K) => (event: InputEventType) => void;
+    handleFormStateOnClick: <K extends keyof T>(key: K, value: T[K]) => () => void;
+    resetFormState: () => void;
+};
+declare function useEffectAfterMount(effect: EffectCallback, deps: DependencyList): void;
+declare function useFilePaste({ acceptedTypes, maxSize, targetElement, enabled, }?: {
+    acceptedTypes?: string[];
+    maxSize?: number;
+    targetElement?: HTMLElement | null;
+    enabled?: boolean;
+}): {
+    files: File[];
+    isLoading: boolean;
+    error: string | null;
+    clearFiles: () => void;
+};
+type FileDragDropOptions = {
+    onDrop?: (files: File[]) => void;
+    onDragOver?: (e: DragEvent<HTMLElement>) => void;
+    onDragLeave?: (e: DragEvent<HTMLElement>) => void;
+    acceptedFileTypes?: string[];
+    maxFileSize?: number;
+    multiple?: boolean;
+};
+declare function useFileDragDrop<T extends HTMLElement = HTMLDivElement>(options?: FileDragDropOptions): {
+    ref: react.RefObject<T | null>;
+    isDragging: boolean;
+    files: File[] | null;
+    reset: () => void;
+};
+
+export { useEffectAfterMount, useElementAttributes, useFileDragDrop, useFilePaste, useFormState };

package/dist/hooks/index.d.ts

@@ -0,0 +1,50 @@
+import * as react from 'react';
+import { EffectCallback, DependencyList, DragEvent, ChangeEvent } from 'react';
+
+declare function useElementAttributes<T extends HTMLElement, K extends keyof T>(attributeKeys: K[]): {
+    ref: react.RefObject<T | null>;
+    attributeValues: Partial<Pick<T, K>>;
+};
+type InputEventType = ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>;
+declare function useFormState<T>(initialState: T): {
+    formState: T;
+    setFormState: react.Dispatch<react.SetStateAction<T>>;
+    formErrors: (Partial<Record<keyof T, string[]>> & {
+        non_field_errors?: string[];
+    }) | undefined;
+    setFormErrors: react.Dispatch<react.SetStateAction<(Partial<Record<keyof T, string[]>> & {
+        non_field_errors?: string[];
+    }) | undefined>>;
+    handleFormStateValue: <K extends keyof T>(key: K) => (event: T[K]) => void;
+    handleFormStateEvent: <K extends keyof T>(key: K) => (event: InputEventType) => void;
+    handleFormStateOnClick: <K extends keyof T>(key: K, value: T[K]) => () => void;
+    resetFormState: () => void;
+};
+declare function useEffectAfterMount(effect: EffectCallback, deps: DependencyList): void;
+declare function useFilePaste({ acceptedTypes, maxSize, targetElement, enabled, }?: {
+    acceptedTypes?: string[];
+    maxSize?: number;
+    targetElement?: HTMLElement | null;
+    enabled?: boolean;
+}): {
+    files: File[];
+    isLoading: boolean;
+    error: string | null;
+    clearFiles: () => void;
+};
+type FileDragDropOptions = {
+    onDrop?: (files: File[]) => void;
+    onDragOver?: (e: DragEvent<HTMLElement>) => void;
+    onDragLeave?: (e: DragEvent<HTMLElement>) => void;
+    acceptedFileTypes?: string[];
+    maxFileSize?: number;
+    multiple?: boolean;
+};
+declare function useFileDragDrop<T extends HTMLElement = HTMLDivElement>(options?: FileDragDropOptions): {
+    ref: react.RefObject<T | null>;
+    isDragging: boolean;
+    files: File[] | null;
+    reset: () => void;
+};
+
+export { useEffectAfterMount, useElementAttributes, useFileDragDrop, useFilePaste, useFormState };