Merge branch 'main' into macros-page

MaryaBelanger · web-flow · commit b41c7bebc637 · 2024-05-13T15:57:13.000-07:00
diff --git a/examples/analysis/pubspec.yaml b/examples/analysis/pubspec.yaml
@@ -2,7 +2,7 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   examples_util: {path: ../util}
diff --git a/examples/analysis_alt/pubspec.yaml b/examples/analysis_alt/pubspec.yaml
@@ -2,7 +2,7 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   lints: ^4.0.0
diff --git a/examples/async_await/pubspec.yaml b/examples/async_await/pubspec.yaml
@@ -2,7 +2,7 @@ name: async_await
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   examples_util: {path: ../util}
diff --git a/examples/build_runner_usage/pubspec.yaml b/examples/build_runner_usage/pubspec.yaml
@@ -2,7 +2,7 @@ name: build_runner_usage
 description: dart.dev build_runner example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   args: ^2.4.0
diff --git a/examples/cli/pubspec.yaml b/examples/cli/pubspec.yaml
@@ -2,7 +2,7 @@ name: cli_examples
 description: Examples for CLI tutorials on dart.dev
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   args: ^2.4.2
diff --git a/examples/concurrency/pubspec.yaml b/examples/concurrency/pubspec.yaml
@@ -4,7 +4,7 @@ version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   http: any
diff --git a/examples/create_libraries/pubspec.yaml b/examples/create_libraries/pubspec.yaml
@@ -3,7 +3,7 @@ description: dart.dev example code.
 version: 1.0.0
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   lints: ^4.0.0
diff --git a/examples/extension_methods/pubspec.yaml b/examples/extension_methods/pubspec.yaml
@@ -3,7 +3,7 @@ description: dart.dev example code.
 version: 1.0.0
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   lints: ^4.0.0
diff --git a/examples/fetch_data/pubspec.yaml b/examples/fetch_data/pubspec.yaml
@@ -3,7 +3,7 @@ description: Fetch data example
 version: 0.0.1
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   http: ^1.2.0
diff --git a/examples/futures/pubspec.yaml b/examples/futures/pubspec.yaml
@@ -4,7 +4,7 @@ version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   examples_util: {path: ../util}
diff --git a/examples/html/pubspec.yaml b/examples/html/pubspec.yaml
@@ -3,7 +3,7 @@ description: dart.dev example code.
 version: 0.0.1
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   lints: ^4.0.0
diff --git a/examples/iterables/pubspec.yaml b/examples/iterables/pubspec.yaml
@@ -2,7 +2,7 @@ name: iterables_examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   examples_util: {path: ../util}
diff --git a/examples/language/pubspec.yaml b/examples/language/pubspec.yaml
@@ -2,7 +2,7 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   examples_util: { path: ../util }
diff --git a/examples/misc/pubspec.yaml b/examples/misc/pubspec.yaml
@@ -2,7 +2,7 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   args: ^2.4.2
diff --git a/examples/non_promotion/pubspec.yaml b/examples/non_promotion/pubspec.yaml
@@ -3,7 +3,7 @@ description: dart.dev non-promotion examples.
 version: 0.0.1
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   lints: ^4.0.0
diff --git a/examples/null_safety_codelab/pubspec.yaml b/examples/null_safety_codelab/pubspec.yaml
@@ -2,7 +2,7 @@ name: null_safety_codelab_examples
 description: dart.dev example code for null safety codelab
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   examples_util: {path: ../util}
diff --git a/examples/type_system/pubspec.yaml b/examples/type_system/pubspec.yaml
@@ -2,7 +2,7 @@ name: type_system_examples
 description: dart.dev type system examples.
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   examples_util: {path: ../util}
diff --git a/examples/util/pubspec.yaml b/examples/util/pubspec.yaml
@@ -3,7 +3,7 @@ description: dart.dev example utilities.
 version: 0.0.2
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dependencies:
   test: ^1.25.2
diff --git a/examples/vector_victor/pubspec.yaml b/examples/vector_victor/pubspec.yaml
@@ -4,7 +4,7 @@ version: 1.0.0
 # homepage: https://www.example.com
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 # dependencies:
 #   path: ^1.8.0
diff --git a/pubspec.yaml b/pubspec.yaml
@@ -3,7 +3,7 @@ publish_to: none
 homepage: https://dart.dev
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 
 dev_dependencies:
   dart_site:
diff --git a/site-shared b/site-shared
@@ -1 +1 @@
-Subproject commit 80f090a5942a6988c3c78417a2dec4387546c043
+Subproject commit e466136cd77d715352a7f86a7abf563a1cfce735
diff --git a/src/_data/side-nav.yml b/src/_data/side-nav.yml
@@ -237,6 +237,8 @@
           permalink: /web/deployment
         - title: Libraries & packages
           permalink: /web/libraries
