markdown alerts : parallel builds notice (#1214)

Author: romainmenke

.github/bin/generate-docs/install.mjs

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { parallelBuildsNotice } from './parallel-builds-notice.mjs';
 
 const template = fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), './install-template.md'), 'utf8');
 const packageJSONInfo = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
@@ -12,7 +13,7 @@ installDoc = installDoc.replaceAll('<packageName>', packageJSONInfo.name);
 installDoc = installDoc.replaceAll('<packagePath>', path.join(path.basename(path.dirname(process.cwd())), path.basename(process.cwd())));
 
 if (packageJSONInfo?.csstools?.assumesToProcessBundledCSS) {
-	installDoc = installDoc.replaceAll('<parallelBuildsNotice>', `⚠️ [${packageJSONInfo.csstools.humanReadableName}] assumes to process your complete CSS bundle.<br>If your build tool processes files individually or in parallel the output will be incorrect.<br>Using [\`@csstools/postcss-bundler\`](https://github.com/csstools/postcss-plugins/tree/main/plugin-packs/postcss-bundler) and \`@import\` statements is one way to make sure your CSS is bundled before it is processed by this plugin.\n`);
+	installDoc = installDoc.replaceAll('<parallelBuildsNotice>', parallelBuildsNotice(packageJSONInfo.csstools.humanReadableName));
 	installDoc = installDoc.replaceAll('<otherPluginsInWebpack>', `["@csstools/postcss-bundler"]`);
 	// <parallelBuildsNotice>
 } else {

.github/bin/generate-docs/parallel-builds-notice.mjs

@@ -0,0 +1,3 @@
+export function parallelBuildsNotice(label) {
+	return `> [!IMPORTANT]\n> [${label}] assumes to process your complete CSS bundle.<br>If your build tool processes files individually or processes files in parallel the output will be incorrect.<br>Using [\`@csstools/postcss-bundler\`](https://github.com/csstools/postcss-plugins/tree/main/plugin-packs/postcss-bundler) and \`@import\` statements is one way to make sure your CSS is bundled before it is processed by this plugin.\n`;
+}

.github/bin/generate-docs/readme.mjs

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { parallelBuildsNotice } from './parallel-builds-notice.mjs';
 
 const template = fs.readFileSync(path.join('docs', './README.md'), 'utf8');
 const corsTemplate = fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), './cors-template.md'), 'utf8');
@@ -33,6 +34,7 @@ readmeDoc = readmeDoc.replace(`<!-- Available Variables: -->
 <!-- <envSupport> -->
 <!-- <corsWarning> -->
 <!-- <linkList> -->
+<!-- <parallelBuildsNotice> -->
 <!-- to generate : npm run docs -->
 
 `, '');
@@ -110,6 +112,12 @@ readmeDoc = readmeDoc.replaceAll('<packageVersion>', packageJSONInfo.version);
 readmeDoc = readmeDoc.replaceAll('<packagePath>', path.join(path.basename(path.dirname(process.cwd())), path.basename(process.cwd())));
 readmeDoc = readmeDoc.replaceAll('<specUrl>', packageJSONInfo.csstools.specUrl);
 
+if (packageJSONInfo?.csstools?.assumesToProcessBundledCSS) {
+	readmeDoc = readmeDoc.replaceAll('<parallelBuildsNotice>', parallelBuildsNotice(packageJSONInfo.csstools.humanReadableName));
+} else {
+	readmeDoc = readmeDoc.replaceAll('<parallelBuildsNotice>', ``);
+}
+
 for (const exampleFilePath of exampleFilePaths) {
 	readmeDoc = readmeDoc.replaceAll(
 		`<${path.relative(path.join('test', 'examples'), exampleFilePath)}>`,