@itwin/build-tools 3.0.0-dev.72

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright © 2017-2021 Bentley Systems, Incorporated. All rights reserved.
+
+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.

package/README.md

@@ -0,0 +1,59 @@
+# @itwin/build-tools
+
+Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
+
+## Description
+
+The **@itwin/build-tools** is a package for developers to consolidate the steps for building TypeScript-based packages. The tools contained in this package are written in either Typescript or Javascript within the src/ directory, and compiled for use into the lib/ directory. As a developer package, this package has only dependencies, no devDependencies.
+
+### tsconfig-base
+
+Location: tsconfig-base.json\
+Requires build: no
+
+This file contains common tsconfig settings across all iTwin.js packages. Packages should extend this file in their own tsconfig.json file, and then overwrite and set new properties as needed. Note that this file is different from the tsconfig.json file for this package, as that contains different settings for bentleyjs-tools only.
+
+### NPM Scripts
+
+Location: scripts/\
+Requires build: no
+
+The following node scripts are delivered in this package's scripts folder in order to ease development of iTwin.js packages with npm scripts. These scripts may require that additional packages be installed as dependencies of your package.
+
+The default behaviors of the scripts (without parameters) assume that the directory structure of your package mirrors the following:
+
+- root
+  - source
+    - test
+      - assets
+  - lib
+  - package.json
+  - tsconfig.json
+
+The following is a list of some of the most commonly used scripts within this package:
+
+#### docs.js
+
+This script runs a TypeDoc command, with specific parameters, to generate html TypeScript documentation as well as a json representation of the documentation to be consumed for other purposes. It includes the following parameters:
+
+- source - specify the TypeScript source directory
+- out - specify the directory of the html output
+- json - specify the directory and filename of the json output
+- baseUrl - specify a baseUrl to resolve modules
+- onlyJson - including this option will skip the html output and only output the json file
+- includes - directory of files to include in documentation (ex: for sample code)
+- excludes - name of directory, files, or file extensions to exclude.
+  - A list can be provided using a `,` as a separator
+  - Each of the provided to exclude is added to a glob pattern which checks all directories within the source.
+    - i.e `--excludes=test,docs/*.md` will translate to `**/{test,docs/*.md}/**/*`
+
+#### extract.js
+
+This is a script designed to extract sample code from test.ts files in a specific directory. The sample code should be surrounded by comments containing "\_\_PUBLISH_EXTRACT_START\_\_" and "\_\_PUBLISH_EXTRACT_END\_\_" directives.
+
+- extractDir - the path at which the sample code files are located
+- outDir - the path at which to output the selected code
+
+#### pseudolocalize.js
+
+This script handles translating an English localization JSON file into a pseudoLocalization file.

package/ThirdPartyNotices.md

@@ -0,0 +1,15 @@
+
+# Third-Party Code
+
+The iTwin.js library potentially incorporates work from the following third-party code:
+
+## [tslint-react-set-state-usage](https://github.com/sutrkiller/tslint-react-set-state-usage)
+
+The MIT License (MIT)
+Copyright (c) 2017 Tobias Kamenicky
+
+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.

package/bin/betools.js

