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

package/modules/head-core/drivers/posthtml-head-elements.js

@@ -1,127 +0,0 @@
-// Based on posthtml-head-elements (MIT License).
-// Original: https://github.com/posthtml/posthtml-head-elements
-// Adapted for Baseline head-core.
-
-import { createRequire } from 'node:module';
-
-const require = createRequire(import.meta.url);
-
-function nonString(type, attrsArr) {
-	return attrsArr.map(function (attrs) {
-		return { tag: type, attrs: attrs };
-	});
-}
-
-function nonArray(type, content) {
-	return { tag: type, content: [content] };
-}
-
-function findElmType(type, objectData) {
-	const elementType = {
-		meta: function () {
-			if (Array.isArray(objectData)) {
-				return nonString(type, objectData);
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a meta element');
-			}
-		},
-		title: function () {
-			if (typeof objectData === 'string') {
-				return nonArray('title', objectData);
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a title element');
-			}
-		},
-		link: function () {
-			if (Array.isArray(objectData)) {
-				return nonString(type, objectData);
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a link element');
-			}
-		},
-		linkCanonical: function () {
-			if (Array.isArray(objectData)) {
-				return nonString('link', objectData);
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a linkCanonical element');
-			}
-		},
-		script: function () {
-			if (Array.isArray(objectData)) {
-				return objectData.map(function (entry) {
-					const { content, ...attrs } = entry || {};
-					return content !== undefined ? { tag: 'script', attrs, content: [content] } : { tag: 'script', attrs };
-				});
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a script element');
-			}
-		},
-		style: function () {
-			if (Array.isArray(objectData)) {
-				return objectData.map(function (entry) {
-					const { content, ...attrs } = entry || {};
-					return content !== undefined ? { tag: 'style', attrs, content: [content] } : { tag: 'style', attrs };
-				});
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a style element');
-			}
-		},
-		base: function () {
-			if (Array.isArray(objectData)) {
-				return nonString(type, objectData);
-			} else {
-				console.warn('posthtml-head-elements: Please use the correct syntax for a base element');
-			}
-		},
-		default: function () {
-			console.warn('posthtml-head-elements: Please make sure the HTML head type is correct');
-		}
-	};
-
-	if (type.indexOf('_') !== -1) {
-		type = type.slice(0, type.indexOf('_'));
-	}
-
-	return elementType[type]() || elementType['default']();
-}
-
-function buildNewTree(headElements, EOL) {
-	const newHeadElements = [];
-
-	Object.keys(headElements).forEach(function (value) {
-		newHeadElements.push(findElmType(value, headElements[value]));
-	});
-
-	function cnct(arr) {
-		return Array.prototype.concat.apply([], arr);
-	}
-
-	return cnct(
-		cnct(newHeadElements).map(function (elem) {
-			return [elem, EOL];
-		})
-	);
-}
-
-export default function (options) {
-	options = options || {};
-	options.headElementsTag = options.headElementsTag || 'posthtml-head-elements';
-
-	if (!options.headElements) {
-		console.warn(
-			"posthtml-head-elements: Don't forget to add a link to the JSON file containing the head elements to insert"
-		);
-	}
-	const jsonOne = typeof options.headElements !== 'string' ? options.headElements : require(options.headElements);
-
-	return function posthtmlHeadElements(tree) {
-		tree.match({ tag: options.headElementsTag }, function () {
-			return {
-				tag: false, // delete this node, safe content
-				content: buildNewTree(jsonOne, options.EOL || '\n')
-			};
-		});
-
-		return tree;
-	};
-}

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

