Merge branch 'main' into impr/operator-!

Author: cieplypolar

apps/treeshake-test/package.json

@@ -15,7 +15,7 @@
   "devDependencies": {
     "@types/node": "catalog:types",
     "arktype": "1.0.29-alpha",
-    "esbuild": "^0.25.10",
+    "esbuild": "^0.25.11",
     "ts-loader": "^9.5.4",
     "tsdown": "^0.15.6",
     "tsx": "^4.19.2",

apps/typegpu-docs/package.json

@@ -42,7 +42,7 @@
     "fuse.js": "catalog:frontend",
     "jotai": "^2.15.0",
     "jotai-location": "^0.6.2",
-    "lodash": "^4.17.21",
+    "lodash": "^4.18.1",
     "lucide-react": "^0.536.0",
     "lz-string": "^1.5.0",
     "morphcharts": "^1.3.2",
@@ -86,6 +86,6 @@
     "typegpu-testing-utility": "workspace:*",
     "vite-imagetools": "catalog:frontend",
     "vite-plugin-wasm": "^3.5.0",
-    "yaml": "^2.8.1"
+    "yaml": "^2.8.3"
   }
 }

apps/typegpu-docs/src/content/docs/fundamentals/accessors.mdx

@@ -308,7 +308,7 @@ import tgpu, { d, std } from 'typegpu';
 
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable']
+const texture = root
   .createTexture({ format: 'rgba8unorm', size: [100, 100] })
   .$usage('storage');
 

apps/typegpu-docs/src/content/docs/fundamentals/data-schemas.mdx

@@ -364,7 +364,7 @@ Texture schemas serve two main purposes:
 import tgpu, { d, std } from 'typegpu';
 
 const root = await tgpu.init();
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled', 'storage');

apps/typegpu-docs/src/content/docs/fundamentals/textures.mdx

@@ -21,7 +21,7 @@ import tgpu, { d } from 'typegpu';
 
 const root = await tgpu.init();
 
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm' as const,
 }).$usage('sampled');
@@ -40,7 +40,7 @@ const sampledView = texture.createView();
 
 ## Creating a texture
 
-Textures can be created using the `root['~unstable'].createTexture` method. It accepts a descriptor similar to vanilla `GPUTextureDescriptor`. If specified, the properties will be reflected in the created texture type - this will later help with static checks when creating views or binding the texture in a layout.
+Textures can be created using the `root.createTexture` method. It accepts a descriptor similar to vanilla `GPUTextureDescriptor`. If specified, the properties will be reflected in the created texture type - this will later help with static checks when creating views or binding the texture in a layout.
 
 ```ts
 type TextureProps = {
@@ -57,7 +57,7 @@ type TextureProps = {
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
 //    ^?
   size: [512, 512, 128],
   format: 'rgba8unorm',
@@ -74,7 +74,7 @@ Similar to buffers, textures need usage flags to specify how they will be used.
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 })
@@ -89,7 +89,7 @@ You can also add multiple flags at once:
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled', 'storage', 'render');
@@ -122,7 +122,7 @@ You can write various image sources to textures. `ExternalImageSource` includes:
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled');
@@ -155,7 +155,7 @@ declare const imageBitmap1: ImageBitmap;
 declare const imageBitmap2: ImageBitmap;
 declare const imageBitmap3: ImageBitmap;
 // ---cut---
-const texture3d = root['~unstable'].createTexture({
+const texture3d = root.createTexture({
   size: [256, 256, 3],
   format: 'rgba8unorm',
   dimension: '3d',
@@ -173,7 +173,7 @@ You can write raw binary data directly to textures using `ArrayBuffer`, typed ar
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [2, 2],
   format: 'rgba8unorm',
 }).$usage('sampled');
@@ -198,12 +198,12 @@ You can also copy from another texture:
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const sourceTexture = root['~unstable'].createTexture({
+const sourceTexture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled');
 
-const targetTexture = root['~unstable'].createTexture({
+const targetTexture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled');
@@ -220,7 +220,7 @@ import tgpu from 'typegpu';
 const root = await tgpu.init();
 declare const imageBitmap: ImageBitmap;
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
   mipLevelCount: 9, // log2(256) + 1
@@ -242,7 +242,7 @@ To create a view - which will also serve as fixed texture usage - you can use on
 import tgpu, { d } from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [512, 512],
   format: 'rgba8unorm',
 }).$usage('sampled');
@@ -260,7 +260,7 @@ If type information is available the view schema will be staticly checked agains
 import tgpu, { d } from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [512, 512],
   format: 'rgba8unorm',
 }); // <-- missing .$usage('sampled')
@@ -273,7 +273,7 @@ const sampledView = texture.createView(d.texture2d(d.f32));
 import tgpu, { d } from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [512, 512],
   format: 'r32float',
 }).$usage('storage');
@@ -291,7 +291,7 @@ To sample textures in shaders, you'll often need a sampler that defines how the
 import tgpu from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const sampler = root['~unstable'].createSampler({
+const sampler = root.createSampler({
   magFilter: 'linear',
   minFilter: 'linear',
   mipmapFilter: 'linear',
@@ -312,12 +312,12 @@ Textures can be used in shaders through bind groups or as fixed resources, simil
 import tgpu, { d } from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled');
 
-const sampler = root['~unstable'].createSampler({
+const sampler = root.createSampler({
   magFilter: 'linear',
   minFilter: 'linear',
 });
@@ -343,15 +343,15 @@ For textures that remain consistent across operations, you can create fixed text
 import tgpu, { d, std } from 'typegpu';
 const root = await tgpu.init();
 // ---cut---
-const texture = root['~unstable'].createTexture({
+const texture = root.createTexture({
   size: [256, 256],
   format: 'rgba8unorm',
 }).$usage('sampled');
 
 // Create a fixed sampled view
 const sampledView = texture.createView();
 
-const sampler = root['~unstable'].createSampler({
+const sampler = root.createSampler({
   magFilter: 'linear',
   minFilter: 'linear',
 });