@@ -0,0 +1,148 @@
+#! /usr/bin/env node
+
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+
+"use strict"
+const yargs = require("yargs");
+var path = require("path");
+var child_process = require("child_process");
+
+yargs.strict(true)
+  .wrap(Math.min(150, yargs.terminalWidth()))
+  .version("2.0.0")
+  .usage("Bentley Scripts Utility\n\n These scripts consist of several standard npm tasks an app may want to make use of.")
+  .command("test", false, {}, () => { testCommand() })
+  .command("test-tsnode", false, {}, () => { testCommand() })
+  .command("docs", "Generate TypeDoc documentation by using the provided parameters to pass to TypeDoc.  Supports generating html TypeScript documentation as well as a json representation of the documentation.",
+    function (yargs) {
+      return yargs.options({
+        "source": {
+          describe: "Specify the TypeScript source directory"
+        },
+        "out": {
+          describe: "Specify the directory of the html output"
+        },
+        "json": {
+          describe: "Specify the directory and filename of the json output"
+        },
+        "baseUrl": {
+          describe: "Specify a baseUrl to resolve modules"
+        },
+        "includes": {
+          describe: "Specify a baseUrl to resolve modules"
+        },
+        "excludes": {
+          describe: "Specify a directory, filename, or pattern to be excluded"
+        },
+        "excludeGlob": {
+          describe: "Specify a directory, filename, or pattern to be excluded"
+        },
+        "tsIndexFile": {
+          describe: "The barrel file containing the module documentation. This file is copied to the output folder for parsing."
+        },
+        "onlyJson": {
+          describe: "Specify a baseUrl to resolve modules"
+        }
+      })
+    },
+    (argv) => { docsCommand(argv) })
+  .command("extract", "Extract sample code from test files in a specific directory",
+    function (yargs) {
+      return yargs.options({
+        "extractFrom": {
+          describe: "The path at which the sample code files are located"
+        },
+        "out": {
+          describe: "The path at which to output the selected code"
+        },
+        "fileExt": {
+          describe: "The extension of the files to include"
+        },
+        "recursive": {
+          alias: "r",
+          describe: "Recursively search subdirectories from"
+        }
+      })
+    },
+    (argv) => { extractCommand(argv) })
+  .command("extract-api", "Extracts the API of the Typescript library starting from an entry file with a default presets.  Powered by @microsoft/api-extractor (https://api-extractor.com)",
+    function (yargs) {
+      return yargs.options({
+        "entry": {
+          describe: "The main Typescript entry point for the library which is compiled to the 'main' field in the package.json"
+        },
+        "ignoreMissingTags": {
+          describe: "Turns off the 'ae-missing-release-tag' option which returns an error when a missing release tag is detected"
+        }
+      })
+    },
+    (argv) => { extractApiCommand(argv) })
+  .command("pseudolocalize", "Pseudo-localizes an english localization JSON file.",
+    function (yargs) {
+      return yargs.options({
+        "englishDir": {
+          describe: "The path to the English localization folder.  Default is `./public/locales/en`"
+        },
+        "out": {
+          describe: "The output path to put the pseudo-localized files.  Default is `./public/locales/en-pseudo`"
+        }
+      })
+    },
+    (argv) => { pseudolocalizeCommand(argv) })
+  .help()
+  .argv;
+
+function testCommand(options) {
+  console.error("ERROR: The test and test-tsnode commands have been removed from betools.  Please use mocha directly instead.");
+  process.exit(1);
+}
+
+function docsCommand(options) {
+  const sourceOpt = options.source ? ["--source", options.source] : [];
+  const outOpt = options.out ? ["--out", options.out] : [];
+  const jsonOpt = options.json ? ["--json", options.json] : [];
+  const baseUrlOpt = options.baseUrl ? ["--baseUrl", options.baseUrl] : [];
+  const includesOpt = options.includes ? ["--includes", options.includes] : [];
+  const excludesOpt = options.excludes ? ["--excludes", options.excludes] : [];
+  const excludesGlobOpt = options.excludes ? ["--excludeGlob", options.excludeGlob] : [];
+  const indexFileOpt = options.tsIndexFile ? ["--tsIndexFile", options.tsIndexFile] : [];
+  const onlyJsonOpt = options.onlyJson ? ["--onlyJson"] : [];
+  exec(["node", path.resolve(__dirname, "../scripts/docs.js"),
+    ...sourceOpt, ...outOpt, ...jsonOpt, ...baseUrlOpt, ...includesOpt,
+    ...excludesOpt, ...excludesGlobOpt, ...indexFileOpt, ...onlyJsonOpt]);
+}
+
+function extractCommand(options) {
+  const extractOpt = options.extractFrom ? ["--extractFrom", options.extractFrom] : [];
+  const outOpt = options.out ? ["--out", options.out] : [];
+  const fileExt = options.fileExt ? ["--fileExt", options.fileExt] : [];
+  const recursive = options.recursive ? ["--recursive"] : [];
+  exec(["node", path.resolve(__dirname, "../scripts/extract.js"), ...extractOpt, ...outOpt, ...fileExt, ...recursive]);
+}
+
+function extractApiCommand(options) {
+  const entryOpt = options.entry ? ["--entry", options.entry] : [];
+  const ignoreTagsOpt = options.ignoreMissingTags ? ["--ignoreMissingTags"] : [];
+  exec(["node", path.resolve(__dirname, "../scripts/extract-api.js"), ...entryOpt, ...ignoreTagsOpt]);
+}
+
+function pseudolocalizeCommand(options) {
+  const englishDir = options.englishDir ? ["--englishDir", options.englishDir] : [];
+  const outOpt = options.out ? ["--out", options.out] : [];
+  exec(["node", path.resolve(__dirname, "../scripts/pseudolocalize"), ...englishDir, ...outOpt]);
+}
+
+function exec(cmd) {
+  console.log("Running command:");
+  console.log(cmd.join(" "));
+  try {
+    return child_process.execSync(cmd.join(" "), { encoding: "utf8", stdio: 'inherit' });
+  } catch (error) {
+    if (error.status)
+      process.exit(error.status);
+    throw error;
+  }
+}

