@rse/nunjucks-cli 2.0.1 → 2.2.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 ChangeLog
 =========
 
+2.2.0 (2025-12-26)
+------------------
+
+- IMPROVEMENT: finally fix SEA packaging
+- IMPROVEMENT: provide Docker container publishing
+- CLEANUP: cleanup distribution archive packaging
+
+2.1.0 (2025-12-26)
+------------------
+
+- REFACTOR: change option -e/--extension to option -p/--plugin
+- IMPROVEMENT: add new option -e for loading custom .env files
+- IMPROVEMENT: add new option -E for loading standard .env files
+
 2.0.0 (2025-12-21)
 ------------------
 

package/Dockerfile

@@ -3,15 +3,19 @@
 ##
 
 #   build arguments (early)
-ARG         IMAGE_PREFIX=docker.io/engelschall/
+ARG         IMAGE_PREFIX=ghcr.io/rse/
 ARG         IMAGE_NAME=nunjucks-cli
-ARG         IMAGE_VERSION=2.0.0
-ARG         IMAGE_RELEASE=20251221
+ARG         IMAGE_VERSION=2.1.0
+ARG         IMAGE_RELEASE=20251226
 ARG         IMAGE_ALIAS=latest
 
 #   derive image from a certain base image
 FROM        node:24-alpine3.23
 
+#   link to Github repository
+LABEL       org.opencontainers.image.source=https://github.com/rse/nunjucks-cli
+LABEL       org.opencontainers.image.description="Nunjucks Template Rendering Command-Line Interface"
+
 #   add additional build tools
 RUN         apk update && \
             apk upgrade
@@ -27,9 +31,7 @@ WORKDIR     /app
 ENV         HOME=/app
 
 #   install tool
