poops 1.5.0 → 1.5.1

package/README.md

@@ -910,7 +910,7 @@ All filters are available in both engines. The only syntax difference is how arg
 
 - `jsonify` — serializes a value to JSON. Usage: `{{ myObject | jsonify }}`
 
-- `markdown` — renders a markdown string to HTML with GitHub-style emoji shortcodes (e.g. `:rocket:` → 🚀). Usage: `{{ "**bold** :rocket:" | markdown }}`
+- `markdown` — renders a markdown string to HTML with GitHub Flavored Markdown extras: emoji shortcodes (e.g. `:rocket:` → 🚀), alert callouts (`> [!NOTE]`, `[!TIP]`, `[!IMPORTANT]`, `[!WARNING]`, `[!CAUTION]`, `[!INFO]`) and footnotes (`[^1]`). Code fences are syntax-highlighted and headings get slug `id`s plus permalink anchors. Usage: `{{ "**bold** :rocket:" | markdown }}`
 
 - `date` — formats a date string. Uses [dayjs](https://day.js.org/) format tokens. A default format can be set via the `timeDateFormat` config option.
   - Nunjucks: `{{ "2024-01-15" | date("MMMM D, YYYY") }}`

package/lib/markup/engines/liquid.js

@@ -27,7 +27,11 @@ export default class LiquidEngine {
     this.engine = new Liquid({
       root: roots,
       extname: '.liquid',
-      cache: false,
+      // Parsed-template cache: without it every {% render %}/{% include %}
+      // re-resolves (realpath per root) and re-parses the partial on every
+      // page — dominates build time on partial-heavy sites. Cleared per
+      // compile (clearCache) so watch-mode edits are picked up.
+      cache: true,
       dynamicPartials: true,
       strictFilters: false,
       strictVariables: false,
@@ -106,6 +110,10 @@ export default class LiquidEngine {
     delete this.globals[key]
   }
 
+  clearCache() {
+    if (this.engine.options.cache) this.engine.options.cache.clear()
+  }
+
   async render(templateName, context) {
     let source
     const frontMatterResult = parseFrontMatter(templateName)

package/lib/markup/engines/nunjucks.js

@@ -30,6 +30,7 @@ class RelativeLoader extends nunjucks.Loader {
     }
     if (!fs.existsSync(fullPath)) {
       log({ tag: 'markup', error: true, text: 'Template not found:', link: name })
+      // noCache so a template created mid-watch is found on the next compile
       return { src: '', path: fullPath, noCache: true }
     }
 
@@ -53,7 +54,10 @@ class RelativeLoader extends nunjucks.Loader {
       source = `{% extends '${frontMatter.layout}.html' %}\n{% block content %}\n${source}\n{% endblock %}`
     }
 
-    return { src: source, path: fullPath, noCache: true }
+    // Cached: getSource does glob resolution + front matter + markdown per
+    // call, so re-running it per include per page dominates builds. Cleared
+    // per compile (clearCache) so watch-mode edits are picked up.
+    return { src: source, path: fullPath, noCache: false }
   }
 
   resolve(from, to) {
@@ -67,10 +71,15 @@ export default class NunjucksEngine {
 
     this.env = new nunjucks.Environment(
       new RelativeLoader(templatesDir, includePaths),
-      { autoescape, watch: false, noCache: true }
+      { autoescape, watch: false }
     )
   }
 
+  clearCache() {
+    // nunjucks keeps compiled templates on each loader's cache object
+    for (const loader of this.env.loaders) loader.cache = {}
+  }
+
   get fileExtension() { return '.njk' }
   get indexableExtensions() { return new Set(['.html', '.md', '.njk']) }
   get markupExtensions() { return 'html|xml|rss|atom|json|njk|md' }

package/lib/markups.js

@@ -375,6 +375,9 @@ export default class Markups {
       throw err
     } finally {
       clearFrontMatterCache()
+      // Engine template caches live for one compile: fast within a build,
+      // watch-mode edits always picked up on the next one
+      if (typeof this.engine.clearCache === 'function') this.engine.clearCache()
     }
   }
 
@@ -426,6 +429,7 @@ export default class Markups {
       throw err
     } finally {
       clearFrontMatterCache()
+      if (typeof this.engine.clearCache === 'function') this.engine.clearCache()
     }
   }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "poops",
   "description": "Straightforward, no-bullshit bundler for the web.",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "license": "MIT",
   "type": "module",
   "main": "poops.js",