@ehfuse/forma 1.0.0

package/dist/types/globalForm.d.ts

@@ -0,0 +1,265 @@
+/**
+ * globalForm.ts
+ *
+ * Forma - 전역 폼 상태 관리 관련 TypeScript 타입 정의 | Global form state management related TypeScript type definitions
+ *
+ * @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 { UseFormReturn } from "./form";
+/**
+ * 전역 폼 컨텍스트 제공자의 Props 타입 | Props type for global form context provider
+ */
+export interface GlobalFormProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * useGlobalForm 훅의 Props 타입 | useGlobalForm hook Props type
+ * 글로벌 폼은 데이터 공유에만 집중 | Global form focuses only on data sharing
+ */
+export interface UseGlobalFormProps<T extends Record<string, any>> {
+    /** 전역에서 폼을 식별하는 고유 ID | Unique ID to identify form globally */
+    formId: string;
+    /** 컴포넌트 언마운트 시 자동 정리 여부 | Auto cleanup on component unmount */
+    autoCleanup?: boolean;
+}
+/**
+ * useGlobalForm 훅의 반환 타입 | useGlobalForm hook return type
+ * useForm의 모든 기능에 글로벌 폼 전용 기능 추가 | All useForm features plus global form specific features
+ */
+export interface UseGlobalFormReturn<T extends Record<string, any>> extends UseFormReturn<T> {
+    /** 글로벌 폼 ID | Global form ID */
+    formId: string;
+    /** 글로벌 스토어 직접 접근 | Direct access to global store */
+    _store: FieldStore<T>;
+}
+/**
+ * 전역 폼 스토어 맵의 타입 | Type for global form store map
+ * Key: formId (string)
+ * Value: FieldStore 인스턴스
+ */
+export type GlobalFormStoreMap = Map<string, FieldStore<any>>;
+/**
+ * 전역 폼 메타데이터
+ * 폼의 상태 정보를 추적하는데 사용
+ */
+export interface GlobalFormMetadata {
+    /** 폼 ID */
+    id: string;
+    /** 생성된 시간 */
+    createdAt: Date;
+    /** 마지막 수정 시간 */
+    lastModified: Date;
+    /** 현재 이 폼을 사용 중인 컴포넌트 수 */
+    activeComponents: number;
+    /** 자동 정리 설정 여부 */
+    autoCleanup: boolean;
+}
+/**
+ * 폼 생명주기 이벤트 타입
+ */
+export type GlobalFormLifecycleEvent = "created" | "accessed" | "modified" | "destroyed";
+/**
+ * 폼 생명주기 이벤트 핸들러 타입
+ */
+export type GlobalFormLifecycleHandler = (formId: string, event: GlobalFormLifecycleEvent, metadata?: Partial<GlobalFormMetadata>) => void;
+/**
+ * 전역 폼 설정 옵션
+ */
+export interface GlobalFormConfig {
+    /** 최대 동시 활성 폼 수 (기본값: 50) */
+    maxActiveForms?: number;
+    /** 자동 정리 활성화 여부 (기본값: true) */
+    enableAutoCleanup?: boolean;
+    /** 디버그 모드 활성화 여부 (기본값: development 환경에서만 true) */
+    debugMode?: boolean;
+    /** 생명주기 이벤트 핸들러 */
+    onLifecycleEvent?: GlobalFormLifecycleHandler;
+}
+/**
+ * 전역 폼 통계 정보
+ */
+export interface GlobalFormStats {
+    /** 현재 활성 폼 수 */
+    activeForms: number;
+    /** 지금까지 생성된 총 폼 수 */
+    totalFormsCreated: number;
+    /** 지금까지 정리된 총 폼 수 */
+    totalFormsDestroyed: number;
+    /** 메모리 사용량 (추정치) */
+    estimatedMemoryUsage: string;
+    /** 가장 오래된 폼의 생성 시간 */
+    oldestFormCreatedAt?: Date;
+}
+/**
+ * 전역 폼 훅의 반환 타입에서 추가된 속성들
+ */
+export interface GlobalFormExtensions {
+    /** 전역 폼 ID */
+    formId: string;
+    /** 전역 폼 상태 수동 정리 함수 */
+    clearGlobalForm: () => void;
+    /** 전역 폼 여부를 나타내는 플래그 */
+    isGlobalForm: true;
+}
+/**
+ * 폼이 전역 폼인지 구분하는 타입 가드용 인터페이스
+ */
+export interface GlobalFormIdentifier {
+    isGlobalForm: true;
+    formId: string;
+}
+/**
+ * 로컬 폼과 전역 폼을 구분하는 Union 타입
+ */
+export type FormType = "local" | "global";
+/**
+ * 폼 사용량 추적을 위한 타입
+ */
+export interface FormUsageTracker {
+    /** 폼 ID */
+    formId: string;
+    /** 폼을 사용하는 컴포넌트들의 참조 */
+    componentRefs: Set<string>;
+    /** 마지막 접근 시간 */
+    lastAccessTime: Date;
+    /** 총 접근 횟수 */
+    accessCount: number;
+}
+/**
+ * 전역 폼 에러 타입
+ */
+export declare class GlobalFormError extends Error {
+    formId?: string | undefined;
+    operation?: string | undefined;
+    constructor(message: string, formId?: string | undefined, operation?: string | undefined);
+}
+/**
+ * 전역 폼 경고 타입
+ */
+export interface GlobalFormWarning {
+    type: "memory_usage" | "stale_form" | "excessive_forms" | "cleanup_failure";
+    message: string;
+    formId?: string;
+    severity: "low" | "medium" | "high";
+    timestamp: Date;
+}
+/**
+ * 전역 폼 디버그 정보
+ */
+export interface GlobalFormDebugInfo {
+    /** 모든 활성 폼의 메타데이터 */
+    activeForms: Record<string, GlobalFormMetadata>;
+    /** 성능 통계 */
+    stats: GlobalFormStats;
+    /** 최근 경고들 */
+    recentWarnings: GlobalFormWarning[];
+    /** 메모리 사용량 상세 정보 */
+    memoryBreakdown: {
+        formStores: number;
+        fieldValues: number;
+        listeners: number;
+        metadata: number;
+    };
+}
+/**
+ * 전역 폼 상태 스냅샷
+ * 디버깅이나 테스트 용도로 현재 상태를 캡처
+ */
+export interface GlobalFormSnapshot {
+    /** 스냅샷 생성 시간 */
+    timestamp: Date;
+    /** 모든 폼의 현재 값들 */
+    formValues: Record<string, any>;
+    /** 폼 메타데이터들 */
+    metadata: Record<string, GlobalFormMetadata>;
+    /** 스냅샷 생성 이유 */
+    reason: "manual" | "auto_cleanup" | "memory_limit" | "test";
+}
+/**
+ * 개발 도구를 위한 전역 폼 인터페이스
+ * 브라우저 개발자 도구에서 전역 폼 상태를 검사할 때 사용
+ */
+export interface GlobalFormDevTools {
+    /** 현재 활성 폼 목록 조회 */
+    getActiveForms(): string[];
+    /** 특정 폼의 상세 정보 조회 */
+    getFormDetails(formId: string): GlobalFormMetadata | null;
+    /** 폼 값 조회 */
+    getFormValues(formId: string): any;
+    /** 폼 값 강제 설정 (디버깅용) */
+    setFormValues(formId: string, values: any): void;
+    /** 폼 강제 정리 */
+    destroyForm(formId: string): boolean;
+    /** 모든 폼 정리 */
+    destroyAllForms(): number;
+    /** 성능 통계 조회 */
+    getStats(): GlobalFormStats;
+    /** 디버그 정보 조회 */
+    getDebugInfo(): GlobalFormDebugInfo;
+    /** 상태 스냅샷 생성 */
+    createSnapshot(reason?: string): GlobalFormSnapshot;
+}
+/**
+ * 전역 폼 이벤트 타입
+ */
+export type GlobalFormEvent = {
+    type: GlobalFormLifecycleEvent;
+    formId: string;
+    timestamp: Date;
+    data?: any;
+};
+/**
+ * 전역 폼 이벤트 리스너 타입
+ */
+export type GlobalFormEventListener = (event: GlobalFormEvent) => void;
+/**
+ * 전역 폼 미들웨어 타입
+ * 폼 생명주기에 커스텀 로직을 추가할 때 사용
+ */
+export interface GlobalFormMiddleware {
+    name: string;
+    onFormCreate?: (formId: string, initialValues: any) => void;
+    onFormAccess?: (formId: string) => void;
+    onFormUpdate?: (formId: string, field: string, value: any) => void;
+    onFormDestroy?: (formId: string) => void;
+}
+/**
+ * 전역 폼 Provider에 확장된 Props
+ */
+export interface ExtendedGlobalFormProviderProps extends GlobalFormProviderProps {
+    /** 전역 폼 설정 */
+    config?: GlobalFormConfig;
+    /** 미들웨어 목록 */
+    middleware?: GlobalFormMiddleware[];
+    /** 개발 도구 활성화 여부 */
+    enableDevTools?: boolean;
+}
+/**
+ * 글로벌 폼 컨텍스트 타입 / Global form context type
+ */
+export interface GlobalFormContextType {
+    getOrCreateStore: <T extends Record<string, any>>(formId: string) => FieldStore<T>;
+    registerStore: <T extends Record<string, any>>(formId: string, store: FieldStore<T>) => void;
+}
+//# sourceMappingURL=globalForm.d.ts.map

