quad/.claude/session/2026-08-12-15-slot-in-slot-relate-scope-tag-splice-additions.md

2026-08-12 열다섯 번째 세션 — Slot-in-Slot relate 범위 확인, Tag:Added vararg, Slot:Splice 신설

사용자가 지난 며칠간 확정한 설계를 4개 항목으로 재확인, 1개는 문서 불일치를 발견해 수정, 2개는 새 CRUD/API를 추가.

확인만 하고 넘어간 것 (문서와 일치, 변경 없음)

1. Slot-in-Slot의 slotOwner/kSlotMap relate는 최상위 마운트에만 걸림. attachSlot의 중첩 재귀(slot-plan.md "Slot-in-Slot 중첩" 절)는 Dispatch.process를 다시 안 타고 직접 재귀 호출되므로, SlotHandler.process 안에서만 세팅되는 이 relate는 중첩 자식 Slot엔 전혀 안 걸림 — 완전히 별개 처리 확인(중첩 Slot의 중복마운트 방지는 별도의 전역 element weak-set이 담당, 서로 안 얽힘).
2. Animate의 실제 반환 타입은 State<Tween<T> | T>. CanAnimate가 거짓이면 Tween으로 안 감싸고 plain v를 그대로 반환하는 분기가 이미 tween-plan.md에 있음 — 확인만.
3. Slot의 retract는 전부 파괴, 포탈 없음. Extract/ExtractAll로 미리 빼낸 것만 예외 — 이미 확정된 그대로.

수정한 것

4. Tag:Added/:Removed가 문서상 단일 name만 받고 있었음 — vararg로 정정. 원래 Tag(a,b)를 Tag():Added(a):Added(b)(clone 2회)의 sugar로 서술했는데, 사용자가 태그 여러 개를 한 번에 걸 때 이름 개수만큼 clone+해싱이 반복되는 손해를 지적 — self-return 최적화(이미 걸려있으면 그냥 self 반환)도 검토했으나 매번 먼저 멤버십을 읽어야 해서 오히려 더 비싸 기각, 대신 Added(name, ...)/Removed(name, ...)로 vararg를 지원해 여러 이름을 단일 clone으로 처리하도록 변경(tag-plan.md).

추가한 것

5. Slot:Splice(index, removeCount, ...newElements): {T} 신설. ExtractAll은 이미 있었지만, 한 구간만 비파괴 제거+삽입하는 배치 연산은 없어서 Extract/Add를 요소 수만큼 반복하면 그때마다 개별 shift+recompute가 돌아 비용이 곱으로 커지는 문제가 있었음 — 시프트 1회+recompute 1회로 묶는 순수 최적화로 추가(새 능력이 아니라 기존 CRUD 반복으로도 재현 가능한 결과, 비용만 다름). 비파괴(제거분은 파괴 안 하고 반환) — 실제 물리 detach/reattach는 기존 base/roblox 패키지 경계 그대로 backend Handler 몫(slot-plan.md).