전략: FE de-facto Connector 포트폴리오를 우선 확보

[developer-1px]

배경

json-document의 Connector는 database source나 제품별 API를 수집하는 계층이 아니라, FE 생태계의 이름 붙은 de-facto native contract와 json-document public contract를 번역하는 독립 optional package다.

Database Workspace를 향한 기능을 계속 추가하기 전에 주요 FE 계약과의 접점을 먼저 확보해, 같은 headless editing·selection·history가 서로 다른 UI 생태계에서 재사용됨을 증명한다.

Goal Anchor

• Outcome: Database UI 기능보다 FE de-facto Connector 확보를 우선하는 레포 전략을 참고 이슈로 보존한다.
• Done:
  • 현재 Connector: React, Zod, TanStack Table
  • 우선 확보 대상: Web Platform, TanStack Virtual, React Hook Form
  • 검증 후보: React Aria, dnd-kit
  • 첫 구현 태스크: Web Platform Connector
  • 승격 조건: public contract만 사용하고 반복 glue, contract test, Connector Live Demo와 browser acceptance로 필요성을 증명한다.
• Don't:
  • REST, SQL, 회사 API를 Connector 범위에 넣지 않는다.
  • 검증 후보를 구현 확정으로 취급하지 않는다.
  • Connector가 새로운 editing 또는 database semantics를 발명하지 않는다.
  • Kernel의 dependency-free 경계를 바꾸지 않는다.

포트폴리오

구분	대상	상태
Framework lifecycle	React	구현됨
Runtime validation	Zod	구현됨
Table projection	TanStack Table	구현됨
Browser input/clipboard	Web Platform	첫 구현 태스크
Large collection viewport	TanStack Virtual	우선 확보 대상
Record detail/form	React Hook Form	우선 확보 대상
Accessible collection selection	React Aria	반복 glue 검증 후보
Drag/reorder interaction	dnd-kit	반복 glue 검증 후보

Connector 승격 계약

Connector는 다음 조건을 모두 만족할 때 공식 package로 승격한다.

• Kernel 또는 companion의 public contract만 사용한다.
• 대상 생태계의 native API 모양을 유지한다.
• 외부 runtime을 peerDependency로 격리한다.
• Connector를 제거하거나 교체해도 canonical JSON, selection topology, command 의미가 바뀌지 않는다.
• contract test, Connector별 Live Demo, browser acceptance를 제공한다.
• 제품별 UI, persistence, remote protocol과 interaction policy는 host에 남긴다.

진행 원칙

우선 확보 대상도 미리 일괄 구현하지 않는다. Live Demo에서 반복되는 app-local glue가 확인될 때 하나씩 Connector로 추출한다. React Aria와 dnd-kit은 해당 반복이 증명되기 전까지 후보 상태를 유지한다.

참고

• README.md
• docs/public/connectors.md
• site/src/routes/connectors/connector-catalog.ts

[developer-1px]

첫 실행 태스크를 분리했습니다.\n\n- #294\n\n#294에서는 Web Platform Connector만 다루며, TanStack Virtual·React Hook Form·React Aria·dnd-kit은 #293의 승격 조건에 따라 별도 근거가 확인될 때 후속 범위를 결정합니다.

[developer-1px]

Web Platform Connector #294의 구현·Live Demo 소급 적용·병합을 완료한 뒤 다음 후보를 재평가했습니다.

• 다음 구현 대상: React Hook Form
• 근거: RHF의 draft·dirty·touched·field error·reset lifecycle과 canonical JSON transaction/history 사이에 실제 반복 번역 경계가 존재합니다.
• TanStack Virtual: 현재 native contract가 viewport 측정·render index 중심이라 stable identity를 직접 넘겨 조합할 수 있습니다. 반복 번역이 확인되기 전까지 Connector 구현을 보류합니다.
• React Aria·dnd-kit: #293의 검증 후보 상태를 유지합니다.

React Hook Form Connector는 별도 구현 이슈로 분리하며, field UI·form generator·제품 schema·persistence를 포함하지 않습니다.

[developer-1px]

Connector 포트폴리오를 확장하면서 드러난 조합·학습 비용을 후속 설계 이슈로 분리했습니다.

• 설계: Connector 공개 계약을 XxxConnector(document, options)로 통일 #308

핵심은 범용 composition runtime을 추가하는 것이 아니라, 실제 stateful Connector의 공식 진입점을 createXxxConnector(document, options) / useXxxConnector(document, options)로 통일하는 것입니다. 같은 JSONDocument instance가 canonical value·validation·commit notification의 공유 경계가 되며, selection·focus·draft는 각 affordance가 계속 소유합니다.

Zod validator, Web codec·modifier translator처럼 document에 직접 연결되지 않는 순수 함수는 억지로 Connector 모양에 맞추지 않고 현재 책임에 맞는 helper로 분류합니다. 전역 undo/redo와 path scope도 #308 범위에서 제외했습니다.

[developer-1px]

#436 정본 감사 결과

분류: 종료(completed)

현재 공식 Connector는 React, React Hook Form, Ajv, Zod, TanStack Table 5종이며 package, 공개 문서, Live Demo가 일치합니다. Web Platform과 Contenteditable은 이후 플랫폼 계약을 번역하는 Adapter로 분리됐습니다.

이 이슈가 세운 Connector 승격 기준과 우선 포트폴리오 확보 방향은 현재 정본과 구현에 반영됐습니다. TanStack Virtual, React Aria, dnd-kit은 반복되는 app-local glue가 확인되기 전까지 후보일 뿐이므로 활성 구현 대기열로 남기지 않습니다. 실제 수요와 승격 조건이 생기면 그 근거를 가진 독립 이슈로 다시 다룹니다.

역사적 Goal Anchor와 당시 포트폴리오는 본문에 보존합니다.