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

package/core/helpers.js

@@ -1,127 +0,0 @@
-import path from 'node:path';
-import { TemplatePath } from '@11ty/eleventy-utils';
-
-/**
- * Helper function to add trailing slash to a path
- * @param {string} path
- * @returns {string}
- */
-export function addTrailingSlash(path) {
-	if (path.slice(-1) === '/') {
-		return path;
-	}
-	return path + '/';
-}
-
-/**
- * Resolves the assets directory path from config
- * Follows Eleventy's pattern: join inputDir + rawDir, then normalize and add trailing slash
- * @param {string} inputDir - The input directory (e.g., "./src/")
- * @param {string} rawDir - Raw directory value from config (e.g., "assets")
- * @returns {{assetsDir: string, assetsDirRelative: string}}
- */
-export function resolveAssetsDir(inputDir, outputDir, rawDir) {
-	// Join input/output with assets subdir and normalize
-	const joinedInput = TemplatePath.join(inputDir, rawDir || '');
-	const joinedOutput = TemplatePath.join(outputDir, rawDir || '');
-
-	const assetsDir = addTrailingSlash(TemplatePath.standardizeFilePath(joinedInput));
-	const assetsOutputDir = addTrailingSlash(TemplatePath.standardizeFilePath(joinedOutput));
-
-	return {
-		assetsDir,
-		assetsOutputDir
-	};
-}
-
-/**
- * Builds glob patterns for fast-glob (absolute paths)
- * @param {string[]} patterns - User-provided patterns
- * @param {string} assetsDir - Assets directory (relative, e.g., "./src/assets/")
- * @returns {string[]} Absolute glob patterns
- */
-export function buildGlobPatterns(patterns, assetsDir) {
-	const assetsDirAbsolute = TemplatePath.absolutePath(TemplatePath.stripLeadingDotSlash(assetsDir));
-
-	return patterns.map((pattern) => {
-		const normalized = TemplatePath.standardizeFilePath(pattern);
-		return normalized.startsWith('/') || path.isAbsolute(normalized)
-			? normalized
-			: TemplatePath.join(assetsDirAbsolute, normalized);
-	});
-}
-
-/**
- * Extracts file metadata from a file path
- * @param {string} filePath - Normalized file path
- * @returns {{basename: string, fileSlug: string, inputFileExtension: string}}
- */
-export function extractFileMetadata(filePath) {
-	const ext = path.extname(filePath); // Returns extension with dot (e.g., ".css") or ""
-	const inputFileExtension = ext && ext.length > 0 ? ext.slice(1) : '';
-	const basename = TemplatePath.getLastPathSegment(filePath, false);
-	const fileSlug = ext ? basename.slice(0, -ext.length) : basename;
-
-	return { basename, fileSlug, inputFileExtension };
-}
-
-/**
- * Creates a collection item from a relative file path
- * @param {string} inputPath - Relative path from project root (e.g., "./src/assets/css/index.css")
- * @param {string} inputDir - Input directory (e.g., "./src/")
- * @param {string} outputDir - Output directory (e.g., "./dist/")
- * @param {string} assetsDirRelative - Assets directory relative to input (e.g., "assets")
- * @param {string} passthroughOutput - Output path for passthrough
- * @param {boolean} passthrough - Whether passthrough is enabled
- * @returns {object} Collection item
- */
-export function createCollectionItem(
-	inputPath,
-	inputDir,
-	outputDir,
-	assetsDirRelative,
-	passthroughOutput,
-	passthrough
-) {
-	const { basename, fileSlug, inputFileExtension } = extractFileMetadata(inputPath);
-
-	// Get path relative to input directory
-	// e.g., inputPath = "./src/assets/css/index.css", inputDir = "./src/"
-	// relToInput = "assets/css/index.css"
-	const relToInput = TemplatePath.stripLeadingSubPath(inputPath, TemplatePath.addLeadingDotSlash(inputDir));
-
-	// outputPath: prepend output directory (with leading ./)
-	// e.g., relToInput = "assets/css/index.css", outputDir = "./dist/"
-	// outputPath = "./dist/assets/css/index.css"
-	const outputPath = TemplatePath.addLeadingDotSlash(
-		TemplatePath.normalize(TemplatePath.join(TemplatePath.addLeadingDotSlash(outputDir), relToInput))
-	);
-
-	// relToAssets: path relative to assets directory for URL generation
-	// e.g., inputPath = "./src/assets/css/index.css", assetsDirRelative = "assets"
-	// relToAssets = "css/index.css"
-	const assetsDirPath = TemplatePath.addLeadingDotSlash(TemplatePath.join(inputDir, assetsDirRelative));
-	const relToAssets = TemplatePath.stripLeadingSubPath(inputPath, assetsDirPath);
-
-	const url = passthrough ? TemplatePath.join(passthroughOutput, relToAssets).replace(/\/$/, '') : undefined;
-
-	// filePathStem: path relative to input without extension, with leading slash
-	// e.g., relToInput = "assets/css/index.css"
-	// filePathStem = "/assets/css/index"
-	const filePathStem =
-		'/' +
-		(inputFileExtension
-			? relToInput.slice(0, -inputFileExtension.length - 1) // Remove extension and dot
-			: relToInput);
-
-	return {
-		inputPath,
-		outputPath,
-		basename,
-		fileSlug,
-		inputFileExtension,
-		filePathStem,
-		dir: TemplatePath.getDirFromFilePath(inputPath),
-		url
-	};
-}

