@ehfuse/forma 1.0.0

package/dist/esm/utils/dotNotation.js

@@ -0,0 +1,100 @@
+/**
+ * dotNotation.ts
+ *
+ * Forma - Dot notation 관련 유틸리티 함수들 | Dot notation utility functions
+ * 중첩 객체의 값을 안전하게 가져오고 설정하는 기능 제공 | Provides safe getting and setting of nested object values
+ *
+ * @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.
+ */
+/**
+ * dot notation으로 중첩 객체의 값을 가져오는 함수 | Function to get nested object values using dot notation
+ * @param obj 대상 객체 | Target object
+ * @param path dot notation 경로 (예: "user.profile.name") | Dot notation path (e.g., "user.profile.name")
+ * @returns 해당 경로의 값 또는 undefined | Value at the path or undefined
+ *
+ * @example
+ * ```typescript
+ * const data = { user: { profile: { name: 'John' } } };
+ * const name = getNestedValue(data, 'user.profile.name'); // 'John'
+ * ```
+ */
+export function getNestedValue(obj, path) {
+    if (!path.includes(".")) {
+        return obj[path];
+    }
+    const keys = path.split(".");
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * dot notation으로 중첩 객체의 값을 설정하는 함수 | Function to set nested object values using dot notation
+ * 불변성을 유지하면서 새로운 객체를 반환 | Returns a new object while maintaining immutability
+ * @param obj 대상 객체 | Target object
+ * @param path dot notation 경로 | Dot notation path
+ * @param value 설정할 값 | Value to set
+ * @returns 새로운 객체 | New object
+ *
+ * @example
+ * ```typescript
+ * const data = { user: { profile: { name: 'John' } } };
+ * const newData = setNestedValue(data, 'user.profile.name', 'Jane');
+ * // { user: { profile: { name: 'Jane' } } }
+ * ```
+ */
+export function setNestedValue(obj, path, value) {
+    if (!path.includes(".")) {
+        const result = { ...obj, [path]: value };
+        return result;
+    }
+    const keys = path.split(".");
+    const result = Array.isArray(obj) ? [...obj] : { ...obj }; // 배열 타입 보존 | Preserve array type
+    let current = result;
+    // 마지막 키 전까지 객체 생성/복사 | Create/copy objects until the last key
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] === null ||
+            current[key] === undefined ||
+            typeof current[key] !== "object") {
+            current[key] = {};
+            console.log(`📝 새 객체 생성: ${key} | Creating new object: ${key}`);
+        }
+        else {
+            // 배열 타입 보존하면서 복사 | Copy while preserving array type
+            current[key] = Array.isArray(current[key])
+                ? [...current[key]]
+                : { ...current[key] };
+        }
+        current = current[key];
+    }
+    // 마지막 키에 값 설정 | Set value to the last key
+    const lastKey = keys[keys.length - 1];
+    current[lastKey] = value;
+    return result;
+}
+//# sourceMappingURL=dotNotation.js.map

package/dist/esm/utils/dotNotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotNotation.js","sourceRoot":"","sources":["../../../utils/dotNotation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY;IACjD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY,EAAE,KAAU;IAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,iCAAiC;IAC5F,IAAI,OAAO,GAAG,MAAM,CAAC;IAErB,8DAA8D;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IACI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI;YACrB,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAClC,CAAC;YACC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CACP,eAAe,GAAG,2BAA2B,GAAG,EAAE,CACrD,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,oDAAoD;YACpD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,0CAA0C;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IAEzB,OAAO,MAAM,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * utils/index.ts
+ *
+ * @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 { getNestedValue, setNestedValue } from "./dotNotation";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/utils/index.js

