[kbn/generate] add basic package generator

[spalger]

Adds a script for generating packages which uses the template at packages/kbn-generate/templates/package. The package CLI is pretty simple right now and has the following --help text:

$ node scripts/generate --help

  node scripts/generate [command] [...args]

  Run generators for different components in Kibana

  Commands:
     node scripts/generate package [name]
      Generate a basic package

      Options:
        --dev          Generate a package which is intended for dev-only use and can access things like devDependencies
        --web          Build webpack-compatible version of sources for this package
        --dir          Directory where this package will live, defaults to [./packages]
        --force        If the packageDir already exists, delete it before generation


  Global options:
    --help             Show this message

  To show the help information about a specific command run:
    node scripts/generate help [command]

The template at packages/kbn-generate/templates/package is used to create the package source files. After they're written to disk the package.json file is updated to include references to the new plugin (location based on the --dev flag), and then the packages/BUILD.bazel file is regenerated by discovering all the packages in the repo and producing the new file.

See @kbn/packages, a new package that I generated with this script and updated to discover packages and generate the shared packages/BUILD.bazel file.

[elasticmachine]

Pinging @elastic/kibana-operations (Team:Operations)

[jbudz]

It looks like the BUILD.bazel file didn't get updates / templates didn't get written.

~/dev/kibana (pr/127095) » node scripts/generate package @kbn/test123                                                                                                                                  1 ↵ jon@xps
 info Wrote plugin files to /home/jon/dev/kibana/packages/kbn-test123
 info Updated package.json file
 info Updated packages/BUILD.bazel
 succ Generated @kbn/test123! Please bootstrap to make sure it works.
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
~/dev/kibana (pr/127095*) » git status                                                                                                                                                                     jon@xps
On branch pr/127095
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   package.json

no changes added to commit (use "git add" and/or "git commit -a")
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
~/dev/kibana (pr/127095*) » ls packages/kbn-test123                                                                                                                                                        jon@xps
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
~/dev/kibana (pr/127095*) »    

[jbudz]

Might be nice to include these in the default template based on the tsconfig.json:

TYPES_DEPS = [
  "@npm//@types/jest",
  "@npm//@types/node",
]

Overall though LGTM

[spalger]

Sounds good, thanks!

[kibana-ci]

💚 Build Succeeded

• Buildkite Build
• Commit: 0b09fd5
• Storybooks Preview
• Webpack Bundle Analyzer

Metrics [docs]

Public APIs missing comments

Total count of every public API that lacks a comment. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats comments for more detailed information.

id	before	after	diff
@kbn/dev-utils	203	205	+2
@kbn/generate	-	1	+1
@kbn/packages	-	3	+3
total			+6

Public APIs missing exports

Total count of every type that is part of your API that should be exported but is not. This will cause broken links in the API documentation system. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats exports for more detailed information.

id	before	after	diff
@kbn/packages	-	1	+1

Unknown metric groups

API count

id	before	after	diff
@kbn/dev-utils	281	283	+2
@kbn/generate	-	1	+1
@kbn/packages	-	3	+3
total			+6

History

• 💔 Build #28601 failed ebf2229
• 💔 Build #28581 failed e2ed958
• 💔 Build #28577 failed 710a4b8
• 💚 Build #28424 succeeded 9fefc93
• 💔 Build #28251 failed 711beecc7ee9e4667a52024347573edffcc05bd0

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

[kibanamachine]

💔 All backports failed

Status	Branch	Result
❌	8.1	Backport failed because of merge conflicts You might need to backport the following PRs to 8.1: - Update babel (main) (#126871) - Remove ts refs build from bootstrap (#125314)

Manual backport

To create the backport manually run:

node scripts/backport --pr 127095

Questions ?

Please refer to the Backport tool documentation