@ehfuse/forma 1.0.4 → 1.1.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**: `useFieldState`로 폼 외 일반 상태도 효율적 관리
+-   ✅ **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 { useFieldState } from "@ehfuse/forma";
+
+function TodoApp() {
+    const state = useFieldState({
+        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/useFieldState.d.ts

@@ -0,0 +1,79 @@
+/**
+ * useFieldState.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 useFieldState hook
+ * useFieldState 훅 설정을 위한 옵션
+ */
+export interface UseFieldStateOptions<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 useFieldState hook
+ * useFieldState 훅의 반환 타입
+ */
+export interface UseFieldStateReturn<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 = useFieldState({
+ *   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 useFieldState<T extends Record<string, any>>(initialValues: T, options?: UseFieldStateOptions<T>): UseFieldStateReturn<T>;
+//# sourceMappingURL=useFieldState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldState.d.ts","sourceRoot":"","sources":["../../../hooks/useFieldState.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"}

package/dist/esm/hooks/useFieldState.js

@@ -0,0 +1,154 @@
+/**
+ * useFieldState.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 { useRef, useCallback, useMemo, useState, useEffect } from "react";
+import { FieldStore } from "../core/FieldStore";
+import { setNestedValue } from "../utils/dotNotation";
+/**
+ * Individual field subscription for useFieldState
+ * 개별 필드 구독을 위한 내부 함수
+ */
+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;
+}
+/**
+ * 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 = useFieldState({
+ *   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 function useFieldState(initialValues, options = {}) {
+    const { onChange, deepEquals = false, _externalStore } = options;
+    // Create or use external field store instance (persists across renders)
+    // 필드 스토어 인스턴스 생성 또는 외부 스토어 사용 (렌더링 간 유지)
+    const storeRef = useRef(null);
+    if (_externalStore) {
+        storeRef.current = _externalStore;
+    }
+    else if (!storeRef.current) {
+        storeRef.current = new FieldStore(initialValues);
+        // Set up global change listener if provided
+        // 글로벌 변경 리스너 설정 (제공된 경우)
+        if (onChange) {
+            storeRef.current.subscribeGlobal(() => {
+                onChange(storeRef.current.getValues());
+            });
+        }
+    }
+    const store = storeRef.current;
+    // Update initial values when they change (only for non-external stores)
+    // 초기값이 변경되면 업데이트 (외부 스토어가 아닌 경우에만)
+    useEffect(() => {
+        if (!_externalStore && store) {
+            store.setInitialValues(initialValues);
+        }
+    }, [initialValues, store, _externalStore]);
+    // Subscribe to a specific field value with dot notation
+    // dot notation으로 특정 필드 값 구독
+    const useValue = useCallback((path) => {
+        return useFieldValue(store, path);
+    }, [store]);
+    // Set a specific field value with dot notation
+    // dot notation으로 특정 필드 값 설정
+    const setValue = useCallback((path, value) => {
+        const currentValues = store.getValues();
+        const newValues = setNestedValue(currentValues, path, value);
+        store.setValues(newValues);
+    }, [store]);
+    // Get all current values (non-reactive)
+    // 모든 현재 값 가져오기 (반응형 아님)
+    const getValues = useCallback(() => {
+        return store.getValues();
+    }, [store]);
+    // Set all values at once
+    // 모든 값을 한 번에 설정
+    const setValues = useCallback((values) => {
+        const currentValues = store.getValues();
+        const newValues = { ...currentValues, ...values };
+        store.setValues(newValues);
+    }, [store]);
+    // Reset to initial values
+    // 초기값으로 재설정
+    const reset = useCallback(() => {
+        store.setValues(initialValues);
+    }, [store, initialValues]);
+    // Handle standard input change events
+    // 표준 입력 변경 이벤트 처리
+    const handleChange = useCallback((event) => {
+        const { name, value, type } = event.target;
+        if (!name) {
+            console.warn('useFieldState.handleChange: input element must have a "name" attribute');
+            return;
+        }
+        let processedValue = value;
+        // Handle different input types
+        // 다양한 입력 타입 처리
+        if (type === "checkbox") {
+            processedValue = event.target.checked;
+        }
+        else if (type === "number") {
+            processedValue = value === "" ? "" : Number(value);
+        }
+        setValue(name, processedValue);
+    }, [setValue]);
+    // Get reactive values using the store's reactive mechanism
+    // 스토어의 반응형 메커니즘을 사용하여 반응형 값 가져오기
+    const values = useMemo(() => {
+        // This creates a reactive subscription to all values
+        // 모든 값에 대한 반응형 구독 생성
+        return store.getValues();
+    }, [store]);
+    return {
+        useValue,
+        setValue,
+        getValues,
+        setValues,
+        reset,
+        handleChange,
+        _store: store,
+        values,
+    };
+}
+//# sourceMappingURL=useFieldState.js.map

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

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

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

@@ -50,7 +50,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;

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,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,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;;;;8BAuIE,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"}