Upload via GUI (7543 Dateien)

2026-10-22 07:02:52 +00:00
parent eb549d3975
commit 9c6a69cc53
50 changed files with 20111 additions and 0 deletions
@@ -0,0 +1,96 @@
+/// <reference lib="dom" />
+
+declare module "@xmldom/xmldom" {
+  var DOMParser: DOMParserStatic;
+  var XMLSerializer: XMLSerializerStatic;
+  var DOMImplementation: DOMImplementationStatic;
+
+  interface DOMImplementationStatic {
+      new(): DOMImplementation;
+  }
+
+  interface DOMParserStatic {
+      new (): DOMParser;
+      new (options: Options): DOMParser;
+  }
+
+  interface XMLSerializerStatic {
+      new (): XMLSerializer;
+  }
+
+  interface DOMParser {
+      parseFromString(xmlsource: string, mimeType?: string): Document;
+  }
+
+  /** Options accepted by `XMLSerializer.prototype.serializeToString`. */
+  interface XMLSerializerOptions {
+      /**
+       * When `true`, the serializer throws a DOMException with code `INVALID_STATE_ERR` if:
+       * - A CDATASection node's data contains `"]]>"`.
+       * - A Comment node's data contains `"-->"` (the injection sequence that terminates a
+       *   comment). Comments whose data contains `"--"` but not `"-->"` are accepted on this
+       *   branch — the 0.8.x parser does not validate bare `"--"` in comment content.
+       * - A ProcessingInstruction's target is not a valid XML `NCName` (a `Name` with no colon)
+       *   or is an ASCII case-insensitive match for `"xml"`, or its data contains `"?>"`
+       *   (W3C DOM Parsing §3.2.1.7).
+       * - An EntityReference's `nodeName` is not a valid XML `Name`.
+       *
+       * @default false
+       */
+      requireWellFormed?: boolean;
+  }
+
+  interface XMLSerializer {
+      /**
+       * Returns the result of serializing `node` to XML.
+       *
+       * When `options.requireWellFormed` is `true`, the serializer throws for content that would
+       * produce ill-formed XML.
+       *
+       * __This implementation differs from the specification:__
+       * - CDATASection nodes whose data contains `]]>` are serialized by splitting the section
+       *   at each `]]>` occurrence (following W3C DOM Level 3 Core `split-cdata-sections`
+       *   default behaviour) unless `requireWellFormed` is `true`.
+       * - when `requireWellFormed` is `true`, `DOMException` with code `INVALID_STATE_ERR`
+       *   is only thrown to prevent injection vectors, not for all the spec mandated checks.
+       *
+       * @throws {DOMException}
+       * With code `INVALID_STATE_ERR` when `requireWellFormed` is `true` and:
+       * - an Element's qualified name (including any namespace prefix) is not a valid XML QName,
+       * - an attribute's qualified name (including a synthesized `xmlns:` namespace declaration)
+       *   is not a valid XML QName,
+       * - a CDATASection node's data contains `"]]>"`,
+       * - a Comment node's data contains `"-->"` (bare `"--"` does not throw on this branch),
+       * - a ProcessingInstruction's target is not a valid XML `NCName` (a `Name` with no colon) or
+       *   is an ASCII case-insensitive match for `"xml"`, or its data contains `"?>"`,
+       * - a DocumentType's `name` is not a valid XML `Name` (XML 1.0 production [5]),
+       * - a DocumentType's `publicId` is non-empty and does not match the XML `PubidLiteral`
+       *   production,
+       * - a DocumentType's `systemId` is non-empty and does not match the XML `SystemLiteral`
+       *   production,
+       * - a DocumentType's `internalSubset` contains `"]>"`, or
+       * - an EntityReference's `nodeName` is not a valid XML `Name` (XML 1.0 production [5]).
+       * Note: xmldom does not enforce `readonly` on DocumentType fields — direct property
+       * writes succeed and are covered by the serializer-level checks above.
+       * @see https://html.spec.whatwg.org/#dom-xmlserializer-serializetostring
+       * @see https://w3c.github.io/DOM-Parsing/#xml-serialization
+       * @see https://github.com/w3c/DOM-Parsing/issues/84
+       */
+      serializeToString(node: Node, isHtml?: boolean, nodeFilter?: (node: Node) => Node | null | undefined, options?: XMLSerializerOptions): string;
+  }
+
+  interface Options {
+      locator?: any;
+      errorHandler?: ErrorHandlerFunction | ErrorHandlerObject | undefined;
+  }
+
+  interface ErrorHandlerFunction {
+      (level: string, msg: any): any;
+  }
+
+  interface ErrorHandlerObject {
+      warning?: ((msg: any) => any) | undefined;
+      error?: ((msg: any) => any) | undefined;
+      fatalError?: ((msg: any) => any) | undefined;
+  }
+}