From bec0e805922ad60f77bb5012df297d2781f1bbc5 Mon Sep 17 00:00:00 2001
From: web-padawan <iamkulykov@gmail.com>
Date: Fri, 12 Dec 2025 19:44:28 +0200
Subject: [PATCH 1/2] docs: add progress-bar base style properties to JSDoc

---
 .../progress-bar/src/vaadin-progress-bar.d.ts | 31 ++++++++++++-------
 .../progress-bar/src/vaadin-progress-bar.js   | 27 ++++++++++------
 2 files changed, 36 insertions(+), 22 deletions(-)

diff --git a/packages/progress-bar/src/vaadin-progress-bar.d.ts b/packages/progress-bar/src/vaadin-progress-bar.d.ts
index 73e9e1d4dbb..160ec8b102e 100644
--- a/packages/progress-bar/src/vaadin-progress-bar.d.ts
+++ b/packages/progress-bar/src/vaadin-progress-bar.d.ts
@@ -19,24 +19,31 @@ import { ProgressMixin } from './vaadin-progress-mixin.js';
  *
  * The following shadow DOM parts are available for styling:
  *
- * Part name | Description
- * ----------------|----------------
- * `bar` | Progress-bar's background
- * `value` | Progress-bar's foreground
- *
- * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
- *
- * The following custom properties are available:
- *
- * Custom property | Description | Default
- * ----------------|-------------|-------------
- * `--vaadin-progress-value` | current progress value (between 0 and 1) | 0
+ * Part name  | Description
+ * -----------|----------------
+ * `bar`      | Progress-bar's background
+ * `value`    | Progress-bar's foreground
+ *
+ * The following custom CSS properties are available for styling:
+ *
+ * Custom CSS property                          |
+ * :--------------------------------------------|
+ * | `--vaadin-progress-bar-animation-duration` |
+ * | `--vaadin-progress-bar-background`         |
+ * | `--vaadin-progress-bar-border-color`       |
+ * | `--vaadin-progress-bar-border-radius`      |
+ * | `--vaadin-progress-bar-border-width`       |
+ * | `--vaadin-progress-bar-height`             |
+ * | `--vaadin-progress-bar-padding`            |
+ * | `--vaadin-progress-bar-value-background`   |
  *
  * The following state attributes are available for styling:
  *
  * Attribute       | Description
  * ----------------|-------------------------------------
  * `indeterminate` | Set to an indeterminate progress bar
+ *
+ * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  */
 declare class ProgressBar extends ProgressMixin(ThemableMixin(ElementMixin(HTMLElement))) {}
 
diff --git a/packages/progress-bar/src/vaadin-progress-bar.js b/packages/progress-bar/src/vaadin-progress-bar.js
index b96dacbdaa7..a1d1ee0a713 100644
--- a/packages/progress-bar/src/vaadin-progress-bar.js
+++ b/packages/progress-bar/src/vaadin-progress-bar.js
@@ -24,18 +24,23 @@ import { ProgressMixin } from './vaadin-progress-mixin.js';
  *
  * The following shadow DOM parts are available for styling:
  *
- * Part name | Description
- * ----------------|----------------
- * `bar` | Progress-bar's background
- * `value` | Progress-bar's foreground
+ * Part name  | Description
+ * -----------|----------------
+ * `bar`      | Progress-bar's background
+ * `value`    | Progress-bar's foreground
  *
- * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
- *
- * The following custom properties are available:
+ * The following custom CSS properties are available for styling:
  *
- * Custom property | Description | Default
- * ----------------|-------------|-------------
- * `--vaadin-progress-value` | current progress value (between 0 and 1) | 0
+ * Custom CSS property                          |
+ * :--------------------------------------------|
+ * | `--vaadin-progress-bar-animation-duration` |
+ * | `--vaadin-progress-bar-background`         |
+ * | `--vaadin-progress-bar-border-color`       |
+ * | `--vaadin-progress-bar-border-radius`      |
+ * | `--vaadin-progress-bar-border-width`       |
+ * | `--vaadin-progress-bar-height`             |
+ * | `--vaadin-progress-bar-padding`            |
+ * | `--vaadin-progress-bar-value-background`   |
  *
  * The following state attributes are available for styling:
  *
@@ -43,6 +48,8 @@ import { ProgressMixin } from './vaadin-progress-mixin.js';
  * ----------------|-------------------------------------
  * `indeterminate` | Set to an indeterminate progress bar
  *
+ * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
+ *
  * @customElement
  * @extends HTMLElement
  * @mixes ProgressMixin

From 1de910df4983cfeb0e650c2d705055d828780bf4 Mon Sep 17 00:00:00 2001
From: web-padawan <iamkulykov@gmail.com>
Date: Mon, 15 Dec 2025 14:47:40 +0200
Subject: [PATCH 2/2] docs: add --vaadin-progress-value back

---
 packages/progress-bar/src/vaadin-progress-bar.d.ts | 1 +
 packages/progress-bar/src/vaadin-progress-bar.js   | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/progress-bar/src/vaadin-progress-bar.d.ts b/packages/progress-bar/src/vaadin-progress-bar.d.ts
index 160ec8b102e..79d2671ecb2 100644
--- a/packages/progress-bar/src/vaadin-progress-bar.d.ts
+++ b/packages/progress-bar/src/vaadin-progress-bar.d.ts
@@ -36,6 +36,7 @@ import { ProgressMixin } from './vaadin-progress-mixin.js';
  * | `--vaadin-progress-bar-height`             |
  * | `--vaadin-progress-bar-padding`            |
  * | `--vaadin-progress-bar-value-background`   |
+ * | `--vaadin-progress-value`                  |
  *
  * The following state attributes are available for styling:
  *
diff --git a/packages/progress-bar/src/vaadin-progress-bar.js b/packages/progress-bar/src/vaadin-progress-bar.js
index a1d1ee0a713..af368a40f4c 100644
--- a/packages/progress-bar/src/vaadin-progress-bar.js
+++ b/packages/progress-bar/src/vaadin-progress-bar.js
@@ -41,6 +41,7 @@ import { ProgressMixin } from './vaadin-progress-mixin.js';
  * | `--vaadin-progress-bar-height`             |
  * | `--vaadin-progress-bar-padding`            |
  * | `--vaadin-progress-bar-value-background`   |
+ * | `--vaadin-progress-value`                  |
  *
  * The following state attributes are available for styling:
  *