@lowlighter/xml 6.0.0 → 8.0.0

package/deno.lock

@@ -1,112 +1,32 @@
 {
-  "version": "4",
+  "version": "5",
   "specifiers": {
-    "jsr:@libs/logger@2": "2.1.4",
-    "jsr:@libs/run@2": "2.0.5",
-    "jsr:@libs/testing@3": "3.0.0",
-    "jsr:@libs/typing@2": "2.9.0",
-    "jsr:@libs/typing@3": "3.0.0",
-    "jsr:@std/assert@1": "1.0.6",
-    "jsr:@std/assert@^1.0.6": "1.0.6",
-    "jsr:@std/async@1": "1.0.5",
-    "jsr:@std/bytes@^1.0.2": "1.0.2",
-    "jsr:@std/expect@1": "1.0.4",
-    "jsr:@std/fmt@1": "1.0.2",
-    "jsr:@std/fs@1": "1.0.4",
-    "jsr:@std/html@1": "1.0.3",
-    "jsr:@std/http@1": "1.0.7",
-    "jsr:@std/internal@^1.0.4": "1.0.4",
-    "jsr:@std/path@1": "1.0.6",
-    "jsr:@std/streams@1": "1.0.6",
-    "npm:highlight.js@11": "11.10.0"
+    "jsr:@std/internal@^1.0.14": "1.0.14",
+    "jsr:@std/path@^1.1.4": "1.1.6",
+    "jsr:@std/xml@~0.1.3": "0.1.3"
   },
   "jsr": {
-    "@libs/logger@2.1.4": {
-      "integrity": "47d100412f9c16b5752d670d7fb182a2dce2cda26a72896e0f69d3a2de35fa1f"
+    "@std/internal@1.0.14": {
+      "integrity": "291516b3d4c35024d6ffbc0a9df5bf4c64116e05b50012cf846710152d2ffdf7"
     },
-    "@libs/run@2.0.5": {
-      "integrity": "6da09b6d9458a7f8134a113f7a70186742e6f759423a60f7037ca1001bbf1b78",
+    "@std/path@1.1.6": {
+      "integrity": "c68485c2a4dfbb5ae3cc74fae4e8c4e5d874cf8a8ed12927917235c758b46cbe",
       "dependencies": [
-        "jsr:@libs/logger",
-        "jsr:@libs/typing@2",
-        "jsr:@std/async",
-        "jsr:@std/streams"
-      ]
-    },
-    "@libs/testing@3.0.0": {
-      "integrity": "514547988fadac36890692ccafc932546d9e27680df1b736dd7674ad2e7c9625",
-      "dependencies": [
-        "jsr:@libs/run",
-        "jsr:@libs/typing@2",
-        "jsr:@std/assert@1",
-        "jsr:@std/expect",
-        "jsr:@std/fmt",
-        "jsr:@std/html",
-        "jsr:@std/http",
-        "npm:highlight.js"
-      ]
-    },
-    "@libs/typing@2.9.0": {
-      "integrity": "ddf35ea652b807cd9b19b4f3f163fb5d76d57299053753fbd01ba8b02d9306ad"
-    },
-    "@libs/typing@3.0.0": {
-      "integrity": "f84ffbbdcbb6a02e6a527911b1399dc79f6ad213aec4ad0a86c95df4b353738f"
-    },
-    "@std/assert@1.0.6": {
-      "integrity": "1904c05806a25d94fe791d6d883b685c9e2dcd60e4f9fc30f4fc5cf010c72207",
-      "dependencies": [
-        "jsr:@std/internal"
-      ]
-    },
-    "@std/async@1.0.5": {
-      "integrity": "31d68214bfbb31bd4c6022401d484e3964147c76c9220098baa703a39b6c2da6"
-    },
-    "@std/bytes@1.0.2": {
-      "integrity": "fbdee322bbd8c599a6af186a1603b3355e59a5fb1baa139f8f4c3c9a1b3e3d57"
-    },
-    "@std/expect@1.0.4": {
-      "integrity": "97f68a445a9de0d9670200d2b7a19a7505a01b2cb390a983ba8d97d90ce30c4f",
-      "dependencies": [
-        "jsr:@std/assert@^1.0.6",
         "jsr:@std/internal"
       ]
     },
-    "@std/fmt@1.0.2": {
-      "integrity": "87e9dfcdd3ca7c066e0c3c657c1f987c82888eb8103a3a3baa62684ffeb0f7a7"
-    },
-    "@std/fs@1.0.4": {
-      "integrity": "2907d32d8d1d9e540588fd5fe0ec21ee638134bd51df327ad4e443aaef07123c"
-    },
-    "@std/html@1.0.3": {
-      "integrity": "7a0ac35e050431fb49d44e61c8b8aac1ebd55937e0dc9ec6409aa4bab39a7988"
-    },
-    "@std/http@1.0.7": {
-      "integrity": "9b904fc256678a5c9759f1a53a24a3fdcc59d83dc62099bb472683b6f819194c"
-    },
-    "@std/internal@1.0.4": {
-      "integrity": "62e8e4911527e5e4f307741a795c0b0a9e6958d0b3790716ae71ce085f755422"
-    },
-    "@std/path@1.0.6": {
-      "integrity": "ab2c55f902b380cf28e0eec501b4906e4c1960d13f00e11cfbcd21de15f18fed"
-    },
-    "@std/streams@1.0.6": {
-      "integrity": "022ed94e380d06b4d91c49eb70241b7289ab78b8c2b4c4bbb7eb265e4997c25c",
-      "dependencies": [
-        "jsr:@std/bytes"
-      ]
-    }
-  },
-  "npm": {
-    "highlight.js@11.10.0": {
-      "integrity": "sha512-SYVnVFswQER+zu1laSya563s+F8VDGt7o35d4utbamowvUNLLMovFqwCLSocpZTz3MgaSRA1IbqRWZv97dtErQ=="
+    "@std/xml@0.1.3": {
+      "integrity": "afb7750d09f9f521046b27119d0e63f7aaad6eeb3d74e5f41fc04a9958014811"
     }
   },
   "workspace": {
     "dependencies": [
-      "jsr:@libs/testing@3",
-      "jsr:@libs/typing@3",
-      "jsr:@std/fs@1",
-      "jsr:@std/path@1"
-    ]
+      "jsr:@std/path@^1.1.4"
+    ],
+    "packageJson": {
+      "dependencies": [
+        "npm:@jsr/std__path@^1.1.4"
+      ]
+    }
   }
 }

package/mod.d.ts

@@ -0,0 +1,3 @@
+export * from "./parse.js";
+export * from "./stringify.js";
+export type * from "./_types.js";

package/mod.js

@@ -0,0 +1,3 @@
+export * from "./parse.js";
+export * from "./stringify.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImZpbGU6Ly8vaG9tZS9ydW5uZXIvd29yay9saWJzL2xpYnMvQGxpYnMveG1sL21vZC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tIFwiLi9wYXJzZS5qc1wiXG5leHBvcnQgKiBmcm9tIFwiLi9zdHJpbmdpZnkuanNcIlxuZXhwb3J0IHR5cGUgKiBmcm9tIFwiLi9fdHlwZXMuanNcIlxuIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsYUFBWTtBQUMxQixjQUFjLGlCQUFnQiJ9

package/package.json

@@ -1,28 +1,32 @@
 {
   "name": "@lowlighter/xml",
-  "version": "6.0.0",
+  "version": "8.0.0",
   "type": "module",
-  "scripts": {},
-  "dependencies": {},
-  "devDependencies": {},
-  "description": "XML parser/stringifier with no dependencies.",
-  "keywords": [
-    "xml",
-    "parser",
-    "stringifier",
-    "esm"
-  ],
-  "license": "MIT",
-  "author": "lowlighter (Simon Lecoq)",
-  "homepage": "https://github.com/lowlighter/libs",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lowlighter/libs.git"
-  },
-  "funding": "https://github.com/sponsors/lowlighter",
+  "main": "./mod.js",
+  "types": "./mod.d.ts",
   "exports": {
-    ".": "./mod.mjs",
-    "./parse": "./parse.mjs",
-    "./stringify": "./stringify.mjs"
+    ".": {
+      "types": "./mod.d.ts",
+      "import": "./mod.js",
+      "default": "./mod.js"
+    },
+    "./parse": {
+      "types": "./parse.d.ts",
+      "import": "./parse.js",
+      "default": "./parse.js"
+    },
+    "./stringify": {
+      "types": "./stringify.d.ts",
+      "import": "./stringify.js",
+      "default": "./stringify.js"
+    },
+    "./wasm/parse": {
+      "types": "./wasm/parse.d.ts",
+      "import": "./wasm/parse.js",
+      "default": "./wasm/parse.js"
+    }
+  },
+  "dependencies": {
+    "@jsr/std__xml": "^0.1.3"
   }
-}
+}

