@vaadin/vaadin-themable-mixin 23.0.4 → 23.1.0-alpha2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/vaadin-themable-mixin",
-  "version": "23.0.4",
+  "version": "23.1.0-alpha2",
   "publishConfig": {
     "access": "public"
   },
@@ -40,5 +40,5 @@
     "@vaadin/testing-helpers": "^0.3.2",
     "sinon": "^9.2.4"
   },
-  "gitHead": "d8db2046661c42fb5aac09ed683b500bf4613b26"
+  "gitHead": "6842dcb8b163d4512fae8d3d12a6559077a4aee6"
 }

package/vaadin-theme-property-mixin.d.ts

@@ -24,6 +24,29 @@ export declare class ThemePropertyMixinClass {
    *
    * See [Styling Components: Sub-components](https://vaadin.com/docs/latest/ds/customization/styling-components/#sub-components).
    * page for more information.
+   *
+   * @deprecated The `theme` property is not supposed for public use and will be dropped in Vaadin 24.
+   * Please, use the `theme` attribute instead.
+   * @protected
+   */
+  theme: string | null | undefined;
+
+  /**
+   * Helper property with theme attribute value facilitating propagation
+   * in shadow DOM.
+   *
+   * Enables the component implementation to propagate the `theme`
+   * attribute value to the sub-components in Shadow DOM by binding
+   * the sub-component’s "theme" attribute to the `theme` property of
+   * the host.
+   *
+   * **NOTE:** Extending the mixin only provides the property for binding,
+   * and does not make the propagation alone.
+   *
+   * See [Styling Components: Sub-components](https://vaadin.com/docs/latest/ds/customization/styling-components/#sub-components).
+   * page for more information.
+   *
+   * @protected
    */
-  readonly theme: string | null | undefined;
+  readonly _theme: string | null | undefined;
 }

package/vaadin-theme-property-mixin.js

@@ -25,21 +25,42 @@ export const ThemePropertyMixin = (superClass) =>
          * See [Styling Components: Sub-components](https://vaadin.com/docs/latest/ds/customization/styling-components/#sub-components).
          * page for more information.
          *
+         * @deprecated The `theme` property is not supposed for public use and will be dropped in Vaadin 24.
+         * Please, use the `theme` attribute instead.
          * @protected
          */
         theme: {
+          type: String,
+          reflectToAttribute: true,
+          observer: '__deprecatedThemePropertyChanged'
+        },
+
+        /**
+         * Helper property with theme attribute value facilitating propagation
+         * in shadow DOM.
+         *
+         * Enables the component implementation to propagate the `theme`
+         * attribute value to the sub-components in Shadow DOM by binding
+         * the sub-component’s "theme" attribute to the `theme` property of
+         * the host.
+         *
+         * **NOTE:** Extending the mixin only provides the property for binding,
+         * and does not make the propagation alone.
+         *
+         * See [Styling Components: Sub-components](https://vaadin.com/docs/latest/ds/customization/styling-components/#sub-components).
+         * page for more information.
+         *
+         * @protected
+         */
+        _theme: {
           type: String,
           readOnly: true
         }
       };
     }
 
-    /** @protected */
-    attributeChangedCallback(name, oldValue, newValue) {
-      super.attributeChangedCallback(name, oldValue, newValue);
-
-      if (name === 'theme') {
-        this._setTheme(newValue);
-      }
+    /** @private */
+    __deprecatedThemePropertyChanged(theme) {
+      this._set_theme(theme);
     }
   };