feat: Stabilize tgpu.accessor and tgpu.mutableAccessor (#2167)

Author: iwoplaza

apps/typegpu-docs/src/content/docs/reference/naming-convention.mdx

@@ -75,7 +75,7 @@ const colorSlot = tgpu.slot(vec4f(1, 0, 0, 1));
 We give accessors *camelCase* names with the `Access` suffix.
 
 ```ts
-const colorAccess = tgpu['~unstable'].accessor(vec4f);
+const colorAccess = tgpu.accessor(vec4f);
 ```
 
 ## Lazy

apps/typegpu-docs/src/examples/algorithms/jump-flood-distance/types.ts

@@ -21,7 +21,7 @@ export const SampleResult = d.struct({
   outside: d.vec2f,
 });
 
-export const paramsAccess = tgpu['~unstable'].accessor(VisualizationParams);
+export const paramsAccess = tgpu.accessor(VisualizationParams);
 
 export const distSampleLayout = tgpu.bindGroupLayout({
   distTexture: { texture: d.texture2d() },

apps/typegpu-docs/src/examples/image-processing/background-segmentation/schemas.ts

@@ -42,8 +42,8 @@ export const Params = d.struct({
   sampleBias: d.f32,
 });
 
-export const paramsAccess = tgpu['~unstable'].accessor(Params);
-export const flipAccess = tgpu['~unstable'].accessor(d.bool);
+export const paramsAccess = tgpu.accessor(Params);
+export const flipAccess = tgpu.accessor(d.bool);
 
 export interface ModelConfig {
   name: string;

apps/typegpu-docs/src/examples/rendering/disco/consts.ts

@@ -1,4 +1,4 @@
 import tgpu, { d } from 'typegpu';
 
-export const timeAccess = tgpu['~unstable'].accessor(d.f32);
-export const resolutionAccess = tgpu['~unstable'].accessor(d.vec2f); // (width, height)
+export const timeAccess = tgpu.accessor(d.f32);
+export const resolutionAccess = tgpu.accessor(d.vec2f); // (width, height)

apps/typegpu-docs/src/examples/simulation/gravity/schemas.ts

@@ -55,11 +55,11 @@ export const renderSkyBoxVertexLayout = tgpu.vertexLayout(
   d.arrayOf(SkyBoxVertex),
 );
 
-export const cameraAccess = tgpu['~unstable'].accessor(Camera);
+export const cameraAccess = tgpu.accessor(Camera);
 export const filteringSamplerSlot = tgpu.slot<TgpuSampler>();
-export const lightSourceAccess = tgpu['~unstable'].accessor(d.vec3f);
-export const timeAccess = tgpu['~unstable'].accessor(Time);
-export const skyBoxAccess = tgpu['~unstable'].accessor(d.textureCube(d.f32));
+export const lightSourceAccess = tgpu.accessor(d.vec3f);
+export const timeAccess = tgpu.accessor(Time);
+export const skyBoxAccess = tgpu.accessor(d.textureCube(d.f32));
 
 export const renderBindGroupLayout = tgpu
   .bindGroupLayout({

packages/typegpu-color/src/oklab.ts

@@ -270,7 +270,7 @@ const gamutClipPreserveChroma = tgpu.fn([vec3f], vec3f)((lab) => {
   return vec3f(L_clipped, C_clipped * a_, C_clipped * b_);
 });
 
-export const oklabGamutClipAlphaAccess = tgpu['~unstable'].accessor(f32, 0.2);
+export const oklabGamutClipAlphaAccess = tgpu.accessor(f32, 0.2);
 
 const gamutClipAdaptiveL05 = tgpu.fn([vec3f], vec3f)((lab) => {
   const alpha = oklabGamutClipAlphaAccess.$;

packages/typegpu-noise/src/perlin-2d/dynamic-cache.ts

@@ -132,8 +132,8 @@ export function dynamicCacheConfig<Prefix extends string>(
 ): DynamicPerlin2DCacheConfig<Prefix> {
   const { prefix = DefaultPerlin2DLayoutPrefix as Prefix } = options ?? {};
 
-  const sizeAccess = tgpu['~unstable'].accessor(d.vec2u);
-  const memoryAccess = tgpu['~unstable'].accessor(MemorySchema);
+  const sizeAccess = tgpu.accessor(d.vec2u);
+  const memoryAccess = tgpu.accessor(MemorySchema);
 
   const getJunctionGradient = tgpu.fn([d.vec2i], d.vec2f)((pos) => {
     const size = d.vec2i(sizeAccess.$);

packages/typegpu-noise/src/perlin-3d/dynamic-cache.ts

@@ -132,8 +132,8 @@ export function dynamicCacheConfig<Prefix extends string>(
 ): DynamicPerlin3DCacheConfig<Prefix> {
   const { prefix = DefaultPerlin3DLayoutPrefix as Prefix } = options ?? {};
 
-  const sizeAccess = tgpu['~unstable'].accessor(d.vec4u);
-  const memoryAccess = tgpu['~unstable'].accessor(MemorySchema);
+  const sizeAccess = tgpu.accessor(d.vec4u);
+  const memoryAccess = tgpu.accessor(MemorySchema);
 
   const getJunctionGradient = tgpu.fn([d.vec3i], d.vec3f)((pos) => {
     const size = d.vec3i(sizeAccess.$.xyz);

packages/typegpu/src/tgpu.ts

@@ -7,6 +7,7 @@ export { resolve, resolveWithContext } from './core/resolve/tgpuResolve.ts';
 export { init, initFromDevice } from './core/root/init.ts';
 export { slot } from './core/slot/slot.ts';
 export { lazy } from './core/slot/lazy.ts';
+export { accessor, mutableAccessor } from './core/slot/accessor.ts';
 export { privateVar, workgroupVar } from './core/variable/tgpuVariable.ts';
 export { vertexLayout } from './core/vertexLayout/vertexLayout.ts';
 export { bindGroupLayout } from './tgpuBindGroupLayout.ts';

packages/typegpu/src/tgpuUnstable.ts

@@ -1,56 +1,45 @@
 // NOTE: This is a barrel file, internal files should not import things from this file
 
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.const.
-   */
+  /** @deprecated This feature is now stable, use tgpu.const. */
   constant as const,
 } from './core/constant/tgpuConstant.ts';
 export { declare } from './core/declare/tgpuDeclare.ts';
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.comptime.
-   */
+  /** @deprecated This feature is now stable, use tgpu.comptime. */
   comptime,
 } from './core/function/comptime.ts';
 export { computeFn } from './core/function/tgpuComputeFn.ts';
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.fn.
-   */
+  /** @deprecated This feature is now stable, use tgpu.fn. */
   fn,
 } from './core/function/tgpuFn.ts';
 export { fragmentFn } from './core/function/tgpuFragmentFn.ts';
 export { vertexFn } from './core/function/tgpuVertexFn.ts';
 export { rawCodeSnippet } from './core/rawCodeSnippet/tgpuRawCodeSnippet.ts';
 export { namespace } from './core/resolve/namespace.ts';
 export { simulate } from './core/simulate/tgpuSimulate.ts';
-export { accessor, mutableAccessor } from './core/slot/accessor.ts';
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.lazy.
-   */
+  /** @deprecated This feature is now stable, use tgpu.accessor. */
+  accessor,
+  /** @deprecated This feature is now stable, use tgpu.mutableAccessor. */
+  mutableAccessor,
+} from './core/slot/accessor.ts';
+export {
+  /** @deprecated This feature is now stable, use tgpu.lazy. */
   lazy as derived,
 } from './core/slot/lazy.ts';
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.slot.
-   */
+  /** @deprecated This feature is now stable, use tgpu.slot. */
   slot,
 } from './core/slot/slot.ts';
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.privateVar.
-   */
+  /** @deprecated This feature is now stable, use tgpu.privateVar. */
   privateVar,
-  /**
-   * @deprecated This feature is now stable, use tgpu.workgroupVar.
-   */
+  /** @deprecated This feature is now stable, use tgpu.workgroupVar. */
   workgroupVar,
 } from './core/variable/tgpuVariable.ts';
 export {
-  /**
-   * @deprecated This feature is now stable, use tgpu.vertexLayout.
-   */
+  /** @deprecated This feature is now stable, use tgpu.vertexLayout. */
   vertexLayout,
 } from './core/vertexLayout/vertexLayout.ts';