package/mocha-reporter/index.js

@@ -0,0 +1,76 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable @typescript-eslint/no-var-requires */
+/* eslint-disable no-console */
+const path = require("path");
+const fs = require("fs-extra");
+const { logBuildWarning, logBuildError, failBuild } = require("../scripts/rush/utils");
+const Base = require("mocha/lib/reporters/base");
+const Spec = require("mocha/lib/reporters/spec");
+const MochaJUnitReporter = require("mocha-junit-reporter");
+function withStdErr(callback) {
+    const originalConsoleLog = Base.consoleLog;
+    Base.consoleLog = console.error;
+    callback();
+    Base.consoleLog = originalConsoleLog;
+}
+const isCI = process.env.CI || process.env.TF_BUILD;
+// Force rush test to fail CI builds if describe.only or it.only is used.
+// These should only be used for debugging and must not be committed, otherwise we may be accidentally skipping lots of tests.
+if (isCI) {
+    if (typeof (mocha) !== "undefined")
+        mocha.forbidOnly();
+    else
+        require.cache[require.resolve("mocha/lib/mocharc.json", { paths: (_b = (_a = require.main) === null || _a === void 0 ? void 0 : _a.paths) !== null && _b !== void 0 ? _b : module.paths })].exports.forbidOnly = true;
+}
+// This is necessary to enable colored output when running in rush test:
+Object.defineProperty(Base, "color", {
+    get: () => process.env.FORCE_COLOR !== "false" && process.env.FORCE_COLOR !== "0",
+    set: () => { },
+});
+class BentleyMochaReporter extends Spec {
+    constructor(_runner, _options) {
+        super(...arguments);
+        this._junitReporter = new MochaJUnitReporter(...arguments);
+    }
+    epilogue(...args) {
+        // Force test errors to be printed to stderr instead of stdout.
+        // This will allow rush to correctly summarize test failure when running rush test.
+        if (this.stats.failures) {
+            withStdErr(() => super.epilogue(...args));
+        }
+        else {
+            super.epilogue(...args);
+            if (0 === this.stats.passes) {
+                logBuildError("There were 0 passing tests.  That doesn't seem right."
+                    + "\nIf there are really no passing tests and no failures, then what was even the point?"
+                    + "\nIt seems likely that tests were skipped by it.only, it.skip, or grep filters, so I'm going to fail now.");
+                failBuild();
+            }
+        }
+        if (!this.stats.pending)
+            return;
+        // Also log warnings in CI builds when tests have been skipped.
+        const currentPkgJson = path.join(process.cwd(), "package.json");
+        if (fs.existsSync(currentPkgJson)) {
+            const currentPackage = require(currentPkgJson).name;
+            if (this.stats.pending === 1)
+                logBuildWarning(`1 test skipped in ${currentPackage}`);
+            else
+                logBuildWarning(`${this.stats.pending} tests skipped in ${currentPackage}`);
+        }
+        else {
+            if (this.stats.pending === 1)
+                logBuildWarning(`1 test skipped`);
+            else
+                logBuildWarning(`${this.stats.pending} tests skipped`);
+        }
+    }
+}
+module.exports = BentleyMochaReporter;

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@itwin/build-tools",
+  "version": "3.0.0-dev.72",
+  "description": "Bentley build tools",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/imodeljs/imodeljs/tree/master/tools/build"
+  },
+  "bin": {
+    "betools": "bin/betools.js"
+  },
+  "keywords": [
+    "Bentley",
+    "BIM",
+    "iModel"
+  ],
+  "author": {
+    "name": "Bentley Systems, Inc.",
+    "url": "http://www.bentley.com"
+  },
+  "dependencies": {
+    "@microsoft/api-extractor": "7.7.3",
+    "chalk": "^3.0.0",
+    "cpx": "^1.5.0",
+    "cross-spawn": "^7.0.1",
+    "fs-extra": "^8.1.0",
+    "glob": "^7.1.2",
+    "mocha": "^8.3.2",
+    "mocha-junit-reporter": "^1.16.0",
+    "recursive-readdir": "^2.2.2",
+    "rimraf": "^3.0.2",
+    "tree-kill": "^1.2.0",
+    "tsconfig-paths": "^3.3.2",
+    "typedoc": "^0.16.8",
+    "typedoc-plugin-external-module-name": "3.0.0",
+    "typedoc-plugin-internal-external": "2.1.1",
+    "typescript": "~4.4.0",
+    "yargs": "^16.0.0"
+  },
+  "devDependencies": {
+    "@itwin/eslint-plugin": "3.0.0-dev.72",
+    "@types/node": "14.14.31",
+    "eslint": "^7.11.0"
+  },
+  "eslintConfig": {
+    "plugins": [
+      "@itwin"
+    ],
+    "extends": "plugin:@itwin/itwinjs-recommended",
+    "rules": {
+      "deprecation/deprecation": "off"
+    }
+  },
+  "scripts": {
+    "compile": "npm run build",
+    "build": "tsc 1>&2",
+    "clean": "rimraf ../../modules .rush/temp/package-deps*.json",
+    "docs": "",
+    "lint": "eslint -f visualstudio --config package.json --no-eslintrc \"./src/**/*.ts\" 1>&2",
+    "test": "",
+    "cover": ""
+  }
+}

