@ehfuse/forma 1.0.0

package/dist/esm/core/FieldStore.js

@@ -0,0 +1,260 @@
+/**
+ * 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.
+ */
+import { getNestedValue, setNestedValue } from "../utils/dotNotation";
+/**
+ * 개별 필드 상태 관리 Store / Individual field state management store
+ * 선택적 구독과 성능 최적화를 위한 핵심 클래스
+ * Core class for selective subscriptions and performance optimization
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ */
+export 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 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 = 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();
+    }
+}
+//# sourceMappingURL=FieldStore.js.map

package/dist/esm/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/esm/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/esm/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/esm/core/index.js

@@ -0,0 +1,32 @@
+/**
+ * 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";
+// 향후 추가될 핵심 클래스들
+// export { FormValidator } from './FormValidator';
+// export { FormStore } from './FormStore';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,iBAAiB;AACjB,mDAAmD;AACnD,2CAA2C"}

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

@@ -0,0 +1,67 @@
+/**
+ * useForm.ts
+ *
+ * Forma - 고급 폼 상태 관리 훅 / Advanced form state management hook
+ * 개별 필드 구독과 성능 최적화를 제공하는 핵심 훅
+ * Core hook providing individual field 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.
+ */
+import { FieldStore } from "../core/FieldStore";
+import { FormChangeEvent, DatePickerChangeHandler, UseFormProps } from "../types/form";
+import React from "react";
+/**
+ * Forma 핵심 폼 관리 훅 / Forma core form management hook
+ *
+ * 고급 폼 상태 관리와 성능 최적화를 제공합니다
+ * Provides advanced form state management and performance optimization
+ *
+ * Features:
+ * - 개별 필드 구독으로 선택적 리렌더링 / Selective re-rendering with individual field subscriptions
+ * - Dot notation 지원으로 중첩 객체 처리 / Nested object handling with dot notation support
+ * - MUI 컴포넌트 완전 호환 / Full MUI component compatibility
+ * - TypeScript 완전 지원 / Complete TypeScript support
+ *
+ * @template T 폼 데이터의 타입 / Form data type
+ * @param props 폼 설정 옵션 / Form configuration options
+ * @returns 폼 관리 API 객체 / Form management API object
+ */
+export declare function useForm<T extends Record<string, any>>({ initialValues, onSubmit, onValidate, onComplete, _externalStore, }: UseFormProps<T>): {
+    isSubmitting: boolean;
+    isValidating: boolean;
+    isModified: boolean;
+    useFormValue: (fieldName: string) => unknown;
+    getFormValue: (fieldName: string) => any;
+    getFormValues: () => T;
+    setFormValue: (name: string, value: any) => void;
+    setFormValues: (newValues: Partial<T>) => void;
+    setInitialFormValues: (newInitialValues: T) => void;
+    handleFormChange: (e: FormChangeEvent) => void;
+    handleDatePickerChange: DatePickerChangeHandler;
+    submit: (e?: React.FormEvent) => Promise<boolean>;
+    resetForm: () => void;
+    validateForm: (valuesToValidate?: T) => Promise<boolean>;
+    values: T;
+    _store: FieldStore<T>;
+};
+//# sourceMappingURL=useForm.d.ts.map

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

@@ -0,0 +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"}