package/parse.d.ts

@@ -0,0 +1,81 @@
+import { type CleanOptions, type FlattenOptions, type ReviveOptions } from "./_parser.js";
+import type { XmlDocument } from "./_types.js";
+export type * from "./_types.js";
+export type { CleanOptions, FlattenOptions, ReviveOptions, Reviver } from "./_parser.js";
+/** XML parser options. */ export type ParseOptions = {
+  /** Remove elements from result. */ clean?: CleanOptions;
+  /** Flatten result depending on node content. */ flatten?: FlattenOptions;
+  /** Revive result. */ revive?: ReviveOptions;
+  /**
+   * Parsing mode.
+   * Using `html` is more permissive and will not throw on some invalid XML syntax.
+   * Mainly unquoted attributes will be supported and not properly closed tags will be accepted.
+   *
+   * > Note: `html` mode is currently not supported, use the WASM backend (`@libs/xml/wasm/parse`) instead.
+   * > Tracking issue: https://github.com/denoland/std/issues/7212
+   */ mode?: "xml";
+};
+/**
+ * Parse a XML string into an object.
+ *
+ * Output (cleaning, flattening, reviving, etc.) can be customized using the {@link ParseOptions} parameter.
+ *
+ * Unless flattened, output nodes will contain the following non-enumerable properties (which mean they're not "visible" when iterating over, but are still explicitely accessible):
+ * - General properties
+ *   - `readonly ["~name"]: string`: tag name
+ *   - `readonly ["~parent"]: Nullable<XmlNode>`: parent node
+ *   - `["#text"]?: string`: text content
+ * - Node properties
+ *   - `readonly ["~children"]: Array<XmlNode|XmlText>`: node children
+ *   - `readonly ["#comments"]?: Array<string>`: node comments
+ *   - `readonly ["#text"]?: string`: concatenated children text content, this property becomes enumerable if at least one non-empty text node is present
+ * - XML document properties
+ *  - `["#doctype"]?: XmlNode`: XML doctype
+ *  - `["#instructions"]?: { [key:string]: Arrayable<XmlNode> }`: XML processing instructions
+ *
+ * Attributes are prefixed with an arobase (`@`).
+ *
+ * ```ts
+ * console.log(parse(
+ * `
+ *   <root>
+ *     <!-- This is a comment -->
+ *     <text>hello</text>
+ *     <array>world</array>
+ *     <array>monde</array>
+ *     <array>世界</array>
+ *     <array>🌏</array>
+ *     <number>42</number>
+ *     <boolean>true</boolean>
+ *     <complex attribute="value">content</complex>
+ *   </root>
+ * `))
+ * ```
+ */ export declare function parse(content: string, options?: ParseOptions): XmlDocument;
+/**
+ * Parse a XML string into an object.
+ *
+ * Output (cleaning, flattening, reviving, etc.) can be customized using the {@link ParseOptions} parameter.
+ *
+ * Unless flattened, output nodes will contain the following non-enumerable properties (which mean they're not "visible" when iterating over, but are still explicitely accessible):
+ * - General properties
+ *   - `readonly ["~name"]: string`: tag name
+ *   - `readonly ["~parent"]: Nullable<XmlNode>`: parent node
+ *   - `["#text"]?: string`: text content
+ * - Node properties
+ *   - `readonly ["~children"]: Array<XmlNode|XmlText>`: node children
+ *   - `readonly ["#comments"]?: Array<string>`: node comments
+ *   - `readonly ["#text"]?: string`: concatenated children text content, this property becomes enumerable if at least one non-empty text node is present
+ * - XML document properties
+ *  - `["#doctype"]?: XmlNode`: XML doctype
+ *  - `["#instructions"]?: { [key:string]: Arrayable<XmlNode> }`: XML processing instructions
+ *
+ * Attributes are prefixed with an arobase (`@`).
+ *
+ * ```ts
+ * import { fromFileUrl } from "@std/path"
+ *
+ * const file = await Deno.open(fromFileUrl(import.meta.resolve("./bench/assets/small.xml")))
+ * console.log(await parse(file.readable))
+ * ```
+ */ export declare function parse(content: ReadableStream<Uint8Array>, options?: ParseOptions): Promise<XmlDocument>;

package/parse.js

