parse5-parser-stream 8.0.0 → 8.1.0

package/dist/index.d.ts

@@ -33,6 +33,26 @@ export declare class ParserStream<T extends TreeAdapterTypeMap = DefaultTreeAdap
     /** The resulting document node. */
     get document(): T['document'];
     getFragment(): T['documentFragment'];
+    /**
+     * Synchronously delivers buffered character tokens to the tree builder without ending the input stream.
+     * Incomplete tags and character references are retained for subsequent writes. This does not resume a
+     * suspended script or process queued writes, and must not be called from a parser callback.
+     *
+     * Flushing splits character-token runs. Their source locations do not extend through subsequently
+     * ignored input, such as CDATA delimiters or the leading newline in a `pre` element, so text-node
+     * source ranges can differ from parsing without flushing.
+     *
+     * @example
+     *
+     * ```js
+     * const stream = new ParserStream();
+     * stream.write('<p>hello');
+     * stream.flushCharacters();
+     * // The paragraph's text is now available in `stream.document`.
+     * stream.end(' world</p>');
+     * ```
+     */
+    flushCharacters(): void;
     /**
      * @param options Parsing options.
      */

package/dist/index.js

@@ -37,6 +37,28 @@ export class ParserStream extends Writable {
     getFragment() {
         return this.parser.getFragment();
     }
+    /**
+     * Synchronously delivers buffered character tokens to the tree builder without ending the input stream.
+     * Incomplete tags and character references are retained for subsequent writes. This does not resume a
+     * suspended script or process queued writes, and must not be called from a parser callback.
+     *
+     * Flushing splits character-token runs. Their source locations do not extend through subsequently
+     * ignored input, such as CDATA delimiters or the leading newline in a `pre` element, so text-node
+     * source ranges can differ from parsing without flushing.
+     *
+     * @example
+     *
+     * ```js
+     * const stream = new ParserStream();
+     * stream.write('<p>hello');
+     * stream.flushCharacters();
+     * // The paragraph's text is now available in `stream.document`.
+     * stream.end(' world</p>');
+     * ```
+     */
+    flushCharacters() {
+        this.parser.tokenizer.flushCharacters();
+    }
     /**
      * @param options Parsing options.
      */

package/package.json

@@ -2,9 +2,14 @@
     "name": "parse5-parser-stream",
     "type": "module",
     "description": "Streaming HTML parser with scripting support.",
-    "version": "8.0.0",
+    "version": "8.1.0",
     "author": "Ivan Nikulin <ifaaan@gmail.com> (https://github.com/inikulin)",
-    "contributors": "https://github.com/inikulin/parse5/graphs/contributors",
+    "contributors": [
+        "James Garbutt (https://github.com/43081j)",
+        "Felix Boehm (https://github.com/fb55)",
+        "Ivan Nikulin (https://github.com/inikulin)",
+        "Titus (https://github.com/wooorm)"
+    ],
     "homepage": "https://parse5.js.org",
     "funding": "https://github.com/inikulin/parse5?sponsor=1",
     "keywords": [
@@ -33,5 +38,8 @@
     "files": [
         "dist/**/*.js",
         "dist/**/*.d.ts"
-    ]
+    ],
+    "devDependencies": {
+        "parse5-test-utils": "1.0.0"
+    }
 }