@@ -0,0 +1,27 @@
+/**
+ * utils/index.ts
+ *
+ * @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 { getNestedValue, setNestedValue } from "./dotNotation";
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/hooks/useForm.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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 { FormChangeEvent, DatePickerChangeHandler, UseFormProps } from "../types/form";
+import React from "react";
+/**
+ * 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 declare function useForm<T extends Record<string, any>>({ initialValues, onSubmit, onValidate, onComplete, _externalStore, }: UseFormProps<T>): {
+    isSubmitting: boolean;
+    isValidating: boolean;
+    isModified: boolean;
+    useFormValue: (fieldName: string) => unknown;
+    getFormValue: (fieldName: string) => any;
+    getFormValues: () => T;
+    setFormValue: (name: string, value: any) => void;
+    setFormValues: (newValues: Partial<T>) => void;
+    setInitialFormValues: (newInitialValues: T) => void;
+    handleFormChange: (e: FormChangeEvent) => void;
+    handleDatePickerChange: DatePickerChangeHandler;
+    submit: (e?: React.FormEvent) => Promise<boolean>;
+    resetForm: () => void;
+    validateForm: (valuesToValidate?: T) => Promise<boolean>;
+    values: T;
+    _store: FieldStore<T>;
+};
+//# sourceMappingURL=useForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../hooks/useForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACH,eAAe,EACf,uBAAuB,EACvB,YAAY,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,KAMN,MAAM,OAAO,CAAC;AA0Bf;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACnD,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,cAAc,GACjB,EAAE,YAAY,CAAC,CAAC,CAAC;;;;8BAgKE,MAAM;8BAnBN,MAAM,KAAG,GAAG;yBASU,CAAC;yBAhD5B,MAAM,SAAS,GAAG;+BAmBb,OAAO,CAAC,CAAC,CAAC;6CAUH,CAAC;0BApFhB,eAAe;;iBAyJR,KAAK,CAAC,SAAS,KAAG,OAAO,CAAC,OAAO,CAAC;;sCA9BnB,CAAC;;;EA8GlC"}

package/dist/hooks/useForm.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useForm = useForm;
+const FieldStore_1 = require("../core/FieldStore");
+const react_1 = require("react");
+/**
+ * 개별 필드 구독 / Individual field subscription
+ * 특정 필드만 구독하여 해당 필드가 변경될 때만 리렌더링
+ * Subscribe to specific field only, re-render only when that field changes
+ */
+function useFieldValue(store, fieldName) {
+    const [value, setValue] = (0, react_1.useState)(() => store.getValue(fieldName));
+    (0, react_1.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
+ */
+function useForm({ initialValues, onSubmit, onValidate, onComplete, _externalStore, }) {
+    // Store 인스턴스 (외부 스토어가 있으면 사용, 없으면 로컬 생성)
+    // Store instance (use external store if provided, otherwise create local one)
+    const storeRef = (0, react_1.useRef)(null);
+    if (_externalStore) {
+        storeRef.current = _externalStore;
+    }
+    else if (!storeRef.current) {
+        storeRef.current = new FieldStore_1.FieldStore(initialValues);
+    }
+    const store = storeRef.current;
+    const [isSubmitting, setIsSubmitting] = (0, react_1.useState)(false);
+    const [isValidating, setIsValidating] = (0, react_1.useState)(false);
+    const [isModified, setIsModified] = (0, react_1.useState)(false);
+    // 전역 상태 구독 (isModified 추적) / Global state subscription (isModified tracking)
+    (0, react_1.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] = (0, react_1.useState)(() => store.getValues());
+    (0, react_1.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 = (0, react_1.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 = (0, react_1.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 = (0, react_1.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 = (0, react_1.useCallback)((newValues) => {
+        store.setValues(newValues);
+    }, [store]);
+    /**
+     * 초기값 재설정 / Reset initial values
+     */
+    const setInitialFormValues = (0, react_1.useCallback)((newInitialValues) => {
+        store.setInitialValues(newInitialValues);
+    }, [store]);
+    /**
+     * 구독 없이 현재 값만 가져오기 / Get current value without subscription
+     */
+    const getFormValue = (0, react_1.useCallback)((fieldName) => {
+        return store.getValue(fieldName);
+    }, [store]);
+    /**
+     * 모든 폼 값 가져오기 / Get all form values
+     */
+    const getFormValues = (0, react_1.useCallback)(() => {
+        return store.getValues();
+    }, [store]);
+    /**
+     * 개별 필드 구독 Hook / Individual field subscription hook
+     * 해당 필드가 변경될 때만 컴포넌트가 리렌더링됩니다
+     * Component re-renders only when the specific field changes
+     */
+    const useFormValue = (0, react_1.useCallback)((fieldName) => {
+        return useFieldValue(store, fieldName);
+    }, [store]);
+    /**
+     * 폼 검증 / Form validation
+     */
+    const validateForm = (0, react_1.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 = (0, react_1.useCallback)(() => {
+        store.reset();
+        setIsSubmitting(false);
+        setIsValidating(false);
+    }, [store]);
+    /**
+     * 폼 제출 / Submit form
+     */
+    const submit = (0, react_1.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 (0, react_1.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/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/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/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/hooks/useGlobalForm.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGlobalForm = useGlobalForm;
+const react_1 = require("react");
+const useForm_1 = require("./useForm");
+const GlobalFormContext_1 = require("../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
+ */
+function useGlobalForm({ formId, }) {
+    const { getOrCreateStore } = (0, react_1.useContext)(GlobalFormContext_1.GlobalFormContext);
+    // 글로벌 스토어 가져오기 또는 생성 / Get or create global store
+    const store = getOrCreateStore(formId);
+    // useForm에 외부 스토어 전달 (빈 초기값으로) / Pass external store to useForm (with empty initial values)
+    const form = (0, useForm_1.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/hooks/useGlobalForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalForm.js","sourceRoot":"","sources":["../../hooks/useGlobalForm.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;AAoBH,sCAmBC;AArCD,iCAAmC;AACnC,uCAAoC;AAEpC,qEAAkE;AAElE;;;;;;;;;;;;GAYG;AACH,SAAgB,aAAa,CAAgC,EACzD,MAAM,GACc;IACpB,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAA,kBAAU,EAAC,qCAAiB,CAAC,CAAC;IAE3D,kDAAkD;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAI,MAAM,CAAC,CAAC;IAE1C,4FAA4F;IAC5F,MAAM,IAAI,GAAG,IAAA,iBAAO,EAAI;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"}