Adding upstream version 124.0.1.upstream/124.0.1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 38 insertions, 0 deletions

diff --git a/remote/test/puppeteer/tools/docgen/src/docgen.ts b/remote/test/puppeteer/tools/docgen/src/docgen.ts
new file mode 100644
index 0000000000..c7bafdab3d
--- /dev/null
+++ b/remote/test/puppeteer/tools/docgen/src/docgen.ts
@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2022 Google Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {ApiModel} from '@microsoft/api-extractor-model';
+
+import {MarkdownDocumenter} from './custom_markdown_documenter.js';
+
+export function docgen(jsonPath: string, outputDir: string): void {
+  const apiModel = new ApiModel();
+  apiModel.loadPackage(jsonPath);
+
+  const markdownDocumenter: MarkdownDocumenter = new MarkdownDocumenter({
+    apiModel: apiModel,
+    documenterConfig: undefined,
+    outputFolder: outputDir,
+  });
+  markdownDocumenter.generateFiles();
+}
+
+export function spliceIntoSection(
+  sectionName: string,
+  content: string,
+  sectionContent: string
+): string {
+  const lines = content.split('\n');
+  const offset =
+    lines.findIndex(line => {
+      return line.includes(`<!-- ${sectionName}-start -->`);
+    }) + 1;
+  const limit = lines.slice(offset).findIndex(line => {
+    return line.includes(`<!-- ${sectionName}-end -->`);
+  });
+  lines.splice(offset, limit, ...sectionContent.split('\n'));
+  return lines.join('\n');
+}