jtlt 0.3.0 → 0.5.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":";;;;;;;;AA4iBG,0BACQ,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GAC1C,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CACvC;;;;;;AAEE,0BACQ,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GAC5C,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CACzC;;;;;;AAEE,0BACQ,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,GACzC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CACtC;;;;;;AAEE,0BACQ,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GACvC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CACvC;;;;;;AAEE,0BACQ,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,GACtC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CACtC;;;;;;AAEE,0BACQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GACzC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CACzC;AA1jBM,+BAFI,OAAO,OAAO,EAAE,SAAS,GAAG,OAAO,UAAU,QAIvD;;;;;;;;;;;;;;;kCAKY,WAAW,GAAG;IACtB,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC;;;;;;;2BAQS,CAAC,EACD,CAAC,EACD,IAAI;;;;;;;;;;;;;;;;;;;;cAMH,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;;;;;6BAK7B,CAAC,EACD,CAAC,EACD,IAAI,IACJ,CAAC,IAAI,EAAE,IAAI,EACnB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,GAAG,CAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,KAClB,UAAU,CAAC,CAAC,CAAC,GAAC,IAAI;mCAIb,CAAC,IACD,cAAc,CAAC,CAAC,EAAE,MAAM,EACpC,OAAW,iCAAiC,EAAE,OAAO,CAAC,CAAC,CAAC,CACrD;gCAGS,CAAC,IACD,cAAc,CAAC,CAAC,EAAE,KAAK,EACnC,OAAW,8BAA8B,EAAE,OAAO,CAC/C;+BAGS,CAAC,IACD,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EACxE,OAAW,8BAA8B,EAAE,OAAO,CAC/C,CAAC,CAAC,EAAE;kCAGK,CAAC,IACD,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAC3E,OAAW,iCAAiC,EAAE,OAAO,CAClD,CAAC;iCAIQ,CACR,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,CACvB;2BAIS,MAAM,GAAC,QAAQ,GAAC,KAAK;uBAIrB,CAAC,IACD,CAAC,SAAS,MAAM,GAAG,OAAO,GAAG,CAAC,SAAS,QAAQ,GAAG,MAAM,GAChE,gBAAgB,GAAC,OAAO;;;;4BAKhB,CAAC;;;;;;;aAEA,CACT,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsBS,WAAW,GAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC,KAC9C,UAAU,CAAC,CAAC,CAAC;;;;0CAIA,MAAM,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;gCAehC,CAAC,aACF,eAAe,CAAC,CAAC,CAAC,GAAG;IAC7B,SAAS,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,MAAM,EACrE,OAAa,iCAAiC,EAAE,OAAO,CAClD,CAAC;IACF,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EACtC,OAAa,iCAAiC,EAAE,OAAO,CAClD,CAAC;IACF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAClD,OAAa,8BAA8B,EAAE,OAAO,CAC/C,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,CAAA;CACf;;;;6BAKS,CAAC,IACD,eAAe,CAAC,CAAC,CAAC,GAAG;IAC7B,SAAS,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,KAAK,EACjE,OAAa,8BAA8B,EAAE,OAAO,CAC/C,CAAC;IACF,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EACrC,OAAa,8BAA8B,EAAE,OAAO,CAC/C,CAAC;IACF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,EACjD,OAAa,iCAAiC,EAAE,OAAO,CAClD,CAAC,CAAC;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,GAAC,CAAC,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAC,KAAK,GAAC,MAAM,CAAA;CACnC;0BAIS,mBAAmB,GAC3B,mBAAmB,CAAC,QAAQ,CAAC,GAC7B,mBAAmB,CAAC,KAAK,CAAC,GAC1B,gBAAgB,CAAC,MAAM,CAAC,GACxB,gBAAgB,CAAC,QAAQ,CAAC,GAC1B,gBAAgB,CAAC,KAAK,CAAC;AA1K5B;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH;;;;;GAKG;AACH;;;;;GAKG;AACH;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;GAEG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH;;;;;;;;;IAMK,oBACQ,mBAAmB,EAC7B;;;;;IAEE,oBACQ,mBAAmB,CAAC,QAAQ,CAAC,EACvC;;;;;IAEE,oBACQ,mBAAmB,CAAC,KAAK,CAAC,EACpC;;;;;IAEE,oBACQ,gBAAgB,CAAC,MAAM,CAAC,EAClC;;;;;IAEE,oBACQ,gBAAgB,CAAC,QAAQ,CAAC,EACpC;;;;;IAEE,oBACQ,gBAAgB,CAAC,KAAK,CAAC,EACjC;IAMC,0BAA0B;IAC1B,QADW,WAAW,CACI;IA4B5B;;;OAGG;IACH,6BAHa,qBAAqB,GAAC,sBAAsB,GACpD,wBAAwB,CAuE5B;IAED;;;OAGG;IACH,iBAHW,MAAM,GAAC,SAAS,GACd,IAAI,CAYhB;IAED;;;OAGG;IACH,oBAHW,WAAW,GACT,IAAI,CAiJhB;IAED;;;;;;OAMG;IACH,iBANW,MAAM,GACJ,IAAI,CA6ChB;CACF;qCAhiBoC,+BAA+B;kCAJlC,4BAA4B;mCAC3B,6BAA6B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}

