[Feat] Modifier.Node KSP 코드젠 + Maven Central 배포 설정

[sonms]

@ModifierNodeFactory 를 붙인 Modifier.Node 서브클래스에서 ModifierNodeElement 와
Modifier 확장 함수를 KSP 로 생성한다. composed { } 를 벗어나려 할 때 마주치는
보일러플레이트 벽(손코드 7줄 → 55줄)을 없애는 것이 목적이다.

무엇이 들어왔나

모듈	종류	설명
:modifier-node-annotations	Kotlin JVM · 배포	어노테이션 4종 + InvalidationScope. 전부 SOURCE retention
:modifier-node-processor	Kotlin JVM · 배포	KSP 프로세서. KotlinPoet 으로 Element + 확장 함수 방출
:modifier-node-sample	Android Library · 내부	예제 5종 + Robolectric 계약 테스트
:app	—	라이브 데모 탭 (gridOverlay, squareThumbnail)

어노테이션: @ModifierNodeFactory, @Invalidates, @SkipWhenFalse/@SkipWhenTrue, @OnChange.

설계 판단

• 생성된 update() 는 Measure > Placement > Draw 계층을 접는다 — 켜진 것 중 상위 하나만 호출
• Element 는 항상 internal — ABI 에는 Modifier 확장 함수 하나만 남는다
• @Invalidates 사용 시 shouldAutoInvalidate = false 선언을 KSP 가 강제한다.
  없으면 Compose 자동 무효화 때문에 no-op 이 되는데 codegen 은 노드 클래스를 수정할 수 없다
• 성능 주장은 낮춰 잡았다 — 실질 가치는 보일러플레이트 제거 + equals 안정성 + ABI 축소

배경은 ARCHITECTURE.md, composed 와의 비교는 modifier-node-sample/COMPARISON.md.

배포 설정

io.github.sonms:modifier-node-annotations / modifier-node-processor 0.0.1.
:modifier-node-sample 과 :app 은 내부용이라 제외.

• publish.yml: 태그 패턴 2개 추가, allowlist 를 case 로 교체, 테스트 태스크 분기
• ci.yml: 세 모듈 조립 + sample release 테스트 추가
• dokka.yml + docs/index.html + README.md / README_KO.md

vanniktech 0.36.0 → 0.34.0. 0.36.0 은 Kotlin JVM 모듈에 적용할 때 Kotlin 2.2.0+ 를
요구하는데 이 프로젝트는 2.0.21 이다. Kotlin 을 올리면 KSP·Compose 컴파일러까지 따라
올라가야 해서 범위를 벗어난다. 0.34.0 에서 네 모듈 모두 publishAndReleaseToMavenCentral
이 정상 생성되는 것을 확인했으므로 기존 wheelpicker / ratingbar 릴리스 경로도 그대로다.

배포 전 점검에서 나온 버그 2건 (수정 포함)

1. :modifier-node-sample 의 testReleaseUnitTest 6개가 전부 실패하고 있었다.
   ui-test-manifest 가 debugImplementation 뿐이라 release 테스트 매니페스트에
   ComponentActivity 가 없었다. CI 가 debug 만 돌려서 드러나지 않았다.
2. 에러를 내고도 파일을 생성하는 경로 2개. 특히 @Invalidates(Measure) 를 Draw 전용
   노드에 붙이면 컴파일되지 않는 invalidateMeasurement() 호출을 방출했다.
   둘 다 "하드 에러면 방출 중단" 으로 통일.

또 기존 publish.yml 이 :$MODULE:testReleaseUnitTest 를 고정 호출해서, JVM 모듈 태그를
추가만 했다면 릴리스가 그 자리에서 멈췄을 것이다. 모듈 종류별 분기로 수정했다.

검증

• 두 모듈 publishMavenPublicationToMavenLocal → jar · sources · javadoc · POM · .asc 10개 파일 생성
• Dokka 적용 후 javadoc jar 2개 → 106개 파일 (어노테이션 4종 문서화). Maven Central 은
  릴리스 버전을 덮어쓸 수 없어 배포 전에 붙여야 했다
• 프로세서 에러 경로 7종을 잘못된 입력으로 직접 확인 — 전부 정확한 소스 위치에 보고
• 태그 파싱 로직 bash 검증, CI 명령 로컬 전체 통과

머지 방식

--no-ff merge commit 으로 부탁드립니다. 조사 과정을 squash 하지 않고 남긴다 —
특히 @Invalidates 의 파라미터 단위 invalidation 을 한 차례 "불가능" 이라 잘못
결론냈다가 정정한 이력이 히스토리와 ARCHITECTURE.md 부록 B 에 함께 남아 있다.

머지 후

태그를 순서대로 푸시하면 publish.yml 이 업로드부터 릴리스까지 자동 처리한다.
processor 의 POM 이 annotations 좌표를 참조하므로 annotations 를 먼저 올리고,
Central 반영을 확인한 뒤 processor 를 올린다.

modifier-node-annotations-v0.0.1
modifier-node-processor-v0.0.1

🤖 Generated with Claude Code

https://claude.ai/code/session_01HnjkW5FJVRxQB6v5Kjj1pK