xslt-processor 3.3.0 → 3.4.0

package/README.md

@@ -17,12 +17,16 @@ _A JavaScript XSLT processor without native library dependencies._
 
 ## How to
 
-Install xslt-processor using [npm](https://docs.npmjs.com/about-npm) or [yarn](https://yarnpkg.com):
+Install xslt-processor using [npm](https://docs.npmjs.com/about-npm), [ohpm](https://ohpm.openharmony.cn/#/en/home) or [yarn](https://yarnpkg.com):
 
 ```sh
 npm install xslt-processor
 ```
 
+```sh
+ohpm install xslt-processor
+```
+
 ```sh
 yarn add xslt-processor
 ```
@@ -85,7 +89,7 @@ const xslt = new Xslt(options);
 - `cData` (`boolean`, default `true`): resolves CDATA elements in the output. Content under CDATA is resolved as text. This overrides `escape` for CDATA content.
 - `escape` (`boolean`, default `true`): replaces symbols like `<`, `>`, `&` and `"` by the corresponding [HTML/XML entities](https://www.tutorialspoint.com/xml/xml_character_entities.htm). Can be overridden by `disable-output-escaping`, that also does the opposite, unescaping `&gt;` and `&lt;` by `<` and `>`, respectively.
 - `selfClosingTags` (`boolean`, default `true`): Self-closes tags that don't have inner elements, if `true`. For instance, `<test></test>` becomes `<test />`.
-- `outputMethod` (`string`, default `xml`): Specifies the default output method. if `<xsl:output>` is declared in your XSLT file, this will be overridden.
+- `outputMethod` (`string`, default `xml`): Specifies the default output method. if `<xsl:output>` is declared in your XSLT file, this will be overridden. Valid values: `xml`, `html`, `text`, `name`, `xhtml`.
 - `parameters` (`array`, default `[]`): external parameters that you want to use.
     - `name`: the parameter name;
     - `namespaceUri` (optional): the namespace;
@@ -123,6 +127,8 @@ const outXmlString = xslt.xsltProcess( // Not async.
 
 Version 3 received `<xsl:include>` which relies on Fetch API, which is asynchronous. Version 2 doesn't support `<xsl:include>`.
 
+If using Node.js older than version v17.5.0, please use version 3.2.3, that uses `node-fetch` package. Versions 3.3.0 onward require at least Node.js version v17.5.0, since they use native `fetch()` function.
+
 #### Version 1
 
 Until version 1.2.8, use like the example below:
@@ -219,3 +225,4 @@ HTML per se is not strict XML. Because of that, starting on version 2.0.0, this
 - XSLT Specification: http://www.w3.org/TR/1999/REC-xslt-19991116
 - W3C DOM Level 3 Core Specification: http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/
 - ECMAScript Language Specification: http://www.ecma-international.org/publications/standards/Ecma-262.htm
+- Arkts Language Specification: https://gitee.com/openharmony/arkcompiler_runtime_core/releases/download/ArkTS-spec-1.2.0-alpha-20250307/arktsspecification.pdf

package/dom/xml-output-options.d.ts

@@ -2,5 +2,5 @@ export type XmlOutputOptions = {
     cData: boolean;
     escape: boolean;
     selfClosingTags: boolean;
-    outputMethod: 'xml' | 'html' | 'text' | 'name';
+    outputMethod: 'xml' | 'html' | 'text' | 'name' | 'xhtml';
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xslt-processor",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "A JavaScript XSLT Processor",
   "main": "index.js",
   "module": "index.js",
@@ -48,6 +48,7 @@
     "@rollup/plugin-typescript": "^11.1.1",
     "@types/he": "^1.2.0",
     "@types/jest": "^29.5.12",
+    "@types/node": "^22.9.0",
     "@types/node-fetch": "^2.6.11",
     "@typescript-eslint/eslint-plugin": "^8.4.0",
     "@typescript-eslint/parser": "^8.4.0",
@@ -67,19 +68,10 @@
     "rollup-plugin-terser": "^4.0.3",
     "ts-jest": "^29.2.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.5.4"
+    "typescript": "^5.9.2"
   },
   "dependencies": {
-    "he": "^1.2.0",
-    "node-fetch": "release-2.x"
-  },
-  "overrides": {
-    "node-fetch@release-2.x": {
-      "whatwg-url": "14.x"
-    }
-  },
-  "resolutions": {
-    "whatwg-url": "14.x"
+    "he": "^1.2.0"
   },
   "copyFiles": [
     {

package/umd/dom/xml-output-options.d.ts

@@ -2,5 +2,5 @@ export type XmlOutputOptions = {
     cData: boolean;
     escape: boolean;
     selfClosingTags: boolean;
-    outputMethod: 'xml' | 'html' | 'text' | 'name';
+    outputMethod: 'xml' | 'html' | 'text' | 'name' | 'xhtml';
 };

package/umd/xslt/xslt.d.ts

@@ -34,7 +34,7 @@ export declare class Xslt {
     options: XsltOptions;
     decimalFormatSettings: XsltDecimalFormatSettings;
     outputDocument: XDocument;
-    outputMethod: 'xml' | 'html' | 'text' | 'name';
+    outputMethod: 'xml' | 'html' | 'text' | 'name' | 'xhtml';
     outputOmitXmlDeclaration: string;
     version: string;
     firstTemplateRan: boolean;
@@ -265,5 +265,11 @@ export declare class Xslt {
      * @param template The template node.
      */
     protected xsltWithParam(context: ExprContext, template: XNode): Promise<void>;
+    /**
+     * Test if the given element is an XSLT element, optionally the one with the given name.
+     * @param {XNode} element The element.
+     * @param {string} opt_wantedName The name for comparison.
+     * @returns True, if element is an XSL node. False otherwise.
+     */
     protected isXsltElement(element: XNode, opt_wantedName?: string): boolean;
 }