@anyblades/buildawesome-kit 1.3.0-alpha

package/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "starters"]
+	path = starters
+	url = https://github.com/anyblades/buildawesome-micro-starters.git

package/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "printWidth": 120
+}

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anton Staroverov 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# Eleventy *Bl*ades &nbsp;<img src="https://img.shields.io/npm/v/@anyblades/eleventy-blades?label=plugin&color=white"> <img src="https://img.shields.io/npm/v/@anyblades/eleventy-blades-base?label=base&color=white">
+
+<!--section:summary-->
+
+<h1><mark>Ultimate blade kit</mark> <small>for</small> 11ty / Build&nbsp;Awesome</h1>
+
+<big>Essential 11ty [filters](//11ty.blades.ninja/filters/), transforms, and other toggleable [features](//11ty.blades.ninja/features/) as a simple, configurable plugin. Reusable [npm scripts](//11ty.blades.ninja/scripts/) included.</big>
+
+<nav>
+  <a href="//11ty.blades.ninja/plugin/" role="button">Get started&nbsp;&nbsp;›</a>
+  <span hidden>•</span>
+  <a href="//11ty.blades.ninja/base/" role="button" class="outline">
+    Base <span hidden>package</span> <i class="fa-brands fa-eleventy"></i>&nbsp;&nbsp;›
+  </a>
+  <span hidden>•</span>
+  <a href="//11ty.blades.ninja/starters/" role="button" class="outline">Micro-starters&nbsp;&nbsp;🌱</a>
+</nav>
+
+<!--section:gh-only-->
+
+---
+
+## Quick start
+
+<!--section:install-->
+
+There are 3 ways to get started:
+
+### <mark>A.</mark> Plugin install
+
+Plugin gives you all the features and filters in one go without interfering with the rest of your 11ty config:
+
+```sh
+npm install @anyblades/eleventy-blades
+```
+
+Then `addPlugin` to your 11ty config:
+
+```js
+import eleventyBladesPlugin from "@anyblades/eleventy-blades";
+
+export default function (eleventyConfig) {
+  eleventyConfig.addPlugin(eleventyBladesPlugin);
+}
+```
+
+You can toggle features/filters like this:
+
+```js
+eleventyConfig.addPlugin(eleventyBladesPlugin, {
+  mdAutoRawTags: false,
+  filters: { attr_set: false },
+});
+```
+
+Live examples:
+
+- https://github.com/anyblades/eleventy-blades/tree/main/examples/plugin-usage
+- https://github.com/anyblades/eleventy-blades/tree/main/packages/eleventy-blades-base
+
+<!--section:install,install-starters-->
+
+---
+
+### <mark>B.</mark> Starter projects
+
+Eleventy *Bl*ades plugin and base package are included out-of-the-box with:
+
+`BA v4` [6-in-1 Starter](https://github.com/anyblades/buildawesome-starters)
+: Modern, lightweight Eleventy v4 multi-site starter showcasing Eleventy Blades Kit and Tailwind CLI for: [1] Tailwind CSS + Typography [2] Blades CSS [3] Bootstrap CSS [4] Pico CSS [5] Simple CSS [6] Liquid Templates.
+
+`11ty v4` [*S*ubtle](https://github.com/anyblades/subtle)
+: The most subtle Eleventy v4 micro-starter for content-first sites. Powered by Eleventy Blades Kit
+
+Built-in bare-minimum examples
+: https://github.com/anyblades/eleventy-blades/tree/main/examples
+
+<!--section:install-->
+
+---
+
+### <mark>C.</mark> Base package
+
+<!--section:install,install-base-->
+
+Base package bundles Eleventy *Bl*ades with other popular 11ty plugins, providing a ready-to-go reusable, zero-maintenance config:
+
+```sh
+npm install @anyblades/eleventy-blades-base
+
+# Link base templates:
+cd _includes/
+ln -s ../node_modules/@anyblades/blades/_includes/blades
+
+# Run Eleventy:
+eleventy --config=node_modules/@anyblades/eleventy-blades-base/eleventy.config.js
+```
+
+Live examples:
+
+- https://github.com/anyblades/buildawesome-starters
+- https://github.com/anyblades/subtle/tree/main/.11ty
+
+<div><hr></div>
+
+If you don't want to type `--config=...` every time, symlink it once:
+
+```sh
+ln -s node_modules/@anyblades/eleventy-blades-base/eleventy.config.js
+eleventy
+```
+
+Or save it in your `package.json` scripts:
+
+```json
+  "scripts": {
+    "build": "eleventy --config=node_modules/@anyblades/eleventy-blades-base/eleventy.config.js"
+  }
+```
+
+<div><hr></div>
+
+Alternatively, import it as a base config in your 11ty config:
+
+```js
+import baseConfig from "@anyblades/eleventy-blades-base";
+
+export default async function (eleventyConfig) {
+  await baseConfig(eleventyConfig);
+}
+```
+
+You can toggle features/filters like this:
+
+```js
+await baseConfig(eleventyConfig, {
+  plugins: {
+    "@anyblades/eleventy-blades": {
+      mdAutoRawTags: false,
+      filters: { attr_set: false },
+    },
+  },
+});
+```
+
+Live examples:
+
+- https://github.com/johnheenan/minform/blob/main/eleventy.config.js
+- https://github.com/hostfurl/minformhf/blob/main/eleventy.config.js
+
+<!--section:gh-only-->
+
+## Documentation
+
+<ul class="columns">
+  
+  <li>
+    <strong><a href="/plugin/">Get started</a></strong>
+    <ul><li><a href="https://11ty.blades.ninja/plugin/">Plugin</a></li>
+<li><a href="https://11ty.blades.ninja/base/">Base package</a></li>
+<li><a href="https://11ty.blades.ninja/scripts/">Useful scripts</a></li>
+<li><a href="https://11ty.blades.ninja/starters/">Starter projects</a></li></ul>
+  </li>
+  
+  <li>
+    <strong><a href="/features/">Features</a></strong>
+    <ul><li><a href="https://11ty.blades.ninja/features/">Overview</a></li>
+<li><a href="https://11ty.blades.ninja/features/site-globals/">Site globals</a></li>
+<li><a href="https://11ty.blades.ninja/features/link-favicons/">Automatic link favicons</a></li>
+<li><a href="https://11ty.blades.ninja/features/markdown-auto-raw/">Markdown auto-raw tags</a></li>
+<li><a href="https://11ty.blades.ninja/features/markdown-hidden-attrs/">Markdown hidden attrs</a></li>
+<li><a href="https://11ty.blades.ninja/features/markdown-newlines/">Markdown newlines</a></li></ul>
+  </li>
+  
+  <li>
+    <strong><a href="/templates/">Templates</a></strong>
+    <ul><li><a href="https://blades.ninja/html/starter/">HTML base ↗</a></li>
+<li><a href="https://blades.ninja/html/links/">Links ↗</a></li>
+<li><a href="https://blades.ninja/html/sitemap/">Sitemap ↗</a></li>
+<li><a href="https://11ty.blades.ninja/templates/">More</a></li></ul>
+  </li>
+  
+  <li>
+    <strong><a href="/filters/">Filters</a></strong>
+    <ul><li><a href="https://11ty.blades.ninja/filters/attr_concat/">attr_concat</a></li>
+<li><a href="https://11ty.blades.ninja/filters/attr_includes/">attr_includes</a></li>
+<li><a href="https://11ty.blades.ninja/filters/attr_set/">attr_set</a></li>
+<li><a href="https://11ty.blades.ninja/filters/date/">date</a></li>
+<li><a href="https://11ty.blades.ninja/filters/fetch/">fetch</a></li>
+<li><a href="https://11ty.blades.ninja/filters/if/">if</a></li>
+<li><a href="https://11ty.blades.ninja/filters/markdownify/">markdownify</a></li>
+<li><a href="https://11ty.blades.ninja/filters/merge/">merge</a></li>
+<li><a href="https://11ty.blades.ninja/filters/remove_tag/">remove_tag</a></li>
+<li><a href="https://11ty.blades.ninja/filters/section/">section</a></li>
+<li><a href="https://11ty.blades.ninja/filters/strip_tag/">strip_tag</a></li>
+<li><a href="https://11ty.blades.ninja/filters/unindent/">unindent</a></li></ul>
+  </li>
+  
+  <li>
+    <strong><a href="/awesome/">Awesome</a></strong>
+    
+  </li>
+  
+</ul>
+
+---
+
+<!--section:featured-->
+
+## <sup style>Featured by</sup><!--A-Z sites, then @users-->
+
+- [11ty.dev](https://www.11ty.dev/docs/starter/#:~:text=blades) [↗](https://www.11ty.dev/docs/plugins/community/#:~:text=blades)
+- [11tybundle.dev](https://11tybundle.dev/blog/11ty-bundle-88/#:~:text=blades)
+- [sveltiacms.app](https://sveltiacms.app/en/docs/frameworks/eleventy#:~:text=anyblades)
+- [@hamatti](https://hamatti.org/posts/markdown-content-split-to-sections-in-eleventy-and-nunjucks/#:~:text=section%20filter)
+- [@johnheenan](https://github.com/johnheenan/minform#css-and-performance)
+
+<!--{.markerless .columns}-->

package/eleventy.config.js

@@ -0,0 +1,141 @@
+//<!--section:code-->```js
+
+/* Plugins (core > official > contrib) */
+import { RenderPlugin } from "@awesome.me/buildawesome";
+import { feedPlugin } from "@11ty/eleventy-plugin-rss";
+import eleventyNavigationPlugin from "@11ty/eleventy-navigation";
+import kitPlugin from "@anyblades/buildawesome-kit-plugin";
+import pluginTOC from "@uncenter/eleventy-plugin-toc";
+import { siteData } from "@anyblades/buildawesome-kit-plugin/features/siteData.js";
+/* Libraries (A-Z) */
+import markdownIt from "markdown-it";
+import markdownItAnchor from "markdown-it-anchor";
+import markdownItAttrs from "markdown-it-attrs";
+import slugify from "@sindresorhus/slugify";
+import YAML from "yaml";
+/* System (A-Z) */
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * Eleventy Configuration
+ * @param {Object} eleventyConfig - The Eleventy configuration object
+ * @returns {Object} The Eleventy configuration object
+ */
+export default async function (eleventyConfig, pluginOptions = {}) {
+  /* Dirs */
+  const inputDir = eleventyConfig.directories.input;
+  const outputDir = eleventyConfig.directories.output;
+  const cwdIsDotEleventy = path.basename(process.cwd()) === ".11ty";
+  if (cwdIsDotEleventy) {
+    // Per https://www.11ty.dev/docs/config/#directory-for-includes
+    // Order matters, put this at the top of your configuration file.
+    // This is relative to your input directory!
+    eleventyConfig.setIncludesDirectory("./.11ty/_includes/");
+  }
+
+  /* Plugins */
+  eleventyConfig.addBundle("css", { bundleHtmlContentFromSelector: "style" }); // per https://www.11ty.dev/docs/plugins/bundle/#bundling-html-node-content
+  eleventyConfig.addTransform("inject-css-bundle", function (content) {
+    const isHtml = typeof this.page.outputPath === "string" && this.page.outputPath.endsWith(".html");
+    const css = isHtml && eleventyConfig.getFilter("getBundle").call(this, "css");
+    return css ? content.replace("</head>", `<style>${css}</style></head>`) : content;
+  });
+  eleventyConfig.addPlugin(RenderPlugin);
+  eleventyConfig.addPlugin(eleventyNavigationPlugin);
+  eleventyConfig.addPlugin(
+    kitPlugin,
+    pluginOptions.plugins?.["@anyblades/buildawesome-kit-plugin"] ?? { mdAutoRawTags: true },
+  );
+  eleventyConfig.addPlugin(pluginTOC, {
+    ignoredElements: [".header-anchor", "sub"],
+    ul: true,
+    wrapper: (toc) => `${toc}`,
+  });
+  // Feed plugin
+  eleventyConfig.addCollection("feed", (collectionApi) =>
+    collectionApi.getAll().filter((item) => item.data.date || item.data.revised),
+  );
+  eleventyConfig.addPlugin(feedPlugin, {
+    // per https://www.11ty.dev/docs/plugins/rss/#virtual-template
+    type: "atom", // or "rss", "json"
+    outputPath: "/feed.xml",
+    collection: {
+      name: "feed",
+      limit: 100, // 0 means no limit
+    },
+    templateData: {
+      eleventyComputed: {
+        metadata: (data) => {
+          return {
+            base: "https://example.com/", // sample/fallback value required by Feed plugin
+            ...siteData(data),
+          };
+        },
+      },
+    },
+  });
+
+  /* Libraries */
+  let md = markdownIt({
+    html: true,
+    linkify: true,
+  })
+    .use(markdownItAnchor, {
+      slugify: slugify, // @TODO: TRICKS
+      permalink: markdownItAnchor.permalink.ariaHidden(),
+    })
+    .use(markdownItAttrs);
+  await import("markdown-it-deflist")
+    .then(({ default: markdownItDeflist }) => {
+      md.use(markdownItDeflist);
+    })
+    .catch(() => {
+      /* optional – skip if not installed */
+    });
+  eleventyConfig.setLibrary("md", md);
+  //```<!--section:code,markdownify-->```js
+  eleventyConfig.addFilter("markdownify", (content) => md.render(String(content ?? "")));
+  //```<!--section:code-->```js
+
+  /* Data */
+  eleventyConfig.addDataExtension("yml,yaml", (contents) => YAML.parse(contents));
+  eleventyConfig.addGlobalData("layout", "default");
+  // Sitemap
+  eleventyConfig.addTemplate("sitemap.xml.njk", "", {
+    permalink: "/sitemap.xml",
+    layout: "blades/sitemap.xml.njk",
+    eleventyExcludeFromCollections: true,
+  });
+
+  /* Build */
+  eleventyConfig.addPassthroughCopy(
+    {
+      // From current working directory
+      _public: "./",
+      media: "./media/",
+      // Additionally from input dirs like `../` or `./site-1`
+      [`${inputDir}/_public/`]: "./",
+      [`${inputDir}/media/`]: "./media/",
+    },
+    { expand: true }, // This follows/resolves symbolic links
+  );
+
+  /* Internal */
+  // Jekyll templates compatibility
+  eleventyConfig.addFilter("relative_url", (content) => content); // dummy
+  eleventyConfig.setLiquidOptions({
+    dynamicPartials: false, // allows unquoted Jekyll-style includes
+    root: [
+      eleventyConfig.directories.includes,
+      fs.realpathSync(path.resolve("./node_modules/@anyblades/blades/_includes")), // for symlinks to work after https://github.com/harttle/liquidjs/pull/870
+    ],
+  });
+  // Dev tools
+  eleventyConfig.setChokidarConfig({ followSymlinks: true }); // follow symlinks in Chokidar used by 11ty to watch files
+  if (cwdIsDotEleventy) {
+    eleventyConfig.watchIgnores.add(`../.11ty/${outputDir}`); // !!! avoid circular watching
+    eleventyConfig.watchIgnores.add("../.11ty/node_modules/"); // avoid performance issues
+  }
+}
+//```

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@anyblades/buildawesome-kit",
+  "version": "1.3.0-alpha",
+  "type": "module",
+  "main": "./eleventy.config.js",
+  "dependencies": {
+    "@11ty/eleventy-navigation": "^1.0.5",
+    "@11ty/eleventy-plugin-rss": "^3.0.0",
+    "@anyblades/blades": "^2.4.6",
+    "@anyblades/buildawesome-kit-plugin": "^1.3.0-0",
+    "@uncenter/eleventy-plugin-toc": "^2.1.1",
+    "markdown-it": "^14.1.0",
+    "markdown-it-anchor": "^9.2.0",
+    "markdown-it-attrs": "^4.3.1",
+    "yaml": "^2.9.0"
+  },
+  "peerDependencies": {
+    "@11ty/eleventy": "^3.0.0 || ^4.0.0-0",
+    "@awesome.me/buildawesome": "^3.0.0 || ^4.0.0-0"
+  },
+  "peerDependenciesMeta": {
+    "@11ty/eleventy": {
+      "optional": true
+    },
+    "@awesome.me/buildawesome": {
+      "optional": true
+    }
+  },
+  "=== DEV ONLY": "===",
+  "workspaces": [
+    "plugin"
+  ],
+  "=== METADATA": "===",
+  "author": "Anton Staroverov",
+  "description": "A ready-to-go `eleventy.config.js` for popular 11ty plugins, bundled with npm scripts in one reusable, zero-maintenance package.",
+  "homepage": "https://build.blades.ninja/",
+  "keywords": [
+    "11ty",
+    "buildawesome",
+    "eleventy",
+    "config"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anyblades/buildawesome-kit.git"
+  },
+  "===": "==="
+}

package/plugin/features/autoLinkFavicons.js

@@ -0,0 +1,71 @@
+/*<!--section:docs-->
+
+`autoLinkFavicons` feature prepends a favicon image (from Google's favicon service) to external links whose text is a plain URL or contains only inline emphasis (`<em>`/`<strong>`) — skipping any link already decorated with an `↗` marker.
+
+For each qualifying link the link text is cleaned (protocol prefix and trailing slash stripped; domain portion removed when significant path text remains), then wrapped in the original `<a>` tag preceded by `<i><img src="https://www.google.com/s2/favicons?…"></i>`. Any HTML already present in the link text is wrapped in a `<span>` so the favicon image stays a direct child of `<a>`. Only `.html` output files are processed.
+
+> Compatible with: https://blades.ninja/css/link-icon/ <i class="faded">← this link is a live example!</i>
+
+<!--section:code-->```js */
+export function isExternalUrl(url) {
+  return /^https?:\/\//.test(url);
+}
+
+export function cleanLinkText(linkText) {
+  return linkText
+    .trim()
+    .replace(/^https?:\/\//, "")
+    .replace(/\/$/, "");
+}
+
+export function getExtraAttrs(attrs, defaults) {
+  return Object.entries(defaults)
+    .map(([key, value]) => {
+      const regex = new RegExp(`\\b${key}=`, "i");
+      return regex.test(attrs) ? "" : ` ${key}="${value}"`;
+    })
+    .join("");
+}
+
+export function buildFaviconLink(attrs, domain, text) {
+  const extraAttrs = getExtraAttrs(attrs, {
+    title: domain,
+    target: "_blank",
+    rel: "noopener noreferrer",
+  });
+  const wrappedText = /<[a-z]/i.test(text) ? `<span>${text}</span>` : text;
+  return `<a ${attrs}${extraAttrs}><i><img src="https://www.google.com/s2/favicons?domain=${domain}&sz=64"></i> ${wrappedText}</a>`;
+}
+
+export function transformLink(match, attrs, url, linkText) {
+  try {
+    const domain = new URL(url).hostname;
+
+    if (isExternalUrl(url) && !linkText.includes("↗")) {
+      const cleaned = cleanLinkText(linkText);
+      const stripped = cleaned.replace(domain, "");
+      const label = linkText.trim() === url && stripped.length > 2 ? stripped : cleaned;
+      return buildFaviconLink(attrs, domain, label);
+    }
+  } catch (e) {
+    // URL parsing failed — fall through and return original match
+  }
+  return match;
+}
+
+export function replaceLinksInHtml(content, transformer) {
+  return content.replace(
+    /<a\s+([^>]*href=["']([^"']+)["'][^>]*)>([^<]*(?:<\/?(?:em|strong|code)>[^<]*)*)<\/a>/gi,
+    transformer,
+  );
+}
+
+export default function (eleventyConfig) {
+  eleventyConfig.addTransform("autoLinkFavicons", function (content) {
+    if (this.page.outputPath && this.page.outputPath.endsWith(".html")) {
+      return replaceLinksInHtml(content, transformLink);
+    }
+    return content;
+  });
+}
+//```