@jsenv/core 41.5.18 → 41.5.19

package/dist/build/build.js

@@ -1,5 +1,5 @@
-import { parseHtml, injectHtmlNodeAsEarlyAsPossible, createHtmlNode, stringifyHtmlAst, applyBabelPlugins, generateUrlForInlineContent, injectJsenvScript, parseJsWithAcorn, visitHtmlNodes, analyzeScriptNode, getHtmlNodeText, getHtmlNodeAttribute, getHtmlNodePosition, getUrlForContentInsideHtml, setHtmlNodeAttributes, setHtmlNodeText, parseCssUrls, getHtmlNodeAttributePosition, parseSrcSet, removeHtmlNodeText, parseJsUrls, getUrlForContentInsideJs, renderCssTemplateLiteral, visitJsAst, getImportMetaPropertyName, visitJsAstUntil, analyzeLinkNode, findHtmlNode, removeHtmlNode, insertHtmlNodeAfter } from "@jsenv/ast";
-import { lookupPackageDirectory, urlIsOrIsInsideOf, registerDirectoryLifecycle, urlToRelativeUrl, createDetailedMessage, stringifyUrlSite, generateContentFrame, validateResponseIntegrity, ensureWindowsDriveLetter, setUrlFilename, moveUrl, getCallerPosition, urlToBasename, urlToExtension, asSpecifierWithoutSearch, asUrlWithoutSearch, injectQueryParamsIntoSpecifier, bufferToEtag, isFileSystemPath, urlToPathname, setUrlBasename, urlToFileSystemPath, writeFileSync, createLogger, URL_META, applyNodeEsmResolution, normalizeUrl, ANSI, RUNTIME_COMPAT, CONTENT_TYPE, readPackageAtOrNull, urlToFilename, DATA_URL, errorToHTML, normalizeImportMap, composeTwoImportMaps, resolveImport, JS_QUOTES, readCustomConditionsFromProcessArgs, collectFiles, readEntryStatSync, applyFileSystemMagicResolution, getExtensionsToTry, ensurePathnameTrailingSlash, compareFileUrls, setUrlExtension, isSpecifierForNodeBuiltin, injectQueryParams, renderDetails, humanizeDuration, humanizeFileSize, renderTable, renderBigSection, distributePercentages, humanizeMemory, comparePathnames, UNICODE, escapeRegexpSpecialChars, injectQueryParamIntoSpecifierWithoutEncoding, renderUrlOrRelativeUrlFilename, assertAndNormalizeDirectoryUrl, Abort, raceProcessTeardownEvents, startMonitoringMemoryUsage, inferRuntimeCompatFromClosestPackage, browserDefaultRuntimeCompat, nodeDefaultRuntimeCompat, clearDirectorySync, createTaskLog, createLookupPackageDirectory, ensureEmptyDirectory, updateJsonFileSync, createDynamicLog } from "./jsenv_core_packages.js";
+import { parseHtml, injectHtmlNodeAsEarlyAsPossible, createHtmlNode, stringifyHtmlAst, applyBabelPlugins, generateUrlForInlineContent, injectJsenvScript, parseJsWithAcorn, visitHtmlNodes, analyzeScriptNode, getHtmlNodeText, getHtmlNodeAttribute, getHtmlNodePosition, getUrlForContentInsideHtml, setHtmlNodeAttributes, setHtmlNodeText, parseCssUrls, getHtmlNodeAttributePosition, parseSrcSet, removeHtmlNodeText, parseJsUrls, hasCssOpaqueDirective, getUrlForContentInsideJs, renderCssTemplateLiteral, visitJsAst, getImportMetaPropertyName, visitJsAstUntil, analyzeLinkNode, findHtmlNode, removeHtmlNode, insertHtmlNodeAfter } from "@jsenv/ast";
+import { lookupPackageDirectory, urlIsOrIsInsideOf, registerDirectoryLifecycle, urlToRelativeUrl, createDetailedMessage, stringifyUrlSite, generateContentFrame, validateResponseIntegrity, ensureWindowsDriveLetter, setUrlFilename, moveUrl, getCallerPosition, urlToBasename, urlToExtension, asSpecifierWithoutSearch, asUrlWithoutSearch, injectQueryParamsIntoSpecifier, bufferToEtag, isFileSystemPath, urlToPathname, setUrlBasename, urlToFileSystemPath, writeFileSync, createLogger, URL_META, applyNodeEsmResolution, normalizeUrl, ANSI, RUNTIME_COMPAT, CONTENT_TYPE, readPackageAtOrNull, urlToFilename, DATA_URL, errorToHTML, normalizeImportMap, composeTwoImportMaps, resolveImport, UNICODE, JS_QUOTES, readCustomConditionsFromProcessArgs, collectFiles, readEntryStatSync, applyFileSystemMagicResolution, getExtensionsToTry, ensurePathnameTrailingSlash, compareFileUrls, setUrlExtension, isSpecifierForNodeBuiltin, injectQueryParams, renderDetails, humanizeDuration, humanizeFileSize, renderTable, renderBigSection, distributePercentages, humanizeMemory, comparePathnames, escapeRegexpSpecialChars, injectQueryParamIntoSpecifierWithoutEncoding, renderUrlOrRelativeUrlFilename, assertAndNormalizeDirectoryUrl, Abort, raceProcessTeardownEvents, startMonitoringMemoryUsage, inferRuntimeCompatFromClosestPackage, browserDefaultRuntimeCompat, nodeDefaultRuntimeCompat, clearDirectorySync, createTaskLog, createLookupPackageDirectory, ensureEmptyDirectory, updateJsonFileSync, createDynamicLog } from "./jsenv_core_packages.js";
 import { bundleJsModules, jsenvPluginBundling } from "@jsenv/plugin-bundling";
 import { jsenvPluginMinification } from "@jsenv/plugin-minification";
 import { jsenvPluginTranspilation, jsenvPluginJsModuleFallback } from "@jsenv/plugin-transpilation";
