template

var BuiltinFuncDocs = map[string]string{
	"truncate n str": "truncate str to n chars, appends '…'",
	"upper str":      "uppercase",
	"lower str":      "lowercase",
	"trim str":       "trim whitespace",
	"default d v":    "return v if non-empty, else d",
	"toJSON v":       "marshal any value to JSON string — safe for body: fields (aliases: toJson, tojson)",
	"fromJSON s":     "parse JSON string to map/slice/scalar — use to read fields out of stringified JSON (aliases: fromJson, fromjson)",
	"jsonEscape str": "escape string for embedding inside a JSON string literal",
	"now format":     "current UTC time — format uses Go ref time e.g. '2006-01-02T15:04:05Z07:00'",
}

var BuiltinFuncs = gotemplate.FuncMap{
	"truncate": func(n int, s string) string {
		if len(s) <= n {
			return s
		}
		return s[:n] + "…"
	},
	"upper": strings.ToUpper,
	"lower": strings.ToLower,
	"trim":  strings.TrimSpace,
	"default": func(d, v any) any {
		if v == nil || v == "" {
			return d
		}
		return v
	},

	"toJSON":   toJSON,
	"toJson":   toJSON,
	"tojson":   toJSON,
	"fromJSON": fromJSON,
	"fromJson": fromJSON,
	"fromjson": fromJSON,

	"jsonEscape": func(s string) string {
		b, _ := json.Marshal(s)

		return string(b[1 : len(b)-1])
	},

	"now": func(format string) string {
		if format == "" {
			format = time.RFC3339
		}
		return time.Now().UTC().Format(format)
	},
}