Initial commit

2025-12-03 12:00:46 +08:00
commit 5763b764a3
5365 changed files with 1483113 additions and 0 deletions
--- a/node_modules/@microsoft/tsdoc/lib-commonjs/nodes/DocFencedCode.js
+++ b/node_modules/@microsoft/tsdoc/lib-commonjs/nodes/DocFencedCode.js
@@ -0,0 +1,133 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocFencedCode = void 0;
+const DocNode_1 = require("./DocNode");
+const DocExcerpt_1 = require("./DocExcerpt");
+/**
+ * Represents CommonMark-style code fence, i.e. a block of program code that
+ * starts and ends with a line comprised of three backticks.  The opening delimiter
+ * can also specify a language for a syntax highlighter.
+ */
+class DocFencedCode extends DocNode_1.DocNode {
+    /**
+     * Don't call this directly.  Instead use {@link TSDocParser}
+     * @internal
+     */
+    constructor(parameters) {
+        super(parameters);
+        if (DocNode_1.DocNode.isParsedParameters(parameters)) {
+            this._openingFenceExcerpt = new DocExcerpt_1.DocExcerpt({
+                configuration: this.configuration,
+                excerptKind: DocExcerpt_1.ExcerptKind.FencedCode_OpeningFence,
+                content: parameters.openingFenceExcerpt
+            });
+            if (parameters.spacingAfterOpeningFenceExcerpt) {
+                this._spacingAfterOpeningFenceExcerpt = new DocExcerpt_1.DocExcerpt({
+                    configuration: this.configuration,
+                    excerptKind: DocExcerpt_1.ExcerptKind.Spacing,
+                    content: parameters.spacingAfterOpeningFenceExcerpt
+                });
+            }
+            if (parameters.languageExcerpt) {
+                this._languageExcerpt = new DocExcerpt_1.DocExcerpt({
+                    configuration: this.configuration,
+                    excerptKind: DocExcerpt_1.ExcerptKind.FencedCode_Language,
+                    content: parameters.languageExcerpt
+                });
+            }
+            if (parameters.spacingAfterLanguageExcerpt) {
+                this._spacingAfterLanguageExcerpt = new DocExcerpt_1.DocExcerpt({
+                    configuration: this.configuration,
+                    excerptKind: DocExcerpt_1.ExcerptKind.Spacing,
+                    content: parameters.spacingAfterLanguageExcerpt
+                });
+            }
+            this._codeExcerpt = new DocExcerpt_1.DocExcerpt({
+                configuration: this.configuration,
+                excerptKind: DocExcerpt_1.ExcerptKind.FencedCode_Code,
+                content: parameters.codeExcerpt
+            });
+            if (parameters.spacingBeforeClosingFenceExcerpt) {
+                this._spacingBeforeClosingFenceExcerpt = new DocExcerpt_1.DocExcerpt({
+                    configuration: this.configuration,
+                    excerptKind: DocExcerpt_1.ExcerptKind.Spacing,
+                    content: parameters.spacingBeforeClosingFenceExcerpt
+                });
+            }
+            this._closingFenceExcerpt = new DocExcerpt_1.DocExcerpt({
+                configuration: this.configuration,
+                excerptKind: DocExcerpt_1.ExcerptKind.FencedCode_ClosingFence,
+                content: parameters.closingFenceExcerpt
+            });
+            if (parameters.spacingAfterClosingFenceExcerpt) {
+                this._spacingAfterClosingFenceExcerpt = new DocExcerpt_1.DocExcerpt({
+                    configuration: this.configuration,
+                    excerptKind: DocExcerpt_1.ExcerptKind.Spacing,
+                    content: parameters.spacingAfterClosingFenceExcerpt
+                });
+            }
+        }
+        else {
+            this._code = parameters.code;
+            this._language = parameters.language;
+        }
+    }
+    /** @override */
+    get kind() {
+        return DocNode_1.DocNodeKind.FencedCode;
+    }
+    /**
+     * A name that can optionally be included after the opening code fence delimiter,
+     * on the same line as the three backticks.  This name indicates the programming language
+     * for the code, which a syntax highlighter may use to style the code block.
+     *
+     * @remarks
+     * The TSDoc standard requires that the language "ts" should be interpreted to mean TypeScript.
+     * Other languages names may be supported, but this is implementation dependent.
+     *
+     * CommonMark refers to this field as the "info string".
+     *
+     * @privateRemarks
+     * Examples of language strings supported by GitHub flavored markdown:
+     * https://raw.githubusercontent.com/github/linguist/master/lib/linguist/languages.yml
+     */
+    get language() {
+        if (this._language === undefined) {
+            if (this._languageExcerpt !== undefined) {
+                this._language = this._languageExcerpt.content.toString();
+            }
+            else {
+                this._language = '';
+            }
+        }
+        return this._language;
+    }
+    /**
+     * The text that should be rendered as code.
+     */
+    get code() {
+        if (this._code === undefined) {
+            if (this._codeExcerpt !== undefined) {
+                this._code = this._codeExcerpt.content.toString();
+            }
+        }
+        return this._code;
+    }
+    /** @override */
+    onGetChildNodes() {
+        return [
+            this._openingFenceExcerpt,
+            this._spacingAfterOpeningFenceExcerpt,
+            this._languageExcerpt,
+            this._spacingAfterLanguageExcerpt,
+            this._codeExcerpt,
+            this._spacingBeforeClosingFenceExcerpt,
+            this._closingFenceExcerpt,
+            this._spacingAfterClosingFenceExcerpt
+        ];
+    }
+}
+exports.DocFencedCode = DocFencedCode;
+//# sourceMappingURL=DocFencedCode.js.map