@ehfuse/forma 1.0.0

package/dist/core/FieldStore.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldStore = void 0;
+const dotNotation_1 = require("../utils/dotNotation");
+/**
+ * 개별 필드 상태 관리 Store / Individual field state management store
+ * 선택적 구독과 성능 최적화를 위한 핵심 클래스
+ * Core class for selective subscriptions and performance optimization
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ */
+class FieldStore {
+    constructor(initialValues) {
+        this.fields = new Map();
+        this.dotNotationListeners = new Map(); // Dot notation 구독자 / Dot notation subscribers
+        this.globalListeners = new Set();
+        this.initialValues = { ...initialValues };
+        // 초기값으로 필드 초기화 / Initialize fields with initial values
+        Object.keys(initialValues).forEach((key) => {
+            this.fields.set(key, {
+                value: initialValues[key],
+                listeners: new Set(),
+            });
+        });
+    }
+    /**
+     * 특정 필드 값 가져오기 / Get specific field value
+     * Dot notation 지원 / Supports dot notation
+     * @param fieldName 필드명 또는 dot notation 경로 / Field name or dot notation path
+     * @returns 필드 값 / Field value
+     */
+    getValue(fieldName) {
+        const fieldNameStr = fieldName;
+        // dot notation이 포함된 경우 중첩 객체 접근 / Access nested object for dot notation
+        if (fieldNameStr.includes(".")) {
+            const values = this.getValues();
+            return (0, dotNotation_1.getNestedValue)(values, fieldNameStr);
+        }
+        // 일반 필드 접근 / Regular field access
+        const field = this.fields.get(fieldName);
+        return field?.value;
+    }
+    /**
+     * 특정 필드 구독 / 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, listener) {
+        const fieldNameStr = fieldName;
+        // dot notation이 포함된 경우 정확한 경로로 구독 / Subscribe to exact path for dot notation
+        if (fieldNameStr.includes(".")) {
+            let listeners = this.dotNotationListeners.get(fieldNameStr);
+            if (!listeners) {
+                listeners = new Set();
+                this.dotNotationListeners.set(fieldNameStr, listeners);
+            }
+            listeners.add(listener);
+            return () => {
+                const listeners = this.dotNotationListeners.get(fieldNameStr);
+                if (listeners) {
+                    listeners.delete(listener);
+                    if (listeners.size === 0) {
+                        this.dotNotationListeners.delete(fieldNameStr);
+                    }
+                }
+            };
+        }
+        // 일반 필드 구독 / Regular field subscription
+        let field = this.fields.get(fieldName);
+        if (!field) {
+            // 필드가 없으면 생성 / Create field if not exists
+            field = {
+                value: undefined,
+                listeners: new Set(),
+            };
+            this.fields.set(fieldName, field);
+        }
+        field.listeners.add(listener);
+        return () => {
+            field?.listeners.delete(listener);
+        };
+    }
+    /**
+     * 전역 구독 / Global subscription
+     * isModified 등을 위해 사용 / Used for isModified etc.
+     * @param listener 변경 시 호출될 콜백 / Callback to call on change
+     * @returns 구독 해제 함수 / Unsubscribe function
+     */
+    subscribeGlobal(listener) {
+        this.globalListeners.add(listener);
+        return () => {
+            this.globalListeners.delete(listener);
+        };
+    }
+    /**
+     * 필드 값 설정 / 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, value) {
+        const fieldNameStr = fieldName;
+        // dot notation이 포함된 경우 / For dot notation
+        if (fieldNameStr.includes(".")) {
+            const rootField = fieldNameStr.split(".")[0];
+            const rootFieldStr = String(rootField);
+            const remainingPath = fieldNameStr.substring(rootFieldStr.length + 1);
+            let field = this.fields.get(rootField);
+            if (!field) {
+                field = {
+                    value: {},
+                    listeners: new Set(),
+                };
+                this.fields.set(rootField, field);
+            }
+            const newRootValue = (0, dotNotation_1.setNestedValue)(field.value || {}, remainingPath, value);
+            if (JSON.stringify(field.value) !== JSON.stringify(newRootValue)) {
+                field.value = newRootValue;
+                // 루트 필드 구독자들 알림 / Notify root field subscribers
+                field.listeners.forEach((listener) => {
+                    listener();
+                });
+                // Dot notation 경로 구독자들 알림 / Notify dot notation path subscribers
+                this.dotNotationListeners.forEach((listeners, subscribedPath) => {
+                    if (subscribedPath === fieldNameStr) {
+                        listeners.forEach((listener) => listener());
+                    }
+                });
+                // 전역 구독자들 알림 / Notify global subscribers
+                this.globalListeners.forEach((listener) => listener());
+            }
+            return;
+        }
+        // 일반 필드 설정 / Regular field setting
+        let field = this.fields.get(fieldName);
+        if (!field) {
+            field = {
+                value: undefined,
+                listeners: new Set(),
+            };
+            this.fields.set(fieldName, field);
+        }
+        if (field.value !== value) {
+            field.value = value;
+            const fieldStr = fieldName;
+            // 해당 필드 구독자들 알림 / Notify field subscribers
+            field.listeners.forEach((listener) => {
+                listener();
+            });
+            // Dot notation 구독자들 알림 / Notify dot notation subscribers
+            this.dotNotationListeners.forEach((listeners, subscribedPath) => {
+                if (subscribedPath === fieldStr) {
+                    listeners.forEach((listener) => listener());
+                }
+            });
+            // 전역 구독자들 알림 / Notify global subscribers
+            if (this.globalListeners.size > 0) {
+                this.globalListeners.forEach((listener) => listener());
+            }
+        }
+    }
+    /**
+     * 모든 값 가져오기 / Get all values
+     * @returns 모든 필드 값을 포함한 객체 / Object containing all field values
+     */
+    getValues() {
+        const values = {};
+        this.fields.forEach((field, key) => {
+            // undefined 값을 null로 변환하여 API 전송 시 필드가 누락되지 않도록 함
+            // Convert undefined to null to prevent field omission during API transmission
+            values[key] = field.value === undefined ? null : field.value;
+        });
+        return values;
+    }
+    /**
+     * 모든 값 설정 / Set all values
+     * @param newValues 설정할 값들 / Values to set
+     */
+    setValues(newValues) {
+        Object.keys(newValues).forEach((key) => {
+            this.setValue(key, newValues[key]);
+        });
+    }
+    /**
+     * 초기값 재설정 / Reset initial values
+     * @param newInitialValues 새로운 초기값 / New initial values
+     */
+    setInitialValues(newInitialValues) {
+        this.initialValues = { ...newInitialValues };
+        // 기존 리스너를 보존하면서 값만 업데이트 / Update values while preserving existing listeners
+        Object.keys(newInitialValues).forEach((key) => {
+            const existingField = this.fields.get(key);
+            if (existingField) {
+                // 기존 필드가 있으면 값만 업데이트 / Update value only if field exists
+                existingField.value = newInitialValues[key];
+            }
+            else {
+                // 새 필드면 생성 / Create new field
+                this.fields.set(key, {
+                    value: newInitialValues[key],
+                    listeners: new Set(),
+                });
+            }
+        });
+        // 모든 리스너에게 알림 / Notify all listeners
+        this.fields.forEach((field) => {
+            field.listeners.forEach((listener) => listener());
+        });
+        this.globalListeners.forEach((listener) => listener());
+    }
+    /**
+     * 수정 여부 확인 / Check if modified
+     * @returns 초기값에서 변경되었는지 여부 / Whether changed from initial values
+     */
+    isModified() {
+        const currentValues = this.getValues();
+        return (JSON.stringify(currentValues) !== JSON.stringify(this.initialValues));
+    }
+    /**
+     * 초기값으로 리셋 / Reset to initial values
+     */
+    reset() {
+        this.setValues(this.initialValues);
+    }
+    /**
+     * 리소스 정리 / Clean up resources
+     */
+    destroy() {
+        this.fields.clear();
+        this.globalListeners.clear();
+    }
+}
+exports.FieldStore = FieldStore;
+//# sourceMappingURL=FieldStore.js.map

