@ehfuse/forma 1.0.4 → 1.2.0

package/README.md

@@ -9,19 +9,19 @@
 
 ### 한국어 | Korean
 
-- 🚀 **[시작 가이드](./docs/getting-started-ko.md)** - 단계별 튜토리얼과 예제
-- 📖 **[완전한 문서](./docs/README-ko.md)** - API 레퍼런스, 사용 사례, 고급 기능
-- 📋 **[API 레퍼런스](./docs/API-ko.md)** - 모든 메서드, 타입, 마이그레이션 가이드
-- ⚡ **[성능 최적화 가이드](./docs/best-practices-ko.md)** - 최고 성능을 위한 모범 사례
-- 🏠 **[GitHub](https://github.com/ehfuse/forma)**
+-   🚀 **[시작 가이드](./docs/getting-started-ko.md)** - 단계별 튜토리얼과 예제
+-   📖 **[완전한 문서](./docs/README-ko.md)** - API 레퍼런스, 사용 사례, 고급 기능
+-   📋 **[API 레퍼런스](./docs/API-ko.md)** - 모든 메서드, 타입, 마이그레이션 가이드
+-   ⚡ **[성능 최적화 가이드](./docs/best-practices-ko.md)** - 최고 성능을 위한 모범 사례
+-   🏠 **[GitHub](https://github.com/ehfuse/forma)**
 
 ### English
 
-- 🚀 **[Getting Started Guide](./docs/getting-started-en.md)** - Step-by-step tutorial and examples
-- 📖 **[Complete Documentation](./docs/README-en.md)** - API reference, use cases, advanced features
-- 📋 **[API Reference](./docs/API-en.md)** - All methods, types, migration guide
-- ⚡ **[Performance Optimization Guide](./docs/best-practices-en.md)** - Best practices for optimal performance
-- 🏠 **[GitHub](https://github.com/ehfuse/forma)**
+-   🚀 **[Getting Started Guide](./docs/getting-started-en.md)** - Step-by-step tutorial and examples
+-   📖 **[Complete Documentation](./docs/README-en.md)** - API reference, use cases, advanced features
+-   📋 **[API Reference](./docs/API-en.md)** - All methods, types, migration guide
+-   ⚡ **[Performance Optimization Guide](./docs/best-practices-en.md)** - Best practices for optimal performance
+-   🏠 **[GitHub](https://github.com/ehfuse/forma)**
 
 Forma는 React 애플리케이션에서 폼 상태를 효율적으로 관리하기 위한 고성능 라이브러리입니다. 개별 필드 구독을 통한 선택적 리렌더링과 글로벌 폼 상태 공유 기능을 제공합니다.
 
@@ -29,13 +29,14 @@ _Forma is a high-performance library for efficiently managing form state in Reac
 
 ## 🚀 주요 특징 | Key Features
 
-- ✅ **개별 필드 구독** | **Individual Field Subscription**: 필드별 선택적 리렌더링으로 최적화된 성능
-- ✅ **Dot Notation 최적화** | **Dot Notation Optimization**: `user.profile.name` 형태의 중첩 객체 접근
-- ✅ **MUI 완전 호환** | **Full MUI Compatibility**: Material-UI 컴포넌트와 완벽한 통합
-- ✅ **글로벌 폼 상태** | **Global Form State**: 여러 컴포넌트 간 폼 상태 공유
-- ✅ **폼 등록 시스템** | **Form Registration System**: 기존 폼을 글로벌로 등록 가능
-- ✅ **TypeScript 완전 지원** | **Full TypeScript Support**: 강력한 타입 안전성
-- ✅ **React 19 최적화** | **React 19 Optimized**: 최신 React 기능 활용
+-   ✅ **개별 필드 구독** | **Individual Field Subscription**: 필드별 선택적 리렌더링으로 최적화된 성능
+-   ✅ **범용 상태 관리** | **General State Management**: `useFormaState`로 폼 외 일반 상태도 효율적 관리
+-   ✅ **Dot Notation 최적화** | **Dot Notation Optimization**: `user.profile.name` 형태의 중첩 객체 접근
+-   ✅ **MUI 완전 호환** | **Full MUI Compatibility**: Material-UI 컴포넌트와 완벽한 통합
+-   ✅ **글로벌 폼 상태** | **Global Form State**: 여러 컴포넌트 간 폼 상태 공유
+-   ✅ **폼 등록 시스템** | **Form Registration System**: 기존 폼을 글로벌로 등록 가능
+-   ✅ **TypeScript 완전 지원** | **Full TypeScript Support**: 강력한 타입 안전성
+-   ✅ **React 19 최적화** | **React 19 Optimized**: 최신 React 기능 활용
 
 ## 📦 설치 | Installation
 
@@ -49,6 +50,8 @@ yarn add @ehfuse/forma
 
 ## 🎯 빠른 시작 | Quick Start
 
+### 폼 상태 관리 | Form State Management
+
 ```tsx
 import { useForm } from "@ehfuse/forma";
 
@@ -78,19 +81,64 @@ function MyForm() {
 }
 ```
 
+### 일반 상태 관리 | General State Management
+
+```tsx
+import { useFormaState } from "@ehfuse/forma";
+
+function UserDashboard() {
+    const state = useFormaState({
+        todos: [
+            { id: 1, text: "Learn React", completed: false },
+            { id: 2, text: "Build app", completed: false },
+        ],
+        filter: "all",
+    });
+
+    // 개별 필드 구독 - 해당 필드가 변경될 때만 리렌더링
+    const filter = state.useValue("filter");
+
+    // ✅ 배열 길이만 구독 (항목 추가/삭제 시에만 리렌더링)
+    const todosLength = state.useValue("todos.length");
+
+    // ✅ 특정 할 일의 텍스트만 구독 (dot notation 활용)
+    const firstTodoText = state.useValue("todos.0.text");
+
+    const addTodo = () => {
+        const todos = state.getValues().todos;
+        state.setValue("todos", [
+            ...todos,
+            { id: Date.now(), text: "New todo", completed: false },
+        ]);
+    };
+
+    return (
+        <div>
+            <p>필터: {filter}</p>
+            <p>첫 번째 할 일: {firstTodoText}</p>
+            <p>총 개수: {todosLength}</p>
+            <button onClick={addTodo}>할 일 추가</button>
+            <button onClick={() => state.setValue("filter", "completed")}>
+                완료된 항목 보기
+            </button>
+        </div>
+    );
+}
+```
+
 ## � 문서 | Documentation
 
 ### 한국어 | Korean
 
-- 📖 **[완전한 문서](./docs/README-ko.md)** - API 레퍼런스, 사용 사례, 고급 기능
-- 🌐 **[useGlobalForm 사용법](./docs/useGlobalForm-guide-ko.md)** - 글로벌 폼 상태 관리 가이드
-- ⚡ **[성능 최적화 가이드](./docs/best-practices-ko.md)** - 최고 성능을 위한 모범 사례
+-   📖 **[완전한 문서](./docs/README-ko.md)** - API 레퍼런스, 사용 사례, 고급 기능
+-   🌐 **[useGlobalForm 사용법](./docs/useGlobalForm-guide-ko.md)** - 글로벌 폼 상태 관리 가이드
+-   ⚡ **[성능 최적화 가이드](./docs/best-practices-ko.md)** - 최고 성능을 위한 모범 사례
 
 ### English
 
-- 📖 **[Complete Documentation](./docs/README-en.md)** - API reference, use cases, advanced features
-- 🌐 **[useGlobalForm Usage Guide](./docs/useGlobalForm-guide-en.md)** - Global form state management guide
-- ⚡ **[Performance Optimization Guide](./docs/best-practices-en.md)** - Best practices for optimal performance
+-   📖 **[Complete Documentation](./docs/README-en.md)** - API reference, use cases, advanced features
+-   🌐 **[useGlobalForm Usage Guide](./docs/useGlobalForm-guide-en.md)** - Global form state management guide
+-   ⚡ **[Performance Optimization Guide](./docs/best-practices-en.md)** - Best practices for optimal performance
 
 ## 🎯 When to choose Forma?
 
@@ -107,52 +155,52 @@ Forma는 **폼 상태 관리에 특화**된 라이브러리로 특정 시나리
 **🎨 MUI (Material-UI) Projects**
 **MUI (Material-UI) 프로젝트**
 
-- Seamless integration with MUI components
-  MUI 컴포넌트와 완벽한 통합
-- No additional wrapper components needed
-  추가 래퍼 컴포넌트 불필요
-- Built-in support for MUI's controlled component patterns
-  MUI의 제어 컴포넌트 패턴 내장 지원
+-   Seamless integration with MUI components
+    MUI 컴포넌트와 완벽한 통합
+-   No additional wrapper components needed
+    추가 래퍼 컴포넌트 불필요
+-   Built-in support for MUI's controlled component patterns
+    MUI의 제어 컴포넌트 패턴 내장 지원
 
 **⚡ Performance-Critical Forms**
 **성능이 중요한 폼**
 
-- Large forms with many fields (50+ inputs)
-  많은 필드가 있는 대규모 폼 (50개 이상 입력)
-- Real-time data visualization forms
-  실시간 데이터 시각화 폼
-- Forms that update frequently during user interaction
-  사용자 상호작용 중 자주 업데이트되는 폼
+-   Large forms with many fields (50+ inputs)
+    많은 필드가 있는 대규모 폼 (50개 이상 입력)
+-   Real-time data visualization forms
+    실시간 데이터 시각화 폼
+-   Forms that update frequently during user interaction
+    사용자 상호작용 중 자주 업데이트되는 폼
 
 **🔄 Multi-Step & Global Forms**
 **멀티 스텝 & 글로벌 폼**
 
-- Wizard-style multi-step forms
-  마법사 스타일의 멀티 스텝 폼
-- Forms shared across multiple components
-  여러 컴포넌트에서 공유되는 폼
-- Registration flows with data persistence
-  데이터 지속성이 있는 등록 플로우
+-   Wizard-style multi-step forms
+    마법사 스타일의 멀티 스텝 폼
+-   Forms shared across multiple components
+    여러 컴포넌트에서 공유되는 폼
+-   Registration flows with data persistence
+    데이터 지속성이 있는 등록 플로우
 
 **🏗️ Complex Nested Data**
 **복잡한 중첩 데이터**
 
-- User profiles with nested address/contact info
-  중첩된 주소/연락처 정보가 있는 사용자 프로필
-- Product configurations with multiple layers
-  다층 구조의 제품 구성
-- Settings panels with grouped options
-  그룹화된 옵션이 있는 설정 패널
+-   User profiles with nested address/contact info
+    중첩된 주소/연락처 정보가 있는 사용자 프로필
+-   Product configurations with multiple layers
+    다층 구조의 제품 구성
+-   Settings panels with grouped options
+    그룹화된 옵션이 있는 설정 패널
 
 **📊 Dynamic Form Generation**
 **동적 폼 생성**
 
-- Forms generated from API schemas
-  API 스키마에서 생성되는 폼
-- Conditional field rendering
-  조건부 필드 렌더링
-- Dynamic validation rules
-  동적 검증 규칙
+-   Forms generated from API schemas
+    API 스키마에서 생성되는 폼
+-   Conditional field rendering
+    조건부 필드 렌더링
+-   Dynamic validation rules
+    동적 검증 규칙
 
 ## 🎯 핵심 성능 원칙 | Core Performance Principles
 
@@ -168,15 +216,15 @@ const userEmail = form.useFormValue("user.email");
 
 ## 🌐 링크 | Links
 
-- **📦 NPM**: [https://www.npmjs.com/package/@ehfuse/forma](https://www.npmjs.com/package/@ehfuse/forma)
-- **🐙 GitHub**: [https://github.com/ehfuse/forma](https://github.com/ehfuse/forma)
-- **📄 라이선스 | License**: [MIT](./LICENSE)
+-   **📦 NPM**: [https://www.npmjs.com/package/@ehfuse/forma](https://www.npmjs.com/package/@ehfuse/forma)
+-   **🐙 GitHub**: [https://github.com/ehfuse/forma](https://github.com/ehfuse/forma)
+-   **📄 라이선스 | License**: [MIT](./LICENSE)
 
 ## 📞 연락처 | Contact
 
-- **개발자 | Developer**: 김영진 (KIM YOUNG JIN)
-- **이메일 | Email**: ehfuse@gmail.com
-- **GitHub**: [@ehfuse](https://github.com/ehfuse)
+-   **개발자 | Developer**: 김영진 (KIM YOUNG JIN)
+-   **이메일 | Email**: ehfuse@gmail.com
+-   **GitHub**: [@ehfuse](https://github.com/ehfuse)
 
 ---
 

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

@@ -27,7 +27,6 @@
  * 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";
 /**
@@ -50,7 +49,7 @@ export declare function useForm<T extends Record<string, any>>({ initialValues,
     isSubmitting: boolean;
     isValidating: boolean;
     isModified: boolean;
-    useFormValue: (fieldName: string) => unknown;
+    useFormValue: (fieldName: string) => any;
     getFormValue: (fieldName: string) => any;
     getFormValues: () => T;
     setFormValue: (name: string, value: any) => void;
@@ -61,7 +60,6 @@ export declare function useForm<T extends Record<string, any>>({ initialValues,
     submit: (e?: React.FormEvent) => Promise<boolean>;
     resetForm: () => void;
     validateForm: (valuesToValidate?: T) => Promise<boolean>;
-    values: T;
-    _store: FieldStore<T>;
+    _store: import("..").FieldStore<T>;
 };
 //# sourceMappingURL=useForm.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../../hooks/useForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EACH,eAAe,EACf,uBAAuB,EACvB,YAAY,EACf,MAAM,eAAe,CAAC;AAGvB,OAAO,KAMN,MAAM,OAAO,CAAC;AAKf;;;;;;;;;;;;;;;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;;;;8BA8IE,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;;EA2GlC"}

package/dist/esm/hooks/useForm.js

@@ -27,25 +27,8 @@
  * 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;
-}
+import { useFormaState } from "./useFormaState";
+import { useEffect, useState, useCallback, useMemo, } from "react";
 /**
  * Forma 핵심 폼 관리 훅 / Forma core form management hook
  *
@@ -63,38 +46,22 @@ function useFieldValue(store, fieldName) {
  * @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;
+    // useFormaState를 기반으로 사용 / Use useFormaState as foundation
+    const fieldState = useFormaState(initialValues, { _externalStore });
+    // 폼 특정 상태 관리 / Form-specific state management
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [isValidating, setIsValidating] = useState(false);
+    // 폼이 수정되었는지 확인 / Check if form is modified
+    // Store의 변경 사항을 추적하여 효율적으로 감지
     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());
+        const unsubscribe = fieldState._store.subscribeGlobal(() => {
+            setIsModified(fieldState._store.isModified());
         });
+        // 초기 상태 설정
+        setIsModified(fieldState._store.isModified());
         return unsubscribe;
-    }, [store]);
-    const values = valuesSnapshot;
+    }, [fieldState._store]);
     /**
      * 통합 폼 변경 핸들러 / Unified form change handler
      * MUI Select, TextField, DatePicker 등 모든 컴포넌트 지원
@@ -122,8 +89,8 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         else if (value === null) {
             newValue = undefined;
         }
-        store.setValue(name, newValue);
-    }, [store]);
+        fieldState.setValue(name, newValue);
+    }, [fieldState.setValue]);
     /**
      * DatePicker 전용 변경 핸들러 / DatePicker-specific change handler
      * 간편한 사용을 위한 커링 함수 / Curried function for convenient usage
@@ -138,9 +105,9 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
             else if (value === null) {
                 newValue = undefined;
             }
-            store.setValue(fieldName, newValue);
+            fieldState.setValue(fieldName, newValue);
         };
-    }, [store]);
+    }, [fieldState.setValue]);
     /**
      * 개별 필드 값 설정 / Set individual field value
      */
@@ -153,40 +120,40 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         else if (value === null) {
             processedValue = undefined;
         }
-        store.setValue(name, processedValue);
-    }, [store]);
+        fieldState.setValue(name, processedValue);
+    }, [fieldState.setValue]);
     /**
      * 전체 폼 값 설정 / Set all form values
      */
     const setFormValues = useCallback((newValues) => {
-        store.setValues(newValues);
-    }, [store]);
+        fieldState.setValues(newValues);
+    }, [fieldState.setValues]);
     /**
      * 초기값 재설정 / Reset initial values
      */
     const setInitialFormValues = useCallback((newInitialValues) => {
-        store.setInitialValues(newInitialValues);
-    }, [store]);
+        fieldState._store.setInitialValues(newInitialValues);
+    }, [fieldState._store]);
     /**
      * 구독 없이 현재 값만 가져오기 / Get current value without subscription
      */
     const getFormValue = useCallback((fieldName) => {
-        return store.getValue(fieldName);
-    }, [store]);
+        return fieldState._store.getValue(fieldName);
+    }, [fieldState._store]);
     /**
      * 모든 폼 값 가져오기 / Get all form values
      */
     const getFormValues = useCallback(() => {
-        return store.getValues();
-    }, [store]);
+        return fieldState.getValues();
+    }, [fieldState.getValues]);
     /**
      * 개별 필드 구독 Hook / Individual field subscription hook
      * 해당 필드가 변경될 때만 컴포넌트가 리렌더링됩니다
      * Component re-renders only when the specific field changes
      */
     const useFormValue = useCallback((fieldName) => {
-        return useFieldValue(store, fieldName);
-    }, [store]);
+        return fieldState.useValue(fieldName);
+    }, [fieldState.useValue]);
     /**
      * 폼 검증 / Form validation
      */