package/scripts/config/paths.js

@@ -0,0 +1,27 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+'use strict';
+
+const path = require('path');
+const fs = require('fs-extra');
+
+// Make sure any symlinks in the project folder are resolved:
+const appDirectory = fs.realpathSync(process.cwd());
+const resolveApp = relativePath => path.resolve(appDirectory, relativePath);
+
+module.exports = {
+  appSrc: resolveApp('src'),
+  appTest: resolveApp('src/test'),
+  appLib: resolveApp('lib'),
+  appLibPublic: resolveApp('lib/public'),
+  appLibTests: resolveApp('lib/test'),
+  appPublic: resolveApp('public'),
+  appDocs: resolveApp('lib/docs'),
+  appJsonDocs: resolveApp('lib/docs/json/file.json'),
+  appJUnitTestResults: resolveApp('lib/test/junit_results.xml'),
+  libExtract: resolveApp('lib/extract'),
+  appLocalesEnglish: resolveApp('public/locales/en'),
+  appLocalesPseudolocalize: resolveApp('public/locales/en-pseudo'),
+};

package/scripts/docs.js

@@ -0,0 +1,100 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+"use strict";
+
+process.env.NODE_ENV = "prod";
+
+const paths = require("./config/paths");
+const path = require("path");
+const cpx = require("cpx");
+const fs = require("fs");
+const { spawn, handleInterrupts } = require("./utils/simpleSpawn");
+const { validateTags } = require("./utils/validateTags");
+const argv = require("yargs").argv;
+
+// Makes the script crash on unhandled rejections instead of silently
+// ignoring them. In the future, promise rejections that are not handled will
+// terminate the Node.js process with a non-zero exit code.
+process.on("unhandledRejection", err => {
+  throw err;
+});
+
+const source = (argv.source === undefined) ? paths.appSrc : argv.source;
+const out = (argv.out === undefined) ? paths.appDocs : argv.out;
+const json = (argv.json === undefined) ? paths.appJsonDocs : argv.json;
+
+const baseUrlOptions = (argv.baseUrl === undefined) ? [] : ["--baseUrl", argv.baseUrl];
+console.log("Input: " + argv)
+const includeOptions = (argv.includes === undefined) ? [] : ["--includes", argv.includes];
+
+let excludeList = "**/node_modules/**/*,**/*test*/**/*";
+if (argv.excludes !== undefined)
+  excludeList += ",**/" + argv.excludes + "/**/*";
+if (argv.excludeGlob !== undefined)
+  excludeList += "," + argv.excludeGlob;
+
+let outputOptions = [
+  "--json", json
+];
+
+if (argv.onlyJson === undefined)
+  outputOptions = outputOptions.concat(["--out", out]);
+
+const readmeOption = (argv.readme === undefined) ? "none" : argv.readme;
+
+const options = [
+  "--excludePrivate",
+  "--experimentalDecorators",
+  "--excludeExternals",
+  "--excludeNotExported",
+  "--ignoreCompilerErrors",
+  "--hideGenerator",
+];
+
+if (argv.name) options.push("--name", argv.name);
+
+if (argv.theme) options.push("--theme", argv.theme);
+
+const args = [
+  path.resolve(process.cwd(), source),
+  ...options,
+  "--exclude", [excludeList],
+  ...outputOptions,
+  "--mode", "modules",
+  "--readme", readmeOption,
+  "--module", "commonjs",
+  "--plugin", "typedoc-plugin-external-module-name,typedoc-plugin-internal-external",
+  "--external-aliases", "alpha,internal",
+  "--internal-aliases", "UNUSED",
+  ...baseUrlOptions,
+  ...includeOptions
+];
+
+console.log("Arguments to TypeDoc: " + JSON.stringify(args, null, 2));
+
+spawn(require.resolve(".bin/typedoc"), args).then((code) => {
+  // Copy index.ts file to json output folder and rename to index.ts if a file is specified. Needed to add descriptions within the barrel file.
+  const outputDir = path.parse(json).dir;
+  if (argv.tsIndexFile) {
+    cpx.copySync(path.join(source, argv.tsIndexFile), outputDir);
+    fs.renameSync(path.join(outputDir, argv.tsIndexFile), path.join(outputDir, 'index.ts'));
+  }
+  // Copy CHANGELOG.json to json output folder
+  if (fs.existsSync(path.join(process.cwd(), 'CHANGELOG.json'))) {
+    cpx.copySync(path.join(process.cwd(), 'CHANGELOG.json'), outputDir);
+  }
+
+  if (code === 0) {
+    let tagErrors = validateTags(json);
+    if (tagErrors.toString()) {
+      console.error(`JSON contains invalid tags: ${JSON.stringify(tagErrors)}`);
+      fs.unlink(json);
+      console.log(`JSON removed from ${json}`)
+      code = 5;
+    }
+  }
+  process.exit(code)
+});
+handleInterrupts();

