@ehfuse/forma 1.0.0

package/dist/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/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/hooks/useRegisterGlobalForm.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRegisterGlobalForm = useRegisterGlobalForm;
+const react_1 = require("react");
+const GlobalFormContext_1 = require("../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>;
+ * }
+ * ```
+ */
+function useRegisterGlobalForm(formId, form) {
+    const { registerStore } = (0, react_1.useContext)(GlobalFormContext_1.GlobalFormContext);
+    (0, react_1.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/hooks/useRegisterGlobalForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRegisterGlobalForm.js","sourceRoot":"","sources":["../../hooks/useRegisterGlobalForm.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;AA6BH,sDAYC;AAvCD,iCAA8C;AAE9C,qEAAkE;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,qBAAqB,CACjC,MAAc,EACd,IAAsB;IAEtB,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,kBAAU,EAAC,qCAAiB,CAAC,CAAC;IAExD,IAAA,iBAAS,EAAC,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/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/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/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORMA_METADATA = exports.FORMA_VERSION = exports.setNestedValue = exports.getNestedValue = exports.FieldStore = exports.GlobalFormProvider = exports.GlobalFormContext = exports.useRegisterGlobalForm = exports.useGlobalForm = exports.useForm = void 0;
+// ===== Core Hooks =====
+var useForm_1 = require("./hooks/useForm");
+Object.defineProperty(exports, "useForm", { enumerable: true, get: function () { return useForm_1.useForm; } });
+var useGlobalForm_1 = require("./hooks/useGlobalForm");
+Object.defineProperty(exports, "useGlobalForm", { enumerable: true, get: function () { return useGlobalForm_1.useGlobalForm; } });
+var useRegisterGlobalForm_1 = require("./hooks/useRegisterGlobalForm");
+Object.defineProperty(exports, "useRegisterGlobalForm", { enumerable: true, get: function () { return useRegisterGlobalForm_1.useRegisterGlobalForm; } });
+// ===== Context & Providers =====
+var GlobalFormContext_1 = require("./contexts/GlobalFormContext");
+Object.defineProperty(exports, "GlobalFormContext", { enumerable: true, get: function () { return GlobalFormContext_1.GlobalFormContext; } });
+Object.defineProperty(exports, "GlobalFormProvider", { enumerable: true, get: function () { return GlobalFormContext_1.GlobalFormProvider; } });
+// ===== Core Classes =====
+var FieldStore_1 = require("./core/FieldStore");
+Object.defineProperty(exports, "FieldStore", { enumerable: true, get: function () { return FieldStore_1.FieldStore; } });
+// ===== Utility Functions =====
+var dotNotation_1 = require("./utils/dotNotation");
+Object.defineProperty(exports, "getNestedValue", { enumerable: true, get: function () { return dotNotation_1.getNestedValue; } });
+Object.defineProperty(exports, "setNestedValue", { enumerable: true, get: function () { return dotNotation_1.setNestedValue; } });
+/**
+ * Forma library version
+ */
+exports.FORMA_VERSION = "1.0.0";
+/**
+ * Forma library metadata
+ */
+exports.FORMA_METADATA = {
+    name: "Forma",
+    version: exports.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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAEH,yBAAyB;AACzB,2CAA0C;AAAjC,kGAAA,OAAO,OAAA;AAChB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAE9B,kCAAkC;AAClC,kEAGsC;AAFlC,sHAAA,iBAAiB,OAAA;AACjB,uHAAA,kBAAkB,OAAA;AAGtB,2BAA2B;AAC3B,gDAA+C;AAAtC,wGAAA,UAAU,OAAA;AAEnB,gCAAgC;AAChC,mDAAqE;AAA5D,6GAAA,cAAc,OAAA;AAAE,6GAAA,cAAc,OAAA;AA0BvC;;GAEG;AACU,QAAA,aAAa,GAAG,OAAO,CAAC;AAErC;;GAEG;AACU,QAAA,cAAc,GAAG;IAC1B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,qBAAa;IACtB,WAAW,EAAE,8CAA8C;IAC3D,MAAM,EAAE,+BAA+B;IACvC,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACN,4DAA4D;QAC5D,kDAAkD;QAClD,wCAAwC;QACxC,8BAA8B;QAC9B,6BAA6B;QAC7B,qCAAqC;KACxC;CACK,CAAC"}

package/dist/types/form.d.ts

@@ -0,0 +1,120 @@
+/**
+ * form.ts
+ *
+ * Forma - 기본 폼 관련 타입 정의 | Basic form-related type definitions
+ *
+ * @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";
+type SelectChangeEvent<T = string> = {
+    target: {
+        name?: string;
+        value: T;
+    };
+};
+type PickerChangeHandlerContext<T> = any;
+/**
+ * 폼 이벤트 타입 정의 | Form event type definitions
+ * MUI 컴포넌트들의 다양한 이벤트 타입을 통합 | Unified event types for various MUI components
+ */
+export type FormChangeEvent = React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement> | SelectChangeEvent | SelectChangeEvent<string | number> | {
+    target: {
+        name: string;
+        value: any;
+    };
+    onChange?: (value: any, context: PickerChangeHandlerContext<any>) => void;
+};
+/**
+ * DatePicker 전용 핸들러 타입
+ * MUI DatePicker 컴포넌트와의 통합을 위한 타입
+ */
+export type DatePickerChangeHandler = (fieldName: string) => (value: any, context?: PickerChangeHandlerContext<any>) => void;
+/**
+ * useForm 훅의 Props 타입 | useForm hook Props type
+ */
+export interface UseFormProps<T extends Record<string, any>> {
+    /** 폼의 초기값 | Initial form values */
+    initialValues: T;
+    /** 폼 제출 핸들러 | Form submission handler */
+    onSubmit?: (values: T) => Promise<void> | void;
+    /** 폼 검증 핸들러 | Form validation handler */
+    onValidate?: (values: T) => Promise<boolean> | boolean;
+    /** 폼 제출 완료 후 콜백 | Callback after form submission completion */
+    onComplete?: (values: T) => void;
+    /** 내부 API - 전역 상태용 외부 스토어 | Internal API - external store for global state */
+    _externalStore?: FieldStore<T>;
+}
+/**
+ * useForm 훅의 반환 타입 | useForm hook return type
+ */
+export interface UseFormReturn<T extends Record<string, any>> {
+    /** 개별 필드 값 구독 함수 | Individual field value subscription function */
+    useFormValue: (fieldName: keyof T | string) => any;
+    /** 폼 변경 핸들러 (MUI 컴포넌트용) | Form change handler (for MUI components) */
+    handleFormChange: (event: FormChangeEvent) => void;
+    /** DatePicker 변경 핸들러 | DatePicker change handler */
+    handleDatePickerChange: DatePickerChangeHandler;
+    /** 모든 폼 값 가져오기 | Get all form values */
+    getFormValues: () => T;
+    /** 특정 필드 값 가져오기 | Get specific field value */
+    getFormValue: (fieldName: keyof T | string) => any;
+    /** 특정 필드 값 설정 | Set specific field value */
+    setFormValue: (fieldName: keyof T | string, value: any) => void;
+    /** 모든 폼 값 설정 | Set all form values */
+    setFormValues: (values: Partial<T>) => void;
+    /** 초기값 재설정 | Reset initial values */
+    setInitialFormValues: (newInitialValues: T) => void;
+    /** 폼 리셋 | Reset form */
+    resetForm: () => void;
+    /** 폼 제출 | Submit form */
+    submit: () => Promise<boolean>;
+    /** 폼 검증 | Validate form */
+    validateForm: () => Promise<boolean>;
+    /** 수정 여부 | Modified status */
+    isModified: boolean;
+    /** 제출 중 여부 | Submitting status */
+    isSubmitting: boolean;
+    /** 검증 중 여부 | Validating status */
+    isValidating: boolean;
+    /** 호환성을 위한 values 객체 (비권장) | Values object for compatibility (not recommended) */
+    values: T;
+    /** 내부 스토어 직접 접근 | Direct access to internal store */
+    _store: FieldStore<T>;
+}
+/**
+ * 폼 상태 타입 | Form state type
+ */
+export type FormState = "idle" | "submitting" | "validating" | "error" | "success";
+/**
+ * 폼 검증 결과 타입 | Form validation result type
+ */
+export interface FormValidationResult {
+    /** 검증 성공 여부 | Validation success status */
+    isValid: boolean;
+    /** 에러 메시지 (필드별) | Error messages (by field) */
+    errors?: Record<string, string>;
+    /** 전체 에러 메시지 | Overall error message */
+    message?: string;
+}
+export {};
+//# sourceMappingURL=form.d.ts.map

package/dist/types/form.d.ts.map

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

package/dist/types/form.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * form.ts
+ *
+ * Forma - 기본 폼 관련 타입 정의 | Basic form-related type definitions
+ *
+ * @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 });
+//# sourceMappingURL=form.js.map

package/dist/types/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../types/form.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}