package/dist/types/globalForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalForm.d.ts","sourceRoot":"","sources":["../../types/globalForm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC7D,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAC9D,SAAQ,aAAa,CAAC,CAAC,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,gBAAgB;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,2BAA2B;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAC9B,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,wBAAwB,EAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KACrC,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB;IACnB,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,mBAAmB,CAAC,EAAE,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,wBAAwB;IACxB,YAAY,EAAE,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,gBAAgB;IAChB,cAAc,EAAE,IAAI,CAAC;IACrB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAG3B,MAAM,CAAC,EAAE,MAAM;IACf,SAAS,CAAC,EAAE,MAAM;gBAFzB,OAAO,EAAE,MAAM,EACR,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,SAAS,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,cAAc,GAAG,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,SAAS,EAAE,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,YAAY;IACZ,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa;IACb,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,oBAAoB;IACpB,eAAe,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,gBAAgB;IAChB,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,MAAM,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,oBAAoB;IACpB,cAAc,IAAI,MAAM,EAAE,CAAC;IAC3B,qBAAqB;IACrB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAC1D,aAAa;IACb,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IACnC,uBAAuB;IACvB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IACjD,cAAc;IACd,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,cAAc;IACd,eAAe,IAAI,MAAM,CAAC;IAC1B,eAAe;IACf,QAAQ,IAAI,eAAe,CAAC;IAC5B,gBAAgB;IAChB,YAAY,IAAI,mBAAmB,CAAC;IACpC,gBAAgB;IAChB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5D,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACnE,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,+BACb,SAAQ,uBAAuB;IAC/B,cAAc;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc;IACd,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,mBAAmB;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5C,MAAM,EAAE,MAAM,KACb,UAAU,CAAC,CAAC,CAAC,CAAC;IACnB,aAAa,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KACnB,IAAI,CAAC;CACb"}

