qwreey
32e9db0773
다른 에이전트 감사와 사용자 트레이싱으로 69466ab에서 나온 지적 반영.
핵심 알고리즘(하강 diff/인덱스 체인)엔 버그 없음이 확인됐고, 의사코드와
문서 정합성에서 나온 것들:
1. `nameClaims`가 Relate의 3-인자 계약 위반(`GetStrong(inst)` /
`SetStrong(inst, claims)`) → `(inst, name[, key])`로 정정. 같은 커밋의
`tagNameMap`은 이미 3-인자였어서 대조로 드러남.
2. TagHandler가 생존 이름의 홀더를 비웠다가 곧이은 process에서 `addTag`를
헛되이 재호출 — 문서 서술("addTag 자체가 안 불림")과 정반대였음.
생존 이름은 홀더를 유지하도록 정정하고, `addTag`도 `removeTag`처럼
배치 호출로 통일(`{string}` 시그니처 도입 근거와 맞춤).
3. 그룹 process의 부분 실패 경로(순회 중 충돌 error) 문서화 — 피해가
인스턴스 수명으로 한정되고 재현이 시끄럽게 반복됨을 트레이싱으로
확인, 롤백 장치는 안 넣고 question.md 3번에 열어둠.
doc-check.py: REF 정규식이 줄 단위라 파일명과 절 제목이 줄바꿈에 걸친
인용을 통째로 놓치고 있었음(이번 2단계 분할뿐 아니라 9차 세션 1단계
분할 stale까지 숨어 있던 원인). 파일 전체 스캔 + 개행 허용으로 고치고,
새로 드러난 stale 참조 30여 곳을 dispatch-core/event-plan/ref-plan/
typing-limits로 정정. 오탐 없음(참조–인용 스팬 3줄 미만 전수 확인).
부수: 세션 로그에 리뷰 라운드 절 추가(커밋 메시지 줄수 오기 2291→1213
정정 포함), CLAUDE.md의 스파이크 이동 서술에 `19` 누락 보강,
luau-test/README 상단 요약표를 STATUS.md와 동기화.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KckSawrsJSJmDBcSojJPxZ
86 lines
6.3 KiB
Markdown
86 lines
6.3 KiB
Markdown
# `OnChange` 특수 키 — `GetPropertyChangedSignal` 바인딩
|
|
|
|
**상태**: base — 2026-08-10 세션에서 확정. quad-roblox 전용(값 타입/API
|
|
레이어 없음, `Attribute`와 같은 패키지 배치). **[2026-08-11 아홉 번째
|
|
세션 후속]** `AttributeKey`와 동일한 이름별 weak 캐시로
|
|
`OnChange(a) == OnChange(a)` 동등성도 확정 — 아래 "확정" 절 참고.
|
|
|
|
## 문제
|
|
|
|
이벤트 바인딩은 이미 평범한 문자열 키 + reflection(`GetEventsOfClass`)으로
|
|
확정돼 있음(`bind-system-plan.md`의 "인스턴스 생성 / 이벤트 네이밍 인체공학"
|
|
절) — `inst[key]`가 이미 `RBXScriptSignal`이라 그냥 `Connect`하면 됨.
|
|
`GetPropertyChangedSignal(name)`은 이 패턴이 그대로 안 통함: 프로퍼티 이름을
|
|
인자로 받아 **별도 메소드 호출**로 시그널을 얻어야 하고, 그 프로퍼티 이름은
|
|
이미 "값 세팅" 키 네임스페이스(`Frame.Position = x`)와 겹침 — 값 타입만으론
|
|
"세팅"과 "변경 리스닝"을 구분할 방법이 없어서 별도 마커가 필요함.
|
|
|
|
## 확정
|
|
|
|
- **`OnChange(propertyName): OnChangeKey`** — 프로퍼티 이름을 감싸는 DI 키
|
|
팩토리, `AttributeKey(name)`/`Tag(...)`와 같은 패턴(`AttributeKey`는 구
|
|
`Attribute` — 2026-08-11 아홉 번째 세션에 여러 Store를 묶는 그룹
|
|
`Attribute(...)` 프리미티브가 신설되며 이름 충돌 방지로 리네임됨,
|
|
`base/attribute-plan.md` 참고). 사용 예:
|
|
`Frame { [OnChange "Position"] = function(v: UDim2) ... end }`.
|
|
- **제네릭 타입 파라미터 없음 — `OnChange<<T>>` 같은 타입 파라미터화는 안
|
|
함.** 콜백 파라미터 타입은 호출부가 인라인으로 직접 명시
|
|
(`function(v: UDim2) ... end`) — Luau가 그 타입이 실제 프로퍼티 타입과
|
|
일치하는지 검증해주지 않음. 이미 확정된 "이벤트 바인딩은 콜백 시그니처를
|
|
Luau가 검증 못 하는 대가를 받아들인다"는 결정(`event-plan.md` "이벤트
|
|
바인딩 — `On.EventName` 도트액세스 안 씀" 절, "타입 안전성을 어느 정도
|
|
포기하는 대가")과 같은 급의 트레이드오프라 새로 정당화할 것 없음 — 오히려
|
|
`AttributeKey<<T>>`처럼 제네릭으로 정확히 맞추려는 시도는 이벤트 키보다 더
|
|
엄격한 걸 요구하는 셈이라 일관성이 깨짐.
|
|
- **기각안 — 프로퍼티별 정적 `OnChange.PropertyName` 전량 코드 생성**:
|
|
`archive/onchange-per-property-codegen-rejected.md` 참고. Attribute의
|
|
"제네릭 + 자주 쓰는 것만 정적 지름길" 절충과 겉보기엔 비슷해 보이지만
|
|
규모가 다른 문제라 기각.
|
|
- **패키지 경계: 전부 quad-roblox** — `Handlers/OnChange.luau`에 `OnChange(name)`
|
|
키 팩토리와 Handler를 같이 둠. **[정정, 2026-08-13 열네 번째 세션]**
|
|
예전엔 "단일 키 `AttributeKey.luau`와 같은 배치"라고 적었으나 그
|
|
`AttributeKey`는 같은 세션에 **quad-base로 옮겨갔음**(부기가 엔진 지식을
|
|
요구하지 않아서, `base/attribute-plan.md` "패키지 배치" 절) — `OnChange`가
|
|
quad-roblox에 남는 이유는 그것과 달리 **`GetPropertyChangedSignal`
|
|
자체가 로직**이라 "한 줄 op 주입"으로 줄어들지 않기 때문
|
|
(`base/dispatch-core-plan.md` "base가 소유하는 핸들러와 주입되는 엔진
|
|
op" 절의 분할 기준).
|
|
`GetPropertyChangedSignal` 자체가 Roblox 엔진 API라 base에
|
|
둘 이유가 없음 — Tag처럼 백엔드 무관한 값/API 레이어가 따로 있는 경우와
|
|
다름.
|
|
- **`process(inst,k,v,index)`**: `inst:GetPropertyChangedSignal(name):Connect(
|
|
function() v(inst[name]) end)` 후 **그 Connection을 `:Disconnect()`하는
|
|
클로저를 반환**. 일반 `Handlers/Event.luau`와 같은 결(Connection
|
|
관리뿐, 새 메커니즘 없음). **[정정, 2026-08-13 다섯 번째 세션]** 원래는
|
|
별도 `retract(inst,k,v)` 필드가 Disconnect를 담당한다고 적혀 있었으나,
|
|
Handler 계약이 `process` 1-메소드로 합쳐지며 그 로직이 반환 클로저로
|
|
이동 — `connection`은 `process`의 로컬 변수를 클로저가 upvalue로 그대로
|
|
캡처하므로 별도 `Relate` 저장/재조회가 필요 없음(`dispatch-core-plan.md`
|
|
"핸들러 내부 상태 저장" 절).
|
|
- **`State<function>` 지원 — 새 메커니즘 없음.** 이미 확정된 "이벤트도
|
|
store-bind 가능 — `false`로 disconnect" 메커니즘(`bind-system-plan.md`)이
|
|
`OnChange` 키에도 그대로 적용됨 — `OnChangeHandler`는 `process`(와 그
|
|
반환 클로저)만 구현하면 되고, `v`가 State/Source면 범용 `Dispatch/StoreBind.luau`가 알아서
|
|
언랩+재귀 재-dispatch해서 `process`를 다시 호출해줌. `OnChange` 전용 분기
|
|
불필요.
|
|
- **`OnChange(name)`도 `AttributeKey`와 같은 이름별 weak 캐시 적용
|
|
(2026-08-11 아홉 번째 세션 후속)** — `AttributeKey<<T>>(name)`이
|
|
이름만으로 캐시되는 것과 정확히 같은 모양(이름 → 키, 다른 가변 정보
|
|
없음)이라 같은 기법 그대로 재사용(`base/attribute-plan.md` "동등성"
|
|
절). `State<function>`이 되더라도 문제 없이 작동하고(캐시는 키
|
|
객체 자체의 identity만 다루지, 그 키에 바인딩된 값/콜백과는 무관),
|
|
`OnChange "a" == OnChange "a"`가 외부에서 관찰 가능해지는 것도
|
|
의도적으로 허용해도 되는 동작 — 문제 없음(사용자 확인). `Handlers/OnChange.luau`
|
|
안 `OnChange(name)` 팩토리에 `AttributeKey`와 동일한 캐시 구현.
|
|
|
|
## 다른 특수 DI 키와의 대조
|
|
|
|
| | 소스 | 값 타입 | 패키지 경계 |
|
|
|---|---|---|---|
|
|
| 이벤트(`MouseButton1Click = fn`) | `inst[key]`가 이미 Signal | 콜백, 타입 미검증 | quad-roblox(`Handlers/Event.luau`) |
|
|
| `AttributeKey(name)` | 주입된 `setAttribute` op | 값(제네릭 또는 정적 타입 패밀리로 타입 파라미터화) | **quad-base**(키+Handler, 2026-08-13 열네 번째 세션 재배치) / 엔진 op만 백엔드 |
|
|
| `OnChange(name)` | `GetPropertyChangedSignal(name)` | 콜백, 타입 미검증(제네릭 없음) | quad-roblox(`Handlers/OnChange.luau`) |
|
|
|
|
`OnChange`가 Attribute처럼 제네릭화되지 않은 이유는 "콜백을 받는다"는
|
|
성질이 Attribute(값을 직접 받음)보다 이벤트에 더 가깝기 때문 — 카테고리가
|
|
헷갈리지 않도록 표로 명확히 구분해둠.
|