Sync generated docs

Author: kainino0x

dist/index.d.ts

@@ -675,7 +675,7 @@ interface GPUBufferBinding {
 
 interface GPUBufferBindingLayout {
   /**
-   * Indicates the type required for buffers bound to this bindings.
+   * Indicates the type required for buffers bound to this binding.
    */
   type?: GPUBufferBindingType;
   /**
@@ -1455,16 +1455,35 @@ interface GPURenderPipelineDescriptor
 
 interface GPURequestAdapterOptions {
   /**
-   * "Feature level" for the adapter request.
+   * Requests an adapter that supports at least a particular set of capabilities.
+   * This influences the {@link adapter/{@link https://www.w3.org/TR/webgpu/default feature level}} of devices created
+   * from this adapter. The capabilities for each level are defined below, and the exact
+   * steps are defined in {@link GPU#requestAdapter} and "a new device".
+   * If the implementation or system does not support all of the capabilities in the
+   * requested feature level, {@link GPU#requestAdapter} will return `null`.
+   * Note:
+   * Applications should typically make a single {@link GPU#requestAdapter} call with the lowest
+   * feature level they support, then inspect the adapter for additional capabilities they can
+   * use optionally, and request those in {@link GPUAdapter#requestDevice}.
    * The allowed <dfn dfn for="">feature level string</dfn> values are:
    * <dl dfn-type=dfn dfn-for="feature level string">
    * : <dfn noexport>"core"</dfn>
-   * No effect.
+   * The following set of capabilities:
+   * - The limit/Default limits.
+   * - {@link GPUFeatureName} `"core-features-and-limits"`.
+   * Note:
+   * Adapters with this {@link adapter/{@link https://www.w3.org/TR/webgpu/default feature level}} may
+   * conventionally be referred to as "Core-defaulting".
    * : <dfn noexport>"compatibility"</dfn>
-   * No effect.
+   * The following set of capabilities:
+   * - The limit/Compatibility Mode Default limits.
+   * - No features. (It excludes the {@link GPUFeatureName} `"core-features-and-limits"` feature.)
+   * If the implementation cannot enforce the stricter "Compatibility Mode"
+   * validation rules, {@link GPU#requestAdapter} will ignore this request and
+   * treat it as a request for feature level string/"core".
    * Note:
-   * This value is reserved for future use as a way to opt into additional validation restrictions.
-   * Applications should not use this value at this time.
+   * Adapters with this {@link adapter/{@link https://www.w3.org/TR/webgpu/default feature level}} may
+   * conventionally be referred to as "Compatibility-defaulting".
    */
   featureLevel?: string;
   /**
@@ -1765,20 +1784,20 @@ interface GPUTextureDescriptor
    * </div>
    * Formats in this list must be texture view format compatible with the texture format.
    * <div algorithm data-timeline=const>
-   * Two {@link GPUTextureFormat}s `format` and `viewFormat` are <dfn dfn for="">texture view format compatible</dfn> if:
+   * Two {@link GPUTextureFormat}s `format` and `viewFormat` are <dfn dfn for="">texture view format compatible</dfn> on a given `device` if:
    * - `format` equals `viewFormat`, or
-   * - `format` and `viewFormat` differ only in whether they are `srgb` formats (have the `-srgb` suffix).
+   * - `format` and `viewFormat` differ only in whether they are `srgb` formats (have the `-srgb` suffix) and `device.features` list/contains {@link GPUFeatureName} `"core-features-and-limits"`.
    * </div>
    */
   viewFormats?: Iterable<GPUTextureFormat>;
   /**
-   * **PROPOSED** in [Compatibility Mode](https://github.com/gpuweb/gpuweb/blob/main/proposals/compatibility-mode.md).
-   *
-   * > [In compatibility mode,]
-   * > When specifying a texture, a textureBindingViewDimension property
-   * > determines the views which can be bound from that texture for sampling.
-   * > Binding a view of a different dimension for sampling than specified at
-   * > texture creation time will cause a validation error.
+   * <div class=compatmode>
+   * On devices without {@link GPUFeatureName} `"core-features-and-limits"`,
+   * views created from this texture must have this as their {@link GPUTextureViewDescriptor#dimension}.
+   * If not specified, a default is chosen.
+   * </div>
+   * On devices with {@link GPUFeatureName} `"core-features-and-limits"`,
+   * this is ignored, and there is no such restriction.
    */
   textureBindingViewDimension?: GPUTextureViewDimension;
 }