@@ -0,0 +1,227 @@
+/**
+ * Parse a XML string into an object.
+ * @module
+ */ // Imports
+import { parse as std_parse } from "@std/xml/parse";
+import { parseXmlStreamFromBytes } from "@std/xml/parse-stream";
+import { finalize, xml_doctype, xml_element, xml_instruction, xml_node, xml_text } from "./_parser.js";
+export function parse(content, options) {
+  if (typeof content !== "string") return parse_stream(content, options);
+  const xml = xml_node("~xml");
+  content = content.replace(/^\s+/, "");
+  // @std sync parser only exposes a DOM tree of {declaration, root}
+  // and is missing DOCTYPE and processing instructions (they are discarded)
+  // Prescan the content to recover them first
+  content = prescan(content, xml);
+  const doc = std_parse(content, {
+    disallowDoctype: false
+  });
+  // XML declaration
+  if (doc.declaration) {
+    if (doc.declaration.version) xml["@version"] = doc.declaration.version;
+    if (doc.declaration.encoding) xml["@encoding"] = doc.declaration.encoding;
+    if (doc.declaration.standalone) xml["@standalone"] = doc.declaration.standalone;
+  }
+  build(doc.root, xml);
+  return finalize(xml, options);
+}
+/**
+ * Parse a XML stream into an object.
+ * @std streaming parser events are mapped to the same document structure as the string version,
+ * and unlike the sync DOM they natively expose the doctype and processing instructions.
+ */ async function parse_stream(content, options) {
+  const xml = xml_node("~xml");
+  const stack = [
+    xml
+  ];
+  await parseXmlStreamFromBytes(content, {
+    // XML declaration
+    onDeclaration (version, encoding, standalone) {
+      if (version) xml["@version"] = version;
+      if (encoding) xml["@encoding"] = encoding;
+      if (standalone) xml["@standalone"] = standalone;
+    },
+    // XML doctype (only the name and public/system identifiers are exposed by @std events)
+    onDoctype (name, publicId, systemId) {
+      const doctype = xml_node("~doctype", {
+        parent: xml
+      });
+      [
+        name,
+        publicId,
+        systemId
+      ].filter((value)=>value !== undefined).forEach((value)=>doctype[`@${value}`] = "");
+      xml["#doctype"] = doctype;
+    },
+    // XML processing instruction
+    onProcessingInstruction (target, instruction) {
+      xml_instruction(xml, target, instruction.trim());
+    },
+    // XML tag opened
+    onStartElement (name, _colon, _uri, attributes, selfClosing) {
+      const node = xml_element(name, stack.at(-1));
+      for(let i = 0; i < attributes.count; i++)node[`@${attributes.getName(i)}`] = attributes.getValue(i);
+      if (!selfClosing) stack.push(node);
+    },
+    // XML tag closed
+    onEndElement () {
+      stack.pop();
+    },
+    // Text
+    onText (text) {
+      xml_text(text, {
+        type: "~text",
+        parent: stack.at(-1)
+      });
+    },
+    // CDATA
+    onCData (text) {
+      xml_text(text, {
+        type: "~cdata",
+        parent: stack.at(-1)
+      });
+    },
+    // Comment
+    onComment (text) {
+      xml_text(text, {
+        type: "~comment",
+        parent: stack.at(-1)
+      });
+    }
+  }, {
+    disallowDoctype: false
+  });
+  return finalize(xml, options);
+}
+/** Recover `#doctype` and `#instructions`. */ function prescan(content, xml) {
+  // Prolog: skip whitespace/comments, collect instructions and doctype until the root element opens
+  let i = 0;
+  prolog: while(i < content.length){
+    switch(true){
+      case /\s/.test(content[i]):
+        {
+          i++;
+          continue;
+        }
+      case content.startsWith("<!--", i):
+        {
+          const end = content.indexOf("-->", i + 4);
+          if (end < 0) break prolog;
+          i = end + 3;
+          continue;
+        }
+      case content.startsWith("<?", i):
+        {
+          const end = content.indexOf("?>", i + 2);
+          if (end < 0) break prolog;
+          const raw = content.slice(i + 2, end);
+          i = end + 2;
+          const target = raw.match(/^\S+/)?.[0] ?? "";
+          // The <?xml?> declaration is already handled through std's DOM
+          if (target !== "xml") xml_instruction(xml, target, raw.slice(target.length).trim());
+          continue;
+        }
+      case content.startsWith("<!DOCTYPE", i):
+        {
+          // Find the closing ">", skipping quoted literals and the internal subset "[...]"
+          let j = i + 9;
+          doctype: while(j < content.length){
+            switch(content[j]){
+              case '"':
+              case "'":
+                {
+                  const quote = content.indexOf(content[j], j + 1);
+                  if (quote < 0) break doctype;
+                  j = quote + 1;
+                  break;
+                }
+              case "[":
+                {
+                  const bracket = content.indexOf("]", j + 1);
+                  if (bracket < 0) break doctype;
+                  j = bracket + 1;
+                  break;
+                }
+              case ">":
+                break doctype;
+              default:
+                j++;
+            }
+          }
+          xml["#doctype"] = Object.assign(xml_node("~doctype", {
+            parent: xml
+          }), xml_doctype(content.slice(i + 9, j).trim()));
+          const end = Math.min(j + 1, content.length);
+          content = `${content.slice(0, i)}${" ".repeat(end - i)}${content.slice(end)}`;
+          i = end;
+          continue;
+        }
+      default:
+        break prolog;
+    }
+  }
+  // Epilog: only comments and instructions may follow the root element, scan them backwards
+  const instructions = [];
+  let tail = content.trimEnd();
+  epilog: while(true){
+    switch(true){
+      case tail.endsWith("-->"):
+        {
+          const start = tail.lastIndexOf("<!--");
+          if (start < 0) break epilog;
+          tail = tail.slice(0, start).trimEnd();
+          continue;
+        }
+      case tail.endsWith("?>"):
+        {
+          const start = tail.lastIndexOf("<?");
+          if (start < 0) break epilog;
+          const raw = tail.slice(start + 2, -2);
+          const target = raw.match(/^\S+/)?.[0] ?? "";
+          instructions.unshift([
+            target,
+            raw.slice(target.length).trim()
+          ]);
+          tail = tail.slice(0, start).trimEnd();
+          continue;
+        }
+      default:
+        break epilog;
+    }
+  }
+  instructions.forEach(([target, raw])=>xml_instruction(xml, target, raw));
+  return content;
+}
+/** Walk a std DOM element into the ergonomic ~children/@attr/#text structure. */ function build(element, parent) {
+  // Attach under the enumerable key with array-grouping
+  const node = xml_element(element.name.raw, parent);
+  // Attributes
+  for (const [name, value] of Object.entries(element.attributes))node[`@${name}`] = value;
+  // Children
+  for (const child of element.children){
+    switch(child.type){
+      case "element":
+        build(child, node);
+        break;
+      case "text":
+        xml_text(child.text, {
+          type: "~text",
+          parent: node
+        });
+        break;
+      case "cdata":
+        xml_text(child.text, {
+          type: "~cdata",
+          parent: node
+        });
+        break;
+      case "comment":
+        xml_text(child.text, {
+          type: "~comment",
+          parent: node
+        });
+        break;
+    }
+  }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImZpbGU6Ly8vaG9tZS9ydW5uZXIvd29yay9saWJzL2xpYnMvQGxpYnMveG1sL3BhcnNlLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUGFyc2UgYSBYTUwgc3RyaW5nIGludG8gYW4gb2JqZWN0LlxuICogQG1vZHVsZVxuICovXG5cbi8vIEltcG9ydHNcbmltcG9ydCB7IHBhcnNlIGFzIHN0ZF9wYXJzZSB9IGZyb20gXCJAc3RkL3htbC9wYXJzZVwiXG5pbXBvcnQgeyBwYXJzZVhtbFN0cmVhbUZyb21CeXRlcyB9IGZyb20gXCJAc3RkL3htbC9wYXJzZS1zdHJlYW1cIlxuaW1wb3J0IHR5cGUgeyBYbWxEb2N1bWVudCBhcyBTdGREb2N1bWVudCwgWG1sRWxlbWVudCBhcyBTdGRFbGVtZW50LCBYbWxOb2RlIGFzIFN0ZE5vZGUgfSBmcm9tIFwiQHN0ZC94bWwvdHlwZXNcIlxuaW1wb3J0IHsgdHlwZSBDbGVhbk9wdGlvbnMsIGZpbmFsaXplLCB0eXBlIEZsYXR0ZW5PcHRpb25zLCB0eXBlIFJldml2ZU9wdGlvbnMsIHhtbF9kb2N0eXBlLCB4bWxfZWxlbWVudCwgeG1sX2luc3RydWN0aW9uLCB4bWxfbm9kZSwgeG1sX3RleHQgfSBmcm9tIFwiLi9fcGFyc2VyLmpzXCJcbmltcG9ydCB0eXBlIHsgWG1sRG9jdW1lbnQsIFhtbE5vZGUgfSBmcm9tIFwiLi9fdHlwZXMuanNcIlxuZXhwb3J0IHR5cGUgKiBmcm9tIFwiLi9fdHlwZXMuanNcIlxuZXhwb3J0IHR5cGUgeyBDbGVhbk9wdGlvbnMsIEZsYXR0ZW5PcHRpb25zLCBSZXZpdmVPcHRpb25zLCBSZXZpdmVyIH0gZnJvbSBcIi4vX3BhcnNlci5qc1wiXG5cbi8qKiBYTUwgcGFyc2VyIG9wdGlvbnMuICovXG5leHBvcnQgdHlwZSBQYXJzZU9wdGlvbnMgPSB7XG4gIC8qKiBSZW1vdmUgZWxlbWVudHMgZnJvbSByZXN1bHQuICovXG4gIGNsZWFuPzogQ2xlYW5PcHRpb25zXG4gIC8qKiBGbGF0dGVuIHJlc3VsdCBkZXBlbmRpbmcgb24gbm9kZSBjb250ZW50LiAqL1xuICBmbGF0dGVuPzogRmxhdHRlbk9wdGlvbnNcbiAgLyoqIFJldml2ZSByZXN1bHQuICovXG4gIHJldml2ZT86IFJldml2ZU9wdGlvbnNcbiAgLyoqXG4gICAqIFBhcnNpbmcgbW9kZS5cbiAgICogVXNpbmcgYGh0bWxgIGlzIG1vcmUgcGVybWlzc2l2ZSBhbmQgd2lsbCBub3QgdGhyb3cgb24gc29tZSBpbnZhbGlkIFhNTCBzeW50YXguXG4gICAqIE1haW5seSB1bnF1b3RlZCBhdHRyaWJ1dGVzIHdpbGwgYmUgc3VwcG9ydGVkIGFuZCBub3QgcHJvcGVybHkgY2xvc2VkIHRhZ3Mgd2lsbCBiZSBhY2NlcHRlZC5cbiAgICpcbiAgICogPiBOb3RlOiBgaHRtbGAgbW9kZSBpcyBjdXJyZW50bHkgbm90IHN1cHBvcnRlZCwgdXNlIHRoZSBXQVNNIGJhY2tlbmQgKGBAbGlicy94bWwvd2FzbS9wYXJzZWApIGluc3RlYWQuXG4gICAqID4gVHJhY2tpbmcgaXNzdWU6IGh0dHBzOi8vZ2l0aHViLmNvbS9kZW5vbGFuZC9zdGQvaXNzdWVzLzcyMTJcbiAgICovXG4gIG1vZGU/OiBcInhtbFwiXG59XG5cbi8qKlxuICogUGFyc2UgYSBYTUwgc3RyaW5nIGludG8gYW4gb2JqZWN0LlxuICpcbiAqIE91dHB1dCAoY2xlYW5pbmcsIGZsYXR0ZW5pbmcsIHJldml2aW5nLCBldGMuKSBjYW4gYmUgY3VzdG9taXplZCB1c2luZyB0aGUge0BsaW5rIFBhcnNlT3B0aW9uc30gcGFyYW1ldGVyLlxuICpcbiAqIFVubGVzcyBmbGF0dGVuZWQsIG91dHB1dCBub2RlcyB3aWxsIGNvbnRhaW4gdGhlIGZvbGxvd2luZyBub24tZW51bWVyYWJsZSBwcm9wZXJ0aWVzICh3aGljaCBtZWFuIHRoZXkncmUgbm90IFwidmlzaWJsZVwiIHdoZW4gaXRlcmF0aW5nIG92ZXIsIGJ1dCBhcmUgc3RpbGwgZXhwbGljaXRlbHkgYWNjZXNzaWJsZSk6XG4gKiAtIEdlbmVyYWwgcHJvcGVydGllc1xuICogICAtIGByZWFkb25seSBbXCJ+bmFtZVwiXTogc3RyaW5nYDogdGFnIG5hbWVcbiAqICAgLSBgcmVhZG9ubHkgW1wifnBhcmVudFwiXTogTnVsbGFibGU8WG1sTm9kZT5gOiBwYXJlbnQgbm9kZVxuICogICAtIGBbXCIjdGV4dFwiXT86IHN0cmluZ2A6IHRleHQgY29udGVudFxuICogLSBOb2RlIHByb3BlcnRpZXNcbiAqICAgLSBgcmVhZG9ubHkgW1wifmNoaWxkcmVuXCJdOiBBcnJheTxYbWxOb2RlfFhtbFRleHQ+YDogbm9kZSBjaGlsZHJlblxuICogICAtIGByZWFkb25seSBbXCIjY29tbWVudHNcIl0/OiBBcnJheTxzdHJpbmc+YDogbm9kZSBjb21tZW50c1xuICogICAtIGByZWFkb25seSBbXCIjdGV4dFwiXT86IHN0cmluZ2A6IGNvbmNhdGVuYXRlZCBjaGlsZHJlbiB0ZXh0IGNvbnRlbnQsIHRoaXMgcHJvcGVydHkgYmVjb21lcyBlbnVtZXJhYmxlIGlmIGF0IGxlYXN0IG9uZSBub24tZW1wdHkgdGV4dCBub2RlIGlzIHByZXNlbnRcbiAqIC0gWE1MIGRvY3VtZW50IHByb3BlcnRpZXNcbiAqICAtIGBbXCIjZG9jdHlwZVwiXT86IFhtbE5vZGVgOiBYTUwgZG9jdHlwZVxuICogIC0gYFtcIiNpbnN0cnVjdGlvbnNcIl0/OiB7IFtrZXk6c3RyaW5nXTogQXJyYXlhYmxlPFhtbE5vZGU+IH1gOiBYTUwgcHJvY2Vzc2luZyBpbnN0cnVjdGlvbnNcbiAqXG4gKiBBdHRyaWJ1dGVzIGFyZSBwcmVmaXhlZCB3aXRoIGFuIGFyb2Jhc2UgKGBAYCkuXG4gKlxuICogYGBgdHNcbiAqIGNvbnNvbGUubG9nKHBhcnNlKFxuICogYFxuICogICA8cm9vdD5cbiAqICAgICA8IS0tIFRoaXMgaXMgYSBjb21tZW50IC0tPlxuICogICAgIDx0ZXh0PmhlbGxvPC90ZXh0PlxuICogICAgIDxhcnJheT53b3JsZDwvYXJyYXk+XG4gKiAgICAgPGFycmF5Pm1vbmRlPC9hcnJheT5cbiAqICAgICA8YXJyYXk+5LiW55WMPC9hcnJheT5cbiAqICAgICA8YXJyYXk+8J+MjzwvYXJyYXk+XG4gKiAgICAgPG51bWJlcj40MjwvbnVtYmVyPlxuICogICAgIDxib29sZWFuPnRydWU8L2Jvb2xlYW4+XG4gKiAgICAgPGNvbXBsZXggYXR0cmlidXRlPVwidmFsdWVcIj5jb250ZW50PC9jb21wbGV4PlxuICogICA8L3Jvb3Q+XG4gKiBgKSlcbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2UoY29udGVudDogc3RyaW5nLCBvcHRpb25zPzogUGFyc2VPcHRpb25zKTogWG1sRG9jdW1lbnRcblxuLyoqXG4gKiBQYXJzZSBhIFhNTCBzdHJpbmcgaW50byBhbiBvYmplY3QuXG4gKlxuICogT3V0cHV0IChjbGVhbmluZywgZmxhdHRlbmluZywgcmV2aXZpbmcsIGV0Yy4pIGNhbiBiZSBjdXN0b21pemVkIHVzaW5nIHRoZSB7QGxpbmsgUGFyc2VPcHRpb25zfSBwYXJhbWV0ZXIuXG4gKlxuICogVW5sZXNzIGZsYXR0ZW5lZCwgb3V0cHV0IG5vZGVzIHdpbGwgY29udGFpbiB0aGUgZm9sbG93aW5nIG5vbi1lbnVtZXJhYmxlIHByb3BlcnRpZXMgKHdoaWNoIG1lYW4gdGhleSdyZSBub3QgXCJ2aXNpYmxlXCIgd2hlbiBpdGVyYXRpbmcgb3ZlciwgYnV0IGFyZSBzdGlsbCBleHBsaWNpdGVseSBhY2Nlc3NpYmxlKTpcbiAqIC0gR2VuZXJhbCBwcm9wZXJ0aWVzXG4gKiAgIC0gYHJlYWRvbmx5IFtcIn5uYW1lXCJdOiBzdHJpbmdgOiB0YWcgbmFtZVxuICogICAtIGByZWFkb25seSBbXCJ+cGFyZW50XCJdOiBOdWxsYWJsZTxYbWxOb2RlPmA6IHBhcmVudCBub2RlXG4gKiAgIC0gYFtcIiN0ZXh0XCJdPzogc3RyaW5nYDogdGV4dCBjb250ZW50XG4gKiAtIE5vZGUgcHJvcGVydGllc1xuICogICAtIGByZWFkb25seSBbXCJ+Y2hpbGRyZW5cIl06IEFycmF5PFhtbE5vZGV8WG1sVGV4dD5gOiBub2RlIGNoaWxkcmVuXG4gKiAgIC0gYHJlYWRvbmx5IFtcIiNjb21tZW50c1wiXT86IEFycmF5PHN0cmluZz5gOiBub2RlIGNvbW1lbnRzXG4gKiAgIC0gYHJlYWRvbmx5IFtcIiN0ZXh0XCJdPzogc3RyaW5nYDogY29uY2F0ZW5hdGVkIGNoaWxkcmVuIHRleHQgY29udGVudCwgdGhpcyBwcm9wZXJ0eSBiZWNvbWVzIGVudW1lcmFibGUgaWYgYXQgbGVhc3Qgb25lIG5vbi1lbXB0eSB0ZXh0IG5vZGUgaXMgcHJlc2VudFxuICogLSBYTUwgZG9jdW1lbnQgcHJvcGVydGllc1xuICogIC0gYFtcIiNkb2N0eXBlXCJdPzogWG1sTm9kZWA6IFhNTCBkb2N0eXBlXG4gKiAgLSBgW1wiI2luc3RydWN0aW9uc1wiXT86IHsgW2tleTpzdHJpbmddOiBBcnJheWFibGU8WG1sTm9kZT4gfWA6IFhNTCBwcm9jZXNzaW5nIGluc3RydWN0aW9uc1xuICpcbiAqIEF0dHJpYnV0ZXMgYXJlIHByZWZpeGVkIHdpdGggYW4gYXJvYmFzZSAoYEBgKS5cbiAqXG4gKiBgYGB0c1xuICogaW1wb3J0IHsgZnJvbUZpbGVVcmwgfSBmcm9tIFwiQHN0ZC9wYXRoXCJcbiAqXG4gKiBjb25zdCBmaWxlID0gYXdhaXQgRGVuby5vcGVuKGZyb21GaWxlVXJsKGltcG9ydC5tZXRhLnJlc29sdmUoXCIuL2JlbmNoL2Fzc2V0cy9zbWFsbC54bWxcIikpKVxuICogY29uc29sZS5sb2coYXdhaXQgcGFyc2UoZmlsZS5yZWFkYWJsZSkpXG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlKGNvbnRlbnQ6IFJlYWRhYmxlU3RyZWFtPFVpbnQ4QXJyYXk+LCBvcHRpb25zPzogUGFyc2VPcHRpb25zKTogUHJvbWlzZTxYbWxEb2N1bWVudD5cbmV4cG9ydCBmdW5jdGlvbiBwYXJzZShjb250ZW50OiBzdHJpbmcgfCBSZWFkYWJsZVN0cmVhbTxVaW50OEFycmF5Piwgb3B0aW9ucz86IFBhcnNlT3B0aW9ucyk6IFhtbERvY3VtZW50IHwgUHJvbWlzZTxYbWxEb2N1bWVudD4ge1xuICBpZiAodHlwZW9mIGNvbnRlbnQgIT09IFwic3RyaW5nXCIpXG4gICAgcmV0dXJuIHBhcnNlX3N0cmVhbShjb250ZW50LCBvcHRpb25zKVxuICBjb25zdCB4bWwgPSB4bWxfbm9kZShcIn54bWxcIikgYXMgWG1sRG9jdW1lbnRcbiAgY29udGVudCA9IGNvbnRlbnQucmVwbGFjZSgvXlxccysvLCBcIlwiKVxuICAvLyBAc3RkIHN5bmMgcGFyc2VyIG9ubHkgZXhwb3NlcyBhIERPTSB0cmVlIG9mIHtkZWNsYXJhdGlvbiwgcm9vdH1cbiAgLy8gYW5kIGlzIG1pc3NpbmcgRE9DVFlQRSBhbmQgcHJvY2Vzc2luZyBpbnN0cnVjdGlvbnMgKHRoZXkgYXJlIGRpc2NhcmRlZClcbiAgLy8gUHJlc2NhbiB0aGUgY29udGVudCB0byByZWNvdmVyIHRoZW0gZmlyc3RcbiAgY29udGVudCA9IHByZXNjYW4oY29udGVudCwgeG1sKVxuICBjb25zdCBkb2M6IFN0ZERvY3VtZW50ID0gc3RkX3BhcnNlKGNvbnRlbnQsIHsgZGlzYWxsb3dEb2N0eXBlOiBmYWxzZSB9KVxuXG4gIC8vIFhNTCBkZWNsYXJhdGlvblxuICBpZiAoZG9jLmRlY2xhcmF0aW9uKSB7XG4gICAgaWYgKGRvYy5kZWNsYXJhdGlvbi52ZXJzaW9uKVxuICAgICAgeG1sW1wiQHZlcnNpb25cIl0gPSBkb2MuZGVjbGFyYXRpb24udmVyc2lvbiBhcyB0eXBlb2YgeG1sW1wiQHZlcnNpb25cIl1cbiAgICBpZiAoZG9jLmRlY2xhcmF0aW9uLmVuY29kaW5nKVxuICAgICAgeG1sW1wiQGVuY29kaW5nXCJdID0gZG9jLmRlY2xhcmF0aW9uLmVuY29kaW5nXG4gICAgaWYgKGRvYy5kZWNsYXJhdGlvbi5zdGFuZGFsb25lKVxuICAgICAgeG1sW1wiQHN0YW5kYWxvbmVcIl0gPSBkb2MuZGVjbGFyYXRpb24uc3RhbmRhbG9uZVxuICB9XG5cbiAgYnVpbGQoZG9jLnJvb3QsIHhtbClcblxuICByZXR1cm4gZmluYWxpemUoeG1sLCBvcHRpb25zKVxufVxuXG4vKipcbiAqIFBhcnNlIGEgWE1MIHN0cmVhbSBpbnRvIGFuIG9iamVjdC5cbiAqIEBzdGQgc3RyZWFtaW5nIHBhcnNlciBldmVudHMgYXJlIG1hcHBlZCB0byB0aGUgc2FtZSBkb2N1bWVudCBzdHJ1Y3R1cmUgYXMgdGhlIHN0cmluZyB2ZXJzaW9uLFxuICogYW5kIHVubGlrZSB0aGUgc3luYyBET00gdGhleSBuYXRpdmVseSBleHBvc2UgdGhlIGRvY3R5cGUgYW5kIHByb2Nlc3NpbmcgaW5zdHJ1Y3Rpb25zLlxuICovXG5hc3luYyBmdW5jdGlvbiBwYXJzZV9zdHJlYW0oY29udGVudDogUmVhZGFibGVTdHJlYW08VWludDhBcnJheT4sIG9wdGlvbnM/OiBQYXJzZU9wdGlvbnMpOiBQcm9taXNlPFhtbERvY3VtZW50PiB7XG4gIGNvbnN0IHhtbCA9IHhtbF9ub2RlKFwifnhtbFwiKSBhcyBYbWxEb2N1bWVudFxuICBjb25zdCBzdGFjayA9IFt4bWxdIGFzIEFycmF5PFhtbE5vZGU+XG4gIGF3YWl0IHBhcnNlWG1sU3RyZWFtRnJvbUJ5dGVzKGNvbnRlbnQsIHtcbiAgICAvLyBYTUwgZGVjbGFyYXRpb25cbiAgICBvbkRlY2xhcmF0aW9uKHZlcnNpb24sIGVuY29kaW5nLCBzdGFuZGFsb25lKSB7XG4gICAgICBpZiAodmVyc2lvbilcbiAgICAgICAgeG1sW1wiQHZlcnNpb25cIl0gPSB2ZXJzaW9uIGFzIFhtbERvY3VtZW50W1wiQHZlcnNpb25cIl1cbiAgICAgIGlmIChlbmNvZGluZylcbiAgICAgICAgeG1sW1wiQGVuY29kaW5nXCJdID0gZW5jb2RpbmdcbiAgICAgIGlmIChzdGFuZGFsb25lKVxuICAgICAgICB4bWxbXCJAc3RhbmRhbG9uZVwiXSA9IHN0YW5kYWxvbmVcbiAgICB9LFxuICAgIC8vIFhNTCBkb2N0eXBlIChvbmx5IHRoZSBuYW1lIGFuZCBwdWJsaWMvc3lzdGVtIGlkZW50aWZpZXJzIGFyZSBleHBvc2VkIGJ5IEBzdGQgZXZlbnRzKVxuICAgIG9uRG9jdHlwZShuYW1lLCBwdWJsaWNJZCwgc3lzdGVtSWQpIHtcbiAgICAgIGNvbnN0IGRvY3R5cGUgPSB4bWxfbm9kZShcIn5kb2N0eXBlXCIsIHsgcGFyZW50OiB4bWwgfSlcbiAgICAgIDtbbmFtZSwgcHVibGljSWQsIHN5c3RlbUlkXS5maWx0ZXIoKHZhbHVlKSA9PiB2YWx1ZSAhPT0gdW5kZWZpbmVkKS5mb3JFYWNoKCh2YWx1ZSkgPT4gZG9jdHlwZVtgQCR7dmFsdWV9YF0gPSBcIlwiKVxuICAgICAgeG1sW1wiI2RvY3R5cGVcIl0gPSBkb2N0eXBlXG4gICAgfSxcbiAgICAvLyBYTUwgcHJvY2Vzc2luZyBpbnN0cnVjdGlvblxuICAgIG9uUHJvY2Vzc2luZ0luc3RydWN0aW9uKHRhcmdldCwgaW5zdHJ1Y3Rpb24pIHtcbiAgICAgIHhtbF9pbnN0cnVjdGlvbih4bWwsIHRhcmdldCwgaW5zdHJ1Y3Rpb24udHJpbSgpKVxuICAgIH0sXG4gICAgLy8gWE1MIHRhZyBvcGVuZWRcbiAgICBvblN0YXJ0RWxlbWVudChuYW1lLCBfY29sb24sIF91cmksIGF0dHJpYnV0ZXMsIHNlbGZDbG9zaW5nKSB7XG4gICAgICBjb25zdCBub2RlID0geG1sX2VsZW1lbnQobmFtZSwgc3RhY2suYXQoLTEpISlcbiAgICAgIGZvciAobGV0IGkgPSAwOyBpIDwgYXR0cmlidXRlcy5jb3VudDsgaSsrKVxuICAgICAgICBub2RlW2BAJHthdHRyaWJ1dGVzLmdldE5hbWUoaSl9YF0gPSBhdHRyaWJ1dGVzLmdldFZhbHVlKGkpXG4gICAgICBpZiAoIXNlbGZDbG9zaW5nKVxuICAgICAgICBzdGFjay5wdXNoKG5vZGUpXG4gICAgfSxcbiAgICAvLyBYTUwgdGFnIGNsb3NlZFxuICAgIG9uRW5kRWxlbWVudCgpIHtcbiAgICAgIHN0YWNrLnBvcCgpXG4gICAgfSxcbiAgICAvLyBUZXh0XG4gICAgb25UZXh0KHRleHQpIHtcbiAgICAgIHhtbF90ZXh0KHRleHQsIHsgdHlwZTogXCJ+dGV4dFwiLCBwYXJlbnQ6IHN0YWNrLmF0KC0xKSEgfSlcbiAgICB9LFxuICAgIC8vIENEQVRBXG4gICAgb25DRGF0YSh0ZXh0KSB7XG4gICAgICB4bWxfdGV4dCh0ZXh0LCB7IHR5cGU6IFwifmNkYXRhXCIsIHBhcmVudDogc3RhY2suYXQoLTEpISB9KVxuICAgIH0sXG4gICAgLy8gQ29tbWVudFxuICAgIG9uQ29tbWVudCh0ZXh0KSB7XG4gICAgICB4bWxfdGV4dCh0ZXh0LCB7IHR5cGU6IFwifmNvbW1lbnRcIiwgcGFyZW50OiBzdGFjay5hdCgtMSkhIH0pXG4gICAgfSxcbiAgfSwgeyBkaXNhbGxvd0RvY3R5cGU6IGZhbHNlIH0pXG4gIHJldHVybiBmaW5hbGl6ZSh4bWwsIG9wdGlvbnMpXG59XG5cbi8qKiBSZWNvdmVyIGAjZG9jdHlwZWAgYW5kIGAjaW5zdHJ1Y3Rpb25zYC4gKi9cbmZ1bmN0aW9uIHByZXNjYW4oY29udGVudDogc3RyaW5nLCB4bWw6IFhtbERvY3VtZW50KTogc3RyaW5nIHtcbiAgLy8gUHJvbG9nOiBza2lwIHdoaXRlc3BhY2UvY29tbWVudHMsIGNvbGxlY3QgaW5zdHJ1Y3Rpb25zIGFuZCBkb2N0eXBlIHVudGlsIHRoZSByb290IGVsZW1lbnQgb3BlbnNcbiAgbGV0IGkgPSAwXG4gIHByb2xvZzogd2hpbGUgKGkgPCBjb250ZW50Lmxlbmd0aCkge1xuICAgIHN3aXRjaCAodHJ1ZSkge1xuICAgICAgY2FzZSAvXFxzLy50ZXN0KGNvbnRlbnRbaV0pOiB7XG4gICAgICAgIGkrK1xuICAgICAgICBjb250aW51ZVxuICAgICAgfVxuICAgICAgY2FzZSBjb250ZW50LnN0YXJ0c1dpdGgoXCI8IS0tXCIsIGkpOiB7XG4gICAgICAgIGNvbnN0IGVuZCA9IGNvbnRlbnQuaW5kZXhPZihcIi0tPlwiLCBpICsgNClcbiAgICAgICAgaWYgKGVuZCA8IDApXG4gICAgICAgICAgYnJlYWsgcHJvbG9nXG4gICAgICAgIGkgPSBlbmQgKyAzXG4gICAgICAgIGNvbnRpbnVlXG4gICAgICB9XG4gICAgICBjYXNlIGNvbnRlbnQuc3RhcnRzV2l0aChcIjw/XCIsIGkpOiB7XG4gICAgICAgIGNvbnN0IGVuZCA9IGNvbnRlbnQuaW5kZXhPZihcIj8+XCIsIGkgKyAyKVxuICAgICAgICBpZiAoZW5kIDwgMClcbiAgICAgICAgICBicmVhayBwcm9sb2dcbiAgICAgICAgY29uc3QgcmF3ID0gY29udGVudC5zbGljZShpICsgMiwgZW5kKVxuICAgICAgICBpID0gZW5kICsgMlxuICAgICAgICBjb25zdCB0YXJnZXQgPSByYXcubWF0Y2goL15cXFMrLyk/LlswXSA/PyBcIlwiXG4gICAgICAgIC8vIFRoZSA8P3htbD8+IGRlY2xhcmF0aW9uIGlzIGFscmVhZHkgaGFuZGxlZCB0aHJvdWdoIHN0ZCdzIERPTVxuICAgICAgICBpZiAodGFyZ2V0ICE9PSBcInhtbFwiKVxuICAgICAgICAgIHhtbF9pbnN0cnVjdGlvbih4bWwsIHRhcmdldCwgcmF3LnNsaWNlKHRhcmdldC5sZW5ndGgpLnRyaW0oKSlcbiAgICAgICAgY29udGludWVcbiAgICAgIH1cbiAgICAgIGNhc2UgY29udGVudC5zdGFydHNXaXRoKFwiPCFET0NUWVBFXCIsIGkpOiB7XG4gICAgICAgIC8vIEZpbmQgdGhlIGNsb3NpbmcgXCI+XCIsIHNraXBwaW5nIHF1b3RlZCBsaXRlcmFscyBhbmQgdGhlIGludGVybmFsIHN1YnNldCBcIlsuLi5dXCJcbiAgICAgICAgbGV0IGogPSBpICsgOVxuICAgICAgICBkb2N0eXBlOiB3aGlsZSAoaiA8IGNvbnRlbnQubGVuZ3RoKSB7XG4gICAgICAgICAgc3dpdGNoIChjb250ZW50W2pdKSB7XG4gICAgICAgICAgICBjYXNlICdcIic6XG4gICAgICAgICAgICBjYXNlIFwiJ1wiOiB7XG4gICAgICAgICAgICAgIGNvbnN0IHF1b3RlID0gY29udGVudC5pbmRleE9mKGNvbnRlbnRbal0sIGogKyAxKVxuICAgICAgICAgICAgICBpZiAocXVvdGUgPCAwKVxuICAgICAgICAgICAgICAgIGJyZWFrIGRvY3R5cGVcbiAgICAgICAgICAgICAgaiA9IHF1b3RlICsgMVxuICAgICAgICAgICAgICBicmVha1xuICAgICAgICAgICAgfVxuICAgICAgICAgICAgY2FzZSBcIltcIjoge1xuICAgICAgICAgICAgICBjb25zdCBicmFja2V0ID0gY29udGVudC5pbmRleE9mKFwiXVwiLCBqICsgMSlcbiAgICAgICAgICAgICAgaWYgKGJyYWNrZXQgPCAwKVxuICAgICAgICAgICAgICAgIGJyZWFrIGRvY3R5cGVcbiAgICAgICAgICAgICAgaiA9IGJyYWNrZXQgKyAxXG4gICAgICAgICAgICAgIGJyZWFrXG4gICAgICAgICAgICB9XG4gICAgICAgICAgICBjYXNlIFwiPlwiOlxuICAgICAgICAgICAgICBicmVhayBkb2N0eXBlXG4gICAgICAgICAgICBkZWZhdWx0OlxuICAgICAgICAgICAgICBqKytcbiAgICAgICAgICB9XG4gICAgICAgIH1cbiAgICAgICAgeG1sW1wiI2RvY3R5cGVcIl0gPSBPYmplY3QuYXNzaWduKHhtbF9ub2RlKFwifmRvY3R5cGVcIiwgeyBwYXJlbnQ6IHhtbCB9KSwgeG1sX2RvY3R5cGUoY29udGVudC5zbGljZShpICsgOSwgaikudHJpbSgpKSlcbiAgICAgICAgY29uc3QgZW5kID0gTWF0aC5taW4oaiArIDEsIGNvbnRlbnQubGVuZ3RoKVxuICAgICAgICBjb250ZW50ID0gYCR7Y29udGVudC5zbGljZSgwLCBpKX0ke1wiIFwiLnJlcGVhdChlbmQgLSBpKX0ke2NvbnRlbnQuc2xpY2UoZW5kKX1gXG4gICAgICAgIGkgPSBlbmRcbiAgICAgICAgY29udGludWVcbiAgICAgIH1cbiAgICAgIGRlZmF1bHQ6XG4gICAgICAgIGJyZWFrIHByb2xvZ1xuICAgIH1cbiAgfVxuICAvLyBFcGlsb2c6IG9ubHkgY29tbWVudHMgYW5kIGluc3RydWN0aW9ucyBtYXkgZm9sbG93IHRoZSByb290IGVsZW1lbnQsIHNjYW4gdGhlbSBiYWNrd2FyZHNcbiAgY29uc3QgaW5zdHJ1Y3Rpb25zID0gW10gYXMgQXJyYXk8W3N0cmluZywgc3RyaW5nXT5cbiAgbGV0IHRhaWwgPSBjb250ZW50LnRyaW1FbmQoKVxuICBlcGlsb2c6IHdoaWxlICh0cnVlKSB7XG4gICAgc3dpdGNoICh0cnVlKSB7XG4gICAgICBjYXNlIHRhaWwuZW5kc1dpdGgoXCItLT5cIik6IHtcbiAgICAgICAgY29uc3Qgc3RhcnQgPSB0YWlsLmxhc3RJbmRleE9mKFwiPCEtLVwiKVxuICAgICAgICBpZiAoc3RhcnQgPCAwKVxuICAgICAgICAgIGJyZWFrIGVwaWxvZ1xuICAgICAgICB0YWlsID0gdGFpbC5zbGljZSgwLCBzdGFydCkudHJpbUVuZCgpXG4gICAgICAgIGNvbnRpbnVlXG4gICAgICB9XG4gICAgICBjYXNlIHRhaWwuZW5kc1dpdGgoXCI/PlwiKToge1xuICAgICAgICBjb25zdCBzdGFydCA9IHRhaWwubGFzdEluZGV4T2YoXCI8P1wiKVxuICAgICAgICBpZiAoc3RhcnQgPCAwKVxuICAgICAgICAgIGJyZWFrIGVwaWxvZ1xuICAgICAgICBjb25zdCByYXcgPSB0YWlsLnNsaWNlKHN0YXJ0ICsgMiwgLTIpXG4gICAgICAgIGNvbnN0IHRhcmdldCA9IHJhdy5tYXRjaCgvXlxcUysvKT8uWzBdID8/IFwiXCJcbiAgICAgICAgaW5zdHJ1Y3Rpb25zLnVuc2hpZnQoW3RhcmdldCwgcmF3LnNsaWNlKHRhcmdldC5sZW5ndGgpLnRyaW0oKV0pXG4gICAgICAgIHRhaWwgPSB0YWlsLnNsaWNlKDAsIHN0YXJ0KS50cmltRW5kKClcbiAgICAgICAgY29udGludWVcbiAgICAgIH1cbiAgICAgIGRlZmF1bHQ6XG4gICAgICAgIGJyZWFrIGVwaWxvZ1xuICAgIH1cbiAgfVxuICBpbnN0cnVjdGlvbnMuZm9yRWFjaCgoW3RhcmdldCwgcmF3XSkgPT4geG1sX2luc3RydWN0aW9uKHhtbCwgdGFyZ2V0LCByYXcpKVxuICByZXR1cm4gY29udGVudFxufVxuXG4vKiogV2FsayBhIHN0ZCBET00gZWxlbWVudCBpbnRvIHRoZSBlcmdvbm9taWMgfmNoaWxkcmVuL0BhdHRyLyN0ZXh0IHN0cnVjdHVyZS4gKi9cbmZ1bmN0aW9uIGJ1aWxkKGVsZW1lbnQ6IFN0ZEVsZW1lbnQsIHBhcmVudDogWG1sTm9kZSk6IHZvaWQge1xuICAvLyBBdHRhY2ggdW5kZXIgdGhlIGVudW1lcmFibGUga2V5IHdpdGggYXJyYXktZ3JvdXBpbmdcbiAgY29uc3Qgbm9kZSA9IHhtbF9lbGVtZW50KGVsZW1lbnQubmFtZS5yYXcsIHBhcmVudClcbiAgLy8gQXR0cmlidXRlc1xuICBmb3IgKGNvbnN0IFtuYW1lLCB2YWx1ZV0gb2YgT2JqZWN0LmVudHJpZXMoZWxlbWVudC5hdHRyaWJ1dGVzKSlcbiAgICBub2RlW2BAJHtuYW1lfWBdID0gdmFsdWVcbiAgLy8gQ2hpbGRyZW5cbiAgZm9yIChjb25zdCBjaGlsZCBvZiBlbGVtZW50LmNoaWxkcmVuIGFzIFJlYWRvbmx5QXJyYXk8U3RkTm9kZT4pIHtcbiAgICBzd2l0Y2ggKGNoaWxkLnR5cGUpIHtcbiAgICAgIGNhc2UgXCJlbGVtZW50XCI6XG4gICAgICAgIGJ1aWxkKGNoaWxkLCBub2RlKVxuICAgICAgICBicmVha1xuICAgICAgY2FzZSBcInRleHRcIjpcbiAgICAgICAgeG1sX3RleHQoY2hpbGQudGV4dCwgeyB0eXBlOiBcIn50ZXh0XCIsIHBhcmVudDogbm9kZSB9KVxuICAgICAgICBicmVha1xuICAgICAgY2FzZSBcImNkYXRhXCI6XG4gICAgICAgIHhtbF90ZXh0KGNoaWxkLnRleHQsIHsgdHlwZTogXCJ+Y2RhdGFcIiwgcGFyZW50OiBub2RlIH0pXG4gICAgICAgIGJyZWFrXG4gICAgICBjYXNlIFwiY29tbWVudFwiOlxuICAgICAgICB4bWxfdGV4dChjaGlsZC50ZXh0LCB7IHR5cGU6IFwifmNvbW1lbnRcIiwgcGFyZW50OiBub2RlIH0pXG4gICAgICAgIGJyZWFrXG4gICAgfVxuICB9XG59XG4iXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztDQUdDLEdBRUQsVUFBVTtBQUNWLFNBQVMsU0FBUyxTQUFTLFFBQVEsaUJBQWdCO0FBQ25ELFNBQVMsdUJBQXVCLFFBQVEsd0JBQXVCO0FBRS9ELFNBQTRC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

package/stringify.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Stringify an XML document object into a XML string.
+ * @module
+ */ import type { Nullable, Stringifyable, XmlNode, XmlText } from "./_types.js";
+export type * from "./_types.js";
+/** XML stringifier options. */ export type StringifyOptions = {
+  /** Format options. */ format?: FormatOptions;
+  /** Replace options. */ replace?: ReplaceOptions;
+};
+/** XML stringifier {@linkcode StringifyOptions}`.format` */ export type FormatOptions = {
+  /**
+   * Indent string (defaults to `"  "`).
+   * Set to empty string to disable indentation and enable minification.
+   */ indent?: string;
+  /** Break text node if its length is greater than this value (defaults to `128`). */ breakline?: number;
+};
+/** XML stringifier {@linkcode StringifyOptions}`.replace` */ export type ReplaceOptions = {
+  /**
+   * Force escape all XML entities.
+   * By default, only the ones that would break the XML structure are escaped.
+   */ entities?: boolean;
+  /**
+   * Custom replacer (this is applied after other revivals).
+   * When it is applied on an attribute, `key` and `value` will be given.
+   * When it is applied on a node, both `key` and `value` will be `null`.
+   * Return `undefined` to delete either the attribute or the tag.
+   */ custom?: Replacer;
+};
+/**
+ * Custom XML stringifier replacer.
+ * It can be used to change the way some nodes are stringified.
+ */ export type Replacer = (args: {
+  name: string;
+  key: Nullable<string>;
+  value: Nullable<string>;
+  node: Readonly<XmlNode>;
+}) => unknown;
+/**
+ * Stringify an {@link XmlDocument} object into a XML string.
+ *
+ * Output can be customized using the {@link options} parameter.
+ *
+ * ```ts
+ * import { stringify } from "./stringify.ts"
+ *
+ * console.log(stringify({
+ *   "@version": "1.0",
+ *   "@standalone": "yes",
+ *   root: {
+ *     text: "hello",
+ *     array: ["world", "monde", "世界", "🌏"],
+ *     number: 42,
+ *     boolean: true,
+ *     complex: {
+ *       "@attribute": "value",
+ *       "#text": "content",
+ *     },
+ *   }
+ * }))
+ * ```
+ */ export declare function stringify(document: Stringifyable, options?: StringifyOptions): string;
+/**
+ * Helper to create a CDATA node.
+ *
+ * ```ts
+ * import { stringify, cdata } from "./stringify.ts"
+ * stringify({ string: cdata(`hello <world>`) })
+ * // <string><![CDATA[hello <world>]]></string>
+ * ```
+ */ export declare function cdata(text: string): Omit<XmlText, "~parent">;
+/**
+ * Helper to create a comment node.
+ *
+ * ```ts
+ * import { stringify, comment } from "./stringify.ts"
+ * stringify({ string: comment(`hello world`) })
+ * // <string><!--hello world--></string>
+ * ```
+ */ export declare function comment(text: string): Omit<XmlText, "~parent">;