lua: Add ability to incorporate Dovecot settings in a Lua function argument entry

Author: slusarz

components/LuaFunctionComponent.vue

@@ -78,7 +78,7 @@ function buildFunctionSignature(k, v) {
          <td><code>{{ k2 }}</code></td>
          <td><em>{{ v2.type }}</em></td>
          <td>
-          <span v-html="v2.text" />
+          <div class="lua-function-description" v-html="v2.text" />
           <span v-if="v2.default">(Default: <code>{{ v2.default }}</code>)</span>
          </td>
         </tr>
@@ -104,4 +104,7 @@ function buildFunctionSignature(k, v) {
   margin: 15px auto;
   width: 75%;
 }
+.lua-function-description :deep(p) {
+  margin: 0;
+}
 </style>

data/lua.js

@@ -9,6 +9,11 @@ export const lua_functions = [
 		// List of function arguments
 		args: {
 			text: {
+				// If this argument is set, the 'text (w/default)' and
+				// 'values' information from the Dovecot setting is used if it
+				// does NOT otherwise exist in this config.
+				// dovecot_setting: 'dovecot_setting_name',
+
 				// If true, this argument appears inside a Lua hash table
 				// instead of as a standalone argument.
 				// hash_arg: false,

lib/data/lua.data.js

@@ -22,12 +22,32 @@ async function normalizeLuaConstants(lua) {
 
 async function normalizeLuaFunctions(lua) {
 	const md = await getVitepressMd()
+	let set = false
 	const out = {}
 
 	for (const v of lua.values()) {
 		if (v.args) {
 			for (const [k2, v2] of Object.entries(v.args)) {
-				v2.text = md.renderInline(v2.text)
+				/* Merge information from Dovecot settings. */
+				if (v2.dovecot_setting) {
+					if (!set) {
+						set = structuredClone(loadData('settings').settings)
+					}
+
+					if (!v2.type) {
+						v2.type = set[v2.dovecot_setting].values?.label
+					}
+
+					if (!v2.text) {
+						v2.text = set[v2.dovecot_setting].text.trim()
+					}
+
+					if (v2.default === undefined) {
+						v2.default = set[v2.dovecot_setting].default
+					}
+				}
+
+				v2.text = md.render(v2.text)
 			}
 		}