@apleasantview/eleventy-plugin-baseline 0.1.0-next.32 → 0.1.0-next.33

package/modules/head-core/utils/head-utils.js

@@ -1,16 +1,38 @@
-import Merge from '@11ty/eleventy-utils/src/Merge.js';
-import { TemplatePath } from '@11ty/eleventy-utils';
+import { Merge, TemplatePath } from '@11ty/eleventy-utils';
 
+/**
+ * Return the first value that is neither undefined nor null.
+ * @param {...*} values
+ * @returns {*}
+ */
 const pick = (...values) => values.find((v) => v !== undefined && v !== null);
 
+/**
+ * Normalize a path prefix to match Eleventy's URL behavior.
+ * Returns empty string for root ('/'), otherwise the normalized prefix.
+ * @param {string} [pathPrefix='']
+ * @returns {string}
+ */
 const normalizePathPrefix = (pathPrefix = '') => {
-	// Align with Eleventy’s normalizeUrlPath behavior
 	const normalized = TemplatePath.normalizeUrlPath('/', pathPrefix);
-	return normalized === '/' ? '' : normalized; // empty means root
+	return normalized === '/' ? '' : normalized;
 };
 
+/**
+ * Test whether a URL is absolute (has a scheme or is protocol-relative).
+ * @param {string} [url='']
+ * @returns {boolean}
+ */
 const isAbsoluteUrl = (url = '') => /^[a-z][a-z\d+\-.]*:\/\//i.test(url) || url.startsWith('//');
 
