eleventy-plugin-vento 3.2.0 → 3.4.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # eleventy-plugin-vento
 
+## 3.4.0
+
+### Minor Changes
+
+- 8c6b8a2: Update `ventojs` to v1.12.11
+
+## 3.3.0
+
+### Minor Changes
+
+- 387eb48: ⚠️ DEPRECATION NOTICE: Ignore tag `{{! ... }}` syntax is now deprecated and will be removed in 4.0.0.
+
+  This change comes in favor of using string literals to "pass through" tags without rendering them, like so:
+
+  ```diff
+  - {{! if condition }}
+  + {{ '{{ if condition }}' }}
+      do something
+  - {{! /if }}
+  - {{ '{{ /if }}' }}
+  ```
+
+  While more verbose, this change ensures that there isn't any ambiguity between a tag that needs ignoring and JS negation expressions:
+
+  ```hbs
+  <!-- These are functionally equivalent and can lead to collisions in rendering functionality -->
+
+  {{! conditionStatementToIgnore }}
+
+  {{ !conditionStatementToIgnore }}
+  ```
+
+  If an improved syntax for deferred rendering scenarios ever makes its way to Vento, it will be made available in this plugin.
+
 ## 3.2.0
 
 ### Minor Changes

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "eleventy-plugin-vento",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Adds support for the Vento templating language to Eleventy.",
   "type": "module",
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   },
   "exports": {
     ".": {
@@ -33,17 +33,17 @@
   ],
   "dependencies": {
     "debug": "4.3.7",
-    "ventojs": "1.12.10"
+    "ventojs": "1.12.11"
   },
   "devDependencies": {
     "@11ty/eleventy": "3.0.0",
     "@changesets/cli": "2.27.9",
-    "@eslint/js": "9.13.0",
-    "eslint": "9.13.0",
+    "@eslint/js": "9.14.0",
+    "eslint": "9.14.0",
     "eslint-config-flat-gitignore": "0.3.0",
     "eslint-config-prettier": "9.1.0",
     "eslint-plugin-unicorn": "56.0.0",
-    "globals": "15.11.0",
+    "globals": "15.12.0",
     "vitest": "2.1.4"
   },
   "prettier": {

package/readme.md

@@ -136,7 +136,7 @@ For paired shortcodes, the syntax is the same, just add a closing tag. Paired sh
 
 If you'd prefer to set shortcodes yourself (via a plugin or other method) or prevent Eleventy from loading shortcodes into Vento, set `shortcodes: false` and/or `pairedShortcodes: false` in the plugin options.
 
-> [!CAUTION]
+> [!IMPORTANT]
 > While it's straightforward to load filters via a Vento plugin that appends filters to the filters object as `env.filters.[filter_name]()`, creating custom tags in Vento is more involved. It's highly advised to keep these two options enabled unless you know what you're doing.
 
 ### Relevant Documentation
@@ -201,6 +201,9 @@ Vento: See [Auto Trim Plugin](https://vento.js.org/plugins/auto-trim/).
 
 ## Ignoring Tags
 
+> [!WARNING]
+> This feature is now deprecated as of version 3.3.0. I added it primarily for my own use case, however it can cause more issues than it solves (conflict with `!` negation syntax in JS, ambiguity between ignoring a tag and negating an expression in a template). See the 3.3.0 release notes for more information.
+
 Exclusive to this plugin is the ability to skip processing a vento tag entirely and instead preserve the tag in the markup. This could be useful if you're doing some hybrid rendering and would like to defer certain tags from being processed until load time, so they can be rendered on the server.
 
 This feature is enabled through use of the `enableIgnoreTag` plugin option.

package/src/index.js

@@ -58,6 +58,14 @@ export function VentoPlugin(eleventyConfig, userOptions) {
 
 	DEBUG.setup('Merged default and user config: %O', options);
 
+	if (options.ignoreTag) {
+		console.error(
+			'[eleventy-plugin-vento] DEPRECATION NOTICE:',
+			'Plugin was called with `ignoreTag` option, which has been deprecated.',
+			'For more information, see: https://github.com/noelforte/eleventy-plugin-vento/blob/main/readme.md#ignoring-tags'
+		);
+	}
+
 	// Get list of filters, shortcodes and paired shortcodes
 	const filters = eleventyConfig.getFilters();
 	DEBUG.setup('Reading filters from Eleventy: %o', filters);