docs: remove mentions of overlays and theme attribute propagation (#9877)

web-padawan · web-flow · commit b3a83a293446 · 2025-08-04T14:49:57.000+03:00
diff --git a/packages/avatar-group/src/vaadin-avatar-group.d.ts b/packages/avatar-group/src/vaadin-avatar-group.d.ts
@@ -48,7 +48,6 @@ export { AvatarGroupI18n, AvatarGroupItem, AvatarI18n };
  * In addition to `<vaadin-avatar-group>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-avatar-group-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-avatar-group-menu>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
  * - `<vaadin-avatar-group-menu-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
  */
diff --git a/packages/avatar-group/src/vaadin-avatar-group.js b/packages/avatar-group/src/vaadin-avatar-group.js
@@ -55,7 +55,6 @@ import { AvatarGroupMixin } from './vaadin-avatar-group-mixin.js';
  * In addition to `<vaadin-avatar-group>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-avatar-group-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-avatar-group-menu>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
  * - `<vaadin-avatar-group-menu-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
  *
diff --git a/packages/context-menu/src/vaadin-context-menu.d.ts b/packages/context-menu/src/vaadin-context-menu.d.ts
@@ -239,9 +239,6 @@ export interface ContextMenuEventMap<TItem extends ContextMenuItem = ContextMenu
  * ---------- |-------------
  * `expanded` | Expanded parent item.
  *
- * Note: the `theme` attribute value set on `<vaadin-context-menu>` is
- * propagated to the internal components listed above.
- *
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  * @fires {CustomEvent} item-selected - Fired when an item is selected when the context menu is populated using the `items` API.
  * @fires {CustomEvent} closed - Fired when the context menu is closed.
diff --git a/packages/context-menu/src/vaadin-context-menu.js b/packages/context-menu/src/vaadin-context-menu.js
@@ -200,9 +200,6 @@ import { ContextMenuMixin } from './vaadin-context-menu-mixin.js';
  * ---------- |-------------
  * `expanded` | Expanded parent item.
  *
- * Note: the `theme` attribute value set on `<vaadin-context-menu>` is
- * propagated to the internal components listed above.
- *
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  * @fires {CustomEvent} item-selected - Fired when an item is selected when the context menu is populated using the `items` API.
  * @fires {CustomEvent} closed - Fired when the context menu is closed.
diff --git a/packages/date-picker/src/vaadin-date-picker.d.ts b/packages/date-picker/src/vaadin-date-picker.d.ts
@@ -102,13 +102,11 @@ export interface DatePickerEventMap extends HTMLElementEventMap, DatePickerCusto
  * In addition to `<vaadin-date-picker>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-date-picker-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-date-picker-overlay-content>`
  * - `<vaadin-date-picker-month-scroller>`
  * - `<vaadin-date-picker-year-scroller>`
  * - `<vaadin-date-picker-year>`
  * - `<vaadin-month-calendar>`
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the input.
  *
  * In order to style the overlay content, use `<vaadin-date-picker-overlay-content>` shadow DOM parts:
  *
@@ -149,9 +147,6 @@ export interface DatePickerEventMap extends HTMLElementEventMap, DatePickerCusto
  * `year-number`         | Year number
  * `year-separator`      | Year separator
  *
- * Note: the `theme` attribute value set on `<vaadin-date-picker>` is
- * propagated to the internal components listed above.
- *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
  * ### Change events
diff --git a/packages/date-picker/src/vaadin-date-picker.js b/packages/date-picker/src/vaadin-date-picker.js
@@ -66,13 +66,11 @@ import { DatePickerMixin } from './vaadin-date-picker-mixin.js';
  * In addition to `<vaadin-date-picker>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-date-picker-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-date-picker-overlay-content>`
  * - `<vaadin-date-picker-month-scroller>`
  * - `<vaadin-date-picker-year-scroller>`
  * - `<vaadin-date-picker-year>`
  * - `<vaadin-month-calendar>`
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the input.
  *
  * In order to style the overlay content, use `<vaadin-date-picker-overlay-content>` shadow DOM parts:
  *
@@ -113,9 +111,6 @@ import { DatePickerMixin } from './vaadin-date-picker-mixin.js';
  * `year-number`         | Year number
  * `year-separator`      | Year separator
  *
- * Note: the `theme` attribute value set on `<vaadin-date-picker>` is
- * propagated to the internal components listed above.
- *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
  * ### Change events
diff --git a/packages/date-time-picker/src/vaadin-date-time-picker.d.ts b/packages/date-time-picker/src/vaadin-date-time-picker.d.ts
@@ -88,9 +88,6 @@ export interface DateTimePickerEventMap extends DateTimePickerCustomEventMap, HT
  * - [`<vaadin-date-picker>`](#/elements/vaadin-date-picker).
  * - [`<vaadin-time-picker>`](#/elements/vaadin-time-picker).
  *
- * Note: the `theme` attribute value set on `<vaadin-date-time-picker>` is
- * propagated to these components.
- *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
  * ### Change events
diff --git a/packages/date-time-picker/src/vaadin-date-time-picker.js b/packages/date-time-picker/src/vaadin-date-time-picker.js
@@ -60,9 +60,6 @@ import { DateTimePickerMixin } from './vaadin-date-time-picker-mixin.js';
  * - [`<vaadin-date-picker>`](#/elements/vaadin-date-picker).
  * - [`<vaadin-time-picker>`](#/elements/vaadin-time-picker).
  *
- * Note: the `theme` attribute value set on `<vaadin-date-time-picker>` is
- * propagated to these components.
- *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
  * ### Change events
diff --git a/packages/popover/src/lit/renderer-directives.d.ts b/packages/popover/src/lit/renderer-directives.d.ts
@@ -27,7 +27,7 @@ export class PopoverRendererDirective extends LitRendererDirective<Popover, Popo
 }
 
 /**
- * A Lit directive for populating the content of the `<vaadin-popover-overlay>` element.
+ * A Lit directive for populating the content of the `<vaadin-popover>` element.
  *
  * The directive accepts a renderer callback returning a Lit template and assigns it to the popover
  * via the `renderer` property. The renderer is called once to populate the content when assigned
diff --git a/packages/popover/src/lit/renderer-directives.js b/packages/popover/src/lit/renderer-directives.js
@@ -32,7 +32,7 @@ export class PopoverRendererDirective extends LitRendererDirective {
 }
 
 /**
- * A Lit directive for populating the content of the `<vaadin-popover-overlay>` element.
+ * A Lit directive for populating the content of the `<vaadin-popover>` element.
  *
  * The directive accepts a renderer callback returning a Lit template and assigns it to the popover
  * via the `renderer` property. The renderer is called once to populate the content when assigned
diff --git a/packages/select/src/lit/renderer-directives.d.ts b/packages/select/src/lit/renderer-directives.d.ts
@@ -28,7 +28,7 @@ export class SelectRendererDirective extends LitRendererDirective<Select, Select
 }
 
 /**
- * A Lit directive for populating the content of the `<vaadin-select-overlay>` element.
+ * A Lit directive for populating the content of the `<vaadin-select>` element.
  *
  * The directive accepts a renderer callback returning a Lit template and assigns it to the select
  * via the `renderer` property. The renderer is called once to populate the content when assigned
diff --git a/packages/select/src/lit/renderer-directives.js b/packages/select/src/lit/renderer-directives.js
@@ -32,7 +32,7 @@ export class SelectRendererDirective extends LitRendererDirective {
 }
 
 /**
- * A Lit directive for populating the content of the `<vaadin-select-overlay>` element.
+ * A Lit directive for populating the content of the `<vaadin-select>` element.
  *
  * The directive accepts a renderer callback returning a Lit template and assigns it to the select
  * via the `renderer` property. The renderer is called once to populate the content when assigned
diff --git a/packages/select/src/vaadin-select-base-mixin.d.ts b/packages/select/src/vaadin-select-base-mixin.d.ts
@@ -64,8 +64,7 @@ export declare class SelectBaseMixinClass {
    * Custom function for rendering the content of the `<vaadin-select>`.
    * Receives two arguments:
    *
-   * - `root` The `<vaadin-select-overlay>` internal container
-   *   DOM element. Append your content to it.
+   * - `root` The internal container DOM element. Append your content to it.
    * - `select` The reference to the `<vaadin-select>` element.
    */
   renderer: SelectRenderer | undefined;
diff --git a/packages/select/src/vaadin-select-base-mixin.js b/packages/select/src/vaadin-select-base-mixin.js
@@ -72,8 +72,7 @@ export const SelectBaseMixin = (superClass) =>
          * Custom function for rendering the content of the `<vaadin-select>`.
          * Receives two arguments:
          *
-         * - `root` The `<vaadin-select-overlay>` internal container
-         *   DOM element. Append your content to it.
+         * - `root` The internal container DOM element. Append your content to it.
          * - `select` The reference to the `<vaadin-select>` element.
          * @type {!SelectRenderer | undefined}
          */
diff --git a/packages/select/src/vaadin-select.d.ts b/packages/select/src/vaadin-select.d.ts
@@ -26,8 +26,7 @@ export type SelectChangeEvent = Event & {
  * Function for rendering the content of the `<vaadin-select>`.
  * Receives two arguments:
  *
- * - `root` The `<vaadin-select-overlay>` internal container
- *   DOM element. Append your content to it.
+ * - `root` The internal container DOM element. Append your content to it.
  * - `select` The reference to the `<vaadin-select>` element.
  */
 export type SelectRenderer = (root: HTMLElement, select: Select) => void;
@@ -160,12 +159,9 @@ export interface SelectEventMap extends HTMLElementEventMap, SelectCustomEventMa
  * In addition to `<vaadin-select>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-select-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](#/elements/vaadin-button).
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the button.
- *
- * Note: the `theme` attribute value set on `<vaadin-select>` is
- * propagated to the internal components listed above.
+ * - `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
+ * - `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
diff --git a/packages/select/src/vaadin-select.js b/packages/select/src/vaadin-select.js
@@ -114,12 +114,9 @@ import { SelectBaseMixin } from './vaadin-select-base-mixin.js';
  * In addition to `<vaadin-select>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-select-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](#/elements/vaadin-button).
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the button.
- *
- * Note: the `theme` attribute value set on `<vaadin-select>` is
- * propagated to the internal components listed above.
+ * - `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
+ * - `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
diff --git a/packages/time-picker/src/vaadin-time-picker.d.ts b/packages/time-picker/src/vaadin-time-picker.d.ts
@@ -95,12 +95,7 @@ export interface TimePickerEventMap extends HTMLElementEventMap, TimePickerCusto
  * In addition to `<vaadin-time-picker>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-time-picker-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-time-picker-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the input.
- *
- * Note: the `theme` attribute value set on `<vaadin-time-picker>` is
- * propagated to the internal components listed above.
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
diff --git a/packages/time-picker/src/vaadin-time-picker.js b/packages/time-picker/src/vaadin-time-picker.js
@@ -62,12 +62,7 @@ import { TimePickerMixin } from './vaadin-time-picker-mixin.js';
  * In addition to `<vaadin-time-picker>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-time-picker-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-time-picker-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the input.
- *
- * Note: the `theme` attribute value set on `<vaadin-time-picker>` is
- * propagated to the internal components listed above.
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
diff --git a/packages/tooltip/src/vaadin-tooltip.d.ts b/packages/tooltip/src/vaadin-tooltip.d.ts
@@ -32,9 +32,6 @@ export { TooltipPosition } from './vaadin-tooltip-mixin.js';
  * -----------------|----------------------------------------
  * `position`       | Reflects the `position` property value.
  *
- * Note: the `theme` attribute value set on `<vaadin-tooltip>` is
- * propagated to the internal `<vaadin-tooltip-overlay>` component.
- *
  * ### Custom CSS Properties
  *
  * The following custom CSS properties are available on the `<vaadin-tooltip>` element:
diff --git a/packages/tooltip/src/vaadin-tooltip.js b/packages/tooltip/src/vaadin-tooltip.js
@@ -35,9 +35,6 @@ import { TooltipMixin } from './vaadin-tooltip-mixin.js';
  * -----------------|----------------------------------------
  * `position`       | Reflects the `position` property value.
  *
- * Note: the `theme` attribute value set on `<vaadin-tooltip>` is
- * propagated to the internal `<vaadin-tooltip-overlay>` component.
- *
  * ### Custom CSS Properties
  *
  * The following custom CSS properties are available on the `<vaadin-tooltip>` element:

Original file line number	Diff line number	Diff line change
`@@ -48,7 +48,6 @@ export { AvatarGroupI18n, AvatarGroupItem, AvatarI18n };`
`48`	`48`	* In addition to `<vaadin-avatar-group>` itself, the following internal
`49`	`49`	`* components are themable:`
`50`	`50`	`*`
`51`		- * - `<vaadin-avatar-group-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
`52`	`51`	* - `<vaadin-avatar-group-menu>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
`53`	`52`	* - `<vaadin-avatar-group-menu-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
`54`	`53`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -55,7 +55,6 @@ import { AvatarGroupMixin } from './vaadin-avatar-group-mixin.js';`
`55`	`55`	* In addition to `<vaadin-avatar-group>` itself, the following internal
`56`	`56`	`* components are themable:`
`57`	`57`	`*`
`58`		- * - `<vaadin-avatar-group-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
`59`	`58`	* - `<vaadin-avatar-group-menu>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
`60`	`59`	* - `<vaadin-avatar-group-menu-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
`61`	`60`	`*`
Original file line number	Diff line number	Diff line change
`@@ -102,13 +102,11 @@ export interface DatePickerEventMap extends HTMLElementEventMap, DatePickerCusto`
`102`	`102`	* In addition to `<vaadin-date-picker>` itself, the following internal
`103`	`103`	`* components are themable:`
`104`	`104`	`*`
`105`		- * - `<vaadin-date-picker-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
`106`	`105`	* - `<vaadin-date-picker-overlay-content>`
`107`	`106`	* - `<vaadin-date-picker-month-scroller>`
`108`	`107`	* - `<vaadin-date-picker-year-scroller>`
`109`	`108`	* - `<vaadin-date-picker-year>`
`110`	`109`	* - `<vaadin-month-calendar>`
`111`		- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the input.
`112`	`110`	`*`
`113`	`111`	* In order to style the overlay content, use `<vaadin-date-picker-overlay-content>` shadow DOM parts:
`114`	`112`	`*`
`@@ -149,9 +147,6 @@ export interface DatePickerEventMap extends HTMLElementEventMap, DatePickerCusto`
`149`	`147`	* `year-number` \| Year number
`150`	`148`	* `year-separator` \| Year separator
`151`	`149`	`*`
`152`		- * Note: the `theme` attribute value set on `<vaadin-date-picker>` is
`153`		`- * propagated to the internal components listed above.`
`154`		`- *`
`155`	`150`	`* See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.`
`156`	`151`	`*`
`157`	`152`	`* ### Change events`
Original file line number	Diff line number	Diff line change
`@@ -66,13 +66,11 @@ import { DatePickerMixin } from './vaadin-date-picker-mixin.js';`
`66`	`66`	* In addition to `<vaadin-date-picker>` itself, the following internal
`67`	`67`	`* components are themable:`
`68`	`68`	`*`
`69`		- * - `<vaadin-date-picker-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
`70`	`69`	* - `<vaadin-date-picker-overlay-content>`
`71`	`70`	* - `<vaadin-date-picker-month-scroller>`
`72`	`71`	* - `<vaadin-date-picker-year-scroller>`
`73`	`72`	* - `<vaadin-date-picker-year>`
`74`	`73`	* - `<vaadin-month-calendar>`
`75`		- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the input.
`76`	`74`	`*`
`77`	`75`	* In order to style the overlay content, use `<vaadin-date-picker-overlay-content>` shadow DOM parts:
`78`	`76`	`*`
`@@ -113,9 +111,6 @@ import { DatePickerMixin } from './vaadin-date-picker-mixin.js';`
`113`	`111`	* `year-number` \| Year number
`114`	`112`	* `year-separator` \| Year separator
`115`	`113`	`*`
`116`		- * Note: the `theme` attribute value set on `<vaadin-date-picker>` is
`117`		`- * propagated to the internal components listed above.`
`118`		`- *`
`119`	`114`	`* See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.`
`120`	`115`	`*`
`121`	`116`	`* ### Change events`
Original file line number	Diff line number	Diff line change
`@@ -88,9 +88,6 @@ export interface DateTimePickerEventMap extends DateTimePickerCustomEventMap, HT`
`88`	`88`	* - [`<vaadin-date-picker>`](#/elements/vaadin-date-picker).
`89`	`89`	* - [`<vaadin-time-picker>`](#/elements/vaadin-time-picker).
`90`	`90`	`*`
`91`		- * Note: the `theme` attribute value set on `<vaadin-date-time-picker>` is
`92`		`- * propagated to these components.`
`93`		`- *`
`94`	`91`	`* See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.`
`95`	`92`	`*`
`96`	`93`	`* ### Change events`
Original file line number	Diff line number	Diff line change
`@@ -60,9 +60,6 @@ import { DateTimePickerMixin } from './vaadin-date-time-picker-mixin.js';`
`60`	`60`	* - [`<vaadin-date-picker>`](#/elements/vaadin-date-picker).
`61`	`61`	* - [`<vaadin-time-picker>`](#/elements/vaadin-time-picker).
`62`	`62`	`*`
`63`		- * Note: the `theme` attribute value set on `<vaadin-date-time-picker>` is
`64`		`- * propagated to these components.`
`65`		`- *`
`66`	`63`	`* See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.`
`67`	`64`	`*`
`68`	`65`	`* ### Change events`
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@ export class PopoverRendererDirective extends LitRendererDirective<Popover, Popo`
`27`	`27`	`}`
`28`	`28`
`29`	`29`	`/**`
`30`		- * A Lit directive for populating the content of the `<vaadin-popover-overlay>` element.
	`30`	+ * A Lit directive for populating the content of the `<vaadin-popover>` element.
`31`	`31`	`*`
`32`	`32`	`* The directive accepts a renderer callback returning a Lit template and assigns it to the popover`
`33`	`33`	* via the `renderer` property. The renderer is called once to populate the content when assigned
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ export class PopoverRendererDirective extends LitRendererDirective {`
`32`	`32`	`}`
`33`	`33`
`34`	`34`	`/**`
`35`		- * A Lit directive for populating the content of the `<vaadin-popover-overlay>` element.
	`35`	+ * A Lit directive for populating the content of the `<vaadin-popover>` element.
`36`	`36`	`*`
`37`	`37`	`* The directive accepts a renderer callback returning a Lit template and assigns it to the popover`
`38`	`38`	* via the `renderer` property. The renderer is called once to populate the content when assigned