package/dist/types/globalForm.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * globalForm.ts
+ *
+ * Forma - 전역 폼 상태 관리 관련 TypeScript 타입 정의 | Global form state management related TypeScript type definitions
+ *
+ * @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.GlobalFormError = void 0;
+/**
+ * 전역 폼 에러 타입
+ */
+class GlobalFormError extends Error {
+    constructor(message, formId, operation) {
+        super(message);
+        this.formId = formId;
+        this.operation = operation;
+        this.name = "GlobalFormError";
+    }
+}
+exports.GlobalFormError = GlobalFormError;
+//# sourceMappingURL=globalForm.js.map

package/dist/types/globalForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalForm.js","sourceRoot":"","sources":["../../types/globalForm.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAkJH;;GAEG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACtC,YACI,OAAe,EACR,MAAe,EACf,SAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAS;QACf,cAAS,GAAT,SAAS,CAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AATD,0CASC"}

package/dist/types/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * types/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 type { FormChangeEvent, DatePickerChangeHandler, UseFormProps, UseFormReturn, FormState, FormValidationResult, } from "./form";
+export type { GlobalFormProviderProps, UseGlobalFormProps, GlobalFormStoreMap, GlobalFormMetadata, GlobalFormLifecycleEvent, GlobalFormLifecycleHandler, GlobalFormConfig, GlobalFormStats, GlobalFormExtensions, GlobalFormIdentifier, FormType, FormUsageTracker, GlobalFormWarning, GlobalFormDebugInfo, GlobalFormSnapshot, GlobalFormDevTools, GlobalFormEvent, GlobalFormEventListener, GlobalFormMiddleware, ExtendedGlobalFormProviderProps, } from "./globalForm";
+export { GlobalFormError } from "./globalForm";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,YAAY,EACR,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,oBAAoB,GACvB,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACR,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,+BAA+B,GAClC,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * types/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.GlobalFormError = void 0;
+// 에러 클래스
+var globalForm_1 = require("./globalForm");
+Object.defineProperty(exports, "GlobalFormError", { enumerable: true, get: function () { return globalForm_1.GlobalFormError; } });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAoCH,SAAS;AACT,2CAA+C;AAAtC,6GAAA,eAAe,OAAA"}

