From 258e34de71fcd6475ae1a9cd3dff3f4224325c81 Mon Sep 17 00:00:00 2001
From: Lukas Harbarth <lukas.harbarth@sap.com>
Date: Wed, 21 Jan 2026 08:56:14 +0100
Subject: [PATCH] docs(TimelineChart): add deprecation notice for component

---
 packages/charts/src/components/TimelineChart/Placeholder.tsx | 3 +++
 .../charts/src/components/TimelineChart/TimeLineChart.mdx    | 2 +-
 .../src/components/TimelineChart/TimeLineChart.stories.tsx   | 2 +-
 .../src/components/TimelineChart/TimelineChartAnnotation.tsx | 2 ++
 packages/charts/src/components/TimelineChart/index.tsx       | 5 ++---
 5 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/packages/charts/src/components/TimelineChart/Placeholder.tsx b/packages/charts/src/components/TimelineChart/Placeholder.tsx
index 7d87a2a3703..0233208dd51 100644
--- a/packages/charts/src/components/TimelineChart/Placeholder.tsx
+++ b/packages/charts/src/components/TimelineChart/Placeholder.tsx
@@ -1,6 +1,9 @@
 import { ThemingParameters } from '@ui5/webcomponents-react-base';
 import ContentLoader from 'react-content-loader';
 
+/**
+ * @deprecated The component will be removed without replacement in version 3.0 of `@ui5/webcomponents-react-charts`.
+ */
 export const TimelineChartPlaceholder = () => {
   return (
     // @ts-expect-error: TypeScript is going crazy
diff --git a/packages/charts/src/components/TimelineChart/TimeLineChart.mdx b/packages/charts/src/components/TimelineChart/TimeLineChart.mdx
index 05052a2bb2c..473b9c0ed5f 100644
--- a/packages/charts/src/components/TimelineChart/TimeLineChart.mdx
+++ b/packages/charts/src/components/TimelineChart/TimeLineChart.mdx
@@ -6,7 +6,7 @@ import { TimelineChartAnnotation } from './TimelineChartAnnotation';
 
 <Meta of={ComponentStories} />
 
-<DocsHeader of={ComponentStories} isChart since="1.10.0" experimental />
+<DocsHeader of={ComponentStories} isChart since="1.10.0" experimental deprecationText={`The component will be removed without replacement in version 3.0 of \`@ui5/webcomponents-react-charts\`.`} />
 
 <Canvas of={ComponentStories.Default} />
 
diff --git a/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx b/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx
index 793856429ff..e228a8f39ca 100644
--- a/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx
+++ b/packages/charts/src/components/TimelineChart/TimeLineChart.stories.tsx
@@ -8,7 +8,7 @@ import { TimelineChart } from './index.js';
 const meta = {
   title: 'TimelineChart',
   component: TimelineChart,
-  tags: ['package:@ui5/webcomponents-react-charts', 'experimental'],
+  tags: ['package:@ui5/webcomponents-react-charts', 'experimental', 'deprecated'],
   argTypes: {
     dataset: {
       control: { disable: true },
diff --git a/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx b/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx
index 9e5d6d3d1e0..92c353b97d9 100644
--- a/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx
+++ b/packages/charts/src/components/TimelineChart/TimelineChartAnnotation.tsx
@@ -46,6 +46,8 @@ interface TimelineChartAnnotationProps extends CommonProps {
 /**
  * This is designed to be used for creating custom annotations, markers
  * or illustrations on the timeline of the chart.
+ *
+ * @deprecated The component will be removed without replacement in version 3.0 of `@ui5/webcomponents-react-charts`.
  */
 const TimelineChartAnnotation = forwardRef<HTMLDivElement, TimelineChartAnnotationProps>((props, ref) => {
   const { width = 'auto', height, rowIndex = 0, rowHeight = DEFAULT_ROW_HEIGHT, figure, ...rest } = props;
diff --git a/packages/charts/src/components/TimelineChart/index.tsx b/packages/charts/src/components/TimelineChart/index.tsx
index aa837d4c90c..b1142ddbd98 100644
--- a/packages/charts/src/components/TimelineChart/index.tsx
+++ b/packages/charts/src/components/TimelineChart/index.tsx
@@ -109,9 +109,6 @@ export interface TimelineChartProps extends CommonProps {
 
 /**
  * > __Experimental Component!__ <br />
- * > This component is experimental and not subject to semantic versioning.
- * > Therefore, you could face breaking changes when updating versions.
- * > Please use with caution!
  *
  * A `TimelineChart` is a data visualization chart that can be used to represent
  * Gantt charts or any other timeline-based visualizations. The component has a
@@ -125,6 +122,8 @@ export interface TimelineChartProps extends CommonProps {
  * connections.
  *
  * __Note:__ Charts are custom-built __without__ defined design specifications! They use the Fiori color palette, but functionality and especially accessibility may not meet standard app requirements.
+ *
+ * @deprecated The component will be removed without replacement in version 3.0 of `@ui5/webcomponents-react-charts`.
  */
 const TimelineChart = forwardRef<HTMLDivElement, TimelineChartProps>(
   (