Files
clean-architecture-frontend…/src/presentation/design-system/index.ts
T
DongHyeonka 6b79e7b39f fix(form): 폼이 mutation을 받아 저장 규칙을 맡고 FormSaveFeedback이 피드백을 그린다
결과 불명 상태를 코디네이터(useApplicationMutation)와 폼(useAppForm)이
따로 갖고, 둘을 맞추는 규칙은 생성 작성 페이지의 사본에 있다: 결과 불명·
다른 저장 중 새 저장 막기, 「변경됨으로 확인」 뒤 settleApplied, 같은 키
재전송, 다른 저장이 도는 동안의 표시. 그래서 플랫폼에서 고친 것(1105/08-02,
1105/08-04, 1106/08-02)이 이미 생성한 기능에 들어가지 않는다(1112/01-01).
같은 구조에서 셋이 더 나온다.

- 재전송이 쓰기 전에 거절되거나(429·503) 선언한 409가 나면 "입력 내용을
  확인해 주세요." 요약 아래 나온다(1112/04-02).
- 폼 밖에서 부른 같은 입력이 NOT_APPLIED로 끝나면 훅은 결과 불명인데 폼은
  다시 시도를 보인다(1106/03-01 ②).
- 필드 이름이 붙은 결과 불명(VALIDATION_REJECTED + MAYBE_APPLIED)이 필드
  오류와 결과 불명 화면을 함께 띄운다(1101/03-04).

고른 방법(R9-D1, 권하는 안으로 정함(2026-11-12, 총괄)): useAppForm에 선택
옵션 mutation을 더한다(추가만). 주면 폼이 saveBlocked로 새 저장을 막고
confirmUnknownEffect·resendUnknownEffect를 내주며, 입력 오류가 아닌 저장
안내를 notice로 둔다. 새 FormSaveFeedback이 결과 불명 → 저장 실패 → 충돌 →
다른 저장 순으로 피드백을 그리고, AsyncSurface의 새 notice 칸에 재전송 거절
안내를 보인다. 결과 불명을 코디네이터 상태로 먼저 보므로 ②도 같은 화면이
된다. 폼은 MAYBE_APPLIED를 입력 오류보다 먼저 본다. 생성 작성 페이지는 이
둘을 쓰고 자기 사본을 지운다. mutation을 주지 않은 폼은 전과 같다. 버린
대안: 판정 hook을 따로 두고 폼은 그대로(사본이 하나 더 생긴다).

위험·한계: 이미 생성한 기능은 바뀌지 않는다. CHANGELOG에 생성 페이지를
옮기는 방법을 적는다. 다시 마운트한 폼이 mutation 없이 쓰이면 ②는 그대로다.
VD-04 결정 5의 범위(선언하지 않은 409만)는 머리 블록에 적었다(1103/03-01 (3)).

검증: tests/component/form-foundation.test.tsx의 새 시험 넷(막기, 확인,
재전송 거절 표면, 결과 불명 우선)과 create-feature.test.ts의 생성 페이지
시험이 고치기 전 코드에서 실패하고 고친 뒤 통과한다. 생성 페이지는
FE-GATE-020 scaffold 드릴과 FE-GATE-008 e2e가 돈다(PR 본문).

Refs: 1112/01-01, 1112/04-02, 1106/03-01, 1101/03-04, 1103/03-01
2026-11-12 23:21:21 +09:00

135 lines
3.9 KiB
TypeScript