+        - title: Wasm compilation
+          permalink: /web/wasm
     - title: Environment declarations
       permalink: /guides/environment-declarations
 
diff --git a/src/_data/site.yml b/src/_data/site.yml
@@ -38,4 +38,4 @@ og_image_vers: "?2"
 
 sdkInfo:
   channel: stable
-  version: 3.3.2
+  version: 3.4.0
diff --git a/src/content/interop/js-interop/index.md b/src/content/interop/js-interop/index.md
@@ -35,7 +35,7 @@ check out the [Past JS interop][] page for a more in depth summary on past
 iterations.
 
 [recently]: https://medium.com/dartlang/dart-3-3-325bf2bf6c13
-[Wasm]: {{site.flutter-docs}}/platform-integration/web/wasm
+[Wasm]: /web/wasm
 [`package:web`]: {{site.pub-pkg}}/web
 [`dart:html`]: {{site.dart-api}}/dart-html/dart-html-library.html
 [`dart:svg`]: {{site.dart-api}}/dart-svg/dart-svg-library.html
diff --git a/src/content/interop/js-interop/js-types.md b/src/content/interop/js-interop/js-types.md
@@ -4,7 +4,7 @@ description: Usage information about the core types in JS interop.
 ---
 
 Dart values and JS values belong to separate language domains. When compiling to
-Wasm, they execute in separate *runtimes* as well. As such, you should treat JS
+[Wasm][], they execute in separate *runtimes* as well. As such, you should treat JS
 values as foreign types. To provide Dart types for JS values,
 [`dart:js_interop`] exposes a set of types prefixed with `JS` called "JS types".
 These types are used to distinguish between Dart values and JS values at
@@ -90,7 +90,7 @@ Generally, the conversion table looks like the following:
 </div>
 
 :::warning
-Compiling to JavaScript vs Wasm can introduce inconsistencies in both
+Compiling to JavaScript vs [Wasm][] can introduce inconsistencies in both
 performance and semantics for conversions. Conversions may have different costs
 depending on the compiler, so prefer to only convert values if you need to.
 
@@ -233,7 +233,7 @@ error if the value returned was JS `null` or `undefined` to ensure soundness.
 
 :::warning
 There is a subtle inconsistency with regards to `undefined` between compiling to
-JS and Wasm. While compiling to JS *treats* `undefined` values as if they were
+JS and [Wasm][]. While compiling to JS *treats* `undefined` values as if they were
 Dart `null`, it doesn't actually *change* the value itself. If an interop member
 returns `undefined` and you pass that value back into JS, JS will see
 `undefined`, *not* `null`, when compiling to JS.