-RUN         npm install -g \
-                @rse/nunjucks-cli@1.5.2 \
-                @rse/nunjucks-addons@1.0.8
+RUN         npm install -g @rse/nunjucks-cli
 
 #   cleanup Alpine
 RUN         rm -rf /var/cache/apk/*

package/README.md

@@ -48,6 +48,14 @@ $ npx --yes --package @rse/nunjucks-cli --package @rse/nunjucks-addons -- \
   nunjucks -e @rse/nunjucks-addons [...]
 ```
 
+Furthermore, instead of using NPM at all, you can also use Docker (at
+least as long as you are working with stdin/stdout or perform the
+corresponding bind-mounts):
+
+```sh
+$ docker run -i --rm ghcr.io/rse/nunjucks-cli [...] -
+```
+
 Command-Line Interface (CLI)
 ----------------------------
 
@@ -57,11 +65,13 @@ Short excerpt of the CLI options and arguments from the companion [Unix manpage]
 $ nunjucks
   [-h|--help]
   [-V|--version]
+  [-e|--env <env-file>]
+  [-E|--envs]
   [-c|--config <config-file>]
   [-C|--option <key>=<value>]
   [-d|--defines <context-file>]
   [-D|--define <key>=<value>]
-  [-e|--extension <module-name>]
+  [-p|--plugin <module-name>]
   [-o|--output <output-file>|-]
   <input-file>|-
 ```
@@ -70,6 +80,12 @@ $ nunjucks
   Show usage help.
 - `-V`|`--version`:<br/>
   Show program version information.
+- `-e`|`--env` *env-file*:<br/>
+  Load environment file with key/value definitions.
+  These can later be accessed with the global `env` variable.
+- [`-E`|`--envs`]:<br/>
+  Automatically load environment files with key/value definitions
+  from all `.env` files in current and all parent directories.
 - `-c`|`--config` `<config-file>`:<br/>
   Load Nunjucks configuration YAML file.
 - `-C`|`--option` `<key>=<value>`:<br/>
@@ -80,8 +96,8 @@ $ nunjucks
 - `-D`|`--define` `<key>=<value>`:<br/>
   Set context definition key/value.
   Can occur multiple times.
-- `-e`|`--extension` `<module-name>`:<br/>
-  Load Nunjucks JavaScript extension module (installed via NPM).
+- `-p`|`--plugin` `<module-name>`:<br/>
+  Load Nunjucks JavaScript plugin module (installed via NPM).
 - `-o`|`--output` `<output-file>`|`-`:<br/>
   Save output file (or stdout).
 - `<input-file>`|`-`:<br/>

package/nunjucks.md

@@ -6,11 +6,13 @@
 `nunjucks`
 \[`-h`|`--help`\]
 \[`-V`|`--version`\]
+\[`-e`|`--env` *env-file*\]
+\[`-E`|`--envs`\]
 \[`-c`|`--config` *config-file*\]
 \[`-C`|`--option` *key*=*value*\]
 \[`-d`|`--defines` *context-file*\]
 \[`-D`|`--define` *key*=*value*\]
-\[`-e`|`--extension` *module-name*\]
+\[`-p`|`--plugin` *module-name*\]
 \[`-o`|`--output` *output-file*|`-`\]
 \[*input-file*|`-`\]
 
@@ -27,33 +29,41 @@ It optionally can load Nunjucks addons like the ones from the companion
 
 The following top-level options and arguments exist:
 
-- \[`-h`|`--help`\]
+- \[`-h`|`--help`\]:
   Show usage help.
 
-- \[`-V`|`--version`\]
+- \[`-V`|`--version`\]:
   Show program version information.
 
-- \[`-c`|`--config` *config-file*\]
+- \[`-e`|`--env` *env-file*\]:
+  Load environment file with key/value definitions.
+  These can later be accessed with the global `env` variable.
+
+- \[`-E`|`--envs`\]:
+  Automatically load environment files with key/value definitions
+  from all `.env` files in current and all parent directories.
+
+- \[`-c`|`--config` *config-file*\]:
   Load Nunjucks configuration YAML file.
 
-- \[`-C`|`--option` *key*=*value*\]
+- \[`-C`|`--option` *key*=*value*\]:
   Set Nunjucks configuration option.
 
-- \[`-d`|`--defines` *context-file*\]
+- \[`-d`|`--defines` *context-file*\]:
   Load context definition YAML file.
   Can occur multiple times.
 
-- \[`-D`|`--define` *key*=*value*\]
+- \[`-D`|`--define` *key*=*value*\]:
   Set context definition key/value.
   Can occur multiple times.
 
-- \[`-e`|`--extension` *module-name*\]
-  Load Nunjucks JavaScript extension module (installed via NPM).
+- \[`-p`|`--plugin` *module-name*\]:
+  Load Nunjucks JavaScript plugin module (installed via NPM).
 
-- \[`-o`|`--output` *output-file*|`-`\]
+- \[`-o`|`--output` *output-file*|`-`\]:
   Save output file (or stdout).
 
-- \[`<input-file>`|`-`\]
+- \[`<input-file>`|`-`\]:
   Load input file (or stdin).
 
 ## EXAMPLE

package/nunjucks.ts

@@ -16,6 +16,11 @@ import chalk             from "chalk"
 import jsYAML            from "js-yaml"
 import nunjucks          from "nunjucks"
 import deepmerge         from "deepmerge"
+import dotenvx           from "@dotenvx/dotenvx"
+import * as findup       from "find-up"
+
+/*  internal requirements  */
+import pkg               from "./package.json" with { type: "json" }
 
 /*  type definitions  */
 type PackageInfo = {
@@ -38,196 +43,223 @@ type OptionsType = {
 type CLIOptions = {
     help:      boolean
     version:   boolean
+    env:       string[]
+    envs:      boolean
     config:    string
     option:    string[]
     defines:   string[]
     define:    string[]
-    extension: string[]
+    plugin:    string[]
     output:    string
     _:         string[]
 }
 
-/*  load my own information  */
-const my: PackageInfo = JSON.parse(await fs.promises.readFile(new URL("./package.json", import.meta.url), "utf-8"))
-
-/*  parse command-line arguments  */
-const program = new Command()
-const reduceArray = (v: string, l: string[]) => l.concat([ v ])
-program.name("nunjucks")
-    .description("Nunjucks Template Rendering Command-Line Interface")
-    .showHelpAfterError("hint: use option --help for usage information")
-    .option("-h, --help",                    "show usage help",                                        false)
-    .option("-V, --version",                 "show program version information",                       false)
-    .option("-c, --config <config-file>",    "load Nunjucks configuration YAML file",                  "")
-    .option("-C, --option <key>=<value>",    "set Nunjucks configuration option",         reduceArray, [])
-    .option("-d, --defines <context-file>",  "load context definition YAML file",         reduceArray, [])
-    .option("-D, --define <key>=<value>",    "set context definition key/value",          reduceArray, [])
-    .option("-e, --extension <module-name>", "load Nunjucks JavaScript extension module", reduceArray, [])
-    .option("-o, --output <output-file>",    "save output file",                                       "-")
-    .argument("[<input-file>]", "input file")
-program.parse(process.argv)
-const argv: CLIOptions = {
-    ...program.opts(),
-    _: program.args
-} as CLIOptions
-
-/*  handle special help request  */
-if (argv.help) {
-    console.log(program.helpInformation())
-    console.log("Example:\n  $ echo \"Hello, {{ who }}!\" | nunjucks -Dwho=World -\n")
-    process.exit(0)
-}
+/*  establish asynchronous environment  */
+;(async () => {
+    /*  load my own information  */
+    const my = pkg as PackageInfo
 
-/*  handle special version request  */
-if (argv.version) {
-    console.log(`${my.name} ${my.version} (Node.js ${process.versions.node}, Nunjucks: ${my.dependencies.nunjucks})`)
-    console.log(`${my.description}`)
-    console.log(`Copyright (c) 2019-2025 ${my.author.name} <${my.author.url}>`)
-    console.log(`Licensed under ${my.license} <http://spdx.org/licenses/${my.license}.html>`)
-    process.exit(0)
-}
+    /*  parse command-line arguments  */
+    const program = new Command()
+    const reduceArray = (v: string, l: string[]) => l.concat([ v ])
+    program.name("nunjucks")
+        .description("Nunjucks Template Rendering Command-Line Interface")
+        .showHelpAfterError("hint: use option --help for usage information")
+        .option("-h, --help",                    "show usage help",                                        false)
+        .option("-V, --version",                 "show program version information",                       false)
+        .option("-e, --env <env-file>",          "load environment key/value file",           reduceArray, [])
+        .option("-E, --envs",                    "load all environment key/value files",                   false)
+        .option("-c, --config <config-file>",    "load Nunjucks configuration YAML file",                  "")
+        .option("-C, --option <key>=<value>",    "set Nunjucks configuration option",         reduceArray, [])
+        .option("-d, --defines <context-file>",  "load context definition YAML file",         reduceArray, [])
+        .option("-D, --define <key>=<value>",    "set context definition key/value",          reduceArray, [])
+        .option("-p, --plugin <module-name>",    "load Nunjucks JavaScript plugin module",    reduceArray, [])
+        .option("-o, --output <output-file>",    "save output file",                                       "-")
+        .argument("[<input-file>]", "input file")
+    program.parse(process.argv)
+    const argv: CLIOptions = {
+        ...program.opts(),
+        _: program.args
+    } as CLIOptions
 
-/*  read input file  */
-let input = ""
-if (argv._.length > 1) {
-    console.error(chalk.red("nunjucks: ERROR: invalid number of arguments (zero or one input file expected)"))
-    process.exit(1)
-}
-let inputFile: string = argv._[0] ?? "-"
-if (inputFile === "-") {
-    inputFile = "<stdin>"
-    process.stdin.setEncoding("utf-8")
-    const BUFSIZE = 256
-    const buf = Buffer.alloc(BUFSIZE)
-    while (true) {
-        let bytesRead = 0
+    /*  handle special help request  */
+    if (argv.help) {
+        console.log(program.helpInformation())
+        console.log("Example:\n  $ echo \"Hello, {{ who }}!\" | nunjucks -Dwho=World -\n")
+        process.exit(0)
+    }
+
+    /*  handle special version request  */
+    if (argv.version) {
+        console.log(`${my.name} ${my.version} (Node.js ${process.versions.node}, Nunjucks: ${my.dependencies.nunjucks})`)
+        console.log(`${my.description}`)
+        console.log(`Copyright (c) 2019-2025 ${my.author.name} <${my.author.url}>`)
+        console.log(`Licensed under ${my.license} <http://spdx.org/licenses/${my.license}.html>`)
+        process.exit(0)
+    }
+
+    /*  read input file  */
+    let input = ""
+    if (argv._.length > 1) {
+        console.error(chalk.red("nunjucks: ERROR: invalid number of arguments (zero or one input file expected)"))
+        process.exit(1)
+    }
+    let inputFile: string = argv._[0] ?? "-"
+    if (inputFile === "-") {
+        inputFile = "<stdin>"
+        process.stdin.setEncoding("utf-8")
+        const BUFSIZE = 256
+        const buf = Buffer.alloc(BUFSIZE)
+        while (true) {
+            let bytesRead = 0
+            try {
+                bytesRead = fs.readSync(process.stdin.fd, buf, 0, BUFSIZE, null)
+            }
+            catch (ex: any) {
+                if      (ex.code === "EAGAIN") continue
+                else if (ex.code === "EOF")    break
+                else                           throw ex
+            }
+            if (bytesRead === 0)
+                break
+            input += buf.toString("utf8", 0, bytesRead)
+        }
+    }
+    else {
+        if (!fs.existsSync(inputFile)) {
+            console.error(chalk.red(`nunjucks: ERROR: failed to find input file: "${inputFile}"`))
+            process.exit(1)
+        }
+        input = fs.readFileSync(inputFile, { encoding: "utf8" })
+    }
+
+    /*  provide context variables for template  */
+    let context: ContextType = {}
+    for (const define of argv.defines) {
         try {
-            bytesRead = fs.readSync(process.stdin.fd, buf, 0, BUFSIZE, null)
+            context = deepmerge(context, jsYAML.load(fs.readFileSync(define, { encoding: "utf8" })) as ContextType)
         }
         catch (ex: any) {
-            if      (ex.code === "EAGAIN") continue
-            else if (ex.code === "EOF")    break
-            else                           throw ex
+            console.error(chalk.red(`nunjucks: ERROR: failed to load context YAML file: ${ex.toString()}`))
+            process.exit(1)
         }
-        if (bytesRead === 0)
-            break
-        input += buf.toString("utf8", 0, bytesRead)
     }
-}
-else {
-    if (!fs.existsSync(inputFile)) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to find input file: ${inputFile}`))
-        process.exit(1)
-    }
-    input = fs.readFileSync(inputFile, { encoding: "utf8" })
-}
 
-/*  provide context variables for template  */
-let context: ContextType = {}
-for (const define of argv.defines) {
-    try {
-        context = deepmerge(context, jsYAML.load(fs.readFileSync(define, { encoding: "utf8" })) as ContextType)
+    /*  load environment variables from all default files  */
+    if (argv.envs) {
+        const files = findup.findUpMultipleSync(".env")
+        if (files.length > 0)
+            dotenvx.config({ path: files, quiet: true })
     }
-    catch (ex: any) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to load context YAML file: ${ex.toString()}`))
-        process.exit(1)
+
+    /*  load environment variables from environment files  */
+    if (argv.env.length > 0) {
+        for (const env of argv.env) {
+            if (!fs.existsSync(env)) {
+                console.error(chalk.red(`nunjucks: ERROR: environment file not found: "${env}"`))
+                process.exit(1)
+            }
+        }
+        dotenvx.config({ path: argv.env, quiet: true })
     }
-}
 
-/*  expose environment variables to template  */
-context.env = process.env
-
-/*  add context defines  */
-argv.define.forEach((define: string) => {
-    const match = define.match(/^([^=]+)(?:=(.*))?$/)
-    if (!match)
-        return
-    let [ , key, val ]: (string | undefined)[] = match
-    if (!key)
-        return
-    if (val === undefined)
-        val = "true"
-    context[key] = val
-})
+    /*  expose environment variables to template  */
+    context.env = process.env
 
-/*  determine Nunjucks options  */
-let options: OptionsType = {}
-if (argv.config) {
-    try {
-        options = jsYAML.load(fs.readFileSync(argv.config, { encoding: "utf8" })) as OptionsType
+    /*  add context defines  */
+    argv.define.forEach((define: string) => {
+        const match = define.match(/^([^=]+)(?:=(.*))?$/)
+        if (!match)
+            return
+        let [ , key, val ]: (string | undefined)[] = match
+        if (!key)
+            return
+        if (val === undefined)
+            val = "true"
+        context[key] = val
+    })
+
+    /*  determine Nunjucks options  */
+    let options: OptionsType = {}
+    if (argv.config) {
+        try {
+            options = jsYAML.load(fs.readFileSync(argv.config, { encoding: "utf8" })) as OptionsType
+        }
+        catch (ex: any) {
+            console.error(chalk.red(`nunjucks: ERROR: failed to load options YAML file: ${ex.toString()}`))
+            process.exit(1)
+        }
     }
-    catch (ex: any) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to load options YAML file: ${ex.toString()}`))
-        process.exit(1)
+    if (argv.option.length > 0)
+        options = Object.assign(options, argv.option)
+    options = {
+        autoescape:       false,
+        throwOnUndefined: false,
+        trimBlocks:       true,
+        lstripBlocks:     true,
+        watch:            false,
+        noCache:          true,
+        ...options
     }
-}
-if (argv.option.length > 0)
-    options = Object.assign(options, argv.option)
-options = {
-    autoescape:       false,
-    throwOnUndefined: false,
-    trimBlocks:       true,
-    lstripBlocks:     true,
-    watch:            false,
-    noCache:          true,
-    ...options
-}
 
-/*  configure environment  */
-const env = nunjucks.configure(inputFile, options)
+    /*  configure environment  */
+    const env = nunjucks.configure(inputFile, options)
 
-/*  load external extension files  */
-for (const extension of argv.extension) {
-    let modpath: string | null = path.resolve(extension)
-    if (!fs.existsSync(modpath)) {
+    /*  load external plugin modules  */
+    for (const plugin of argv.plugin) {
+        let modpath: string | null = path.resolve(plugin)
+        if (!fs.existsSync(modpath)) {
+            try {
+                const require = createRequire(import.meta.url)
+                modpath = require.resolve(plugin)
+            }
+            catch (_ex) {
+                modpath = null
+            }
+        }
+        if (modpath === null) {
+            console.error(chalk.red(`nunjucks: ERROR: failed to find plugin module: ${plugin}`))
+            process.exit(1)
+        }
+
+        /*  dynamically import the module  */
+        let mod: any
         try {
-            const require = createRequire(import.meta.url)
-            modpath = require.resolve(extension)
+            mod = await import(modpath)
+
+            /*  handle both default and named exports  */
+            mod = mod.default ?? mod
         }
-        catch (_ex) {
-            modpath = null
+        catch (ex: any) {
+            console.error(chalk.red(`nunjucks: ERROR: failed to load plugin module: ${ex.toString()}`))
+            process.exit(1)
         }
-    }
-    if (modpath === null) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to find extension module: ${extension}`))
-        process.exit(1)
+        if (!(mod !== null && typeof mod === "function")) {
+            console.error(chalk.red(`nunjucks: ERROR: failed to call plugin file: "${modpath}"`))
+            process.exit(1)
+        }
+        mod(env)
     }
 
-    /*  dynamically import the module  */
-    let mod: any
+    /*  render Nunjucks template  */
+    let output: string
     try {
-        mod = await import(modpath)
-
-        /*  handle both default and named exports  */
-        mod = mod.default ?? mod
+        output = env.renderString(input, context)
     }
     catch (ex: any) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to load extension module: ${ex.toString()}`))
-        process.exit(1)
-    }
-    if (!(mod !== null && typeof mod === "function")) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to call extension file: ${modpath}`))
+        console.error(chalk.red(`nunjucks: ERROR: failed to render template: ${ex.toString()}`))
         process.exit(1)
     }