package/dist/utils/dotNotation.d.ts

@@ -0,0 +1,58 @@
+/**
+ * dotNotation.ts
+ *
+ * Forma - Dot notation 관련 유틸리티 함수들 | Dot notation utility functions
+ * 중첩 객체의 값을 안전하게 가져오고 설정하는 기능 제공 | Provides safe getting and setting of nested object values
+ *
+ * @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.
+ */
+/**
+ * dot notation으로 중첩 객체의 값을 가져오는 함수 | Function to get nested object values using dot notation
+ * @param obj 대상 객체 | Target object
+ * @param path dot notation 경로 (예: "user.profile.name") | Dot notation path (e.g., "user.profile.name")
+ * @returns 해당 경로의 값 또는 undefined | Value at the path or undefined
+ *
+ * @example
+ * ```typescript
+ * const data = { user: { profile: { name: 'John' } } };
+ * const name = getNestedValue(data, 'user.profile.name'); // 'John'
+ * ```
+ */
+export declare function getNestedValue(obj: any, path: string): any;
+/**
+ * dot notation으로 중첩 객체의 값을 설정하는 함수 | Function to set nested object values using dot notation
+ * 불변성을 유지하면서 새로운 객체를 반환 | Returns a new object while maintaining immutability
+ * @param obj 대상 객체 | Target object
+ * @param path dot notation 경로 | Dot notation path
+ * @param value 설정할 값 | Value to set
+ * @returns 새로운 객체 | New object
+ *
+ * @example
+ * ```typescript
+ * const data = { user: { profile: { name: 'John' } } };
+ * const newData = setNestedValue(data, 'user.profile.name', 'Jane');
+ * // { user: { profile: { name: 'Jane' } } }
+ * ```
+ */
+export declare function setNestedValue(obj: any, path: string, value: any): any;
+//# sourceMappingURL=dotNotation.d.ts.map

package/dist/utils/dotNotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotNotation.d.ts","sourceRoot":"","sources":["../../utils/dotNotation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAgB1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAqCtE"}

