@ehfuse/forma 1.0.0

package/LICENSE

@@ -0,0 +1,42 @@
+MIT License
+
+Copyright (c) 2025 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.
+
+---
+
+MIT 라이선스
+
+Copyright (c) 2025 김영진 (ehfuse@gmail.com)
+
+이 소프트웨어와 관련 문서 파일(이하 "소프트웨어")의 사본을 얻는 모든 사람에게 
+무료로 허가를 부여합니다. 이 허가에는 소프트웨어를 제한 없이 다루는 권리가 
+포함되며, 여기에는 사용, 복사, 수정, 병합, 게시, 배포, 서브라이선스 및/또는 
+소프트웨어 사본의 판매 권리와 소프트웨어가 제공된 사람들에게 그렇게 할 수 있는 
+권한을 부여하는 권리가 포함됩니다. 단, 다음 조건을 따라야 합니다:
+
+위의 저작권 고지와 이 허가 고지는 소프트웨어의 모든 사본 또는 상당 부분에 
+포함되어야 합니다.
+
+소프트웨어는 "있는 그대로" 제공되며, 상품성, 특정 목적에의 적합성 및 
+비침해에 대한 보증을 포함하되 이에 국한되지 않는 명시적 또는 묵시적 보증 없이 
+제공됩니다. 어떠한 경우에도 작성자 또는 저작권 보유자는 계약, 불법 행위 또는 
+기타 행위에서 발생하거나, 소프트웨어나 소프트웨어의 사용 또는 기타 거래와 
+관련하여 발생하는 청구, 손해 또는 기타 책임에 대해 책임지지 않습니다.

package/README.md