-    mod(env)
-}
-
-/*  render Nunjucks template  */
-let output: string
-try {
-    output = env.renderString(input, context)
-}
-catch (ex: any) {
-    console.error(chalk.red(`nunjucks: ERROR: failed to render template: ${ex.toString()}`))
-    process.exit(1)
-}
 
-/*  write output  */
-if (argv.output === "-")
-    process.stdout.write(output)
-else
-    fs.writeFileSync(argv.output, output, { encoding: "utf8" })
+    /*  write output  */
+    if (argv.output === "-")
+        process.stdout.write(output)
+    else
+        fs.writeFileSync(argv.output, output, { encoding: "utf8" })
 
-/*  die gracefully  */
-process.exit(0)
+    /*  die gracefully  */
+    process.exit(0)
+})().catch((err: any) => {
+    console.error(chalk.red(`nunjucks: ERROR: ${err.toString()}`))
+})
 

package/package.json

@@ -1,60 +1,66 @@
 {
-    "name":                       "@rse/nunjucks-cli",
-    "publishConfig":              { "access": "public" },
-    "version":                    "2.0.1",
-    "stdver":                     "2.0.0-GA",
-    "description":                "Nunjucks Template Rendering Command-Line Interface",
+    "name":                             "@rse/nunjucks-cli",
+    "publishConfig":                    { "access": "public" },
+    "version":                          "2.2.0",
+    "stdver":                           "2.2.0-GA",
+    "description":                      "Nunjucks Template Rendering Command-Line Interface",
     "author": {
-        "name":                   "Dr. Ralf S. Engelschall",
-        "email":                  "rse@engelschall.com",
-        "url":                    "http://engelschall.com"
+        "name":                         "Dr. Ralf S. Engelschall",
+        "email":                        "rse@engelschall.com",
+        "url":                          "http://engelschall.com"
     },
-    "license":                    "MIT",
+    "license":                          "MIT",
     "repository": {
-        "type":                   "git",
-        "url":                    "git+https://github.com/rse/nunjucks-cli.git"
+        "type":                         "git",
+        "url":                          "git+https://github.com/rse/nunjucks-cli.git"
     },
     "bugs": {
-        "url":                    "http://github.com/rse/nunjucks-cli/issues"
+        "url":                          "http://github.com/rse/nunjucks-cli/issues"
     },
     "bin": {
-        "nunjucks":               "nunjucks.js"
+        "nunjucks":                     "dst-stage1/nunjucks.js"
     },
-    "man":                        "nunjucks.1",
-    "type":                       "module",
+    "man":                              "dst-stage1/nunjucks.1",
+    "type":                             "module",
     "engines": {
-        "node":                   ">=22.18.0"
+        "node":                         ">=22.18.0"
     },
     "dependencies": {
-        "nunjucks":               "3.2.4",
-        "chalk":                  "5.6.2",
-        "commander":              "14.0.2",
-        "js-yaml":                "4.1.1",
-        "deepmerge":              "4.3.1"
+        "nunjucks":                     "3.2.4",
+        "chalk":                        "5.6.2",
+        "commander":                    "14.0.2",
+        "js-yaml":                      "4.1.1",
+        "deepmerge":                    "4.3.1",
+        "@dotenvx/dotenvx":             "1.51.2",
+        "find-up":                      "8.0.0"
     },
     "devDependencies": {
-        "eslint":                 "9.39.2",
-        "@eslint/js":             "9.39.2",
-        "neostandard":            "0.12.2",
-        "eslint-plugin-promise":  "7.2.1",
-        "eslint-plugin-import":   "2.32.0",
-        "eslint-plugin-n":        "17.23.1",
-        "globals":                "16.5.0",
-        "remark-cli":             "12.0.1",
-        "remark":                 "15.0.1",
-        "remark-man":             "9.0.0",
-        "typescript":             "5.9.3",
-        "typescript-eslint":      "8.50.0",
-        "@rse/stx":               "1.1.3",
-        "shx":                    "0.4.0",
-        "@yao-pkg/pkg":           "6.11.0",
+        "eslint":                       "9.39.2",
+        "@eslint/js":                   "9.39.2",
+        "neostandard":                  "0.12.2",
+        "eslint-plugin-promise":        "7.2.1",
+        "eslint-plugin-import":         "2.32.0",
+        "eslint-plugin-n":              "17.23.1",
+        "globals":                      "16.5.0",
+        "remark-cli":                   "12.0.1",
+        "remark":                       "15.0.1",
+        "remark-man":                   "9.0.0",
+        "typescript":                   "5.9.3",
+        "typescript-eslint":            "8.50.1",
+        "@rse/stx":                     "1.1.4",
+        "shx":                          "0.4.0",
+        "@yao-pkg/pkg":                 "6.11.0",
+        "vite":                         "7.3.0",
+        "@wroud/vite-plugin-tsc":       "0.12.2",
+        "rollup-plugin-node-externals": "8.1.2",
+        "terser":                       "5.44.1",
 
-        "@types/node":            "25.0.3",
-        "@types/js-yaml":         "4.0.9",
-        "@types/nunjucks":        "3.2.6"
+        "@types/node":                  "25.0.3",
+        "@types/js-yaml":               "4.0.9",
+        "@types/nunjucks":              "3.2.6"
     },
     "scripts": {
-        "start":                  "stx -v4 -c stx.conf",
-        "test":                   "npm start test"
+        "start":                        "stx -v4 -c stx.conf",
+        "test":                         "npm start test"
     }
 }

