main - 1dc6b44 docs(material/dialog): clarify that default options replace rather than merge (#32819)

Author: yogeshwaran-c

docs-content/overviews/cdk/dialog/dialog.md.html

@@ -109,7 +109,15 @@ <h3 id="specifying-global-configuration-defaults" class="docs-header-link">
   <span class="hljs-attr">providers</span>: [
     {<span class="hljs-attr">provide</span>: <span class="hljs-variable constant_">DEFAULT_DIALOG_CONFIG</span>, <span class="hljs-attr">useValue</span>: {<span class="hljs-attr">hasBackdrop</span>: <span class="hljs-literal">false</span>}}
   ]
-});</code></pre>
+});</code></pre><blockquote>
+<p><strong>Note:</strong> The value provided for <code>DEFAULT_DIALOG_CONFIG</code> <strong>replaces</strong> the built-in defaults
+entirely rather than merging with them. For example, providing <code>{disableClose: true}</code> means that
+all other defaults (such as <code>hasBackdrop</code>) will be <code>undefined</code>. If you only want to override
+specific properties, spread the defaults first:</p>
+<pre><code class="language-ts">{<span class="hljs-attr">provide</span>: <span class="hljs-variable constant_">DEFAULT_DIALOG_CONFIG</span>, <span class="hljs-attr">useValue</span>: {...<span class="hljs-keyword">new</span> <span class="hljs-title class_">DialogConfig</span>(), <span class="hljs-attr">disableClose</span>: <span class="hljs-literal">true</span>}}</code></pre><p>When you call <code>dialog.open()</code> with a config, that config is merged on top of these defaults, so
+per-dialog options always take precedence.</p>
+</blockquote>
+
         <h3 id="sharing-data-with-the-dialog-component" class="docs-header-link">
           <span header-link="sharing-data-with-the-dialog-component"></span>
           Sharing data with the Dialog component.

docs-content/overviews/material/dialog/dialog.md.html

@@ -36,7 +36,15 @@ <h3 id="specifying-global-configuration-defaults" class="docs-header-link">
   <span class="hljs-attr">providers</span>: [
     {<span class="hljs-attr">provide</span>: <span class="hljs-variable constant_">MAT_DIALOG_DEFAULT_OPTIONS</span>, <span class="hljs-attr">useValue</span>: {<span class="hljs-attr">hasBackdrop</span>: <span class="hljs-literal">false</span>}}
   ]
-});</code></pre>
+});</code></pre><blockquote>
+<p><strong>Note:</strong> The value provided for <code>MAT_DIALOG_DEFAULT_OPTIONS</code> <strong>replaces</strong> the built-in defaults
+entirely rather than merging with them. For example, providing <code>{disableClose: true}</code> means that
+all other defaults (such as <code>hasBackdrop</code>) will be <code>undefined</code>. If you only want to override
+specific properties, spread the defaults first:</p>
+<pre><code class="language-ts">{<span class="hljs-attr">provide</span>: <span class="hljs-variable constant_">MAT_DIALOG_DEFAULT_OPTIONS</span>, <span class="hljs-attr">useValue</span>: {...<span class="hljs-keyword">new</span> <span class="hljs-title class_">MatDialogConfig</span>(), <span class="hljs-attr">disableClose</span>: <span class="hljs-literal">true</span>}}</code></pre><p>When you call <code>dialog.open()</code> with a config, that config is merged on top of these defaults, so
+per-dialog options always take precedence.</p>
+</blockquote>
+
         <h3 id="sharing-data-with-the-dialog-component" class="docs-header-link">
           <span header-link="sharing-data-with-the-dialog-component"></span>
           Sharing data with the Dialog component.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/components-examples",
-  "version": "22.0.0-next.3+sha-8473a27",
+  "version": "22.0.0-next.3+sha-1dc6b44",
   "description": "Angular Components Examples",
   "private": true,
   "repository": {
@@ -255,15 +255,15 @@
   },
   "homepage": "https://github.com/angular/components#readme",
   "peerDependencies": {
-    "@angular/aria": "22.0.0-next.3+sha-8473a27",
-    "@angular/cdk": "22.0.0-next.3+sha-8473a27",
-    "@angular/cdk-experimental": "22.0.0-next.3+sha-8473a27",
+    "@angular/aria": "22.0.0-next.3+sha-1dc6b44",
+    "@angular/cdk": "22.0.0-next.3+sha-1dc6b44",
+    "@angular/cdk-experimental": "22.0.0-next.3+sha-1dc6b44",
     "@angular/core": "^22.0.0-0 || ^22.1.0-0 || ^22.2.0-0 || ^22.3.0-0 || ^23.0.0-0",
     "@angular/common": "^22.0.0-0 || ^22.1.0-0 || ^22.2.0-0 || ^22.3.0-0 || ^23.0.0-0",
-    "@angular/material": "22.0.0-next.3+sha-8473a27",
-    "@angular/material-experimental": "22.0.0-next.3+sha-8473a27",
-    "@angular/material-luxon-adapter": "22.0.0-next.3+sha-8473a27",
-    "@angular/material-date-fns-adapter": "22.0.0-next.3+sha-8473a27"
+    "@angular/material": "22.0.0-next.3+sha-1dc6b44",
+    "@angular/material-experimental": "22.0.0-next.3+sha-1dc6b44",
+    "@angular/material-luxon-adapter": "22.0.0-next.3+sha-1dc6b44",
+    "@angular/material-date-fns-adapter": "22.0.0-next.3+sha-1dc6b44"
   },
   "devDependencies": {
     "@angular/aria": "workspace:*",