@@ -1,75 +0,0 @@
-import headElements from '../drivers/posthtml-head-elements.js';
-import { getVerbose, logIfVerbose } from '../../../core/logging.js';
-import { buildHead } from '../utils/head-utils.js';
-
-/**
- * eleventy-plugin-head-core
- *
- * Manages the <head> for every page. Merges site-level defaults, page-level
- * overrides, and computed values (canonical URL, open graph, structured data)
- * into a single head spec, then injects the result into HTML via a PostHTML
- * transform. Pages control their head through a `head` data key.
- *
- * Depends on: core/logging, head-core/utils/head-utils, head-core/drivers/posthtml-head-elements.
- * No cross-module dependencies.
- */
-/** @param {import("@11ty/eleventy").UserConfig} eleventyConfig */
-export default function headCore(eleventyConfig, options = {}) {
-	const verbose = getVerbose(eleventyConfig) || options.verbose || false;
-
-	// Internal options — not part of the public API.
-	const userKey = options.dirKey || 'head';
-	const headElementsTag = options.headElementsTag || 'baseline-head';
-	const eol = options.EOL || '\n';
-	const pathPrefix = options.pathPrefix ?? eleventyConfig?.pathPrefix ?? '';
-	const siteUrl = options.siteUrl;
-
-	// Cache the content map so canonical URLs can resolve inputPath → URL.
-	// Updated each build when Eleventy emits the contentMap event.
-	let cachedContentMap = {};
-	eleventyConfig.on('eleventy.contentMap', ({ inputPathToUrl, urlToInputPath }) => {
-		cachedContentMap = { inputPathToUrl, urlToInputPath };
-	});
-
-	// Computed global data: build the head spec for every page through the
-	// data cascade. Templates access the result via `page.head`.
-	eleventyConfig.addGlobalData('eleventyComputed.page.head', () => {
-		return (data) =>
-			buildHead(data, {
-				userKey,
-				siteUrl,
-				pathPrefix,
-				contentMap: cachedContentMap,
-				pageUrlOverride: data?.page?.url,
-				verbose
-			});
-	});
-
-	// HTML transform: inject the head spec into the document <head> using
-	// PostHTML. Replaces the <baseline-head> placeholder tag with real elements.
-	// Falls back to building the spec from context if page.head isn't available.
-	eleventyConfig.htmlTransformer.addPosthtmlPlugin('html', function (context) {
-		logIfVerbose(verbose, 'head-core: injecting head elements for', context?.page?.inputPath || context?.outputPath);
-
-		const headElementsSpec =
-			context?.page?.head ||
-			buildHead(context, {
-				userKey,
-				siteUrl,
-				pathPrefix,
-				contentMap: cachedContentMap,
-				pageUrlOverride: context?.page?.url,
-				verbose
-			});
-
-		const plugin = headElements({
-			headElements: headElementsSpec,
-			headElementsTag,
-			EOL: eol
-		});
-
-		return async function asyncHead(tree) {
-			return plugin(tree);
-		};
-	});
-}

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