package/stx.conf

@@ -11,28 +11,47 @@ lint
 
 #   build JavaScript from TypeScript
 build
-    tsc --project tsconfig.json
-
-#   build manual page
-man
-    remark --quiet --use remark-man --output nunjucks.1 nunjucks.md
+    vite --config vite.mts build --mode production &&
+    remark --quiet --use remark-man --output dst-stage1/nunjucks.man nunjucks.md
 
 #   execute simple smole test
 test : build
     echo 'Hello, {{who}}!' | node nunjucks.js -D who=world -
 
-#   build all-in-one packages
-build:pkg [hostname=en4.*]
-
 #   package distribution archives
-package : build build:pkg [hostname=en4.*]
-    VERSION=`sed -n '/"version":/ s/.*: *"\(.*\)".*/\1/p' package.json` && \
+package : package:docker package:sea [hostname=en4.*]
+
+#   package as Docker container image
+package:docker [hostname=en4.*]
+	IMAGE_PREFIX=`egrep "ARG.*IMAGE_PREFIX" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_NAME=`egrep "ARG.*IMAGE_NAME" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_VERSION=`egrep "ARG.*IMAGE_VERSION" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_RELEASE=`egrep "ARG.*IMAGE_RELEASE" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_ALIAS=`egrep "ARG.*IMAGE_ALIAS" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	docker buildx build \
+	    --progress plain \
+        --pull \
+        --no-cache \
+	    --platform linux/amd64,linux/arm64 \
+	    -t $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_ALIAS \
+	    -t $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_VERSION \
+	    -t $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_VERSION-$IMAGE_RELEASE \
+	    -f Dockerfile . && \
+	docker image ls $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_VERSION-$IMAGE_RELEASE
+
+#   package as Single Excecutable Application (SEA)
+package:sea [hostname=en4.*]
+    rm -rf dst-stage3 && \
+    mkdir dst-stage3 && \
+    cd dst-stage3 && \
+    VERSION=`sed -n '/"version":/ s/.*: *"\(.*\)".*/\1/p' ../package.json` && \
     targets="node24-linux-x64,node24-linux-arm64" && \
     targets="$targets,node24-win-x64,node24-win-arm64" && \
     targets="$targets,node24-macos-x64,node24-macos-arm64" && \
-    sed -e 's;@rse/nunjucks-cli;nunjucks;' <package.json >nunjucks.json && \
-    pkg --sea --public -c nunjucks.json -t "$targets" nunjucks.js && \
-    rm -f nunjucks.json && \
+    sed -e 's;@rse/nunjucks-cli;nunjucks;' -e '/"type"/d' <../package.json >package.json && \
+    cp ../dst-stage2/nunjucks.cjs nunjucks.cjs && \
+    cp ../dst-stage1/nunjucks.man nunjucks.man && \
+    pkg --public --no-bytecode -c package.json -t "$targets" nunjucks.cjs && \
     shx mv nunjucks-linux-x64     nunjucks-lnx-x64     && \
     shx mv nunjucks-linux-arm64   nunjucks-lnx-a64     && \
     shx mv nunjucks-win-x64.exe   nunjucks-win-x64.exe && \
@@ -46,20 +65,20 @@ package : build build:pkg [hostname=en4.*]
     mkdir -p nunjucks-$VERSION-mac-a64/ && \
     mkdir -p nunjucks-$VERSION-lnx-x64/ && \
     mkdir -p nunjucks-$VERSION-lnx-a64/ && \
-    cp -p nunjucks.js             nunjucks-$VERSION/nunjucks.js && \
+    cp -p nunjucks.cjs            nunjucks-$VERSION/nunjucks.cjs && \
     cp -p nunjucks-win-x64.exe    nunjucks-$VERSION-win-x64/nunjucks.exe && \
     cp -p nunjucks-win-a64.exe    nunjucks-$VERSION-win-a64/nunjucks.exe && \
     cp -p nunjucks-mac-x64        nunjucks-$VERSION-mac-x64/nunjucks && \
     cp -p nunjucks-mac-a64        nunjucks-$VERSION-mac-a64/nunjucks && \
     cp -p nunjucks-lnx-x64        nunjucks-$VERSION-lnx-x64/nunjucks && \
     cp -p nunjucks-lnx-a64        nunjucks-$VERSION-lnx-a64/nunjucks && \
-    cp -p nunjucks.1              nunjucks-$VERSION/nunjucks.man && \
-    cp -p nunjucks.1              nunjucks-$VERSION-win-x64/nunjucks.man && \
-    cp -p nunjucks.1              nunjucks-$VERSION-win-a64/nunjucks.man && \
-    cp -p nunjucks.1              nunjucks-$VERSION-mac-x64/nunjucks.man && \
-    cp -p nunjucks.1              nunjucks-$VERSION-mac-a64/nunjucks.man && \
-    cp -p nunjucks.1              nunjucks-$VERSION-lnx-x64/nunjucks.man && \
-    cp -p nunjucks.1              nunjucks-$VERSION-lnx-a64/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION-win-x64/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION-win-a64/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION-mac-x64/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION-mac-a64/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION-lnx-x64/nunjucks.man && \
+    cp -p nunjucks.man            nunjucks-$VERSION-lnx-a64/nunjucks.man && \
     zip -9 -r nunjucks-$VERSION.zip         nunjucks-$VERSION/         && \
     zip -9 -r nunjucks-$VERSION-win-x64.zip nunjucks-$VERSION-win-x64/ && \
     zip -9 -r nunjucks-$VERSION-win-a64.zip nunjucks-$VERSION-win-a64/ && \
@@ -69,24 +88,37 @@ package : build build:pkg [hostname=en4.*]
     zip -9 -r nunjucks-$VERSION-lnx-a64.zip nunjucks-$VERSION-lnx-a64/
 
 #   publish distribution archives
-publish : package [hostname=en4.*]
+publish : publish:docker publish:sea [hostname=en4.*]
+
+#   publish Docker container image
+publish:docker [hostname=en4.*]
+	IMAGE_PREFIX=`egrep "ARG.*IMAGE_PREFIX" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_NAME=`egrep "ARG.*IMAGE_NAME" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_VERSION=`egrep "ARG.*IMAGE_VERSION" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_RELEASE=`egrep "ARG.*IMAGE_RELEASE" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	IMAGE_ALIAS=`egrep "ARG.*IMAGE_ALIAS" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
+	docker push $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_VERSION-$IMAGE_RELEASE && \
+	docker push $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_VERSION && \
+	docker push $IMAGE_PREFIX$IMAGE_NAME:$IMAGE_ALIAS
+
+#   publish Single Excecutable Application (SEA)
+publish:sea [hostname=en4.*]
     VERSION=`sed -n '/"version":/ s/.*: *"\(.*\)".*/\1/p' package.json` && \
     V=`echo "$VERSION" | sed -e 's;\.;\\.;g'` && \
     sed -n -e "/^${V} /, /^[0-9]\\./ { /^${V} /p; /^[0-9]\\./!p; }" <CHANGELOG.md >.notes.md && \
     gh release create --title "Nunjucks $VERSION" --notes-file .notes.md --verify-tag $VERSION \
