ember-cli 4.0.0-beta.2 → 4.1.0-beta.1

package/.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.1.5
+      - uses: actions/setup-node@v2.5.0
         with:
           node-version: 12.x
           cache: 'yarn'
@@ -39,7 +39,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.1.5
+      - uses: actions/setup-node@v2.5.0
         with:
           node-version: 12.x
           cache: 'yarn'
@@ -56,12 +56,12 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [12.x, 14.x]
+        node-version: [12.x, 14.x, 16.x]
         os: [ubuntu, windows]
 
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.1.5
+      - uses: actions/setup-node@v2.5.0
         with:
           node-version: ${{ matrix.node-version }}
           cache: 'yarn'
@@ -86,7 +86,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2.1.5
+      - uses: actions/setup-node@v2.5.0
         with:
           node-version: 12.x
           cache: 'yarn'

package/CHANGELOG.md

@@ -1,20 +1,65 @@
 # ember-cli Changelog
 
+## v4.1.0-beta.1
 
-## v4.0.0-beta.2
+#### Blueprint Changes
+
+- [`ember new` diff](https://github.com/ember-cli/ember-new-output/compare/v4.0.0...v4.1.0-beta.1)
+- [`ember addon` diff](https://github.com/ember-cli/ember-addon-output/compare/v4.0.0...v4.1.0-beta.1)
+
+#### Changelog
+
+- [#9431](https://github.com/ember-cli/ember-cli/pull/9431) replace fixtures with jest-like snapshots [@lifeart](https://github.com/lifeart)
+- [#9607](https://github.com/ember-cli/ember-cli/pull/9607) Add online editor files to update-output-repos script [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+- [#9700](https://github.com/ember-cli/ember-cli/pull/9700) [Chore] Update  .npmignore to ignore .github and docs folders [@SergeAstapov](https://github.com/SergeAstapov)
+- [#9728](https://github.com/ember-cli/ember-cli/pull/9728) eslint-plugin-mocha@^9.0.0 [@kellyselden](https://github.com/kellyselden)
+- [#9729](https://github.com/ember-cli/ember-cli/pull/9729) is-language-code@^3.1.0 [@kellyselden](https://github.com/kellyselden)
+
+Thank you to all who took the time to contribute!
+
+## v4.0.0
 
 #### Blueprint Changes
 
-- [`ember new` diff](https://github.com/ember-cli/ember-new-output/compare/v4.0.0-beta.1...v4.0.0-beta.2)
-- [`ember addon` diff](https://github.com/ember-cli/ember-addon-output/compare/v4.0.0-beta.1...v4.0.0-beta.2)
+- [`ember new` diff](https://github.com/ember-cli/ember-new-output/compare/v3.28.4...v4.0.0)
+- [`ember addon` diff](https://github.com/ember-cli/ember-addon-output/compare/v3.28.4...v4.0.0)
 
 #### Changelog
 
+- [#9679](https://github.com/ember-cli/ember-cli/pull/9679) Bump ember-page-title from v6.2.2 to v7.0.0 [@raido](https://github.com/raido)
+- [#9694](https://github.com/ember-cli/ember-cli/pull/9694) test in node 16 LTS [@kellyselden](https://github.com/kellyselden)
+- [#9696](https://github.com/ember-cli/ember-cli/pull/9696) commands/init: Fix `--yarn` usage [@Turbo87](https://github.com/Turbo87)
 - [#9659](https://github.com/ember-cli/ember-cli/pull/9659) Ensure `ember-classic` ember-try scenario uses Ember 3.x [@rwjblue](https://github.com/rwjblue)
 - [#9661](https://github.com/ember-cli/ember-cli/pull/9661) Set default CI config blueprints to run all builds [@elwayman02](https://github.com/elwayman02)
 - [#9666](https://github.com/ember-cli/ember-cli/pull/9666) Remove IE11 comments from `config/target.js` in app blueprint [@bertdeblock](https://github.com/bertdeblock)
 - [#9667](https://github.com/ember-cli/ember-cli/pull/9667) Update eslint-plugin-qunit to v7 in blueprint [@bmish](https://github.com/bmish)
 - [#9670](https://github.com/ember-cli/ember-cli/pull/9670) Don't emit an error when the `lint:fix` script fails post blueprint generation [@bertdeblock](https://github.com/bertdeblock)
+- [#9574](https://github.com/ember-cli/ember-cli/pull/9574) Update link to Discord in README.md [@MelSumner](https://github.com/MelSumner)
+- [#9613](https://github.com/ember-cli/ember-cli/pull/9613) Fix test that started failing with v2.17.0 of qunit [@kategengler](https://github.com/kategengler)
+- [#9579](https://github.com/ember-cli/ember-cli/pull/9579) Add `--ci-provider` option to `ember new` and `ember addon` [@snewcomer](https://github.com/snewcomer)
+- [#9618](https://github.com/ember-cli/ember-cli/pull/9618) Reload `_packageInfo` as part of `reloadPkg` [@brendenpalmer](https://github.com/brendenpalmer)
+- [#9563](https://github.com/ember-cli/ember-cli/pull/9563) Add `pnpm` support to `ember install` command [@Turbo87](https://github.com/Turbo87)
+- [#9580](https://github.com/ember-cli/ember-cli/pull/9580) Add `.lint-todo` to prettier ignore [@elwayman02](https://github.com/elwayman02)
+- [#9589](https://github.com/ember-cli/ember-cli/pull/9589) Add link to visualizer to perf guide [@mehulkar](https://github.com/mehulkar)
+- [#9595](https://github.com/ember-cli/ember-cli/pull/9595) Add support for `addons.exclude` and `addons.include` options [@bertdeblock](https://github.com/bertdeblock)
+- [#9623](https://github.com/ember-cli/ember-cli/pull/9623) Update app/addon blueprints to use ember-auto-import@2 [@rwjblue](https://github.com/rwjblue)
+- [#9619](https://github.com/ember-cli/ember-cli/pull/9619) Update watch-detector to 1.0.1 [@colenso](https://github.com/colenso)
+- [#9605](https://github.com/ember-cli/ember-cli/pull/9605) Properly set `loglevel` flag for npm [@jrvidal](https://github.com/jrvidal)
+- [#9609](https://github.com/ember-cli/ember-cli/pull/9609) Ignore additional `ember-try` files for apps and addons [@bertdeblock](https://github.com/bertdeblock)
+- [#9644](https://github.com/ember-cli/ember-cli/pull/9644) Default `ember new` and `ember addon` to use GitHub Actions [@rwjblue](https://github.com/rwjblue)
+
+Thank you to all who took the time to contribute!
+
+## v3.28.4
+
+#### Blueprint Changes
+
+- [`ember new` diff](https://github.com/ember-cli/ember-new-output/compare/v3.28.3...v3.28.4)
+- [`ember addon` diff](https://github.com/ember-cli/ember-addon-output/compare/v3.28.3...v3.28.4)
+
+#### Changelog
+
+- [#9694](https://github.com/ember-cli/ember-cli/pull/9694) test in node 16 LTS [@kellyselden](https://github.com/kellyselden)
 
 Thank you to all who took the time to contribute!
 

package/blueprints/addon/additional-dev-dependencies.json

@@ -1,8 +1,8 @@
 {
   "devDependencies": {
-    "@embroider/test-setup": "^0.44.1",
+    "@embroider/test-setup": "^0.48.1",
     "ember-disable-prototype-extensions": "^1.1.3",
-    "ember-try": "^1.4.0",
+    "ember-try": "^2.0.0",
     "ember-source-channel-url": "^3.0.0"
   }
 }

package/blueprints/addon/files/.github/workflows/ci.yml

@@ -7,6 +7,10 @@ on:
       - master
   pull_request: {}
 
+concurrency:
+   group: ci-${{ github.head_ref || github.ref }}
+   cancel-in-progress: true
+
 jobs:
   test:
     name: "Tests"
@@ -50,8 +54,8 @@ jobs:
       fail-fast: false
       matrix:
         try-scenario:
-          - ember-lts-3.20
           - ember-lts-3.24
+          - ember-lts-3.28
           - ember-release
           - ember-beta
           - ember-canary

package/blueprints/addon/files/.travis.yml

@@ -51,8 +51,8 @@ jobs:
 
     # we recommend new addons test the current and previous LTS
     # as well as latest stable release (bonus points to beta/canary)
-    - env: EMBER_TRY_SCENARIO=ember-lts-3.20
     - env: EMBER_TRY_SCENARIO=ember-lts-3.24
+    - env: EMBER_TRY_SCENARIO=ember-lts-3.28
     - env: EMBER_TRY_SCENARIO=ember-release
     - env: EMBER_TRY_SCENARIO=ember-beta
     - env: EMBER_TRY_SCENARIO=ember-canary

package/blueprints/addon/files/README.md

@@ -7,8 +7,8 @@
 Compatibility
 ------------------------------------------------------------------------------
 
-* Ember.js v3.20 or above
-* Ember CLI v3.20 or above
+* Ember.js v3.24 or above
+* Ember CLI v3.24 or above
 * Node.js v12 or above
 
 

package/blueprints/addon/files/addon-config/ember-try.js

@@ -8,18 +8,18 @@ module.exports = async function () {
     <% if (yarn) { %>useYarn: true,
     <% } %>scenarios: [
       {
-        name: 'ember-lts-3.20',
+        name: 'ember-lts-3.24',
         npm: {
           devDependencies: {
-            'ember-source': '~3.20.5',
+            'ember-source': '~3.24.3',
           },
         },
       },
       {
-        name: 'ember-lts-3.24',
+        name: 'ember-lts-3.28',
         npm: {
           devDependencies: {
-            'ember-source': '~3.24.3',
+            'ember-source': '~3.28.0',
           },
         },
       },

package/blueprints/app/files/.github/workflows/ci.yml

@@ -7,6 +7,10 @@ on:
       - master
   pull_request: {}
 
+concurrency:
+   group: ci-${{ github.head_ref || github.ref }}
+   cancel-in-progress: true
+
 jobs:
   lint:
     name: "Lint"

package/blueprints/app/files/package.json

@@ -24,45 +24,45 @@
   },
   "devDependencies": {
     "@ember/optional-features": "^2.0.0",
-    "@ember/test-helpers": "^2.4.2<% if (embroider) { %>",
-    "@embroider/compat": "^0.44.1",
-    "@embroider/core": "^0.44.1",
-    "@embroider/webpack": "^0.44.1<% } %>",
+    "@ember/test-helpers": "^2.6.0<% if (embroider) { %>",
+    "@embroider/compat": "^0.48.1",
+    "@embroider/core": "^0.48.1",
+    "@embroider/webpack": "^0.48.1<% } %>",
     "@glimmer/component": "^1.0.4",
     "@glimmer/tracking": "^1.0.4",
     "babel-eslint": "^10.1.0",
     "broccoli-asset-rev": "^3.0.0",
-    "ember-auto-import": "^2.2.0",
+    "ember-auto-import": "^2.2.4",
     "ember-cli": "~<%= emberCLIVersion %>",
     "ember-cli-app-version": "^5.0.0",
-    "ember-cli-babel": "^7.26.6",
+    "ember-cli-babel": "^7.26.8",
     "ember-cli-dependency-checker": "^3.2.0",
-    "ember-cli-htmlbars": "^5.7.1",
+    "ember-cli-htmlbars": "^6.0.1",
     "ember-cli-inject-live-reload": "^2.1.0",
     "ember-cli-sri": "^2.1.1",
     "ember-cli-terser": "^4.0.2",
-    "ember-data": "~4.0.0-beta.2",
+    "ember-data": "~4.1.0-beta.0",
     "ember-export-application-global": "^2.0.1",
     "ember-fetch": "^8.1.1",
     "ember-load-initializers": "^2.1.2",
-    "ember-page-title": "^6.2.2",
-    "ember-qunit": "^5.1.4",
+    "ember-page-title": "^7.0.0",
+    "ember-qunit": "^5.1.5",
     "ember-resolver": "^8.0.3",
-    "ember-source": "~4.0.0-beta.4",
-    "ember-template-lint": "^3.7.0<% if (welcome) { %>",
-    "ember-welcome-page": "^5.0.0<% } %>",
+    "ember-source": "~4.1.0-beta.1",
+    "ember-template-lint": "^3.15.0<% if (welcome) { %>",
+    "ember-welcome-page": "^6.0.0<% } %>",
     "eslint": "^7.32.0",
     "eslint-config-prettier": "^8.3.0",
-    "eslint-plugin-ember": "^10.5.4",
+    "eslint-plugin-ember": "^10.5.8",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prettier": "^4.0.0",
-    "eslint-plugin-qunit": "^7.0.0",
+    "eslint-plugin-qunit": "^7.2.0",
     "loader.js": "^4.7.0",
     "npm-run-all": "^4.1.5",
-    "prettier": "^2.4.0",
+    "prettier": "^2.5.1",
     "qunit": "^2.17.2",
     "qunit-dom": "^2.0.0",
-    "webpack": "^5.52.1"
+    "webpack": "^5.65.0"
   },
   "engines": {
     "node": "12.* || 14.* || >= 16"

package/docs/build/data.json

@@ -3,7 +3,7 @@
         "logo": "https://ember-cli.com/assets/images/ember-cli-logo-small-dark.png",
         "name": "ember-cli",
         "description": "Command line tool for developing ambitious ember.js apps",
-        "version": "4.0.0-beta.2-beta-6d064ff49f"
+        "version": "4.1.0-beta.1-beta-d79fe1e1b3"
     },
     "files": {
         "lib/broccoli/default-packager.js": {
@@ -2378,7 +2378,7 @@
         },
         {
             "file": "lib/models/per-bundle-addon-cache/index.js",
-            "line": 248,
+            "line": 247,
             "description": "Called from PackageInfo.getAddonInstance(), return an instance of the requested\naddon or a Proxy, based on the type of addon and its bundle host.",
             "itemtype": "method",
             "name": "getAddonInstance",
@@ -5651,7 +5651,7 @@
         },
         {
             "file": "lib/models/host-info-cache.js",
-            "line": 272,
+            "line": 270,
             "description": "This returns the LCA host for a given engine; we use the associated package info\nto compute this (see `getHostAddonInfo` above); this finds the lowest common ancestor\nthat is considered a host amongst _all_ engines by the same name in the project. This\nfunction is intended to replace the original behavior in `ember-engines`.\n\nFor more info, see the original implementation here:\n\nhttps://github.com/ember-engines/ember-engines/blob/master/packages/ember-engines/lib/utils/find-lca-host.js",
             "itemtype": "method",
             "name": "findLCAHost",

package/lib/commands/init.js

@@ -101,9 +101,17 @@ module.exports = Command.extend({
     await this.runTask('InstallBlueprint', blueprintOpts);
 
     if (!commandOptions.skipNpm) {
+      let packageManager =
+        commandOptions.yarn === true
+          ? 'yarn'
+          : // supported for legacy reasons
+          commandOptions.yarn === false
+          ? 'npm'
+          : undefined;
+
       await this.runTask('NpmInstall', {
         verbose: commandOptions.verbose,
-        useYarn: commandOptions.yarn,
+        packageManager,
       });
     }
 

package/lib/models/host-info-cache.js

@@ -242,11 +242,9 @@ class HostInfoCache {
         path.push(currentPackageInfo);
 
         queue.push(
-          ...[
-            ...inRepoAddons,
-            ...Object.values(dependencyPackages),
-            ...Object.values(devDependencyPackages),
-          ].map((pkgInfo) => ({ pkgInfo, path: [...path] }))
+          ...[...inRepoAddons, ...Object.values(dependencyPackages), ...Object.values(devDependencyPackages)].map(
+            (pkgInfo) => ({ pkgInfo, path: [...path] })
+          )
         );
       }
     }

package/lib/models/per-bundle-addon-cache/index.js

@@ -234,9 +234,8 @@ class PerBundleAddonCache {
       return bundleHost;
     }
 
-    let { hostPackageInfo, hostAndAncestorBundledPackageInfos } = this.project.hostInfoCache.getHostAddonInfo(
-      bundleHost
-    );
+    let { hostPackageInfo, hostAndAncestorBundledPackageInfos } =
+      this.project.hostInfoCache.getHostAddonInfo(bundleHost);
 
     if (!hostAndAncestorBundledPackageInfos.has(addonPkgInfo)) {
       return bundleHost;

package/lib/utilities/get-lang-arg.js

@@ -1,6 +1,6 @@
-/* 
+/*
 
-This utility processes the argument passed with the `lang` option 
+This utility processes the argument passed with the `lang` option
 in ember-cli, i.e. `ember (new||init||addon) app-name --lang=langArg`
 
 Execution Context (usage, input, output, error handling, etc.):
@@ -35,11 +35,11 @@ Warning Messages (if necessary):
 
 'use strict';
 
-const getLangCodeInfo = require('is-language-code');
+const { isLangCode } = require('is-language-code');
 
 // Primary language code validation function (boolean)
 function isValidLangCode(langArg) {
-  return getLangCodeInfo(langArg).res;
+  return isLangCode(langArg).res;
 }
 
 // Generates the result to pass back to `init`
@@ -48,29 +48,29 @@ function getResult(langArg) {
 }
 
 /*
-Misuse case: attempt to set application programming language via `lang` 
+Misuse case: attempt to set application programming language via `lang`
 AND
 Edge case: valid language code AND a common programming language abbreviation
 -------------------------------------------------------------------------------
-It is possible that a user might mis-interpret the type of `language` that is 
-specified by the `--lang` flag. One notable potential `misuse case` is one in 
-which the user thinks `--lang` specifies the application's programming 
-language. For example, the user might call `ember new my-app --lang=typescript` 
-expecting to achieve an effect similar to the one provided by the 
+It is possible that a user might mis-interpret the type of `language` that is
+specified by the `--lang` flag. One notable potential `misuse case` is one in
+which the user thinks `--lang` specifies the application's programming
+language. For example, the user might call `ember new my-app --lang=typescript`
+expecting to achieve an effect similar to the one provided by the
 `ember-cli-typescript` addon.
 
-This misuse case is handled by checking the input `langArg` against an Array 
-containing notable programming language-related values: language names 
-(e.g. `JavaScript`), abbreviations (e.g. `js`), file extensions (e.g. `.js`), 
-or versions (e.g. `ES6`), etc. Specifically, if `langArg` is found within this 
-reference list, a WARNING message that describes correct `--lang` usage will 
-be emitted. The `lang` attribute will not be assigned in `index.html`, and the 
+This misuse case is handled by checking the input `langArg` against an Array
+containing notable programming language-related values: language names
+(e.g. `JavaScript`), abbreviations (e.g. `js`), file extensions (e.g. `.js`),
+or versions (e.g. `ES6`), etc. Specifically, if `langArg` is found within this
+reference list, a WARNING message that describes correct `--lang` usage will
+be emitted. The `lang` attribute will not be assigned in `index.html`, and the
 user will be notified with a corresponding STATUS message.
 
 There are several edge cases (marked) where `langArg` is both a commonly-used
-abbreviation for a programming language AND a valid language code. The behavior 
-for these cases is to assume the user has used `--lang` correctly and set the 
-`lang` attribute to the valid code in `index.html`. To cover for potential 
+abbreviation for a programming language AND a valid language code. The behavior
+for these cases is to assume the user has used `--lang` correctly and set the
+`lang` attribute to the valid code in `index.html`. To cover for potential
 misuage, several helpful messages will also be emitted:
 - `ts` is a valid language code AND a common programming language abbreviation
 - the `lang` attribute will be set to `ts` in the application
@@ -141,44 +141,44 @@ function isValidCodeAndProg(langArg) {
   return isValidLangCode(langArg) && isProgLang(langArg);
 }
 
-/* 
+/*
 Misuse case: `--lang` called without `langArg` (NB: parser bug workaround)
 -------------------------------------------------------------------------------
-This is a workaround for handling an existing bug in the ember-cli parser  
-where the `--lang` option is specified in the command without a corresponding 
-value for `langArg`. 
+This is a workaround for handling an existing bug in the ember-cli parser
+where the `--lang` option is specified in the command without a corresponding
+value for `langArg`.
 
-As examples, the parser behavior would likely affect the following usages: 
+As examples, the parser behavior would likely affect the following usages:
   1. `ember new app-name --lang --skip-npm
   2. `ember new app-name --lang`
 
-In this context, the unintended parser behavior is that `langArg` will be 
-assingned to the String that immediately follows `--lang` in the command. If 
-`--lang` is the last explicitly defined part of the command (as in the second 
-example above), the first of any any `hidden` options pushed onto the command 
-after the initial parse (e.g. `--disable-analytics`, `--no-watcher`) will be 
-used when assigning `langArg`. 
+In this context, the unintended parser behavior is that `langArg` will be
+assingned to the String that immediately follows `--lang` in the command. If
+`--lang` is the last explicitly defined part of the command (as in the second
+example above), the first of any any `hidden` options pushed onto the command
+after the initial parse (e.g. `--disable-analytics`, `--no-watcher`) will be
+used when assigning `langArg`.
 
 In the above examples, `langArg` would likely be assigned as follows:
   1. `ember new app-name --lang --skip-npm => `langArg='--skip-npm'`
   2. `ember new app-name --lang` => `langArg='--disable-analytics'`
 
-The workaround impelemented herein is to check whether or not the value of 
-`langArg` starts with a hyphen. The rationale for this approach is based on 
+The workaround impelemented herein is to check whether or not the value of
+`langArg` starts with a hyphen. The rationale for this approach is based on
 the following underlying assumptions:
   - ALL CLI options start with (at least one) hyphen
   - NO valid language codes start with a hyphen
 
-If the leading hyphen is detected, the current behavior is to assume `--lang` 
-was declared without a corresponding specification. A WARNING message that 
-describes correct `--lang` usage will be emitted. The `lang` attribute will not 
-be assigned in `index.html`, and the user will be notified with a corresponding 
+If the leading hyphen is detected, the current behavior is to assume `--lang`
+was declared without a corresponding specification. A WARNING message that
+describes correct `--lang` usage will be emitted. The `lang` attribute will not
+be assigned in `index.html`, and the user will be notified with a corresponding
 STATUS message. Execution will not be halted.
 
-Other complications related to this parser behavior are considered out-of-scope 
-and not handled here. In the first example above, this workaround would ensure 
-that `lang` is not assigned to `--skip-npm`, but it would not guarantee that 
-`--skip-npm` is correctly processed as a command option. That is, `npm` may or 
+Other complications related to this parser behavior are considered out-of-scope
+and not handled here. In the first example above, this workaround would ensure
+that `lang` is not assigned to `--skip-npm`, but it would not guarantee that
+`--skip-npm` is correctly processed as a command option. That is, `npm` may or
 may not get skipped during execution.
 */
 
@@ -194,12 +194,12 @@ const MSG_HEAD = `An issue with the \`--lang\` flag returned the following messa
 
 // Message context from language code validation (valid: null, invalid: reason)
 function getLangCodeMsg(langArg) {
-  return getLangCodeInfo(langArg).message;
+  return isLangCode(langArg).message;
 }
 
 // Edge case: valid language code AND a common programming language abbreviation
 function getValidAndProgMsg(langArg) {
-  return `The \`--lang\` flag has been used with argument \`${langArg}\`, 
+  return `The \`--lang\` flag has been used with argument \`${langArg}\`,
   which is BOTH a valid language code AND an abbreviation for a programming language.
   ${getProgLangMsg(langArg)}`;
 }
@@ -218,15 +218,15 @@ function getCliMsg() {
 
 // 3. `STATUS` message: report if `lang` will be set in `index.html`
 function getStatusMsg(langArg, willSet) {
-  return `The human language of the application will ${willSet ? `be set to ${langArg}` : `NOT be set`} in 
+  return `The human language of the application will ${willSet ? `be set to ${langArg}` : `NOT be set`} in
   the \`<html>\` element's \`lang\` attribute in \`index.html\`.`;
 }
 
 // 4. `HELP` message: template for all `--lang`-related warnings emitted
-const MSG_HELP = `If this was not your intention, you may edit the \`<html>\` element's 
+const MSG_HELP = `If this was not your intention, you may edit the \`<html>\` element's
   \`lang\` attribute in \`index.html\` manually after the process is complete.
 Information about using the \`--lang\` flag:
-  The \`--lang\` flag sets the base human language of an app or test app: 
+  The \`--lang\` flag sets the base human language of an app or test app:
     - \`app/index.html\` (app)
     - \`tests/dummy/app/index.html\` (addon test app)
   If used, the lang option must specfify a valid language code.