@@ -1,249 +0,0 @@
-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 = '') => {
-	const normalized = TemplatePath.normalizeUrlPath('/', pathPrefix);
-	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;
-	const prefix = normalizePathPrefix(pathPrefix);
-	const joined = TemplatePath.normalizeUrlPath(prefix || '/', 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(
-		{},
-		{
-			title,
-			meta: [
-				{ charset: 'UTF-8' },
-				{ name: 'viewport', content: 'width=device-width, initial-scale=1.0' },
-				{ name: 'description', content: description },
-				{ name: 'robots', content: noindex ? 'noindex, nofollow' : 'index, follow' }
-			],
-			link: [],
-			script: [],
-			style: [],
-			hreflang: [],
-			openGraph: {
-				'og:title': title,
-				'og:description': description,
-				'og:type': 'website',
-				'og:url': url || '',
-				'og:image': ''
-			},
-			twitter: {
-				'twitter:card': 'summary_large_image',
-				'twitter:title': title,
-				'twitter:description': description,
-				'twitter:image': ''
-			},
-			miscMeta: [],
-			structuredData: null
-		},
-		user
-	);
-};
-
-/**
- * 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);
-	if (explicit) {
-		if (!siteUrl && verbose) {
-			console.warn('[baseline] site.url is missing; canonical will be relative.');
-		}
-		return absoluteUrl(siteUrl, pathPrefix, explicit);
-	}
-
-	const url = pick(pageUrlOverride, page?.url, page?.inputPath && contentMap?.inputPathToUrl?.[page.inputPath]?.[0]);
-	if (!url) return undefined;
-
-	if (!siteUrl && verbose) {
-		console.warn('[baseline] site.url is missing; canonical will be relative.');
-	}
-
-	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 = [];
-	for (let i = arr.length - 1; i >= 0; i--) {
-		const m = arr[i];
-		const key = m.charset
-			? 'charset'
-			: m.name
-				? `name:${m.name}`
-				: m.property
-					? `prop:${m.property}`
-					: m['http-equiv']
-						? `http:${m['http-equiv']}`
-						: null;
-		if (!key || seen.has(key)) continue;
-		seen.add(key);
-		out.push(m);
-	}
-	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 = [];
-	for (let i = links.length - 1; i >= 0; i--) {
-		const l = links[i];
-		const key = l.rel && l.href ? `rel:${l.rel}|${l.href}` : null;
-		if (!key || seen.has(key)) continue;
-		seen.add(key);
-		out.push(l);
-	}
-	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) => {
-	const baseMeta = dedupeMeta([...(head.meta || []), ...(head.miscMeta || [])]);
-
-	const socialMeta = dedupeMeta([
-		...(head.openGraph
-			? Object.entries(head.openGraph)
-					.filter(([, v]) => v)
-					.map(([k, v]) => ({ property: k, content: v }))
-			: []),
-		...(head.twitter
-			? Object.entries(head.twitter)
-					.filter(([, v]) => v)
-					.map(([k, v]) => ({ name: k, content: v }))
-			: [])
-	]);
-
-	const style = [...(head.style || [])];
-
-	const linkCanonical = canonical ? [{ rel: 'canonical', href: canonical }] : [];
-	const link = dedupeLink([...(head.link || []), ...(head.hreflang || [])].filter(Boolean));
-
-	const script = [...(head.script || [])];
-	if (head.structuredData) {
-		script.unshift({
-			type: 'application/ld+json',
-			content: JSON.stringify(head.structuredData)
-		});
-	}
-
-	// Key order matters for posthtml-head-elements.
-	return {
-		meta: baseMeta,
-		title: head.title || '',
-		linkCanonical,
-		style,
-		link,
-		script,
-		meta_social: socialMeta
-	};
-};
-
-/**
- * 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 || {};
-	const user = userKey ? data[userKey] || {} : {};
-	const page = data.page || {};
-	const resolvedSiteUrl =
-		siteUrl || site.url || process.env.URL || process.env.DEPLOY_URL || process.env.DEPLOY_PRIME_URL;
-
-	const siteTitle = site.title || '';
-	const pageTitle = pick(data.title, user.title, site.title, '');
-	const title =
-		siteTitle && pageTitle && siteTitle !== pageTitle ? `${pageTitle} | ${siteTitle}` : pageTitle || siteTitle || '';
-
-	const description = pick(data.description, user.description, site.tagline, '');
-	const noindex = pick(data.noindex, page.noindex, user.noindex, site.noindex, false);
-
-	const canonical = resolveCanonical(
-		{ canonical: absoluteUrl(resolvedSiteUrl, pathPrefix, user.canonical) },
-		page,
-		contentMap,
-		{ ...env, siteUrl: resolvedSiteUrl, verbose: env.verbose }
-	);
-	const merged = mergeBaseHead(site, user, page, title, description, noindex, canonical);
-	return flattenHead(merged, canonical);
-};
-
-export { pick, resolveCanonical, flattenHead, buildHead, absoluteUrl };

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

@@ -1,118 +0,0 @@
-import { I18nPlugin } from '@11ty/eleventy';
-import { DeepCopy } from '@11ty/eleventy-utils';
-import i18nTranslationsFor from '../filters/i18n-translations-for.js';
-import i18nTranslationIn from '../filters/i18n-translation-in.js';
-import i18nDefaultTranslation from '../filters/i18n-default-translation.js';
-
-/**
- * eleventy-plugin-multilang-core
- *
- * 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
- */
-export default function multilangCore(eleventyConfig, options = {}) {
-	const userOptions = {
-		defaultLanguage: 'en',
-		languages: [],
-		verbose: false,
-		...options
-	};
-
-	// Register Eleventy's built-in I18nPlugin for locale-aware URL resolution.
-	eleventyConfig.addPlugin(I18nPlugin, {
-		defaultLanguage: userOptions.defaultLanguage,
-		errorMode: 'allow-fallback'
-	});
-
-	// 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)
-			? userOptions.languages.map(normalizeLang)
-			: 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);
-			const translationKey = data.translationKey;
-			const isDefaultLang = lang === normalizeLang(userOptions.defaultLanguage);
-
-			return {
-				translationKey,
-				lang,
-				isDefaultLang
-			};
-		};
-	});
-
-	// 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 = [];
-
-		for (const page of collection.getAll()) {
-			const translationKey = page.data.translationKey;
-			if (!translationKey) continue;
-
-			const lang = page.data.lang || page.data.language || userOptions.defaultLanguage;
-			if (!lang) continue;
-
-			if (allowedLanguages.size && !allowedLanguages.has(lang)) {
-				if (userOptions.verbose) {
-					console.warn(`[baseline:multilang-core] Unknown lang "${lang}" in ${page.inputPath}`);
-				}
-				continue;
-			}
-
-			const locale = { locale: { translationKey, lang, isDefaultLang: lang === userOptions.defaultLanguage } };
-			const safeCopy = DeepCopy(page, locale);
-			list.push(safeCopy);
-
-			if (!map[translationKey]) map[translationKey] = {};
-			map[translationKey][lang] = {
-				title: page.data.title,
-				url: page.url,
-				lang,
-				isDefaultLang: lang === userOptions.defaultLanguage,
-				data: page.data
-			};
-		}
-
-		return { map, list };
-	};
-
-	// --- Collections ---
-
-	// Map form: translationsMap[translationKey][lang] → page metadata.
-	eleventyConfig.addCollection('translationsMap', (collection) => {
-		return buildTranslations(collection).map;
-	});
-
-	// Flat list: all translatable pages with locale data attached.
-	eleventyConfig.addCollection('translations', (collection) => {
-		return buildTranslations(collection).list;
-	});
-
-	// --- 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

@@ -1,57 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-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;
-	const [enableNavigatorTemplate, inspectorDepth] = Array.isArray(raw) ? [raw[0], raw[1]] : [raw, undefined];
-
-	const userOptions = {
-		...options,
-		enableNavigatorTemplate: enableNavigatorTemplate ?? false,
-		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;
-	});
-	eleventyConfig.addNunjucksGlobal('_context', function () {
-		return this.ctx;
-	});
-
-	// --- Virtual debug template ---
-	if (userOptions.enableNavigatorTemplate) {
-		// 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, {
-			permalink: '/navigator-core.html',
-			title: 'Navigator Core',
-			description: '',
-			layout: null,
-			eleventyExcludeFromCollections: true,
-			inspectorDepth: userOptions.inspectorDepth
-		});
-	}
-}