-    nunjucks-$VERSION.zip \
-    nunjucks-$VERSION-win-x64.zip \
-    nunjucks-$VERSION-win-a64.zip \
-    nunjucks-$VERSION-mac-x64.zip \
-    nunjucks-$VERSION-mac-a64.zip \
-    nunjucks-$VERSION-lnx-x64.zip \
-    nunjucks-$VERSION-lnx-a64.zip && \
+    dst-stage3/nunjucks-$VERSION.zip \
+    dst-stage3/nunjucks-$VERSION-win-x64.zip \
+    dst-stage3/nunjucks-$VERSION-win-a64.zip \
+    dst-stage3/nunjucks-$VERSION-mac-x64.zip \
+    dst-stage3/nunjucks-$VERSION-mac-a64.zip \
+    dst-stage3/nunjucks-$VERSION-lnx-x64.zip \
+    dst-stage3/nunjucks-$VERSION-lnx-a64.zip && \
     rm -f .notes.md
 
 #   remove all generated artifacts
 clean
-    shx rm -f nunjucks.js && \
-    shx rm -rf nunjucks-*.zip
+    shx rm -rf dst-stage*
 
 #   remove all generated artifacts
 distclean: clean

package/tsconfig.json

@@ -1,9 +1,9 @@
 {
     "compilerOptions": {
         "target":                           "ES2024",
-        "module":                           "node20",
+        "module":                           "nodenext",
         "lib":                              [ "ES2024" ],
-        "moduleResolution":                 "node16",
+        "moduleResolution":                 "nodenext",
         "resolveJsonModule":                true,
         "declaration":                      false,
         "allowSyntheticDefaultImports":     true,
@@ -11,7 +11,7 @@
         "forceConsistentCasingInFileNames": true,
         "strict":                           true,
         "skipLibCheck":                     true,
-        "outDir":                           ".",
+        "outDir":                           "dst-stage1",
         "types":                            [ "node" ]
     },
     "include": [

package/vite.mts

@@ -0,0 +1,59 @@
+/*
+**  nunjucks -- Nunjucks Template Rendering Command-Line Interface
+**  Copyright (c) 2019-2025 Dr. Ralf S. Engelschall <http://engelschall.com>
+**  Licensed under MIT <http://spdx.org/licenses/MIT.html>
+*/
+
+import * as Vite          from "vite"
+import { tscPlugin }      from "@wroud/vite-plugin-tsc"
+import nodeExternals      from "rollup-plugin-node-externals"
+
+export default Vite.defineConfig(({ command, mode }) => ({
+    logLevel: "info",
+    appType: "custom",
+    base: "",
+    root: "",
+    plugins: [
+        tscPlugin({
+            tscArgs: [ "--project", "tsconfig.json", ...(mode === "development" ? [ "--sourceMap" ] : []) ],
+            packageManager: "npx" as "npm",
+            prebuild: true
+        }),
+        nodeExternals({
+            builtins: true,
+            devDeps:  false,
+            deps:     false,
+            optDeps:  false,
+            peerDeps: false
+        })
+    ],
+    resolve: {
+        mainFields: [ "module", "jsnext:main", "jsnext" ],
+        conditions: [ "node" ],
+    },
+    build: {
+        lib: {
+            entry:    "dst-stage1/nunjucks.js",
+            formats:  [ "cjs" ],
+            name:     "Nunjucks",
+            fileName: () => "nunjucks.cjs"
+        },
+        target:                 "esnext",
+        outDir:                 "dst-stage2",
+        assetsDir:              "",
+        emptyOutDir:            (mode === "production"),
+        chunkSizeWarningLimit:  5000,
+        assetsInlineLimit:      0,
+        sourcemap:              (mode === "development"),
+        minify:                 (mode === "production" ? "terser" : false),
+        reportCompressedSize:   true,
+        rollupOptions: {
+            onwarn (warning, warn) {
+                if (warning.message.match(/Use of eval.*?is strongly discouraged/))
+                    return
+                warn(warning)
+            }
+        }
+    }
+}))
+

package/Dockerfile.mk

@@ -1,104 +0,0 @@
-##
-##  Makefile: Docker Build Procedure
-##
-
-#   ==== DEFAULT ====
-#   default build target
-TARGETS ?= build
-all: $(TARGETS)
-
-#   ==== COMMON ====
-#   configuration of container image
-DOCKER_IMAGE_CONFIG ?= __dummy=1
-IMAGE_CONFIG = \
-	IMAGE_PREFIX=`egrep "ARG.*IMAGE_PREFIX" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
-	IMAGE_NAME=`egrep "ARG.*IMAGE_NAME" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
-	IMAGE_VERSION=`egrep "ARG.*IMAGE_VERSION" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
-	IMAGE_RELEASE=`egrep "ARG.*IMAGE_RELEASE" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
-	IMAGE_ALIAS=`egrep "ARG.*IMAGE_ALIAS" Dockerfile | sed -e 's;^.*=;;' | head -1` && \
-	$(DOCKER_IMAGE_CONFIG)
-
-#   ==== BUILD ====
-#   (re)build a container image
-DOCKER_BUILD_FLAGS ?= --pull --no-cache
-build: Dockerfile
-	@$(IMAGE_CONFIG) && \
-	echo "++ building Docker image $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} ($${IMAGE_ALIAS})" && \
-	docker build \
-	    $(DOCKER_BUILD_FLAGS) \
-	    --build-arg "IMAGE_PREFIX=$${IMAGE_PREFIX}" \
-	    --build-arg "IMAGE_NAME=$${IMAGE_NAME}" \
-	    --build-arg "IMAGE_VERSION=$${IMAGE_VERSION}" \
-	    --build-arg "IMAGE_RELEASE=$${IMAGE_RELEASE}" \
-	    --build-arg "IMAGE_ALIAS=$${IMAGE_ALIAS}" \
-	    -t $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_ALIAS} \
-	    -t $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION} \
-	    -t $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} \
-	    -f Dockerfile . && \
-	docker image ls $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE}
-
-#   ==== RUN ====
-#   run a container image
-DOCKER_RUN_FLAGS ?= --rm -i -t -e TERM --init
-DOCKER_RUN_ARGS  ?=
-run:
-	@$(IMAGE_CONFIG) && \
-	echo "++ running Docker image $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE}" && \
-	docker run \
-	    --name "$${IMAGE_NAME}-temp" \
-		$(DOCKER_RUN_FLAGS) \
-	    $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} \
-		$(DOCKER_RUN_ARGS)
-
-#   ==== INSPECT ====
-#   inspect a container image
-DOCKER_INSPECT_FLAGS ?= --rm -i -t -e TERM -u root --entrypoint "/bin/bash"
-DOCKER_INSPECT_ARGS  ?=
-inspect:
-	@$(IMAGE_CONFIG) && \
-	echo "++ inspecting Docker image $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE}" && \
-	docker run \
-	    --name "$${IMAGE_NAME}-temp" \
-		$(DOCKER_INSPECT_FLAGS) \
-	    $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} \
-		$(DOCKER_INSPECT_ARGS)
-
-#   ==== EXEC ====
-#   enter a running container image
-DOCKER_EXEC_FLAGS ?= -i -t -e TERM
-DOCKER_EXEC_ARGS  ?= /bin/bash
-exec:
-	@$(IMAGE_CONFIG) && \
-	echo "++ executing command in Docker container of Docker image $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE}" && \
-	docker exec \
-	    $(DOCKER_EXEC_FLAGS) \
-		`docker ps --filter "ancestor=$${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE}" --format "{{ .ID }}"` \
-		$(DOCKER_EXEC_ARGS)
-
-#   ==== PUSH ====
-#   push container image to registry
-push:
-	@$(IMAGE_CONFIG) && \
-	echo "++ pushing Docker image $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} ($${IMAGE_ALIAS})" && \
-	docker push $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} && \
-	docker push $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION} && \
-	docker push $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_ALIAS}
-
-#   ==== CLEAN ====
-#   remove container image
-clean:
-	@$(IMAGE_CONFIG) && \
-	echo "++ removing Docker image $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} ($${IMAGE_ALIAS})" && \
-	docker image rm $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION}-$${IMAGE_RELEASE} >/dev/null 2>&1 || true && \
-	docker image rm $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_VERSION} >/dev/null 2>&1 || true && \
-	docker image rm $${IMAGE_PREFIX}$${IMAGE_NAME}:$${IMAGE_ALIAS} >/dev/null 2>&1 || true && \
-
-#   ==== PRUNE ====
-#   prune entire Docker environment
-prune:
-	@echo "++ pruning Docker environment"
-	docker container prune -f
-	docker network prune -f
-	docker volume prune -f
-	docker image prune -f
-

