From cbc921e6d240ea4a79c61017dfa23a9604447f28 Mon Sep 17 00:00:00 2001
From: Oliver Geer <o@ogeer.org>
Date: Sun, 30 Aug 2026 23:19:58 +0100
Subject: [PATCH 1/6] Add TypeScript test file; Reorganise test files

---
 tests/automated/README.md                     |   7 ++
 tests/{ => automated}/afterform.html          |   0
 tests/{ => automated}/hljs.html               |  30 ++---
 tests/automated/index.html                    |  44 ++++++++
 tests/{ => automated}/prism.html              |  32 +++---
 tests/{ => automated}/tester.js               |   0
 tests/{ => automated}/tester.min.js           |   0
 tests/i18n/README.md                          |   9 ++
 tests/{i18n-common.js => i18n/common.js}      |   0
 .../common.min.js}                            |   0
 tests/{i18n-hljs.html => i18n/hljs.html}      |  32 +++---
 tests/{i18n.html => i18n/index.html}          |   4 +-
 tests/{i18n-prism.html => i18n/prism.html}    |  34 +++---
 tests/typescript/.gitignore                   |   1 +
 tests/typescript/README.md                    |   7 ++
 tests/typescript/example.ts                   | 105 ++++++++++++++++++
 16 files changed, 239 insertions(+), 66 deletions(-)
 create mode 100644 tests/automated/README.md
 rename tests/{ => automated}/afterform.html (100%)
 rename tests/{ => automated}/hljs.html (69%)
 create mode 100644 tests/automated/index.html
 rename tests/{ => automated}/prism.html (68%)
 rename tests/{ => automated}/tester.js (100%)
 rename tests/{ => automated}/tester.min.js (100%)
 create mode 100644 tests/i18n/README.md
 rename tests/{i18n-common.js => i18n/common.js} (100%)
 rename tests/{i18n-common.min.js => i18n/common.min.js} (100%)
 rename tests/{i18n-hljs.html => i18n/hljs.html} (75%)
 rename tests/{i18n.html => i18n/index.html} (89%)
 rename tests/{i18n-prism.html => i18n/prism.html} (74%)
 create mode 100644 tests/typescript/.gitignore
 create mode 100644 tests/typescript/README.md
 create mode 100644 tests/typescript/example.ts

diff --git a/tests/automated/README.md b/tests/automated/README.md
new file mode 100644
index 0000000..c155c35
--- /dev/null
+++ b/tests/automated/README.md
@@ -0,0 +1,7 @@
+# (Semi-)Automated Tests
+
+Carries out partially automated user interface tests to check that both the core components and the plugins work in some ways. It doesn't fully cover every scenario so you should test any code you change by hand, but it's good for quickly checking a wide range of functionality works.
+
+For each of `prism.html` and `hljs.html`, open the page, answer the browser popups you get, and see the results of testing at the end.
+
+The code currently relies on hardcoded wait periods, assuming the interface will respond in time, and meaning that if they don't, tests can fail. If tests fail unexpectedly, free up memory etc. on your computer, reload, and try again.
diff --git a/tests/afterform.html b/tests/automated/afterform.html
similarity index 100%
rename from tests/afterform.html
rename to tests/automated/afterform.html
diff --git a/tests/hljs.html b/tests/automated/hljs.html
similarity index 69%
rename from tests/hljs.html
rename to tests/automated/hljs.html
index 179e207..43e6f36 100644
--- a/tests/hljs.html
+++ b/tests/automated/hljs.html
@@ -15,23 +15,23 @@
     
 
     <!--Import code-input-->
-    <link rel="stylesheet" href="../code-input.css">
-    <script src="../code-input.js"></script>
+    <link rel="stylesheet" href="../../code-input.css">
+    <script src="../../code-input.js"></script>
 
     <!--Import code-input plugins-->
-    <script src="../plugins/auto-close-brackets.js"></script>
-    <script src="../plugins/autocomplete.js"></script>
-    <link rel="stylesheet" href="../plugins/autocomplete.css">
-    <link rel="stylesheet" href="../plugins/autogrow.css">
-    <script src="../plugins/autodetect.js"></script>
-    <script src="../plugins/find-and-replace.js"></script>
-    <link rel="stylesheet" href="../plugins/find-and-replace.css">
-    <script src="../plugins/go-to-line.js"></script>
-    <link rel="stylesheet" href="../plugins/go-to-line.css">
-    <script src="../plugins/indent.js"></script>
-    <script src="../plugins/select-token-callbacks.js"></script>
-    <script src="../plugins/special-chars.js"></script>
-    <link rel="stylesheet" href="../plugins/special-chars.css">
+    <script src="../../plugins/auto-close-brackets.js"></script>
+    <script src="../../plugins/autocomplete.js"></script>
+    <link rel="stylesheet" href="../../plugins/autocomplete.css">
+    <link rel="stylesheet" href="../../plugins/autogrow.css">
+    <script src="../../plugins/autodetect.js"></script>
+    <script src="../../plugins/find-and-replace.js"></script>
+    <link rel="stylesheet" href="../../plugins/find-and-replace.css">
+    <script src="../../plugins/go-to-line.js"></script>
+    <link rel="stylesheet" href="../../plugins/go-to-line.css">
+    <script src="../../plugins/indent.js"></script>
+    <script src="../../plugins/select-token-callbacks.js"></script>
+    <script src="../../plugins/special-chars.js"></script>
+    <link rel="stylesheet" href="../../plugins/special-chars.css">
 
     <script src="tester.js"></script>
 </head>
diff --git a/tests/automated/index.html b/tests/automated/index.html
new file mode 100644
index 0000000..4b384a5
--- /dev/null
+++ b/tests/automated/index.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>code-input Tester</title>
+
+    <!--Import Highlight.JS-->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css" id="theme-stylesheet">
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/xml.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/css.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/javascript.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/python.min.js"></script>
+
+
+    <!--Import code-input-->
+    <link rel="stylesheet" href="../../code-input.css">
+    <script src="../../code-input.js"></script>
+
+    <!--Import code-input plugins-->
+    <script src="../../plugins/auto-close-brackets.js"></script>
+    <script src="../../plugins/autocomplete.js"></script>
+    <link rel="stylesheet" href="../../plugins/autocomplete.css">
+    <link rel="stylesheet" href="../../plugins/autogrow.css">
+    <script src="../../plugins/autodetect.js"></script>
+    <script src="../../plugins/find-and-replace.js"></script>
+    <link rel="stylesheet" href="../../plugins/find-and-replace.css">
+    <script src="../../plugins/go-to-line.js"></script>
+    <link rel="stylesheet" href="../../plugins/go-to-line.css">
+    <script src="../../plugins/indent.js"></script>
+    <script src="../../plugins/select-token-callbacks.js"></script>
+    <script src="../../plugins/special-chars.js"></script>
+    <link rel="stylesheet" href="../../plugins/special-chars.css">
+
+    <script src="tester.js"></script>
+</head>
+<body>
+    <ul>
+        <li><a href="prism.html">Test code-input.js + Prism.js</a></li>
+        <li><a href="hljs.html">Test code-input.js + highlight.js</a></li>
+    </ul>
+</body>
+</html>
diff --git a/tests/prism.html b/tests/automated/prism.html
similarity index 68%
rename from tests/prism.html
rename to tests/automated/prism.html
index 591604b..1832714 100644
--- a/tests/prism.html
+++ b/tests/automated/prism.html
@@ -10,27 +10,27 @@
     <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/autoloader/prism-autoloader.min.js"></script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/line-numbers/prism-line-numbers.min.js"></script>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/line-numbers/prism-line-numbers.min.css">