package/dist/utils/dotNotation.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * dotNotation.ts
+ *
+ * Forma - Dot notation 관련 유틸리티 함수들 | Dot notation utility functions
+ * 중첩 객체의 값을 안전하게 가져오고 설정하는 기능 제공 | Provides safe getting and setting of nested object values
+ *
+ * @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.getNestedValue = getNestedValue;
+exports.setNestedValue = setNestedValue;
+/**
+ * dot notation으로 중첩 객체의 값을 가져오는 함수 | Function to get nested object values using dot notation
+ * @param obj 대상 객체 | Target object
+ * @param path dot notation 경로 (예: "user.profile.name") | Dot notation path (e.g., "user.profile.name")
+ * @returns 해당 경로의 값 또는 undefined | Value at the path or undefined
+ *
+ * @example
+ * ```typescript
+ * const data = { user: { profile: { name: 'John' } } };
+ * const name = getNestedValue(data, 'user.profile.name'); // 'John'
+ * ```
+ */
+function getNestedValue(obj, path) {
+    if (!path.includes(".")) {
+        return obj[path];
+    }
+    const keys = path.split(".");
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * dot notation으로 중첩 객체의 값을 설정하는 함수 | Function to set nested object values using dot notation
+ * 불변성을 유지하면서 새로운 객체를 반환 | Returns a new object while maintaining immutability
+ * @param obj 대상 객체 | Target object
+ * @param path dot notation 경로 | Dot notation path
+ * @param value 설정할 값 | Value to set
+ * @returns 새로운 객체 | New object
+ *
+ * @example
+ * ```typescript
+ * const data = { user: { profile: { name: 'John' } } };
+ * const newData = setNestedValue(data, 'user.profile.name', 'Jane');
+ * // { user: { profile: { name: 'Jane' } } }
+ * ```
+ */
+function setNestedValue(obj, path, value) {
+    if (!path.includes(".")) {
+        const result = { ...obj, [path]: value };
+        return result;
+    }
+    const keys = path.split(".");
+    const result = Array.isArray(obj) ? [...obj] : { ...obj }; // 배열 타입 보존 | Preserve array type
+    let current = result;
+    // 마지막 키 전까지 객체 생성/복사 | Create/copy objects until the last key
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] === null ||
+            current[key] === undefined ||
+            typeof current[key] !== "object") {
+            current[key] = {};
+            console.log(`📝 새 객체 생성: ${key} | Creating new object: ${key}`);
+        }
+        else {
+            // 배열 타입 보존하면서 복사 | Copy while preserving array type
+            current[key] = Array.isArray(current[key])
+                ? [...current[key]]
+                : { ...current[key] };
+        }
+        current = current[key];
+    }
+    // 마지막 키에 값 설정 | Set value to the last key
+    const lastKey = keys[keys.length - 1];
+    current[lastKey] = value;
+    return result;
+}
+//# sourceMappingURL=dotNotation.js.map

package/dist/utils/dotNotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotNotation.js","sourceRoot":"","sources":["../../utils/dotNotation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;AAcH,wCAgBC;AAiBD,wCAqCC;AAlFD;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAAC,GAAQ,EAAE,IAAY;IACjD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,cAAc,CAAC,GAAQ,EAAE,IAAY,EAAE,KAAU;IAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,iCAAiC;IAC5F,IAAI,OAAO,GAAG,MAAM,CAAC;IAErB,8DAA8D;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IACI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI;YACrB,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAClC,CAAC;YACC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CACP,eAAe,GAAG,2BAA2B,GAAG,EAAE,CACrD,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,oDAAoD;YACpD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,0CAA0C;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IAEzB,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * utils/index.ts
+ *
+ * @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 { getNestedValue, setNestedValue } from "./dotNotation";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * utils/index.ts
+ *
+ * @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.setNestedValue = exports.getNestedValue = void 0;
+var dotNotation_1 = require("./dotNotation");
+Object.defineProperty(exports, "getNestedValue", { enumerable: true, get: function () { return dotNotation_1.getNestedValue; } });
+Object.defineProperty(exports, "setNestedValue", { enumerable: true, get: function () { return dotNotation_1.setNestedValue; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAEH,6CAA+D;AAAtD,6GAAA,cAAc,OAAA;AAAE,6GAAA,cAAc,OAAA"}