package/nunjucks.1

@@ -1,47 +0,0 @@
-.TH "NUNJUCKS" "1" "June 2025" "" ""
-.SH "NAME"
-\fBnunjucks\fR - Template Rendering Engine
-.SH "SYNOPSIS"
-.P
-\fBnunjucks\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-V\fR|\fB--version\fR\[rB] \[lB]\fB-c\fR|\fB--config\fR \fIconfig-file\fR\[rB] \[lB]\fB-C\fR|\fB--option\fR \fIkey\fR=\fIvalue\fR\[rB] \[lB]\fB-d\fR|\fB--defines\fR \fIcontext-file\fR\[rB] \[lB]\fB-D\fR|\fB--define\fR \fIkey\fR=\fIvalue\fR\[rB] \[lB]\fB-e\fR|\fB--extension\fR \fImodule-name\fR\[rB] \[lB]\fB-o\fR|\fB--output\fR \fIoutput-file\fR|\fB-\fR\[rB] \[lB]\fIinput-file\fR|\fB-\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBnunjucks\fR(1) is a small command-line utility to render templates with the rich and powerful templating language \fBMozilla Nunjucks\fR \fI\(lahttps://mozilla.github.io/nunjucks/\(ra\fR. This allows you to define your configuration in a YAML file and then render an output file based on a template input file where your configuration can be expanded. It optionally can load Nunjucks addons like the ones from the companion \fBNunjucks Addons\fR \fI\(lahttps://github.com/rse/nunjucks-addons\(ra\fR package.
-.SH "OPTIONS"
-.P
-The following top-level options and arguments exist:
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB] Show usage help.
-.IP \(bu 4
-\[lB]\fB-V\fR|\fB--version\fR\[rB] Show program version information.
-.IP \(bu 4
-\[lB]\fB-c\fR|\fB--config\fR \fIconfig-file\fR\[rB] Load Nunjucks configuration YAML file.
-.IP \(bu 4
-\[lB]\fB-C\fR|\fB--option\fR \fIkey\fR=\fIvalue\fR\[rB] Set Nunjucks configuration option.
-.IP \(bu 4
-\[lB]\fB-d\fR|\fB--defines\fR \fIcontext-file\fR\[rB] Load context definition YAML file. Can occur multiple times.
-.IP \(bu 4
-\[lB]\fB-D\fR|\fB--define\fR \fIkey\fR=\fIvalue\fR\[rB] Set context definition key/value. Can occur multiple times.
-.IP \(bu 4
-\[lB]\fB-e\fR|\fB--extension\fR \fImodule-name\fR\[rB] Load Nunjucks JavaScript extension module (installed via NPM).
-.IP \(bu 4
-\[lB]\fB-o\fR|\fB--output\fR \fIoutput-file\fR|\fB-\fR\[rB] Save output file (or stdout).
-.IP \(bu 4
-\[lB]\fB<input-file>\fR|\fB-\fR\[rB] Load input file (or stdin).
-.RE 0
-
-.SH "EXAMPLE"
-.P
-.RS 2
-.nf
-$ echo "Hello, {{who}}!" | nunjucks -D who=world -
-Hello, world!
-.fi
-.RE
-.SH "HISTORY"
-.P
-The \fBnunjucks\fR(1) utility was developed in August 2023 for being able to easily generate multiple configuration files for a complex \fIDocker-Compose\fR based setup.
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/nunjucks.js

@@ -1,187 +0,0 @@
-#!/usr/bin/env node
-/*
-**  nunjucks -- Nunjucks Template Rendering Command-Line Interface
-**  Copyright (c) 2019-2025 Dr. Ralf S. Engelschall <http://engelschall.com>
-**  Licensed under MIT <http://spdx.org/licenses/MIT.html>
-*/
-/*  built-in requirements  */
-import fs from "node:fs";
-import path from "node:path";
-import { createRequire } from "node:module";
-/*  external requirements  */
-import { Command } from "commander";
-import chalk from "chalk";
-import jsYAML from "js-yaml";
-import nunjucks from "nunjucks";
-import deepmerge from "deepmerge";
-/*  load my own information  */
-const my = JSON.parse(await fs.promises.readFile(new URL("./package.json", import.meta.url), "utf-8"));
-/*  parse command-line arguments  */
-const program = new Command();
-const reduceArray = (v, l) => l.concat([v]);
-program.name("nunjucks")
-    .description("Nunjucks Template Rendering Command-Line Interface")
-    .showHelpAfterError("hint: use option --help for usage information")
-    .option("-h, --help", "show usage help", false)
-    .option("-V, --version", "show program version information", false)
-    .option("-c, --config <config-file>", "load Nunjucks configuration YAML file", "")
-    .option("-C, --option <key>=<value>", "set Nunjucks configuration option", reduceArray, [])
-    .option("-d, --defines <context-file>", "load context definition YAML file", reduceArray, [])
-    .option("-D, --define <key>=<value>", "set context definition key/value", reduceArray, [])
-    .option("-e, --extension <module-name>", "load Nunjucks JavaScript extension module", reduceArray, [])
-    .option("-o, --output <output-file>", "save output file", "-")
-    .argument("[<input-file>]", "input file");
-program.parse(process.argv);
-const argv = {
-    ...program.opts(),
-    _: program.args
-};
-/*  handle special help request  */
-if (argv.help) {
-    console.log(program.helpInformation());
-    console.log("Example:\n  $ echo \"Hello, {{ who }}!\" | nunjucks -Dwho=World -\n");
-    process.exit(0);
-}
-/*  handle special version request  */
-if (argv.version) {
-    console.log(`${my.name} ${my.version} (Node.js ${process.versions.node}, Nunjucks: ${my.dependencies.nunjucks})`);
-    console.log(`${my.description}`);
-    console.log(`Copyright (c) 2019-2025 ${my.author.name} <${my.author.url}>`);
-    console.log(`Licensed under ${my.license} <http://spdx.org/licenses/${my.license}.html>`);
-    process.exit(0);
-}
-/*  read input file  */
-let input = "";
-if (argv._.length > 1) {
-    console.error(chalk.red("nunjucks: ERROR: invalid number of arguments (zero or one input file expected)"));
-    process.exit(1);
-}
-let inputFile = argv._[0] ?? "-";
-if (inputFile === "-") {
-    inputFile = "<stdin>";
-    process.stdin.setEncoding("utf-8");
-    const BUFSIZE = 256;
-    const buf = Buffer.alloc(BUFSIZE);
-    while (true) {
-        let bytesRead = 0;
-        try {
-            bytesRead = fs.readSync(process.stdin.fd, buf, 0, BUFSIZE, null);
-        }
-        catch (ex) {
-            if (ex.code === "EAGAIN")
-                continue;
-            else if (ex.code === "EOF")
-                break;
-            else
-                throw ex;
-        }
-        if (bytesRead === 0)
-            break;
-        input += buf.toString("utf8", 0, bytesRead);
-    }
-}
-else {
-    if (!fs.existsSync(inputFile)) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to find input file: ${inputFile}`));
-        process.exit(1);
-    }
-    input = fs.readFileSync(inputFile, { encoding: "utf8" });
-}
-/*  provide context variables for template  */
-let context = {};
-for (const define of argv.defines) {
-    try {
-        context = deepmerge(context, jsYAML.load(fs.readFileSync(define, { encoding: "utf8" })));
-    }
-    catch (ex) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to load context YAML file: ${ex.toString()}`));
-        process.exit(1);
-    }
-}
-/*  expose environment variables to template  */
-context.env = process.env;
-/*  add context defines  */
-argv.define.forEach((define) => {
-    const match = define.match(/^([^=]+)(?:=(.*))?$/);
-    if (!match)
-        return;
-    let [, key, val] = match;
-    if (!key)
-        return;
-    if (val === undefined)
-        val = "true";
-    context[key] = val;
-});
-/*  determine Nunjucks options  */
-let options = {};
-if (argv.config) {
-    try {
-        options = jsYAML.load(fs.readFileSync(argv.config, { encoding: "utf8" }));
-    }
-    catch (ex) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to load options YAML file: ${ex.toString()}`));
-        process.exit(1);
-    }
-}
-if (argv.option.length > 0)
-    options = Object.assign(options, argv.option);
-options = {
-    autoescape: false,
-    throwOnUndefined: false,
-    trimBlocks: true,
-    lstripBlocks: true,
-    watch: false,
-    noCache: true,
-    ...options
-};
-/*  configure environment  */
-const env = nunjucks.configure(inputFile, options);
-/*  load external extension files  */
-for (const extension of argv.extension) {
-    let modpath = path.resolve(extension);
-    if (!fs.existsSync(modpath)) {
-        try {
-            const require = createRequire(import.meta.url);
-            modpath = require.resolve(extension);
-        }
-        catch (_ex) {
-            modpath = null;
-        }
-    }
-    if (modpath === null) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to find extension module: ${extension}`));
-        process.exit(1);
-    }
-    /*  dynamically import the module  */
-    let mod;
-    try {
-        mod = await import(modpath);
-        /*  handle both default and named exports  */
-        mod = mod.default ?? mod;
-    }
-    catch (ex) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to load extension module: ${ex.toString()}`));
-        process.exit(1);
-    }
-    if (!(mod !== null && typeof mod === "function")) {
-        console.error(chalk.red(`nunjucks: ERROR: failed to call extension file: ${modpath}`));
-        process.exit(1);
-    }
-    mod(env);
-}
-/*  render Nunjucks template  */
-let output;
-try {
-    output = env.renderString(input, context);
-}
-catch (ex) {
-    console.error(chalk.red(`nunjucks: ERROR: failed to render template: ${ex.toString()}`));
-    process.exit(1);
-}
-/*  write output  */
-if (argv.output === "-")
-    process.stdout.write(output);
-else
-    fs.writeFileSync(argv.output, output, { encoding: "utf8" });
-/*  die gracefully  */
-process.exit(0);