@anyblades/eleventy-blades 0.28.0-beta.3 → 0.29.0-alpha

package/README.md

@@ -1,45 +1,57 @@
-## <sub>Build Awesome /</sub><br> Eleventy blades <sup>![](https://img.shields.io/github/v/release/anyblades/eleventy-blades?label=&color=black)</sup>
-
 <!--section:summary-->
 
-Ultimate blade kit for 11ty (Build Awesome).
-
-<!--section:docs-->
-
-## Documentation
-
-<!--prettier-ignore-->
-- [Filters](              https://blades.ninja/build-awesome-11ty/filters/)
-  - [attr_concat](        https://blades.ninja/build-awesome-11ty/filters/#attr-concat),
-    [attr_includes](      https://blades.ninja/build-awesome-11ty/filters/#attr-includes),
-    [attr_set](           https://blades.ninja/build-awesome-11ty/filters/#attr-set)
-  - [date](               https://blades.ninja/build-awesome-11ty/filters/#date)
-  - [fetch](              https://blades.ninja/build-awesome-11ty/filters/#fetch) <!--{data-marker=🥷}-->
-  - [if](                 https://blades.ninja/build-awesome-11ty/filters/#if)
-  - [markdownify](        https://blades.ninja/build-awesome-11ty/filters/#markdownify)
-  - [merge](              https://blades.ninja/build-awesome-11ty/filters/#merge)
-  - [remove_tag](         https://blades.ninja/build-awesome-11ty/filters/#remove-tag),
-    [strip_tag](          https://blades.ninja/build-awesome-11ty/filters/#strip-tag)
-  - [section](            https://blades.ninja/build-awesome-11ty/filters/#section) <!--{data-marker=🥷}-->
-  - [unindent](           https://blades.ninja/build-awesome-11ty/filters/#unindent)
-- [Processors](           https://blades.ninja/build-awesome-11ty/processors/)
-  - [Auto link favicons]( https://blades.ninja/build-awesome-11ty/processors/#auto-link-favicons) <!--{data-marker=🥷}-->
-  - [Auto-raw tags](      https://blades.ninja/build-awesome-11ty/processors/#md-auto-raw)
-  - [Auto newlines-to-br](https://blades.ninja/build-awesome-11ty/processors/#md-auto-br)
-  - [Hidden markdown attrs<i>&nbsp;🆕</i>](https://blades.ninja/build-awesome-11ty/processors/#md-hidden-attrs) <!--{data-marker=🥷}-->
-- [Power tools](          https://blades.ninja/build-awesome-11ty/tools/)
-  - [Base config file](   https://blades.ninja/build-awesome-11ty/tools/#base-config) <!--{data-marker=🥷}-->
-  - [Base npm scripts](   https://blades.ninja/build-awesome-11ty/tools/#base-scripts) <!--{data-marker=🥷}-->
-  - [Data helpers](       https://blades.ninja/build-awesome-11ty/tools/#data-helpers)
-  - [Blades starters](    https://blades.ninja/build-awesome-11ty/tools/#starters) <!--{data-marker=🥷}-->
+# Eleventy 🥷 *Bl*ades
 
-<!--{.unlist .columns}-->
+<big>Ultimate blade kit for 11ty (Build Awesome).</big>
+
+![](https://img.shields.io/github/v/release/anyblades/eleventy-blades?label=&color=darkslategray&style=for-the-badge&include_prereleases)
+[![](https://img.shields.io/badge/Code-gainsboro?logo=github&logoColor=black&style=for-the-badge)](https://github.com/anyblades/eleventy-blades)
+[![](https://img.shields.io/github/stars/anyblades/eleventy-blades?label=Star&labelColor=gainsboro&color=silver&style=for-the-badge)](https://github.com/anyblades/eleventy-blades)
+
+<!--section:gh-only-->
+
+## [Documentation ↗](https://blades.ninja/build-awesome-11ty/)
+
+### [Filters](https://blades.ninja/build-awesome-11ty/filters/)
+
+<!-- ToC from https://blades.ninja/build-awesome-11ty/#filters -->
+<ul class="columns"><li><a href="https://blades.ninja/build-awesome-11ty/filters/#attr-concat" tabindex="-1">attr_concat</a></li><p></p>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#attr-includes" tabindex="-1">attr_includes</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#attr-set" tabindex="-1">attr_set</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#date" tabindex="-1">date</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#fetch" tabindex="-1">fetch</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#if" tabindex="-1">if</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#markdownify" tabindex="-1">markdownify</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#merge" tabindex="-1">merge</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#remove-tag" tabindex="-1">remove_tag</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#section" tabindex="-1">section</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#strip-tag" tabindex="-1">strip_tag</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#unindent" tabindex="-1">unindent</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/filters/#install" tabindex="-1">Install</a></li></ul>
+
+### [Processors](https://blades.ninja/build-awesome-11ty/processors/)
+
+<!-- ToC from https://blades.ninja/build-awesome-11ty/#processors -->
+<ul class="columns"><li><a href="https://blades.ninja/build-awesome-11ty/processors/#auto-link-favicons" tabindex="-1">autoLinkFavicons postprocessor (transformer)</a></li><p></p>
+<li><a href="https://blades.ninja/build-awesome-11ty/processors/#md-auto-raw" tabindex="-1">mdAutoRawTags preprocessor</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/processors/#md-auto-br" tabindex="-1">mdAutoNl2br converter</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/processors/#md-hidden-attrs" tabindex="-1">Hidden Markdown attributes using HTML comments</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/processors/#install" tabindex="-1">Install</a></li></ul>
+
+### [Power tools](https://blades.ninja/build-awesome-11ty/tools/)
+
+<!-- ToC from https://blades.ninja/build-awesome-11ty/#tools -->
+<ul class="columns"><li><a href="https://blades.ninja/build-awesome-11ty/tools/#starters" tabindex="-1">Modern starters</a></li><p></p>
+<li><a href="https://blades.ninja/build-awesome-11ty/tools/#base-config" tabindex="-1">Base eleventy.config.js</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/tools/#base-scripts" tabindex="-1">Base 11ty npm scripts via npm workspace</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/tools/#data-helpers" tabindex="-1">Data helpers</a></li>
+<li><a href="https://blades.ninja/build-awesome-11ty/tools/#more" tabindex="-1">More</a><ul><li><a href="https://blades.ninja/build-awesome-11ty/tools/#find-and-kill-11ty-processes" tabindex="-1">Find and kill 11ty processes</a></li></ul></li></ul>
 
 ---
 
-## Install
+<!--section:install-->
 
-<!--section:docs,install-->
+## Install
 
 ```sh
 npm install @anyblades/eleventy-blades
@@ -47,7 +59,7 @@ npm install @anyblades/eleventy-blades
 
 Then choose one of the following options:
 
-<mark>A. All-in</mark> managed by Eleventy Blades:
+###### <mark>A. All-in</mark> managed by Eleventy Blades:
 
 Consider symlinking entire `eleventy.config.js` as a set-and-forget zero-config zero-maintenance solution:
 
@@ -62,7 +74,7 @@ Living examples:
 - https://github.com/anyblades/build-awesome-starter
 - https://github.com/anyblades/bladeswitch
 
-<mark>B. Base config</mark> by Eleventy Blades with your additions/overrides in `eleventy.config.js`:
+###### <mark>B. Base config</mark> by Eleventy Blades with overrides in `eleventy.config.js`:
 
 ```js
 import baseConfig from "@anyblades/eleventy-blades/base-config";
@@ -75,9 +87,9 @@ export default function (eleventyConfig) {
 }
 ```
 
-Living example: https://github.com/hostfurl/minformhf/blob/main/eleventy.config.js
+Living example: https://github.com/johnheenan/minform/blob/main/eleventy.config.js
 
-<mark>C. Plug-in</mark> Eleventy Blades in your existing `eleventy.config.js`:
+###### <mark>C. Plug-in</mark> Eleventy Blades in existing `eleventy.config.js`:
 
 ```js
 import eleventyBladesPlugin from "@anyblades/eleventy-blades";
@@ -93,7 +105,7 @@ export default function (eleventyConfig) {
 }
 ```
 
-<mark>D. Individual imports</mark> from Eleventy Blades in your `eleventy.config.js`:
+###### <mark>D. Individual imports</mark> from Eleventy Blades in `eleventy.config.js`:
 
 ```js
 import { siteData, mdAutoRawTags, mdAutoNl2br, autoLinkFavicons, attrSetFilter, attrConcatFilter, ... } from "@anyblades/eleventy-blades";
@@ -109,25 +121,23 @@ export default function (eleventyConfig) {
 }
 ```
 
-<div><hr></div>
-
-Or use a <mark>fully preconfigured template</mark> as an alternative option:
-
-<nav>
-
-[🥷 Build Awesome Starter ↗ &nbsp;<small style="white-space: nowrap">11ty + Tailwind + Typography + Blades</small>](https://github.com/anyblades/build-awesome-starter)<!--{role=button .outline}-->
-
-[🥷 Bladeswitch Starter ↗ &nbsp;<small style="white-space: nowrap">11ty + Pico + Blades</small>](https://github.com/anyblades/bladeswitch)<!--{role=button .outline}-->
+###### <mark>E. Included with</mark>
 
-</nav>
+- https://github.com/anyblades/build-awesome-starter
+- https://github.com/anyblades/bladeswitch starter
+- https://github.com/johnheenan/minform starter
+- https://github.com/hostfurl/minformhf starter
 
-<!--section:docs-->
+<!--section:featured-->
 
 ---
 
-Featured by:
+## <sup>Featured by</sup><!--A-Z-->
 
 - https://11tybundle.dev/blog/11ty-bundle-83/
+- https://11tybundle.dev/blog/11ty-bundle-88/
 - https://11tybundle.dev/categories/getting-started/
-- https://hamatti.org/posts/markdown-content-split-to-sections-in-eleventy-and-nunjucks/#:~:text=anydigital
 - https://github.com/anydigital/awesome-11ty-build-awesome
+- https://hamatti.org/posts/markdown-content-split-to-sections-in-eleventy-and-nunjucks/#:~:text=anydigital
+
+<!--{.unlist .columns}-->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anyblades/eleventy-blades",
-  "version": "0.28.0-beta.3",
+  "version": "0.29.0-alpha",
   "description": "A collection of helpful utilities and filters for Eleventy (11ty)",
   "type": "module",
   "main": "./src/index.js",

package/src/do/package.json

@@ -2,14 +2,11 @@
   "name": "@anyblades/eleventy-blades-do",
   "private": true,
   "scripts": {
-    "build": "npm run tw && npm run 11ty -- $ELTY_OPTIONS",
-    "start": "npm run 11ty -- $ELTY_OPTIONS --serve --incremental & npm run tw -- --watch",
-    "prerestart": "npm run 11ty:clean",
+    "start": "npm run 11ty -- $ELTY_OPTIONS --serve --incremental & npm run tw -- $TW_OPTIONS --watch",
     "stage": "npm run 11ty:clean; npm run build && serve ../_site",
+    "build": "npm run tw -- $TW_OPTIONS && npm run 11ty -- $ELTY_OPTIONS",
     "11ty": "cd ../ && NODE_OPTIONS='--preserve-symlinks' eleventy",
     "11ty:clean": "rm -r ../_site",
-    "11ty:debug": "DEBUG=* npm run 11ty --",
-    "tw": "cd ../ && tailwindcss -i ./_styles/styles.css -o ./_public/styles.css",
-    "tw:debug": "DEBUG=* npm run tw --"
+    "tw": "cd ../ && tailwindcss"
   }
 }

package/src/eleventy.config.js

@@ -63,7 +63,8 @@ export default function (eleventyConfig) {
   eleventyConfig.setLiquidOptions({
     dynamicPartials: false, // allows unquoted Jekyll-style includes
     root: [
-      inputDir + "_includes", // default
+      eleventyConfig.directories.includes,
+      inputDir + "../_includes", // for shared multisite includes
       fs.realpathSync(path.resolve("./node_modules/@anyblades/blades/_includes")), // for symlinks to work after https://github.com/harttle/liquidjs/pull/870
     ],
   });
@@ -94,9 +95,9 @@ export default function (eleventyConfig) {
   });
   if (pluginTOC) {
     eleventyConfig.addPlugin(pluginTOC, {
-      ignoredElements: ["sub", "[data-is-anchor]"],
+      ignoredElements: [".header-anchor", "sub"],
       ul: true,
-      wrapper: (toc) => `<div data-is-toc>${toc}</div>`,
+      wrapper: (toc) => `${toc}`,
     });
   }
   // https://www.11ty.dev/docs/plugins/rss/#virtual-template
@@ -127,10 +128,7 @@ export default function (eleventyConfig) {
   if (markdownItAnchor) {
     md = md.use(markdownItAnchor, {
       slugify: slugify, // @TODO: TRICKS
-      permalink: markdownItAnchor.permalink.ariaHidden({
-        class: null,
-        renderAttrs: () => ({ "data-is-anchor": true }),
-      }),
+      permalink: markdownItAnchor.permalink.ariaHidden(),
     });
   }
   if (markdownItAttrs) md = md.use(markdownItAttrs);

package/src/filters/attr_concat.js

@@ -80,13 +80,13 @@ A filter that concatenates values to an attribute array, returning a new object
 - Logs an error if the existing attribute is not an array
 - `TBC:` Supports nested attributes (e.g., `data.tags`)
 
-#### Example: Add tags to a post object in `.njk`:
+##### Example: Add tags to a post object in `.njk`:
 
 ```jinja2
 {% set enhancedPost = post | attr_concat('tags', ['featured', 'popular']) %}
 ```
 
-#### `PRO` Example: Add scripts and styles to the `site` object in `.liquid`:
+##### `PRO` Example: Add scripts and styles to the `site` object in `.liquid`:
 
 ```liquid
 {% capture _ %}[

package/src/filters/attr_includes.js

@@ -53,7 +53,7 @@ A filter that filters a list of items by checking if an attribute array includes
 
 **Why use this?** When working with Eleventy collections, you often need to filter items based on tags or other array attributes in front matter. The `attr_includes` filter provides a flexible way to filter by any array attribute, with support for nested properties using dot notation.
 
-#### Example: Get all posts that include `#javascript` tag
+##### Example: Get all posts that include `#javascript` tag
 
 ```jinja2 {data-caption="in .njk:"}
 {% set js_posts = collections.all | attr_includes('data.tags', '#javascript') %}

package/src/filters/attr_set.js

@@ -33,7 +33,7 @@ export function attrSetFilter(eleventyConfig) {
 
 A filter that creates a new object with an overridden attribute value. This is useful for modifying data objects in templates without mutating the original. Or even constructing an object from scratch.
 
-#### Example: How to pass object(s) as argument(s) to a filter in `.liquid`?
+##### Example: How to pass object(s) as argument(s) to a filter in `.liquid`?
 
 ```liquid {data-caption="trick for '| renderContent' filter"}
 {% assign _ctx = null | attr_set: 'collections', collections %}

package/src/filters/remove_tag.js

@@ -60,7 +60,7 @@ A filter that removes a specified HTML element from provided HTML content. It re
 
 **Security note:** While this filter can help sanitize HTML content, it should not be relied upon as the sole security measure. For critical security requirements, use a dedicated HTML sanitization library on the server side before content reaches your templates.
 
-#### Example: Remove all script tags from content <!-- @TODO: better examples -->
+##### Example: Remove all script tags from content <!-- @TODO: better examples -->
 
 ```jinja2
 {% set cleanContent = htmlContent | remove_tag('script') %}

package/src/filters/strip_tag.js

@@ -57,7 +57,7 @@ A filter that strips a specified HTML element from content while keeping its inn
 - Case-insensitive matching
 - Non-destructive: Returns a new string, leaves the original unchanged
 
-#### Example: Unwrap a wrapping `<div>` from content
+##### Example: Unwrap a wrapping `<div>` from content
 
 ```jinja2
 {% set unwrapped = htmlContent | strip_tag('div') %}

package/src/processors/markdown.js

@@ -47,7 +47,7 @@ export function transformNl2br(content) {
 }
 /*```
 
-### Hidden Markdown attributes using HTML comments 🆕 <sub>`<!--{...}-—>` trick via `mdAutoUncommentAttrs` converter</sub> {#md-hidden-attrs}
+### Hidden Markdown attributes using HTML comments <sub>`<!--{...}-—>` trick via `mdAutoUncommentAttrs` converter</sub> {#md-hidden-attrs}
 
 This function amends the markdown library to automatically expand
 HTML-comment-wrapped attribute blocks `<!—-{...}-->` to their raw form