@ntf/xml 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Night The Fox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @ntf/xml
+
+Another XML library
+
+## Why
+
+Because I like reinventing the wheel :)
+
+## Installation
+
+Use your favourite package manager, idk
+
+```sh
+npm install @ntf/xml
+```
+
+```sh
+yarn add @ntf/xml
+```
+
+```sh
+pnpm install @ntf/xml
+```
+
+## Usage
+
+### Importing
+
+This library can be used in `CommonJS` and `ESModule` environments
+
+```typescript
+const { ... } = require("@ntf/xml");
+```
+
+```typescript
+import { ... } from "@ntf/xml";
+```
+
+## License stuff that nobody reads
+
+Just like any [Open Source Project](https://github.com/N1ghtTheF0x/ntf-xml) this has a [License](./LICENSE), the MIT License

package/dist/index.d.mts

@@ -0,0 +1,186 @@
+//#region source/declaration.d.ts
+declare class XMLDeclaration {
+  version: string;
+  encoding: string;
+  standalone?: boolean | undefined;
+  static readonly START = "<?xml";
+  static readonly END = "?>";
+  static readonly DEFAULT_ENCODING = "UTF-8";
+  static readonly DEFAULT_VERSION = "1.0";
+  constructor(version?: string, encoding?: string, standalone?: boolean | undefined);
+  toString(): string;
+  get [Symbol.toStringTag](): string;
+}
+//#endregion
+//#region source/utilities.d.ts
+/**
+ * A table of characters mapped to XML escape codes
+ */
+declare const XML_ESCAPE: {
+  "<": string;
+  ">": string;
+  "&": string;
+  "'": string;
+  '"': string;
+};
+/**
+ * The media type of XML
+ */
+declare const XML_MIMETYPE = "application/xml";
+/**
+ * Escape `string` using XML escape codes
+ * @param string A string
+ */
+declare function escapeXMLString(string: string): string;
+/**
+ * Convert escaped XML string to a normal string
+ * @param string A string
+ */
+declare function unescapeXMLString(string: string): string;
+/**
+ * A symbol to tell XML elements have no content
+ */
+declare const XML_EXPLICIT_END_SYMBOL: unique symbol;
+/**
+ * The symbol used by NodeJS's `inspect` function from `node:util`
+ */
+declare const NODEJS_CUSTOM_INSPECT_SYMBOL: unique symbol;
+//#endregion
+//#region source/element.d.ts
+declare class XMLElement<P extends XMLElement.Attributes = XMLElement.Attributes> {
+  readonly type: string;
+  attributes: Partial<P>;
+  private _children;
+  private _parent?;
+  get parent(): XMLElement | undefined;
+  set parent(parent: XMLElement | undefined);
+  get children(): ReadonlyArray<XMLElement | string>;
+  set children(nodes: ReadonlyArray<XMLElement | string>);
+  get textContent(): string;
+  set textContent(value: string);
+  constructor(type: string, attributes?: Partial<P>, parent?: XMLElement, children?: Array<XMLElement | string>);
+  appendNode<Node extends XMLElement | string>(node: Node): Node;
+  append(...nodes: ReadonlyArray<XMLElement | string>): this;
+  remove(node: XMLElement | string): boolean;
+  clear(): void;
+  setAttribute<K extends keyof P>(key: K, value: P[K]): this;
+  setAttribute(key: string, value: any): this;
+  getAttribute<K extends keyof P>(key: K): P[K] | undefined;
+  getAttribute(key: string): any | undefined;
+  hasAttributes(): boolean;
+  hasAttribute<Key extends string>(key: Key): this is XMLElement<P & { [k in Key]: any }>;
+  toString(): string;
+  [Symbol.iterator](): Iterator<XMLElement | string>;
+  [NODEJS_CUSTOM_INSPECT_SYMBOL](..._args: Array<any>): string;
+  get [Symbol.toStringTag](): string;
+}
+declare namespace XMLElement {
+  type Attributes = Record<string, any>;
+}
+//#endregion
+//#region source/document.d.ts
+declare class XMLDocument {
+  root: XMLElement;
+  declaration: XMLDeclaration;
+  constructor(root: XMLElement, declaration?: XMLDeclaration);
+  toString(): string;
+  get [Symbol.toStringTag](): string;
+  [NODEJS_CUSTOM_INSPECT_SYMBOL](..._args: Array<any>): string;
+}
+//#endregion
+//#region source/builder.d.ts
+declare class XMLElementBuilder {
+  private _type?;
+  private _children;
+  private _attr;
+  constructor();
+  setType(type: string): this;
+  setAttribute(key: string, value: any): this;
+  addElement(element: XMLElement | XMLElementBuilder): this;
+  addText(text: string): this;
+  build(): XMLElement;
+}
+declare class XMLDocumentBuilder {
+  private _declaration?;
+  private _root?;
+  setDeclaration(declaration: XMLDeclaration | undefined): this;
+  setRoot(root: XMLElement | XMLElementBuilder): this;
+  build(): XMLDocument;
+}
+//#endregion
+//#region source/parser.d.ts
+/**
+ * Parse `string` as XML attributes
+ * @param string A string
+ */
+declare function parseXMLAttributes(string: string): XMLElement.Attributes;
+/**
+ * Parse `string` as a XML declaration
+ * @param string A string
+ */
+declare function parseXMLDeclaration(string: string): XMLDeclaration;
+/**
+ * Metadata of a parsed XML start tag
+ */
+interface IXMLStartTag {
+  /**
+   * The XML type
+   */
+  type: string;
+  /**
+   * The XML attributes
+   */
+  attributes: XMLElement.Attributes;
+  /**
+   * Is an end tag required?
+   */
+  requiresEnd: boolean;
+}
+/**
+ * Parse `string` to get metadata about the XML start tag
+ * @param string A string
+ */
+declare function parseXMLStartTag(string: string): IXMLStartTag;
+/**
+ * Parse `string` to a XML element
+ * @param string A string
+ * @deprecated Currently not implemented
+ * @throws {Error} Not implemented
+ */
+declare function parseXMLElement(string: string): XMLElement;
+/**
+ * Parse `string` to a XML document
+ * @param string A string
+ * @deprecated {@link parseXMLElement} is not implemented yet
+ * @throws {Error} {@link parseXMLElement} is not implemented yet
+ */
+declare function parseXMLDocument(string: string): XMLDocument;
+//#endregion
+//#region source/render.d.ts
+/**
+ * Rendering XML attributes to a string
+ * @param attributes XML attributes as a object
+ */
+declare function renderXMLAttributes(attributes: XMLElement.Attributes): string;
+/**
+ * Render the start of an XML element
+ * @param elm A XML element
+ */
+declare function renderXMLStartTag(elm: XMLElement): string;
+/**
+ * Render the end of an XML element
+ * @param elm A XML element
+ */
+declare function renderXMLEndTag(elm: XMLElement): string;
+/**
+ * Render a XML element to a string
+ * @param root A XML element
+ */
+declare function renderXMLElement(root: XMLElement): string;
+/**
+ * Render a XML document to a string
+ * @param document A XML document
+ */
+declare function renderXMLDocument(document: XMLDocument): string;
+//#endregion
+export { IXMLStartTag, NODEJS_CUSTOM_INSPECT_SYMBOL, XMLDeclaration, XMLDocument, XMLDocumentBuilder, XMLElement, XMLElementBuilder, XML_ESCAPE, XML_EXPLICIT_END_SYMBOL, XML_MIMETYPE, escapeXMLString, parseXMLAttributes, parseXMLDeclaration, parseXMLDocument, parseXMLElement, parseXMLStartTag, renderXMLAttributes, renderXMLDocument, renderXMLElement, renderXMLEndTag, renderXMLStartTag, unescapeXMLString };

package/dist/index.d.ts

@@ -0,0 +1,186 @@
+//#region source/declaration.d.ts
+declare class XMLDeclaration {
+  version: string;
+  encoding: string;
+  standalone?: boolean | undefined;
+  static readonly START = "<?xml";
+  static readonly END = "?>";
+  static readonly DEFAULT_ENCODING = "UTF-8";
+  static readonly DEFAULT_VERSION = "1.0";
+  constructor(version?: string, encoding?: string, standalone?: boolean | undefined);
+  toString(): string;
+  get [Symbol.toStringTag](): string;
+}
+//#endregion
+//#region source/utilities.d.ts
+/**
+ * A table of characters mapped to XML escape codes
+ */
+declare const XML_ESCAPE: {
+  "<": string;
+  ">": string;
+  "&": string;
+  "'": string;
+  '"': string;
+};
+/**
+ * The media type of XML
+ */
+declare const XML_MIMETYPE = "application/xml";
+/**
+ * Escape `string` using XML escape codes
+ * @param string A string
+ */
+declare function escapeXMLString(string: string): string;
+/**
+ * Convert escaped XML string to a normal string
+ * @param string A string
+ */
+declare function unescapeXMLString(string: string): string;
+/**
+ * A symbol to tell XML elements have no content
+ */
+declare const XML_EXPLICIT_END_SYMBOL: unique symbol;
+/**
+ * The symbol used by NodeJS's `inspect` function from `node:util`
+ */
+declare const NODEJS_CUSTOM_INSPECT_SYMBOL: unique symbol;
+//#endregion
+//#region source/element.d.ts
+declare class XMLElement<P extends XMLElement.Attributes = XMLElement.Attributes> {
+  readonly type: string;
+  attributes: Partial<P>;
+  private _children;
+  private _parent?;
+  get parent(): XMLElement | undefined;
+  set parent(parent: XMLElement | undefined);
+  get children(): ReadonlyArray<XMLElement | string>;
+  set children(nodes: ReadonlyArray<XMLElement | string>);
+  get textContent(): string;
+  set textContent(value: string);
+  constructor(type: string, attributes?: Partial<P>, parent?: XMLElement, children?: Array<XMLElement | string>);
+  appendNode<Node extends XMLElement | string>(node: Node): Node;
+  append(...nodes: ReadonlyArray<XMLElement | string>): this;
+  remove(node: XMLElement | string): boolean;
+  clear(): void;
+  setAttribute<K extends keyof P>(key: K, value: P[K]): this;
+  setAttribute(key: string, value: any): this;
+  getAttribute<K extends keyof P>(key: K): P[K] | undefined;
+  getAttribute(key: string): any | undefined;
+  hasAttributes(): boolean;
+  hasAttribute<Key extends string>(key: Key): this is XMLElement<P & { [k in Key]: any }>;
+  toString(): string;
+  [Symbol.iterator](): Iterator<XMLElement | string>;
+  [NODEJS_CUSTOM_INSPECT_SYMBOL](..._args: Array<any>): string;
+  get [Symbol.toStringTag](): string;
+}
+declare namespace XMLElement {
+  type Attributes = Record<string, any>;
+}
+//#endregion
+//#region source/document.d.ts
+declare class XMLDocument {
+  root: XMLElement;
+  declaration: XMLDeclaration;
+  constructor(root: XMLElement, declaration?: XMLDeclaration);
+  toString(): string;
+  get [Symbol.toStringTag](): string;
+  [NODEJS_CUSTOM_INSPECT_SYMBOL](..._args: Array<any>): string;
+}
+//#endregion
+//#region source/builder.d.ts
+declare class XMLElementBuilder {
+  private _type?;
+  private _children;
+  private _attr;
+  constructor();
+  setType(type: string): this;
+  setAttribute(key: string, value: any): this;
+  addElement(element: XMLElement | XMLElementBuilder): this;
+  addText(text: string): this;
+  build(): XMLElement;
+}
+declare class XMLDocumentBuilder {
+  private _declaration?;
+  private _root?;
+  setDeclaration(declaration: XMLDeclaration | undefined): this;
+  setRoot(root: XMLElement | XMLElementBuilder): this;
+  build(): XMLDocument;
+}
+//#endregion
+//#region source/parser.d.ts
+/**
+ * Parse `string` as XML attributes
+ * @param string A string
+ */
+declare function parseXMLAttributes(string: string): XMLElement.Attributes;
+/**
+ * Parse `string` as a XML declaration
+ * @param string A string
+ */
+declare function parseXMLDeclaration(string: string): XMLDeclaration;
+/**
+ * Metadata of a parsed XML start tag
+ */
+interface IXMLStartTag {
+  /**
+   * The XML type
+   */
+  type: string;
+  /**
+   * The XML attributes
+   */
+  attributes: XMLElement.Attributes;
+  /**
+   * Is an end tag required?
+   */
+  requiresEnd: boolean;
+}
+/**
+ * Parse `string` to get metadata about the XML start tag
+ * @param string A string
+ */
+declare function parseXMLStartTag(string: string): IXMLStartTag;
+/**
+ * Parse `string` to a XML element
+ * @param string A string
+ * @deprecated Currently not implemented
+ * @throws {Error} Not implemented
+ */
+declare function parseXMLElement(string: string): XMLElement;
+/**
+ * Parse `string` to a XML document
+ * @param string A string
+ * @deprecated {@link parseXMLElement} is not implemented yet
+ * @throws {Error} {@link parseXMLElement} is not implemented yet
+ */
+declare function parseXMLDocument(string: string): XMLDocument;
+//#endregion
+//#region source/render.d.ts
+/**
+ * Rendering XML attributes to a string
+ * @param attributes XML attributes as a object
+ */
+declare function renderXMLAttributes(attributes: XMLElement.Attributes): string;
+/**
+ * Render the start of an XML element
+ * @param elm A XML element
+ */
+declare function renderXMLStartTag(elm: XMLElement): string;
+/**
+ * Render the end of an XML element
+ * @param elm A XML element
+ */
+declare function renderXMLEndTag(elm: XMLElement): string;
+/**
+ * Render a XML element to a string
+ * @param root A XML element
+ */
+declare function renderXMLElement(root: XMLElement): string;
+/**
+ * Render a XML document to a string
+ * @param document A XML document
+ */
+declare function renderXMLDocument(document: XMLDocument): string;
+//#endregion
+export { IXMLStartTag, NODEJS_CUSTOM_INSPECT_SYMBOL, XMLDeclaration, XMLDocument, XMLDocumentBuilder, XMLElement, XMLElementBuilder, XML_ESCAPE, XML_EXPLICIT_END_SYMBOL, XML_MIMETYPE, escapeXMLString, parseXMLAttributes, parseXMLDeclaration, parseXMLDocument, parseXMLElement, parseXMLStartTag, renderXMLAttributes, renderXMLDocument, renderXMLElement, renderXMLEndTag, renderXMLStartTag, unescapeXMLString };

package/dist/index.js

@@ -0,0 +1 @@
+const e={"<":`&lt;`,">":`&gt;`,"&":`&amp;`,"'":`&apos;`,'"':`&quot;`},t=`application/xml`;function n(t){for(let[n,r]of Object.entries(e))t=t.replaceAll(n,r);return t}function r(t){for(let[n,r]of Object.entries(e))t=t.replaceAll(r,n);return t}const i=Symbol.for(`ntf-xml-explicit-end`),a=Symbol.for(`nodejs.util.inspect.custom`);var o=class e{static START=`<?xml`;static END=`?>`;static DEFAULT_ENCODING=`UTF-8`;static DEFAULT_VERSION=`1.0`;constructor(t=e.DEFAULT_VERSION,n=e.DEFAULT_ENCODING,r){this.version=t,this.encoding=n,this.standalone=r}toString(){let t=`${e.START} version="${n(this.version)}" encoding="${n(this.encoding)}"`;return typeof this.standalone==`boolean`&&(t+=` standalone="${this.standalone?`yes`:`no`}"`),t+e.END}get[Symbol.toStringTag](){return`XMLDeclaration`}},s=class{constructor(e,t=new o){this.root=e,this.declaration=t}toString(){return`${this.declaration.toString()}${this.root.toString()}`}get[Symbol.toStringTag](){return`XMLDocument`}[a](...e){return this.toString()}};function c(e){return Object.entries(e).map(function([e,t]){let r=n(e);if(t==null)return r;let i=n(String(t));return i.length===0?r:`${r}="${i}"`}).join(` `).trim()}function l(e){let t=`<${n(e.type)}`;return e.hasAttributes()&&(t+=` `+c(e.attributes)),i in e||e.children.length>0?t+`>`:t+` />`}function u(e){return i in e||e.children.length>0?`</${n(e.type)}>`:``}function d(e){let t=``,r=[{elm:e,children:[...e],index:0,started:!1}];for(;r.length>0;){let e=r[r.length-1];if(e===void 0)break;if(!e.started&&(t+=l(e.elm),e.started=!0,e.elm.children.length===0)){r.pop();continue}if(e.index>=e.children.length){t+=u(e.elm),r.pop();continue}let i=e.children[e.index++];i instanceof p&&r.push({elm:i,children:[...i],index:0,started:!1}),typeof i==`string`&&(t+=n(i))}return t}function f(e){return`${e.declaration.toString()}${d(e.root)}`}var p=class e{_children=[];_parent;get parent(){return this._parent}set parent(e){if(typeof e==`string`)throw TypeError(`cannot assign string as parent`);this._parent!==e&&(this._parent!==void 0&&this._parent.remove(this),e!==void 0&&(this._parent=e,e._children.push(this)))}get children(){return this._children}set children(e){this.clear(),this.append(...e)}get textContent(){return this._children.filter(e=>typeof e==`string`).join(``)}set textContent(e){this.children=[e]}constructor(e,t={},n,r=[]){this.type=e,this.attributes=t,this._parent=n,this.children=r}appendNode(t){return t instanceof e&&!this._children.includes(t)&&(t.parent=this),t}append(...e){for(let t of e)this.appendNode(t);return this}remove(e){let t=this._children.indexOf(e);return t<0?!1:(this._children.splice(t,1),!0)}clear(){for(let t of this._children)t instanceof e&&(t._parent=void 0);this._children=[]}setAttribute(e,t){return this.attributes[e]=t,this}getAttribute(e){return this.attributes[e]}hasAttributes(){return Object.keys(this.attributes).length>0}hasAttribute(e){return this.attributes[e]!==void 0}toString(){return`${l(this)}${this.children.length>0?`...`:``}${u(this)}`}*[Symbol.iterator](){for(let e of this._children)yield e}[a](...e){return this.toString()}get[Symbol.toStringTag](){return`XMLElement`}},m=class{_type;_children=[];_attr={};constructor(){}setType(e){return this._type=e,this}setAttribute(e,t){return this._attr[e]=t,this}addElement(e){let t=`build`in e?e.build():e;return this._children.push(t),this}addText(e){return this._children.push(e),this}build(){if(this._type===void 0)throw TypeError(`no XML type specified`);return new p(this._type,this._attr,void 0,this._children)}},h=class{_declaration;_root;setDeclaration(e){return this._declaration=e,this}setRoot(e){return this._root=`build`in e?e.build():e,this}build(){if(this._root===void 0)throw TypeError(`no XML document root specified`);return new s(this._root,this._declaration)}};function g(e){e=r(e.trim());let t={},n=``,i=``,a=0;for(let t=0;t<e.length;t++){let r=e[t];if(r===void 0)break;if(a===0){if(r===` `){o();continue}if(r===`=`){e[t+1]===`"`&&(a++,t++),a++;continue}n+=r;continue}if(a===1||a===2){if(r===` `&&a===1||r===`"`&&a===2){a=0,o();continue}i+=r;continue}}return o(),t;function o(){n.length>0&&(t[n]=i.length>0?i:void 0),n=i=``}}function _(e){if(e!==void 0){if(e=e.trim(),[`yes`,`true`,`on`].includes(e))return!0;if([`no`,`false`,`off`].includes(e))return!1;throw TypeError(`invalid XML declaration standalone value '${e}'`)}}function v(e){if(e=r(e.trim()),!e.startsWith(o.START)||!e.endsWith(o.END))throw TypeError(`XML declaration does not start with '${o.START}' and/or end with '${o.END}'`);let t=g(e.substring(o.START.length,e.length-o.END.length));if(`version`in t&&typeof t.version==`string`)return new o(t.version,`encoding`in t&&typeof t.encoding==`string`?t.encoding:void 0,_(`standalone`in t&&typeof t.standalone==`string`?t.standalone:void 0));throw TypeError(`XML declaration has no version`)}function y(e){if(e=r(e.trim()),!e.startsWith(`<`)||!e.endsWith(`>`))throw TypeError(`XML start tag does not start with < and/or ends with >`);let t=!e.endsWith(`/>`);e=e.substring(1,e.length-(e.endsWith(`/>`)?2:1));let n=e.substring(0,e.indexOf(` `));return{type:n,attributes:g(e.substring(n.length)),requiresEnd:t}}function b(e){throw Error(`not implemented`)}function x(e){e=r(e.trim());let t=e.substring(0,e.indexOf(`?>`)+2);return new s(b(e.substring(t.length)),v(t))}exports.NODEJS_CUSTOM_INSPECT_SYMBOL=a,exports.XMLDeclaration=o,exports.XMLDocument=s,exports.XMLDocumentBuilder=h,exports.XMLElement=p,exports.XMLElementBuilder=m,exports.XML_ESCAPE=e,exports.XML_EXPLICIT_END_SYMBOL=i,exports.XML_MIMETYPE=`application/xml`,exports.escapeXMLString=n,exports.parseXMLAttributes=g,exports.parseXMLDeclaration=v,exports.parseXMLDocument=x,exports.parseXMLElement=b,exports.parseXMLStartTag=y,exports.renderXMLAttributes=c,exports.renderXMLDocument=f,exports.renderXMLElement=d,exports.renderXMLEndTag=u,exports.renderXMLStartTag=l,exports.unescapeXMLString=r;

package/dist/index.mjs

@@ -0,0 +1 @@
+const e={"<":`&lt;`,">":`&gt;`,"&":`&amp;`,"'":`&apos;`,'"':`&quot;`},t=`application/xml`;function n(t){for(let[n,r]of Object.entries(e))t=t.replaceAll(n,r);return t}function r(t){for(let[n,r]of Object.entries(e))t=t.replaceAll(r,n);return t}const i=Symbol.for(`ntf-xml-explicit-end`),a=Symbol.for(`nodejs.util.inspect.custom`);var o=class e{static START=`<?xml`;static END=`?>`;static DEFAULT_ENCODING=`UTF-8`;static DEFAULT_VERSION=`1.0`;constructor(t=e.DEFAULT_VERSION,n=e.DEFAULT_ENCODING,r){this.version=t,this.encoding=n,this.standalone=r}toString(){let t=`${e.START} version="${n(this.version)}" encoding="${n(this.encoding)}"`;return typeof this.standalone==`boolean`&&(t+=` standalone="${this.standalone?`yes`:`no`}"`),t+e.END}get[Symbol.toStringTag](){return`XMLDeclaration`}},s=class{constructor(e,t=new o){this.root=e,this.declaration=t}toString(){return`${this.declaration.toString()}${this.root.toString()}`}get[Symbol.toStringTag](){return`XMLDocument`}[a](...e){return this.toString()}};function c(e){return Object.entries(e).map(function([e,t]){let r=n(e);if(t==null)return r;let i=n(String(t));return i.length===0?r:`${r}="${i}"`}).join(` `).trim()}function l(e){let t=`<${n(e.type)}`;return e.hasAttributes()&&(t+=` `+c(e.attributes)),i in e||e.children.length>0?t+`>`:t+` />`}function u(e){return i in e||e.children.length>0?`</${n(e.type)}>`:``}function d(e){let t=``,r=[{elm:e,children:[...e],index:0,started:!1}];for(;r.length>0;){let e=r[r.length-1];if(e===void 0)break;if(!e.started&&(t+=l(e.elm),e.started=!0,e.elm.children.length===0)){r.pop();continue}if(e.index>=e.children.length){t+=u(e.elm),r.pop();continue}let i=e.children[e.index++];i instanceof p&&r.push({elm:i,children:[...i],index:0,started:!1}),typeof i==`string`&&(t+=n(i))}return t}function f(e){return`${e.declaration.toString()}${d(e.root)}`}var p=class e{_children=[];_parent;get parent(){return this._parent}set parent(e){if(typeof e==`string`)throw TypeError(`cannot assign string as parent`);this._parent!==e&&(this._parent!==void 0&&this._parent.remove(this),e!==void 0&&(this._parent=e,e._children.push(this)))}get children(){return this._children}set children(e){this.clear(),this.append(...e)}get textContent(){return this._children.filter(e=>typeof e==`string`).join(``)}set textContent(e){this.children=[e]}constructor(e,t={},n,r=[]){this.type=e,this.attributes=t,this._parent=n,this.children=r}appendNode(t){return t instanceof e&&!this._children.includes(t)&&(t.parent=this),t}append(...e){for(let t of e)this.appendNode(t);return this}remove(e){let t=this._children.indexOf(e);return t<0?!1:(this._children.splice(t,1),!0)}clear(){for(let t of this._children)t instanceof e&&(t._parent=void 0);this._children=[]}setAttribute(e,t){return this.attributes[e]=t,this}getAttribute(e){return this.attributes[e]}hasAttributes(){return Object.keys(this.attributes).length>0}hasAttribute(e){return this.attributes[e]!==void 0}toString(){return`${l(this)}${this.children.length>0?`...`:``}${u(this)}`}*[Symbol.iterator](){for(let e of this._children)yield e}[a](...e){return this.toString()}get[Symbol.toStringTag](){return`XMLElement`}},m=class{_type;_children=[];_attr={};constructor(){}setType(e){return this._type=e,this}setAttribute(e,t){return this._attr[e]=t,this}addElement(e){let t=`build`in e?e.build():e;return this._children.push(t),this}addText(e){return this._children.push(e),this}build(){if(this._type===void 0)throw TypeError(`no XML type specified`);return new p(this._type,this._attr,void 0,this._children)}},h=class{_declaration;_root;setDeclaration(e){return this._declaration=e,this}setRoot(e){return this._root=`build`in e?e.build():e,this}build(){if(this._root===void 0)throw TypeError(`no XML document root specified`);return new s(this._root,this._declaration)}};function g(e){e=r(e.trim());let t={},n=``,i=``,a=0;for(let t=0;t<e.length;t++){let r=e[t];if(r===void 0)break;if(a===0){if(r===` `){o();continue}if(r===`=`){e[t+1]===`"`&&(a++,t++),a++;continue}n+=r;continue}if(a===1||a===2){if(r===` `&&a===1||r===`"`&&a===2){a=0,o();continue}i+=r;continue}}return o(),t;function o(){n.length>0&&(t[n]=i.length>0?i:void 0),n=i=``}}function _(e){if(e!==void 0){if(e=e.trim(),[`yes`,`true`,`on`].includes(e))return!0;if([`no`,`false`,`off`].includes(e))return!1;throw TypeError(`invalid XML declaration standalone value '${e}'`)}}function v(e){if(e=r(e.trim()),!e.startsWith(o.START)||!e.endsWith(o.END))throw TypeError(`XML declaration does not start with '${o.START}' and/or end with '${o.END}'`);let t=g(e.substring(o.START.length,e.length-o.END.length));if(`version`in t&&typeof t.version==`string`)return new o(t.version,`encoding`in t&&typeof t.encoding==`string`?t.encoding:void 0,_(`standalone`in t&&typeof t.standalone==`string`?t.standalone:void 0));throw TypeError(`XML declaration has no version`)}function y(e){if(e=r(e.trim()),!e.startsWith(`<`)||!e.endsWith(`>`))throw TypeError(`XML start tag does not start with < and/or ends with >`);let t=!e.endsWith(`/>`);e=e.substring(1,e.length-(e.endsWith(`/>`)?2:1));let n=e.substring(0,e.indexOf(` `));return{type:n,attributes:g(e.substring(n.length)),requiresEnd:t}}function b(e){throw Error(`not implemented`)}function x(e){e=r(e.trim());let t=e.substring(0,e.indexOf(`?>`)+2);return new s(b(e.substring(t.length)),v(t))}export{a as NODEJS_CUSTOM_INSPECT_SYMBOL,o as XMLDeclaration,s as XMLDocument,h as XMLDocumentBuilder,p as XMLElement,m as XMLElementBuilder,e as XML_ESCAPE,i as XML_EXPLICIT_END_SYMBOL,t as XML_MIMETYPE,n as escapeXMLString,g as parseXMLAttributes,v as parseXMLDeclaration,x as parseXMLDocument,b as parseXMLElement,y as parseXMLStartTag,c as renderXMLAttributes,f as renderXMLDocument,d as renderXMLElement,u as renderXMLEndTag,l as renderXMLStartTag,r as unescapeXMLString};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ntf/xml",
+  "version": "0.1.0",
+  "description": "Another XML library",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "require": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "import": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/N1ghtTheF0x/ntf-xml.git"
+  },
+  "keywords": [
+    "esm",
+    "cjs",
+    "nodejs",
+    "browser"
+  ],
+  "author": "N1ghtTheF0x",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/N1ghtTheF0x/ntf-xml/issues"
+  },
+  "homepage": "https://github.com/N1ghtTheF0x/ntf-xml#readme",
+  "devDependencies": {
+    "tsdown": "latest",
+    "typescript": "latest"
+  },
+  "scripts": {
+    "pretest": "pnpm run build",
+    "test": "node tests/test.mjs",
+    "check": "tsc --noEmit",
+    "prebuild": "pnpm check",
+    "build": "node build.mjs",
+    "build:prod": "pnpm build prod"
+  }
+}