docs: add icon custom CSS properties to JSDoc

web-padawan · web-padawan · commit 4f1c1e88ddb3 · 2025-09-24T10:25:46.000+03:00
diff --git a/packages/icon/src/vaadin-icon.d.ts b/packages/icon/src/vaadin-icon.d.ts
@@ -48,6 +48,14 @@ import { IconMixin } from './vaadin-icon-mixin.js';
  *
  * ### Styling
  *
+ * The following custom CSS properties are available for styling:
+ *
+ * Custom CSS property          | Description
+ * -----------------------------|-------------
+ * `--vaadin-icon-size`         | Size (width and height) of the icon
+ * `--vaadin-icon-stroke-width` | Stroke width of the SVG icon
+ * `--vaadin-icon-visual-size`  | Visual size of the icon
+ *
  * The following state attributes are available for styling:
  *
  * Attribute      | Description
diff --git a/packages/icon/src/vaadin-icon.js b/packages/icon/src/vaadin-icon.js
@@ -56,6 +56,14 @@ import { ensureSvgLiteral } from './vaadin-icon-svg.js';
  *
  * ### Styling
  *
+ * The following custom CSS properties are available for styling:
+ *
+ * Custom CSS property          | Description
+ * -----------------------------|-------------
+ * `--vaadin-icon-size`         | Size (width and height) of the icon
+ * `--vaadin-icon-stroke-width` | Stroke width of the SVG icon
+ * `--vaadin-icon-visual-size`  | Visual size of the icon
+ *
  * The following state attributes are available for styling:
  *
  * Attribute      | Description

Original file line number	Diff line number	Diff line change
`@@ -48,6 +48,14 @@ import { IconMixin } from './vaadin-icon-mixin.js';`
`48`	`48`	`*`
`49`	`49`	`* ### Styling`
`50`	`50`	`*`
	`51`	`+ * The following custom CSS properties are available for styling:`
	`52`	`+ *`
	`53`	`+ * Custom CSS property \| Description`
	`54`	`+ * -----------------------------\|-------------`
	`55`	+ * `--vaadin-icon-size` \| Size (width and height) of the icon
	`56`	+ * `--vaadin-icon-stroke-width` \| Stroke width of the SVG icon
	`57`	+ * `--vaadin-icon-visual-size` \| Visual size of the icon
	`58`	`+ *`
`51`	`59`	`* The following state attributes are available for styling:`
`52`	`60`	`*`
`53`	`61`	`* Attribute \| Description`
Original file line number	Diff line number	Diff line change
`@@ -56,6 +56,14 @@ import { ensureSvgLiteral } from './vaadin-icon-svg.js';`
`56`	`56`	`*`
`57`	`57`	`* ### Styling`
`58`	`58`	`*`
	`59`	`+ * The following custom CSS properties are available for styling:`
	`60`	`+ *`
	`61`	`+ * Custom CSS property \| Description`
	`62`	`+ * -----------------------------\|-------------`
	`63`	+ * `--vaadin-icon-size` \| Size (width and height) of the icon
	`64`	+ * `--vaadin-icon-stroke-width` \| Stroke width of the SVG icon
	`65`	+ * `--vaadin-icon-visual-size` \| Visual size of the icon
	`66`	`+ *`
`59`	`67`	`* The following state attributes are available for styling:`
`60`	`68`	`*`
`61`	`69`	`* Attribute \| Description`