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

package/README.md

@@ -1,6 +1,14 @@
-# Eleventy Plugin Baseline
+# Eleventy Baseline
 
-An experimental Swiss army knife toolkit for Eleventy. Bundles handy helpers for assets, head/meta, navigation, sitemaps, debugging, and more — without turning into a full theme.
+_An experimental Swiss army knife for Eleventy._
+
+Eleventy Baseline is a lightweight toolkit built around a simple question:
+
+> What if Eleventy had a minimal, optional layer of conventions — just enough to eliminate repetition, but not enough to feel restrictive?
+
+It explores what a "core" for Eleventy could look like without becoming a framework or theme — small, practical tools rather than sweeping abstractions. If you've ever started a new Eleventy project and found yourself copy-pasting the same asset pipeline, the same head template, the same image shortcode for the third time, this is for you.
+
+This is a practical, evolving baseline. Things might shift, break, or get renamed as the project evolves.
 
 ## Install
 
@@ -16,6 +24,8 @@ For a fresh project (install Eleventy and eleventy-img too):
 npm install @11ty/eleventy @11ty/eleventy-img @apleasantview/eleventy-plugin-baseline
 ```
 
+Requires Eleventy 3.x and Node >=20.
+
 ## Usage
 
 In your Eleventy config (ESM):
@@ -34,13 +44,32 @@ export default function (eleventyConfig) {
 export const config = baselineConfig;
 ```
 
-Requires Eleventy 3.x.
+## What's included
+
+When the plugin loads, you get core filters, Nunjucks globals, debugging utilities, and an image shortcode (via eleventy-img) out of the box. On top of that, the plugin is organized into opt-in modules — take what you need:
+
+| Module | What it does |
+|---|---|
+| `assets-core` | Shared foundation for the asset pipeline |
+| `assets-esbuild` | JS bundling via esbuild, with an inline injection filter for critical scripts |
+| `assets-postcss` | CSS processing via PostCSS + cssnano, with an inline injection filter for critical styles |
+| `head-core` | Drop `<baseline-head>` into your template and get sensible meta, canonical, og:image, and basic SEO defaults — processed by PostHTML at build time |
+| `multilang-core` | Directory-based multilingual support: per-language collections, hreflang, sitemaps, and language normalization |
+| `navigator-core` | Navigation tree helpers and a `_navigator` Nunjucks global |
+| `sitemap-core` | XML sitemap generation with draft-page support |
 
 ## Docs
 
-Documentation tracks latest builds:  
+Full documentation — tutorials, how-to guides, and reference — lives at:
 [https://eleventy-plugin-baseline.netlify.app/](https://eleventy-plugin-baseline.netlify.app/)
 
+## Contributing
+
+Opinions, issues, and pull requests are welcome. If something doesn't work as documented, or
+you've found a pattern that fits the spirit of the project,
+[open an issue](https://github.com/apleasantview/eleventy-plugin-baseline/issues) and let's talk.
+You can also find me on [Mastodon](https://mastodon.social/@crisverstraeten).
+
 ## License
 
 MIT. See `LICENSE`.

package/core/shortcodes/image.js

@@ -1,8 +1,8 @@
 import path from 'node:path';
 import Image from '@11ty/eleventy-img';
 
-const DEFAULT_WIDTHS = [320, 640, 960, 1280];
-const DEFAULT_FORMATS = ['avif', 'webp', 'jpeg'];
+const DEFAULT_WIDTHS = [320, 640, 960, 1280, 1920, 'auto'];
+const DEFAULT_FORMATS = ['avif', 'webp'];
 const DEFAULT_SIZES = '(max-width: 768px) 100vw, 768px';
 
 function pickRenditions(metadata) {
@@ -26,7 +26,7 @@ function pickRenditions(metadata) {
  * @param {Array<number|string>} [options.widths=DEFAULT_WIDTHS]   Widths passed to eleventy-img.
  * @param {string} [options.sizes=DEFAULT_SIZES]        Sizes attribute used on sources.
  * @param {string[]} [options.formats=DEFAULT_FORMATS]  Output formats (order matters).
- * @param {string} [options.outputDir]                  Output directory for generated assets (defaults to `./dist/media/` or `./<dir.output>/media/` when set).
+ * @param {string} [options.outputDir]                  Output directory for generated assets.
  * @param {string} [options.urlPath="/media/"]          Public URL base for generated assets.
  * @param {Object} [options.attrs={}]                   Extra attributes applied to <img>; `class` merges with imageClass.
  * @param {string} [options.style]                      Inline style applied to <img> (alias for attrs.style).
@@ -66,18 +66,34 @@ export async function imageShortcode(options = {}) {
 	const isRemote = /^https?:\/\//i.test(src);
 	const resolvedSrc = !isRemote && inputDir ? path.join(inputDir, src.replace(/^\//, '')) : src;
 
-	const metadata = await Image(resolvedSrc, {
-		transformOnRequest: process.env.ELEVENTY_RUN_MODE === 'serve',
-		widths: [...widths],
-		formats: [...formats],
-		outputDir,
-		urlPath,
-		filenameFormat(id, srcPath, width, format) {
-			const extension = path.extname(srcPath);
-			const name = path.basename(srcPath, extension);
-			return `${name}-${width}w.${format}`;
-		}
-	});
+	let metadata;
+	try {
+		metadata = await Image(resolvedSrc, {
+			transformOnRequest: process.env.ELEVENTY_RUN_MODE === 'serve',
+			widths: [...widths],
+			formats: [...formats],
+			outputDir,
+			urlPath,
+			filenameFormat(id, srcPath, width, format) {
+				const extension = path.extname(srcPath);
+				const name = path.basename(srcPath, extension);
+				return `${name}-${width}w.${format}`;
+			}
+		});
+	} catch (error) {
+		console.warn(`imageShortcode: transformOnRequest failed for ${src}.\n > ${error?.message || error}`);
+		metadata = await Image(resolvedSrc, {
+			widths: [...widths],
+			formats: [...formats],
+			outputDir,
+			urlPath,
+			filenameFormat(id, srcPath, width, format) {
+				const extension = path.extname(srcPath);
+				const name = path.basename(srcPath, extension);
+				return `${name}-${width}w.${format}`;
+			}
+		});
+	}
 
 	const { lowsrc, highsrc } = pickRenditions(metadata);
 	if (!lowsrc || !highsrc) {

package/modules/assets-postcss/fallback/postcss.config.js

@@ -8,7 +8,7 @@ const plugins = [
 	postcssImportExtGlob,
 	postcssImport,
 	postcssPresetEnv({
-		browsers: ['> 0.2% and not dead'],
+		browsers: ['baseline widely available with downstream'],
 		preserve: true
 	})
 ];

package/package.json

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