-    <script src="prism-match-braces-compatibility.js"></script>
+    <script src="../prism-match-braces-compatibility.js"></script>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/match-braces/prism-match-braces.min.css">
 
     <!--Import code-input-->
-    <link rel="stylesheet" href="../code-input.css">
-    <script src="../code-input.js"></script>
+    <link rel="stylesheet" href="../../code-input.css">
+    <script src="../../code-input.js"></script>
 
     <!--Import code-input plugins-->
-    <script src="../plugins/auto-close-brackets.js"></script>
-    <script src="../plugins/autocomplete.js"></script>
-    <link rel="stylesheet" href="../plugins/autocomplete.css">
-    <link rel="stylesheet" href="../plugins/autogrow.css">
-    <script src="../plugins/find-and-replace.js"></script>
-    <link rel="stylesheet" href="../plugins/find-and-replace.css">
-    <script src="../plugins/go-to-line.js"></script>
-    <link rel="stylesheet" href="../plugins/go-to-line.css">
-    <script src="../plugins/indent.js"></script>
-    <link rel="stylesheet" href="../plugins/prism-line-numbers.css">
-    <script src="../plugins/select-token-callbacks.js"></script>
-    <script src="../plugins/special-chars.js"></script>
-    <link rel="stylesheet" href="../plugins/special-chars.css">
+    <script src="../../plugins/auto-close-brackets.js"></script>
+    <script src="../../plugins/autocomplete.js"></script>
+    <link rel="stylesheet" href="../../plugins/autocomplete.css">
+    <link rel="stylesheet" href="../../plugins/autogrow.css">
+    <script src="../../plugins/find-and-replace.js"></script>
+    <link rel="stylesheet" href="../../plugins/find-and-replace.css">
+    <script src="../../plugins/go-to-line.js"></script>
+    <link rel="stylesheet" href="../../plugins/go-to-line.css">
+    <script src="../../plugins/indent.js"></script>
+    <link rel="stylesheet" href="../../plugins/prism-line-numbers.css">
+    <script src="../../plugins/select-token-callbacks.js"></script>
+    <script src="../../plugins/special-chars.js"></script>
+    <link rel="stylesheet" href="../../plugins/special-chars.css">
 
     <script src="tester.js"></script>
 </head>
diff --git a/tests/tester.js b/tests/automated/tester.js
similarity index 100%
rename from tests/tester.js
rename to tests/automated/tester.js
diff --git a/tests/tester.min.js b/tests/automated/tester.min.js
similarity index 100%
rename from tests/tester.min.js
rename to tests/automated/tester.min.js
diff --git a/tests/i18n/README.md b/tests/i18n/README.md
new file mode 100644
index 0000000..f032d90
--- /dev/null
+++ b/tests/i18n/README.md
@@ -0,0 +1,9 @@
+# Demos with Internationalisation
+
+A playground of `<code-input>` elements for manual testing.
+
+Includes various aspects not in the semi-automated tests:
+
+- "rtl" elements should have right-to-left text decoration;
+- plugins' user interface elements should be translated into Spanish;
+- code-input elements' contents include Unicode text in various language.
diff --git a/tests/i18n-common.js b/tests/i18n/common.js
similarity index 100%
rename from tests/i18n-common.js
rename to tests/i18n/common.js
diff --git a/tests/i18n-common.min.js b/tests/i18n/common.min.js
similarity index 100%
rename from tests/i18n-common.min.js
rename to tests/i18n/common.min.js
diff --git a/tests/i18n-hljs.html b/tests/i18n/hljs.html
similarity index 75%
rename from tests/i18n-hljs.html
rename to tests/i18n/hljs.html
index 70c64cc..0705eeb 100644
--- a/tests/i18n-hljs.html
+++ b/tests/i18n/hljs.html
@@ -15,23 +15,23 @@
 
 
         <!--Import code-input-->
-        <link rel="stylesheet" href="../code-input.css">
-        <script src="../code-input.js"></script>
+        <link rel="stylesheet" href="../../code-input.css">
+        <script src="../../code-input.js"></script>
 
         <!--Import code-input plugins-->
-        <script src="../plugins/auto-close-brackets.js"></script>
-        <script src="../plugins/autocomplete.js"></script>
-        <script src="../plugins/autodetect.js"></script>
-        <link rel="stylesheet" href="../plugins/autocomplete.css">
-        <script src="../plugins/find-and-replace.js"></script>
-        <link rel="stylesheet" href="../plugins/find-and-replace.css">
-        <script src="../plugins/go-to-line.js"></script>
-        <link rel="stylesheet" href="../plugins/go-to-line.css">
-        <script src="../plugins/indent.js"></script>
-        <link rel="stylesheet" href="../plugins/prism-line-numbers.css">
-        <script src="../plugins/select-token-callbacks.js"></script>
-        <script src="../plugins/special-chars.js"></script>
-        <link rel="stylesheet" href="../plugins/special-chars.css">
+        <script src="../../plugins/auto-close-brackets.js"></script>
+        <script src="../../plugins/autocomplete.js"></script>
+        <script src="../../plugins/autodetect.js"></script>
+        <link rel="stylesheet" href="../../plugins/autocomplete.css">
+        <script src="../../plugins/find-and-replace.js"></script>
+        <link rel="stylesheet" href="../../plugins/find-and-replace.css">
+        <script src="../../plugins/go-to-line.js"></script>
+        <link rel="stylesheet" href="../../plugins/go-to-line.css">
+        <script src="../../plugins/indent.js"></script>
+        <link rel="stylesheet" href="../../plugins/prism-line-numbers.css">
+        <script src="../../plugins/select-token-callbacks.js"></script>
+        <script src="../../plugins/special-chars.js"></script>
+        <link rel="stylesheet" href="../../plugins/special-chars.css">
 
         <!--Register templates-->
 
@@ -47,7 +47,7 @@
         <code-input dir="rtl" template="hljs+" language="markdown"><textarea data-code-input-fallback placeholder="hljs rtl"></textarea></code-input>
         <code-input dir="ltr" template="hljs+" language="markdown"><textarea data-code-input-fallback placeholder="hljs ltr"></textarea></code-input>
 
