설계 규칙
규칙 115개
컴파일러 설계 문서 docs/language-design.md의 규칙을 모두 모았습니다. 커밋 26de7be8의 추적 트리에서 읽어 왔습니다. 규칙은 "use typeshade" 파일을 쓰는 사람이나 컴파일러 자신을 제약합니다. 규칙 하나에는 요구 사항 하나와 그 이유, 출처, 컴파일러가 규칙을 적용하는 곳이 들어 있습니다.
추적 트리에 기록된 규칙별 검증 방식입니다.
- 테스트 규칙 107개: 테스트나 게이트 스크립트, CI 워크플로가 규칙을 가리킵니다.
- 구현만 규칙 2개: 구현만 규칙을 따르고, 아직 확인하는 테스트는 없습니다.
- 적용 전 규칙 1개: 설계 문서 부록 B에 아직 적용하지 않은 규칙으로 올라 있습니다.
- 리뷰 규칙 5개: 리뷰로 지키며, 확인하는 파일은 없습니다.
보장하는 것 페이지는 검증 방식마다 규칙을 모으고, 규칙마다 그 규칙을 확인하는 파일을 함께 싣습니다.
규칙 본문과 그 아래 항목은 설계 문서에 적힌 컴파일러 원문이라 한국어 페이지에서도 영어로 둡니다.
이전 고정 커밋 이후 바뀐 규칙
컴파일러의 추적 트리가 기록한 이전 고정 커밋 4dda5269(2026-10-04)와 이번 고정 커밋 26de7be8 사이의 변화입니다. 규칙의 지문(fingerprint)이 달라지면 바뀐 규칙으로 봅니다. 규칙 본문이나 규칙을 확인하는 파일이 바뀌면 지문이 달라집니다. 추가 0개, 삭제 0개, 변경 3개입니다.
변경
1. 소개
- 규칙 1.1 테스트
- A
"use typeshade"program must mean what the WGSL program it emits means, unless a rule in this document says otherwise. - 규칙 1.2 구현만
- GLSL ES 3.00 is a target of the compiler; it must not be the definition of a construct.
- 규칙 1.3 테스트
- The CPU oracle is the reference evaluation of the IR: where WGSL fixes a result, the oracle must produce that result, and where WGSL leaves room (§11), the oracle’s answer is one of the permitted ones.
2. 표면 이름의 출처
- 규칙 2.1 테스트
- Every author-facing name must come from exactly one of three sources:
- 규칙 2.2 테스트
- A compiler-internal name (§2.1) must not be authorable.
- 규칙 2.3 테스트
- A value sometimes has to cross between a representation the compiler chose and one the target has: an
f64and the twof32halves that carry it across an interface off32. - 규칙 2.4 테스트
- An ECMAScript name that has a WGSL meaning must lower to that meaning, and an ECMAScript name that has no WGSL meaning is still an ECMAScript name, whatever the backend expands it to.
3. 텍스트 구조와 이름
- 규칙 3.1 테스트
- A shader file must begin with the directive
"use typeshade"as its first statement. - 규칙 3.2 테스트
- A local variable, parameter, module constant or module variable may use any identifier TypeScript permits.
- 규칙 3.3 테스트
- A local variable, parameter, module constant or module variable named by a WGSL keyword or reserved word must receive a fresh backend spelling, with every reference rewritten.
- 규칙 3.4 테스트
- A local variable, parameter, module constant or module variable that collides with a GLSL ES 3.00 identifier restriction must be renamed consistently by the GLSL writer; helper function renaming retains its existing behavior.
- 규칙 3.5 테스트
- A name the compiler generates (the mangler, the type aliaser) must not be a keyword or reserved word of either target.
- 규칙 3.6 테스트
- A type name an author writes must be lowercase when WGSL declares it and capitalized when TypeShade declares it, so the case of a name says where its meaning comes from.
- 규칙 3.7 리뷰
- A new surface section must take the next free
§number indocs/use-typeshade-surface.mdas the current tree makes it, and a new diagnostic must take the next freeTS80xxcode insrc/compiler/ts/codes.ts. - 규칙 3.8 테스트
- A shader module that host code imports is named
*.shade.ts, and a host import of a.tsfile that begins with the directive under any other name must be refused with the rename. - 규칙 3.9 테스트
- A shader file may import what another shader file exports, by a relative specifier or, from a package, by the package’s name; the file a compile starts from and every shader file it imports, directly or through another, are one program, which emits one module, and each file keeps the scope TypeScript gives it.
4. 타입
- 규칙 4.1 테스트
- Every type an author writes must be a WGSL type under a TypeScript spelling, or a member of the f64 family (Rule 4.4).
- 규칙 4.2 테스트
- A type alias is another name for its target.
- 규칙 4.3 테스트
- A brand must be erased:
f32 & { readonly [m]: 'm' }and{ readonly __brand: 'm' }are the carrier type, and the brand must reach no emitted text. - 규칙 4.4 테스트
- The f64 family (
f64,vec2f64,vec3f64,vec4f64, the short spellingsvec2d,vec3d, andvec4dand, by type argument,mat2<f64>,mat3<f64>, andmat4<f64>) is the one numeric type family TypeShade adds that WGSL does not have. - 규칙 4.5 테스트
- A TypeScript type the GPU has no word for must be refused in one sentence naming the reason and what to write instead; the list is surface §28 and is not repeated here.
- 규칙 4.6 테스트
numberandbooleanmust not be written as shader types; a number on the GPU has a width, and the boolean is spelledbool.- 규칙 4.7 테스트
f16and thehspellings must not be authorable until the roadmap’s After 1.0 row is picked up; thef16capability may be declared through the EDSL and nothing an author writes uses it.- 규칙 4.8 테스트
- Every
matCxRwithCandRin 2, 3, 4 must be a type, and a square one must also answer tomatN.
5. 리터럴과 타입 결정
- 규칙 5.1 테스트
- An integer-written literal must take the integer type the position around it declares.
- 규칙 5.2 테스트
- A written number beside a typed peer in an arithmetic operator or a builtin call must take the peer’s kind; a written number beside an
f64or anf64vector must become anf64literal carrying the full double. - 규칙 5.3 테스트
- There is no implicit conversion between concrete types; an
i32beside au32, or an integer beside a float, must be refused with the cast to write. - 규칙 5.4 테스트
- A literal must fit the type it takes;
-1in au32position and2147483648in ani32position are refused as written. - 규칙 5.5 테스트
- A single float-written literal valued as a whole number may take a declared integer type in a declaration only; a return, an argument, and a field must not take that carve-out.
6. 선언과 리소스
- 규칙 6.1 테스트
- A resource must be written
declare const x: uniform<T>,declare const x: storage<T>,declare const x: storage<T, "read_write">, ordeclare const x: <texture or sampler type>. - 규칙 6.2 테스트
- A storage binding’s access mode is its second type argument:
storage<T>isvar<storage, read>andstorage<T, "read_write">isvar<storage, read_write>. - 규칙 6.3 테스트
- A top-level
constis a module constant: a scalar must fold to one value carried at double precision for the oracle and at the target’s precision for emit, and a vector, array, or struct must carry a constant-foldable expression every backend evaluates. - 규칙 6.4 테스트
- A pipeline-overridable constant must be written
const x: override<T> = defaultordeclare const x: override<T>. - 규칙 6.5 테스트
- A top-level
letis a module variable in the per-invocation (private) address space; workgroup memory must be writtenlet x: workgroup<T>; a module variable must take nodeclare. - 규칙 6.6 테스트
- An entry point’s inputs and outputs are explicit parameters and return values; every parameter and every field of an entry I/O struct must carry
@builtin("...")or@location(n), and the builtin name must be one WGSL defines for that stage and direction. - 규칙 6.7 테스트
- The attribute names the compiler reads are
@vertex,@fragment,@compute,@builtin,@location,@interpolate,@invariant,@blend_src, and@diagnostic(the last four since #168, surface §53 and §54); every other WGSL attribute is either inferred by the compiler or carried as an argument (@compute([64, 1, 1])carries@workgroup_size), and a decorator outside that list must be refused. - 규칙 6.8 테스트
- The byte layout the emitted module assumes for a resource and the layout
reflect()reports must agree byte for byte, under WGSL’s uniform and storage layout rules, and so must the layout the manifest carries (Rule 11.10); a vertex entry’s vertex buffer is one layout, its@locationinputs tightly packed in the order written, whichreflect().vertexand the manifest both report. - 규칙 6.9 테스트
- A struct must be the members written in it, in one of three spellings (
class,interface, atypeover an object literal). - 규칙 6.10 테스트
- A local
constbinds its name once and leaves what it holds as writable as TypeScript does. - 규칙 6.11 테스트
- The compiler adds one binding an author did not write for a
consolecall, and only when a compile asks for GPU recording (compile(src, { console: 'gpu' })):_console, aread_writestorage buffer ofstruct _Console { cursor: atomic<u32>, dropped: atomic<u32>, words: array<u32> }, at group 0, the first binding past the module’s own group-0 bindings, the slot the_fp64guard takes by the same rule (the guard, when there is one, comes one past it).
7. 표현식과 문
- 규칙 7.1 테스트
- An operator, a swizzle, an index, and a call must mean what WGSL’s typing table gives them.
- 규칙 7.2 테스트
- Where TypeShade lowers a TypeScript form to a WGSL form, the mapping must be a rule with a recorded divergence; the mappings today are:
- 규칙 7.3 테스트
- An empty
switchcase directly above a case with a body is one clause with several selectors (case 0: case 1:is WGSL’scase 0, 1:); an empty case with no case below it or directly abovedefault:, and an emptydefault:with a case after it, must be refused; a case body must not fall through into the body of a case below it. - 규칙 7.4 테스트
- A shift amount the compiler can fold must be in 0 to 31; a divisor the compiler can prove to be zero must be refused where the division is lowered.
- 규칙 7.5 테스트
- A
forloop must be counted: ani32oru32induction variable, a constant step, and an exit that compares the induction variable to a bound; the start and the bound may be runtime values, the loop body must not write the bound, and the step must move the variable toward the bound. - 규칙 7.6 적용 전
- A read of a local before its first assignment is zero on WGSL and on the CPU, and undefined on GLSL ES 3.00; the divergence is recorded and the author should assign before reading.
- 규칙 7.7 테스트
discardmust be written as a bare statement, the identifier alone (discard), and may stand in a fragment entry and in a helper no vertex or compute entry can reach.- 규칙 7.8 테스트
- The refusals of surface §28 (a union of two GPU types, a string type, a nullable, a mixed tuple, a rest tuple,
symbol, an intersection of carriers,instanceof,in) must apply to expressions as they do to types, each in one sentence. - 규칙 7.9 테스트
- An expression must be evaluated left to right, as TypeScript and WGSL both evaluate it, and a call that writes (its object, a module variable, a storage binding, an atomic location) inside a larger expression must take effect in that order on every target.
8. 함수와 진입점
- 규칙 8.1 테스트
- An entry point is a top-level function; an entry method on a class must be refused.
- 규칙 8.2 테스트
- A vertex entry must return the position, as a bare
vec4or as a struct with a@builtin("position")field; a fragment entry returns one@location(0)value, a struct of render targets, or nothing. - 규칙 8.3 테스트
- A builtin WGSL confines by stage may be used in an entry of a permitted stage, and in a helper that no entry of an excluded stage can reach.
- 규칙 8.4 테스트
- A function must not take part in a call cycle, directly or through other functions; the check reads the calls a body writes, and the calls a method call, an accessor and
newlower to, before any optimisation, so a call in a branch the optimizer would drop is a cycle too. - 규칙 8.5 테스트
- A collective operation (a derivative, an implicit-LOD texture sample, a barrier) must be in uniform control flow.
- 규칙 8.6 테스트
- An entry point must not be called from another function, and neither may a kernel function (Rule 8.22).
- 규칙 8.7 테스트
@computecarries the workgroup size as an array literal of one to three whole numbers,x,yandz, a missingyorzbeing 1, and the default is 64; every extent reaches the emitted@workgroup_sizeand the reflection, and a shape over WebGPU’s default compute limits must be reported as a warning.- 규칙 8.8 테스트
- A parameter an author writes must be passed by value; there must be no pointers and no reference parameters.
- 규칙 8.9 테스트
- Method dispatch must be static, and a generic function or class must be compiled once per set of type arguments the program uses (Rule 3.9).
- 규칙 8.10 테스트
- A method that writes its object (assigns to
thisor to a field, a component or an element of it, applies++or--to one, or calls such a method or reads such a getter onthis, on a field, a component or an element of it whatever class that field is, or throughsuper) must take the object by reference, and may return a value like any other method; a base’s body that a class calls throughsuperand that writes its object takes it by reference too, and so does the copy of a method that takes a function (Rule 8.18) when a function handed over writes the variable the call is on. - 규칙 8.11 테스트
- A
getorsetaccessor is a function of the module,Owner_get_xorOwner_set_x, which takes its object as a method does (Rule 8.10); a read ofo.xmust call the getter, and an assignment, a compound assignment,++and--must call the setter with the new value, the compound forms reading the old one through the getter. - 규칙 8.12 테스트
- A private name
#xmust be emitted without its#: a field as the struct memberx, a method asOwner_x, an accessor asOwner_get_xandOwner_set_x, a static field asOwner_x. - 규칙 8.13 테스트
- A static field must be a module constant
Owner_xwhen nothing in the program writes it, and a module variable in the per-invocation space (Rule 6.5) when something does; areadonlystatic is never written. - 규칙 8.14 테스트
- A constructor’s parameter property (
constructor(public x: f32), orprivate,protectedorreadonlyin place ofpublic) is a field of its class, at the constructor’s place among the members, which the constructor assigns from the parameter before the field initializers run. - 규칙 8.15 테스트
- A member declared
privatemay be named only inside the body of the class that declares it, and one declaredprotectedonly inside the bodies of that class and of the classes that extend it, on an object of the naming body’s own class or of one that extends it; a name either rule does not allow must be refused with the remedy. - 규칙 8.16 테스트
- An instance field that holds an arrow function or a function expression is a method of its class under the field’s name: the function’s parameters, return type and body are the method’s, an expression body is the value it returns, and
thisin it is the object, as it is in TypeScript. - 규칙 8.17 테스트
- A local function (a
constthat holds an arrow function or a function expression, or afunctiondeclaration, written inside a function’s body) is a function of the module named after the body that declares it (surface §14), and it may read and write the variables of the functions around it, as a TypeScript closure does. - 규칙 8.18 테스트
- A function whose parameter has a function type, written out (
f: (x: f32) => f32) or through a type alias of one, takes a function: a function declared at the top of the file or of a namespace, a method, a static method, a constructor, a field that holds a function (Rule 8.16) and a local function (Rule 8.17). - 규칙 8.19 테스트
- A function that writes no return type returns what its body does, as TypeScript infers it: a function of the file or of a namespace, a local function (Rule 8.17), each instance of a generic function (Rule 8.9) and of a function that takes a function (Rule 8.18), a method, a getter and a field that holds a function (Rule 8.16) take the type of their first
returnwith a value, thereturns after it are typed against that type as against a written one, and one with no suchreturnreturns nothing. - 규칙 8.20 테스트
- A function a host file can call through an import of its module is an exported function that is not an entry point, is not generic, takes no function, has a host value (Rule 8.21) for each parameter and for its result, and reaches, through the calls of its body, no binding, no workgroup variable and no builtin only a GPU computes (a derivative, a barrier, an atomic, an implicit-LOD texture sample).
- 규칙 8.21 테스트
- A host call passes and returns host values by value: an
f32,f64,i32oru32is anumber, aboolaboolean, a vector areadonlytuple of its components as an argument and a tuple as a result, a matrix a flat column-major array of its components, anarray<T, N>an array ofNhost values ofT, a struct an object of its fields, and anenummember its number. - 규칙 8.22 테스트
- A kernel function is an exported function that is not an entry point and takes at least one array with no size (
array<T>); its candidate loops are theforandfor…ofstatements at the top level of its body, and no other loop is ever a candidate. - 규칙 8.23 테스트
- A kernel function’s parameter of an array with no size is the caller’s storage, passed by reference: the body reads and writes its elements in place, reads its
.length, and cannot assign it whole; whether the body writes it decides its access. - 규칙 8.24 테스트
- An exported
@computeentry is called from host code asentry(bindings, workgroups).
9. 내장 함수와 TypeShade 확장
- 규칙 9.1 테스트
- Every builtin id the compiler can emit must be classified as portable (
PORTABLE_INTRINSICS) or as a row of theINTRINSICSregistry; an unclassified id must not reach a backend. - 규칙 9.2 테스트
- A builtin’s signature must be WGSL’s, checked at the call.
- 규칙 9.3 테스트
- A WGSL builtin GLSL ES 3.00 has no spelling for must be behind a capability, and the GLSL emit must fail closed on it.
- 규칙 9.4 테스트
- A
Mathmember and its free-function spelling must lower to the WGSL builtin of the same meaning; aMathmember with no WGSL builtin must be expanded into WGSL arithmetic and stays an ECMAScript name;Math.fround(x)isf32(x). - 규칙 9.5 테스트
- A function the file declares or imports (Rule 3.9) must win over a builtin of the same name, as a module-scope declaration hides a predeclared object in WGSL.
- 규칙 9.6 테스트
- The author-facing names of source (c) must be exactly the rows below; the table is shrink-only, and a name may join it only by Rule 13.6.
- 규칙 9.7 테스트
- A name must be added to the table in this order and in no other: the rationale is written into this section (and into Rule 4.4’s family for an f64 type), the row is added to
TYPESHADE_EXTENSIONSwith the same reason, the surface document gains or extends a§, andCHANGELOG.mdgains an entry under[Unreleased]. - 규칙 9.8 테스트
- A row, a declaration, a signature, an overload, or a member must never be added for a compiler-internal name (§2.1), under its own id, under an allowed id, or under a new spelling that denotes the same thing.
10. 확장과 기능
- 규칙 10.1 테스트
- A
"use typeshade"file must not spell a WGSLenableorrequiresstatement. - 규칙 10.2 테스트
- The compiler must derive
requiredFeaturesfrom the module and must report them throughreflect(), with every implied capability included. - 규칙 10.3 테스트
- A GLSL ES 3.00 emit that lacks a capability’s row must fail closed with the target sentence, which opens
backend 'glsl-es300' cannot emit this moduleand endsmissing capabilities: <ids>; on a module with a render entry that is aTS8015warning that leaveswgslin place, and on a compute-only module it is silence,glslbeingundefined. - 규칙 10.4 테스트
- Every capability must have a witness: a module shape an author can write that uses the feature; a declarable capability with no witness is recorded as such and never advertised as usable.
- 규칙 10.5 테스트
- A GLSL lowering of a WGSL-only feature (the family #130 to #139: 1d, multisampled, depth read both ways, gather, cube array, storage texture, read-write storage, atomics, and barriers) is deferred by the maintainer, and must not be written until the deferral is lifted.
11. 대상과 오라클
- 규칙 11.1 테스트
- There must be one IR, and the WGSL writer, the GLSL ES 3.00 writer, and the CPU oracle must consume it over one shared tree walk; a new emit feature must go into the shared walk, or the oracle and the GLSL writer drift.
- 규칙 11.2 테스트
- A divergence between targets, or between a target and the oracle, must be measured on Tint and on a WebGL2 driver before it is kept, and recorded where the emit is decided: a comment on the
INTRINSICSrow with the measured text, and a row of the determinism report (surface §38) where the results may differ. - 규칙 11.3 테스트
- Every registered example must compile on Tint and, where the module has a GLSL row for each capability it needs, on a WebGL2 driver; an example that is WGSL-only says so with
renderable: falseand a stated reason. - 규칙 11.4 테스트
- An emit golden is a reviewed artifact: a change to
examples/__emit-goldens__/must be read as a diff and must not be re-baked as a rubber stamp. - 규칙 11.5 구현만
- Where WGSL fixes a result and GLSL ES 3.00 does not, the oracle must follow WGSL; where a GLSL spelling answers differently on an input WGSL settles, the determinism report must list the operation as
target. - 규칙 11.6 테스트
- The public API surface (
src/__api__/surface.md) is generated and must not be edited by hand; an exported name or type may change only with a re-bake. - 규칙 11.7 테스트
- The CPU tier, which runs a host call of a module’s function and, where there is no GPU tier, the invocations of an entry a host calls and the pixels of a fragment entry a host draws (Rule 8.24), is the oracle’s generated code (
generateModuleJs) atf32precision, written into the module the bundler reads as module code, with nonew Function, over the op library alone,typeshade/runtime/internal. - 규칙 11.8 테스트
- A kernel function’s call (Rule 8.21) runs on the first tier of
configure({ prefer })that can run it, WebGPU, WebGL2 and the CPU tier being the default order: WebGPU when the function lowers (Rule 8.22) and there is a device, WebGL2 when every loop writes one array of 4-byte elements (f32,i32,u32) at exactlyiand every scalar parameter is a number or a vector, each loop one fragment program into anR32UItarget that starts out holding the array, so an iteration that writes nothing leaves its element, and the CPU tier always; a list of one tier makes that tier required, and a call no tier on the list can run throws anErrornaming each tier’s reason. - 규칙 11.9 테스트
- A
consolecall computes nothing a shader reads: its arguments must be evaluated once, in order, on every target, and the call then delivers an event,{ method, args, span, invocation }. - 규칙 11.10 테스트
- A compiled program’s manifest, what
packModule()returns and what the default export of a module’s host import is, must be one JSON object that carries its schema (schema, 1) and the package version that wrote it (compiler); each binding with its group and slot, its resource inreflect()’s vocabulary, the stages that reach it, and a buffer’s byte layout with every offset, size and stride under the rule of its space (Rule 6.8), the_fp64guard the emit adds among them; each entry with its stage, its workgroup size, its inputs and outputs with their locations, builtins and interpolation, the bindings it reaches and which it writes, a vertex entry’s vertex buffer, and its line; the overrides and the WebGPU features; withconsole, the recorded variant, its WGSL, its log table and its bindings; withir, the program as portable IR and the package version that wrote it, which emitted again gives every other field byte for byte; and what the WebGL2 tier uses, each full-screen fragment entry’s GLSL ES 3.00 program, block names and texture-sampler pairs, and each storage array’s data texture. - 규칙 11.11 테스트
- The program runtime,
typeshade/runtime, loads a manifest (Rule 11.10) and runs its entries on WebGPU, on the host’s device or on one it requests with the features the programs need; its module closure must hold no file ofsrc/compiler/and no package, and its bundle must stay within the size budgetscripts/bundle-budget.jsonrecords. - 규칙 11.12 테스트
- An integer division, remainder and shift, and a float’s conversion to an integer, must give WGSL’s answer on GLSL ES 3.00 for every input WGSL settles: the GLSL writer spells each through a helper that settles the inputs GLSL ES 3.00 leaves undefined, and uses the bare operator only where the operands cannot reach one.
12. 진단
- 규칙 12.1 테스트
- A diagnostic must name the offending thing and the remedy in at most two sentences: the first states the mistake, and the second, when there is one, states the remedy or the reason.
- 규칙 12.2 리뷰
- A code must be
TS8followed by a sequential number in the order codes were added, or a number from a block handed to a parallel branch (Rule 3.7), whose unused numbers stay a gap. - 규칙 12.3 테스트
- Severity must follow the target’s role: a program WGSL refuses must be an error; a shortfall of GLSL ES 3.00 on a module with a render entry must be a warning that leaves
wgslin place; a compute-only module’s GLSL shortfall must be no diagnostic at all. - 규칙 12.4 테스트
- One mistake reads as one diagnostic; a refusal must not be followed by further diagnostics about the same mistake.
- 규칙 12.5 테스트
- The message text is part of the contract: a test that pins a refusal must assert the code and the text, and a change to the text is a change to the surface.
- 규칙 12.6 테스트
- A requirement the front end can check must be checked at the front end, in the author’s words, and not left to Tint or a driver.
- 규칙 12.7 테스트
- The language service and the compiler must name one vocabulary: the ambient library’s declarations are derived from the compiler’s own tables and never retyped, a builtin’s overloads from Tint’s
core.defthrough the TypeShade overlay, and a program the compiler accepts must draw no error in the editor or intshc check.
13. 변경 관리
- 규칙 13.1 리뷰
- An issue or pull request that changes what an author can write must cite the rule of this document it rests on.
- 규칙 13.2 리뷰
- A change the rules do not cover must change the rules first: the rule is written or amended in this document, in the same pull request, before the surface moves.
- 규칙 13.3 테스트
- A design that a target might refuse must be measured on Tint, on a WebGL2 driver, or on a device before it is kept, and the measured text must be recorded in the plan and in the code comment.
- 규칙 13.4 테스트
- Every change must pass the mechanical gates:
bun run build;bun run test, withsurface-names.test.ts,intrinsic-coverage.test.ts,capability-reachability.test.ts,determinism.test.ts,api-surface.test.ts,emit-reflection-conformance.test.ts, and the emit goldens among them;bun run gate:compile; the docs snippet testsrc/compiler/ts/doc-snippets.test.ts, which compiles every snippet of the surface document. - 규칙 13.5 리뷰
- A hot-spot file must be edited only after reading what the branch already did to it, and a claim of a
§number, aTS80xxcode, or anINTRINSICSrow must be made in the issue before the branch is opened. - 규칙 13.6 테스트
- A new author-facing name must be added only by its source: a WGSL name by citing the specification section that declares it, and an ECMAScript name by citing the
Mathorconsolemember it is. - 규칙 13.7 테스트
- The extension table must shrink when WGSL grows a builtin or a type a row was standing in for, or when a spelling is withdrawn; the row must be deleted, the surface document must say so, and the CHANGELOG must record it.
- 규칙 13.8 테스트
- Every change to the surface must carry a CHANGELOG entry under
[Unreleased]in the house style (a bold lead naming the feature and the § or roadmap item, then what an author can now write, what each target emits, what is refused and how, and what was measured) and a surface§whose snippets compile. - 규칙 13.9 테스트
- A published version must follow Semantic Versioning 2.0.0, and before
1.0.0the minor is the breaking position: a breaking change must ship only in a new0.N.0, and a0.N.Pmust only fix and add. - 규칙 13.10 테스트
- A change that keeps a program compiling and makes it compute something else must ship in two steps, and the second must come no earlier than the next breaking release after the first step’s release was published (the next minor before
1.0.0, the next major after it).