package/dist/core/FieldStore.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * core/index.ts
+ *
+ * Forma - 핵심 클래스들 내보내기
+ *
+ * @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 { FieldStore } from "./FieldStore";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * core/index.ts
+ *
+ * Forma - 핵심 클래스들 내보내기
+ *
+ * @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.FieldStore = void 0;
+var FieldStore_1 = require("./FieldStore");
+Object.defineProperty(exports, "FieldStore", { enumerable: true, get: function () { return FieldStore_1.FieldStore; } });
+// 향후 추가될 핵심 클래스들
+// export { FormValidator } from './FormValidator';
+// export { FormStore } from './FormStore';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAEH,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,iBAAiB;AACjB,mDAAmD;AACnD,2CAA2C"}

package/dist/esm/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/esm/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/esm/contexts/GlobalFormContext.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx } from "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.
+ */
+import { createContext, useRef } from "react";
+import { FieldStore } from "../core/FieldStore";
+/**
+ * 글로벌 폼 상태 관리를 위한 React Context | React Context for global form state management
+ */
+export const GlobalFormContext = 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>
+ *   );
+ * }
+ * ```
+ */
+export function GlobalFormProvider({ children }) {
+    // formId별 FieldStore 인스턴스들을 관리하는 Map | Map managing FieldStore instances by formId
+    const storesRef = 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({});
+            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 (_jsx(GlobalFormContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=GlobalFormContext.js.map

package/dist/esm/contexts/GlobalFormContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalFormContext.js","sourceRoot":"","sources":["../../../contexts/GlobalFormContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAa,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAwB;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,MAAM,UAAU,kBAAkB,CAAC,EAAE,QAAQ,EAA2B;IACpE,mFAAmF;IACnF,MAAM,SAAS,GAAG,MAAM,CAA+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,UAAU,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,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC1C,QAAQ,GACgB,CAChC,CAAC;AACN,CAAC"}

package/dist/esm/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/esm/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"}