FixKFXBoilerplate: Add script

Author: arch1t3cht

DependencyControl.json

@@ -578,6 +578,32 @@
           "Move repository to TypesettingTools/arch1t3cht-Aegisub-Scripts"
         ]
       }
+    },
+    "arch.FixKFXBoilerplate": {
+      "fileBaseUrl": "@{fileBaseUrl}/macros/@{namespace}",
+      "url": "@{baseUrl}#@{namespace}",
+      "author": "arch1t3cht",
+      "name": "Fix KFX Boilerplate",
+      "description": "Fix certain errors in boilerplate lines in old KFX templates on new Aegisub versions",
+      "channels": {
+        "release": {
+          "version": "1.0.0",
+          "released": "2025-06-14",
+          "default": true,
+          "files": [
+            {
+              "name": ".moon",
+              "url": "@{fileBaseUrl}@{fileName}",
+              "sha1": ""
+            }
+          ]
+        }
+      },
+      "changelog": {
+        "1.0.0": [
+          "Initial Release"
+        ]
+      }
     }
   },
   "modules": {

README.md

@@ -7,6 +7,7 @@ My automation scripts for Aegisub. In my opinion, the coolest thing here is Aegi
   - [AegisubChain](#aegisubchain)
   - [Scripts for Typesetting](#scripts-for-typesetting)
     - [Focus Lines](#focus-lines)
+    - [FBF-ifier](#fbf-ifier)
     - [PerspectiveMotion](#perspectivemotion)
     - [Derive Perspective Track](#derive-perspective-track)
     - [Resample Perspective](#resample-perspective)
@@ -20,6 +21,7 @@ My automation scripts for Aegisub. In my opinion, the coolest thing here is Aegi
     - [Center Times](#center-times)
   - [Other Scripts](#other-scripts)
     - [Convert Folds](#convert-folds)
+    - [Fix KFX Boilerplate](#fix-kfx-boilerplate)
     - [Blender Export Scripts for After Effects Tracking Data](#blender-export-scripts-for-after-effects-tracking-data)
   - [See also](#see-also)
 
@@ -128,6 +130,17 @@ To use it, either
 - click the "From File" button to automatically read this line from the subtitle file. This only works if the file is saved on your disk.
 This will work on any version of Aegisub (i.e. an Aegisub version using extradata folds will be able to load folds from the resulting file), but in order for the folds to be displayed inside of Aegisub, you obviously need a build that supports extradata folds.
 
+### Fix KFX Boilerplate
+There is a large collection of old (stock templater) karaoke templates that all use the same boilerplate lines
+(which are often bad or even completely unnecessary, but that is another discussion).
+One of these boilerplate lines [broke after argument checking was added to the Lua utility libraries](https://github.com/TypesettingTools/Aegisub/issues/141#issuecomment-2561017082),
+which breaks these templates.
+This script automatically applies one of the simple workarounds to fix the template.
+
+Let me once again stress that the *proper* solution for such templates is to rewrite them to not need this boilerplate at all,
+using [a better templater](https://github.com/The0x539/Aegisub-Scripts/blob/trunk/doc/0x.KaraTemplater.md) if needed.
+I only wrote this script so certain people will stop complaining.
+
 ### Blender Export Scripts for After Effects Tracking Data
 You might be looking for my patched version of the After Effects Blender export script that adds the ability to export Power Pin data. This script has been superseded by Akatsumekusa's version, which is an almost complete rewrite with more features and a more user-friendly GUI. Go [here](https://github.com/Akatmks/Akatsumekusa-Aegisub-Scripts) to download this version.
 

macros/arch.FixKFXBoilerplate.moon

@@ -0,0 +1,66 @@
+export script_name = "Fix KFX Boilerplate"
+export script_description = "Fix certain errors in boilerplate lines in old KFX templates on new Aegisub versions"
+export script_author = "arch1t3cht"
+export script_namespace = "arch.FixKFXBoilerplate"
+export script_version = "1.0.0"
+
+haveDepCtrl, DependencyControl = pcall(require, "l0.DependencyControl")
+local depctrl
+if haveDepCtrl
+    depctrl = DependencyControl{
+        feed: "https://raw.githubusercontent.com/TypesettingTools/arch1t3cht-Aegisub-Scripts/main/DependencyControl.json",
+    }
+
+-- For now we just apply the least invasive fix of replacing _G.unicode.len(foo) with _G.unicode.len((foo)).
+-- If this turns out to miss too many files we can do something simpler like just patch _G.unicode.len with a wrapper function.
+
+find_matching_paren = (str, n) ->
+    return nil if str\sub(n, n) ~= "("
+
+    depth = 1
+
+    while n <= #str
+        n += 1
+        c = str\sub(n, n)
+
+        depth += 1 if c == "("
+        depth -= 1 if c == ")"
+
+        return n if depth == 0
+    return nil
+
+
+fix_boilerplate = (subs, sel) ->
+    patched = 0
+    for li, line in ipairs(subs)
+        continue unless line.class == "dialogue"
+        continue unless line.comment
+        continue unless line.effect\match("template") or line.effect\match("code")
+
+        while true
+            i = 1
+            newtext = line.text
+            while true
+                _, i = line.text\find("unicode.len(", i, true)
+                break if i == nil
+                matching = find_matching_paren(line.text, i)
+                matching2 = find_matching_paren(line.text, i + 1)
+
+                continue if matching == nil
+                continue if matching2 == matching - 1
+
+                newtext = line.text\sub(1, i) .. "(" .. line.text\sub(i + 1, matching) .. ")" .. line.text\sub(matching + 1)
+                patched += 1
+
+            break if newtext == line.text
+            line.text = newtext
+
+        subs[li] = line
+    
+    aegisub.log("Patched #{patched} instances of _G.unicode.len.")
+
+
+if haveDepCtrl
+    depctrl\registerMacro fix_boilerplate
+else
+    aegisub.register_macro(script_name, script_description, fix_boilerplate)