feat: Add material 3 guide (#1236)

Author: mmalerba

material.angular.io/.aspect/rules/external_repository_action_cache/npm_translate_lock_LTE4Nzc1MDcwNjU=

@@ -2,6 +2,6 @@
 # Input hashes for repository rule npm_translate_lock(name = "npm", pnpm_lock = "//:pnpm-lock.yaml").
 # This file should be checked into version control along with the pnpm-lock.yaml file.
 .npmrc=-1306950124
-pnpm-lock.yaml=1756835753
-yarn.lock=1009768585
-package.json=-1257644840
+pnpm-lock.yaml=772880874
+yarn.lock=201241157
+package.json=1655886787

material.angular.io/package.json

@@ -30,24 +30,24 @@
   },
   "private": true,
   "dependencies": {
-    "@angular/animations": "^17.2.0-rc.0",
-    "@angular/cdk": "^17.2.0-rc.0",
-    "@angular/cdk-experimental": "^17.2.0-rc.0",
-    "@angular/common": "^17.2.0-rc.0",
-    "@angular/compiler": "^17.2.0-rc.0",
-    "@angular/components-examples": "https://github.com/angular/material2-docs-content.git#2cbeda837203364cc3603d7a6b574621e7c9f189",
-    "@angular/core": "^17.2.0-rc.0",
-    "@angular/forms": "^17.2.0-rc.0",
-    "@angular/google-maps": "^17.2.0-rc.0",
-    "@angular/localize": "^17.2.0-rc.0",
-    "@angular/material": "^17.2.0-rc.0",
-    "@angular/material-experimental": "^17.2.0-rc.0",
-    "@angular/material-moment-adapter": "^17.2.0-rc.0",
-    "@angular/platform-browser": "^17.2.0-rc.0",
-    "@angular/platform-browser-dynamic": "^17.2.0-rc.0",
-    "@angular/router": "^17.2.0-rc.0",
-    "@angular/ssr": "^17.2.0-rc.0",
-    "@angular/youtube-player": "^17.2.0-rc.0",
+    "@angular/animations": "^17.2.0",
+    "@angular/cdk": "^17.2.0",
+    "@angular/cdk-experimental": "^17.2.0",
+    "@angular/common": "^17.2.0",
+    "@angular/compiler": "^17.2.0",
+    "@angular/components-examples": "https://github.com/angular/material2-docs-content.git#a3db0dd92577982c00436c484fe2bfaca5a139a7",
+    "@angular/core": "^17.2.0",
+    "@angular/forms": "^17.2.0",
+    "@angular/google-maps": "^17.2.0",
+    "@angular/localize": "^17.2.0",
+    "@angular/material": "^17.2.0",
+    "@angular/material-experimental": "^17.2.0",
+    "@angular/material-moment-adapter": "^17.2.0",
+    "@angular/platform-browser": "^17.2.0",
+    "@angular/platform-browser-dynamic": "^17.2.0",
+    "@angular/router": "^17.2.0",
+    "@angular/ssr": "^17.2.0",
+    "@angular/youtube-player": "^17.2.0",
     "@stackblitz/sdk": "^1.5.2",
     "moment": "^2.29.1",
     "path-normalize": "^6.0.7",
@@ -56,15 +56,15 @@
     "zone.js": "~0.14.0"
   },
   "devDependencies": {
-    "@angular-devkit/architect": "^0.1702.0-rc.0",
-    "@angular-devkit/architect-cli": "^0.1702.0-rc.0",
-    "@angular-devkit/build-angular": "^17.2.0-rc.0",
+    "@angular-devkit/architect": "^0.1702.0",
+    "@angular-devkit/architect-cli": "^0.1702.0",
+    "@angular-devkit/build-angular": "^17.2.0",
     "@angular-eslint/builder": "^14.0.0",
     "@angular-eslint/eslint-plugin": "^14.0.0",
     "@angular-eslint/eslint-plugin-template": "^14.0.0",
     "@angular-eslint/template-parser": "^14.0.0",
-    "@angular/cli": "^17.2.0-rc.0",
-    "@angular/compiler-cli": "^17.2.0-rc.0",
+    "@angular/cli": "^17.2.0",
+    "@angular/compiler-cli": "^17.2.0",
     "@bazel/bazelisk": "^1.12.1",
     "@types/imagemin": "^7.0.0",
     "@types/jasmine": "^3.7.7",

material.angular.io/pnpm-lock.yaml

@@ -79,6 +79,12 @@ const GUIDES = [
     name: 'Migrating to MDC-based Components',
     document: '/docs-content/guides/v15-mdc-migration.html',
     overview: 'Learn how to migrate your app to the new MDC-based components available in v15.'
+  },
+  {
+    id: 'material-3',
+    name: 'Using Material 3 Themes (Experimental)',
+    document: '/docs-content/guides/material-3.html',
+    overview: 'Learn how to use Material 3 themes in your app.'
   }
 ];