@@ -194,7 +161,7 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         if (!onValidate)
             return true;
         setIsValidating(true);
-        const currentValues = valuesToValidate || store.getValues();
+        const currentValues = valuesToValidate || fieldState.getValues();
         try {
             return await onValidate(currentValues);
         }
@@ -205,22 +172,22 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         finally {
             setIsValidating(false);
         }
-    }, [onValidate, store]);
+    }, [onValidate, fieldState.getValues]);
     /**
      * 폼 초기화 / Reset form
      */
     const resetForm = useCallback(() => {
-        store.reset();
+        fieldState.reset();
         setIsSubmitting(false);
         setIsValidating(false);
-    }, [store]);
+    }, [fieldState.reset]);
     /**
      * 폼 제출 / Submit form
      */
     const submit = useCallback(async (e) => {
         if (e)
             e.preventDefault();
-        const currentValues = store.getValues();
+        const currentValues = fieldState.getValues();
         if (!(await validateForm(currentValues))) {
             return false;
         }
@@ -241,7 +208,7 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         finally {
             setIsSubmitting(false);
         }
-    }, [onSubmit, onComplete, validateForm, store]);
+    }, [onSubmit, onComplete, validateForm, fieldState.getValues]);
     return useMemo(() => ({
         // 상태 / State
         isSubmitting,
@@ -262,10 +229,8 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         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
+        _store: fieldState._store, // 직접 store 접근용 / direct store access
     }), [
         isSubmitting,
         isValidating,
@@ -281,7 +246,7 @@ export function useForm({ initialValues, onSubmit, onValidate, onComplete, _exte
         submit,
         resetForm,
         validateForm,
-        values,
+        fieldState._store, // Store 의존성으로 대체
     ]);
 }
 //# sourceMappingURL=useForm.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * useFormaState.ts
+ *
+ * Advanced state management hook with individual field subscriptions
+ * Optimized for arrays, objects, and complex nested data structures
+ *
+ * @author KIM YOUNG JIN (ehfuse@gmail.com)
+ * @license MIT License
+ */
+import { FieldStore } from "../core/FieldStore";
+/**
+ * Options for configuring useFormaState hook
+ * useFormaState 훅 설정을 위한 옵션
+ */
+export interface UseFormaStateOptions<T extends Record<string, any>> {
+    /** Optional callback when state changes | 상태 변경 시 선택적 콜백 */
+    onChange?: (values: T) => void;
+    /** Enable deep equality checking for better performance | 성능 향상을 위한 깊은 동등성 검사 활성화 */
+    deepEquals?: boolean;
+    /** External FieldStore instance for shared state | 공유 상태를 위한 외부 FieldStore 인스턴스 */
+    _externalStore?: FieldStore<T>;
+}
+/**
+ * Return type of useFormaState hook
+ * useFormaState 훅의 반환 타입
+ */
+export interface UseFormaStateReturn<T extends Record<string, any>> {
+    /** Subscribe to a specific field value with dot notation | dot notation으로 특정 필드 값 구독 */
+    useValue: <K extends string>(path: K) => any;
+    /** Set a specific field value with dot notation | dot notation으로 특정 필드 값 설정 */
+    setValue: <K extends string>(path: K, value: any) => void;
+    /** Get all current values (non-reactive) | 모든 현재 값 가져오기 (반응형 아님) */
+    getValues: () => T;
+    /** Set all values at once | 모든 값을 한 번에 설정 */
+    setValues: (values: Partial<T>) => void;
+    /** Reset to initial values | 초기값으로 재설정 */
+    reset: () => void;
+    /** Handle standard input change events | 표준 입력 변경 이벤트 처리 */
+    handleChange: (event: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => void;
+    /** Direct access to the internal store for advanced usage | 고급 사용을 위한 내부 스토어 직접 접근 */
+    _store: FieldStore<T>;
+    /** Current values (reactive) | 현재 값들 (반응형) */
+    values: T;
+}
+/**
+ * Advanced state management hook with individual field subscriptions
+ * 개별 필드 구독을 통한 고급 상태 관리 훅
+ *
+ * Optimized for managing complex arrays, objects, and nested data structures
+ * where you want to avoid unnecessary re-renders when only specific fields change.
+ *
+ * 복잡한 배열, 객체, 중첩된 데이터 구조를 관리하는 데 최적화되어 있으며,
+ * 특정 필드만 변경될 때 불필요한 재렌더링을 방지하고자 할 때 사용합니다.
+ *
+ * @example
+ * ```typescript
+ * // Managing an array of users
+ * const state = useFormaState({
+ *   initialValues: {
+ *     users: [
+ *       { name: 'John', email: 'john@example.com', age: 30 },
+ *       { name: 'Jane', email: 'jane@example.com', age: 25 }
+ *     ],
+ *     settings: { theme: 'dark', notifications: true }
+ *   }
+ * });
+ *
+ * // Subscribe to individual fields - only these components re-render when changed
+ * const firstName = state.useValue('users.0.name');  // Only re-renders when John's name changes
+ * const userAge = state.useValue('users.1.age');     // Only re-renders when Jane's age changes
+ * const theme = state.useValue('settings.theme');    // Only re-renders when theme changes
+ *
+ * // Update specific fields
+ * state.setValue('users.0.name', 'Johnny');
+ * state.setValue('settings.theme', 'light');
+ * ```
+ */
+export declare function useFormaState<T extends Record<string, any>>(initialValues: T, options?: UseFormaStateOptions<T>): UseFormaStateReturn<T>;
+//# sourceMappingURL=useFormaState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormaState.d.ts","sourceRoot":"","sources":["../../../hooks/useFormaState.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC/D,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAE/B,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,mFAAmF;IACnF,cAAc,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC9D,wFAAwF;IACxF,QAAQ,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC;IAE7C,+EAA+E;IAC/E,QAAQ,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAE1D,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC,CAAC;IAEnB,6CAA6C;IAC7C,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAExC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,4DAA4D;IAC5D,YAAY,EAAE,CACV,KAAK,EAAE,KAAK,CAAC,WAAW,CACpB,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,CAC7D,KACA,IAAI,CAAC;IAEV,sFAAsF;IACtF,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAEtB,8CAA8C;IAC9C,MAAM,EAAE,CAAC,CAAC;CACb;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvD,aAAa,EAAE,CAAC,EAChB,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACtC,mBAAmB,CAAC,CAAC,CAAC,CA2HxB"}