jtlt 0.3.0 → 0.4.0

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,74 @@
     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
 
-9. Consider implementing the following elements from <https://www.w3.org/TR/xslt20/>
+8. 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:catch
   "xsl:character-map",
   ~~"xsl:choose",~~
   ~~"xsl:comment",~~
+  xsl:context-item
   ~~"xsl:copy",~~
   ~~"xsl:copy-of",~~
   "xsl:decimal-format",
   ~~"xsl:document",~~
   ~~"xsl:element",~~
+  xsl:evaluate
+  xsl:expose
   "xsl:fallback",
   ~~"xsl:for-each",~~
   "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: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:override
+  xsl:package
   "xsl:param",
   "xsl:perform-sort",
   "xsl:preserve-space",
@@ -132,13 +152,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.4.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,19 @@
     "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": "npm run copy-simple-get-json && npm run copy-jhtml && npm run copy-jamilih && npm run copy-jsonpath-plus",
     "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()
+  ]
+};