Explain the function behavior further

talldan · talldan · commit b8db01a5b66d · 2024-08-28T11:04:30.000+08:00
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.

Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,11 @@ const ROOT_SELECTOR_TOKENS = [`
`26`	`26`	`* instead, but this results in inconsistent specificity.`
`27`	`27`	`*`
`28`	`28`	`* This function instead inserts the prefix after the root tags but before`
`29`		`- * any other part of the selector.`
	`29`	`+ * any other part of the selector. This results in consistent specificity:`
	`30`	+ * - If a `:where()` selector is used for the prefix, all selectors output
	`31`	+ * by `transformStyles` will have no specificity increase.
	`32`	`+ * - If a classname, id, or something else is used as the prefix, all selectors`
	`33`	`+ * will have the same specificity bump when transformed.`
`30`	`34`	`*`
`31`	`35`	`* @param {string} prefix The prefix.`
`32`	`36`	`* @param {string} selector The selector.`