TypeShade
규칙 11.19
11장, 대상과 오라클 테스트
The package root exports no IR builder. An author writes a program in "use typeshade"; the builder, its node classes and its declarators are typeshade/core/ir, a subpath for engines, tools and the compiler’s tests, with no stability promise before 1.0. The root keeps the IR’s types and the readers a tool needs to inspect what compile() returns.
규칙 본문과 그 아래 항목은 설계 문서에 적힌 컴파일러 원문이라 한국어 페이지에서도 영어로 둡니다.
근거
the root export is where a reader looks first (import { … } from 'typeshade', the editor’s completion list, the API reference’s first page). While the builder is there, the authoring guide, the site and every completion list keep teaching a second language beside "use typeshade". Code that builds IR (an engine’s generated shaders, the compiler’s tests, the registry examples) keeps one home for it, the subpath.
출처
change 0060 in changes/; docs/roadmap.md 0.8 item 24.
검증 방식
테스트로 확인합니다. 테스트나 게이트 스크립트, CI 워크플로가 이 규칙을 가리키고, 아래 파일 가운데 하나라도 규칙을 더는 가리키지 않으면 추적 검사가 실패합니다.
컴파일러가 이 규칙을 적용하는 곳을 규칙이 직접 적은 내용입니다.
the explicit re-export list of src/index.ts; src/api-surface.test.ts, which holds the root to none of the builder’s values and typeshade/core/ir to all of them, and the baked src/__api__/surface.md (Rule 11.6).
커밋 91c2fe31에서 이 규칙을 확인하는 파일입니다. 파일마다 규칙을 처음 가리키는 줄로 연결했습니다.
함께 보기
소스
커밋 91c2fe31의 규칙 원문:
docs/language-design.md:1395(설계 문서)reqs/rules/RULE-1119.md(추적 항목)