@@ -0,0 +1,180 @@
+<!-- slide -->
+
+# Forma
+
+**고급 React 폼 상태 관리 라이브러리** | \*\*Advanced R## 📚 문서 | Documentation
+
+### 한국어 | 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)**
+
+### 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)**
+
+Forma는 React 애플리케이션에서 폼 상태를 효율적으로 관리하기 위한 고성능 라이브러리입니다. 개별 필드 구독을 통한 선택적 리렌더링과 글로벌 폼 상태 공유 기능을 제공합니다.
+
+_Forma is a high-performance library for efficiently managing form state in React applications. It provides selective re-rendering through individual field subscriptions and global form state sharing capabilities._
+
+## 🚀 주요 특징 | 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 기능 활용
+
+## 📦 설치 | Installation
+
+```bash
+npm install @ehfuse/forma
+```
+
+```bash
+yarn add @ehfuse/forma
+```
+
+## 🎯 빠른 시작 | Quick Start
+
+```tsx
+import { useForm } from "@ehfuse/forma";
+
+function MyForm() {
+    const form = useForm({
+        initialValues: { name: "", email: "" },
+        onSubmit: async (values) => {
+            console.log("제출 | Submit:", values);
+        },
+    });
+
+    return (
+        <form onSubmit={form.submit}>
+            <input
+                name="name"
+                value={form.useFormValue("name")}
+                onChange={form.handleFormChange}
+            />
+            <input
+                name="email"
+                value={form.useFormValue("email")}
+                onChange={form.handleFormChange}
+            />
+            <button type="submit">제출 | Submit</button>
+        </form>
+    );
+}
+```
+
+## � 문서 | Documentation
+
+### 한국어 | Korean
+
+- 📖 **[완전한 문서](./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
+
+## 🎯 When to choose Forma?
+
+언제 Forma를 선택해야 할까요?
+
+Forma is **specialized for form state management** and shines in specific scenarios. Here's when Forma is the perfect choice for your project.
+
+Forma는 **폼 상태 관리에 특화**된 라이브러리로 특정 시나리오에서 빛을 발합니다. 다음은 Forma가 프로젝트에 완벽한 선택이 되는 경우입니다.
+
+### ✨ Perfect for these use cases:
+
+이런 경우에 완벽합니다:
+
+**🎨 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의 제어 컴포넌트 패턴 내장 지원
+
+**⚡ Performance-Critical Forms**
+**성능이 중요한 폼**
+
+- 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
+  데이터 지속성이 있는 등록 플로우
+
+**🏗️ Complex Nested Data**
+**복잡한 중첩 데이터**
+
+- 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
+  동적 검증 규칙
+
+## 🎯 핵심 성능 원칙 | Core Performance Principles
+
+```tsx
+// ✅ 효율적 | Efficient: 개별 필드 구독 | Individual field subscription
+const userName = form.useFormValue("user.name");
+const userEmail = form.useFormValue("user.email");
+
+// user.name 변경 시 → userName 필드만 리렌더링 | Only userName field re-renders
+```
+
+**[성능 최적화 상세 가이드 보기 | View Detailed Performance Guide](./docs/best-practices-ko.md)**
+
+## 🌐 링크 | 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)
+
+## 📞 연락처 | Contact
+
+- **개발자 | Developer**: 김영진 (KIM YOUNG JIN)
+- **이메일 | Email**: ehfuse@gmail.com
+- **GitHub**: [@ehfuse](https://github.com/ehfuse)
+
+---
+
+Copyright (c) 2025 김영진 (KIM YOUNG JIN) - MIT License

package/dist/contexts/GlobalFormContext.d.ts

@@ -0,0 +1,66 @@
+/**
+ * GlobalFormContext.tsx
+ *
+ * Forma - 글로벌 폼 상태 관리 컨텍스트 | Global form state management context
+ * 여러 컴포넌트 간 폼 상태 공유를 위한 React Context | React Context 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 { ReactNode } from "react";
+import { GlobalFormContextType } from "../types/globalForm";
+/**
+ * 글로벌 폼 상태 관리를 위한 React Context | React Context for global form state management
+ */
+export declare const GlobalFormContext: import("react").Context<GlobalFormContextType>;
+/**
+ * 글로벌 폼 상태 관리 Provider | Global form state management provider
+ *
+ * 애플리케이션 최상단에 배치하여 전역 폼 상태 관리를 활성화합니다. | Place at the top of your application to enable global form state management.
+ * 각 formId별로 독립적인 FieldStore 인스턴스를 관리합니다. | Manages independent FieldStore instances for each formId.
+ *
+ * @param props Provider props
+ * @returns 글로벌 폼 컨텍스트 Provider
+ *
+ * @example
+ * ```typescript
+ * // App.tsx
+ * import { GlobalFormProvider } from '@/forma';
+ *
+ * function App() {
+ *   return (
+ *     <GlobalFormProvider>
+ *       <Router>
+ *         <Routes>
+ *           <Route path="/" element={<HomePage />} />
+ *           <Route path="/customer" element={<CustomerPage />} />
+ *         </Routes>
+ *       </Router>
+ *     </GlobalFormProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function GlobalFormProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=GlobalFormContext.d.ts.map

package/dist/contexts/GlobalFormContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalFormContext.d.ts","sourceRoot":"","sources":["../../contexts/GlobalFormContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAyB,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,iBAAiB,gDAW5B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAiDvE"}

package/dist/contexts/GlobalFormContext.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalFormContext = void 0;
+exports.GlobalFormProvider = GlobalFormProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * GlobalFormContext.tsx
+ *
+ * Forma - 글로벌 폼 상태 관리 컨텍스트 | Global form state management context
+ * 여러 컴포넌트 간 폼 상태 공유를 위한 React Context | React Context 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.
+ */
+const react_1 = require("react");
+const FieldStore_1 = require("../core/FieldStore");
+/**
+ * 글로벌 폼 상태 관리를 위한 React Context | React Context for global form state management
+ */
+exports.GlobalFormContext = (0, react_1.createContext)({
+    getOrCreateStore: () => {
+        throw new Error("GlobalFormContext must be used within GlobalFormProvider");
+    },
+    registerStore: () => {
+        throw new Error("GlobalFormContext must be used within GlobalFormProvider");
+    },
+});
+/**
+ * 글로벌 폼 상태 관리 Provider | Global form state management provider
+ *
+ * 애플리케이션 최상단에 배치하여 전역 폼 상태 관리를 활성화합니다. | Place at the top of your application to enable global form state management.
+ * 각 formId별로 독립적인 FieldStore 인스턴스를 관리합니다. | Manages independent FieldStore instances for each formId.
+ *
+ * @param props Provider props
+ * @returns 글로벌 폼 컨텍스트 Provider
+ *
+ * @example
+ * ```typescript
+ * // App.tsx
+ * import { GlobalFormProvider } from '@/forma';
+ *
+ * function App() {
+ *   return (
+ *     <GlobalFormProvider>
+ *       <Router>
+ *         <Routes>
+ *           <Route path="/" element={<HomePage />} />
+ *           <Route path="/customer" element={<CustomerPage />} />
+ *         </Routes>
+ *       </Router>
+ *     </GlobalFormProvider>
+ *   );
+ * }
+ * ```
+ */
+function GlobalFormProvider({ children }) {
+    // formId별 FieldStore 인스턴스들을 관리하는 Map | Map managing FieldStore instances by formId
+    const storesRef = (0, react_1.useRef)(new Map());
+    /**
+     * formId에 해당하는 FieldStore를 가져오거나 새로 생성합니다. | Get or create FieldStore for the given formId.
+     *
+     * @param formId 폼 식별자 | Form identifier
+     * @returns FieldStore 인스턴스 | FieldStore instance
+     */
+    const getOrCreateStore = (formId) => {
+        const stores = storesRef.current;
+        if (!stores.has(formId)) {
+            // 새로운 스토어를 빈 객체로 생성 | Create new store with empty object
+            const newStore = new FieldStore_1.FieldStore({});
+            stores.set(formId, newStore);
+            return newStore;
+        }
+        return stores.get(formId);
+    };
+    /**
+     * 기존 FieldStore를 글로벌 폼에 등록합니다. | Register existing FieldStore to global form.
+     *
+     * @param formId 폼 식별자 | Form identifier
+     * @param store 등록할 FieldStore 인스턴스 | FieldStore instance to register
+     */
+    const registerStore = (formId, store) => {
+        const stores = storesRef.current;
+        stores.set(formId, store);
+    };
+    const contextValue = {
+        getOrCreateStore,
+        registerStore,
+    };
+    return ((0, jsx_runtime_1.jsx)(exports.GlobalFormContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=GlobalFormContext.js.map

package/dist/contexts/GlobalFormContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalFormContext.js","sourceRoot":"","sources":["../../contexts/GlobalFormContext.tsx"],"names":[],"mappings":";;;AA6EA,gDAiDC;;AA9HD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iCAAyD;AACzD,mDAAgD;AAGhD;;GAEG;AACU,QAAA,iBAAiB,GAAG,IAAA,qBAAa,EAAwB;IAClE,gBAAgB,EAAE,GAAG,EAAE;QACnB,MAAM,IAAI,KAAK,CACX,0DAA0D,CAC7D,CAAC;IACN,CAAC;IACD,aAAa,EAAE,GAAG,EAAE;QAChB,MAAM,IAAI,KAAK,CACX,0DAA0D,CAC7D,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAA2B;IACpE,mFAAmF;IACnF,MAAM,SAAS,GAAG,IAAA,cAAM,EAA+B,IAAI,GAAG,EAAE,CAAC,CAAC;IAElE;;;;;OAKG;IACH,MAAM,gBAAgB,GAAG,CACrB,MAAc,EACD,EAAE;QACf,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QAEjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,yDAAyD;YACzD,MAAM,QAAQ,GAAG,IAAI,uBAAU,CAAI,EAAO,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7B,OAAO,QAAQ,CAAC;QACpB,CAAC;QAED,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IAC/C,CAAC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,aAAa,GAAG,CAClB,MAAc,EACd,KAAoB,EAChB,EAAE;QACN,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,MAAM,YAAY,GAA0B;QACxC,gBAAgB;QAChB,aAAa;KAChB,CAAC;IAEF,OAAO,CACH,uBAAC,yBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC1C,QAAQ,GACgB,CAChC,CAAC;AACN,CAAC"}

package/dist/core/FieldStore.d.ts

@@ -0,0 +1,100 @@
+/**
+ * FieldStore.ts
+ *
+ * Forma - 개별 필드 상태 관리 핵심 클래스 / Core class for individual field state management
+ * 선택적 구독과 성능 최적화 지원 / Supports selective 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.
+ */
+/**
+ * 개별 필드 상태 관리 Store / Individual field state management store
+ * 선택적 구독과 성능 최적화를 위한 핵심 클래스
+ * Core class for selective subscriptions and performance optimization
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ */
+export declare class FieldStore<T extends Record<string, any>> {
+    private fields;
+    private dotNotationListeners;
+    private initialValues;
+    private globalListeners;
+    constructor(initialValues: T);
+    /**
+     * 특정 필드 값 가져오기 / Get specific field value
+     * Dot notation 지원 / Supports dot notation
+     * @param fieldName 필드명 또는 dot notation 경로 / Field name or dot notation path
+     * @returns 필드 값 / Field value
+     */
+    getValue(fieldName: keyof T | string): any;
+    /**
+     * 특정 필드 구독 / Subscribe to specific field
+     * Dot notation 지원 / Supports dot notation
+     * @param fieldName 필드명 또는 dot notation 경로 / Field name or dot notation path
+     * @param listener 변경 시 호출될 콜백 / Callback to call on change
+     * @returns 구독 해제 함수 / Unsubscribe function
+     */
+    subscribe(fieldName: keyof T | string, listener: () => void): () => void;
+    /**
+     * 전역 구독 / Global subscription
+     * isModified 등을 위해 사용 / Used for isModified etc.
+     * @param listener 변경 시 호출될 콜백 / Callback to call on change
+     * @returns 구독 해제 함수 / Unsubscribe function
+     */
+    subscribeGlobal(listener: () => void): () => void;
+    /**
+     * 필드 값 설정 / Set field value
+     * Dot notation 지원 / Supports dot notation
+     * @param fieldName 필드명 또는 dot notation 경로 / Field name or dot notation path
+     * @param value 설정할 값 / Value to set
+     */
+    setValue(fieldName: keyof T | string, value: any): void;
+    /**
+     * 모든 값 가져오기 / Get all values
+     * @returns 모든 필드 값을 포함한 객체 / Object containing all field values
+     */
+    getValues(): T;
+    /**
+     * 모든 값 설정 / Set all values
+     * @param newValues 설정할 값들 / Values to set
+     */
+    setValues(newValues: Partial<T>): void;
+    /**
+     * 초기값 재설정 / Reset initial values
+     * @param newInitialValues 새로운 초기값 / New initial values
+     */
+    setInitialValues(newInitialValues: T): void;
+    /**
+     * 수정 여부 확인 / Check if modified
+     * @returns 초기값에서 변경되었는지 여부 / Whether changed from initial values
+     */
+    isModified(): boolean;
+    /**
+     * 초기값으로 리셋 / Reset to initial values
+     */
+    reset(): void;
+    /**
+     * 리소스 정리 / Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=FieldStore.d.ts.map

package/dist/core/FieldStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldStore.d.ts","sourceRoot":"","sources":["../../core/FieldStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH;;;;;;GAMG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACjD,OAAO,CAAC,MAAM,CACA;IACd,OAAO,CAAC,oBAAoB,CAA2C;IACvE,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,eAAe,CAAyB;gBAEpC,aAAa,EAAE,CAAC;IAW5B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,GAAG;IAc1C;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI;IAuC3D;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI;IAOpC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG;IAkFhD;;;OAGG;IACH,SAAS,IAAI,CAAC;IAUd;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAM/B;;;OAGG;IACH,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;IAyBpC;;;OAGG;IACH,UAAU,IAAI,OAAO;IAOrB;;OAEG;IACH,KAAK;IAIL;;OAEG;IACH,OAAO;CAIV"}