From 5aaeac9547c7b7ac9b73320b44998a90fad9b99e Mon Sep 17 00:00:00 2001 From: Daniel Date: Thu, 29 Feb 2024 22:10:36 -0500 Subject: [PATCH] Properly completed Nuke update to v8 In an earlier PR, Nuke was updated but somehow not totally (bootstraping scripts and .Net runtime) --- _build/_build.csproj | 2 +- build.ps1 | 4 +- build.sh | 4 +- package-lock.json | 121 ++++++++---------- packages/react-library/package.json | 2 +- packages/stencil-library/licenses.json | 47 +------ packages/stencil-library/package-lock.json | 4 +- packages/stencil-library/package.json | 4 +- .../src/components/dnn-input/readme.md | 6 + .../dnn-vertical-splitview/readme.md | 6 + 10 files changed, 75 insertions(+), 125 deletions(-) diff --git a/_build/_build.csproj b/_build/_build.csproj index 41c377952..4dc0dd2d3 100644 --- a/_build/_build.csproj +++ b/_build/_build.csproj @@ -2,7 +2,7 @@ Exe - net6.0 + net8.0 CS0649;CS0169 .. diff --git a/build.ps1 b/build.ps1 index 54325c1f8..1f2c7a568 100644 --- a/build.ps1 +++ b/build.ps1 @@ -20,9 +20,8 @@ $DotNetGlobalFile = "$PSScriptRoot\\global.json" $DotNetInstallUrl = "https://dot.net/v1/dotnet-install.ps1" $DotNetChannel = "STS" -$env:DOTNET_SKIP_FIRST_TIME_EXPERIENCE = 1 $env:DOTNET_CLI_TELEMETRY_OPTOUT = 1 -$env:DOTNET_MULTILEVEL_LOOKUP = 0 +$env:DOTNET_NOLOGO = 1 ########################################################################### # EXECUTION @@ -61,6 +60,7 @@ else { ExecSafe { & powershell $DotNetInstallFile -InstallDir $DotNetDirectory -Version $DotNetVersion -NoPath } } $env:DOTNET_EXE = "$DotNetDirectory\dotnet.exe" + $env:PATH = "$DotNetDirectory;$env:PATH" } Write-Output "Microsoft (R) .NET SDK version $(& $env:DOTNET_EXE --version)" diff --git a/build.sh b/build.sh index 6909e8a26..e58b138f6 100755 --- a/build.sh +++ b/build.sh @@ -17,8 +17,7 @@ DOTNET_INSTALL_URL="https://dot.net/v1/dotnet-install.sh" DOTNET_CHANNEL="STS" export DOTNET_CLI_TELEMETRY_OPTOUT=1 -export DOTNET_SKIP_FIRST_TIME_EXPERIENCE=1 -export DOTNET_MULTILEVEL_LOOKUP=0 +export DOTNET_NOLOGO=1 ########################################################################### # EXECUTION @@ -54,6 +53,7 @@ else "$DOTNET_INSTALL_FILE" --install-dir "$DOTNET_DIRECTORY" --version "$DOTNET_VERSION" --no-path fi export DOTNET_EXE="$DOTNET_DIRECTORY/dotnet" + export PATH="$DOTNET_DIRECTORY:$PATH" fi echo "Microsoft (R) .NET SDK version $("$DOTNET_EXE" --version)" diff --git a/package-lock.json b/package-lock.json index f0d3166b0..150d1104e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -2742,9 +2742,9 @@ } }, "node_modules/@eslint/js": { - "version": "8.56.0", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.56.0.tgz", - "integrity": "sha512-gMsVel9D7f2HLkBma9VbtzZRehRogVRfbr++f06nL2vnCGCNlzOD+/MUov/F4p8myyAHspEhVobgjpX64q5m6A==", + "version": "8.57.0", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.0.tgz", + "integrity": "sha512-Ys+3g2TaW7gADOJzPt83SJtCDhMjndcDMFVQ/Tj9iA1BfJzFKD9mAUXT3OenpuPHbI6P/myECxRJrofUsDx/5g==", "dev": true, "peer": true, "engines": { @@ -2796,14 +2796,14 @@ "dev": true }, "node_modules/@humanwhocodes/config-array": { - "version": "0.11.13", - "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.11.13.tgz", - "integrity": "sha512-JSBDMiDKSzQVngfRjOdFXgFfklaXI4K9nLF49Auh21lmBWRLIK3+xTErTWD4KU54pb6coM6ESE7Awz/FNU3zgQ==", + "version": "0.11.14", + "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.11.14.tgz", + "integrity": "sha512-3T8LkOmg45BV5FICb15QQMsyUSWrQ8AygVfC7ZG32zOalnqrilm018ZVCw0eapXux8FtA33q8PSRSstjee3jSg==", "dev": true, "peer": true, "dependencies": { - "@humanwhocodes/object-schema": "^2.0.1", - "debug": "^4.1.1", + "@humanwhocodes/object-schema": "^2.0.2", + "debug": "^4.3.1", "minimatch": "^3.0.5" }, "engines": { @@ -2811,9 +2811,9 @@ } }, "node_modules/@humanwhocodes/config-array/node_modules/@humanwhocodes/object-schema": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.1.tgz", - "integrity": "sha512-dvuCeX5fC9dXgJn9t+X5atfmgQAzUOWqS1254Gh0m6i8wKd10ebXkfNKiRK+1GWi/yTvvLDHpoxLr0xxxeslWw==", + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.2.tgz", + "integrity": "sha512-6EwiSjwWYP7pTckG6I5eyFANjPhmPjUX9JRLUSfNPC7FX7zK9gyZAfUEaECL6ALTpGX5AjnBq3C9XmVWPitNpw==", "dev": true, "peer": true }, @@ -12589,16 +12589,6 @@ "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", "dev": true }, - "node_modules/core-js": { - "version": "3.32.1", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.32.1.tgz", - "integrity": "sha512-lqufgNn9NLnESg5mQeYsxQP5w7wrViSj0jr/kv6ECQiByzQkrn1MKvV0L3acttpDqfQrHLwr2KCMgX5b8X+lyQ==", - "hasInstallScript": true, - "funding": { - "type": "opencollective", - "url": "https://opencollective.com/core-js" - } - }, "node_modules/core-js-compat": { "version": "3.35.1", "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.35.1.tgz", @@ -13878,17 +13868,17 @@ } }, "node_modules/eslint": { - "version": "8.56.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.56.0.tgz", - "integrity": "sha512-Go19xM6T9puCOWntie1/P997aXxFsOi37JIHRWI514Hc6ZnaHGKY9xFhrU65RT6CcBEzZoGG1e6Nq+DT04ZtZQ==", + "version": "8.57.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.0.tgz", + "integrity": "sha512-dZ6+mexnaTIbSBZWgou51U6OmzIhYM2VcNdtiTtI7qPNZm35Akpr0f6vtw3w1Kmn5PYo+tZVfh13WrhpS6oLqQ==", "dev": true, "peer": true, "dependencies": { "@eslint-community/eslint-utils": "^4.2.0", "@eslint-community/regexpp": "^4.6.1", "@eslint/eslintrc": "^2.1.4", - "@eslint/js": "8.56.0", - "@humanwhocodes/config-array": "^0.11.13", + "@eslint/js": "8.57.0", + "@humanwhocodes/config-array": "^0.11.14", "@humanwhocodes/module-importer": "^1.0.1", "@nodelib/fs.walk": "^1.2.8", "@ungap/structured-clone": "^1.2.0", @@ -18419,6 +18409,14 @@ "@types/yargs-parser": "*" } }, + "node_modules/jodit": { + "version": "4.0.16", + "resolved": "https://registry.npmjs.org/jodit/-/jodit-4.0.16.tgz", + "integrity": "sha512-TfmHfuT5JNKdtRQ0m2cJMHRDQZb/0jBfX233TOVDCBG7jajbSQ5uNQYBkggBMNwUVn0kGcVGG8QjaHgTvLGA4A==", + "dependencies": { + "autobind-decorator": "^2.4.0" + } + }, "node_modules/js-tokens": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", @@ -26652,7 +26650,7 @@ }, "packages/react-library": { "name": "@dnncommunity/dnn-elements-react", - "version": "0.18.0-alpha.61", + "version": "0.23.3-alpha.7", "license": "MIT", "dependencies": { "@dnncommunity/dnn-elements": "*" @@ -26678,10 +26676,10 @@ }, "packages/stencil-library": { "name": "@dnncommunity/dnn-elements", - "version": "0.18.0-alpha.61", + "version": "0.23.3-alpha.7", "license": "MIT", "dependencies": { - "jodit": "^3.24.9" + "jodit": "^4.0.6" }, "devDependencies": { "@stencil/core": "4.12.2", @@ -26895,15 +26893,6 @@ "node": ">= 4" } }, - "packages/stencil-library/node_modules/jodit": { - "version": "3.24.9", - "resolved": "https://registry.npmjs.org/jodit/-/jodit-3.24.9.tgz", - "integrity": "sha512-t2d73v7GFbGI08ZzdCTwrzi8ZtoOG4icGzD6IIN2e+ghlpUKYxcHZ/Rmy6/mc6055172z+tv7QSr9BcOz6IOFQ==", - "dependencies": { - "autobind-decorator": "^2.4.0", - "core-js": "^3.28.0" - } - }, "packages/stencil-library/node_modules/tslib": { "version": "1.14.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz", @@ -28566,7 +28555,7 @@ "gh-pages": "^6.0.0", "jest": "^29.7.0", "jest-cli": "^29.7.0", - "jodit": "^3.24.9", + "jodit": "^4.0.6", "license-checker-rseidelsohn": "^4.2.6", "lit": "^3.1.0", "npm-run-all": "^4.1.5", @@ -28718,15 +28707,6 @@ "integrity": "sha512-cyFDKrqc/YdcWFniJhzI42+AzS+gNwmUzOSFcRCQYwySuBBBy/KjuxWLZ/FHEH6Moq1NizMOBWyTcv8O4OZIMg==", "dev": true }, - "jodit": { - "version": "3.24.9", - "resolved": "https://registry.npmjs.org/jodit/-/jodit-3.24.9.tgz", - "integrity": "sha512-t2d73v7GFbGI08ZzdCTwrzi8ZtoOG4icGzD6IIN2e+ghlpUKYxcHZ/Rmy6/mc6055172z+tv7QSr9BcOz6IOFQ==", - "requires": { - "autobind-decorator": "^2.4.0", - "core-js": "^3.28.0" - } - }, "tslib": { "version": "1.14.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz", @@ -28994,9 +28974,9 @@ } }, "@eslint/js": { - "version": "8.56.0", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.56.0.tgz", - "integrity": "sha512-gMsVel9D7f2HLkBma9VbtzZRehRogVRfbr++f06nL2vnCGCNlzOD+/MUov/F4p8myyAHspEhVobgjpX64q5m6A==", + "version": "8.57.0", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.0.tgz", + "integrity": "sha512-Ys+3g2TaW7gADOJzPt83SJtCDhMjndcDMFVQ/Tj9iA1BfJzFKD9mAUXT3OenpuPHbI6P/myECxRJrofUsDx/5g==", "dev": true, "peer": true }, @@ -29041,21 +29021,21 @@ "dev": true }, "@humanwhocodes/config-array": { - "version": "0.11.13", - "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.11.13.tgz", - "integrity": "sha512-JSBDMiDKSzQVngfRjOdFXgFfklaXI4K9nLF49Auh21lmBWRLIK3+xTErTWD4KU54pb6coM6ESE7Awz/FNU3zgQ==", + "version": "0.11.14", + "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.11.14.tgz", + "integrity": "sha512-3T8LkOmg45BV5FICb15QQMsyUSWrQ8AygVfC7ZG32zOalnqrilm018ZVCw0eapXux8FtA33q8PSRSstjee3jSg==", "dev": true, "peer": true, "requires": { - "@humanwhocodes/object-schema": "^2.0.1", - "debug": "^4.1.1", + "@humanwhocodes/object-schema": "^2.0.2", + "debug": "^4.3.1", "minimatch": "^3.0.5" }, "dependencies": { "@humanwhocodes/object-schema": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.1.tgz", - "integrity": "sha512-dvuCeX5fC9dXgJn9t+X5atfmgQAzUOWqS1254Gh0m6i8wKd10ebXkfNKiRK+1GWi/yTvvLDHpoxLr0xxxeslWw==", + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.2.tgz", + "integrity": "sha512-6EwiSjwWYP7pTckG6I5eyFANjPhmPjUX9JRLUSfNPC7FX7zK9gyZAfUEaECL6ALTpGX5AjnBq3C9XmVWPitNpw==", "dev": true, "peer": true } @@ -36340,11 +36320,6 @@ "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", "dev": true }, - "core-js": { - "version": "3.32.1", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.32.1.tgz", - "integrity": "sha512-lqufgNn9NLnESg5mQeYsxQP5w7wrViSj0jr/kv6ECQiByzQkrn1MKvV0L3acttpDqfQrHLwr2KCMgX5b8X+lyQ==" - }, "core-js-compat": { "version": "3.35.1", "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.35.1.tgz", @@ -37344,17 +37319,17 @@ } }, "eslint": { - "version": "8.56.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.56.0.tgz", - "integrity": "sha512-Go19xM6T9puCOWntie1/P997aXxFsOi37JIHRWI514Hc6ZnaHGKY9xFhrU65RT6CcBEzZoGG1e6Nq+DT04ZtZQ==", + "version": "8.57.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.0.tgz", + "integrity": "sha512-dZ6+mexnaTIbSBZWgou51U6OmzIhYM2VcNdtiTtI7qPNZm35Akpr0f6vtw3w1Kmn5PYo+tZVfh13WrhpS6oLqQ==", "dev": true, "peer": true, "requires": { "@eslint-community/eslint-utils": "^4.2.0", "@eslint-community/regexpp": "^4.6.1", "@eslint/eslintrc": "^2.1.4", - "@eslint/js": "8.56.0", - "@humanwhocodes/config-array": "^0.11.13", + "@eslint/js": "8.57.0", + "@humanwhocodes/config-array": "^0.11.14", "@humanwhocodes/module-importer": "^1.0.1", "@nodelib/fs.walk": "^1.2.8", "@ungap/structured-clone": "^1.2.0", @@ -40813,6 +40788,14 @@ } } }, + "jodit": { + "version": "4.0.16", + "resolved": "https://registry.npmjs.org/jodit/-/jodit-4.0.16.tgz", + "integrity": "sha512-TfmHfuT5JNKdtRQ0m2cJMHRDQZb/0jBfX233TOVDCBG7jajbSQ5uNQYBkggBMNwUVn0kGcVGG8QjaHgTvLGA4A==", + "requires": { + "autobind-decorator": "^2.4.0" + } + }, "js-tokens": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", diff --git a/packages/react-library/package.json b/packages/react-library/package.json index 1dc8f2677..bf6897bdc 100644 --- a/packages/react-library/package.json +++ b/packages/react-library/package.json @@ -1,6 +1,6 @@ { "name": "@dnncommunity/dnn-elements-react", - "version": "0.18.0-alpha.61", + "version": "0.23.3-alpha.7", "description": "Dnn themed custom elements with react wrappers.", "homepage": "https://github.com/valadas/dnn-elements", "license": "MIT", diff --git a/packages/stencil-library/licenses.json b/packages/stencil-library/licenses.json index 9fd9d30c7..79da9b08a 100644 --- a/packages/stencil-library/licenses.json +++ b/packages/stencil-library/licenses.json @@ -7,7 +7,7 @@ "path": "node_modules\\@babel\\code-frame", "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@babel\\code-frame\\LICENSE" }, - "@dnncommunity/dnn-elements@0.18.0-alpha.61": { + "@dnncommunity/dnn-elements@0.23.3-alpha.7": { "licenses": "MIT", "repository": "https://github.com/dnncommunity/dnn-elements", "path": "", @@ -33,36 +33,6 @@ "path": "node_modules\\@stencil\\eslint-plugin", "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@stencil\\eslint-plugin\\LICENSE.md" }, - "@typescript-eslint/parser@4.33.0": { - "licenses": "BSD-2-Clause", - "repository": "https://github.com/typescript-eslint/typescript-eslint", - "path": "node_modules\\@typescript-eslint\\parser", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@typescript-eslint\\parser\\LICENSE" - }, - "@typescript-eslint/scope-manager@4.33.0": { - "licenses": "MIT", - "repository": "https://github.com/typescript-eslint/typescript-eslint", - "path": "node_modules\\@typescript-eslint\\scope-manager", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@typescript-eslint\\scope-manager\\LICENSE" - }, - "@typescript-eslint/types@4.33.0": { - "licenses": "MIT", - "repository": "https://github.com/typescript-eslint/typescript-eslint", - "path": "node_modules\\@typescript-eslint\\types", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@typescript-eslint\\types\\LICENSE" - }, - "@typescript-eslint/typescript-estree@4.33.0": { - "licenses": "BSD-2-Clause", - "repository": "https://github.com/typescript-eslint/typescript-eslint", - "path": "node_modules\\@typescript-eslint\\typescript-estree", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@typescript-eslint\\typescript-estree\\LICENSE" - }, - "@typescript-eslint/visitor-keys@4.33.0": { - "licenses": "MIT", - "repository": "https://github.com/typescript-eslint/typescript-eslint", - "path": "node_modules\\@typescript-eslint\\visitor-keys", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@typescript-eslint\\visitor-keys\\LICENSE" - }, "eslint-utils@2.1.0": { "licenses": "MIT", "repository": "https://github.com/mysticatea/eslint-utils", @@ -100,14 +70,6 @@ "path": "node_modules\\ignore", "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\ignore\\LICENSE-MIT" }, - "jodit@3.24.9": { - "licenses": "MIT", - "repository": "https://github.com/xdan/jodit", - "publisher": "Chupurnov", - "email": "chupurnov@gmail.com", - "path": "node_modules\\jodit", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\jodit\\LICENSE.txt" - }, "tslib@1.14.1": { "licenses": "0BSD", "repository": "https://github.com/Microsoft/tslib", @@ -122,13 +84,6 @@ "path": "node_modules\\tsutils", "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\tsutils\\LICENSE" }, - "tsutils@3.21.0": { - "licenses": "MIT", - "repository": "https://github.com/ajafff/tsutils", - "publisher": "Klaus Meinhardt", - "path": "node_modules\\@typescript-eslint\\typescript-estree\\node_modules\\tsutils", - "licenseFile": "D:\\dnn-elements\\dnn-elements\\packages\\stencil-library\\node_modules\\@typescript-eslint\\typescript-estree\\node_modules\\tsutils\\LICENSE" - }, "typescript@4.9.5": { "licenses": "Apache-2.0", "repository": "https://github.com/Microsoft/TypeScript", diff --git a/packages/stencil-library/package-lock.json b/packages/stencil-library/package-lock.json index abc25f4ec..700eeb168 100644 --- a/packages/stencil-library/package-lock.json +++ b/packages/stencil-library/package-lock.json @@ -1,12 +1,12 @@ { "name": "@dnncommunity/dnn-elements", - "version": "0.18.0-alpha.61", + "version": "0.23.3-alpha.7", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "@dnncommunity/dnn-elements", - "version": "0.18.0-alpha.61", + "version": "0.23.3-alpha.7", "license": "MIT", "dependencies": { "jodit": "^3.24.9" diff --git a/packages/stencil-library/package.json b/packages/stencil-library/package.json index ce924cbe2..e37534b90 100644 --- a/packages/stencil-library/package.json +++ b/packages/stencil-library/package.json @@ -1,6 +1,6 @@ { "name": "@dnncommunity/dnn-elements", - "version": "0.18.0-alpha.61", + "version": "0.23.3-alpha.7", "description": "Dnn themed custom elements.", "repository": "https://github.com/dnncommunity/dnn-elements", "homepage": "https://dnncommunity.github.io/dnn-elements", @@ -67,6 +67,6 @@ "typescript-debounce-decorator": "^0.0.18" }, "dependencies": { - "jodit": "^4.0.6" + "jodit": "^4.0.6" } } diff --git a/packages/stencil-library/src/components/dnn-input/readme.md b/packages/stencil-library/src/components/dnn-input/readme.md index b5a1862c5..0dec72f08 100644 --- a/packages/stencil-library/src/components/dnn-input/readme.md +++ b/packages/stencil-library/src/components/dnn-input/readme.md @@ -57,6 +57,12 @@ Type: `Promise` +#### Parameters + +| Name | Type | Description | +| --------- | -------- | ----------- | +| `message` | `string` | | + #### Returns Type: `Promise` diff --git a/packages/stencil-library/src/components/dnn-vertical-splitview/readme.md b/packages/stencil-library/src/components/dnn-vertical-splitview/readme.md index 0b40ff87b..eaa867b70 100644 --- a/packages/stencil-library/src/components/dnn-vertical-splitview/readme.md +++ b/packages/stencil-library/src/components/dnn-vertical-splitview/readme.md @@ -95,6 +95,12 @@ Type: `Promise` Sets the width percentage of the divider +#### Parameters + +| Name | Type | Description | +| ---------- | -------- | ----------- | +| `newWidth` | `number` | | + #### Returns Type: `Promise`