@yeongseoksong/framework 1.6.1 → 1.7.0

package/dist/store/index.d.ts

@@ -1,237 +0,0 @@
-import * as zustand_middleware from 'zustand/middleware';
-import * as zustand from 'zustand';
-import { ReactNode, FormEvent } from 'react';
-
-/**
- * 로그인한 사용자. 소비자 앱의 사용자 모델이 더 넓으면 `login()`에 넘기기 전에
- * 이 형태로 좁혀서 넣는다 — 스토어는 화면이 필요로 하는 최소 정보만 갖는다.
- */
-interface AuthUser {
-    id: string;
-    email: string;
-    name?: string;
-    roles?: string[];
-}
-interface AuthState {
-    user: AuthUser | null;
-    /** user의 파생값이지만, 셀렉터를 `(s) => s.isAuthenticated` 한 줄로 유지하려고 상태로 둔다. */
-    isAuthenticated: boolean;
-    /** localStorage 복원이 끝났는지. 정적 프리렌더 대비용 — 아래 주석 참고. */
-    hasHydrated: boolean;
-    login: (user: AuthUser) => void;
-    logout: () => void;
-    setHasHydrated: (value: boolean) => void;
-}
-/**
- * 인증 세션.
- *
- * **액세스 토큰을 여기 넣지 말 것.** `partialize`가 사용자 프로필만 저장하도록
- * 막아 두었다. 토큰은 httpOnly 쿠키로 두는 게 소비자 앱의 몫이다 — localStorage에
- * 담으면 XSS 한 번에 그대로 털린다.
- *
- * `skipHydration`을 켠 이유: 자동 복원은 모듈 평가 시점에 일어나서 **첫 클라이언트
- * 렌더가 이미 로그인 상태**가 된다. 반면 서버가 만든 HTML에는 항상 로그아웃 상태가
- * 박혀 나가므로(`output: "export"`면 빌드 시점에 고정) 하이드레이션 불일치가 난다.
- * 복원을 이펙트로 미루면 첫 렌더가 서버와 일치하고, 그 다음 틱에 세션이 반영된다.
- * 복원을 트리거하고 완료 여부를 돌려주는 게 아래 `useAuthHydrated()`다.
- */
-declare const useAuthStore: zustand.UseBoundStore<Omit<zustand.StoreApi<AuthState>, "setState" | "persist"> & {
-    setState(partial: AuthState | Partial<AuthState> | ((state: AuthState) => AuthState | Partial<AuthState>), replace?: false | undefined): unknown;
-    setState(state: AuthState | ((state: AuthState) => AuthState), replace: true): unknown;
-    persist: {
-        setOptions: (options: Partial<zustand_middleware.PersistOptions<AuthState, unknown, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: AuthState) => void) => () => void;
-        onFinishHydration: (fn: (state: AuthState) => void) => () => void;
-        getOptions: () => Partial<zustand_middleware.PersistOptions<AuthState, unknown, unknown>>;
-    };
-}>;
-/**
- * 저장된 세션을 복원하고, 복원이 끝났는지를 돌려준다.
- *
- * 로그인 여부에 따라 다르게 그리는 UI는 이 값이 `false`인 동안 **로그아웃 상태로**
- * 그려야 서버 HTML과 어긋나지 않는다.
- *
- * ```tsx
- * const hydrated = useAuthHydrated()
- * const isAuthenticated = useAuthStore((s) => s.isAuthenticated)
- * if (hydrated && isAuthenticated) { ... }
- * ```
- */
-declare function useAuthHydrated(): boolean;
-
-interface UiState {
-    /** 전역 로딩 오버레이 — 라우트 전환·일괄 작업처럼 화면 전체를 막아야 할 때 */
-    globalLoading: boolean;
-    setGlobalLoading: (value: boolean) => void;
-    /** 관리자형 레이아웃의 사이드 내비 열림 상태 */
-    sideNavOpened: boolean;
-    openSideNav: () => void;
-    closeSideNav: () => void;
-    toggleSideNav: () => void;
-}
-/**
- * 화면 간 공유가 필요한 클라이언트 UI 상태.
- *
- * `SdHeader`의 모바일 드로어는 **일부러 여기 두지 않는다.** 그건 인스턴스 로컬
- * 상태(`useDisclosure`)여야 한다 — 카탈로그처럼 한 페이지에 헤더가 둘 이상 렌더되면
- * 스토어를 공유하는 순간 드로어가 함께 열린다.
- */
-declare const useUiStore: zustand.UseBoundStore<zustand.StoreApi<UiState>>;
-
-interface CommonInfo {
-    id: number;
-    order: number;
-    isShow: boolean;
-    createdAt?: Date;
-    updatedAt?: Date;
-}
-interface NavItem extends CommonInfo {
-    label: string;
-    href?: string;
-    highlight?: boolean;
-    parentId?: number;
-}
-
-interface NavState {
-    /** 앱 전역 네비게이션 트리. 소비자가 앱 진입 시 `setNavItems`로 한 번 주입한다. */
-    navItems: NavItem[];
-    setNavItems: (navItems: NavItem[]) => void;
-}
-/**
- * 네비게이션 상태 스토어 — 렌더 트리 **밖에서** navItems에 접근해야 할 때 쓴다
- * (프로그램적 네비게이션, 라우팅 로직 등). 소비자가 `setNavItems`로 채운다.
- *
- * 트리 **안** 컴포넌트(`SdBreadcrumb`)는 이 스토어가 아니라 `ui/template/NavProvider`의
- * React Context(`useNav`)에서 navItems를 읽는다 — `ui` 번들이 스토어를 import하면
- * `dist/ui`에 인라인돼 `create()`가 두 번 도는 dual-bundle 문제가 생기기 때문이다
- * (store/index.ts 상단 주석 참고). Context는 모듈 상태가 없어 그 문제에서 자유롭다.
- */
-declare const useNavStore: zustand.UseBoundStore<zustand.StoreApi<NavState>>;
-
-/**
- * 어떤 작업이 끝난 뒤 항상 돌려야 하는 뒷정리 — 라우팅, 모달 닫기, 목록 새로고침 등.
- *
- * 폼에 딸린 개념이 아니다. 제출·삭제·업로드처럼 "끝나면 정리한다"가 필요한 곳이면
- * 어느 스토어에서든 같은 타입과 실행기를 쓴다.
- */
-/**
- * 뒷정리 함수. **인자를 받지 않는다** — 대개 결과와 무관한 정리·이동이라
- * 기존 함수(`close`, `refetch`, `() => router.push('/')`)를 그대로 꽂을 수 있어야 한다.
- * 반환값은 무시하고, 프로미스면 기다린다.
- */
-type Finalizer = () => unknown | Promise<unknown>;
-/** 하나 또는 여러 개. 여러 개면 넘긴 순서대로 실행된다. */
-type Finalizers = Finalizer | Finalizer[];
-
-/**
- * 모든 폼이 공유하는 상태 + 제출 파이프라인.
- *
- * 폼 하나하나가 `useState`로 값·에러·제출중 여부를 따로 들고 있으면 제출 처리(중복
- * 클릭 차단, 성공/실패 알림, 성공 후 초기화)가 폼마다 조금씩 달라진다. 그 셋을 여기
- * 한 곳에 묶어 두고, 화면은 `useSdForm()` 하나만 부르면 되게 한다.
- *
- * 스토어는 `formId`로 칸을 나눠 쓰므로 한 화면에 폼이 여러 개 떠 있어도 섞이지 않고,
- * 반대로 **같은 id를 쓰면 서로 다른 컴포넌트가 같은 폼을 공유**한다(마법사 단계 분리,
- * 페이지를 오간 뒤 입력값 복원 등).
- */
-type FormValues = Record<string, unknown>;
-/** 값이 유효하면 `null`, 아니면 사용자에게 보여줄 메시지를 돌려준다. */
-type FormRule<V extends FormValues> = (value: unknown, values: V) => string | null;
-type FormErrors<V extends FormValues> = Partial<Record<keyof V, string>>;
-interface FormEntry {
-    values: FormValues;
-    errors: Record<string, string>;
-    submitting: boolean;
-    /** 제출 실패 메시지 — 폼 상단에 노출한다. 필드 에러는 `errors`가 담는다. */
-    error: ReactNode | null;
-}
-interface FormStoreState {
-    forms: Record<string, FormEntry>;
-    /** 첫 마운트 시 초기값을 심는다. 이미 있으면 건드리지 않는다(입력값 보존). */
-    ensureForm: (formId: string, initialValues: FormValues) => void;
-    setValue: (formId: string, name: string, value: unknown) => void;
-    setValues: (formId: string, values: FormValues) => void;
-    setErrors: (formId: string, errors: Record<string, string>) => void;
-    setSubmitting: (formId: string, submitting: boolean) => void;
-    setError: (formId: string, error: ReactNode | null) => void;
-    resetForm: (formId: string, initialValues: FormValues) => void;
-    /** 폼 칸 자체를 버린다 — 값까지 지우고 싶을 때만. */
-    removeForm: (formId: string) => void;
-}
-declare const useFormStore: zustand.UseBoundStore<zustand.StoreApi<FormStoreState>>;
-interface SdFormOptions<V extends FormValues> {
-    /** 스토어에서 이 폼이 쓸 칸의 이름. 같은 id를 쓰는 컴포넌트끼리는 상태를 공유한다. */
-    id: string;
-    initialValues: V;
-    /** 필드별 검증 규칙. 제출 시 한 번에 돌린다. */
-    rules?: Partial<Record<keyof V, FormRule<V>>>;
-    /** 실제 전송. 예외를 던지면 실패로 처리된다(에러 토스트 + 폼 상단 메시지). */
-    onSubmit: (values: V) => void | Promise<void>;
-    /** 성공 토스트 메시지. `false`면 토스트를 띄우지 않는다. */
-    successMessage?: ReactNode | false;
-    /** 실패 메시지 변환. 기본값은 `Error.message`, 없으면 일반 문구. */
-    errorMessage?: (error: unknown) => ReactNode;
-    /** 성공 후 초기값으로 되돌릴지 */
-    resetOnSuccess?: boolean;
-    onSuccess?: (values: V) => void;
-    /** 전송이 실패했을 때. 예외를 그대로 받는다. */
-    onError?: (error: unknown) => void;
-    /**
-     * 성공·실패와 무관하게 전송이 끝나면 **항상** 실행된다 — `finally`에 해당한다.
-     * 라우팅, 모달 닫기, 목록 새로고침처럼 결과와 무관한 뒷정리 자리다.
-     *
-     * 타입은 폼 전용이 아니라 공용 `Finalizers`(`util/finalize.util.ts`)다 — 인자를 받지
-     * 않으므로 기존 함수를 그대로 꽂고(`finalize: closeModal`), 여러 개는 배열로 묶는다.
-     * 결과에 따라 갈라져야 하는 일은 `onSuccess` / `onError`에 둔다.
-     *
-     * 검증에서 걸려 전송 자체를 하지 않은 경우에는 실행되지 않는다(아직 "끝난" 게 아니다).
-     * `submitting`이 내려간 **뒤에** 실행되므로, 여기서 `reset()`이나 다른 제출을 불러도 안전하다.
-     */
-    finalize?: Finalizers;
-}
-interface SdFormApi<V extends FormValues> {
-    values: V;
-    errors: FormErrors<V>;
-    /** 전송 중 — 버튼 `loading`에 그대로 넘긴다. 이 동안 재제출은 무시된다. */
-    submitting: boolean;
-    /** 제출 실패 메시지 */
-    error: ReactNode | null;
-    setValue: <K extends keyof V>(name: K, value: V[K]) => void;
-    setValues: (values: Partial<V>) => void;
-    reset: () => void;
-    /** Mantine 입력 컴포넌트에 펼쳐 넣는다. 체크박스는 `{ type: 'checkbox' }`. */
-    getInputProps: (name: keyof V, options?: {
-        type?: 'input' | 'checkbox';
-    }) => Record<string, unknown>;
-    /** `<form onSubmit={...}>`에 그대로 넘긴다. */
-    onSubmit: (event?: FormEvent<HTMLFormElement>) => void;
-}
-/**
- * 폼 하나를 스토어에 붙이고, 값·에러·제출을 한 묶음으로 돌려준다.
- *
- * 제출은 항상 같은 순서로 흐른다:
- * 검증 → (통과 시) submitting on → `onSubmit` → 성공 토스트·초기화·`onSuccess`
- * → 실패 시 에러 토스트 + 상단 메시지·`onError` → submitting off → `finalize`.
- */
-declare function useSdForm<V extends FormValues>({ id, initialValues, rules, onSubmit, successMessage, errorMessage, resetOnSuccess, onSuccess, onError, finalize, }: SdFormOptions<V>): SdFormApi<V>;
-/**
- * 자주 쓰는 검증 규칙. `rules`에 그대로 꽂아 쓴다.
- *
- * ```ts
- * rules: { email: formRules.email(), password: formRules.minLength(8) }
- * ```
- */
-declare const formRules: {
-    required: <V extends FormValues>(message?: string) => FormRule<V>;
-    email: <V extends FormValues>(message?: string) => FormRule<V>;
-    minLength: <V extends FormValues>(length: number, message?: string) => FormRule<V>;
-    /** 체크박스 동의 — 반드시 true여야 한다. */
-    checked: <V extends FormValues>(message?: string) => FormRule<V>;
-    /** 다른 필드와 같은 값인지 — 비밀번호 확인 등. */
-    sameAs: <V extends FormValues>(other: keyof V, message?: string) => FormRule<V>;
-};
-
-export { type AuthUser, type FormErrors, type FormRule, type FormValues, type SdFormApi, type SdFormOptions, formRules, useAuthHydrated, useAuthStore, useFormStore, useNavStore, useSdForm, useUiStore };

