@ehfuse/forma 1.0.0

package/dist/esm/hooks/useForm.js

@@ -0,0 +1,287 @@
+/**
+ * useForm.ts
+ *
+ * Forma - 고급 폼 상태 관리 훅 / Advanced form state management hook
+ * 개별 필드 구독과 성능 최적화를 제공하는 핵심 훅
+ * Core hook providing individual field subscriptions and performance optimization
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+import { FieldStore } from "../core/FieldStore";
+import { useEffect, useState, useCallback, useRef, useMemo, } from "react";
+/**
+ * 개별 필드 구독 / Individual field subscription
+ * 특정 필드만 구독하여 해당 필드가 변경될 때만 리렌더링
+ * Subscribe to specific field only, re-render only when that field changes
+ */
+function useFieldValue(store, fieldName) {
+    const [value, setValue] = useState(() => store.getValue(fieldName));
+    useEffect(() => {
+        // 구독 설정 / Setup subscription
+        const unsubscribe = store.subscribe(fieldName, () => {
+            const newValue = store.getValue(fieldName);
+            setValue(newValue);
+        });
+        return unsubscribe;
+    }, [fieldName]); // store 의존성 제거로 불필요한 재구독 방지 / Remove store dependency to prevent unnecessary re-subscriptions
+    return value;
+}
+/**
+ * Forma 핵심 폼 관리 훅 / Forma core form management hook
+ *
+ * 고급 폼 상태 관리와 성능 최적화를 제공합니다
+ * Provides advanced form state management and performance optimization
+ *
+ * Features:
+ * - 개별 필드 구독으로 선택적 리렌더링 / Selective re-rendering with individual field subscriptions
+ * - Dot notation 지원으로 중첩 객체 처리 / Nested object handling with dot notation support
+ * - MUI 컴포넌트 완전 호환 / Full MUI component compatibility
+ * - TypeScript 완전 지원 / Complete TypeScript support
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ * @param props 폼 설정 옵션 / Form configuration options
+ * @returns 폼 관리 API 객체 / Form management API object
+ */
+export function useForm({ initialValues, onSubmit, onValidate, onComplete, _externalStore, }) {
+    // Store 인스턴스 (외부 스토어가 있으면 사용, 없으면 로컬 생성)
+    // Store instance (use external store if provided, otherwise create local one)
+    const storeRef = useRef(null);
+    if (_externalStore) {
+        storeRef.current = _externalStore;
+    }
+    else if (!storeRef.current) {
+        storeRef.current = new FieldStore(initialValues);
+    }
+    const store = storeRef.current;
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const [isValidating, setIsValidating] = useState(false);
+    const [isModified, setIsModified] = useState(false);
+    // 전역 상태 구독 (isModified 추적) / Global state subscription (isModified tracking)
+    useEffect(() => {
+        const checkModified = () => {
+            const modified = store.isModified();
+            setIsModified(modified);
+        };
+        checkModified();
+        const unsubscribe = store.subscribeGlobal(checkModified);
+        return unsubscribe;
+    }, [store]);
+    // 호환성을 위한 values 객체 (비권장) / Values object for compatibility (not recommended)
+    const [valuesSnapshot, setValuesSnapshot] = useState(() => store.getValues());
+    useEffect(() => {
+        const unsubscribe = store.subscribeGlobal(() => {
+            setValuesSnapshot(store.getValues());
+        });
+        return unsubscribe;
+    }, [store]);
+    const values = valuesSnapshot;
+    /**
+     * 통합 폼 변경 핸들러 / Unified form change handler
+     * MUI Select, TextField, DatePicker 등 모든 컴포넌트 지원
+     * Supports all components: MUI Select, TextField, DatePicker, etc.
+     */
+    const handleFormChange = useCallback((e) => {
+        const target = e.target;
+        if (!target || !target.name)
+            return;
+        const { name, type, value, checked } = target;
+        let newValue = value;
+        // DatePicker 처리 (Dayjs 객체) / DatePicker handling (Dayjs object)
+        if (value && typeof value === "object" && value.format) {
+            newValue = value.format("YYYY-MM-DD");
+        }
+        // 체크박스 처리 / Checkbox handling
+        else if (type === "checkbox") {
+            newValue = checked;
+        }
+        // 숫자 타입 처리 / Number type handling
+        else if (type === "number") {
+            newValue = Number(value);
+        }
+        // null 값 처리 / Null value handling
+        else if (value === null) {
+            newValue = undefined;
+        }
+        store.setValue(name, newValue);
+    }, [store]);
+    /**
+     * DatePicker 전용 변경 핸들러 / DatePicker-specific change handler
+     * 간편한 사용을 위한 커링 함수 / Curried function for convenient usage
+     */
+    const handleDatePickerChange = useCallback((fieldName) => {
+        return (value, _context) => {
+            let newValue = value;
+            // DatePicker 처리 (Dayjs 객체) / DatePicker handling (Dayjs object)
+            if (value && typeof value === "object" && value.format) {
+                newValue = value.format("YYYY-MM-DD");
+            }
+            else if (value === null) {
+                newValue = undefined;
+            }
+            store.setValue(fieldName, newValue);
+        };
+    }, [store]);
+    /**
+     * 개별 필드 값 설정 / Set individual field value
+     */
+    const setFormValue = useCallback((name, value) => {
+        let processedValue = value;
+        // DatePicker에서 오는 Dayjs 객체 처리 / Handle Dayjs object from DatePicker
+        if (value && typeof value === "object" && value.format) {
+            processedValue = value.format("YYYY-MM-DD");
+        }
+        else if (value === null) {
+            processedValue = undefined;
+        }
+        store.setValue(name, processedValue);
+    }, [store]);
+    /**
+     * 전체 폼 값 설정 / Set all form values
+     */
+    const setFormValues = useCallback((newValues) => {
+        store.setValues(newValues);
+    }, [store]);
+    /**
+     * 초기값 재설정 / Reset initial values
+     */
+    const setInitialFormValues = useCallback((newInitialValues) => {
+        store.setInitialValues(newInitialValues);
+    }, [store]);
+    /**
+     * 구독 없이 현재 값만 가져오기 / Get current value without subscription
+     */
+    const getFormValue = useCallback((fieldName) => {
+        return store.getValue(fieldName);
+    }, [store]);
+    /**
+     * 모든 폼 값 가져오기 / Get all form values
+     */
+    const getFormValues = useCallback(() => {
+        return store.getValues();
+    }, [store]);
+    /**
+     * 개별 필드 구독 Hook / Individual field subscription hook
+     * 해당 필드가 변경될 때만 컴포넌트가 리렌더링됩니다
+     * Component re-renders only when the specific field changes
+     */
+    const useFormValue = useCallback((fieldName) => {
+        return useFieldValue(store, fieldName);
+    }, [store]);
+    /**
+     * 폼 검증 / Form validation
+     */
+    const validateForm = useCallback(async (valuesToValidate) => {
+        if (!onValidate)
+            return true;
+        setIsValidating(true);
+        const currentValues = valuesToValidate || store.getValues();
+        try {
+            return await onValidate(currentValues);
+        }
+        catch (error) {
+            console.error("Validation error:", error);
+            return false;
+        }
+        finally {
+            setIsValidating(false);
+        }
+    }, [onValidate, store]);
+    /**
+     * 폼 초기화 / Reset form
+     */
+    const resetForm = useCallback(() => {
+        store.reset();
+        setIsSubmitting(false);
+        setIsValidating(false);
+    }, [store]);
+    /**
+     * 폼 제출 / Submit form
+     */
+    const submit = useCallback(async (e) => {
+        if (e)
+            e.preventDefault();
+        const currentValues = store.getValues();
+        if (!(await validateForm(currentValues))) {
+            return false;
+        }
+        setIsSubmitting(true);
+        try {
+            if (onSubmit) {
+                await onSubmit(currentValues);
+            }
+            if (onComplete) {
+                onComplete(currentValues);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error("Form submission error:", error);
+            return false;
+        }
+        finally {
+            setIsSubmitting(false);
+        }
+    }, [onSubmit, onComplete, validateForm, store]);
+    return useMemo(() => ({
+        // 상태 / State
+        isSubmitting,
+        isValidating,
+        isModified,
+        // 값 가져오기 / Get values
+        useFormValue, // Hook - 구독 있음 (성능 최적화) / with subscription (performance optimized)
+        getFormValue, // 함수 - 구독 없음 (현재 값만) / function - no subscription (current value only)
+        getFormValues, // 함수 - 모든 값 / function - all values
+        // 값 설정 / Set values
+        setFormValue, // 개별 필드 설정 / set individual field
+        setFormValues, // 전체 값 설정 / set all values
+        setInitialFormValues, // 초기값 재설정 / reset initial values
+        // 이벤트 핸들러 / Event handlers
+        handleFormChange, // 폼 요소 onChange (MUI 완전 호환) / form element onChange (fully MUI compatible)
+        handleDatePickerChange, // DatePicker 전용 onChange / DatePicker-specific onChange
+        // 폼 액션 / Form actions
+        submit, // 폼 제출 / submit form
+        resetForm, // 폼 초기화 / reset form
+        validateForm, // 폼 검증 / validate form
+        // 호환성 / Compatibility
+        values, // 비권장: 전체 리렌더링 발생 / not recommended: causes full re-renders
+        // 고급 사용 / Advanced usage
+        _store: store, // 직접 store 접근용 / direct store access
+    }), [
+        isSubmitting,
+        isValidating,
+        isModified,
+        useFormValue,
+        getFormValue,
+        getFormValues,
+        setFormValue,
+        setFormValues,
+        setInitialFormValues,
+        handleFormChange,
+        handleDatePickerChange,
+        submit,
+        resetForm,
+        validateForm,
+        values,
+    ]);
+}
+//# sourceMappingURL=useForm.js.map

package/dist/esm/hooks/useForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.js","sourceRoot":"","sources":["../../../hooks/useForm.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/useGlobalForm.d.ts

@@ -0,0 +1,45 @@
+/**
+ * useGlobalForm.ts
+ *
+ * Forma - 글로벌 폼 상태 관리 훅 / Global form state management hook
+ * 여러 컴포넌트 간 폼 상태 공유를 위한 확장 훅
+ * Extended hook for sharing form state across multiple components
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+import { UseGlobalFormProps, UseGlobalFormReturn } from "../types/globalForm";
+/**
+ * 글로벌 폼 상태 관리 훅 / Global form state management hook
+ *
+ * 여러 컴포넌트 간 폼 데이터를 공유하기 위한 훅입니다
+ * Hook for sharing form data across multiple components
+ *
+ * 데이터 공유에만 집중하며, 초기값 설정과 제출/검증 로직은 각 컴포넌트에서 직접 처리합니다
+ * Focuses only on data sharing; initial values and submission/validation logic handled by individual components
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ * @param props 글로벌 폼 설정 옵션 / Global form configuration options
+ * @returns 글로벌 폼 관리 API 객체 / Global form management API object
+ */
+export declare function useGlobalForm<T extends Record<string, any>>({ formId, }: UseGlobalFormProps<T>): UseGlobalFormReturn<T>;
+//# sourceMappingURL=useGlobalForm.d.ts.map

package/dist/esm/hooks/useGlobalForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalForm.d.ts","sourceRoot":"","sources":["../../../hooks/useGlobalForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACzD,MAAM,GACT,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAiBhD"}

package/dist/esm/hooks/useGlobalForm.js

@@ -0,0 +1,61 @@
+/**
+ * useGlobalForm.ts
+ *
+ * Forma - 글로벌 폼 상태 관리 훅 / Global form state management hook
+ * 여러 컴포넌트 간 폼 상태 공유를 위한 확장 훅
+ * Extended hook for sharing form state across multiple components
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+import { useContext } from "react";
+import { useForm } from "./useForm";
+import { GlobalFormContext } from "../contexts/GlobalFormContext";
+/**
+ * 글로벌 폼 상태 관리 훅 / Global form state management hook
+ *
+ * 여러 컴포넌트 간 폼 데이터를 공유하기 위한 훅입니다
+ * Hook for sharing form data across multiple components
+ *
+ * 데이터 공유에만 집중하며, 초기값 설정과 제출/검증 로직은 각 컴포넌트에서 직접 처리합니다
+ * Focuses only on data sharing; initial values and submission/validation logic handled by individual components
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ * @param props 글로벌 폼 설정 옵션 / Global form configuration options
+ * @returns 글로벌 폼 관리 API 객체 / Global form management API object
+ */
+export function useGlobalForm({ formId, }) {
+    const { getOrCreateStore } = useContext(GlobalFormContext);
+    // 글로벌 스토어 가져오기 또는 생성 / Get or create global store
+    const store = getOrCreateStore(formId);
+    // useForm에 외부 스토어 전달 (빈 초기값으로) / Pass external store to useForm (with empty initial values)
+    const form = useForm({
+        initialValues: {},
+        _externalStore: store,
+    });
+    return {
+        ...form,
+        formId, // 글로벌 폼 ID 추가 제공 / Provide additional global form ID
+        _store: store, // 글로벌 스토어 직접 접근용 / Direct access to global store
+    };
+}
+//# sourceMappingURL=useGlobalForm.js.map

package/dist/esm/hooks/useGlobalForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalForm.js","sourceRoot":"","sources":["../../../hooks/useGlobalForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAgC,EACzD,MAAM,GACc;IACpB,MAAM,EAAE,gBAAgB,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE3D,kDAAkD;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAI,MAAM,CAAC,CAAC;IAE1C,4FAA4F;IAC5F,MAAM,IAAI,GAAG,OAAO,CAAI;QACpB,aAAa,EAAE,EAAO;QACtB,cAAc,EAAE,KAAK;KACxB,CAAC,CAAC;IAEH,OAAO;QACH,GAAG,IAAI;QACP,MAAM,EAAE,qDAAqD;QAC7D,MAAM,EAAE,KAAK,EAAE,iDAAiD;KACzC,CAAC;AAChC,CAAC"}

package/dist/esm/hooks/useRegisterGlobalForm.d.ts

@@ -0,0 +1,55 @@
+/**
+ * useRegisterGlobalForm.ts
+ *
+ * Forma - 기존 useForm을 글로벌 폼으로 등록하는 훅 | Hook to register existing useForm as global form
+ * 기존에 만든 로컬 폼을 글로벌 상태로 공유할 수 있게 해주는 유틸리티
+ * Utility to enable sharing existing local forms as global state
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+import { UseFormReturn } from "../types/form";
+/**
+ * 기존 useForm을 글로벌 폼으로 등록하는 훅 | Hook to register existing useForm as global form
+ *
+ * 이미 만들어진 로컬 폼을 글로벌 상태로 공유하고 싶을 때 사용합니다.
+ * Use this when you want to share an already created local form as global state.
+ *
+ * @template T 폼 데이터의 타입 | Form data type
+ * @param formId 글로벌 폼 식별자 | Global form identifier
+ * @param form 등록할 useForm 인스턴스 | useForm instance to register
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const form = useForm({ initialValues: { name: '', email: '' } });
+ *
+ *   // 로컬 폼을 글로벌로 등록
+ *   useRegisterGlobalForm('my-form-id', form);
+ *
+ *   // 이제 다른 컴포넌트에서 useGlobalForm({ formId: 'my-form-id' })로 접근 가능
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useRegisterGlobalForm<T extends Record<string, any>>(formId: string, form: UseFormReturn<T>): void;
+//# sourceMappingURL=useRegisterGlobalForm.d.ts.map

package/dist/esm/hooks/useRegisterGlobalForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRegisterGlobalForm.d.ts","sourceRoot":"","sources":["../../../hooks/useRegisterGlobalForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/D,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,IAAI,CASN"}

package/dist/esm/hooks/useRegisterGlobalForm.js

@@ -0,0 +1,64 @@
+/**
+ * useRegisterGlobalForm.ts
+ *
+ * Forma - 기존 useForm을 글로벌 폼으로 등록하는 훅 | Hook to register existing useForm as global form
+ * 기존에 만든 로컬 폼을 글로벌 상태로 공유할 수 있게 해주는 유틸리티
+ * Utility to enable sharing existing local forms as global state
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+import { useContext, useEffect } from "react";
+import { GlobalFormContext } from "../contexts/GlobalFormContext";
+/**
+ * 기존 useForm을 글로벌 폼으로 등록하는 훅 | Hook to register existing useForm as global form
+ *
+ * 이미 만들어진 로컬 폼을 글로벌 상태로 공유하고 싶을 때 사용합니다.
+ * Use this when you want to share an already created local form as global state.
+ *
+ * @template T 폼 데이터의 타입 | Form data type
+ * @param formId 글로벌 폼 식별자 | Global form identifier
+ * @param form 등록할 useForm 인스턴스 | useForm instance to register
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const form = useForm({ initialValues: { name: '', email: '' } });
+ *
+ *   // 로컬 폼을 글로벌로 등록
+ *   useRegisterGlobalForm('my-form-id', form);
+ *
+ *   // 이제 다른 컴포넌트에서 useGlobalForm({ formId: 'my-form-id' })로 접근 가능
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export function useRegisterGlobalForm(formId, form) {
+    const { registerStore } = useContext(GlobalFormContext);
+    useEffect(() => {
+        // useForm의 내부 store를 글로벌에 등록 | Register useForm's internal store globally
+        if (form._store) {
+            registerStore(formId, form._store);
+        }
+    }, [formId, form._store, registerStore]);
+}
+//# sourceMappingURL=useRegisterGlobalForm.js.map

package/dist/esm/hooks/useRegisterGlobalForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRegisterGlobalForm.js","sourceRoot":"","sources":["../../../hooks/useRegisterGlobalForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CACjC,MAAc,EACd,IAAsB;IAEtB,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACX,0EAA0E;QAC1E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;IACL,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * index.ts
+ *
+ * Forma - Advanced React form state management library
+ * Main entry point and API exports
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+export { useForm } from "./hooks/useForm";
+export { useGlobalForm } from "./hooks/useGlobalForm";
+export { useRegisterGlobalForm } from "./hooks/useRegisterGlobalForm";
+export { GlobalFormContext, GlobalFormProvider, } from "./contexts/GlobalFormContext";
+export { FieldStore } from "./core/FieldStore";
+export { getNestedValue, setNestedValue } from "./utils/dotNotation";
+export type { UseFormProps, UseFormReturn, FormChangeEvent, DatePickerChangeHandler, } from "./types/form";
+export type { UseGlobalFormProps, UseGlobalFormReturn, GlobalFormProviderProps, GlobalFormContextType, GlobalFormStoreMap, GlobalFormMetadata, GlobalFormEvent, GlobalFormEventListener, GlobalFormConfig, GlobalFormMiddleware, ExtendedGlobalFormProviderProps, } from "./types/globalForm";
+/**
+ * Forma library version
+ */
+export declare const FORMA_VERSION = "1.0.0";
+/**
+ * Forma library metadata
+ */
+export declare const FORMA_METADATA: {
+    readonly name: "Forma";
+    readonly version: "1.0.0";
+    readonly description: "Advanced React form state management library";
+    readonly author: "KIM YOUNG JIN (Kim Young Jin)";
+    readonly email: "ehfuse@gmail.com";
+    readonly license: "MIT";
+    readonly features: readonly ["Optimized re-rendering with individual field subscriptions", "Nested object handling with dot notation support", "Full compatibility with MUI components", "Global form state management", "Complete TypeScript support", "Leveraging latest React 19 features"];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EACH,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrE,YAAY,EACR,YAAY,EACZ,aAAa,EACb,eAAe,EACf,uBAAuB,GAC1B,MAAM,cAAc,CAAC;AAGtB,YAAY,EACR,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,+BAA+B,GAClC,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;CAejB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,62 @@
+/**
+ * index.ts
+ *
+ * Forma - Advanced React form state management library
+ * Main entry point and API exports
+ *
+ * @license MIT License
+ * @copyright 2025 KIM YOUNG JIN (Kim Young Jin)
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+// ===== Core Hooks =====
+export { useForm } from "./hooks/useForm";
+export { useGlobalForm } from "./hooks/useGlobalForm";
+export { useRegisterGlobalForm } from "./hooks/useRegisterGlobalForm";
+// ===== Context & Providers =====
+export { GlobalFormContext, GlobalFormProvider, } from "./contexts/GlobalFormContext";
+// ===== Core Classes =====
+export { FieldStore } from "./core/FieldStore";
+// ===== Utility Functions =====
+export { getNestedValue, setNestedValue } from "./utils/dotNotation";
+/**
+ * Forma library version
+ */
+export const FORMA_VERSION = "1.0.0";
+/**
+ * Forma library metadata
+ */
+export const FORMA_METADATA = {
+    name: "Forma",
+    version: FORMA_VERSION,
+    description: "Advanced React form state management library",
+    author: "KIM YOUNG JIN (Kim Young Jin)",
+    email: "ehfuse@gmail.com",
+    license: "MIT",
+    features: [
+        "Optimized re-rendering with individual field subscriptions",
+        "Nested object handling with dot notation support",
+        "Full compatibility with MUI components",
+        "Global form state management",
+        "Complete TypeScript support",
+        "Leveraging latest React 19 features",
+    ],
+};
+//# sourceMappingURL=index.js.map