typegpu 0.2.0 → 0.3.0-alpha.2

package/utilityTypes-0b50gROn.d.cts

@@ -0,0 +1,1122 @@
+/**
+ * Extracts the inferred representation of a resource.
+ * @example
+ * type A = Infer<F32> // => number
+ * type B = Infer<TgpuArray<F32>> // => number[]
+ */
+type Infer<T> = T extends {
+    readonly '~repr': infer TRepr;
+} ? TRepr : T;
+type InferRecord<T extends Record<string | number | symbol, unknown>> = {
+    [Key in keyof T]: Infer<T[Key]>;
+};
+
+interface NumberArrayView {
+    readonly length: number;
+    [n: number]: number;
+}
+interface BaseWgslData {
+    type: string;
+    /** Type-token, not available at runtime */
+    readonly '~repr': unknown;
+}
+interface Swizzle2<T2, T3, T4> {
+    readonly xx: T2;
+    readonly xy: T2;
+    readonly yx: T2;
+    readonly yy: T2;
+    readonly xxx: T3;
+    readonly xxy: T3;
+    readonly xyx: T3;
+    readonly xyy: T3;
+    readonly yxx: T3;
+    readonly yxy: T3;
+    readonly yyx: T3;
+    readonly yyy: T3;
+    readonly xxxx: T4;
+    readonly xxxy: T4;
+    readonly xxyx: T4;
+    readonly xxyy: T4;
+    readonly xyxx: T4;
+    readonly xyxy: T4;
+    readonly xyyx: T4;
+    readonly xyyy: T4;
+    readonly yxxx: T4;
+    readonly yxxy: T4;
+    readonly yxyx: T4;
+    readonly yxyy: T4;
+    readonly yyxx: T4;
+    readonly yyxy: T4;
+    readonly yyyx: T4;
+    readonly yyyy: T4;
+}
+interface Swizzle3<T2, T3, T4> extends Swizzle2<T2, T3, T4> {
+    readonly xz: T2;
+    readonly yz: T2;
+    readonly zx: T2;
+    readonly zy: T2;
+    readonly zz: T2;
+    readonly xxz: T3;
+    readonly xyz: T3;
+    readonly xzx: T3;
+    readonly xzy: T3;
+    readonly xzz: T3;
+    readonly yxz: T3;
+    readonly yyz: T3;
+    readonly yzx: T3;
+    readonly yzy: T3;
+    readonly yzz: T3;
+    readonly zxx: T3;
+    readonly zxy: T3;
+    readonly zxz: T3;
+    readonly zyx: T3;
+    readonly zyy: T3;
+    readonly zyz: T3;
+    readonly zzx: T3;
+    readonly zzy: T3;
+    readonly zzz: T3;
+    readonly xxxz: T4;
+    readonly xxyz: T4;
+    readonly xxzx: T4;
+    readonly xxzy: T4;
+    readonly xxzz: T4;
+    readonly xyxz: T4;
+    readonly xyyz: T4;
+    readonly xyzx: T4;
+    readonly xyzy: T4;
+    readonly xyzz: T4;
+    readonly xzxx: T4;
+    readonly xzxy: T4;
+    readonly xzxz: T4;
+    readonly xzyx: T4;
+    readonly xzyy: T4;
+    readonly xzyz: T4;
+    readonly xzzx: T4;
+    readonly xzzy: T4;
+    readonly xzzz: T4;
+    readonly yxxz: T4;
+    readonly yxyz: T4;
+    readonly yxzx: T4;
+    readonly yxzy: T4;
+    readonly yxzz: T4;
+    readonly yyxz: T4;
+    readonly yyyz: T4;
+    readonly yyzx: T4;
+    readonly yyzy: T4;
+    readonly yyzz: T4;
+    readonly yzxx: T4;
+    readonly yzxy: T4;
+    readonly yzxz: T4;
+    readonly yzyx: T4;
+    readonly yzyy: T4;
+    readonly yzyz: T4;
+    readonly yzzx: T4;
+    readonly yzzy: T4;
+    readonly yzzz: T4;
+    readonly zxxx: T4;
+    readonly zxxy: T4;
+    readonly zxxz: T4;
+    readonly zxyx: T4;
+    readonly zxyy: T4;
+    readonly zxyz: T4;
+    readonly zxzx: T4;
+    readonly zxzy: T4;
+    readonly zxzz: T4;
+    readonly zyxx: T4;
+    readonly zyxy: T4;
+    readonly zyxz: T4;
+    readonly zyyx: T4;
+    readonly zyyy: T4;
+    readonly zyyz: T4;
+    readonly zyzx: T4;
+    readonly zyzy: T4;
+    readonly zyzz: T4;
+    readonly zzxx: T4;
+    readonly zzxy: T4;
+    readonly zzxz: T4;
+    readonly zzyx: T4;
+    readonly zzyy: T4;
+    readonly zzyz: T4;
+    readonly zzzx: T4;
+    readonly zzzy: T4;
+    readonly zzzz: T4;
+}
+interface Swizzle4<T2, T3, T4> extends Swizzle3<T2, T3, T4> {
+    readonly yw: T2;
+    readonly zw: T2;
+    readonly wx: T2;
+    readonly wy: T2;
+    readonly wz: T2;
+    readonly ww: T2;
+    readonly xxw: T3;
+    readonly xyw: T3;
+    readonly xzw: T3;
+    readonly xwx: T3;
+    readonly xwy: T3;
+    readonly xwz: T3;
+    readonly xww: T3;
+    readonly yxw: T3;
+    readonly yyw: T3;
+    readonly yzw: T3;
+    readonly ywx: T3;
+    readonly ywy: T3;
+    readonly ywz: T3;
+    readonly yww: T3;
+    readonly zxw: T3;
+    readonly zyw: T3;
+    readonly zzw: T3;
+    readonly zwx: T3;
+    readonly zwy: T3;
+    readonly zwz: T3;
+    readonly zww: T3;
+    readonly wxx: T3;
+    readonly wxz: T3;
+    readonly wxy: T3;
+    readonly wyy: T3;
+    readonly wyz: T3;
+    readonly wzz: T3;
+    readonly wwx: T3;
+    readonly wwy: T3;
+    readonly wwz: T3;
+    readonly www: T3;
+    readonly xxxw: T4;
+    readonly xxyw: T4;
+    readonly xxzw: T4;
+    readonly xxwx: T4;
+    readonly xxwy: T4;
+    readonly xxwz: T4;
+    readonly xxww: T4;
+    readonly xyxw: T4;
+    readonly xyyw: T4;
+    readonly xyzw: T4;
+    readonly xywx: T4;
+    readonly xywy: T4;
+    readonly xywz: T4;
+    readonly xyww: T4;
+    readonly xzxw: T4;
+    readonly xzyw: T4;
+    readonly xzzw: T4;
+    readonly xzwx: T4;
+    readonly xzwy: T4;
+    readonly xzwz: T4;
+    readonly xzww: T4;
+    readonly xwxx: T4;
+    readonly xwxy: T4;
+    readonly xwxz: T4;
+    readonly xwyy: T4;
+    readonly xwyz: T4;
+    readonly xwzz: T4;
+    readonly xwwx: T4;
+    readonly xwwy: T4;
+    readonly xwwz: T4;
+    readonly xwww: T4;
+    readonly yxxw: T4;
+    readonly yxyw: T4;
+    readonly yxzw: T4;
+    readonly yxwx: T4;
+    readonly yxwy: T4;
+    readonly yxwz: T4;
+    readonly yxww: T4;
+    readonly yyxw: T4;
+    readonly yyyw: T4;
+    readonly yyzw: T4;
+    readonly yywx: T4;
+    readonly yywy: T4;
+    readonly yywz: T4;
+    readonly yyww: T4;
+    readonly yzxw: T4;
+    readonly yzyw: T4;
+    readonly yzzw: T4;
+    readonly yzwx: T4;
+    readonly yzwy: T4;
+    readonly yzwz: T4;
+    readonly yzww: T4;
+    readonly ywxx: T4;
+    readonly ywxy: T4;
+    readonly ywxz: T4;
+    readonly ywxw: T4;
+    readonly ywyy: T4;
+    readonly ywyz: T4;
+    readonly ywzz: T4;
+    readonly ywwx: T4;
+    readonly ywwy: T4;
+    readonly ywwz: T4;
+    readonly ywww: T4;
+    readonly zxxw: T4;
+    readonly zxyw: T4;
+    readonly zxzw: T4;
+    readonly zxwx: T4;
+    readonly zxwy: T4;
+    readonly zxwz: T4;
+    readonly zxww: T4;
+    readonly zyxw: T4;
+    readonly zyyw: T4;
+    readonly zyzw: T4;
+    readonly zywx: T4;
+    readonly zywy: T4;
+    readonly zywz: T4;
+    readonly zyww: T4;
+    readonly zzxw: T4;
+    readonly zzyw: T4;
+    readonly zzzw: T4;
+    readonly zzwx: T4;
+    readonly zzwy: T4;
+    readonly zzwz: T4;
+    readonly zzww: T4;
+    readonly zwxx: T4;
+    readonly zwxy: T4;
+    readonly zwxz: T4;
+    readonly zwxw: T4;
+    readonly zwyy: T4;
+    readonly zwyz: T4;
+    readonly zwzz: T4;
+    readonly zwwx: T4;
+    readonly zwwy: T4;
+    readonly zwwz: T4;
+    readonly zwww: T4;
+    readonly wxxx: T4;
+    readonly wxxy: T4;
+    readonly wxxz: T4;
+    readonly wxxw: T4;
+    readonly wxyx: T4;
+    readonly wxyy: T4;
+    readonly wxyz: T4;
+    readonly wxyw: T4;
+    readonly wxzx: T4;
+    readonly wxzy: T4;
+    readonly wxzz: T4;
+    readonly wxzw: T4;
+    readonly wxwx: T4;
+    readonly wxwy: T4;
+    readonly wxwz: T4;
+    readonly wxww: T4;
+    readonly wyxx: T4;
+    readonly wyxy: T4;
+    readonly wyxz: T4;
+    readonly wyxw: T4;
+    readonly wyyy: T4;
+    readonly wyyz: T4;
+    readonly wyzw: T4;
+    readonly wywx: T4;
+    readonly wywy: T4;
+    readonly wywz: T4;
+    readonly wyww: T4;
+    readonly wzxx: T4;
+    readonly wzxy: T4;
+    readonly wzxz: T4;
+    readonly wzxw: T4;
+    readonly wzyy: T4;
+    readonly wzyz: T4;
+    readonly wzzy: T4;
+    readonly wzzw: T4;
+    readonly wzwx: T4;
+    readonly wzwy: T4;
+    readonly wzwz: T4;
+    readonly wzww: T4;
+    readonly wwxx: T4;
+    readonly wwxy: T4;
+    readonly wwxz: T4;
+    readonly wwxw: T4;
+    readonly wwyy: T4;
+    readonly wwyz: T4;
+    readonly wwzz: T4;
+    readonly wwwx: T4;
+    readonly wwwy: T4;
+    readonly wwwz: T4;
+    readonly wwww: T4;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec2f or vec2<f32>.
+ * A vector with 2 elements of type f32
+ */
+interface v2f extends NumberArrayView, Swizzle2<v2f, v3f, v4f> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec2f';
+    x: number;
+    y: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec2i or vec2<i32>.
+ * A vector with 2 elements of type i32
+ */
+interface v2i extends NumberArrayView, Swizzle2<v2i, v3i, v4i> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec2i';
+    x: number;
+    y: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec2u or vec2<u32>.
+ * A vector with 2 elements of type u32
+ */
+interface v2u extends NumberArrayView, Swizzle2<v2u, v3u, v4u> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec2u';
+    x: number;
+    y: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec3f or vec3<f32>.
+ * A vector with 3 elements of type f32
+ */
+interface v3f extends NumberArrayView, Swizzle3<v2f, v3f, v4f> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec3f';
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec3i or vec3<i32>.
+ * A vector with 3 elements of type i32
+ */
+interface v3i extends NumberArrayView, Swizzle3<v2i, v3i, v4i> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec3i';
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec3u or vec3<u32>.
+ * A vector with 3 elements of type u32
+ */
+interface v3u extends NumberArrayView, Swizzle3<v2u, v3u, v4u> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec3u';
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec4f or vec4<f32>.
+ * A vector with 4 elements of type f32
+ */
+interface v4f extends NumberArrayView, Swizzle4<v2f, v3f, v4f> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec4f';
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec4i or vec4<i32>.
+ * A vector with 4 elements of type i32
+ */
+interface v4i extends NumberArrayView, Swizzle4<v2i, v3i, v4i> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec4i';
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+/**
+ * Interface representing its WGSL vector type counterpart: vec4u or vec4<u32>.
+ * A vector with 4 elements of type u32
+ */
+interface v4u extends NumberArrayView, Swizzle4<v2u, v3u, v4u> {
+    /** use to distinguish between vectors of the same size on the type level */
+    readonly kind: 'vec4u';
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+interface matBase<TColumn> extends NumberArrayView {
+    readonly columns: readonly TColumn[];
+}
+/**
+ * Interface representing its WGSL matrix type counterpart: mat2x2
+ * A matrix with 2 rows and 2 columns, with elements of type `TColumn`
+ */
+interface mat2x2<TColumn> extends matBase<TColumn> {
+    readonly length: 4;
+    [n: number]: number;
+}
+/**
+ * Interface representing its WGSL matrix type counterpart: mat2x2f or mat2x2<f32>
+ * A matrix with 2 rows and 2 columns, with elements of type d.f32
+ */
+interface m2x2f extends mat2x2<v2f> {
+    readonly kind: 'mat2x2f';
+}
+/**
+ * Interface representing its WGSL matrix type counterpart: mat3x3
+ * A matrix with 3 rows and 3 columns, with elements of type `TColumn`
+ */
+interface mat3x3<TColumn> extends matBase<TColumn> {
+    readonly length: 12;
+    [n: number]: number;
+}
+/**
+ * Interface representing its WGSL matrix type counterpart: mat3x3f or mat3x3<f32>
+ * A matrix with 3 rows and 3 columns, with elements of type d.f32
+ */
+interface m3x3f extends mat3x3<v3f> {
+    readonly kind: 'mat3x3f';
+}
+/**
+ * Interface representing its WGSL matrix type counterpart: mat4x4
+ * A matrix with 4 rows and 4 columns, with elements of type `TColumn`
+ */
+interface mat4x4<TColumn> extends matBase<TColumn> {
+    readonly length: 16;
+    [n: number]: number;
+}
+/**
+ * Interface representing its WGSL matrix type counterpart: mat4x4f or mat4x4<f32>
+ * A matrix with 4 rows and 4 columns, with elements of type d.f32
+ */
+interface m4x4f extends mat4x4<v4f> {
+    readonly kind: 'mat4x4f';
+}
+/**
+ * Boolean schema representing a single WGSL bool value.
+ * Cannot be used inside buffers as it is not host-shareable.
+ */
+interface Bool {
+    readonly type: 'bool';
+    readonly '~repr': boolean;
+}
+interface F32 {
+    readonly type: 'f32';
+    /** Type-token, not available at runtime */
+    readonly '~repr': number;
+}
+interface F16 {
+    readonly type: 'f16';
+    /** Type-token, not available at runtime */
+    readonly '~repr': number;
+}
+interface I32 {
+    readonly type: 'i32';
+    /** Type-token, not available at runtime */
+    readonly '~repr': number;
+}
+interface U32 {
+    readonly type: 'u32';
+    /** Type-token, not available at runtime */
+    readonly '~repr': number;
+}
+interface Vec2f {
+    readonly type: 'vec2f';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v2f;
+}
+interface Vec2i {
+    readonly type: 'vec2i';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v2i;
+}
+interface Vec2u {
+    readonly type: 'vec2u';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v2u;
+}
+interface Vec3f {
+    readonly type: 'vec3f';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v3f;
+}
+interface Vec3i {
+    readonly type: 'vec3i';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v3i;
+}
+interface Vec3u {
+    readonly type: 'vec3u';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v3u;
+}
+interface Vec4f {
+    readonly type: 'vec4f';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v4f;
+}
+interface Vec4i {
+    readonly type: 'vec4i';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v4i;
+}
+interface Vec4u {
+    readonly type: 'vec4u';
+    /** Type-token, not available at runtime */
+    readonly '~repr': v4u;
+}
+interface Mat2x2f {
+    readonly type: 'mat2x2f';
+    /** Type-token, not available at runtime */
+    readonly '~repr': m2x2f;
+}
+interface Mat3x3f {
+    readonly type: 'mat3x3f';
+    /** Type-token, not available at runtime */
+    readonly '~repr': m3x3f;
+}
+interface Mat4x4f {
+    readonly type: 'mat4x4f';
+    /** Type-token, not available at runtime */
+    readonly '~repr': m4x4f;
+}
+interface WgslStruct<TProps extends Record<string, BaseWgslData> = Record<string, BaseWgslData>> {
+    readonly type: 'struct';
+    readonly label?: string | undefined;
+    readonly propTypes: TProps;
+    /** Type-token, not available at runtime */
+    readonly '~repr': InferRecord<TProps>;
+}
+interface WgslArray<TElement = BaseWgslData> {
+    readonly type: 'array';
+    readonly elementCount: number;
+    readonly elementType: TElement;
+    /** Type-token, not available at runtime */
+    readonly '~repr': Infer<TElement>[];
+}
+/**
+ * Schema representing the `atomic<...>` WGSL data type.
+ */
+interface Atomic<TInner extends U32 | I32 = U32 | I32> {
+    readonly type: 'atomic';
+    readonly inner: TInner;
+    /** Type-token, not available at runtime */
+    readonly '~repr': Infer<TInner>;
+}
+interface Align<T extends number> {
+    readonly type: '@align';
+    readonly value: T;
+}
+interface Size<T extends number> {
+    readonly type: '@size';
+    readonly value: T;
+}
+interface Location<T extends number> {
+    readonly type: '@location';
+    readonly value: T;
+}
+interface Builtin<T extends string> {
+    readonly type: '@builtin';
+    readonly value: T;
+}
+interface Decorated<TInner extends BaseWgslData = BaseWgslData, TAttribs extends unknown[] = unknown[]> {
+    readonly type: 'decorated';
+    readonly inner: TInner;
+    readonly attribs: TAttribs;
+    /** Type-token, not available at runtime */
+    readonly '~repr': Infer<TInner>;
+}
+declare const wgslTypeLiterals: readonly ["bool", "f32", "f16", "i32", "u32", "vec2f", "vec2i", "vec2u", "vec3f", "vec3i", "vec3u", "vec4f", "vec4i", "vec4u", "mat2x2f", "mat3x3f", "mat4x4f", "struct", "array", "atomic", "decorated"];
+type WgslTypeLiteral = (typeof wgslTypeLiterals)[number];
+type AnyWgslData = Bool | F32 | F16 | I32 | U32 | Vec2f | Vec2i | Vec2u | Vec3f | Vec3i | Vec3u | Vec4f | Vec4i | Vec4u | Mat2x2f | Mat3x3f | Mat4x4f | WgslStruct | WgslArray | Atomic | Decorated;
+declare function isWgslData(value: unknown): value is AnyWgslData;
+/**
+ * Checks whether passed in value is an array schema,
+ * as opposed to, e.g., a looseArray schema.
+ *
+ * Array schemas can be used to describe uniform and storage buffers,
+ * whereas looseArray schemas cannot.
+ *
+ * @example
+ * isWgslArray(d.arrayOf(d.u32, 4)) // true
+ * isWgslArray(d.looseArrayOf(d.u32, 4)) // false
+ * isWgslArray(d.vec3f) // false
+ */
+declare function isWgslArray<T extends WgslArray>(schema: T | unknown): schema is T;
+/**
+ * Checks whether passed in value is a struct schema,
+ * as opposed to, e.g., a looseStruct schema.
+ *
+ * Struct schemas can be used to describe uniform and storage buffers,
+ * whereas looseStruct schemas cannot.
+ *
+ * @example
+ * isWgslStruct(d.struct({ a: d.u32 })) // true
+ * isWgslStruct(d.looseStruct({ a: d.u32 })) // false
+ * isWgslStruct(d.vec3f) // false
+ */
+declare function isWgslStruct<T extends WgslStruct>(schema: T | unknown): schema is T;
+/**
+ * Checks whether the passed in value is an atomic schema.
+ *
+ * @example
+ * isAtomic(d.atomic(d.u32)) // true
+ * isAtomic(d.u32) // false
+ */
+declare function isAtomic<T extends Atomic<U32 | I32>>(schema: T | unknown): schema is T;
+declare function isAlignAttrib<T extends Align<number>>(value: unknown | T): value is T;
+declare function isSizeAttrib<T extends Size<number>>(value: unknown | T): value is T;
+declare function isLocationAttrib<T extends Location<number>>(value: unknown | T): value is T;
+declare function isBuiltinAttrib<T extends Builtin<string>>(value: unknown | T): value is T;
+declare function isDecorated<T extends Decorated>(value: unknown | T): value is T;
+
+/**
+ * A schema that represents a boolean value. (equivalent to `bool` in WGSL)
+ */
+declare const bool: Bool;
+/**
+ * Unsigned 32-bit integer schema representing a single WGSL u32 value.
+ */
+type NativeU32 = U32 & {
+    '~exotic': U32;
+} & ((v: number | boolean) => number);
+/**
+ * A schema that represents an unsigned 32-bit integer value. (equivalent to `u32` in WGSL)
+ *
+ * Can also be called to cast a value to an u32 in accordance with WGSL casting rules.
+ *
+ * @example
+ * const value = u32(3.14); // 3
+ * @example
+ * const value = u32(-1); // 4294967295
+ * @example
+ * const value = u32(-3.1); // 0
+ */
+declare const u32: NativeU32;
+/**
+ * Signed 32-bit integer schema representing a single WGSL i32 value.
+ */
+type NativeI32 = I32 & {
+    '~exotic': I32;
+} & ((v: number | boolean) => number);
+/**
+ * A schema that represents a signed 32-bit integer value. (equivalent to `i32` in WGSL)
+ *
+ * Can also be called to cast a value to an i32 in accordance with WGSL casting rules.
+ *
+ * @example
+ * const value = i32(3.14); // 3
+ * @example
+ * const value = i32(-3.9); // -3
+ * @example
+ * const value = i32(10000000000) // 1410065408
+ */
+declare const i32: NativeI32;
+/**
+ * 32-bit float schema representing a single WGSL f32 value.
+ */
+type NativeF32 = F32 & {
+    '~exotic': F32;
+} & ((v: number | boolean) => number);
+/**
+ * A schema that represents a 32-bit float value. (equivalent to `f32` in WGSL)
+ *
+ * Can also be called to cast a value to an f32.
+ *
+ * @example
+ * const value = f32(true); // 1
+ */
+declare const f32: NativeF32;
+/**
+ * 16-bit float schema representing a single WGSL f16 value.
+ */
+type NativeF16 = F16 & {
+    '~exotic': F16;
+} & ((v: number | boolean) => number);
+/**
+ * A schema that represents a 16-bit float value. (equivalent to `f16` in WGSL)
+ *
+ * Can also be called to cast a value to an f16.
+ *
+ * @example
+ * const value = f16(true); // 1
+ * @example
+ * const value = f16(21877.5); // 21872
+ */
+declare const f16: NativeF16;
+
+/**
+ * Type of the `d.vec2f` object/function: vector data type schema/constructor
+ */
+type NativeVec2f = Vec2f & {
+    '~exotic': Vec2f;
+} & ((x: number, y: number) => v2f) & ((xy: number) => v2f) & (() => v2f);
+/**
+ *
+ * Schema representing vec2f - a vector with 2 elements of type f32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec2f(); // (0.0, 0.0)
+ * const vector = d.vec2f(1); // (1.0, 1.0)
+ * const vector = d.vec2f(0.5, 0.1); // (0.5, 0.1)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec2f, d.vec2f(0, 1)); // buffer holding a d.vec2f value, with an initial value of vec2f(0, 1);
+ */
+declare const vec2f: NativeVec2f;
+/**
+ * Type of the `d.vec2i` object/function: vector data type schema/constructor
+ */
+type NativeVec2i = Vec2i & {
+    '~exotic': Vec2i;
+} & ((x: number, y: number) => v2i) & ((xy: number) => v2i) & (() => v2i);
+/**
+ *
+ * Schema representing vec2i - a vector with 2 elements of type i32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec2i(); // (0, 0)
+ * const vector = d.vec2i(1); // (1, 1)
+ * const vector = d.vec2i(-1, 1); // (-1, 1)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec2i, d.vec2i(0, 1)); // buffer holding a d.vec2i value, with an initial value of vec2i(0, 1);
+ */
+declare const vec2i: NativeVec2i;
+/**
+ * Type of the `d.vec2u` object/function: vector data type schema/constructor
+ */
+type NativeVec2u = Vec2u & {
+    '~exotic': Vec2u;
+} & ((x: number, y: number) => v2u) & ((xy: number) => v2u) & (() => v2u);
+/**
+ *
+ * Schema representing vec2u - a vector with 2 elements of type u32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec2u(); // (0, 0)
+ * const vector = d.vec2u(1); // (1, 1)
+ * const vector = d.vec2u(1, 2); // (1, 2)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec2u, d.vec2u(0, 1)); // buffer holding a d.vec2u value, with an initial value of vec2u(0, 1);
+ */
+declare const vec2u: NativeVec2u;
+/**
+ * Type of the `d.vec3f` object/function: vector data type schema/constructor
+ */
+type NativeVec3f = Vec3f & {
+    '~exotic': Vec3f;
+} & ((x: number, y: number, z: number) => v3f) & ((xyz: number) => v3f) & (() => v3f);
+/**
+ *
+ * Schema representing vec3f - a vector with 3 elements of type f32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec3f(); // (0.0, 0.0, 0.0)
+ * const vector = d.vec3f(1); // (1.0, 1.0, 1.0)
+ * const vector = d.vec3f(1, 2, 3.5); // (1.0, 2.0, 3.5)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec3f, d.vec3f(0, 1, 2)); // buffer holding a d.vec3f value, with an initial value of vec3f(0, 1, 2);
+ */
+declare const vec3f: NativeVec3f;
+/**
+ * Type of the `d.vec3i` object/function: vector data type schema/constructor
+ */
+type NativeVec3i = Vec3i & {
+    '~exotic': Vec3i;
+} & ((x: number, y: number, z: number) => v3i) & ((xyz: number) => v3i) & (() => v3i);
+/**
+ *
+ * Schema representing vec3i - a vector with 3 elements of type i32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec3i(); // (0, 0, 0)
+ * const vector = d.vec3i(1); // (1, 1, 1)
+ * const vector = d.vec3i(1, 2, -3); // (1, 2, -3)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec3i, d.vec3i(0, 1, 2)); // buffer holding a d.vec3i value, with an initial value of vec3i(0, 1, 2);
+ */
+declare const vec3i: NativeVec3i;
+/**
+ * Type of the `d.vec3u` object/function: vector data type schema/constructor
+ */
+type NativeVec3u = Vec3u & {
+    '~exotic': Vec3u;
+} & ((x: number, y: number, z: number) => v3u) & ((xyz: number) => v3u) & (() => v3u);
+/**
+ *
+ * Schema representing vec3u - a vector with 3 elements of type u32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec3u(); // (0, 0, 0)
+ * const vector = d.vec3u(1); // (1, 1, 1)
+ * const vector = d.vec3u(1, 2, 3); // (1, 2, 3)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec3u, d.vec3u(0, 1, 2)); // buffer holding a d.vec3u value, with an initial value of vec3u(0, 1, 2);
+ */
+declare const vec3u: NativeVec3u;
+/**
+ * Type of the `d.vec4f` object/function: vector data type schema/constructor
+ */
+type NativeVec4f = Vec4f & {
+    '~exotic': Vec4f;
+} & ((x: number, y: number, z: number, w: number) => v4f) & ((xyzw: number) => v4f) & (() => v4f);
+/**
+ *
+ * Schema representing vec4f - a vector with 4 elements of type f32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec4f(); // (0.0, 0.0, 0.0, 0.0)
+ * const vector = d.vec4f(1); // (1.0, 1.0, 1.0, 1.0)
+ * const vector = d.vec4f(1, 2, 3, 4.5); // (1.0, 2.0, 3.0, 4.5)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec4f, d.vec4f(0, 1, 2, 3)); // buffer holding a d.vec4f value, with an initial value of vec4f(0, 1, 2, 3);
+ */
+declare const vec4f: NativeVec4f;
+/**
+ * Type of the `d.vec4i` object/function: vector data type schema/constructor
+ */
+type NativeVec4i = Vec4i & {
+    '~exotic': Vec4i;
+} & ((x: number, y: number, z: number, w: number) => v4i) & ((xyzw: number) => v4i) & (() => v4i);
+/**
+ *
+ * Schema representing vec4i - a vector with 4 elements of type i32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec4i(); // (0, 0, 0, 0)
+ * const vector = d.vec4i(1); // (1, 1, 1, 1)
+ * const vector = d.vec4i(1, 2, 3, -4); // (1, 2, 3, -4)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec4i, d.vec4i(0, 1, 2, 3)); // buffer holding a d.vec4i value, with an initial value of vec4i(0, 1, 2, 3);
+ */
+declare const vec4i: NativeVec4i;
+/**
+ * Type of the `d.vec4u` object/function: vector data type schema/constructor
+ */
+type NativeVec4u = Vec4u & {
+    '~exotic': Vec4u;
+} & ((x: number, y: number, z: number, w: number) => v4u) & ((xyzw: number) => v4u) & (() => v4u);
+/**
+ *
+ * Schema representing vec4u - a vector with 4 elements of type u32.
+ * Also a constructor function for this vector value.
+ *
+ * @example
+ * const vector = d.vec4u(); // (0, 0, 0, 0)
+ * const vector = d.vec4u(1); // (1, 1, 1, 1)
+ * const vector = d.vec4u(1, 2, 3, 4); // (1, 2, 3, 4)
+ *
+ * @example
+ * const buffer = root.createBuffer(d.vec4u, d.vec4u(0, 1, 2, 3)); // buffer holding a d.vec4u value, with an initial value of vec4u(0, 1, 2, 3);
+ */
+declare const vec4u: NativeVec4u;
+
+declare const vertexFormats: readonly ["uint8x2", "uint8x4", "sint8x2", "sint8x4", "unorm8x2", "unorm8x4", "snorm8x2", "snorm8x4", "uint16x2", "uint16x4", "sint16x2", "sint16x4", "unorm16x2", "unorm16x4", "snorm16x2", "snorm16x4", "float16x2", "float16x4", "float32", "float32x2", "float32x3", "float32x4", "uint32", "uint32x2", "uint32x3", "uint32x4", "sint32", "sint32x2", "sint32x3", "sint32x4", "unorm10-10-10-2"];
+type VertexFormat = (typeof vertexFormats)[number];
+
+type FormatToWGSLType<T extends VertexFormat> = (typeof formatToWGSLType)[T];
+interface TgpuVertexFormatData<T extends VertexFormat> {
+    readonly '~repr': Infer<FormatToWGSLType<T>>;
+    readonly type: T;
+}
+declare const formatToWGSLType: {
+    readonly uint8x2: NativeVec2u;
+    readonly uint8x4: NativeVec4u;
+    readonly sint8x2: NativeVec2i;
+    readonly sint8x4: NativeVec4i;
+    readonly unorm8x2: NativeVec2f;
+    readonly unorm8x4: NativeVec4f;
+    readonly snorm8x2: NativeVec2f;
+    readonly snorm8x4: NativeVec4f;
+    readonly uint16x2: NativeVec2u;
+    readonly uint16x4: NativeVec4u;
+    readonly sint16x2: NativeVec2i;
+    readonly sint16x4: NativeVec4i;
+    readonly unorm16x2: NativeVec2f;
+    readonly unorm16x4: NativeVec4f;
+    readonly snorm16x2: NativeVec2f;
+    readonly snorm16x4: NativeVec4f;
+    readonly float16x2: NativeVec2f;
+    readonly float16x4: NativeVec4f;
+    readonly float32: NativeF32;
+    readonly float32x2: NativeVec2f;
+    readonly float32x3: NativeVec3f;
+    readonly float32x4: NativeVec4f;
+    readonly uint32: NativeU32;
+    readonly uint32x2: NativeVec2u;
+    readonly uint32x3: NativeVec3u;
+    readonly uint32x4: NativeVec4u;
+    readonly sint32: NativeI32;
+    readonly sint32x2: NativeVec2i;
+    readonly sint32x3: NativeVec3i;
+    readonly sint32x4: NativeVec4i;
+    readonly 'unorm10-10-10-2': NativeVec4f;
+};
+declare const packedFormats: string[];
+type uint8x2 = TgpuVertexFormatData<'uint8x2'>;
+declare const uint8x2: uint8x2;
+type uint8x4 = TgpuVertexFormatData<'uint8x4'>;
+declare const uint8x4: uint8x4;
+type sint8x2 = TgpuVertexFormatData<'sint8x2'>;
+declare const sint8x2: sint8x2;
+type sint8x4 = TgpuVertexFormatData<'sint8x4'>;
+declare const sint8x4: sint8x4;
+type unorm8x2 = TgpuVertexFormatData<'unorm8x2'>;
+declare const unorm8x2: unorm8x2;
+type unorm8x4 = TgpuVertexFormatData<'unorm8x4'>;
+declare const unorm8x4: unorm8x4;
+type snorm8x2 = TgpuVertexFormatData<'snorm8x2'>;
+declare const snorm8x2: snorm8x2;
+type snorm8x4 = TgpuVertexFormatData<'snorm8x4'>;
+declare const snorm8x4: snorm8x4;
+type uint16x2 = TgpuVertexFormatData<'uint16x2'>;
+declare const uint16x2: uint16x2;
+type uint16x4 = TgpuVertexFormatData<'uint16x4'>;
+declare const uint16x4: uint16x4;
+type sint16x2 = TgpuVertexFormatData<'sint16x2'>;
+declare const sint16x2: sint16x2;
+type sint16x4 = TgpuVertexFormatData<'sint16x4'>;
+declare const sint16x4: sint16x4;
+type unorm16x2 = TgpuVertexFormatData<'unorm16x2'>;
+declare const unorm16x2: unorm16x2;
+type unorm16x4 = TgpuVertexFormatData<'unorm16x4'>;
+declare const unorm16x4: unorm16x4;
+type snorm16x2 = TgpuVertexFormatData<'snorm16x2'>;
+declare const snorm16x2: snorm16x2;
+type snorm16x4 = TgpuVertexFormatData<'snorm16x4'>;
+declare const snorm16x4: snorm16x4;
+type float16x2 = TgpuVertexFormatData<'float16x2'>;
+declare const float16x2: float16x2;
+type float16x4 = TgpuVertexFormatData<'float16x4'>;
+declare const float16x4: float16x4;
+type float32 = TgpuVertexFormatData<'float32'>;
+declare const float32: float32;
+type float32x2 = TgpuVertexFormatData<'float32x2'>;
+declare const float32x2: float32x2;
+type float32x3 = TgpuVertexFormatData<'float32x3'>;
+declare const float32x3: float32x3;
+type float32x4 = TgpuVertexFormatData<'float32x4'>;
+declare const float32x4: float32x4;
+type uint32 = TgpuVertexFormatData<'uint32'>;
+declare const uint32: uint32;
+type uint32x2 = TgpuVertexFormatData<'uint32x2'>;
+declare const uint32x2: uint32x2;
+type uint32x3 = TgpuVertexFormatData<'uint32x3'>;
+declare const uint32x3: uint32x3;
+type uint32x4 = TgpuVertexFormatData<'uint32x4'>;
+declare const uint32x4: uint32x4;
+type sint32 = TgpuVertexFormatData<'sint32'>;
+declare const sint32: sint32;
+type sint32x2 = TgpuVertexFormatData<'sint32x2'>;
+declare const sint32x2: sint32x2;
+type sint32x3 = TgpuVertexFormatData<'sint32x3'>;
+declare const sint32x3: sint32x3;
+type sint32x4 = TgpuVertexFormatData<'sint32x4'>;
+declare const sint32x4: sint32x4;
+type unorm10_10_10_2 = TgpuVertexFormatData<'unorm10-10-10-2'>;
+declare const unorm10_10_10_2: unorm10_10_10_2;
+type PackedData = uint8x2 | uint8x4 | sint8x2 | sint8x4 | unorm8x2 | unorm8x4 | snorm8x2 | snorm8x4 | uint16x2 | uint16x4 | sint16x2 | sint16x4 | unorm16x2 | unorm16x4 | snorm16x2 | snorm16x4 | float16x2 | float16x4 | float32 | float32x2 | float32x3 | float32x4 | uint32 | uint32x2 | uint32x3 | uint32x4 | sint32 | sint32x2 | sint32x3 | sint32x4 | unorm10_10_10_2;
+
+/**
+ * Array schema constructed via `d.looseArrayOf` function.
+ *
+ * Useful for defining vertex buffers.
+ * Elements in the schema are not aligned in respect to their `byteAlignment`,
+ * unless they are explicitly decorated with the custom align attribute
+ * via `d.align` function.
+ */
+interface LooseArray<TElement extends BaseWgslData = BaseWgslData> {
+    readonly type: 'loose-array';
+    readonly elementCount: number;
+    readonly elementType: TElement;
+    readonly '~repr': Infer<TElement>[];
+}
+/**
+ * Struct schema constructed via `d.looseStruct` function.
+ *
+ * Useful for defining vertex buffers, as the standard layout restrictions do not apply.
+ * Members are not aligned in respect to their `byteAlignment`,
+ * unless they are explicitly decorated with the custom align attribute
+ * via `d.align` function.
+ */
+interface LooseStruct<TProps extends Record<string, BaseWgslData> = Record<string, BaseWgslData>> {
+    readonly type: 'loose-struct';
+    readonly propTypes: TProps;
+    readonly '~repr': InferRecord<TProps>;
+}
+interface LooseDecorated<TInner extends BaseWgslData = BaseWgslData, TAttribs extends unknown[] = unknown[]> {
+    readonly type: 'loose-decorated';
+    readonly inner: TInner;
+    readonly attribs: TAttribs;
+    readonly '~repr': Infer<TInner>;
+}
+declare const looseTypeLiterals: readonly ["loose-struct", "loose-array", "loose-decorated", "uint8x2", "uint8x4", "sint8x2", "sint8x4", "unorm8x2", "unorm8x4", "snorm8x2", "snorm8x4", "uint16x2", "uint16x4", "sint16x2", "sint16x4", "unorm16x2", "unorm16x4", "snorm16x2", "snorm16x4", "float16x2", "float16x4", "float32", "float32x2", "float32x3", "float32x4", "uint32", "uint32x2", "uint32x3", "uint32x4", "sint32", "sint32x2", "sint32x3", "sint32x4", "unorm10-10-10-2"];
+type LooseTypeLiteral = (typeof looseTypeLiterals)[number];
+type AnyLooseData = LooseArray | LooseStruct | LooseDecorated | PackedData;
+declare function isLooseData(data: unknown): data is AnyLooseData;
+/**
+ * Checks whether the passed in value is a loose-array schema,
+ * as opposed to, e.g., a regular array schema.
+ *
+ * Array schemas can be used to describe uniform and storage buffers,
+ * whereas looseArray schemas cannot. Loose arrays are useful for
+ * defining vertex buffers instead.
+ *
+ * @example
+ * isLooseArray(d.arrayOf(d.u32, 4)) // false
+ * isLooseArray(d.looseArrayOf(d.u32, 4)) // true
+ * isLooseArray(d.vec3f) // false
+ */
+declare function isLooseArray<T extends LooseArray>(schema: T | unknown): schema is T;
+/**
+ * Checks whether passed in value is a looseStruct schema,
+ * as opposed to, e.g., a struct schema.
+ *
+ * Struct schemas can be used to describe uniform and storage buffers,
+ * whereas looseStruct schemas cannot. Loose structs are useful for
+ * defining vertex buffers instead.
+ *
+ * @example
+ * isLooseStruct(d.struct({ a: d.u32 })) // false
+ * isLooseStruct(d.looseStruct({ a: d.u32 })) // true
+ * isLooseStruct(d.vec3f) // false
+ */
+declare function isLooseStruct<T extends LooseStruct>(schema: T | unknown): schema is T;
+declare function isLooseDecorated<T extends LooseDecorated>(value: T | unknown): value is T;
+declare function isData(value: unknown): value is AnyData;
+type AnyData = AnyWgslData | AnyLooseData;
+
+/**
+ * Strips schema types down to their most basic forms. (native -> exotic)
+ * This is used by schema constructors to be able to ingest native schemas (created by TypeGPU), and
+ * spit out a type that matches non-native schemas as well.
+ */
+type Exotic<T> = T extends {
+    readonly '~exotic': infer TExotic;
+} ? TExotic : T;
+type ExoticRecord<T> = T extends Record<string | number | symbol, unknown> ? {
+    [Key in keyof T]: Exotic<T[Key]>;
+} : T;
+
+/**
+ * Can be assigned a name. Not to be confused with
+ * being able to HAVE a name.
+ */
+interface TgpuNamable {
+    $name(label?: string | undefined): this;
+}
+
+type Default<T, TDefault> = unknown extends T ? TDefault : T extends undefined ? TDefault : T;
+type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * Removes properties from record type that extend `Prop`
+ */
+type OmitProps<T extends Record<string, unknown>, Prop> = Pick<T, {
+    [Key in keyof T]: T[Key] extends Prop ? never : Key;
+}[keyof T]>;
+/**
+ * The opposite of Readonly<T>
+ */
+type Mutable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+
+export { isLocationAttrib as $, type AnyData as A, type BaseWgslData as B, bool as C, type Default as D, type Exotic as E, type F32 as F, f32 as G, f16 as H, type I32 as I, i32 as J, u32 as K, type Location as L, type Mutable as M, isWgslData as N, type OmitProps as O, type Prettify as P, isWgslArray as Q, isWgslStruct as R, type Size as S, type TgpuNamable as T, type U32 as U, type Vec4f as V, type WgslTypeLiteral as W, isAtomic as X, isDecorated as Y, isAlignAttrib as Z, isBuiltinAttrib as _, type Vec4u as a, type PackedData as a$, isSizeAttrib as a0, type Bool as a1, type F16 as a2, type Vec2f as a3, type Vec2i as a4, type Vec2u as a5, type Vec3f as a6, type Vec3i as a7, type Vec3u as a8, type v2i as a9, unorm8x2 as aA, unorm8x4 as aB, snorm8x2 as aC, snorm8x4 as aD, uint16x2 as aE, uint16x4 as aF, sint16x2 as aG, sint16x4 as aH, unorm16x2 as aI, unorm16x4 as aJ, snorm16x2 as aK, snorm16x4 as aL, float16x2 as aM, float16x4 as aN, float32 as aO, float32x2 as aP, float32x3 as aQ, float32x4 as aR, uint32 as aS, uint32x2 as aT, uint32x3 as aU, uint32x4 as aV, sint32 as aW, sint32x2 as aX, sint32x3 as aY, sint32x4 as aZ, unorm10_10_10_2 as a_, type v2u as aa, type v3i as ab, type v3u as ac, type v4i as ad, type v4u as ae, vec2f as af, vec2i as ag, vec2u as ah, vec3f as ai, vec3i as aj, vec3u as ak, vec4f as al, vec4i as am, vec4u as an, isLooseArray as ao, isLooseStruct as ap, isLooseDecorated as aq, isData as ar, isLooseData as as, type FormatToWGSLType as at, type TgpuVertexFormatData as au, packedFormats as av, uint8x2 as aw, uint8x4 as ax, sint8x2 as ay, sint8x4 as az, type Vec4i as b, type UnionToIntersection as c, type Infer as d, type AnyWgslData as e, type Align as f, type Builtin as g, type Decorated as h, type LooseDecorated as i, type AnyLooseData as j, type LooseTypeLiteral as k, type WgslStruct as l, type ExoticRecord as m, type WgslArray as n, type LooseArray as o, type LooseStruct as p, type m2x2f as q, type m3x3f as r, type m4x4f as s, type Mat2x2f as t, type Mat3x3f as u, type v2f as v, type v3f as w, type Mat4x4f as x, type v4f as y, type Atomic as z };