feat: Better errors for illegal arguments in shellless

[aleksanderkatan]

No description provided.

[github-actions]

📊 Bundle Size Comparison

🟢 Decreased	➖ Unchanged	🔴 Increased	❔ Unknown
0	326	9	0

👀 Notable results

Static test results:

No major changes.

Dynamic test results:

Test	tsdown
isBufferShorthand from typegpu.ts	1.69 kB ($${\color{red}+4.8\%}$$)

📋 All results

Click to reveal the results table (334 entries).

Test	tsdown
dataImportEverything.ts	80.13 kB (➖)
dataImportOneDirect.ts	40.68 kB (➖)
dataImportOneStar.ts	40.68 kB (➖)
functionWithUseGpu.ts	268 B (➖)
functionWithoutUseGpu.ts	24 B (➖)
importEntireLibrary.ts	259.62 kB ($${\color{red}+0.2\%}$$)
stdImportEverything.ts	112.90 kB (➖)
stdImportOneDirect.ts	62.25 kB (➖)
stdImportOneStar.ts	62.25 kB (➖)
tgpuImportEverything.ts	240.19 kB ($${\color{red}+0.2\%}$$)
tgpuImportOne.ts	240.20 kB ($${\color{red}+0.2\%}$$)
MissingBindGroupsError from typegpu.ts	1.29 kB (➖)
MissingLinksError from typegpu.ts	208 B (➖)
MissingSlotValueError from typegpu.ts	153 B (➖)
MissingVertexBuffersError from typegpu.ts	1.29 kB (➖)
NotUniformError from typegpu.ts	1.25 kB (➖)
ResolutionError from typegpu.ts	1.48 kB (➖)
Void from typegpudata.ts	675 B (➖)
abs from typegpustd.ts	78.92 kB (➖)
acos from typegpustd.ts	78.92 kB (➖)
acosh from typegpustd.ts	78.92 kB (➖)
add from typegpustd.ts	62.25 kB (➖)
align from typegpudata.ts	42.36 kB (➖)
alignmentOf from typegpudata.ts	38.78 kB (➖)
allEq from typegpustd.ts	64.65 kB (➖)
all from typegpustd.ts	64.65 kB (➖)
and from typegpustd.ts	64.65 kB (➖)
any from typegpustd.ts	64.66 kB (➖)
arrayLength from typegpustd.ts	11.31 kB (➖)
arrayOf from typegpudata.ts	42.57 kB (➖)
asin from typegpustd.ts	78.92 kB (➖)
asinh from typegpustd.ts	78.92 kB (➖)
atan2 from typegpustd.ts	78.92 kB (➖)
atan from typegpustd.ts	78.92 kB (➖)
atanh from typegpustd.ts	78.92 kB (➖)
atomicAdd from typegpustd.ts	12.70 kB (➖)
atomicAnd from typegpustd.ts	12.70 kB (➖)
atomicLoad from typegpustd.ts	12.68 kB (➖)
atomicMax from typegpustd.ts	12.70 kB (➖)
atomicMin from typegpustd.ts	12.70 kB (➖)
atomicOr from typegpustd.ts	12.70 kB (➖)
atomicStore from typegpustd.ts	12.69 kB (➖)
atomicSub from typegpustd.ts	12.70 kB (➖)
atomicXor from typegpustd.ts	12.70 kB (➖)
atomic from typegpudata.ts	714 B (➖)
bitcastU32toF32 from typegpustd.ts	60.02 kB (➖)
bitcastU32toI32 from typegpustd.ts	60.02 kB (➖)
bool from typegpudata.ts	10.84 kB (➖)
builtin from typegpudata.ts	44.92 kB (➖)
ceil from typegpustd.ts	78.92 kB (➖)
clamp from typegpustd.ts	78.92 kB (➖)
common from typegpu.ts	54.92 kB (➖)
comparisonSampler from typegpudata.ts	694 B (➖)
cos from typegpustd.ts	78.92 kB (➖)
cosh from typegpustd.ts	78.92 kB (➖)
countLeadingZeros from typegpustd.ts	78.92 kB (➖)
countOneBits from typegpustd.ts	78.92 kB (➖)
countTrailingZeros from typegpustd.ts	78.92 kB (➖)
cross from typegpustd.ts	78.92 kB (➖)
d from typegpu.ts	80.14 kB (➖)
deepEqual from typegpudata.ts	2.71 kB (➖)
degrees from typegpustd.ts	78.92 kB (➖)
determinant from typegpustd.ts	78.92 kB (➖)
disarrayOf from typegpudata.ts	12.80 kB (➖)
discard from typegpustd.ts	9.43 kB (➖)
distance from typegpustd.ts	78.92 kB (➖)
div from typegpustd.ts	62.25 kB (➖)
dot4I8Packed from typegpustd.ts	78.92 kB (➖)
dot4U8Packed from typegpustd.ts	78.92 kB (➖)
dot from typegpustd.ts	78.92 kB (➖)
dpdxCoarse from typegpustd.ts	10.28 kB (➖)
dpdxFine from typegpustd.ts	10.28 kB (➖)
dpdx from typegpustd.ts	10.28 kB (➖)
dpdyCoarse from typegpustd.ts	10.28 kB (➖)
dpdyFine from typegpustd.ts	10.28 kB (➖)
dpdy from typegpustd.ts	10.28 kB (➖)
eq from typegpustd.ts	64.65 kB (➖)
exp2 from typegpustd.ts	78.92 kB (➖)
exp from typegpustd.ts	78.92 kB (➖)
extensionEnabled from typegpustd.ts	12.36 kB (➖)
extractBits from typegpustd.ts	78.92 kB (➖)
f16 from typegpudata.ts	10.84 kB (➖)
f32 from typegpudata.ts	10.84 kB (➖)
faceForward from typegpustd.ts	78.92 kB (➖)
firstLeadingBit from typegpustd.ts	78.92 kB (➖)
firstTrailingBit from typegpustd.ts	78.92 kB (➖)
float16 from typegpudata.ts	37.76 kB (➖)
float16x2 from typegpudata.ts	37.76 kB (➖)
float16x4 from typegpudata.ts	37.76 kB (➖)
float32 from typegpudata.ts	37.76 kB (➖)
float32x2 from typegpudata.ts	37.76 kB (➖)
float32x3 from typegpudata.ts	37.76 kB (➖)
float32x4 from typegpudata.ts	37.76 kB (➖)
floor from typegpustd.ts	78.92 kB (➖)
fma from typegpustd.ts	78.92 kB (➖)
formatToWGSLType from typegpudata.ts	37.76 kB (➖)
fract from typegpustd.ts	78.92 kB (➖)
frexp from typegpustd.ts	78.92 kB (➖)
fwidthCoarse from typegpustd.ts	10.28 kB (➖)
fwidthFine from typegpustd.ts	10.28 kB (➖)
fwidth from typegpustd.ts	10.28 kB (➖)
ge from typegpustd.ts	64.65 kB (➖)
gt from typegpustd.ts	64.66 kB (➖)
i32 from typegpudata.ts	10.84 kB (➖)
identity2 from typegpustd.ts	43.23 kB (➖)
identity3 from typegpustd.ts	43.23 kB (➖)
identity4 from typegpustd.ts	43.23 kB (➖)
insertBits from typegpustd.ts	78.92 kB (➖)
interpolate from typegpudata.ts	42.36 kB (➖)
invariant from typegpudata.ts	42.73 kB (➖)
inverseSqrt from typegpustd.ts	78.92 kB (➖)
isAccessor from typegpu.ts	72 B (➖)
isAlignAttrib from typegpudata.ts	696 B (➖)
isAtomic from typegpudata.ts	696 B (➖)
isBufferShorthand from typegpu.ts	1.69 kB ($${\color{red}+4.8\%}$$)
isBuffer from typegpu.ts	98.11 kB (➖)
isBuiltinAttrib from typegpudata.ts	698 B (➖)
isBuiltin from typegpudata.ts	40.77 kB (➖)
isCloseTo from typegpustd.ts	64.66 kB (➖)
isComparisonSampler from typegpu.ts	65.49 kB (➖)
isData from typegpudata.ts	2.32 kB (➖)
isDecorated from typegpudata.ts	699 B (➖)
isDisarray from typegpudata.ts	1.62 kB (➖)
isInterpolateAttrib from typegpudata.ts	702 B (➖)
isLazy from typegpu.ts	68 B (➖)
isLocationAttrib from typegpudata.ts	699 B (➖)
isLooseData from typegpudata.ts	1.67 kB (➖)
isLooseDecorated from typegpudata.ts	1.63 kB (➖)
isMutableAccessor from typegpu.ts	80 B (➖)
isPackedData from typegpudata.ts	37.83 kB (➖)
isPtr from typegpudata.ts	693 B (➖)
isSampler from typegpu.ts	65.48 kB (➖)
isSizeAttrib from typegpudata.ts	695 B (➖)
isSlot from typegpu.ts	68 B (➖)
isTexture from typegpu.ts	65.47 kB (➖)
isTgpuComputeFn from typegpu.ts	76 B (➖)
isTgpuFn from typegpu.ts	706 B (➖)
isTgpuFragmentFn from typegpu.ts	77 B (➖)
isTgpuVertexFn from typegpu.ts	75 B (➖)
isUnstruct from typegpudata.ts	1.62 kB (➖)
isUsableAsRender from typegpu.ts	62 B (➖)
isUsableAsSampled from typegpu.ts	63 B (➖)
isUsableAsStorage from typegpu.ts	63 B (➖)
isUsableAsUniform from typegpu.ts	65.46 kB (➖)
isUsableAsVertex from typegpu.ts	98.10 kB (➖)
isVariable from typegpu.ts	67.26 kB (➖)
isWgslArray from typegpudata.ts	695 B (➖)
isWgslData from typegpudata.ts	1.25 kB (➖)
isWgslStruct from typegpudata.ts	696 B (➖)
ldexp from typegpustd.ts	78.92 kB (➖)
le from typegpustd.ts	64.66 kB (➖)
length from typegpustd.ts	78.92 kB (➖)
location from typegpudata.ts	42.36 kB (➖)
log2 from typegpustd.ts	78.92 kB (➖)
log from typegpustd.ts	78.92 kB (➖)
lt from typegpustd.ts	64.65 kB (➖)
mat2x2f from typegpudata.ts	43.23 kB (➖)
mat3x3f from typegpudata.ts	43.23 kB (➖)
mat4x4f from typegpudata.ts	43.23 kB (➖)
matToArray from typegpudata.ts	43.36 kB (➖)
max from typegpustd.ts	78.92 kB (➖)
min from typegpustd.ts	78.92 kB (➖)
mix from typegpustd.ts	78.92 kB (➖)
mod from typegpustd.ts	62.25 kB (➖)
modf from typegpustd.ts	78.92 kB (➖)
mul from typegpustd.ts	62.25 kB (➖)
ne from typegpustd.ts	64.65 kB (➖)
neg from typegpustd.ts	62.25 kB (➖)
normalize from typegpustd.ts	78.92 kB (➖)
not from typegpustd.ts	64.65 kB (➖)
or from typegpustd.ts	64.65 kB (➖)
pack2x16float from typegpustd.ts	51.81 kB (➖)
pack4x8unorm from typegpustd.ts	51.81 kB (➖)
packedFormats from typegpudata.ts	37.78 kB (➖)
pow from typegpustd.ts	78.92 kB (➖)
ptrFn from typegpudata.ts	800 B (➖)
ptrHandle from typegpudata.ts	792 B (➖)
ptrPrivate from typegpudata.ts	799 B (➖)
ptrStorage from typegpudata.ts	797 B (➖)
ptrUniform from typegpudata.ts	793 B (➖)
ptrWorkgroup from typegpudata.ts	801 B (➖)
quantizeToF16 from typegpustd.ts	78.92 kB (➖)
radians from typegpustd.ts	78.92 kB (➖)
ref from typegpudata.ts	4.09 kB (➖)
reflect from typegpustd.ts	78.92 kB (➖)
refract from typegpustd.ts	78.92 kB (➖)
reverseBits from typegpustd.ts	78.92 kB (➖)
rotateX4 from typegpustd.ts	62.97 kB (➖)
rotateY4 from typegpustd.ts	62.97 kB (➖)
rotateZ4 from typegpustd.ts	62.97 kB (➖)
rotationX4 from typegpustd.ts	43.23 kB (➖)
rotationY4 from typegpustd.ts	43.23 kB (➖)
rotationZ4 from typegpustd.ts	43.23 kB (➖)
round from typegpustd.ts	78.92 kB (➖)
sampler from typegpudata.ts	683 B (➖)
saturate from typegpustd.ts	78.92 kB (➖)
scale4 from typegpustd.ts	62.97 kB (➖)
scaling4 from typegpustd.ts	43.23 kB (➖)
select from typegpustd.ts	64.66 kB (➖)
sign from typegpustd.ts	78.92 kB (➖)
sin from typegpustd.ts	78.92 kB (➖)
sinh from typegpustd.ts	78.92 kB (➖)
sint16 from typegpudata.ts	37.76 kB (➖)
sint16x2 from typegpudata.ts	37.76 kB (➖)
sint16x4 from typegpudata.ts	37.76 kB (➖)
sint32 from typegpudata.ts	37.76 kB (➖)
sint32x2 from typegpudata.ts	37.76 kB (➖)
sint32x3 from typegpudata.ts	37.76 kB (➖)
sint32x4 from typegpudata.ts	37.76 kB (➖)
sint8 from typegpudata.ts	37.76 kB (➖)
sint8x2 from typegpudata.ts	37.76 kB (➖)
sint8x4 from typegpudata.ts	37.76 kB (➖)
sizeOf from typegpudata.ts	40.69 kB (➖)
size from typegpudata.ts	42.36 kB (➖)
smoothstep from typegpustd.ts	78.92 kB (➖)
snorm16 from typegpudata.ts	37.76 kB (➖)
snorm16x2 from typegpudata.ts	37.76 kB (➖)
snorm16x4 from typegpudata.ts	37.76 kB (➖)
snorm8 from typegpudata.ts	37.76 kB (➖)
snorm8x2 from typegpudata.ts	37.76 kB (➖)
snorm8x4 from typegpudata.ts	37.76 kB (➖)
sqrt from typegpustd.ts	78.92 kB (➖)
std from typegpu.ts	112.90 kB (➖)
step from typegpustd.ts	78.92 kB (➖)
storageBarrier from typegpustd.ts	12.70 kB (➖)
struct from typegpudata.ts	3.31 kB (➖)
sub from typegpustd.ts	62.25 kB (➖)
subgroupAdd from typegpustd.ts	39.90 kB (➖)
subgroupAll from typegpustd.ts	39.90 kB (➖)
subgroupAnd from typegpustd.ts	39.90 kB (➖)
subgroupAny from typegpustd.ts	39.90 kB (➖)
subgroupBallot from typegpustd.ts	39.90 kB (➖)
subgroupBroadcastFirst from typegpustd.ts	39.90 kB (➖)
subgroupBroadcast from typegpustd.ts	39.90 kB (➖)
subgroupElect from typegpustd.ts	39.90 kB (➖)
subgroupExclusiveAdd from typegpustd.ts	39.90 kB (➖)
subgroupExclusiveMul from typegpustd.ts	39.90 kB (➖)
subgroupInclusiveAdd from typegpustd.ts	39.90 kB (➖)
subgroupInclusiveMul from typegpustd.ts	39.90 kB (➖)
subgroupMax from typegpustd.ts	39.90 kB (➖)
subgroupMin from typegpustd.ts	39.90 kB (➖)
subgroupMul from typegpustd.ts	39.90 kB (➖)
subgroupOr from typegpustd.ts	39.90 kB (➖)
subgroupShuffleDown from typegpustd.ts	39.90 kB (➖)
subgroupShuffleUp from typegpustd.ts	39.90 kB (➖)
subgroupShuffleXor from typegpustd.ts	39.90 kB (➖)
subgroupShuffle from typegpustd.ts	39.90 kB (➖)
subgroupXor from typegpustd.ts	39.90 kB (➖)
tan from typegpustd.ts	78.92 kB (➖)
tanh from typegpustd.ts	78.92 kB (➖)
texture1d from typegpudata.ts	11.30 kB (➖)
texture2dArray from typegpudata.ts	11.32 kB (➖)
texture2d from typegpudata.ts	11.30 kB (➖)
texture3d from typegpudata.ts	11.30 kB (➖)
textureBarrier from typegpustd.ts	12.69 kB (➖)
textureCubeArray from typegpudata.ts	11.32 kB (➖)
textureCube from typegpudata.ts	11.30 kB (➖)
textureDepth2dArray from typegpudata.ts	11.30 kB (➖)
textureDepth2d from typegpudata.ts	11.29 kB (➖)
textureDepthCubeArray from typegpudata.ts	11.31 kB (➖)
textureDepthCube from typegpudata.ts	11.29 kB (➖)
textureDepthMultisampled2d from typegpudata.ts	11.31 kB (➖)
textureDimensions from typegpustd.ts	40.67 kB (➖)
textureExternal from typegpudata.ts	814 B (➖)
textureLoad from typegpustd.ts	40.67 kB (➖)
textureMultisampled2d from typegpudata.ts	11.32 kB (➖)
textureSampleBaseClampToEdge from typegpustd.ts	40.67 kB (➖)
textureSampleBias from typegpustd.ts	40.67 kB (➖)
textureSampleCompareLevel from typegpustd.ts	40.67 kB (➖)
textureSampleCompare from typegpustd.ts	40.67 kB (➖)
textureSampleLevel from typegpustd.ts	40.67 kB (➖)
textureSample from typegpustd.ts	40.67 kB (➖)
textureStorage1d from typegpudata.ts	978 B (➖)
textureStorage2dArray from typegpudata.ts	996 B (➖)
textureStorage2d from typegpudata.ts	978 B (➖)
textureStorage3d from typegpudata.ts	978 B (➖)
textureStore from typegpustd.ts	40.67 kB (➖)
tgpu.bindGroupLayout from typegpu.ts	74.37 kB (➖)
tgpu.comptime from typegpu.ts	12.14 kB (➖)
tgpu.const from typegpu.ts	66.34 kB (➖)
tgpu.fn from typegpu.ts	50.88 kB (➖)
tgpu.initFromDevice from typegpu.ts	231.69 kB ($${\color{red}+0.2\%}$$)
tgpu.init from typegpu.ts	232.20 kB ($${\color{red}+0.2\%}$$)
tgpu.lazy from typegpu.ts	1.15 kB (➖)
tgpu.privateVar from typegpu.ts	67.27 kB (➖)
tgpu.resolveWithContext from typegpu.ts	179.42 kB ($${\color{red}+0.1\%}$$)
tgpu.resolve from typegpu.ts	179.49 kB ($${\color{red}+0.1\%}$$)
tgpu.slot from typegpu.ts	1.58 kB (➖)
tgpu.vertexLayout from typegpu.ts	42.69 kB (➖)
tgpu.workgroupVar from typegpu.ts	67.27 kB (➖)
tgpu from typegpu.ts	240.20 kB ($${\color{red}+0.2\%}$$)
translate4 from typegpustd.ts	62.97 kB (➖)
translation4 from typegpustd.ts	43.23 kB (➖)
transpose from typegpustd.ts	78.92 kB (➖)
trunc from typegpustd.ts	78.92 kB (➖)
u16 from typegpudata.ts	10.87 kB (➖)
u32 from typegpudata.ts	10.84 kB (➖)
uint16 from typegpudata.ts	37.76 kB (➖)
uint16x2 from typegpudata.ts	37.76 kB (➖)
uint16x4 from typegpudata.ts	37.76 kB (➖)
uint32 from typegpudata.ts	37.76 kB (➖)
uint32x2 from typegpudata.ts	37.76 kB (➖)
uint32x3 from typegpudata.ts	37.76 kB (➖)
uint32x4 from typegpudata.ts	37.76 kB (➖)
uint8 from typegpudata.ts	37.76 kB (➖)
uint8x2 from typegpudata.ts	37.76 kB (➖)
uint8x4 from typegpudata.ts	37.76 kB (➖)
unorm10 10 10 2 from typegpudata.ts	37.76 kB (➖)
unorm16 from typegpudata.ts	37.76 kB (➖)
unorm16x2 from typegpudata.ts	37.76 kB (➖)
unorm16x4 from typegpudata.ts	37.76 kB (➖)
unorm8 from typegpudata.ts	37.76 kB (➖)
unorm8x2 from typegpudata.ts	37.76 kB (➖)
unorm8x4 bgra from typegpudata.ts	37.76 kB (➖)
unorm8x4 from typegpudata.ts	37.76 kB (➖)
unpack2x16float from typegpustd.ts	51.81 kB (➖)
unpack4x8unorm from typegpustd.ts	51.81 kB (➖)
unstruct from typegpudata.ts	1.58 kB (➖)
vec2b from typegpudata.ts	36.27 kB (➖)
vec2f from typegpudata.ts	36.27 kB (➖)
vec2h from typegpudata.ts	36.27 kB (➖)
vec2i from typegpudata.ts	36.27 kB (➖)
vec2u from typegpudata.ts	36.27 kB (➖)
vec3b from typegpudata.ts	36.27 kB (➖)
vec3f from typegpudata.ts	36.27 kB (➖)
vec3h from typegpudata.ts	36.27 kB (➖)
vec3i from typegpudata.ts	36.27 kB (➖)
vec3u from typegpudata.ts	36.27 kB (➖)
vec4b from typegpudata.ts	36.27 kB (➖)
vec4f from typegpudata.ts	36.27 kB (➖)
vec4h from typegpudata.ts	36.27 kB (➖)
vec4i from typegpudata.ts	36.27 kB (➖)
vec4u from typegpudata.ts	36.27 kB (➖)
workgroupBarrier from typegpustd.ts	12.69 kB (➖)

