@blockquote-web-components/blockquote-base-style-helpers 1.1.9 → 1.1.10

package/README.md

@@ -204,10 +204,10 @@ export default css`
 
 #### Functions
 
-| Name                  | Description | Parameters           | Return |
-| --------------------- | ----------- | -------------------- | ------ |
-| `adoptDocumentStyles` |             | `renderRoot, styles` |        |
-| `setDocumentStyles`   |             | `styles`             |        |
+| Name                  | Description                                   | Parameters                                           | Return |
+| --------------------- | --------------------------------------------- | ---------------------------------------------------- | ------ |
+| `adoptDocumentStyles` | Adopts the given styles into the render root. | `renderRoot: Document \| HTMLElement, styles: Array` |        |
+| `setDocumentStyles`   | Sets the document styles.                     | `styles: !*`                                         |        |
 
 <hr/>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockquote-web-components/blockquote-base-style-helpers",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "Webcomponent blockquote-base-style-helpers following open-wc recommendations",
   "keywords": [
     "lit",
@@ -135,6 +135,9 @@
       "import/prefer-default-export": "off",
       "lit/no-classfield-shadowing": "off",
       "lit/no-native-attributes": "off"
+    },
+    "globals": {
+      "globalThis": "readonly"
     }
   },
   "stylelint": {
@@ -158,5 +161,5 @@
     "access": "public"
   },
   "customElements": "custom-elements.json",
-  "gitHead": "0c10727d27b0d5f05acb9aeef97807513aef9874"
+  "gitHead": "ef40e9fad141e3a19ab89496d3cabcfa5f02447d"
 }

package/src/setDocumentStyles.js

@@ -1,19 +1,43 @@
+const globalThisOrWindow = globalThis /* c8 ignore next */ || window;
+
+/**
+ * Checks if the current environment supports adopting style sheets.
+ * @type {boolean}
+ */
 const supportsAdoptingStyleSheets =
-  window.ShadowRoot &&
-  (window.ShadyCSS === undefined || /* c8 ignore next */ window.ShadyCSS.nativeShadow) &&
+  globalThisOrWindow.ShadowRoot &&
+  // @ts-ignore
+  (globalThisOrWindow.ShadyCSS === undefined /* c8 ignore next */ ||
+    globalThisOrWindow.ShadyCSS.nativeShadow) &&
   'adoptedStyleSheets' in Document.prototype &&
   'replace' in CSSStyleSheet.prototype;
 
+/**
+ * The root element where styles will be rendered.
+ * @type {Document | HTMLElement}
+ */
 const renderDocumentRoot = supportsAdoptingStyleSheets
   ? document
   : /* c8 ignore next */ document.head;
 
+/**
+ * Flattens the styles array.
+ * @param {Array} styles - The styles to flatten.
+ * @returns {Array} The flattened styles.
+ */
+const flattenStyles = styles => (Array.isArray(styles) ? styles.flat(Infinity) : [styles]);
+
+/**
+ * Adopts the given styles into the render root.
+ * @param {Document | HTMLElement} renderRoot - The root element where styles will be rendered.
+ * @param {Array} styles - The styles to adopt.
+ */
 export const adoptDocumentStyles = (renderRoot, styles) => {
   if (supportsAdoptingStyleSheets) {
     // https://github.com/lit/lit/issues/2984#issuecomment-1150224373
-    // eslint-disable-next-line no-param-reassign
-    renderRoot.adoptedStyleSheets = [
-      ...renderRoot.adoptedStyleSheets,
+    const documentRoot = /** @type {Document} */ (renderRoot);
+    documentRoot.adoptedStyleSheets = [
+      ...documentRoot.adoptedStyleSheets,
       ...styles.map(s => (s instanceof CSSStyleSheet ? s : s.styleSheet)),
     ];
   } else {
@@ -25,6 +49,11 @@ export const adoptDocumentStyles = (renderRoot, styles) => {
   }
 };
 
+/**
+ * Sets the document styles.
+ * @param {!*} styles - The styles to set.
+ */
 export const setDocumentStyles = styles => {
-  adoptDocumentStyles(renderDocumentRoot, [styles]);
+  const flattenedArray = flattenStyles(styles);
+  adoptDocumentStyles(renderDocumentRoot, flattenedArray);
 };