fix

2025-05-12 05:38:44 +09:00
parent dced21c3f8
commit 6d78bfa46e
8120 changed files with 1161564 additions and 0 deletions
--- a/book/node_modules/parse5-parser-stream/LICENSE
+++ b/book/node_modules/parse5-parser-stream/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2013-2019 Ivan Nikulin (ifaaan@gmail.com, https://github.com/inikulin)
+
+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.
--- a/book/node_modules/parse5-parser-stream/README.md
+++ b/book/node_modules/parse5-parser-stream/README.md
@@ -0,0 +1,34 @@
+<p align="center">
+    <a href="https://github.com/inikulin/parse5">
+        <img src="https://raw.github.com/inikulin/parse5/master/media/logo.png" alt="parse5" />
+    </a>
+</p>
+
+<div align="center">
+<h1>parse5-parser-stream</h1>
+<i><b>Streaming HTML parser with scripting support.</b></i>
+</div>
+<br>
+
+<div align="center">
+<code>npm install --save parse5-parser-stream</code>
+</div>
+<br>
+
+<p align="center">
+  📖 <a href="https://parse5.js.org/modules/parse5_parser_stream.html"><b>Documentation</b></a> 📖
+</p>
+
+---
+
+<p align="center">
+  <a href="https://github.com/inikulin/parse5/tree/master/docs/list-of-packages.md">List of parse5 toolset packages</a>
+</p>
+
+<p align="center">
+    <a href="https://github.com/inikulin/parse5">GitHub</a>
+</p>
+
+<p align="center">
+    <a href="https://github.com/inikulin/parse5/releases">Changelog</a>
+</p>
--- a/book/node_modules/parse5-parser-stream/dist/cjs/index.d.ts
+++ b/book/node_modules/parse5-parser-stream/dist/cjs/index.d.ts
@@ -0,0 +1,85 @@
+/// <reference types="node" resolution-mode="require"/>
+import { Writable } from 'node:stream';
+import { Parser, type ParserOptions, type TreeAdapterTypeMap, type DefaultTreeAdapterMap } from 'parse5';
+/**
+ * Streaming HTML parser with scripting support.
+ * A [writable stream](https://nodejs.org/api/stream.html#stream_class_stream_writable).
+ *
+ * @example
+ *
+ * ```js
+ * const ParserStream = require('parse5-parser-stream');
+ * const http = require('http');
+ * const { finished } = require('node:stream');
+ *
+ * // Fetch the page content and obtain it's <head> node
+ * http.get('http://inikulin.github.io/parse5/', res => {
+ *     const parser = new ParserStream();
+ *
+ *     finished(parser, () => {
+ *         console.log(parser.document.childNodes[1].childNodes[0].tagName); //> 'head'
+ *     });
+ *
+ *     res.pipe(parser);
+ * });
+ * ```
+ *
+ */
+export declare class ParserStream<T extends TreeAdapterTypeMap = DefaultTreeAdapterMap> extends Writable {
+    parser: Parser<T>;
+    static getFragmentStream<T extends TreeAdapterTypeMap>(fragmentContext?: T['parentNode'] | null, options?: ParserOptions<T>): ParserStream<T>;
+    private lastChunkWritten;
+    private writeCallback;
+    private pendingHtmlInsertions;
+    /** The resulting document node. */
+    get document(): T['document'];
+    getFragment(): T['documentFragment'];
+    /**
+     * @param options Parsing options.
+     */
+    constructor(options?: ParserOptions<T>, parser?: Parser<T>);
+    _write(chunk: string, _encoding: string, callback: () => void): void;
+    end(chunk?: any, encoding?: any, callback?: any): any;
+}
+export interface ParserStream<T extends TreeAdapterTypeMap = DefaultTreeAdapterMap> {
+    /**
+     * Raised when parser encounters a `<script>` element. If this event has listeners, parsing will be suspended once
+     * it is emitted. So, if `<script>` has the `src` attribute, you can fetch it, execute and then resume parsing just
+     * like browsers do.
+     *
+     * @example
+     *
+     * ```js
+     * const ParserStream = require('parse5-parser-stream');
+     * const http = require('http');
+     *
+     * const parser = new ParserStream();
+     *
+     * parser.on('script', (scriptElement, documentWrite, resume) => {
+     *     const src = scriptElement.attrs.find(({ name }) => name === 'src').value;
+     *
+     *     http.get(src, res => {
+     *         // Fetch the script content, execute it with DOM built around `parser.document` and
+     *         // `document.write` implemented using `documentWrite`.
+     *         ...
+     *         // Then resume parsing.
+     *         resume();
+     *     });
+     * });
+     *
+     * parser.end('<script src="example.com/script.js"></script>');
+     * ```
+     *
+     * @param event Name of the event
+     * @param handler
+     */
+    on(event: 'script', handler: (scriptElement: T['element'], documentWrite: (html: string) => void, resume: () => void) => void): void;
+    /**
+     * Base event handler.
+     *
+     * @param event Name of the event
+     * @param handler Event handler
+     */
+    on(event: string, handler: (...args: any[]) => void): this;
+}
+//# sourceMappingURL=index.d.ts.map
--- a/book/node_modules/parse5-parser-stream/dist/cjs/index.js
+++ b/book/node_modules/parse5-parser-stream/dist/cjs/index.js
@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParserStream = void 0;
+const node_stream_1 = require("node:stream");
+const parse5_1 = require("parse5");
+/* eslint-disable unicorn/consistent-function-scoping -- The rule seems to be broken here. */
+/**
+ * Streaming HTML parser with scripting support.
+ * A [writable stream](https://nodejs.org/api/stream.html#stream_class_stream_writable).
+ *
+ * @example
+ *
+ * ```js
+ * const ParserStream = require('parse5-parser-stream');
+ * const http = require('http');
+ * const { finished } = require('node:stream');
+ *
+ * // Fetch the page content and obtain it's <head> node
+ * http.get('http://inikulin.github.io/parse5/', res => {
+ *     const parser = new ParserStream();
+ *
+ *     finished(parser, () => {
+ *         console.log(parser.document.childNodes[1].childNodes[0].tagName); //> 'head'
+ *     });
+ *
+ *     res.pipe(parser);
+ * });
+ * ```
+ *
+ */
+class ParserStream extends node_stream_1.Writable {
+    static getFragmentStream(fragmentContext, options) {
+        const parser = parse5_1.Parser.getFragmentParser(fragmentContext, options);
+        const stream = new ParserStream(options, parser);
+        return stream;
+    }
+    /** The resulting document node. */
+    get document() {
+        return this.parser.document;
+    }
+    getFragment() {
+        return this.parser.getFragment();
+    }
+    /**
+     * @param options Parsing options.
+     */
+    constructor(options, parser = new parse5_1.Parser(options)) {
+        super({ decodeStrings: false });
+        this.parser = parser;
+        this.lastChunkWritten = false;
+        this.writeCallback = undefined;
+        this.pendingHtmlInsertions = [];
+        const resume = () => {
+            for (let i = this.pendingHtmlInsertions.length - 1; i >= 0; i--) {
+                this.parser.tokenizer.insertHtmlAtCurrentPos(this.pendingHtmlInsertions[i]);
+            }
+            this.pendingHtmlInsertions.length = 0;
+            //NOTE: keep parsing if we don't wait for the next input chunk
+            this.parser.tokenizer.resume(this.writeCallback);
+        };
+        const documentWrite = (html) => {
+            if (!this.parser.stopped) {
+                this.pendingHtmlInsertions.push(html);
+            }
+        };
+        const scriptHandler = (scriptElement) => {
+            if (this.listenerCount('script') > 0) {
+                this.parser.tokenizer.pause();
+                this.emit('script', scriptElement, documentWrite, resume);
+            }
+        };
+        this.parser.scriptHandler = scriptHandler;
+    }
+    //WritableStream implementation
+    _write(chunk, _encoding, callback) {
+        if (typeof chunk !== 'string') {
+            throw new TypeError('Parser can work only with string streams.');
+        }
+        this.writeCallback = callback;
+        this.parser.tokenizer.write(chunk, this.lastChunkWritten, this.writeCallback);
+    }
+    // TODO [engine:node@>=16]: Due to issues with Node < 16, we are overriding `end` instead of `_final`.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    end(chunk, encoding, callback) {
+        this.lastChunkWritten = true;
+        super.end(chunk || '', encoding, callback);
+    }
+}
+exports.ParserStream = ParserStream;
+//# sourceMappingURL=index.js.map
--- a/book/node_modules/parse5-parser-stream/dist/cjs/package.json
+++ b/book/node_modules/parse5-parser-stream/dist/cjs/package.json
@@ -0,0 +1 @@
+{"type":"commonjs"}
--- a/book/node_modules/parse5-parser-stream/dist/index.d.ts
+++ b/book/node_modules/parse5-parser-stream/dist/index.d.ts
@@ -0,0 +1,85 @@
+/// <reference types="node" resolution-mode="require"/>
+import { Writable } from 'node:stream';
+import { Parser, type ParserOptions, type TreeAdapterTypeMap, type DefaultTreeAdapterMap } from 'parse5';
+/**
+ * Streaming HTML parser with scripting support.
+ * A [writable stream](https://nodejs.org/api/stream.html#stream_class_stream_writable).
+ *
+ * @example
+ *
+ * ```js
+ * const ParserStream = require('parse5-parser-stream');
+ * const http = require('http');
+ * const { finished } = require('node:stream');
+ *
+ * // Fetch the page content and obtain it's <head> node
+ * http.get('http://inikulin.github.io/parse5/', res => {
+ *     const parser = new ParserStream();
+ *
+ *     finished(parser, () => {
+ *         console.log(parser.document.childNodes[1].childNodes[0].tagName); //> 'head'
+ *     });
+ *
+ *     res.pipe(parser);
+ * });
+ * ```
+ *
+ */
+export declare class ParserStream<T extends TreeAdapterTypeMap = DefaultTreeAdapterMap> extends Writable {
+    parser: Parser<T>;
+    static getFragmentStream<T extends TreeAdapterTypeMap>(fragmentContext?: T['parentNode'] | null, options?: ParserOptions<T>): ParserStream<T>;
+    private lastChunkWritten;
+    private writeCallback;
+    private pendingHtmlInsertions;
+    /** The resulting document node. */
+    get document(): T['document'];
+    getFragment(): T['documentFragment'];
+    /**
+     * @param options Parsing options.
+     */
+    constructor(options?: ParserOptions<T>, parser?: Parser<T>);
+    _write(chunk: string, _encoding: string, callback: () => void): void;
+    end(chunk?: any, encoding?: any, callback?: any): any;
+}
+export interface ParserStream<T extends TreeAdapterTypeMap = DefaultTreeAdapterMap> {
+    /**
+     * Raised when parser encounters a `<script>` element. If this event has listeners, parsing will be suspended once
+     * it is emitted. So, if `<script>` has the `src` attribute, you can fetch it, execute and then resume parsing just
+     * like browsers do.
+     *
+     * @example
+     *
+     * ```js
+     * const ParserStream = require('parse5-parser-stream');
+     * const http = require('http');
+     *
+     * const parser = new ParserStream();
+     *
+     * parser.on('script', (scriptElement, documentWrite, resume) => {
+     *     const src = scriptElement.attrs.find(({ name }) => name === 'src').value;
+     *
+     *     http.get(src, res => {
+     *         // Fetch the script content, execute it with DOM built around `parser.document` and
+     *         // `document.write` implemented using `documentWrite`.
+     *         ...
+     *         // Then resume parsing.
+     *         resume();
+     *     });
+     * });
+     *
+     * parser.end('<script src="example.com/script.js"></script>');
+     * ```
+     *
+     * @param event Name of the event
+     * @param handler
+     */
+    on(event: 'script', handler: (scriptElement: T['element'], documentWrite: (html: string) => void, resume: () => void) => void): void;
+    /**
+     * Base event handler.
+     *
+     * @param event Name of the event
+     * @param handler Event handler
+     */
+    on(event: string, handler: (...args: any[]) => void): this;
+}
+//# sourceMappingURL=index.d.ts.map
--- a/book/node_modules/parse5-parser-stream/dist/index.js
+++ b/book/node_modules/parse5-parser-stream/dist/index.js
@@ -0,0 +1,86 @@
+import { Writable } from 'node:stream';
+import { Parser } from 'parse5';
+/* eslint-disable unicorn/consistent-function-scoping -- The rule seems to be broken here. */
+/**
+ * Streaming HTML parser with scripting support.
+ * A [writable stream](https://nodejs.org/api/stream.html#stream_class_stream_writable).
+ *
+ * @example
+ *
+ * ```js
+ * const ParserStream = require('parse5-parser-stream');
+ * const http = require('http');
+ * const { finished } = require('node:stream');
+ *
+ * // Fetch the page content and obtain it's <head> node
+ * http.get('http://inikulin.github.io/parse5/', res => {
+ *     const parser = new ParserStream();
+ *
+ *     finished(parser, () => {
+ *         console.log(parser.document.childNodes[1].childNodes[0].tagName); //> 'head'
+ *     });
+ *
+ *     res.pipe(parser);
+ * });
+ * ```
+ *
+ */
+export class ParserStream extends Writable {
+    static getFragmentStream(fragmentContext, options) {
+        const parser = Parser.getFragmentParser(fragmentContext, options);
+        const stream = new ParserStream(options, parser);
+        return stream;
+    }
+    /** The resulting document node. */
+    get document() {
+        return this.parser.document;
+    }
+    getFragment() {
+        return this.parser.getFragment();
+    }
+    /**
+     * @param options Parsing options.
+     */
+    constructor(options, parser = new Parser(options)) {
+        super({ decodeStrings: false });
+        this.parser = parser;
+        this.lastChunkWritten = false;
+        this.writeCallback = undefined;
+        this.pendingHtmlInsertions = [];
+        const resume = () => {
+            for (let i = this.pendingHtmlInsertions.length - 1; i >= 0; i--) {
+                this.parser.tokenizer.insertHtmlAtCurrentPos(this.pendingHtmlInsertions[i]);
+            }
+            this.pendingHtmlInsertions.length = 0;
+            //NOTE: keep parsing if we don't wait for the next input chunk
+            this.parser.tokenizer.resume(this.writeCallback);
+        };
+        const documentWrite = (html) => {
+            if (!this.parser.stopped) {
+                this.pendingHtmlInsertions.push(html);
+            }
+        };
+        const scriptHandler = (scriptElement) => {
+            if (this.listenerCount('script') > 0) {
+                this.parser.tokenizer.pause();
+                this.emit('script', scriptElement, documentWrite, resume);
+            }
+        };
+        this.parser.scriptHandler = scriptHandler;
+    }
+    //WritableStream implementation
+    _write(chunk, _encoding, callback) {
+        if (typeof chunk !== 'string') {
+            throw new TypeError('Parser can work only with string streams.');
+        }
+        this.writeCallback = callback;
+        this.parser.tokenizer.write(chunk, this.lastChunkWritten, this.writeCallback);
+    }
+    // TODO [engine:node@>=16]: Due to issues with Node < 16, we are overriding `end` instead of `_final`.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    end(chunk, encoding, callback) {
+        this.lastChunkWritten = true;
+        super.end(chunk || '', encoding, callback);
+    }
+}
+//# sourceMappingURL=index.js.map
--- a/book/node_modules/parse5-parser-stream/package.json
+++ b/book/node_modules/parse5-parser-stream/package.json
@@ -0,0 +1,39 @@
+{
+    "name": "parse5-parser-stream",
+    "type": "module",
+    "description": "Streaming HTML parser with scripting support.",
+    "version": "7.1.2",
+    "author": "Ivan Nikulin <ifaaan@gmail.com> (https://github.com/inikulin)",
+    "contributors": "https://github.com/inikulin/parse5/graphs/contributors",
+    "homepage": "https://github.com/inikulin/parse5",
+    "funding": "https://github.com/inikulin/parse5?sponsor=1",
+    "keywords": [
+        "parse5",
+        "parser",
+        "stream",
+        "streaming"
+    ],
+    "license": "MIT",
+    "main": "dist/cjs/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        "import": "./dist/index.js",
+        "require": "./dist/cjs/index.js"
+    },
+    "dependencies": {
+        "parse5": "^7.0.0"
+    },
+    "scripts": {
+        "build:cjs": "tsc --module CommonJS --target ES6 --outDir dist/cjs && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git://github.com/inikulin/parse5.git"
+    },
+    "files": [
+        "dist/cjs/package.json",
+        "dist/**/*.js",
+        "dist/**/*.d.ts"
+    ]
+}