-	<script src="i18n-common.js"></script>
+	<script src="common.js"></script>
         <script>
             codeInput.registerTemplate("hljs", new codeInput.templates.Hljs(hljs, []));
             codeInput.registerTemplate("hljs+", new codeInput.templates.Hljs(hljs, [
diff --git a/tests/i18n.html b/tests/i18n/index.html
similarity index 89%
rename from tests/i18n.html
rename to tests/i18n/index.html
index e73e3b2..19376fb 100644
--- a/tests/i18n.html
+++ b/tests/i18n/index.html
@@ -20,7 +20,7 @@
         <textarea dir="rtl" placeholder="textarea rtl"></textarea>
         <textarea dir="ltr" placeholder="textarea ltr"></textarea>
 	<p>Prism.js and highlight.js embedded separately: not in same page because their styles can interfere with each other whether or not code-input.js is present.</p>
-	<iframe src="i18n-prism.html"></iframe> 
-	<iframe src="i18n-hljs.html"></iframe> 
+	<iframe src="prism.html"></iframe>
+	<iframe src="hljs.html"></iframe>
     </body>
 </html>
diff --git a/tests/i18n-prism.html b/tests/i18n/prism.html
similarity index 74%
rename from tests/i18n-prism.html
rename to tests/i18n/prism.html
index 7778d02..e620a64 100644
--- a/tests/i18n-prism.html
+++ b/tests/i18n/prism.html
@@ -11,27 +11,27 @@
         <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/autoloader/prism-autoloader.min.js"></script>
         <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/line-numbers/prism-line-numbers.min.js"></script>
         <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/line-numbers/prism-line-numbers.min.css">
-        <script src="prism-match-braces-compatibility.js"></script>
+        <script src="../prism-match-braces-compatibility.js"></script>
         <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/match-braces/prism-match-braces.min.css">
 
         <!--Import code-input-->
-        <link rel="stylesheet" href="../code-input.css">
-        <script src="../code-input.js"></script>
+        <link rel="stylesheet" href="../../code-input.css">
+        <script src="../../code-input.js"></script>
 
         <!--Import code-input plugins-->
-        <script src="../plugins/auto-close-brackets.js"></script>
-        <script src="../plugins/autocomplete.js"></script>
-        <script src="../plugins/autodetect.js"></script>
-        <link rel="stylesheet" href="../plugins/autocomplete.css">
-        <script src="../plugins/find-and-replace.js"></script>
-        <link rel="stylesheet" href="../plugins/find-and-replace.css">
-        <script src="../plugins/go-to-line.js"></script>
-        <link rel="stylesheet" href="../plugins/go-to-line.css">
-        <script src="../plugins/indent.js"></script>
-        <link rel="stylesheet" href="../plugins/prism-line-numbers.css">
-        <script src="../plugins/select-token-callbacks.js"></script>
-        <script src="../plugins/special-chars.js"></script>
-        <link rel="stylesheet" href="../plugins/special-chars.css">
+        <script src="../../plugins/auto-close-brackets.js"></script>
+        <script src="../../plugins/autocomplete.js"></script>
+        <script src="../../plugins/autodetect.js"></script>
+        <link rel="stylesheet" href="../../plugins/autocomplete.css">
+        <script src="../../plugins/find-and-replace.js"></script>
+        <link rel="stylesheet" href="../../plugins/find-and-replace.css">
+        <script src="../../plugins/go-to-line.js"></script>
+        <link rel="stylesheet" href="../../plugins/go-to-line.css">
+        <script src="../../plugins/indent.js"></script>
+        <link rel="stylesheet" href="../../plugins/prism-line-numbers.css">
+        <script src="../../plugins/select-token-callbacks.js"></script>
+        <script src="../../plugins/special-chars.js"></script>
+        <link rel="stylesheet" href="../../plugins/special-chars.css">
 
         <!--Register templates-->
 
@@ -47,7 +47,7 @@
         <code-input dir="rtl" template="prism+" language="markdown"><textarea data-code-input-fallback placeholder="prism rtl"></textarea></code-input>
         <code-input dir="ltr" template="prism+" language="markdown"><textarea data-code-input-fallback placeholder="prism ltr"></textarea></code-input>
 
-	<script src="i18n-common.js"></script>
+	<script src="common.js"></script>
         <script>
             codeInput.registerTemplate("prism", new codeInput.templates.Prism(Prism, []));
             codeInput.registerTemplate("prism+", new codeInput.templates.Prism(Prism, [
diff --git a/tests/typescript/.gitignore b/tests/typescript/.gitignore
new file mode 100644
index 0000000..a6cbb3c
--- /dev/null
+++ b/tests/typescript/.gitignore
@@ -0,0 +1 @@
+example.js
diff --git a/tests/typescript/README.md b/tests/typescript/README.md
new file mode 100644
index 0000000..671835f
--- /dev/null
+++ b/tests/typescript/README.md
@@ -0,0 +1,7 @@
+# Typescript Type Declaration Testing
+
+To check for bugs in code-input.d.ts, and in ESM generation of d.ts files:
+
+1. Generate ECMAScript modules in the esm/ directory, using esm/README.md
+2. Compile this TypeScript file, by changing to its directory and running `tsc example.ts --lib dom,es6`
+3. Fix any compilation bugs that occur
diff --git a/tests/typescript/example.ts b/tests/typescript/example.ts
new file mode 100644
index 0000000..27efb10
--- /dev/null
+++ b/tests/typescript/example.ts
@@ -0,0 +1,105 @@
+// To check for bugs in code-input.d.ts, and in ESM generation of d.ts files:
+// 1. Generate ECMAScript modules in the esm/ directory, using esm/README.md
+// 2. Compile this TypeScript file, by changing to its directory and running `tsc example.ts --lib dom,es6`
+// 3. Fix any compilation bugs that occur
+
+
+import { registerTemplate, CodeInput, Template, Plugin } from "../../esm/code-input.mjs";
+
+// Check CodeInput extends HTMLElement; in real usage use document.createElement("code-input")
+// rather than this constructor.
+(new CodeInput()) as HTMLElement;
+
+import HLJSTemplate from "../../esm/templates/hljs.mjs";
+import PrismTemplate from "../../esm/templates/prism.mjs";
+
+import AutoCloseBrackets from "../../esm/plugins/auto-close-brackets.mjs";
+import Autocomplete from "../../esm/plugins/autocomplete.mjs";
+import Autodetect from "../../esm/plugins/autodetect.mjs";
+import FindAndReplace from "../../esm/plugins/find-and-replace.mjs";
+import GoToLine from "../../esm/plugins/go-to-line.mjs";
+import Indent from "../../esm/plugins/indent.mjs";
+import SelectTokenCallbacks from "../../esm/plugins/select-token-callbacks.mjs";
+import SpecialChars from "../../esm/plugins/special-chars.mjs";
+import Test from "../../esm/plugins/test.mjs";
+
+const stubHLJS = { highlightElement: function(codeElement) {} };
+const stubPrism = { highlightElement: function(codeElement) {} };
+
+const findAndReplaceTranslations = {
+    start: "Buscar términos en su código.",
+    none: "No hay sucesos",
+    oneFound: "1 suceso encontrado.",
+    matchIndex: (index, count) => `${index} de ${count} sucesos.`,
+    error: (message) => `Error: ${message}`,
+    infiniteLoopError: "Causa un ciclo infinito",
+    closeDialog: "Cerrar el Diálogo y Regresar al Editor",
+    findPlaceholder: "Buscar",
+    findCaseSensitive: "Prestar atención a las minúsculas/mayúsculas",
+    findRegExp: "Utilizar expresión regular de JavaScript",
+    replaceTitle: "Reemplazar",
+    replacePlaceholder: "Reemplazar con",
+    findNext: "Buscar Suceso Próximo",
+    findPrevious: "Buscar Suceso Previo",
+    replaceActionShort: "Reemplazar",
+    replaceAction: "Reemplazar este Suceso",
+    replaceAllActionShort: "Reemplazar Todos",
+    replaceAllAction: "Reemplazar Todos los Sucesos"
+};
+const goToLineTranslations = {
+    closeDialog: "Cerrar el Diálogo y Regresar al Editor",
+    input: "Línea:Columno o Línea luego Retorno",
+    guidanceFormat: "Formato incorrecto. Ingresa un número de línea (por ej. 1) o un número de línea luego dos puntos luego un número de columno (por ej. 1:3).",
+    guidanceLineRange: (current, max) => `Número de línea (actualmente ${current}) debería ser entre 1 y ${max}.`,
+    guidanceColumnRange: (line, current, max) => `En la línea número ${line}, número de columno (actualmente ${current}) debería ser entre 1 y ${max}.`,
+    guidanceValidLine: (line) => `Tecla Retorno para ir a línea número ${line}.`,
+    guidanceValidColumn: (line, column) => `Tecla Retorno para ir a línea número ${line}, columno número ${column}.`,
+};
+const indentTranslations = {
+    tabForIndentation: "Tabulador y Mayús-Tabulador actualmente para la indentación. Tecla Escape para activar la navegación por el teclado.",
+    tabForNavigation: "Tabulador y Mayús-Tabulador actualmente para la navegación por el teclado. Tecla para activar la indentación.",
+};
+
+const tokenSelectorCallbacks1 = new SelectTokenCallbacks.TokenSelectorCallbacks(
+    function(token: HTMLElement) {
+        // Stub
+    },
+    function(tokenContainer: HTMLElement) {
+        // Stub
+    }
+);
+const tokenSelectorCallbacks2 = SelectTokenCallbacks.TokenSelectorCallbacks.createClassSynchronisation("selected");
+
+const plugins1: Array<Plugin> = [
+    new AutoCloseBrackets({"(": ")"}),
+    new Autocomplete(function(popupElem: HTMLElement, textareaElem: HTMLTextAreaElement, selectionEnd: number, selectionStart: number) {
+        popupElem.textContent = textareaElem.value.substring(selectionStart, selectionEnd);
+    }),
+    new Autodetect(),
+    new FindAndReplace(false, false, findAndReplaceTranslations),
+    new GoToLine(false, goToLineTranslations),
+    new Indent(true, 4, {"(": ")"}, true, indentTranslations),
+    new SelectTokenCallbacks(tokenSelectorCallbacks1, true, true, true, false, true, false),
+    new SpecialChars(true, false, /(?!\n)(?!\t)[\u{0000}-\u{001F}]|[\u{007F}-\u{009F}]|[\u{0200}-\u{FFFF}]/ug),
+    new Test()
+];
+
+const plugins2: Array<Plugin> = [
+    new AutoCloseBrackets(),
+    new Autocomplete(function(popupElem: HTMLElement, textareaElem: HTMLTextAreaElement, selectionEnd: number) {
+        popupElem.textContent = textareaElem.value.substring(0, selectionEnd);
+    }),
+    // No Autodetect, since passed to Prism.js
+    new FindAndReplace(),
+    new GoToLine(),
+    new Indent(),
+    new SelectTokenCallbacks(tokenSelectorCallbacks2),
+    new SpecialChars(),
+    new Test()
+];
+
+const hljsTemplate: Template = new HLJSTemplate(stubHLJS, plugins1);
+const prismTemplate: Template = new PrismTemplate(stubPrism, plugins2);
+
+registerTemplate("hljs", hljsTemplate);
+registerTemplate("prism", prismTemplate);

From f10f4973b696ac0e179ab75192c4ebc65aec2cf1 Mon Sep 17 00:00:00 2001
From: Oliver Geer <o@ogeer.org>
Date: Sun, 6 Sep 2026 23:05:21 +0100
Subject: [PATCH 2/6] Fix TypeScript errors in d.ts and generate.sh, with just
 a few uncopyrightable peeks at #233

---
 code-input.d.ts                              |   2 +-
 esm/README.md                                |   2 +-
 esm/generate.sh                              |  67 +++++++++---
 tests/typescript/.gitignore                  |   3 +-
 tests/typescript/{example.ts => example1.ts} |   6 +-
 tests/typescript/example2.ts                 | 105 +++++++++++++++++++
 6 files changed, 165 insertions(+), 20 deletions(-)
 rename tests/typescript/{example.ts => example1.ts} (96%)
 create mode 100644 tests/typescript/example2.ts

diff --git a/code-input.d.ts b/code-input.d.ts
index 3c398ea..4123af5 100644
--- a/code-input.d.ts
+++ b/code-input.d.ts
@@ -424,7 +424,7 @@ export class CodeInput extends HTMLTextAreaElement { // Tries to implement texta
   /**
    * When the code-input's template is registered, this contains its codeInput.Template object.
    */
-  templateObject?: readonly Template
+  /*readonly*/ templateObject?: Template // `readonly` commented for backwards compatibility
   /**
    * Exposed child textarea element for user to input code in; in this version of code-input you shouldn't need to access
    * it because most textarea functionality is present on the code-input element itself.
diff --git a/esm/README.md b/esm/README.md
index d65b6ac..16261d1 100644
--- a/esm/README.md
+++ b/esm/README.md
@@ -7,7 +7,7 @@ If you are using Yarn, NPM, or a similar package manager, the files should have
 Otherwise, after changing directory to the one containing this file:
 
 - If you have Node.js installed, run `node generate.mjs`.
-- If you don't have Node.js installed but are on a POSIX-like system with `bash`/`zsh`, run `sh ./generate.sh`.
+- If you don't have Node.js installed but are on a POSIX-like system with `bash`/`zsh`, run `sh ./generate.sh`. (This uses features like `grep -o`, so won't work on *absolutely all* POSIX systems. It works on many computers though, so try it out first!) **Security-wise, we don't prevent JavaScript**
 - If neither of the above are true, install Node.js or (slightly harder; look online) a POSIX/"Linux" compatible shell.
 
 ## Extra Information
diff --git a/esm/generate.sh b/esm/generate.sh
index 7d69021..bcc23d5 100644
--- a/esm/generate.sh
+++ b/esm/generate.sh
@@ -10,11 +10,11 @@ AUTOGENERATED_NOTICE="// NOTICE: This code is @generated from code outside the e
     echo "" >> code-input.mjs
     # Imports: Nothing
     # Code before first templates block
-    head -$(($(sed -n "/ESM-SUPPORT-START-TEMPLATES-BLOCK-1/=" ../code-input.js | head -1) - 1)) ../code-input.js >> code-input.mjs
+    head -n $(($(sed -n "/ESM-SUPPORT-START-TEMPLATES-BLOCK-1/=" ../code-input.js | head -n 1) - 1)) ../code-input.js >> code-input.mjs
     # Code before second templates block, after first templates block
-    head -$(($(sed -n "/ESM-SUPPORT-START-TEMPLATES-BLOCK-2/=" ../code-input.js | head -1) - 1)) ../code-input.js | tail --line=+$(($(sed -n "/ESM-SUPPORT-END-TEMPLATES-BLOCK-1/=" ../code-input.js | head -1) + 1)) >> code-input.mjs
+    head -n $(($(sed -n "/ESM-SUPPORT-START-TEMPLATES-BLOCK-2/=" ../code-input.js | head -n 1) - 1)) ../code-input.js | tail --line=+$(($(sed -n "/ESM-SUPPORT-END-TEMPLATES-BLOCK-1/=" ../code-input.js | head -n 1) + 1)) >> code-input.mjs
     # Code after second templates block
-    tail --line=+$(($(sed -n "/ESM-SUPPORT-END-TEMPLATES-BLOCK-2/=" ../code-input.js | head -1) + 1)) ../code-input.js >> code-input.mjs
+    tail --line=+$(($(sed -n "/ESM-SUPPORT-END-TEMPLATES-BLOCK-2/=" ../code-input.js | head -n 1) + 1)) ../code-input.js >> code-input.mjs
     # Exports
     echo "export const Plugin = codeInput.Plugin;" >> code-input.mjs
     echo "export const Template = codeInput.Template;" >> code-input.mjs
@@ -27,12 +27,39 @@ AUTOGENERATED_NOTICE="// NOTICE: This code is @generated from code outside the e
     echo "" >> code-input.d.mts
     # Miss out no-ESM specific code at the top
     # Code before first namespace, after no-ESM specific code
-    head -$(($(sed -n "/ESM-SUPPORT-START-NAMESPACE-1/=" ../code-input.d.ts | head -1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-END-NOESM-SPECIFIC/=" ../code-input.d.ts | head -1) + 1)) >> code-input.d.mts
+    head -n $(($(sed -n "/ESM-SUPPORT-START-NAMESPACE-1/=" ../code-input.d.ts | head -n 1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-END-NOESM-SPECIFIC/=" ../code-input.d.ts | head -n 1) + 1)) >> code-input.d.mts
     # Code before second namespace, after first namespace
-    head -$(($(sed -n "/ESM-SUPPORT-START-NAMESPACE-2/=" ../code-input.d.ts | head -1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-END-NAMESPACE-1/=" ../code-input.d.ts | head -1) + 1)) >> code-input.d.mts
+    head -n $(($(sed -n "/ESM-SUPPORT-START-NAMESPACE-2/=" ../code-input.d.ts | head -n 1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-END-NAMESPACE-1/=" ../code-input.d.ts | head -n 1) + 1)) >> code-input.d.mts
     # Code after second namespace
-    tail --line=+$(($(sed -n "/ESM-SUPPORT-END-NAMESPACE-2/=" ../code-input.d.ts | head -1) + 1)) ../code-input.d.ts >> code-input.d.mts
-    echo "export default { Plugin, Template, CodeInput, registerTemplate };" >> code-input.d.mts
+    tail --line=+$(($(sed -n "/ESM-SUPPORT-END-NAMESPACE-2/=" ../code-input.d.ts | head -n 1) + 1)) ../code-input.d.ts >> code-input.d.mts
+    echo "
+
+// Prepare the default export:
+
+// Values under the default export
+declare const _default: {
+    Plugin: typeof Plugin;
+    Template: typeof Template;
+    CodeInput: typeof CodeInput;
+    registerTemplate: typeof registerTemplate;
+}
+
+// Type aliases to prevent ambiguous 'Plugin = Plugin'
+declare type _Plugin = Plugin;
+declare type _Template = Template;
+declare type _CodeInput = CodeInput;
+// Types under the default export
+declare namespace _default {
+    export type Plugin = _Plugin;
+    export type Template = _Template;
+    export type CodeInput = _CodeInput;
+}
+
+export default _default;" >> code-input.d.mts
+#declare type _default.Plugin = Plugin;
+#declare type _default.Template = Template;
+#declare type _default.CodeInput = CodeInput;
+
 
 # Templates
 mkdir -p templates
@@ -45,9 +72,9 @@ mkdir -p templates
     echo "import { Template } from \"../code-input.mjs\";" >> templates/$0.mjs
 
     # Code after start and before end of this template, making use of the imported Template, not codeInput.Template
-    head -$(($(sed -n "/ESM-SUPPORT-END-TEMPLATE-$0/=" ../code-input.js | head -1) - 1)) ../code-input.js | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-TEMPLATE-$0/=" ../code-input.js | head -1) + 1)) | sed "s/codeInput\.Template/Template/g" >> templates/$0.mjs
+    head -n $(($(sed -n "/ESM-SUPPORT-END-TEMPLATE-$0/=" ../code-input.js | head -n 1) - 1)) ../code-input.js | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-TEMPLATE-$0/=" ../code-input.js | head -n 1) + 1)) | sed "s/codeInput\.Template/Template/g" >> templates/$0.mjs
 
-    TEMPLATE_CLASS_NAME="$(grep -Eo "class [a-zA-Z]+ extends Template" templates/$0.mjs | head -1 | sed "s/class //" | sed "s/ extends Template//")";
+    TEMPLATE_CLASS_NAME="$(grep -Eo "class [a-zA-Z]+ extends Template" templates/$0.mjs | head -n 1 | sed "s/class //" | sed "s/ extends Template//")";
     # Export.
     echo "export default $TEMPLATE_CLASS_NAME;" >> templates/$0.mjs
 
@@ -59,10 +86,10 @@ mkdir -p templates
     echo $1 > templates/$0.d.mts;
     echo "" >> templates/$0.d.mts;
     # Imports
-    echo "import { Template, Plugin } from \"../code-input.d.mts\";" >> templates/$0.d.mts
+    echo "import type { Template, Plugin } from \"../code-input.d.mts\";" >> templates/$0.d.mts
     # Code after start and before end of this template, making use of the imported Template, not codeInput.Template, and the imported Plugin, not codeInput.Plugin, exporting the class as default
     # export default class replacement should work but won"t leave indentation as JS version does.
-    head -$(($(sed -n "/ESM-SUPPORT-END-TEMPLATE-$0/=" ../code-input.d.ts | head -1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-TEMPLATE-$0/=" ../code-input.d.ts | head -1) + 1)) | sed "s/codeInput\.Template/Template/g" | sed "s/codeInput\.Plugin/Plugin/g" | sed -E "s/^[[:space:]]*class /export default class /" >> templates/$0.d.mts
+    head -n $(($(sed -n "/ESM-SUPPORT-END-TEMPLATE-$0/=" ../code-input.d.ts | head -n 1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-TEMPLATE-$0/=" ../code-input.d.ts | head -n 1) + 1)) | sed "s/codeInput\.Template/Template/g" | sed "s/codeInput\.Plugin/Plugin/g" | sed -E "s/^[[:space:]]*class /export default class /" >> templates/$0.d.mts
 
     # $0 is the template name, $1 is the autogenerated notice
     ' "%" "$AUTOGENERATED_NOTICE"
@@ -77,11 +104,11 @@ mkdir -p plugins
     # Imports
     echo "import { Plugin } from \"../code-input.mjs\";" >> plugins/$0.mjs
     # Plugin syntax is to be stored in an object; do so temporarily.
-    echo "let plugins = {};" >> plugins/$0.mjs
+    echo "let plugins = {};" >> plugins/$0.mjs;
     # Code from this plugin"s file, making use of the imported Plugin, not codeInput.Plugin, and of the created plugins object, not codeInput.plugins
     cat ../plugins/$0.js | sed "s/codeInput\.Plugin/Plugin/g" | sed "s/codeInput\.plugins/plugins/g" >> plugins/$0.mjs;
 
-    PLUGIN_CLASS_NAME="$(grep -Eo "codeInput\.plugins\.[a-zA-Z]+" ../plugins/$0.js | head -1 | sed "s/codeInput\.plugins\.//")";
+    PLUGIN_CLASS_NAME="$(grep -Eo "codeInput\.plugins\.[a-zA-Z]+" ../plugins/$0.js | head -n 1 | sed "s/codeInput\.plugins\.//")";
     # Export.
     echo "" >> plugins/$0.mjs;
     echo "export default plugins.$PLUGIN_CLASS_NAME;" >> plugins/$0.mjs;
@@ -94,10 +121,20 @@ mkdir -p plugins
     echo $1 > plugins/$0.d.mts;
     echo "" >> plugins/$0.d.mts;
     # Imports
-    echo "import { Plugin, CodeInput } from \"../code-input.d.mts\";" >> plugins/$0.d.mts
+    echo "import type { Plugin, CodeInput } from \"../code-input.d.mts\";" >> plugins/$0.d.mts
     # Code after start and before end of this template, making use of the imported Plugin, not codeInput.Plugin and the imported CodeInput, not codeInput.CodeInput, exporting the class as default
     # export default class replacement should work but won"t leave indentation as JS version does.
-    head -$(($(sed -n "/ESM-SUPPORT-END-PLUGIN-$0/=" ../code-input.d.ts | head -1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-PLUGIN-$0/=" ../code-input.d.ts | head -1) + 1)) | sed "s/codeInput\.Plugin/Plugin/g" | sed "s/codeInput\.CodeInput/CodeInput/g" | sed -E "s/^[[:space:]]*class /export default class /" >> plugins/$0.d.mts
+    head -n $(($(sed -n "/ESM-SUPPORT-END-PLUGIN-$0/=" ../code-input.d.ts | head -n 1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-PLUGIN-$0/=" ../code-input.d.ts | head -n 1) + 1)) | sed "s/codeInput\.Plugin/Plugin/g" | sed "s/codeInput\.CodeInput/CodeInput/g" >> plugins/$0.d.mts;
+
+    # Declare the first class defined in the file and if it exists the namespace with the
+    # same name, then export it at the end of the file so the class and namespace are
+    # merged if necessary.
+    classname=$(grep -Eo "^ *class [A-Za-z]+" plugins/$0.d.mts | head -n 1 | sed "s/^ *class //");
+
+    cat plugins/$0.d.mts | sed "s/class ${classname} /declare class ${classname} /g" | sed "s/namespace ${classname} /declare namespace ${classname} /g" | sed "s/codeInput\.plugins\.${classname}/${classname}/g" | sed "s/prevname/oldname/g" >> plugins/$0.new.d.mts;
+    mv plugins/$0.new.d.mts plugins/$0.d.mts;
+
+    echo "export default ${classname};" >> plugins/$0.d.mts;
 
     # $0 is the plugin name, $1 is the autogenerated notice
     ' "%" "$AUTOGENERATED_NOTICE"
diff --git a/tests/typescript/.gitignore b/tests/typescript/.gitignore
index a6cbb3c..d602a1c 100644
--- a/tests/typescript/.gitignore
+++ b/tests/typescript/.gitignore
@@ -1 +1,2 @@
-example.js
+example1.js
+example2.js
diff --git a/tests/typescript/example.ts b/tests/typescript/example1.ts
similarity index 96%
rename from tests/typescript/example.ts
rename to tests/typescript/example1.ts
index 27efb10..69697e7 100644
--- a/tests/typescript/example.ts
+++ b/tests/typescript/example1.ts
@@ -1,6 +1,8 @@
+// Example 1: imports { registerTemplate, CodeInput, Template, Plugin }
+
 // To check for bugs in code-input.d.ts, and in ESM generation of d.ts files:
 // 1. Generate ECMAScript modules in the esm/ directory, using esm/README.md
-// 2. Compile this TypeScript file, by changing to its directory and running `tsc example.ts --lib dom,es6`
+// 2. Compile each TypeScript file, by changing to its directory and running `tsc example.ts --lib dom,es6`
 // 3. Fix any compilation bugs that occur
 
 
@@ -80,7 +82,7 @@ const plugins1: Array<Plugin> = [
     new GoToLine(false, goToLineTranslations),
     new Indent(true, 4, {"(": ")"}, true, indentTranslations),
     new SelectTokenCallbacks(tokenSelectorCallbacks1, true, true, true, false, true, false),
-    new SpecialChars(true, false, /(?!\n)(?!\t)[\u{0000}-\u{001F}]|[\u{007F}-\u{009F}]|[\u{0200}-\u{FFFF}]/ug),
+    new SpecialChars(true, false, /[^\n\t ]/g),
     new Test()
 ];
 
diff --git a/tests/typescript/example2.ts b/tests/typescript/example2.ts
new file mode 100644
index 0000000..a43b00a
--- /dev/null
+++ b/tests/typescript/example2.ts
@@ -0,0 +1,105 @@
+// To check for bugs in code-input.d.ts, and in ESM generation of d.ts files:
+// 1. Generate ECMAScript modules in the esm/ directory, using esm/README.md
+// 2. Compile this TypeScript file, by changing to its directory and running `tsc example.ts --lib dom,es6`
+// 3. Fix any compilation bugs that occur
+
+
+import codeInput from "../../esm/code-input.mjs";
+
+// Check CodeInput extends HTMLElement; in real usage use document.createElement("code-input")
+// rather than this constructor.
+(new codeInput.CodeInput()) as HTMLElement;
+
+import HLJSTemplate from "../../esm/templates/hljs.mjs";
+import PrismTemplate from "../../esm/templates/prism.mjs";
+
+import AutoCloseBrackets from "../../esm/plugins/auto-close-brackets.mjs";
+import Autocomplete from "../../esm/plugins/autocomplete.mjs";
+import Autodetect from "../../esm/plugins/autodetect.mjs";
+import FindAndReplace from "../../esm/plugins/find-and-replace.mjs";
+import GoToLine from "../../esm/plugins/go-to-line.mjs";
+import Indent from "../../esm/plugins/indent.mjs";
+import SelectTokenCallbacks from "../../esm/plugins/select-token-callbacks.mjs";
+import SpecialChars from "../../esm/plugins/special-chars.mjs";
+import Test from "../../esm/plugins/test.mjs";
+
+const stubHLJS = { highlightElement: function(codeElement) {} };
+const stubPrism = { highlightElement: function(codeElement) {} };
+
+const findAndReplaceTranslations = {
+    start: "Buscar términos en su código.",
+    none: "No hay sucesos",
+    oneFound: "1 suceso encontrado.",
+    matchIndex: (index, count) => `${index} de ${count} sucesos.`,
+    error: (message) => `Error: ${message}`,
+    infiniteLoopError: "Causa un ciclo infinito",
+    closeDialog: "Cerrar el Diálogo y Regresar al Editor",
+    findPlaceholder: "Buscar",
+    findCaseSensitive: "Prestar atención a las minúsculas/mayúsculas",
+    findRegExp: "Utilizar expresión regular de JavaScript",
+    replaceTitle: "Reemplazar",
+    replacePlaceholder: "Reemplazar con",
+    findNext: "Buscar Suceso Próximo",
+    findPrevious: "Buscar Suceso Previo",
+    replaceActionShort: "Reemplazar",
+    replaceAction: "Reemplazar este Suceso",
+    replaceAllActionShort: "Reemplazar Todos",
+    replaceAllAction: "Reemplazar Todos los Sucesos"
+};
+const goToLineTranslations = {
+    closeDialog: "Cerrar el Diálogo y Regresar al Editor",
+    input: "Línea:Columno o Línea luego Retorno",
+    guidanceFormat: "Formato incorrecto. Ingresa un número de línea (por ej. 1) o un número de línea luego dos puntos luego un número de columno (por ej. 1:3).",
+    guidanceLineRange: (current, max) => `Número de línea (actualmente ${current}) debería ser entre 1 y ${max}.`,
+    guidanceColumnRange: (line, current, max) => `En la línea número ${line}, número de columno (actualmente ${current}) debería ser entre 1 y ${max}.`,
+    guidanceValidLine: (line) => `Tecla Retorno para ir a línea número ${line}.`,
+    guidanceValidColumn: (line, column) => `Tecla Retorno para ir a línea número ${line}, columno número ${column}.`,
+};
+const indentTranslations = {
+    tabForIndentation: "Tabulador y Mayús-Tabulador actualmente para la indentación. Tecla Escape para activar la navegación por el teclado.",
+    tabForNavigation: "Tabulador y Mayús-Tabulador actualmente para la navegación por el teclado. Tecla para activar la indentación.",
+};
+
+const tokenSelectorCallbacks1 = new SelectTokenCallbacks.TokenSelectorCallbacks(
+    function(token: HTMLElement) {
+        // Stub
+    },
+    function(tokenContainer: HTMLElement) {
+        // Stub
+    }
+);
+const tokenSelectorCallbacks2 = SelectTokenCallbacks.TokenSelectorCallbacks.createClassSynchronisation("selected");
+
+const plugins1: Array<codeInput.Plugin> = [
+    new AutoCloseBrackets({"(": ")"}),
+    new Autocomplete(function(popupElem: HTMLElement, textareaElem: HTMLTextAreaElement, selectionEnd: number, selectionStart: number) {
+        popupElem.textContent = textareaElem.value.substring(selectionStart, selectionEnd);
+    }),
+    new Autodetect(),
+    new FindAndReplace(false, false, findAndReplaceTranslations),
+    new GoToLine(false, goToLineTranslations),
+    new Indent(true, 4, {"(": ")"}, true, indentTranslations),
+    new SelectTokenCallbacks(tokenSelectorCallbacks1, true, true, true, false, true, false),
+    new SpecialChars(true, false, /[^\n\t ]/g),
+    new Test()
+];
+
+const plugins2: Array<codeInput.Plugin> = [
+    new AutoCloseBrackets(),
+    new Autocomplete(function(popupElem: HTMLElement, textareaElem: HTMLTextAreaElement, selectionEnd: number) {
+        popupElem.textContent = textareaElem.value.substring(0, selectionEnd);
+    }),
+    // No Autodetect, since passed to Prism.js
+    new FindAndReplace(),
+    new GoToLine(),
+    new Indent(),
+    new SelectTokenCallbacks(tokenSelectorCallbacks2),
+    new SpecialChars(),
+    new Test()
+];
+
+const hljsTemplate: codeInput.Template = new HLJSTemplate(stubHLJS, plugins1);
+const prismTemplate: codeInput.Template = new PrismTemplate(stubPrism, plugins2);
+
+codeInput.registerTemplate("hljs", hljsTemplate);
+codeInput.registerTemplate("prism", prismTemplate);

From 25a2c9977b2e56ed8fa45e7abb79a30ef64986dd Mon Sep 17 00:00:00 2001
From: Oliver Geer <o@ogeer.org>
Date: Sun, 6 Sep 2026 23:19:54 +0100
Subject: [PATCH 3/6] Fix some documentation

---
 esm/generate.sh            | 1 +
 tests/typescript/README.md | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/esm/generate.sh b/esm/generate.sh
index bcc23d5..0e28e06 100644
--- a/esm/generate.sh
+++ b/esm/generate.sh
@@ -132,6 +132,7 @@ mkdir -p plugins
     classname=$(grep -Eo "^ *class [A-Za-z]+" plugins/$0.d.mts | head -n 1 | sed "s/^ *class //");
 
     cat plugins/$0.d.mts | sed "s/class ${classname} /declare class ${classname} /g" | sed "s/namespace ${classname} /declare namespace ${classname} /g" | sed "s/codeInput\.plugins\.${classname}/${classname}/g" | sed "s/prevname/oldname/g" >> plugins/$0.new.d.mts;
+    # New file in middle so concurrent pipes dont read and write same file
     mv plugins/$0.new.d.mts plugins/$0.d.mts;
 
     echo "export default ${classname};" >> plugins/$0.d.mts;
diff --git a/tests/typescript/README.md b/tests/typescript/README.md
index 671835f..9fac0a0 100644
--- a/tests/typescript/README.md
+++ b/tests/typescript/README.md
@@ -3,5 +3,5 @@
 To check for bugs in code-input.d.ts, and in ESM generation of d.ts files:
 
 1. Generate ECMAScript modules in the esm/ directory, using esm/README.md
-2. Compile this TypeScript file, by changing to its directory and running `tsc example.ts --lib dom,es6`
+2. Compile each TypeScript file, by changing to its directory and running `tsc example1.ts ; tsc example2.ts` in the shell
 3. Fix any compilation bugs that occur

From 076b0001752bf60e4107141d148ccfde5815e270 Mon Sep 17 00:00:00 2001
From: Oliver Geer <o@ogeer.org>
Date: Sun, 6 Sep 2026 23:49:52 +0100
Subject: [PATCH 4/6] Correct esm/generate.mjs so it matches esm/generate.sh

---
 esm/generate.mjs | 62 ++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 52 insertions(+), 10 deletions(-)

diff --git a/esm/generate.mjs b/esm/generate.mjs
index d48adfb..31c0152 100644
--- a/esm/generate.mjs
+++ b/esm/generate.mjs
@@ -58,7 +58,30 @@ const AUTOGENERATED_NOTICE = "// NOTICE: This code is @generated from code outsi
             copyingCode = true; // After is code to copy - this line missed out
         }
     }
-    await codeInputDMts.writeFile("export default { Plugin, Template, CodeInput, registerTemplate };\n");
+    await codeInputDMts.writeFile(`
+
+    // Prepare the default export:
+
+    // Values under the default export
+    declare const _default: {
+        Plugin: typeof Plugin;
+        Template: typeof Template;
+        CodeInput: typeof CodeInput;
+        registerTemplate: typeof registerTemplate;
+    }
+
+    // Type aliases to prevent ambiguous 'Plugin = Plugin'
+    declare type _Plugin = Plugin;
+    declare type _Template = Template;
+    declare type _CodeInput = CodeInput;
+    // Types under the default export
+    declare namespace _default {
+        export type Plugin = _Plugin;
+        export type Template = _Template;
+        export type CodeInput = _CodeInput;
+    }
+
+    export default _default;`);
 
     await codeInputDTs.close();
     await codeInputDMts.close();
@@ -127,7 +150,7 @@ const AUTOGENERATED_NOTICE = "// NOTICE: This code is @generated from code outsi
         const templateDMts = await open("templates/"+templateName+".d.mts", "w")
         await templateDMts.writeFile(AUTOGENERATED_NOTICE);
         // Imports
-        await templateDMts.writeFile("import { Template, Plugin } from \"../code-input.d.mts\";\n");
+        await templateDMts.writeFile("import type { Template, Plugin } from \"../code-input.d.mts\";\n");
         // Code after start and before end of this template, making use of the imported Template, not codeInput.Template
         let copyingCode = false;
         let classSeen = false;
@@ -213,26 +236,45 @@ const AUTOGENERATED_NOTICE = "// NOTICE: This code is @generated from code outsi
         const pluginDMts = await open("plugins/"+pluginName+".d.mts", "w")
         await pluginDMts.writeFile(AUTOGENERATED_NOTICE);
         // Imports
-        await pluginDMts.writeFile("import { Plugin, CodeInput } from \"../code-input.d.mts\";\n");
-        // Code after start and before end of this plugin, making use of the imported Template, not codeInput.Template
+        await pluginDMts.writeFile("import type { Plugin, CodeInput } from \"../code-input.d.mts\";\n");
+
+        // 1. Get the name of the Plugin class
         let copyingCode = false;
-        let functionSeen = false;
+        let className = null;
+        const lines = [];
         for await (let line of codeInputDTs.readLines()) {
             if(line.includes("ESM-SUPPORT-END-PLUGIN-"+pluginName)) {
                 break;
             }
             if(copyingCode) {
-                if(/( |\t)*class.*/.test(line) && !functionSeen) {
-                    // Replace only first occurrence
-                    line = line.replace("class", "export default class");
-                    functionSeen = true;
+                lines.push(line);
+                if(className === null) {
+                    const classRegExpMatch = line.match(/^ *class ([A-Za-z]+)/);
+                    if(classRegExpMatch !== null) {
+                        // Replace only first occurrence
+                        className = classRegExpMatch[1];
+                    }
                 }
-                await pluginDMts.writeFile(line.replaceAll("codeInput.Plugin", "Plugin").replaceAll("codeInput.CodeInput", "CodeInput")+"\n");
             }
             if(line.includes("ESM-SUPPORT-START-PLUGIN-"+pluginName)) {
                 copyingCode = true; // After is code to copy - this line missed out
             }
         }
+        if(className === null) throw new Error(`ESM-SUPPORT-START-PLUGIN-${pluginName} section of code-input.d.ts does not contain a line matching /^ *class ([A-Za-z]+)/, but it should!`);
+
+        // 2. Edit the lines
+        for await (let line of lines) {
+            if(copyingCode) {
+                await pluginDMts.writeFile(line
+                .replaceAll("codeInput.Plugin", "Plugin")
+                .replaceAll("codeInput.CodeInput", "CodeInput")
+                .replaceAll(`class ${className}`, `declare class ${className}`)
+                .replaceAll(`namespace ${className}`, `declare namespace ${className}`)
+                .replaceAll(`codeInput.plugins.${className}`, className)
+                +"\n");
+            }
+        }
+        await pluginDMts.writeFile(`export default ${className};\n`);
         await codeInputDTs.close();
         await pluginDMts.close();
     }

From f5d515fc4faf64f74475beb7067864c3ff180867 Mon Sep 17 00:00:00 2001
From: Oliver Geer <o@ogeer.org>
Date: Sun, 6 Sep 2026 23:50:39 +0100
Subject: [PATCH 5/6] Add some small fixes to ESM generation

---
 esm/generate.sh            | 10 +++++-----
 tests/typescript/README.md |  7 ++++---
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/esm/generate.sh b/esm/generate.sh
index 0e28e06..60347e6 100644
--- a/esm/generate.sh
+++ b/esm/generate.sh
@@ -124,14 +124,14 @@ mkdir -p plugins
     echo "import type { Plugin, CodeInput } from \"../code-input.d.mts\";" >> plugins/$0.d.mts
     # Code after start and before end of this template, making use of the imported Plugin, not codeInput.Plugin and the imported CodeInput, not codeInput.CodeInput, exporting the class as default
     # export default class replacement should work but won"t leave indentation as JS version does.
-    head -n $(($(sed -n "/ESM-SUPPORT-END-PLUGIN-$0/=" ../code-input.d.ts | head -n 1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-PLUGIN-$0/=" ../code-input.d.ts | head -n 1) + 1)) | sed "s/codeInput\.Plugin/Plugin/g" | sed "s/codeInput\.CodeInput/CodeInput/g" >> plugins/$0.d.mts;
+    head -n $(($(sed -n "/ESM-SUPPORT-END-PLUGIN-$0/=" ../code-input.d.ts | head -n 1) - 1)) ../code-input.d.ts | tail --line=+$(($(sed -n "/ESM-SUPPORT-START-PLUGIN-$0/=" ../code-input.d.ts | head -n 1) + 1)) >> plugins/$0.d.mts;
 
-    # Declare the first class defined in the file and if it exists the namespace with the
-    # same name, then export it at the end of the file so the class and namespace are
-    # merged if necessary.
+    # Declare the first class defined in the file and, if a namespace with the same name
+    # exists, declare that as well, then export it at the end of the file so the class and
+    # namespace are merged if necessary.
     classname=$(grep -Eo "^ *class [A-Za-z]+" plugins/$0.d.mts | head -n 1 | sed "s/^ *class //");
 
-    cat plugins/$0.d.mts | sed "s/class ${classname} /declare class ${classname} /g" | sed "s/namespace ${classname} /declare namespace ${classname} /g" | sed "s/codeInput\.plugins\.${classname}/${classname}/g" | sed "s/prevname/oldname/g" >> plugins/$0.new.d.mts;
+    cat plugins/$0.d.mts | sed "s/codeInput\.Plugin/Plugin/g" | sed "s/codeInput\.CodeInput/CodeInput/g" | sed "s/class ${classname} /declare class ${classname} /g" | sed "s/namespace ${classname} /declare namespace ${classname} /g" | sed "s/codeInput\.plugins\.${classname}/${classname}/g" >> plugins/$0.new.d.mts;
     # New file in middle so concurrent pipes dont read and write same file
     mv plugins/$0.new.d.mts plugins/$0.d.mts;
 
diff --git a/tests/typescript/README.md b/tests/typescript/README.md
index 9fac0a0..55e9e24 100644
--- a/tests/typescript/README.md
+++ b/tests/typescript/README.md
@@ -2,6 +2,7 @@
 
 To check for bugs in code-input.d.ts, and in ESM generation of d.ts files:
 
-1. Generate ECMAScript modules in the esm/ directory, using esm/README.md
-2. Compile each TypeScript file, by changing to its directory and running `tsc example1.ts ; tsc example2.ts` in the shell
-3. Fix any compilation bugs that occur
+1. Generate ECMAScript modules in the esm/ directory, using esm/README.md.
+2. Compile each TypeScript file, by changing to this directory and running `tsc example1.ts ; tsc example2.ts` in the terminal.
+3. If any compilation bugs appear in the terminal, fix them.
+4. If nothing appears in the terminal, this test passed.

From 4032f9f368f184c3a6ad5f8357ddf7387d1fde25 Mon Sep 17 00:00:00 2001
From: Oliver Geer <o@ogeer.org>
Date: Mon, 7 Sep 2026 00:23:19 +0100
Subject: [PATCH 6/6] Make generate.mjs and generate.sh consistent when
 declaring let plugins = {};

---
 esm/generate.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/esm/generate.mjs b/esm/generate.mjs
index 31c0152..692b176 100644
--- a/esm/generate.mjs
+++ b/esm/generate.mjs
@@ -208,7 +208,7 @@ const AUTOGENERATED_NOTICE = "// NOTICE: This code is @generated from code outsi
         // Imports
         await pluginMjs.writeFile("import { Plugin } from \"../code-input.mjs\";\n")
         // Plugin syntax is to be stored in an object; do so temporarily.
-        await pluginMjs.writeFile("const plugins = {};\n");
+        await pluginMjs.writeFile("let plugins = {};\n");
         // Code from this plugin"s file, making use of the imported Plugin, not codeInput.Plugin, and of the created plugins object, not codeInput.plugins
         let pluginClassName = null;
         for await (const line of pluginJs.readLines()) {