package/core/modules.js

@@ -1,22 +0,0 @@
-// Eleventy plugins
-import { EleventyHtmlBasePlugin } from '@11ty/eleventy';
-
-// Custom plugins
-import multilangCore from '../modules/multilang-core/plugins/multilang-core.js';
-import navigatorCore from '../modules/navigator-core/plugins/navigator-core.js';
-import assetsCore from '../modules/assets-core/plugins/assets-core.js';
-import assetsPostCSS from '../modules/assets-postcss/plugins/assets-postcss.js';
-import assetsESBuild from '../modules/assets-esbuild/plugins/assets-esbuild.js';
-import headCore from '../modules/head-core/plugins/head-core.js';
-import sitemapCore from '../modules/sitemap-core/plugins/sitemap-core.js';
-
-export default {
-	EleventyHtmlBasePlugin,
-	multilangCore,
-	navigatorCore,
-	assetsCore,
-	assetsPostCSS,
-	assetsESBuild,
-	headCore,
-	sitemapCore
-};

package/core/shortcodes.js

@@ -1,3 +0,0 @@
-import { imageShortcode } from './shortcodes/image.js';
-
-export default { imageShortcode };

package/eleventy.config.js

@@ -1,157 +0,0 @@
-import 'dotenv/config';
-import globals from './core/globals.js';
-import debug from './core/debug.js';
-import filters from './core/filters.js';
-import modules from './core/modules.js';
-import shortcodes from './core/shortcodes.js';
-import { eleventyImageOnRequestDuringServePlugin } from '@11ty/eleventy-img';
-
-import { createRequire } from 'node:module';
-const __require = createRequire(import.meta.url);
-
-const { name, version } = __require('./package.json');
-
-/**
- * Eleventy Plugin Baseline.
- *
- * @typedef {Object} BaselineOptions
- * @property {boolean} [verbose=false] Enable extra logging from the plugin.
- * @property {boolean} [enableNavigatorTemplate=false] Register navigator template/routes.
- * @property {boolean} [enableSitemapTemplate=true] Register sitemap template/routes.
- * @property {boolean} [multilingual=false] Enable multilang core (requires defaultLanguage + languages).
- * @property {string} [defaultLanguage] IETF/BCP47 default language code (used when multilingual=true).
- * @property {Record<string, unknown>} [languages={}] Language definition map (shape not enforced; only presence/keys checked).
- * @property {Object} [assetsESBuild] Options forwarded to assets-esbuild (minify/target).
- *
- * @param {BaselineOptions} [options={}] Custom options for the plugin.
- * @returns {(eleventyConfig: import("@11ty/eleventy").UserConfig) => Promise<void>}
- */
-export default function baseline(options = {}) {
-	/** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
-	const plugin = async function (eleventyConfig) {
-		try {
-			// Emit a warning message if the application is not using Eleventy 3.0 or newer (including prereleases).
-			eleventyConfig.versionCheck('>=3.0');
-		} catch (e) {
-			console.log(`[eleventy-plugin-baseline] WARN Eleventy plugin compatibility: ${e.message}`);
-		}
-
-		const hasImageTransformPlugin = eleventyConfig.hasPlugin('eleventyImageTransformPlugin');
-
-		const userOptions = {
-			version,
-			name,
-			verbose: options.verbose ?? false,
-			hasImageTransformPlugin,
-			enableNavigatorTemplate: options.enableNavigatorTemplate ?? false,
-			enableSitemapTemplate: options.enableSitemapTemplate ?? true,
-			filterAllCollection: options.filterAllCollection ?? true,
-			assets: {
-				esbuild: options.assetsESBuild ?? { minify: true, target: 'es2020' }
-			},
-			multilingual: options.multilingual ?? false,
-			...options
-		};
-
-		// Core functions.
-
-		// Normalize languages to an object map; if missing or invalid, use null.
-		const normalizedLanguages = Array.isArray(userOptions.languages)
-			? Object.fromEntries(
-					userOptions.languages
-						.filter((lang) => typeof lang === 'string' && lang.trim())
-						.map((lang) => [lang.trim(), {}])
-				)
-			: userOptions.languages && typeof userOptions.languages === 'object'
-				? userOptions.languages
-				: null;
-
-		if (userOptions.verbose && Array.isArray(userOptions.languages)) {
-			const normalizedCount = normalizedLanguages ? Object.keys(normalizedLanguages).length : 0;
-			if (normalizedCount !== userOptions.languages.length) {
-				console.warn('[baseline] Some languages entries were invalid and were dropped.');
-			}
-		}
-
-		userOptions.languages = normalizedLanguages;
-		const languages = normalizedLanguages;
-		const hasLanguages = languages && Object.keys(languages).length > 0;
-		const isMultilingual = userOptions.multilingual === true && userOptions.defaultLanguage && hasLanguages;
-
-		eleventyConfig.addGlobalData('_baseline', userOptions);
-		globals(eleventyConfig);
-		eleventyConfig.addPassthroughCopy({ './src/static': '/' });
-
-		// Prevents double-registering the preprocessor, user config wins.
-		if (!eleventyConfig.preprocessors.drafts) {
-			eleventyConfig.addPreprocessor('drafts', '*', (data) => {
-				if (data.draft && process.env.ELEVENTY_RUN_MODE === 'build') {
-					return false;
-				}
-			});
-		}
-
-		if (isMultilingual) {
-			eleventyConfig.addPlugin(modules.multilangCore, {
-				defaultLanguage: userOptions.defaultLanguage,
-				languages
-			});
-		}
-
-		// Modules.
-		eleventyConfig.addPlugin(modules.EleventyHtmlBasePlugin, {
-			baseHref: process.env.URL || eleventyConfig.pathPrefix
-		});
-		eleventyConfig.addPlugin(modules.assetsCore);
-		eleventyConfig.addPlugin(modules.assetsPostCSS);
-		eleventyConfig.addPlugin(modules.assetsESBuild, userOptions.assets.esbuild);
-
-		if (userOptions.filterAllCollection) {
-			// Override the default collection behavior. Adding js as template format collects 11tydata.js files.
-			eleventyConfig.addCollection('all', (collectionApi) =>
-				collectionApi.getAll().filter((item) => !item.inputPath.endsWith('11tydata.js'))
-			);
-		}
-
-		eleventyConfig.addPlugin(modules.headCore);
-		eleventyConfig.addPlugin(modules.sitemapCore, {
-			enableSitemapTemplate: userOptions.enableSitemapTemplate,
-			multilingual: isMultilingual,
-			languages
-		});
-
-		// Filters — Module filters might move to their respective module.
-		eleventyConfig.addFilter('markdownify', filters.markdownFilter);
-		eleventyConfig.addFilter('relatedPosts', filters.relatedPostsFilter);
-		eleventyConfig.addFilter('isString', filters.isStringFilter);
-
-		// Shortcodes.
-		eleventyConfig.addShortcode('image', shortcodes.imageShortcode);
-
-		// Add the dev server middleware for images.
-		eleventyConfig.addPlugin(eleventyImageOnRequestDuringServePlugin);
-
-		// Debug filters and navigators.
-		eleventyConfig.addFilter('_inspect', debug.inspect);
-		eleventyConfig.addFilter('_json', debug.json);
-		eleventyConfig.addFilter('_keys', debug.keys);
-		eleventyConfig.addPlugin(modules.navigatorCore, { enableNavigatorTemplate: userOptions.enableNavigatorTemplate });
-	};
-
-	// Set plugin name so `eleventyConfig.hasPlugin()` can detect it.
-	Object.defineProperty(plugin, 'name', { value: `${name}` });
-	return plugin;
-}
-
-export const config = {
-	dir: {
-		input: 'src',
-		output: 'dist',
-		data: '_data',
-		includes: '_includes',
-		assets: 'assets'
-	},
-	htmlTemplateEngine: 'njk',
-	markdownTemplateEngine: 'njk',
-	templateFormats: ['html', 'njk', 'md']
-};

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

@@ -1,84 +0,0 @@
-import { TemplatePath } from '@11ty/eleventy-utils';
-import { addTrailingSlash, resolveAssetsDir } from '../../../core/helpers.js';
-import { warnIfVerbose, getVerbose } from '../../../core/logging.js';
-
-const syncCacheFromDirectories = (cache, dirs, rawDir) => {
-	const inputDir = TemplatePath.addLeadingDotSlash(dirs.input || './');
-	const outputDir = TemplatePath.addLeadingDotSlash(dirs.output || './');
-	const { assetsDir, assetsOutputDir } = resolveAssetsDir(inputDir, outputDir, rawDir);
-
-	cache.input = addTrailingSlash(inputDir);
-	cache.output = addTrailingSlash(outputDir);
-	cache.assetsInput = assetsDir;
-	cache.assetsOutput = assetsOutputDir;
-};
-
-const ensureCache = (cache, eleventyConfig, rawDir, verbose) => {
-	if (cache.assetsInput) return;
-	syncCacheFromDirectories(cache, eleventyConfig.dir || {}, rawDir);
-	warnIfVerbose(verbose, 'Fallback directory resolution');
-};
-
-/**
- * eleventy-plugin-assets-core
- *
- * Resolve assets input/output directories, register a virtual
- * `directories.assets`, expose the resolved paths via global data, and add
- * a watch target under the resolved assets input directory.
- *
- * Options:
- *  - verbose  (boolean, default global baseline verbose): enable verbose logs.
- */
-/** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
-export default function assetsCore(eleventyConfig, options = {}) {
-	const verbose = getVerbose(eleventyConfig) || options.verbose || false;
-	const userKey = 'assets';
-
-	// Extract raw directory value from config (can be done early)
-	const rawDir = eleventyConfig.dir?.[userKey] || userKey;
-
-	// Cache object (raw values; normalized later by syncCacheFromDirectories)
-	const cache = {
-		input: eleventyConfig.dir?.input || null,
-		output: eleventyConfig.dir?.output || null,
-		assetsInput: eleventyConfig.dir?.assets ?? userKey ?? null,
-		assetsOutput: null
-	};
-
-	syncCacheFromDirectories(cache, eleventyConfig.dir || {}, rawDir);
-
-	eleventyConfig.on('eleventy.directories', (directories) => {
-		syncCacheFromDirectories(cache, directories, rawDir);
-
-		// Add a virtual directory key only if not already defined/configurable.
-		const existing = Object.getOwnPropertyDescriptor(eleventyConfig.directories, userKey);
-		if (existing && existing.configurable === false) {
-			warnIfVerbose(verbose, `directories[${userKey}] already defined; skipping`);
-			return;
-		}
-
-		Object.defineProperty(eleventyConfig.directories, userKey, {
-			get() {
-				return cache.assetsInput;
-			},
-			enumerable: true,
-			configurable: false
-		});
-	});
-
-	eleventyConfig.addGlobalData('_baseline.assets', () => {
-		ensureCache(cache, eleventyConfig, rawDir, verbose);
-		// Merge with existing _baseline.assets (e.g., esbuild config)
-		const existing = eleventyConfig.globalData?._baseline?.assets || {};
-		return {
-			input: cache.assetsInput,
-			output: cache.assetsOutput,
-			...existing
-		};
-	});
-
-	// Watch target — use resolved assets input dir.
-	ensureCache(cache, eleventyConfig, rawDir, verbose);
-	const watchGlob = TemplatePath.join(cache.assetsInput, '**/*.{css,js,svg,png,jpeg,jpg,webp,gif,avif}');
-	eleventyConfig.addWatchTarget(watchGlob);
-}

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

@@ -1,24 +0,0 @@
-import * as esbuild from 'esbuild';
-
-const defaultOptions = { minify: true, target: 'es2020' };
-
-export default async function inlineESbuild(jsFilePath, options = {}) {
-	const userOptions = { ...defaultOptions, ...options };
-
-	try {
-		let result = await esbuild.build({
-			entryPoints: [jsFilePath],
-			bundle: true,
-			minify: userOptions.minify,
-			target: userOptions.target,
-			write: false
-		});
-
-		// Return raw JS; markup wrapping is handled by the plugin registration.
-		return result.outputFiles[0].text;
-	} catch (error) {
-		console.error(error);
-		// Surface a safe JS comment so the caller can decide how to wrap it.
-		return '/* Error processing 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;
-		}
-	});
-}