Database saved-view와 편집 표현 책임을 정본 모듈로 수렴한다

[developer-1px]

Goal Anchor

• Outcome: Database의 saved-view, change contract, property control 책임이 각각 하나의 정본 모듈을 통해 확장된다.
• Done: DatabaseTableView와 DatabaseViewDocument의 병렬 모델을 제거하고, remote update가 전체 records를 비교하지 않으며, cell과 record panel이 같은 property control owner를 소비한다.
• Don’t: 기존 local document·legacy Zod records·remote resource 공개 사용 사례와 다섯 property type 동작을 깨지 않는다. Host/Demo에 domain 책임을 옮기거나 의미 없는 facade·전역 registry·자기 등록 lifecycle을 추가하지 않는다.

감사 근거

• json-document-editing/src/database.ts의 DatabaseTableView와 json-document-database/src/contracts.ts의 DatabaseViewDocument가 saved-view projection을 병렬 소유한다.
• json-document-database/src/database-hands.tsx가 DatabaseHand의 전체 records 결과를 JSON.stringify와 shallow diff로 역추론한다.
• database-hand.tsx의 cell editor와 database-hands.tsx의 record panel이 property type별 React control 선택을 각각 구현한다.
• 현재 canonical closure guard는 property value conversion 우회만 검사한다.

범위와 순서

1. Saved-view headless model과 mutation을 @interactive-os/json-document-editing에 확장하고 Hand의 병렬 model을 제거한다.
2. DatabaseHandChange가 변경 record와 patch 또는 동등한 canonical operation을 제공하게 하여 consumer-local diff를 제거한다.
3. property type별 React control 선택을 @interactive-os/json-document-database 내부 named canonical module로 수렴한다.
4. owner tests, API reference, Usage, source registration, recurrence guard를 갱신하고 모든 in-scope consumer를 이동한다.

완료 증거

• saved-view 모델과 mutation owner가 하나이며 기존 DatabaseViewDocument 병렬 계약이 남지 않는다.
• remote resource update path에 JSON.stringify 기반 record 탐색이 없다.
• cell과 record panel의 property type 분기는 한 canonical React module만 소유한다.
• Database Demo와 Zod connector Demo는 fixture·copy·layout·wiring만 소유한다.
• Editing·Database·Zod package test/typecheck/build, docs/API 검사, canonical closure guard, Database browser flow가 통과한다.
• 변경 production source LOC는 기능 삭제 없이 가능한 범위에서 순감소한다.

제외

• 새로운 table layout 장르 추가
• Database 외 domain의 일반화
• 배포 및 병합

[developer-1px]

작업 계획을 고정합니다.

• Owner first: Editing의 saved-view model/Intent를 확장하고 contract test로 고정
• Consumer migration: Database resource/runtime과 Hands를 canonical view 계약으로 이동
• Change contract: full-record diff를 canonical patch/change payload로 교체
• React owner: cell과 record panel의 property control 분기를 named module로 수렴
• Closure: public export, API reference, Usage/source registration, recurrence guard 갱신
• Verification: 관련 package test/typecheck/build, docs/API, closure guard, Database browser flow

제외 범위는 새 layout 장르, Database 외 일반화, 병합입니다.

[developer-1px]

중간 검증 결과입니다.

• Saved-view owner: DatabaseTableView.projection으로 통합하고 DatabaseViewDocument 병렬 모델 제거
• View UI owner: database-view-controls.tsx 하나를 DatabaseHand와 Database.ViewToolbar가 함께 소비
• Change contract: DatabaseHandChange.updates를 추가하고 remote path의 full-record JSON.stringify diff 제거
• Property UI owner: database-property-control.tsx 하나를 cell과 record panel이 함께 소비
• Closure: API reference, Usage, Demo source implementation closure, 세 재발 guard 갱신

최초 이슈 투영에서 감사 Packet A의 공통 view-control surface 항목이 본문에 충분히 드러나지 않았습니다. 이는 새 범위가 아니라 사용자가 승인한 감사 결과를 복원한 것이며, 위 공통 owner로 구현했습니다.

검증 완료:

• Database 13, Editing 72, Zod 8, Demo source 14 tests
• 관련 package/site typecheck, root build
• docs/API/canonical closure
• external kit: 17 tarballs + one-package import + browser
• Database Playwright: 3 passed
• 실제 Chrome Demo: grid, property edit, descending saved-view projection, console error 없음

Production source LOC는 새 파일 포함 +245/-386, net -141 LOC입니다.

[developer-1px]

PR을 열었습니다: #587

완료 증거:

• DatabaseTableView.projection 단일 saved-view owner
• DatabaseViewControls 단일 view-control owner
• DatabasePropertyControl 단일 property-control owner
• DatabaseHandChange.updates를 통한 canonical remote patch
• production source net -141 LOC
• package/site/docs/external-kit/browser 검증 통과

남은 작업은 PR CI 확인이며 병합은 승인 범위 밖입니다.

[developer-1px]

Database 선택 표시 후속 검증 결과입니다.

• 선택 상태는 배경만 소유하고, 현재 포커스는 셀의 :focus/:focus-within inset ring 하나가 소유하도록 정리했습니다.
• 상태 전환 시 table border를 바꾸지 않아 편집 전후 셀 크기가 동일합니다.
• 내부 input/select의 별도 focus shadow를 제거해 이중선을 없앴습니다.
• 브라우저 회귀 검사에 좌우 border 0, 셀 단일 ring, control ring 없음, 포커스 전후 bounding box 동일 조건을 추가했습니다.
• 기존 Site CI가 드러낸 정본 view controls와 source registration 기대값도 현재 구현에 맞춰 복구했습니다.

검증: Database 13 tests, Database typecheck, 관련 Chrome browser 5 scenarios 통과, 실제 /demo/database에서 편집 전후 196.703×42px 동일 및 console 오류 없음.

[developer-1px]

최종 원격 검증이 완료됐습니다.

• HEAD: f0d0b09767c0fc5cb3dc9cb0ba1119d0020a113c
• CI run: https://github.com/developer-1px/json-document/actions/runs/32992712558
• Plan, Package full release graph, External kit, Site build 및 전체 browser behavior 모두 통과
• PR #587은 open/CLEAN이며 병합은 승인 범위 밖이라 수행하지 않았습니다.
• 실제 Database Demo는 http://127.0.0.1:18779/demo/database에 변경 worktree HEAD로 열어 두었습니다.