Explain the function behavior further

WordPress · Aug 28, 2024 · b8db01a · b8db01a
1 parent 534a8b5
commit b8db01a
Showing 1 changed file with 5 additions and 1 deletion.
diff --git a/packages/block-editor/src/utils/transform-styles/index.js b/packages/block-editor/src/utils/transform-styles/index.js
@@ -26,7 +26,11 @@ const ROOT_SELECTOR_TOKENS = [
  * instead, but this results in inconsistent specificity.
  *
  * This function instead inserts the prefix after the root tags but before
- * any other part of the selector.
+ * any other part of the selector. This results in consistent specificity:
+ * - If a `:where()` selector is used for the prefix, all selectors output
+ *   by `transformStyles` will have no specificity increase.
+ * - If a classname, id, or something else is used as the prefix, all selectors
+ *   will have the same specificity bump when transformed.
  *
  * @param {string} prefix   The prefix.
  * @param {string} selector The selector.