qwreey
d9898d6629
- quad-base/src: Void.luau(단일 no-op), Brand.luau(Brand() + 브랜드 인스턴스 15 + M2 is* 11), LifetimeHandle.luau(InitLifetimeHandle — 모듈 인스턴스에 영어 level 2 에러 스텁 4종), Ref.luau(.Value/.Revision/:Set/:Callback/:WeakCallback/:Uncallback, EpochBrand+RefBrand), init.luau 재export. Relate.luau는 타입만 quad-types에서 재export. - quad-types: Quad에 M2 첫 단위 탑레벨 값 + Ref<T>/RefCallback<T>/Relate/Epoch 타입. - test/mock.luau: installLifetime(quad) — lifecycle-pattern.md (0)/(1) 스케치 그대로, Destroy가 모든 Connection을 끊도록 보강(gcconn 판정 근거). - scripts/test.sh: spec.* 수집 + luau-analyze(src/spec/mock). 전부 ALL PASS, analyze 0건. - 발견 ①: H-165 pesde shim은 생성 시점 export 타입만 안다(project-setup-plan.md), H-166 Ref.Revision 초기값 0(ref-plan.md). ROADMAP 공통 기반 체크박스 완료 표기. Co-authored-by: qwreey <me@qwreey.moe>
95 lines
3.2 KiB
Text
95 lines
3.2 KiB
Text
--[[ Relate 계약 — `.claude/base/relate-plan.md` "API (확정)" / "실제 구조 (확정, 2026-08-08 세션)" ]]
|
|
|
|
local Relate = require("../src/Relate")
|
|
local Quad = require("../src")
|
|
|
|
-- strict 모드에서 `collectgarbage`는 선언 안 된 전역 — 표준 luau CLI엔 있다(Roblox엔 없음)
|
|
local collectgarbage = (_G :: any).collectgarbage :: () -> ()
|
|
print("=== 1. 네 메서드 — Strong/Weak는 서로 다른 슬롯, 같은 키라도 안 섞임 ===")
|
|
do
|
|
local r = Relate()
|
|
local inst = {}
|
|
r:SetStrong(inst, "k", 1)
|
|
r:SetWeak(inst, "k", {})
|
|
assert(r:GetStrong(inst, "k") == 1, "GetStrong reads what SetStrong wrote")
|
|
assert(type(r:GetWeak(inst, "k")) == "table", "GetWeak reads what SetWeak wrote")
|
|
assert(r:GetStrong(inst, "missing") == nil and r:GetWeak(inst, "missing") == nil, "unknown key is nil")
|
|
assert(r:GetStrong({}, "k") == nil and r:GetWeak({}, "k") == nil, "unknown inst is nil")
|
|
assert(Quad.Relate == Relate, "Relate must be re-exported on Quad")
|
|
print("PASS")
|
|
end
|
|
|
|
print()
|
|
print("=== 2. lazy 서브테이블 — 읽기는 쓰기를 유발하지 않음, Set이 처음 불릴 때만 생성 ===")
|
|
do
|
|
local r = Relate()
|
|
local inst = {}
|
|
local buckets = (r :: any).buckets
|
|
assert(r:GetStrong(inst, "k") == nil, "read on fresh relate")
|
|
assert(buckets[inst] == nil, "a read must not create the bucket")
|
|
r:SetStrong(inst, "k", true)
|
|
assert(buckets[inst] ~= nil and buckets[inst].StrongMap ~= nil, "SetStrong creates bucket + StrongMap")
|
|
assert(buckets[inst].WeakMap == nil, "WeakMap stays unmade until SetWeak")
|
|
r:SetWeak(inst, "w", {})
|
|
assert(buckets[inst].WeakMap ~= nil, "SetWeak creates WeakMap")
|
|
print("PASS")
|
|
end
|
|
|
|
print()
|
|
print("=== 3. 공유 메타테이블 — 모든 WeakMap이 같은 {__mode='v'} 객체 ===")
|
|
do
|
|
local r = Relate()
|
|
local a, b = {}, {}
|
|
r:SetWeak(a, "k", {})
|
|
r:SetWeak(b, "k", {})
|
|
local buckets = (r :: any).buckets
|
|
local mtA, mtB = getmetatable(buckets[a].WeakMap), getmetatable(buckets[b].WeakMap)
|
|
assert(mtA ~= nil and mtA == mtB, "WeakMap metatable is shared")
|
|
assert(mtA.__mode == "v", "WeakMap is weak-valued")
|
|
assert(getmetatable(buckets[a].StrongMap) == nil, "StrongMap has no metatable")
|
|
print("PASS")
|
|
end
|
|
|
|
print()
|
|
print("=== 4. Weak 값은 다른 곳에서 안 잡으면 GC됨, Strong 값은 살아남음 ===")
|
|
do
|
|
local r = Relate()
|
|
local inst = {}
|
|
do
|
|
r:SetWeak(inst, "w", {})
|
|
r:SetStrong(inst, "s", {})
|
|
end
|
|
collectgarbage()
|
|
collectgarbage()
|
|
assert(r:GetWeak(inst, "w") == nil, "weakly held value is collected")
|
|
assert(r:GetStrong(inst, "s") ~= nil, "strongly held value survives")
|
|
print("PASS")
|
|
end
|
|
|
|
print()
|
|
print("=== 5. inst는 항상 weak — inst를 놓으면 버킷째 사라짐 ===")
|
|
do
|
|
local r = Relate()
|
|
local buckets = (r :: any).buckets
|
|
do
|
|
local inst = {}
|
|
r:SetStrong(inst, "s", {})
|
|
end
|
|
collectgarbage()
|
|
collectgarbage()
|
|
assert(next(buckets) == nil, "bucket keyed by a dead inst must be collected")
|
|
print("PASS")
|
|
end
|
|
|
|
print()
|
|
print("=== 6. 비싱글톤 — 인스턴스마다 독립 ===")
|
|
do
|
|
local a, b = Relate(), Relate()
|
|
local inst = {}
|
|
a:SetStrong(inst, "k", 1)
|
|
assert(b:GetStrong(inst, "k") == nil, "separate Relate instances do not share buckets")
|
|
print("PASS")
|
|
end
|
|
|
|
print()
|
|
print("=== ALL PASS ===")
|