docs: fix spelling (#25296)

Author: jayvdb

guides/theming.md

@@ -385,7 +385,7 @@ Angular Material supports rendering highly visible outlines on focused elements.
 enable these strong focus indicators via two Sass mixins:
 `strong-focus-indicators` and `strong-focus-indicators-theme`.
 
-The `strong-focus-indicators` mixin emits structal indicator styles for all components. This mixin
+The `strong-focus-indicators` mixin emits structural indicator styles for all components. This mixin
 should be included exactly once in an application, similar to the `core` mixin described above.
 
 The `strong-focus-indicators-theme` mixin emits only the indicator's color styles. This mixin should

guides/typography.md

@@ -8,7 +8,7 @@ for the library's components. Additionally, Angular Material provides APIs for a
 styles to elements in your own application.
 
 Angular Material's theming APIs are built with [Sass](https://sass-lang.com). This document assumes
-familiary with CSS and Sass basics, including variables, functions, and mixins.
+familiarity with CSS and Sass basics, including variables, functions, and mixins.
 
 [theming-system]: https://material.angular.io/guide/theming
 

scripts/check-mdc-tests-config.ts

@@ -175,7 +175,7 @@ export const config = {
       // The MDC slide toggle uses a `button` which isn't able to block form submission.
       'should prevent the form from submit when being required',
 
-      // TODO: the focus origin functionality has to be implemeted for the MDC slide toggle.
+      // TODO: the focus origin functionality has to be implemented for the MDC slide toggle.
       'should not change focus origin if origin not specified',
     ],
     'mdc-snack-bar': [

src/cdk-experimental/column-resize/resize-strategy.ts

@@ -69,7 +69,7 @@ export abstract class ResizeStrategy {
 }
 
 /**
- * The optimially performing resize strategy for <table> elements with table-layout: fixed.
+ * The optimally performing resize strategy for <table> elements with table-layout: fixed.
  * Tested against and outperformed:
  *   CSS selector
  *   CSS selector w/ CSS variable

src/cdk-experimental/popover-edit/edit-event-dispatcher.ts

@@ -191,7 +191,7 @@ export class EditEventDispatcher<R> {
     this._editRef = ref;
   }
 
-  /** Unsets the currently active EditRef, if the specified editRef is active. */
+  /** Unset the currently active EditRef, if the specified editRef is active. */
   unsetActiveEditRef(ref: R) {
     if (this._editRef !== ref) {
       return;

src/cdk-experimental/popover-edit/table-directives.ts

@@ -145,7 +145,7 @@ export class CdkEditable implements AfterViewInit, OnDestroy {
         )
         .subscribe(this.editEventDispatcher.editing);
 
-      // Keydown must be used here or else key autorepeat does not work properly on some platforms.
+      // Keydown must be used here or else key auto-repeat does not work properly on some platforms.
       fromEvent<KeyboardEvent>(element, 'keydown')
         .pipe(takeUntil(this.destroyed))
         .subscribe(this.focusDispatcher.keyObserver);

src/cdk-experimental/scrolling/auto-size-virtual-scroll.ts

@@ -210,7 +210,7 @@ export class AutoSizeVirtualScrollStrategy implements VirtualScrollStrategy {
     if (scrollDelta < 0) {
       // The content offset we would expect based on the average item size.
       const predictedOffset = renderedRange.start * this._averager.getAverageItemSize();
-      // The difference between the predicted size of the unrendered content at the beginning and
+      // The difference between the predicted size of the un-rendered content at the beginning and
       // the actual available space to scroll over. We need to reduce this to zero by the time the
       // user scrolls to the top.
       // - 0 indicates that the predicted size and available space are the same.

src/cdk/a11y/live-announcer/live-announcer.ts

@@ -50,23 +50,23 @@ export class LiveAnnouncer implements OnDestroy {
   }
 
   /**
-   * Announces a message to screenreaders.
-   * @param message Message to be announced to the screenreader.
+   * Announces a message to screen readers.
+   * @param message Message to be announced to the screen reader.
    * @returns Promise that will be resolved when the message is added to the DOM.
    */
   announce(message: string): Promise<void>;
 
   /**
-   * Announces a message to screenreaders.
-   * @param message Message to be announced to the screenreader.
+   * Announces a message to screen readers.
+   * @param message Message to be announced to the screen reader.
    * @param politeness The politeness of the announcer element.
    * @returns Promise that will be resolved when the message is added to the DOM.
    */
   announce(message: string, politeness?: AriaLivePoliteness): Promise<void>;
 
   /**
-   * Announces a message to screenreaders.
-   * @param message Message to be announced to the screenreader.
+   * Announces a message to screen readers.
+   * @param message Message to be announced to the screen reader.
    * @param duration Time in milliseconds after which to clear out the announcer element. Note
    *   that this takes effect after the message has been added to the DOM, which can be up to
    *   100ms after `announce` has been called.
@@ -75,8 +75,8 @@ export class LiveAnnouncer implements OnDestroy {
   announce(message: string, duration?: number): Promise<void>;
 
   /**
-   * Announces a message to screenreaders.
-   * @param message Message to be announced to the screenreader.
+   * Announces a message to screen readers.
+   * @param message Message to be announced to the screen reader.
    * @param politeness The politeness of the announcer element.
    * @param duration Time in milliseconds after which to clear out the announcer element. Note
    *   that this takes effect after the message has been added to the DOM, which can be up to

src/cdk/bidi/dir-document-token.ts

@@ -16,7 +16,7 @@ import {inject, InjectionToken} from '@angular/core';
  * We can't use the real document in tests because changing the real `dir` causes geometry-based
  * tests in Safari to fail.
  *
- * We also can't re-provide the DOCUMENT token from platform-brower because the unit tests
+ * We also can't re-provide the DOCUMENT token from platform-browser because the unit tests
  * themselves use things like `querySelector` in test code.
  *
  * This token is defined in a separate file from Directionality as a workaround for

src/cdk/clipboard/pending-copy.ts

@@ -10,10 +10,10 @@
  * A pending copy-to-clipboard operation.
  *
  * The implementation of copying text to the clipboard modifies the DOM and
- * forces a relayout. This relayout can take too long if the string is large,
+ * forces a re-layout. This re-layout can take too long if the string is large,
  * causing the execCommand('copy') to happen too long after the user clicked.
  * This results in the browser refusing to copy. This object lets the
- * relayout happen in a separate tick from copying by providing a copy function
+ * re-layout happen in a separate tick from copying by providing a copy function
  * that can be called later.
  *
  * Destroy must be called when no longer in use, regardless of whether `copy` is