// One file per primitive (1101/08-08): a bundler places a module, not an
// export, so a primitive only a lazy screen uses stays out of the initial
// chunk only when no primitive the shell uses shares its file.
export { Alert, type AlertProps } from "./primitives/alert.tsx";
export { Badge, type BadgeProps } from "./primitives/badge.tsx";
export {
Button,
type ButtonProps,
type ButtonSize,
type ButtonVariant,
} from "./primitives/button.tsx";
export { Card, type CardProps } from "./primitives/card.tsx";
export { Dialog, type DialogProps } from "./primitives/dialog.tsx";
export { Field } from "./primitives/field.tsx";
export { FocusRing } from "./primitives/focus-ring.tsx";
export { IconButton, type IconButtonProps } from "./primitives/icon-button.tsx";
export {
LinkButton,
type LinkButtonProps,
type LinkTarget,
} from "./primitives/link-button.tsx";
export { Portal } from "./primitives/portal.tsx";
export { Spinner, type SpinnerProps } from "./primitives/spinner.tsx";
export { TextField, type TextFieldProps } from "./primitives/text-field.tsx";
export { VisuallyHidden } from "./primitives/visually-hidden.tsx";
export { Checkbox, type CheckboxProps } from "./primitives/checkbox.tsx";
export {
RadioGroup,
type RadioGroupProps,
type RadioOption,
} from "./primitives/radio-group.tsx";
export {
SearchField,
type SearchFieldProps,
} from "./primitives/search-field.tsx";
export {
Select,
type SelectOption,
type SelectProps,
} from "./primitives/select.tsx";
export { Switch, type SwitchProps } from "./primitives/switch.tsx";
export { TextArea, type TextAreaProps } from "./primitives/text-area.tsx";
export {
ProgressBar,
type ProgressBarProps,
} from "./primitives/progress-bar.tsx";
export { Separator } from "./primitives/separator.tsx";
export { Skeleton, type SkeletonProps } from "./primitives/skeleton.tsx";
export {
ConfirmationDialog,
} from "./primitives/confirmation-dialog.tsx";
export { Drawer, type DrawerProps } from "./primitives/drawer.tsx";
export {
Menu,
type MenuItemDefinition,
type MenuProps,
} from "./primitives/menu.tsx";
export { Popover, type PopoverProps } from "./primitives/popover.tsx";
export { ToastProvider, useToast } from "./primitives/toast.tsx";
export { Tooltip, type TooltipProps } from "./primitives/tooltip.tsx";
export {
Breadcrumbs,
type BreadcrumbItem,
} from "./primitives/breadcrumbs.tsx";
export { Pagination } from "./primitives/pagination.tsx";
export { Tabs, type TabDefinition } from "./primitives/tabs.tsx";
export {
CloseIcon,
ErrorIcon,
InfoIcon,
MenuIcon,
NextIcon,
PreviousIcon,
SearchIcon,
SuccessIcon,
WarningIcon,
} from "./icons/semantic-icons.tsx";
export type {
SemanticIconProps,
} from "./icons/semantic-icons.tsx";
export {
DESIGN_TOKEN_CONTRACT,
REQUIRED_COMPONENT_TOKENS,
REQUIRED_PRIMITIVE_TOKENS,
REQUIRED_SEMANTIC_TOKENS,
} from "./tokens/token-contract.ts";
export {
AccessSurface,
DataTable,
DisclosureGroup,
PaginationBar,
SearchFilterToolbar,
} from "./patterns/common-patterns.tsx";
export type {
AccessSurfaceProps,
DataTableColumn,
DisclosureDefinition,
} from "./patterns/common-patterns.tsx";
export {
AsyncSurface,
EmptySurface,
LoadingSurface,
TerminalErrorSurface,
} from "../components/async-surface.tsx";
export { PageHeader } from "../components/page-header.tsx";
export {
AuthRequiredSurface,
ForbiddenSurface,
NotFoundSurface,
} from "../components/state-surfaces.tsx";
export {
DetailPage,
CollectionPage,
FormPage,
StandardPage,
StatusPage,
} from "../templates/index.ts";
export {
DirtyNavigationDialog,
ErrorSummary,
Form,
FormActions,
FormFailureStatus,
FormField,
FormSaveFeedback,
useAppForm,
useDirtyNavigationGuard,
} from "../forms/index.ts";
export type {
PageActionDefinition,
PageHeading,
} from "../templates/page-templates.tsx";
export type { FormResult } from "../forms/form-contracts.ts";