package/scripts/extract-api-summary.js

@@ -0,0 +1,91 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+"use strict";
+
+// The script parses api.md files, generated by the extract-api.js script (and subsequently the api-extractor.com tool), and extracts the high level API items
+// into a csv format for easier review.
+
+const path = require('path');
+const argv = require("yargs").argv;
+const fs = require("fs-extra");
+
+if (undefined === argv.apiSignature) {
+  console.log("Missing apiSignature argument.");
+  return;
+}
+
+if (!fs.existsSync(argv.apiSignature)) {
+  console.log("The api signature file does not exist.")
+  return;
+}
+
+if (undefined === argv.outDir) {
+  console.log("Missing outDir argument.");
+  return;
+}
+
+fs.ensureDir(path.normalize(argv.outDir));
+
+let shouldGenerateFullReport = false;
+if (undefined !== argv.gatherFullReport)
+  shouldGenerateFullReport = true;
+
+// create output file
+const trimmedApiSignature = (argv.apiSignature.split('.'))[0];
+const sigFileName = path.basename(path.normalize(trimmedApiSignature));
+const sigFilePath = path.join(argv.outDir, `${shouldGenerateFullReport ? "summary" : sigFileName}.exports.csv`);
+
+const outputLines = [];
+if (shouldGenerateFullReport) {
+  if (fs.existsSync(sigFilePath))
+    outputLines.push("");
+  else {
+    outputLines.push("sep=;");
+    outputLines.push("Package Name;Release Tag;API Item");
+  }
+} else {
+  fs.createFileSync(sigFilePath);
+  outputLines.push("sep=;");
+  outputLines.push("Release Tag;API Item");
+}
+
+// Open up the signature file
+fs.readFile(argv.apiSignature, function (error, data) {
+  if (error) { throw error; }
+
+  let previousLines = [];
+  data.toString().split("\n").forEach(function (line, index, arr) {
+    if (index === arr.length - 1 && line === "") { return; }
+
+    if (previousLines.length !== 0) {
+      const matches = line.match(/export \S*\s(.*)(\s{|;)/);
+      if (null !== matches) {
+        const split = matches[1].split(/(<|extends|implements)/);
+        for (const previousLine of previousLines)
+          outputLines.push(shouldGenerateFullReport ? `${sigFileName};${previousLine};${split[0]}` : `${previousLine};${split[0]}`);
+      }
+
+      previousLines = [];
+      return;
+    }
+
+    let match = line.match(/\s@(beta|alpha|public|internal)/);
+    if (null === match) {
+      previousLines = [];
+      return;
+    }
+
+    previousLines.push(match[1]);
+
+    // handle deprecated separate since it can be used together with the other release tags
+    match = line.match(/\s@(deprecated)/);
+    if (null !== match) {
+      previousLines.push(match[1]);
+      return;
+    }
+  });
+
+  shouldGenerateFullReport ? fs.appendFileSync(sigFilePath, outputLines.join("\n")) : fs.writeFileSync(sigFilePath, outputLines.join("\n"));
+});