If you wish to run a comparison for other, slower bundlers, run the 'Tree-shake test' from the GitHub Actions menu.

[github-actions]

pkg.pr.new

packages
Ready to be installed by your favorite package manager ⬇️

https://pkg.pr.new/software-mansion/TypeGPU/typegpu@62e38b328931ce916e3997f10480f0995077ad34

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/noise@62e38b328931ce916e3997f10480f0995077ad34

https://pkg.pr.new/software-mansion/TypeGPU/unplugin-typegpu@62e38b328931ce916e3997f10480f0995077ad34

benchmark
view benchmark

commit
view commit

[Copilot]

Pull request overview

This pull request enhances error messages for illegal arguments passed to shellless functions in TypeGPU. When developers incorrectly pass resources (like samplers, texture views, or uniforms) without dereferencing them using .$, they now receive clear, actionable error messages explaining what went wrong and how to fix it.

Changes:

• Enhanced error messages in shellless functions to provide clear guidance when illegal arguments are passed
• Added toString() methods to TgpuTextureImpl and TgpuBufferShorthandImpl to improve error message clarity
• Added comprehensive test coverage for both valid and invalid argument cases

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
packages/typegpu/src/tgsl/shellless.ts	Enhanced error message with multi-line explanation and guidance for fixing illegal argument errors
packages/typegpu/src/core/texture/texture.ts	Added toString() method to texture class for better error reporting
packages/typegpu/src/core/buffer/bufferShorthand.ts	Added toString() method and imported getName for buffer shorthand classes
packages/typegpu/tests/tgsl/shellless.test.ts	Added comprehensive test cases for valid sampler/texture view arguments and error cases for various illegal arguments

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[reczkok]

Looks good