mikser-io-render-liquid 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Almero Digital Marketing
+
+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,49 @@
+# mikser-io-render-liquid
+
+[LiquidJS](https://www.npmjs.com/package/liquidjs) renderer for [Mikser](https://github.com/almero-digital-marketing/mikser-io). Renders entities whose layout uses the `.liquid` template engine.
+
+## Install
+
+```bash
+npm install mikser-io-render-liquid
+```
+
+## Usage
+
+```js
+// mikser.config.js
+export default {
+  renderer: 'liquid',
+  'render-liquid': {
+    jsTruthy: true,
+    strictFilters: false
+  }
+}
+```
+
+The `render-liquid` config object is passed through to the `Liquid` constructor — see [LiquidJS options](https://liquidjs.com/api/interfaces/LiquidOptions.html). Defaults applied by the plugin:
+
+- `root: options.layoutsFolder`
+- `extname: '.liquid'`
+- `cache: !options.watch` (cached for one-shot builds, disabled in watch mode)
+
+## Runtime → Filters
+
+Every function exposed on the render runtime (by Mikser itself or by other `render-*` helper plugins) is auto-registered as a Liquid filter. So if you load `render-markdown`, this works in any template:
+
+```liquid
+{{ entity.meta.title }}
+{{ entity.meta.body | markdown }}
+{{ entity.meta.summary | removeMarkdown }}
+{{ '/blog/welcome' | href: 'en' }}
+```
+
+Includes resolve from the layouts folder:
+
+```liquid
+{% include 'partials/header' %}
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,37 @@
+import { Liquid } from 'liquidjs'
+import path from 'node:path'
+
+let engine
+
+export function load({ runtime, options, config }) {
+    if (!engine) {
+        engine = new Liquid({
+            root: options.layoutsFolder,
+            extname: '.liquid',
+            cache: !options.watch,
+            ...config,
+        })
+    }
+    runtime.liquid = (name, data) => engine.renderFile(name, data)
+}
+
+export async function render({ entity, options, runtime }) {
+    // Expose every function on runtime as a Liquid filter,
+    // so render-helper plugins (markdown, href, ...) keep working without per-plugin glue.
+    for (let key in runtime) {
+        if (typeof runtime[key] === 'function') {
+            engine.registerFilter(key, (input, ...args) => runtime[key](input, ...args))
+        }
+    }
+    const name = path.relative(options.layoutsFolder, entity.layout.uri).replace(/\.liquid$/, '')
+    try {
+        return await runtime.liquid(name, runtime)
+    } catch (err) {
+        // LiquidJS RenderError/ParseError carry a `token` with file/line/col.
+        const token = err?.token
+        err.layoutUri ??= token?.file || entity.layout.uri
+        if (token?.line && err.line == null) err.line = token.line
+        if (token?.col && err.column == null) err.column = token.col
+        throw err
+    }
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "mikser-io-render-liquid",
+  "version": "1.1.0",
+  "description": "",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/almero-digital-marketing/mikser-io-render-liquid.git"
+  },
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/almero-digital-marketing/mikser-io-render-liquid/issues"
+  },
+  "homepage": "https://github.com/almero-digital-marketing/mikser-io-render-liquid#readme",
+  "peerDependencies": {
+    "mikser-io": "^6.0.0"
+  },
+  "dependencies": {
+    "liquidjs": "^10.16.0"
+  }
+}