Skip to content

docs: document PathKey encoding and immer performance considerations (#14 #15) - #31

Merged
ayden94 merged 1 commit into
mainfrom
docs/path-key-and-immer
Jul 24, 2026
Merged

docs: document PathKey encoding and immer performance considerations (#14 #15)#31
ayden94 merged 1 commit into
mainfrom
docs/path-key-and-immer

Conversation

@ayden94

@ayden94 ayden94 commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Summary

2개 P1 이슈를 문서화로 해결 (실제 최적화는 벤치마크 후 필요 시 진행).

Resolves #14
Resolves #15

Rationale

두 이슈 모두 성능 최적화 제안이지만 실제 벤치마크 없이는 추정에 불과. 현재 동작이 정확하고 가독성이 좋으므로, 설계 의사결정과 향후 최적화 경로를 문서화하여 해결.

Changes

#14 Path key JSON.stringify

  • README.md/README.ko.md FormPath 섹션: JSON.stringify/JSON.parse를 NUL separator 인코딩으로 대체 가능하다는 점과 벤치마크 권고 추가

#15 Immer runtime 의존성

  • README.md/README.ko.md FormStateWriter 섹션: immer (~5KB)를 spread 기반 업데이트로 대체 가능하다는 점과 벤치마크 권고 추가

Verification

  • 문서만 변경되어 typecheck/test/build 영향 없음

Notes

  • 머지 금지 — 사용자 검증 후 머지 지시 예정

…14 #15)

- FormPath section: note JSON.stringify/parse could be replaced with
  NUL-separator encoding for large forms; benchmark before migrating
- FormStateWriter section: note immer (~5KB) could be replaced with
  spread-based updates for flat record; benchmark before migrating
- No code changes — design decision documentation

Resolves #14
Resolves #15
@ayden94
ayden94 merged commit 18bd869 into main Jul 24, 2026
1 check passed
@ayden94
ayden94 deleted the docs/path-key-and-immer branch July 24, 2026 01:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant