From 283e278ff1b18589d908476bb5fa6103e29eb2bb Mon Sep 17 00:00:00 2001
From: Kristiyan Kostadinov <crisbeto@abv.bg>
Date: Thu, 16 Apr 2026 09:05:57 +0200
Subject: [PATCH] fix(material/sort): deprecate MatSortHeaderIntl and hide from
 docs

`MatSortHeaderIntl` hasn't been used for a while. These changes deprecate it and it from the docs.

Fixes #33083.
---
 goldens/material/sort/index.api.md    | 2 +-
 src/material/sort/sort-header-intl.ts | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/goldens/material/sort/index.api.md b/goldens/material/sort/index.api.md
index e471450dd1fb..3dc256b01d5c 100644
--- a/goldens/material/sort/index.api.md
+++ b/goldens/material/sort/index.api.md
@@ -114,7 +114,7 @@ export class MatSortHeader implements MatSortable, OnDestroy, OnInit, AfterViewI
     static ɵfac: i0.ɵɵFactoryDeclaration<MatSortHeader, never>;
 }
 
-// @public
+// @public @deprecated
 export class MatSortHeaderIntl {
     readonly changes: Subject<void>;
     // (undocumented)
diff --git a/src/material/sort/sort-header-intl.ts b/src/material/sort/sort-header-intl.ts
index c275a4cca2ed..ea7ca77d65b8 100644
--- a/src/material/sort/sort-header-intl.ts
+++ b/src/material/sort/sort-header-intl.ts
@@ -12,6 +12,10 @@ import {Subject} from 'rxjs';
 /**
  * To modify the labels and text displayed, create a new instance of MatSortHeaderIntl and
  * include it in a custom provider.
+ *
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 23.0.0
+ * @docs-private
  */
 @Injectable({providedIn: 'root'})
 export class MatSortHeaderIntl {