+/**
+ * Build an absolute URL from siteUrl + pathPrefix + relative URL.
+ * Returns the input unchanged if already absolute or empty.
+ * @param {string} siteUrl - Site root (e.g. 'https://example.com').
+ * @param {string} pathPrefix - Eleventy path prefix.
+ * @param {string} url - The URL to resolve.
+ * @returns {string}
+ */
 const absoluteUrl = (siteUrl, pathPrefix, url) => {
 	if (!url) return url;
 	if (isAbsoluteUrl(url)) return url;
@@ -19,6 +41,19 @@ const absoluteUrl = (siteUrl, pathPrefix, url) => {
 	return siteUrl ? `${siteUrl.replace(/\/+$/, '')}${joined}` : joined;
 };
 
+/**
+ * Merge site defaults, user overrides, and computed values into a raw head object.
+ * The result contains all head sections (meta, link, OG, twitter, etc.) before
+ * deduplication and flattening.
+ * @param {Object} site - Site-level data (site.yaml / site.json).
+ * @param {Object} user - Page-level head overrides (the `head` data key).
+ * @param {Object} page - Eleventy page object.
+ * @param {string} title - Resolved page title.
+ * @param {string} description - Resolved description.
+ * @param {boolean} noindex - Whether to set noindex/nofollow.
+ * @param {string} url - Canonical URL.
+ * @returns {Object} Merged head object.
+ */
 const mergeBaseHead = (site, user, page, title, description, noindex, url) => {
 	return Merge(
 		{},
@@ -54,6 +89,15 @@ const mergeBaseHead = (site, user, page, title, description, noindex, url) => {
 	);
 };
 
+/**
+ * Resolve the canonical URL for a page. Uses an explicit canonical from head
+ * data if present, otherwise derives it from the page URL or content map.
+ * @param {Object} head - Head data (may contain a canonical property).
+ * @param {Object} page - Eleventy page object.
+ * @param {Object} contentMap - Cached inputPathToUrl / urlToInputPath maps.
+ * @param {Object} [env] - Environment options (siteUrl, pathPrefix, verbose).
+ * @returns {string|undefined} Absolute canonical URL, or undefined if unresolvable.
+ */
 const resolveCanonical = (head, page, contentMap, env = {}) => {
 	const { siteUrl, pathPrefix = '', pageUrlOverride, verbose } = env;
 	const explicit = pick(head.canonical);
@@ -74,6 +118,12 @@ const resolveCanonical = (head, page, contentMap, env = {}) => {
 	return absoluteUrl(siteUrl, pathPrefix, url);
 };
 
+/**
+ * Deduplicate meta tags. Last-wins by key (charset, name, property, http-equiv).
+ * Preserves insertion order after dedup.
+ * @param {Array<Object>} [arr=[]] - Array of meta tag objects.
+ * @returns {Array<Object>}
+ */
 const dedupeMeta = (arr = []) => {
 	const seen = new Set();
 	const out = [];
@@ -95,6 +145,11 @@ const dedupeMeta = (arr = []) => {
 	return out.reverse();
 };
 
+/**
+ * Deduplicate link tags by rel+href. Last-wins, preserves insertion order.
+ * @param {Array<Object>} [links=[]] - Array of link tag objects.
+ * @returns {Array<Object>}
+ */
 const dedupeLink = (links = []) => {
 	const seen = new Set();
 	const out = [];
@@ -108,8 +163,15 @@ const dedupeLink = (links = []) => {
 	return out.reverse();
 };
 
+/**
+ * Flatten a merged head object into the shape posthtml-head-elements expects.
+ * Deduplicates meta and link tags, separates social meta, and prepends
+ * structured data as a JSON-LD script.
+ * @param {Object} [head={}] - Merged head object from mergeBaseHead.
+ * @param {string} canonical - Resolved canonical URL.
+ * @returns {Object} Flat head spec keyed by element type (meta, title, link, script, etc.).
+ */
 const flattenHead = (head = {}, canonical) => {
-	// base/meta first, keep OG/Twitter last by placing them in a separate meta bucket
 	const baseMeta = dedupeMeta([...(head.meta || []), ...(head.miscMeta || [])]);
 
 	const socialMeta = dedupeMeta([
@@ -150,6 +212,14 @@ const flattenHead = (head = {}, canonical) => {
 	};
 };
 
+/**
+ * Build the complete head spec for a page. This is the main entry point —
+ * resolves title, description, canonical, merges everything, and flattens.
+ * Called from both the computed global data and the PostHTML transform fallback.
+ * @param {Object} [data={}] - Full Eleventy data cascade for the page.
+ * @param {Object} [env={}] - Environment options (userKey, contentMap, siteUrl, pathPrefix, verbose).
+ * @returns {Object} Flat head spec ready for posthtml-head-elements.
+ */
 const buildHead = (data = {}, env = {}) => {
 	const { userKey = 'head', contentMap = {}, siteUrl, pathPrefix } = env;
 	const site = data.site || {};
@@ -176,8 +246,4 @@ const buildHead = (data = {}, env = {}) => {
 	return flattenHead(merged, canonical);
 };
 
-const buildHeadSpec = (context, contentMap, env = {}) => {
-	return buildHead(context, { ...env, contentMap });
-};
-
-export { pick, resolveCanonical, flattenHead, buildHead, buildHeadSpec, absoluteUrl };
+export { pick, resolveCanonical, flattenHead, buildHead, absoluteUrl };

package/modules/multilang-core/plugins/multilang-core.js

@@ -5,12 +5,21 @@ import i18nTranslationIn from '../filters/i18n-translation-in.js';
 import i18nDefaultTranslation from '../filters/i18n-default-translation.js';
 
 /**
- * Baseline – multilang-core
+ * eleventy-plugin-multilang-core
  *
- * Responsibilities:
- * - Normalize language metadata
- * - Annotate translatable pages
- * - Expose relational helpers for translations
+ * Language infrastructure for multilingual sites. Normalizes language metadata,
+ * builds a translations map keyed by translationKey + lang, and exposes
+ * relational filters for cross-language lookups. Wraps Eleventy's built-in
+ * I18nPlugin with stricter language validation.
+ *
+ * Depends on: Eleventy I18nPlugin (built-in), @11ty/eleventy-utils (DeepCopy).
+ * No cross-module dependencies. Sitemap-core receives language config via
+ * options at registration time, not through imports.
+ *
+ * Options:
+ *  - defaultLanguage (string, default 'en'): fallback language code.
+ *  - languages (array|object): allowed languages. Pages with unlisted langs are skipped.
+ *  - verbose (boolean, default false): warn on unknown language codes.
  *
  * @param { import("@11ty/eleventy/src/UserConfig.js").default } eleventyConfig
  */
@@ -22,12 +31,13 @@ export default function multilangCore(eleventyConfig, options = {}) {
 		...options
 	};
 
+	// Register Eleventy's built-in I18nPlugin for locale-aware URL resolution.
 	eleventyConfig.addPlugin(I18nPlugin, {
 		defaultLanguage: userOptions.defaultLanguage,
 		errorMode: 'allow-fallback'
 	});
 
-	// Normalize allowed languages (optionally lower/trim)
+	// Build a set of allowed language codes for validation during collection building.
 	const normalizeLang = (lang) => (lang || '').toLowerCase().trim();
 	const allowedLanguages = new Set(
 		Array.isArray(userOptions.languages)
@@ -35,6 +45,8 @@ export default function multilangCore(eleventyConfig, options = {}) {
 			: Object.keys(userOptions.languages || {}).map(normalizeLang)
 	);
 
+	// Computed locale data: every page gets a page.locale object with its
+	// resolved lang, translationKey, and whether it's the default language.
 	eleventyConfig.addGlobalData('eleventyComputed.page.locale', () => {
 		return (data) => {
 			const lang = normalizeLang(data.lang || data.language || userOptions.defaultLanguage);
@@ -49,6 +61,8 @@ export default function multilangCore(eleventyConfig, options = {}) {
 		};
 	});
 
+	// Build both the map (keyed by translationKey → lang) and the flat list.
+	// Shared logic for both collections — called once per collection registration.
 	const buildTranslations = (collection) => {
 		const map = {};
 		const list = [];
@@ -84,17 +98,20 @@ export default function multilangCore(eleventyConfig, options = {}) {
 		return { map, list };
 	};
 
-	// Map form for direct lookups
+	// --- Collections ---
+
+	// Map form: translationsMap[translationKey][lang] → page metadata.
 	eleventyConfig.addCollection('translationsMap', (collection) => {
 		return buildTranslations(collection).map;
 	});
 
-	// Canonical translations collection
+	// Flat list: all translatable pages with locale data attached.
 	eleventyConfig.addCollection('translations', (collection) => {
 		return buildTranslations(collection).list;
 	});
 
-	// Filters – relational helpers
+	// --- Filters ---
+	// Relational helpers for cross-language lookups in templates.
 	eleventyConfig.addFilter('i18nTranslationsFor', i18nTranslationsFor);
 	eleventyConfig.addFilter('i18nTranslationIn', i18nTranslationIn);
 	eleventyConfig.addFilter('i18nDefaultTranslation', i18nDefaultTranslation);

package/modules/navigator-core/plugins/navigator-core.js

@@ -5,6 +5,20 @@ import { fileURLToPath } from 'node:url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+/**
+ * eleventy-plugin-navigator-core
+ *
+ * Debug tooling. Exposes the full Nunjucks environment and template context
+ * as globals so templates can inspect what data is available at render time.
+ * Optionally registers a virtual /navigator-core.html page that dumps
+ * everything in a readable format.
+ *
+ * No dependencies on other modules or core utilities. Standalone.
+ *
+ * Options:
+ *  - enableNavigatorTemplate (boolean|[boolean, number]): register the debug page.
+ *    Pass [true, depth] to control inspector depth (default 2).
+ */
 /** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
 export default function navigatorCore(eleventyConfig, options = {}) {
 	const raw = options.enableNavigatorTemplate;
@@ -16,6 +30,9 @@ export default function navigatorCore(eleventyConfig, options = {}) {
 		inspectorDepth: inspectorDepth ?? 2
 	};
 
+	// --- Globals ---
+	// _navigator: the full Nunjucks runtime environment (this).
+	// _context: the template context object (this.ctx) — what templates actually see.
 	eleventyConfig.addNunjucksGlobal('_navigator', function () {
 		return this;
 	});
@@ -23,8 +40,9 @@ export default function navigatorCore(eleventyConfig, options = {}) {
 		return this.ctx;
 	});
 
+	// --- Virtual debug template ---
 	if (userOptions.enableNavigatorTemplate) {
-		// Read virtual template synchronously; Nunjucks pipeline here is sync-only.
+		// Read synchronously — Nunjucks virtual template registration is sync-only.
 		const templatePath = path.join(__dirname, '../templates/navigator-core.html');
 		const virtualTemplateContent = fs.readFileSync(templatePath, 'utf-8');
 		eleventyConfig.addTemplate('navigator-core.html', virtualTemplateContent, {

package/modules/navigator-core/templates/navigator-core.html

@@ -42,7 +42,7 @@ permalink: /navigator-core.html
 			<details>
 				<summary><strong>{{ key }}</strong></summary>
 				{% if value | isString %}
-				<pre>{{ value | safe }}</pre>
+				<pre>{{ value }}</pre>
 				{% else %}
 				<pre>{{ value | _inspect({ depth: inspectorDepth }) }}</pre>
 				{% endif %}
@@ -56,9 +56,9 @@ permalink: /navigator-core.html
 			history.back();
 		});
 	</script>
+	<footer>
+		<div class="_navigator__wrapper"><small>Navigator Core — Eleventy Plugin Baseline</small></div>
+	</footer>
 </body>
-<footer>
-	<div class="_navigator__wrapper"><small>Navigator Core — Eleventy Plugin Baseline</small></div>
-</footer>
 
 </html>

package/modules/sitemap-core/plugins/sitemap-core.js

@@ -5,6 +5,23 @@ import { fileURLToPath } from 'node:url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+/**
+ * eleventy-plugin-sitemap-core
+ *
+ * Generates XML sitemaps. Adds a computed page.sitemap object to every page
+ * (with ignore/changefreq/priority), then registers virtual templates for
+ * the sitemap XML. In multilingual mode, produces per-language sitemaps plus
+ * a sitemap index. Pages opt out via noindex in data.
+ *
+ * No cross-module dependencies. Receives multilingual config (languages,
+ * multilingual flag) via options at registration time — does not import
+ * from multilang-core.
+ *
+ * Options:
+ *  - enableSitemapTemplate (boolean, default true): register virtual sitemap templates.
+ *  - multilingual (boolean): force multilingual mode. Auto-detected from languages if omitted.
+ *  - languages (array|object): language codes. Determines per-language sitemap generation.
+ */
 /** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
 export default function sitemapCore(eleventyConfig, options = {}) {
 	const userOptions = {
@@ -13,6 +30,8 @@ export default function sitemapCore(eleventyConfig, options = {}) {
 		languages: options.languages
 	};
 
+	// Computed sitemap data: every page gets a page.sitemap object.
+	// Pages set noindex in frontmatter or site data to be excluded.
 	eleventyConfig.addGlobalData('eleventyComputed.page.sitemap', () => {
 		return (data) => ({
 			ignore: data.noindex ?? data.page?.noindex ?? data.site?.noindex ?? false,
@@ -21,6 +40,10 @@ export default function sitemapCore(eleventyConfig, options = {}) {
 		});
 	});
 
+	// --- Virtual sitemap templates ---
+	// Read template sources synchronously (same constraint as navigator-core).
+	// In multilingual mode: one sitemap per language + a sitemap index.
+	// In single-language mode: one flat sitemap at /sitemap.xml.
 	if (userOptions.enableSitemapTemplate) {
 		const templatePath = path.join(__dirname, '../templates/sitemap-core.html');
 		const indexTemplatePath = path.join(__dirname, '../templates/sitemap-index.html');

package/modules/sitemap-core/templates/sitemap-core.html

@@ -1,25 +1,34 @@
 <?xml version="1.0" encoding="utf-8" standalone="yes"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
-{%- if not site.noindex -%}
-{%- for item in collections.all -%}
-{%- if not item.data.eleventyExcludeFromCollections and (not item.data.sitemap or item.data.sitemap.ignore != true) and item.data.noindex != true -%}
-{%- set pageLang = item.data.lang or site.defaultLanguage -%}
-{%- if (not isMultilingual) or (not sitemapLang) or (pageLang == sitemapLang) -%}
-{%- set absoluteUrl = item.url | htmlBaseUrl -%}
-{%- set lastmod = item.data.sitemap and item.data.sitemap.lastmod or item.date -%}
+{%- if not site.noindex %}
+{%- for item in collections.all %}
+{%- if not item.data.eleventyExcludeFromCollections and (not item.data.sitemap or item.data.sitemap.ignore != true) and item.data.noindex != true %}
+{%- set pageLang = item.data.lang or site.defaultLanguage %}
+{%- if (not isMultilingual) or (not sitemapLang) or (pageLang == sitemapLang) %}
+{%- set absoluteUrl = item.url | htmlBaseUrl %}
+{%- set lastmod = item.data.sitemap and item.data.sitemap.lastmod or item.date %}
 <url>
 <loc>{{ absoluteUrl }}</loc>
-{%- if lastmod -%}<lastmod>{{ date.toUTCISO(lastmod) }}</lastmod>{%- endif -%}
-{%- if item.data.sitemap and item.data.sitemap.changefreq -%}<changefreq>{{ item.data.sitemap.changefreq }}</changefreq>{%- endif -%}
-{%- if item.data.sitemap and item.data.sitemap.priority is defined -%}<priority>{{ item.data.sitemap.priority }}</priority>{%- endif -%}
-{%- if item.data.translationKey and collections.translationsMap and collections.translationsMap[item.data.translationKey] -%}
-{%- for language, entry in collections.translationsMap[item.data.translationKey] -%}
+{%- if lastmod %}
+<lastmod>{{ date.toUTCISO(lastmod) }}</lastmod>
+{%- endif %}
+{%- if item.data.sitemap and item.data.sitemap.changefreq %}
+<changefreq>{{ item.data.sitemap.changefreq }}</changefreq>
+{%- endif %}
+{%- if item.data.sitemap and item.data.sitemap.priority is defined %}
+<priority>{{ item.data.sitemap.priority }}</priority>
+{%- endif %}
+{%- if item.data.translationKey and collections.translationsMap and collections.translationsMap[item.data.translationKey] %}
+{%- for language, entry in collections.translationsMap[item.data.translationKey] %}
 <xhtml:link rel="alternate" hreflang="{{ entry.lang }}" href="{{ entry.url | htmlBaseUrl }}" />
-{%- endfor -%}
-{%- endif -%}
+{%- if entry.isDefaultLang %}
+<xhtml:link rel="alternate" hreflang="x-default" href="{{ entry.url | htmlBaseUrl }}" />
+{%- endif %}
+{%- endfor %}
+{%- endif %}
 </url>
-{%- endif -%}
-{%- endif -%}
-{%- endfor -%}
-{%- endif -%}
+{%- endif %}
+{%- endif %}
+{%- endfor %}
+{%- endif %}
 </urlset>

package/modules/sitemap-core/templates/sitemap-index.html

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8" standalone="yes"?>
 <sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 {%- if not site.noindex %}
-{%- set langs = _baseline.languages or _i18n.languages %}
+{%- set langs = _baseline.languages %}
 {%- if langs %}
 {%- for lang, cfg in langs %}
 <sitemap>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apleasantview/eleventy-plugin-baseline",
-  "version": "0.1.0-next.32",
+  "version": "0.1.0-next.33",
   "description": "An experimental Swiss army knife toolkit for Eleventy",
   "type": "module",
   "main": "eleventy.config.js",

package/modules/assets-esbuild/plugins/assets-esbuild.js

@@ -1,71 +0,0 @@
-import path from 'node:path';
-import * as esbuild from 'esbuild';
-import { resolveAssetsDir } from '../../../core/helpers.js';
-import inlineESbuild from '../filters/inline-esbuild.js';
-
-/**
- * assets-esbuild
- *
- * - Registers `js` as a template format and bundles/minifies `index.js` entries under the resolved assets `js` dir.
- * - Registers `inlineESbuild` filter to inline arbitrary JS by bundling it with esbuild.
- * - Filters the `all` collection to drop `11tydata.js` files (added by the `js` template format).
- *
- * Options:
- * - minify (boolean, default true): pass-through to esbuild minify flag.
- * - target (string|string[], default "es2020"): pass-through to esbuild target.
- */
-/** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
-export default function assetsESBuild(eleventyConfig, options = {}) {
-	const defaultOptions = { minify: true, target: 'es2020' };
-	const { assetsDir } = resolveAssetsDir(
-		eleventyConfig.dir?.input || './',
-		eleventyConfig.dir?.output || './',
-		eleventyConfig.dir?.assets || 'assets'
-	);
-	const jsDir = `${assetsDir}js/`;
-	const userOptions = { ...defaultOptions, ...options };
-
-	eleventyConfig.addTemplateFormats('js');
-
-	eleventyConfig.addExtension('js', {
-		outputFileExtension: 'js',
-		useLayouts: false,
-		compile: async function (_inputContent, inputPath) {
-			if (
-				inputPath.includes('11tydata.js') ||
-				!inputPath.startsWith(jsDir) ||
-				path.basename(inputPath) !== 'index.js'
-			) {
-				return;
-			}
-
-			return async () => {
-				let result = await esbuild.build({
-					entryPoints: [inputPath],
-					bundle: true,
-					minify: userOptions.minify,
-					target: userOptions.target,
-					write: false
-				});
-
-				return result.outputFiles[0].text;
-			};
-		}
-	});
-
-	// Filter to inline a bundled entry; supports callback style (Nunjucks/Liquid) and Promise return.
-	eleventyConfig.addAsyncFilter('inlineESbuild', async function (jsFilePath, callback) {
-		const done = typeof callback === 'function' ? callback : null;
-		try {
-			const js = await inlineESbuild(jsFilePath);
-			const html = `<script>${js}</script>`;
-			if (done) return done(null, html);
-			return html;
-		} catch {
-			// Non-fatal fallback: return an error comment wrapped in script tags.
-			const html = `<script>/* Error processing JS */</script>`;
-			if (done) return done(null, html);
-			return html;
-		}
-	});
-}

package/modules/assets-postcss/filters/inline-postcss.js

@@ -1,38 +0,0 @@
-import fs from 'fs/promises';
-import postcss from 'postcss';
-import loadPostCSSConfig from 'postcss-load-config';
-import fallbackPostCSSConfig from '../fallback/postcss.config.js';
-
-// Resolve user PostCSS config from the project root (cwd), not the Eleventy input dir.
-const configRoot = process.cwd();
-
-export default async function inlinePostCSS(cssFilePath) {
-	try {
-		let cssContent = await fs.readFile(cssFilePath, 'utf8');
-
-		let plugins;
-		let options;
-
-		try {
-			// Prefer the consuming project's PostCSS config (postcss.config.* or package.json#postcss).
-			({ plugins, options } = await loadPostCSSConfig({}, configRoot));
-		} catch {
-			// If none is found, fall back to the bundled Baseline config to keep builds working.
-			const { plugins: fallbackPlugins, ...fallbackOptions } = fallbackPostCSSConfig;
-			plugins = fallbackPlugins;
-			options = fallbackOptions;
-		}
-
-		let result = await postcss(plugins).process(cssContent, {
-			from: cssFilePath,
-			map: options?.map
-		});
-
-		// Return raw CSS; markup wrapping is handled in the plugin registration.
-		return result.css;
-	} catch (error) {
-		console.error(error);
-		// Surface a safe CSS string so the caller can decide how to wrap it.
-		return '/* Error processing CSS */';
-	}
-}

package/modules/assets-postcss/plugins/assets-postcss.js

@@ -1,75 +0,0 @@
-import path from 'node:path';
-import postcss from 'postcss';
-import loadPostCSSConfig from 'postcss-load-config';
-import fallbackPostCSSConfig from '../fallback/postcss.config.js';
-import inlinePostCSS from '../filters/inline-postcss.js';
-import { resolveAssetsDir } from '../../../core/helpers.js';
-
-/**
- * assets-postcss
- *
- * - Registers `css` as a template format and processes `index.css` entries under the resolved assets `css` dir with PostCSS.
- * - Registers `inlinePostCSS` filter to inline arbitrary CSS by processing it with PostCSS.
- * - No module-specific options (inherits global Baseline verbose only).
- */
-/** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
-export default function assetsPostCSS(eleventyConfig) {
-	const { assetsDir } = resolveAssetsDir(
-		eleventyConfig.dir?.input || './',
-		eleventyConfig.dir?.output || './',
-		eleventyConfig.dir?.assets || 'assets'
-	);
-	const cssDir = `${assetsDir}css/`;
-
-	// Resolve user PostCSS config from the project root (cwd), not the Eleventy input dir.
-	const configRoot = process.cwd();
-
-	eleventyConfig.addTemplateFormats('css');
-
-	eleventyConfig.addExtension('css', {
-		outputFileExtension: 'css',
-		useLayouts: false,
-		compile: async function (_inputContent, inputPath) {
-			if (!inputPath.startsWith(cssDir) || path.basename(inputPath) !== 'index.css') {
-				return;
-			}
-
-			return async () => {
-				let plugins;
-				let options;
-
-				try {
-					// Prefer the consuming project's PostCSS config (postcss.config.* or package.json#postcss).
-					({ plugins, options } = await loadPostCSSConfig({}, configRoot));
-				} catch {
-					// If none is found, fall back to the bundled Baseline config to keep builds working.
-					({ plugins, ...options } = fallbackPostCSSConfig);
-				}
-
-				const result = await postcss(plugins).process(_inputContent, {
-					from: inputPath,
-					map: options?.map,
-					...options
-				});
-
-				return result.css;
-			};
-		}
-	});
-
-	// Filter to inline a bundled entry; supports callback style (Nunjucks/Liquid) and Promise return.
-	eleventyConfig.addAsyncFilter('inlinePostCSS', async function (cssFilePath, callback) {
-		const done = typeof callback === 'function' ? callback : null;
-		try {
-			const css = await inlinePostCSS(cssFilePath);
-			const html = `<style>${css}</style>`;
-			if (done) return done(null, html);
-			return html;
-		} catch {
-			// Keep behavior non-fatal: return a styled error comment instead of throwing.
-			const html = `<style>/* Error processing CSS */</style>`;
-			if (done) return done(null, html);
-			return html;
-		}
-	});
-}