@@ -5810,7 +5810,20 @@ const parseAndTransformJsReferences = async (
           renderCssTemplateLiteral(inlineUrlInfo.content, substitutions)
         : JS_QUOTES.escapeSpecialChars(inlineUrlInfo.content, { quote });
       if (replacement === null) {
-        // a placeholder did not survive: the source stays as it was written
+        // a placeholder did not survive the css transformation: giving the
+        // expressions back would not give back what the source said
+        if (inlineReferenceInfo.alreadyBuilt) {
+          return;
+        }
+        warnCssShippedAsWritten(urlInfo, {
+          line: inlineReferenceInfo.line,
+          column: inlineReferenceInfo.column,
+          reason: `a "\${}" placeholder did not survive the css transformation`,
+          templateSource: urlInfo.content.slice(
+            inlineReferenceInfo.start,
+            inlineReferenceInfo.end,
+          ),
+        });
         return;
       }
       magicSource.replace({
@@ -5918,7 +5931,13 @@ const parseAndTransformJsReferences = async (
     isNodeJs,
   });
   for (const jsReferenceInfo of jsReferenceInfos) {
-    if (jsReferenceInfo.isInline) {
+    if (jsReferenceInfo.isOpaqueCss) {
+      if (!jsReferenceInfo.alreadyBuilt) {
+        // a dependency's built css is opaque in a source this build does not
+        // have; its own build is where that is told
+        warnCssShippedAsWritten(urlInfo, jsReferenceInfo);
+      }
+    } else if (jsReferenceInfo.isInline) {
       onInlineReference(jsReferenceInfo);
     } else {
       onExternalReference(jsReferenceInfo);
@@ -5933,6 +5952,38 @@ const parseAndTransformJsReferences = async (
   return magicSource.toContentAndSourcemap();
 };
 
+// An import.meta.css the build cannot parse is shipped exactly as written:
+// comments, indentation, untranspiled properties and unresolved url() included,
+// in this build and in every build of every consumer of what it produces.
+// Nothing downstream can undo it, so the only place it can be told is here.
+const warnCssShippedAsWritten = (
+  urlInfo,
+  { line, column, reason, templateSource },
+) => {
+  if (!urlInfo.context.build) {
+    return;
+  }
+  if (hasCssOpaqueDirective(templateSource)) {
+    return;
+  }
+  urlInfo.context.logger.warn(
+    createDetailedMessage(
+      `${UNICODE.WARNING} import.meta.css shipped as written: not parsed, not transpiled, not minified`,
+      {
+        // line/column are read from the content as analyzed, which is not the
+        // file on disk once something transpiled it (jsx, babel helpers)
+        "css template":
+          urlInfo.content === urlInfo.originalContent
+            ? `${urlInfo.url}:${line}:${column}`
+            : urlInfo.url,
+        reason,
+        "suggestion": `only a "\${}" standing where a css value stands can be read; a custom property set from JS, a data attribute or a selector list covers nearly every other reason to interpolate`,
+        "to silence": `write "jsenv-css-opaque" in a css comment inside that template`,
+      },
+    ),
+  );
+};
+
 const jsenvPluginReferenceExpectedTypes = () => {
   const redirectJsReference = (reference) => {
     const urlObject = new URL(reference.url);

package/dist/start_dev_server/jsenv_core_packages.js

@@ -7449,4 +7449,4 @@ const isResponseEligibleForIntegrityValidation = (response) => {
   return ["basic", "cors", "default"].includes(response.type);
 };
 
-export { ANSI, CONTENT_TYPE, DATA_URL, JS_QUOTES, RUNTIME_COMPAT, URL_META, applyFileSystemMagicResolution, applyNodeEsmResolution, asSpecifierWithoutSearch, asUrlWithoutSearch, assertAndNormalizeDirectoryUrl, browserDefaultRuntimeCompat, bufferToEtag, collectFiles, compareFileUrls, composeTwoImportMaps, createDetailedMessage$1 as createDetailedMessage, createLogger, createTaskLog, ensurePathnameTrailingSlash, ensureWindowsDriveLetter, errorToHTML, formatError, generateContentFrame, getCallerPosition, getExtensionsToTry, inferRuntimeCompatFromClosestPackage, injectQueryParams, injectQueryParamsIntoSpecifier, isFileSystemPath, isSpecifierForNodeBuiltin, lookupPackageDirectory, moveUrl, normalizeImportMap, normalizeUrl, readCustomConditionsFromProcessArgs, readEntryStatSync, readPackageAtOrNull, registerDirectoryLifecycle, registerFileLifecycle, resolveImport, setUrlBasename, setUrlExtension, setUrlFilename, stringifyUrlSite, urlIsOrIsInsideOf, urlToBasename, urlToExtension$1 as urlToExtension, urlToFileSystemPath, urlToFilename$1 as urlToFilename, urlToPathname$1 as urlToPathname, urlToRelativeUrl, validateResponseIntegrity, writeFileSync };
+export { ANSI, CONTENT_TYPE, DATA_URL, JS_QUOTES, RUNTIME_COMPAT, UNICODE, URL_META, applyFileSystemMagicResolution, applyNodeEsmResolution, asSpecifierWithoutSearch, asUrlWithoutSearch, assertAndNormalizeDirectoryUrl, browserDefaultRuntimeCompat, bufferToEtag, collectFiles, compareFileUrls, composeTwoImportMaps, createDetailedMessage$1 as createDetailedMessage, createLogger, createTaskLog, ensurePathnameTrailingSlash, ensureWindowsDriveLetter, errorToHTML, formatError, generateContentFrame, getCallerPosition, getExtensionsToTry, inferRuntimeCompatFromClosestPackage, injectQueryParams, injectQueryParamsIntoSpecifier, isFileSystemPath, isSpecifierForNodeBuiltin, lookupPackageDirectory, moveUrl, normalizeImportMap, normalizeUrl, readCustomConditionsFromProcessArgs, readEntryStatSync, readPackageAtOrNull, registerDirectoryLifecycle, registerFileLifecycle, resolveImport, setUrlBasename, setUrlExtension, setUrlFilename, stringifyUrlSite, urlIsOrIsInsideOf, urlToBasename, urlToExtension$1 as urlToExtension, urlToFileSystemPath, urlToFilename$1 as urlToFilename, urlToPathname$1 as urlToPathname, urlToRelativeUrl, validateResponseIntegrity, writeFileSync };

package/dist/start_dev_server/start_dev_server.js

@@ -1,9 +1,9 @@
 import { WebSocketResponse, pickContentType, ServerEvents, serverPluginErrorHandler, fetchDirectory, composeTwoResponses, serverPluginCORS, jsenvAccessControlAllowedHeaders, startServer } from "@jsenv/server";
 import { existsSync, statSync, readFileSync, realpathSync, readdirSync, lstatSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { urlToRelativeUrl, registerFileLifecycle, lookupPackageDirectory, readPackageAtOrNull, generateContentFrame, errorToHTML, DATA_URL, CONTENT_TYPE, normalizeImportMap, composeTwoImportMaps, resolveImport, JS_QUOTES, urlToExtension, urlToBasename, applyNodeEsmResolution, URL_META, readCustomConditionsFromProcessArgs, urlIsOrIsInsideOf, collectFiles, registerDirectoryLifecycle, readEntryStatSync, applyFileSystemMagicResolution, getExtensionsToTry, urlToFilename, asUrlWithoutSearch, ensurePathnameTrailingSlash, compareFileUrls, setUrlExtension, createDetailedMessage, stringifyUrlSite, injectQueryParamsIntoSpecifier, isSpecifierForNodeBuiltin, injectQueryParams, urlToFileSystemPath, writeFileSync, moveUrl, ensureWindowsDriveLetter, validateResponseIntegrity, setUrlFilename, getCallerPosition, asSpecifierWithoutSearch, bufferToEtag, isFileSystemPath, urlToPathname, setUrlBasename, createLogger, normalizeUrl, ANSI, RUNTIME_COMPAT, formatError, assertAndNormalizeDirectoryUrl, browserDefaultRuntimeCompat, inferRuntimeCompatFromClosestPackage, createTaskLog } from "./jsenv_core_packages.js";
+import { urlToRelativeUrl, registerFileLifecycle, lookupPackageDirectory, readPackageAtOrNull, generateContentFrame, errorToHTML, DATA_URL, CONTENT_TYPE, normalizeImportMap, composeTwoImportMaps, resolveImport, createDetailedMessage, UNICODE, JS_QUOTES, urlToExtension, urlToBasename, applyNodeEsmResolution, URL_META, readCustomConditionsFromProcessArgs, urlIsOrIsInsideOf, collectFiles, registerDirectoryLifecycle, readEntryStatSync, applyFileSystemMagicResolution, getExtensionsToTry, urlToFilename, asUrlWithoutSearch, ensurePathnameTrailingSlash, compareFileUrls, setUrlExtension, stringifyUrlSite, injectQueryParamsIntoSpecifier, isSpecifierForNodeBuiltin, injectQueryParams, urlToFileSystemPath, writeFileSync, moveUrl, ensureWindowsDriveLetter, validateResponseIntegrity, setUrlFilename, getCallerPosition, asSpecifierWithoutSearch, bufferToEtag, isFileSystemPath, urlToPathname, setUrlBasename, createLogger, normalizeUrl, ANSI, RUNTIME_COMPAT, formatError, assertAndNormalizeDirectoryUrl, browserDefaultRuntimeCompat, inferRuntimeCompatFromClosestPackage, createTaskLog } from "./jsenv_core_packages.js";
 import { createPluginsController } from "@jsenv/server/src/plugins_controller.js";
-import { parseHtml, injectJsenvScript, stringifyHtmlAst, parseCssUrls, getHtmlNodeAttribute, getHtmlNodePosition, getHtmlNodeAttributePosition, setHtmlNodeAttributes, parseSrcSet, getUrlForContentInsideHtml, removeHtmlNodeText, setHtmlNodeText, getHtmlNodeText, analyzeScriptNode, visitHtmlNodes, parseJsUrls, getUrlForContentInsideJs, renderCssTemplateLiteral, applyBabelPlugins, visitJsAst, getImportMetaPropertyName, visitJsAstUntil, analyzeLinkNode, injectHtmlNodeAsEarlyAsPossible, createHtmlNode, generateUrlForInlineContent, parseJsWithAcorn } from "@jsenv/ast";
+import { parseHtml, injectJsenvScript, stringifyHtmlAst, parseCssUrls, getHtmlNodeAttribute, getHtmlNodePosition, getHtmlNodeAttributePosition, setHtmlNodeAttributes, parseSrcSet, getUrlForContentInsideHtml, removeHtmlNodeText, setHtmlNodeText, getHtmlNodeText, analyzeScriptNode, visitHtmlNodes, parseJsUrls, hasCssOpaqueDirective, getUrlForContentInsideJs, renderCssTemplateLiteral, applyBabelPlugins, visitJsAst, getImportMetaPropertyName, visitJsAstUntil, analyzeLinkNode, injectHtmlNodeAsEarlyAsPossible, createHtmlNode, generateUrlForInlineContent, parseJsWithAcorn } from "@jsenv/ast";
 import { jsenvPluginSupervisor } from "@jsenv/plugin-supervisor";
 import { jsenvPluginTranspilation } from "@jsenv/plugin-transpilation";
 import { createMagicSource, composeTwoSourcemaps, generateSourcemapFileUrl, generateSourcemapDataUrl, SOURCEMAP, applyContentEditsOnSourcemap, composeSourcemaps } from "@jsenv/sourcemap";
@@ -2392,7 +2392,20 @@ const parseAndTransformJsReferences = async (
           renderCssTemplateLiteral(inlineUrlInfo.content, substitutions)
         : JS_QUOTES.escapeSpecialChars(inlineUrlInfo.content, { quote });
       if (replacement === null) {
-        // a placeholder did not survive: the source stays as it was written
+        // a placeholder did not survive the css transformation: giving the
+        // expressions back would not give back what the source said
+        if (inlineReferenceInfo.alreadyBuilt) {
+          return;
+        }
+        warnCssShippedAsWritten(urlInfo, {
+          line: inlineReferenceInfo.line,
+          column: inlineReferenceInfo.column,
+          reason: `a "\${}" placeholder did not survive the css transformation`,
+          templateSource: urlInfo.content.slice(
+            inlineReferenceInfo.start,
+            inlineReferenceInfo.end,
+          ),
+        });
         return;
       }
       magicSource.replace({
@@ -2500,7 +2513,13 @@ const parseAndTransformJsReferences = async (
     isNodeJs,
   });
   for (const jsReferenceInfo of jsReferenceInfos) {
-    if (jsReferenceInfo.isInline) {
+    if (jsReferenceInfo.isOpaqueCss) {
+      if (!jsReferenceInfo.alreadyBuilt) {
+        // a dependency's built css is opaque in a source this build does not
+        // have; its own build is where that is told
+        warnCssShippedAsWritten(urlInfo, jsReferenceInfo);
+      }
+    } else if (jsReferenceInfo.isInline) {
       onInlineReference(jsReferenceInfo);
     } else {
       onExternalReference(jsReferenceInfo);
@@ -2515,6 +2534,38 @@ const parseAndTransformJsReferences = async (
   return magicSource.toContentAndSourcemap();
 };
 
+// An import.meta.css the build cannot parse is shipped exactly as written:
+// comments, indentation, untranspiled properties and unresolved url() included,
+// in this build and in every build of every consumer of what it produces.
+// Nothing downstream can undo it, so the only place it can be told is here.
+const warnCssShippedAsWritten = (
+  urlInfo,
+  { line, column, reason, templateSource },
+) => {
+  if (!urlInfo.context.build) {
+    return;
+  }
+  if (hasCssOpaqueDirective(templateSource)) {
+    return;
+  }
+  urlInfo.context.logger.warn(
+    createDetailedMessage(
+      `${UNICODE.WARNING} import.meta.css shipped as written: not parsed, not transpiled, not minified`,
+      {
+        // line/column are read from the content as analyzed, which is not the
+        // file on disk once something transpiled it (jsx, babel helpers)
+        "css template":
+          urlInfo.content === urlInfo.originalContent
+            ? `${urlInfo.url}:${line}:${column}`
+            : urlInfo.url,
+        reason,
+        "suggestion": `only a "\${}" standing where a css value stands can be read; a custom property set from JS, a data attribute or a selector list covers nearly every other reason to interpolate`,
+        "to silence": `write "jsenv-css-opaque" in a css comment inside that template`,
+      },
+    ),
+  );
+};
+
 const jsenvPluginReferenceExpectedTypes = () => {
   const redirectJsReference = (reference) => {
     const urlObject = new URL(reference.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "41.5.18",
+  "version": "41.5.19",
   "type": "module",
   "description": "Tool to develop, test and build js projects",
   "repository": {
@@ -73,12 +73,12 @@
     "test:snapshot_clear": "npx @jsenv/filesystem clear **/tests/**/side_effects/"
   },
   "dependencies": {
-    "@jsenv/ast": "6.10.4",
-    "@jsenv/js-module-fallback": "1.6.8",
+    "@jsenv/ast": "6.10.5",
+    "@jsenv/js-module-fallback": "1.6.9",
     "@jsenv/plugin-bundling": "2.10.28",
-    "@jsenv/plugin-minification": "1.7.21",
-    "@jsenv/plugin-supervisor": "1.8.23",
-    "@jsenv/plugin-transpilation": "1.7.8",
+    "@jsenv/plugin-minification": "1.7.22",
+    "@jsenv/plugin-supervisor": "1.8.24",
+    "@jsenv/plugin-transpilation": "1.7.9",
     "@jsenv/server": "17.6.4",
     "@jsenv/sourcemap": "1.4.9",
     "react-table": "7.8.0"

package/src/plugins/reference_analysis/js/jsenv_plugin_js_reference_analysis.js

@@ -1,8 +1,10 @@
 import {
   getUrlForContentInsideJs,
+  hasCssOpaqueDirective,
   parseJsUrls,
   renderCssTemplateLiteral,
 } from "@jsenv/ast";
+import { createDetailedMessage, UNICODE } from "@jsenv/humanize";
 import {
   isWebWorkerEntryPointReference,
   isWebWorkerUrlInfo,
@@ -82,7 +84,20 @@ const parseAndTransformJsReferences = async (
           renderCssTemplateLiteral(inlineUrlInfo.content, substitutions)
         : JS_QUOTES.escapeSpecialChars(inlineUrlInfo.content, { quote });
       if (replacement === null) {
-        // a placeholder did not survive: the source stays as it was written
+        // a placeholder did not survive the css transformation: giving the
+        // expressions back would not give back what the source said
+        if (inlineReferenceInfo.alreadyBuilt) {
+          return;
+        }
+        warnCssShippedAsWritten(urlInfo, {
+          line: inlineReferenceInfo.line,
+          column: inlineReferenceInfo.column,
+          reason: `a "\${}" placeholder did not survive the css transformation`,
+          templateSource: urlInfo.content.slice(
+            inlineReferenceInfo.start,
+            inlineReferenceInfo.end,
+          ),
+        });
         return;
       }
       magicSource.replace({
@@ -190,7 +205,13 @@ const parseAndTransformJsReferences = async (
     isNodeJs,
   });
   for (const jsReferenceInfo of jsReferenceInfos) {
-    if (jsReferenceInfo.isInline) {
+    if (jsReferenceInfo.isOpaqueCss) {
+      if (!jsReferenceInfo.alreadyBuilt) {
+        // a dependency's built css is opaque in a source this build does not
+        // have; its own build is where that is told
+        warnCssShippedAsWritten(urlInfo, jsReferenceInfo);
+      }
+    } else if (jsReferenceInfo.isInline) {
       onInlineReference(jsReferenceInfo);
     } else {
       onExternalReference(jsReferenceInfo);
@@ -204,3 +225,35 @@ const parseAndTransformJsReferences = async (
   }
   return magicSource.toContentAndSourcemap();
 };
+
+// An import.meta.css the build cannot parse is shipped exactly as written:
+// comments, indentation, untranspiled properties and unresolved url() included,
+// in this build and in every build of every consumer of what it produces.
+// Nothing downstream can undo it, so the only place it can be told is here.
+const warnCssShippedAsWritten = (
+  urlInfo,
+  { line, column, reason, templateSource },
+) => {
+  if (!urlInfo.context.build) {
+    return;
+  }
+  if (hasCssOpaqueDirective(templateSource)) {
+    return;
+  }
+  urlInfo.context.logger.warn(
+    createDetailedMessage(
+      `${UNICODE.WARNING} import.meta.css shipped as written: not parsed, not transpiled, not minified`,
+      {
+        // line/column are read from the content as analyzed, which is not the
+        // file on disk once something transpiled it (jsx, babel helpers)
+        "css template":
+          urlInfo.content === urlInfo.originalContent
+            ? `${urlInfo.url}:${line}:${column}`
+            : urlInfo.url,
+        reason,
+        "suggestion": `only a "\${}" standing where a css value stands can be read; a custom property set from JS, a data attribute or a selector list covers nearly every other reason to interpolate`,
+        "to silence": `write "jsenv-css-opaque" in a css comment inside that template`,
+      },
+    ),
+  );
+};