타입

루트 진입점은 CreateFormOptions, FieldSchemaOptions, FieldPathInput, FieldPathValue, FieldState, Form, FormArray, FormError, FormState, ResetOptions, SetValueOptions, StandardSchemaV1, ValidationTrigger(CreateForm 클래스 포함)을 내보냅니다. 어댑터 패키지도 RegisterOptions 별칭과 프레임워크별 반환 타입을 내보냅니다.

import type {
  CreateFormOptions,
  FieldPathInput,
  FieldState,
  FormError,
  FormState,
  StandardSchemaV1,
} from '@ilokesto/form';
import type { RegisterOptions } from '@ilokesto/form/react';

이 타입들은 공유 폼 팩토리, 커스텀 훅, 재사용 필드 컴포넌트, 스키마 도우미 같은 경계에서 사용하세요. FormState를 통해 관찰 가능한 것으로 문서화된 경우가 아니라면 내부 정규화 키에 의존하지 않는 편이 좋습니다. 공개 타입은 안정적인 계약을 설명하고, 구현 도우미는 애플리케이션 코드의 일부가 되지 않은 채 바뀔 수 있습니다.

실무 사용 팁

추상화를 만들 때는 이 레퍼런스를 가까이 두세요. 레퍼런스는 패키지가 무엇을 노출하는지 설명하고, 가이드는 그 조각들을 조합하는 한 가지 방식을 보여줍니다. 어떤 도우미가 FieldPathInput, 검증 시점, 배열 재배치를 감춘다면 그 도우미도 같은 정밀도로 문서화하세요. 그래야 나중에 문자열, 튜플, 안정적인 키 중 무엇을 기대하는지 유지보수자가 알 수 있습니다.