@brightspace-ui/core 1.201.1 → 1.202.0

package/helpers/README.md

@@ -21,6 +21,25 @@ import { AsyncStateEvent } from '@brightspace-ui/core/helpers/asyncStateEvent.js
 const asyncStateEvent = new AsyncStateEvent(pendingPromise);
 ```
 
+## composeMixins
+
+A helper function for cleanly incorporating a list of mixins into a base class. Designed for use with Lit components with a large amount of reusable functionality.
+
+```js
+// other imports...
+import { composeMixins } from '@brightspace-ui/core/helpers/composeMixins.js';
+
+class ExampleComponent extends composeMixins(
+  LitElement,
+  EntityMixin,
+  LocalizeMixin,
+) {
+  // ...
+}
+```
+
+Read more about mixins on [the `open-wc` docs](https://open-wc.org/docs/development/dedupe-mixin/#what-is-a-mixin).
+
 ## Dismissible
 
 Dismissible components are those that should be dismissible when the user presses
@@ -196,4 +215,3 @@ import '@brightspace-ui/core/helpers/viewport-size.js';
     min-width: calc(var(--d2l-vw, 1vw) * 100);
 }
 ```
-

package/helpers/composeMixins.js

@@ -0,0 +1,2 @@
+export const composeMixins = (base, ...mixins) =>
+	mixins.reduce((subclass, superclass) => superclass(subclass), base);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightspace-ui/core",
-  "version": "1.201.1",
+  "version": "1.202.0",
   "description": "A collection of accessible, free, open-source web components for building Brightspace applications",
   "repository": "https://github.com/BrightspaceUI/core.git",
   "publishConfig": {