@@ -279,4 +279,5 @@ See [`toExternalReference`] and [`toDartObject`] to convert to and from an
 [`JSBoxedDartObject`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/JSBoxedDartObject-extension-type.html
 [`ExternalDartReference`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/ExternalDartReference-extension-type.html
 [`toExternalReference`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/ObjectToExternalDartReference/toExternalReference.html
-[`toDartObject`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/ExternalDartReferenceToObject/toDartObject.html
+[`toDartObject`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/ExternalDartReferenceToObject/toDartObject.html
+[Wasm]: /web/wasm
diff --git a/src/content/interop/js-interop/package-web.md b/src/content/interop/js-interop/package-web.md
@@ -298,7 +298,7 @@ Do we have any other package migrations to show off here?
 {% endcomment -%}
 
 [`package:web`]: {{site.pub-pkg}}/web
-[Wasm]: {{site.repo.dart.sdk}}/blob/main/pkg/dart2wasm/README.md
+[Wasm]: /web/wasm
 [html]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-html/dart-html-library.html
 [svg]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-svg/dart-svg-library.html
 [`dart:js_interop`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/dart-js_interop-library.html
diff --git a/src/content/interop/js-interop/past-js-interop.md b/src/content/interop/js-interop/past-js-interop.md
@@ -4,7 +4,7 @@ description: Archive of past JS interop implementations.
 ---
 
 :::warning
-None of these legacy interop libraries are supported when compiling to Wasm.
+None of these legacy interop libraries are supported when compiling to [Wasm][].
 :::
 
 This page addresses previous iterations of JS interop for Dart that are
@@ -121,3 +121,4 @@ TODO: Link to `package:web` section
 [`dart:js_util`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_util
 [`Function.toJS`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop/FunctionToJSExportedDartFunction/toJS.html
 [`dart:js_interop_unsafe`]: {{site.dart-api}}/{{site.sdkInfo.channel}}/dart-js_interop_unsafe
+[Wasm]: /web/wasm
diff --git a/src/content/overview.md b/src/content/overview.md
@@ -184,8 +184,8 @@ Dart's compiler technology lets you run code in different ways:
   an ahead-of-time (AOT) compiler for producing machine code.
 
 * **Web platform**: For apps targeting the web, Dart can compile for
-  development or production purposes. Its web compiler translates Dart
-  into JavaScript.
+  development or production purposes. Its web compilers translate Dart
+  into JavaScript or WebAssembly.
 
 <img 
   src="/assets/img/Dart-platforms.svg" 
@@ -221,26 +221,31 @@ More information:
 * [Write command-line apps](/tutorials/server/cmdline)
 * [Write HTTP servers](/tutorials/server/httpserver)
 
-#### Dart Web (JavaScript dev & prod) {:#web-platform}
+#### Dart Web (JavaScript dev & prod and WebAssembly) {:#web-platform}
 
 Dart Web enables running Dart code on web platforms powered by
 JavaScript. With Dart Web, you compile Dart code to JavaScript code, which in
 turn runs in a browser—for example, [V8](https://v8.dev/) inside
 [Chrome](https://www.google.com/chrome/).
+Alternatively, Dart code can be compiled to WebAssembly.
 
-Dart web contains two compilation modes:
+Dart web contains three compilation modes:
 
-* An incremental development compiler enabling a fast developer cycle
-* An optimizing production compiler which compiles Dart code to fast,
-  compact, deployable JavaScript. These efficiencies come from
-  techniques such as dead-code elimination.
+* An incremental JavaScript development compiler enabling a fast developer 
+  cycle.
+* An optimizing JavaScript production compiler which compiles Dart code to fast,
+  compact, deployable JavaScript. These efficiencies come from techniques such
+  as dead-code elimination.
+* An optimizing WebAssembly (WasmGC) production compiler which compiles Dart
+  code to super-fast, deployable WebAssembly GC code.
 
 More information:
 
 * [Build a web app with Dart](/web/get-started)
 * [`dart compile js`](/tools/dart-compile#js)
 * [`webdev` tool](/tools/webdev)
 * [Web deployment tips](/web/deployment)
+* [WebAssembly compilation](/web/wasm)
 
 #### The Dart runtime {:#runtime}
 
diff --git a/src/content/tools/dart-compile.md b/src/content/tools/dart-compile.md
@@ -117,6 +117,14 @@ The following table shows the subcommands of `dart compile`.
       <br><em><a href="#js">Learn more.</a></em>
     </td>
   </tr>
+  <tr>
+    <td> <code>wasm</code> </td>
+    <td> WebAssembly </td>
+    <td> A portable, binary instruction format for a stack-based virtual machine.
+         Currently under development.
+      <br><em><a href="/web/wasm">Learn more.</a></em>
+    </td>
+  </tr>
 </table>
 
 
diff --git a/src/content/tutorials/server/cmdline.md b/src/content/tutorials/server/cmdline.md
@@ -191,7 +191,7 @@ $ dart run bin/dcat.dart -n pubspec.yaml
 4 # repository: https://github.com/my_org/my_repo
 5 
 6 environment:
-7   sdk: ^3.3.0
+7   sdk: ^3.4.0
 8 
 9 # Add regular dependencies here.
 10 dependencies:
diff --git a/src/content/web/wasm.md b/src/content/web/wasm.md
diff --git a/tool/dart_site/pubspec.yaml b/tool/dart_site/pubspec.yaml
diff --git a/tool/get-dart/archive/pubspec.yaml b/tool/get-dart/archive/pubspec.yaml
diff --git a/tool/get-dart/dart_sdk_archive/pubspec.yaml b/tool/get-dart/dart_sdk_archive/pubspec.yaml
diff --git a/tool/get-dart/sdk_builds.dart/pubspec.yaml b/tool/get-dart/sdk_builds.dart/pubspec.yaml

Original file line number	Diff line number	Diff line change
`@@ -191,7 +191,7 @@ $ dart run bin/dcat.dart -n pubspec.yaml`
`191`	`191`	`4 # repository: https://github.com/my_org/my_repo`
`192`	`192`	`5`
`193`	`193`	`6 environment:`
`194`		`-7 sdk: ^3.3.0`
	`194`	`+7 sdk: ^3.4.0`
`195`	`195`	`8`
`196`	`196`	`9 # Add regular dependencies here.`
`197`	`197`	`10 dependencies:`