package/docs/API.expanded.md

@@ -85,12 +85,13 @@ Responsibilities:
 - Sorts by priority (numeric or specificity resolver).
 - Invokes winning template; falls back to default rules when no match.
 
-### `XPathTransformer` (experimental)
+### `XPathTransformer`
 
 Same pattern for XML/HTML DOM data using XPath selectors.
 
 Config additions:
-- `xpathVersion`: `1` (native `XPathEvaluator`), `2` (`xpath2.js`). Default `1`.
+- `xpathVersion`: `1` (native `XPathEvaluator`), `2` (`xpath2.js`), `3.1` (`fontoxpath`).
+  Default `1`.
 
 ```js
 import {XPathTransformer, StringJoiningTransformer} from 'jtlt';
@@ -122,7 +123,8 @@ const out = engine.transform('');
 ```
 
 Limitations:
-- Version 2 (`xpath2.js`) may lack some XPath 2.0 functions; stick to basic location paths and simple predicates.
+- Versions 2 and 3 (`xpath2.js` and `fontoxpath`) may lack some XPath functions;
+  stick to basic location paths and simple predicates.
 - Namespace resolution not yet exposed (future `namespaceResolver` option).
 
 ## Contexts

package/docs/API.md

@@ -25,7 +25,7 @@ new JTLT({
 - JSONPathTransformer: on JSON with JSONPath selectors; resolves
 	priority and falls back to defaults when no template matches.
 - XPathTransformer (experimental): on XML/HTML DOM. Choose
-	`engineType: 'xpath'` on JTLT and set `xpathVersion: 1 | 2`.
+	`engineType: 'xpath'` on JTLT and set `xpathVersion: 1 | 2 | 3.1`.
 
 ## Context basics
 

package/docs/TO-DO.md

@@ -1,6 +1,8 @@
 ## To-dos
 
-1.  Document and add test cases to cover current features! (Could adapt an XSLT/XQuery test suite)
+1. Testing: Could adapt an XSLT/XQuery test suite
+
+1. Document
 
     1.  Implement and demo equivalent to applying and calling templates, and
         root template
@@ -10,45 +12,41 @@
         even making aliases so that XQuery's friendlier terms can be used
         instead of XSLT's.
 
-2.  Support processing of JSON documents with `$jtlt-stylesheet` to let
-    documents define their own targeted stylesheets.
+2. Support processing of JSON documents with `$jtlt-stylesheet` to let
+    documents define their own targeted stylesheets and make own
+    `<?xml-stylesheet type="text/javascript" href="..."?>` for XML
 
-3.  When sufficiently documented, add as example library/tool to
+3. When sufficiently documented, add as example library/tool to
     JSONPath wiki.
 
-4.  Allow alternative to `element()`, `array()`, etc. methods by just
+4. Allow alternative to `element()`, `array()`, etc. methods by just
     detecting those types from return values (and generic of each
     type like `dom()` and `json()`).
 
-5.  Allow, depending on mode, containers to contain containers of other
+5. Allow, depending on mode, containers to contain containers of other
     types (e.g., a JS container containing DOM objects, or temporary use
     of a string container, etc.).
 
-    1.  Support XML and add [hXML](https://github.com/brettz9/hxml) methods.
-
-    2.  Support [JHTML](https://github.com/brettz9/jhtml).
+    1. Support XML and add [hXML](https://github.com/brettz9/hxml) methods.
 
-    3.  Support `appendJSON()`/`appendDOM()` and
+    2. Support `appendJSON()`/`appendDOM()` and
         `appendType('json', ...)` (allowing type extensions).
 
-6.  Add `appendResult(function () {return result})`.
+6. Add `appendResult(function () {return result})`.
 
-7.  Add JSON update functions (equivalent to Xquery Update Facility for
+7. Add JSON update functions (equivalent to Xquery Update Facility for
     XML ([overview](http://www.xmlplease.com/xquery-update))) and create
     JSON serialization (as with XSLT expressed itself in declarative XML)
     so one can submit and evaluate
     through [HTTPQuery](https://github.com/brettz9/httpquery) (and also
     supply to JSONEditor, etc.). Utilize updating by reference.
 
-8. Demo narrowing to subset of JavaScript (as with `jspe`) to make
+8. Demo narrowing to subset of JavaScript (as with `jsep`) to make
     JTLT truly "declarative" as far as freedom from scripting
 
-9. Use [fontoxpath](https://github.com/FontoXML/fontoxpath)
-    for XPath 3.1 implementation?
-
 ## Possible to-dos
 
-1.  Make schema-aware so that templates could target types. Most reusable
+1. Make schema-aware so that templates could target types. Most reusable
     application may be having a type-driven view of a JSON Schema instance
     (e.g., dates could be shown inside a calendar widget). Perhaps this
     schema-awareness could also drive a JSON editor (as with other existing
@@ -59,21 +57,18 @@
     files) could point the way for edited contents to be saved back to the
     correct JSON file and position in the JSON file.
 
-2.  Add a [non-eval PR for JSONPath](https://github.com/s3u/JSONPath/pull/4).
+2. ~~Add a [non-eval PR for JSONPath](https://github.com/s3u/JSONPath/pull/4).~~
     The OR condition (outside of filters) is another important feature as
     would be schema-aware path results.
 
-3.  Allow hybrid JSON/[Jamilih](https://github.com/brettz9/jamilih) or
+3. Allow hybrid JSON/[Jamilih](https://github.com/brettz9/jamilih) or
     JSON/(X)HTML/XML so that one can add
     XPath or query into HTML in a relevant manner
 
-4.  Support pull parsing/streaming? Pass `done()` function to templates to
+4. Support pull parsing/streaming? Pass `done()` function to templates to
     signal completion?
 
-5.  Support Promise API in addition to callbacks (reconcile with
-    current chaining; see also XQuery FLWOR to-do)
-
-6.  Add [XQuery Functions](https://code.google.com/p/jsxqueryparser/source/browse/trunk/jsxqueryparser/XQueryParser.js#1768)
+5. Add [XQuery Functions](https://code.google.com/p/jsxqueryparser/source/browse/trunk/jsxqueryparser/XQueryParser.js#1768)
     (also supporting DOM and JSON where possible) as plug-in (also any
     missing from XSLT/XQuery 3.0). Also add, if not present among these
     functions (or in XQuery), add equivalents to XSLT's
@@ -82,49 +77,76 @@
     iterating or retrieving IndexedDB, `localStorage`, and cookies
     (names, keys and values).
 
-7.  Add `outputType` which uses a DOM joiner but allows specialized
+6. Add `outputType` which uses a DOM joiner but allows specialized
     serialized output (e.g., pretty-printed HTML) so the users
     don't need to build it themselves (likewise with stringified
     JSON output).
 
-8.  See code for other possible to-dos
+7. See code for other possible to-dos
+
+8. Promise-based templates
 
-9. Consider implementing the following elements from <https://www.w3.org/TR/xslt20/>
+9. Consider implementing the following elements from <https://www.w3.org/TR/xslt-30/>
     which are not yet implemented.
 
-  "xsl:analyze-string",
+  xsl:accept
+  xsl:accumulator
+  xsl:accumulator-rule
+  ~~"xsl:analyze-string",~~
   "xsl:apply-imports",
   ~~"xsl:apply-templates",~~
+  xsl:assert
   ~~"xsl:attribute",~~
   "xsl:attribute-set",
+  xsl:break
   ~~"xsl:call-template",~~
-  "xsl:character-map",
+  xsl:catch
+  ~~"xsl:character-map",~~
   ~~"xsl:choose",~~
   ~~"xsl:comment",~~
+  xsl:context-item
   ~~"xsl:copy",~~
   ~~"xsl:copy-of",~~
-  "xsl:decimal-format",
+  ~~"xsl:decimal-format",~~
   ~~"xsl:document",~~
   ~~"xsl:element",~~
+  xsl:evaluate
+  xsl:expose
   "xsl:fallback",
   ~~"xsl:for-each",~~
-  "xsl:for-each-group",
+  ~~"xsl:for-each-group",~~
+  xsl:fork
   "xsl:function",
+  xsl:global-context-item
   ~~"xsl:if",~~
   "xsl:import",
   "xsl:import-schema",
   "xsl:include",
+  xsl:iterate
   ~~"xsl:key",~~
-  "xsl:matching-substring",
+  xsl:map
+  xsl:map-entry
+  ~~"xsl:matching-substring",~~
+  xsl:merge
+  xsl:merge-action
+  xsl:merge-key
+  xsl:merge-source
   ~~"xsl:message",~~
-  "xsl:namespace",
+  xsl:mode
+  ~~"xsl:namespace",~~
   "xsl:namespace-alias",
+  xsl:next-iteration
   "xsl:next-match",
-  "xsl:non-matching-substring",
-  "xsl:number",
+  ~~"xsl:non-matching-substring",~~
+  ~~"xsl:number",~~
+  xsl:on-completion
+  xsl:on-empty
+  xsl:on-non-empty
   ~~"xsl:otherwise",~~
   ~~"xsl:output",~~
-  "xsl:output-character",
+  ~~"xsl:output-character",~~
+  xsl:override
+  xsl:package
   "xsl:param",
   "xsl:perform-sort",
   "xsl:preserve-space",
@@ -132,13 +154,17 @@
   ~~"xsl:result-document",~~
   "xsl:sequence",
   ~~"xsl:sort",~~
+  xsl:source-document
   "xsl:strip-space",
   ~~"xsl:stylesheet",~~
   ~~"xsl:template",~~
   ~~"xsl:text",~~
   ~~"xsl:transform",~~
+  xsl:try
+  xsl:use-package
   ~~"xsl:value-of",~~
   ~~"xsl:variable",~~
   ~~"xsl:when",~~
+  xsl:where-populated
   ~~"xsl:with-param"~~
 

package/eslint.config.js

@@ -4,7 +4,9 @@ export default [
   {
     ignores: [
       'dist',
-      'coverage'
+      'coverage',
+      'demo/vendor',
+      'demo/codemirror.esm.js'
     ]
   },
   ...ashNazg(['sauron']),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jtlt",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "author": "Brett Zamir",
   "contributors": [],
@@ -25,16 +25,28 @@
     "url": "https://github.com/brettz9/jtlt.git"
   },
   "dependencies": {
+    "@codemirror/lang-javascript": "^6.2.4",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-xml": "^6.1.0",
+    "@codemirror/language": "^6.11.3",
+    "@codemirror/state": "^6.5.2",
+    "@lezer/highlight": "^1.2.3",
+    "codemirror": "^6.0.2",
+    "fontoxpath": "^3.33.2",
     "jamilih": "0.62.1",
     "jhtml": "0.7.1",
     "jsdom": "27.1.0",
     "jsonpath-plus": "10.3.0",
+    "prsc": "^4.0.0",
     "simple-get-json": "10.0.0",
-    "xpath2.js": "1.0.0-alpha-6"
+    "whynot": "^5.0.0",
+    "xpath2.js": "1.0.0-alpha-6",
+    "xspattern": "^3.1.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
     "@node-static/node-static": "^0.8.1",
+    "@rollup/plugin-node-resolve": "^16.0.3",
     "@types/chai": "^5.2.3",
     "@types/jsdom": "^27.0.0",
     "@types/mocha": "^10.0.10",
@@ -44,6 +56,7 @@
     "eslint-config-ash-nazg": "^39.8.0",
     "mocha": "^11.7.5",
     "open": "^10.2.0",
+    "rollup": "^4.53.2",
     "typescript": "^5.9.3"
   },
   "bugs": "https://github.com/brettz9/jtlt/issues",
@@ -55,12 +68,23 @@
     "javascript"
   ],
   "scripts": {
-    "start": "open http://localhost:8020/demo/ && static -p 8020",
+    "start": "open http://localhost:8021/demo/ && static -p 8021",
     "attw": "attw --pack",
     "tsc": "tsc",
-    "build": "tsc -p tsconfig-prod.json",
+    "build": "tsc -p tsconfig-prod.json && npm run rollup",
+    "rollup": "rollup -c",
+    "copy-simple-get-json": "cp -r node_modules/simple-get-json/dist/index-es.js demo/vendor/simple-get-json/dist/index-es.js",
+    "copy-jhtml": "cp -Rf node_modules/jhtml/src demo/vendor/jhtml",
+    "copy-jamilih": "cp node_modules/jamilih/dist/jml.mjs demo/vendor/jamilih/dist/jml.mjs",
+    "copy-jsonpath-plus": "cp node_modules/jsonpath-plus/dist/index-browser-esm.js demo/vendor/jsonpath-plus/dist/index-browser-esm.js",
+    "copy-fontoxpath": "cp node_modules/fontoxpath/dist/fontoxpath.esm.js demo/vendor/fontoxpath/dist/fontoxpath.esm.js",
+    "copy-xspattern": "cp node_modules/xspattern/dist/xspattern.esm.js demo/vendor/xspattern/dist/xspattern.esm.js",
+    "copy-prsc": "cp node_modules/prsc/dist/prsc.esm.js demo/vendor/prsc/dist/prsc.esm.js",
+    "copy-whynot": "cp node_modules/whynot/dist/whynot.esm.js demo/vendor/whynot/dist/whynot.esm.js",
+    "copy": "pnpm copy-simple-get-json && pnpm copy-jhtml && pnpm copy-jamilih && pnpm copy-jsonpath-plus && pnpm copy-fontoxpath && pnpm copy-xspattern && pnpm copy-prsc && pnpm copy-whynot",
     "lint": "eslint .",
     "mocha": "mocha",
+    "test:browser": "open http://localhost:8020/test/browser/ && static -p 8020",
     "test": "c8 npm run mocha"
   }
 }

package/rollup.config.js

@@ -0,0 +1,13 @@
+import {nodeResolve} from '@rollup/plugin-node-resolve';
+
+export default {
+  input: 'demo/codemirror.js',
+  output: {
+    file: 'demo/codemirror.esm.js',
+    format: 'esm',
+    banner: '// Do not edit this file; it was auto-generated'
+  },
+  plugins: [
+    nodeResolve()
+  ]
+};

package/src/AbstractJoiningTransformer.js

@@ -2,6 +2,10 @@
 //    mid-transformation (e.g., building strings with
 //    string transformer but adding as text node in a DOM transformer)
 
+/**
+ * @typedef {{character: string, string: string}[]} OutputCharacters
+ */
+
 /**
  * @typedef {{
  *   requireSameChildren?: boolean,
@@ -66,6 +70,8 @@ class AbstractJoiningTransformer {
   constructor (cfg) {
     // Todo: Might set some reasonable defaults across all classes
     this._cfg = cfg ?? /** @type {JoiningTransformerConfig<T>} */ ({});
+    /** @type {Record<string, OutputCharacters>} */
+    this._characterMap = {};
   }
 
   /**
@@ -76,6 +82,42 @@ class AbstractJoiningTransformer {
     this._cfg = cfg;
   }
 
+  /**
+   * @param {import('./StringJoiningTransformer.js').OutputConfig} cfg
+   * @returns {this}
+   */
+  output (cfg) {
+    // We wait until first element is set in `element()` to add
+    //   XML declaration and DOCTYPE as latter depends on root element
+    this._outputConfig = cfg;
+
+    // Use for file extension if making downloadable?
+    this.mediaType = cfg.mediaType;
+    return this;
+  }
+
+  /**
+   * @param {string} name
+   * @param {OutputCharacters} outputCharacters
+   * @returns {void}
+   */
+  characterMap (name, outputCharacters) {
+    this._characterMap[name] = outputCharacters;
+  }
+
+  /**
+   * @param {string} str
+   * @returns {string}
+   */
+  _replaceCharacterMaps (str) {
+    this._outputConfig?.useCharacterMaps?.forEach((name) => {
+      this._characterMap[name].forEach(({character, string}) => {
+        str = str.replaceAll(character, string);
+      });
+    });
+    return str;
+  }
+
   /**
    * @param {string} type - Type name
    * @param {string} embedType - Embed type name

package/src/DOMJoiningTransformer.js

@@ -182,31 +182,84 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
   }
 
   /**
-   * @param {import('./StringJoiningTransformer.js').OutputConfig} cfg
+   * @overload
+   * @param {Element|string} elName
+   * @param {Record<string, string>} atts
+   * @param {(Node|string)[]} childNodes
+   * @param {(this: DOMJoiningTransformer) => void} cb
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
+   * @param {Record<string, string>} atts
+   * @param {(Node|string)[]} childNodes
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
+   * @param {Record<string, string>} atts
+   * @param {(this: DOMJoiningTransformer) => void} cb
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
+   * @param {Record<string, string>} atts
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
+   * @param {(Node|string)[]} childNodes
+   * @param {(this: DOMJoiningTransformer) => void} cb
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
+   * @param {(Node|string)[]} childNodes
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
+   * @param {(this: DOMJoiningTransformer) => void} cb
+   * @returns {DOMJoiningTransformer}
+   */
+  /**
+   * @overload
+   * @param {Element|string} elName
    * @returns {DOMJoiningTransformer}
    */
-  output (cfg) {
-    // We wait until first element is set in `element()` to add
-    //   XML declaration and DOCTYPE as latter depends on root element
-    this._outputConfig = cfg;
-
-    // Use for file extension if making downloadable?
-    this.mediaType = cfg.mediaType;
-    return this;
-  }
-
   /**
    * @param {Element|string} elName - Element name
-   * @param {Record<string, string>} [atts] - Attributes object
-   * @param {(this: DOMJoiningTransformer) => void} [cb] - Callback function
+   * @param {Record<string, string>|(Node|string)[
+   *   ]|((this: DOMJoiningTransformer) => void)} [atts] - Attributes,
+   *   childNodes, or callback
+   * @param {(Node|string)[]|((this: DOMJoiningTransformer) => void)
+   *   } [childNodes] - Child nodes or callback
+   * @param {(this: DOMJoiningTransformer) => void} [cb] - Callback
    * @returns {DOMJoiningTransformer}
    */
-  element (elName, atts, cb) {
-    // Todo: allow third argument to be array following Jamilih (also let
-    //   "atts" follow Jamilih)
-    // Todo: allow for cfg to produce Jamilih DOM output or hXML
-    // Todo: allow separate XML DOM one with XML String and hXML conversions
-    //   (HTML to XHTML is inevitably safe?)
+  element (elName, atts, childNodes, cb) {
+    // Handle argument overloading like other transformers
+    if (Array.isArray(atts)) {
+      cb = /** @type {(this: DOMJoiningTransformer) => void} */ (
+        /** @type {unknown} */ (childNodes)
+      );
+      childNodes = atts;
+      atts = {};
+    } else if (typeof atts === 'function') {
+      cb = /** @type {(this: DOMJoiningTransformer) => void} */ (atts);
+      childNodes = [];
+      atts = {};
+    }
+    if (typeof childNodes === 'function') {
+      cb = /** @type {(this: DOMJoiningTransformer) => void} */ (childNodes);
+      childNodes = [];
+    }
 
     if (!this.root && this._outputConfig) {
       this.root = elName;
@@ -277,13 +330,24 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
 
       for (const att in atts) {
         if (Object.hasOwn(atts, att)) {
-          el.setAttribute(att, atts[att]);
+          el.setAttribute(att, this._replaceCharacterMaps(atts[att]));
         }
       }
 
       const oldDOM = this._dom;
       this._dom = el;
 
+      // Add childNodes if provided
+      if (childNodes && childNodes.length) {
+        for (const child of childNodes) {
+          if (typeof child === 'string') {
+            el.append(this._replaceCharacterMaps(child));
+          } else {
+            el.append(child);
+          }
+        }
+      }
+
       if (cb) {
         cb.call(this);
       }
@@ -301,7 +365,7 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
 
     for (const att in atts) {
       if (Object.hasOwn(atts, att)) {
-        el.setAttribute(att, atts[att]);
+        el.setAttribute(att, this._replaceCharacterMaps(atts[att]));
       }
     }
     this.append(el);
@@ -310,6 +374,17 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
 
     this._dom = el;
 
+    // Add childNodes if provided
+    if (childNodes && childNodes.length) {
+      for (const child of childNodes) {
+        if (typeof child === 'string') {
+          el.append(this._replaceCharacterMaps(child));
+        } else {
+          el.append(child);
+        }
+      }
+    }
+
     if (cb) {
       cb.call(this);
     }
@@ -318,6 +393,21 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
     return this;
   }
 
+  /**
+   * @param {string} prefix
+   * @param {string} namespaceURI
+   * @returns {DOMJoiningTransformer}
+   */
+  namespace (prefix, namespaceURI) {
+    /** @type {Element} */
+    (this._dom).setAttributeNS(
+      'http://www.w3.org/2000/xmlns/',
+      'xmlns:' + prefix,
+      this._replaceCharacterMaps(namespaceURI)
+    );
+    return this;
+  }
+
   /**
    * @param {string} name
    * @param {string} val
@@ -328,7 +418,9 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
         this._dom.nodeType !== 1) {
       throw new Error('You may only set an attribute on an element');
     }
-    (/** @type {Element} */ (this._dom)).setAttribute(name, val);
+    (/** @type {Element} */ (this._dom)).setAttribute(
+      name, this._replaceCharacterMaps(val)
+    );
     return this;
   }
 
@@ -337,7 +429,7 @@ class DOMJoiningTransformer extends AbstractJoiningTransformer {
    * @returns {DOMJoiningTransformer}
    */
   text (txt) {
-    this.append(txt);
+    this.append(this._replaceCharacterMaps(txt));
     return this;
   }