package/dist/types/index.cjs

@@ -1,18 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// types/index.ts
-var types_exports = {};
-module.exports = __toCommonJS(types_exports);

package/dist/types/index.d.ts

@@ -1,105 +0,0 @@
-import { ReactNode } from 'react';
-
-interface CommonInfo {
-    id: number;
-    order: number;
-    isShow: boolean;
-    createdAt?: Date;
-    updatedAt?: Date;
-}
-interface NavItem extends CommonInfo {
-    label: string;
-    href?: string;
-    highlight?: boolean;
-    parentId?: number;
-}
-interface HeroCta {
-    label: string;
-    href: string;
-    variant?: 'primary' | 'secondary' | 'outline' | 'white';
-    icon: boolean;
-}
-interface HeroSlide extends CommonInfo {
-    image: string;
-    title: ReactNode;
-    description: string;
-    ctas?: HeroCta[];
-}
-interface FeatureItem extends CommonInfo {
-    icon?: ReactNode;
-    label?: string;
-    title: ReactNode;
-    description?: ReactNode;
-}
-interface CompanyAddress {
-    label: string;
-    address: string;
-    order: number;
-    embbedUrl?: string;
-}
-type SocialPlatform = 'x' | 'youtube' | 'instagram' | 'facebook' | 'linkedin' | 'github' | 'blog';
-interface SocialItem {
-    platform: SocialPlatform;
-    url: string;
-    label?: string;
-}
-interface CompanyInfo {
-    name: string;
-    registrationNumber: string;
-    addresses: CompanyAddress[];
-    tel: string;
-    fax?: string;
-    email: string;
-    copyrightYear: number;
-    socials?: SocialItem[];
-}
-interface TimelineEvent extends CommonInfo {
-    year: number;
-    month: number;
-    title?: string;
-    description: string;
-}
-interface StepItem {
-    title: string;
-    description?: string;
-}
-interface TestimonialItem {
-    lines: string[];
-    name: string;
-    role: string;
-    company?: string;
-    rating?: number;
-    avatar?: string;
-}
-interface PricingFeature {
-    text: string;
-    included: boolean;
-}
-interface PricingItem {
-    name: string;
-    price: string;
-    period?: string;
-    description?: string;
-    features: PricingFeature[];
-    ctaLabel?: string;
-    isPopular?: boolean;
-}
-interface FaqItem {
-    question: string;
-    answer: string;
-}
-interface ClientItem {
-    name: string;
-    url: string;
-    logo: string;
-}
-interface SolutionItem extends CommonInfo {
-    category: string;
-    title: ReactNode;
-    description: string;
-    href?: string;
-    ctaLabel?: string;
-    icon?: ReactNode;
-}
-
-export type { ClientItem, CommonInfo, CompanyAddress, CompanyInfo, FaqItem, FeatureItem, HeroCta, HeroSlide, NavItem, PricingFeature, PricingItem, SocialItem, SocialPlatform, SolutionItem, StepItem, TestimonialItem, TimelineEvent };