Merge pull request #37 from noelforte/changeset-release/main

[ci] release

CHANGELOG.md

@@ -1,5 +1,47 @@
 # eleventy-plugin-vento
 
+## 3.1.0
+
+### Minor Changes
+
+- 7e6ba68: Separate `shortcodes` and `pairedShortcodes` into seperate object namespaces. Prior to this version, Eleventy shortcodes and paired shortcodes were merged into a single object keyed as `_11ty.functions` which allowed for naming collisions between shortcodes and their paired counterparts.
+- b8f0a03: Adds new dependency on `debug` package, to help out with testing and getting more verbose logs. The following `DEBUG` namespaces are implemented:
+
+  - `Eleventy:Vento:Setup` - Logs initial setup of the plugin, loading features, pre-page compile setup steps (like changing `page` and `eleventy` objects)
+  - `Eleventy:Vento:Cache` - Logs updates to Vento's own internal cache, which is used in tandem with Eleventy's cache.
+  - `Eleventy:Vento:Template` - Logs rendered templates and other template related actions
+
+  Because it is a child of the `Eleventy:` namespace, the following command will include output from this plugin as well:
+
+  ```sh
+  $ DEBUG='Eleventy:*' npx @11ty/eleventy
+  ```
+
+  Alternatively, use a finer grained namespace to see only the output generated by `eleventy-plugin-vento`.
+
+  ```sh
+  $ DEBUG='Eleventy:Vento:*' npx @11ty/eleventy
+  ```
+
+  ```sh
+  $ DEBUG='Eleventy:Vento:Template' npx @11ty/eleventy
+  ```
+
+  See [the docs on 11ty.dev](https://www.11ty.dev/docs/debugging/) as well as the [debug package README](https://github.com/debug-js/debug/blob/master/README.md) for more information.
+
+- ec02a76: Further caching improvements to e8111234 and e46ce6ea. Eleventy now defers all template caching to Vento.
+
+  Templates are now compiled directly instead of using Vento's `.runString` method which reduces overhead and enables this plugin to manage the Vento cache in a more direct manner.
+
+- 494b184: Permalink compilation optimizations:
+
+  - Permalinks now short-circuit to raw strings if they don't contain Vento template syntax, avoiding compilation entirely.
+  - Permalinks are now assigned (fake) pathnames in Vento's cache. If you change template content but don't change a dynamic permalink in development, Vento will reuse the compiled permalink template. Note that **any** modifications to a template file will **always** cause it to be recompiled (see 19c352fa) — this improvement just optimizes recompiling dynamic permalinks that haven't changed.
+
+### Patch Changes
+
+- 4b4b387: Entries for changed files are now deleted from Vento's cache when running the Eleventy Dev server. (fixes #38)
+
 ## 3.0.3-next.0
 
 ### Patch Changes

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "eleventy-plugin-vento",
-	"version": "3.0.3-next.0",
+	"version": "3.1.0",
 	"description": "Adds support for the Vento templating language to Eleventy.",
 	"type": "module",
 	"engines": {