piral-cli 1.0.0-pre.2217 → 1.0.0

package/lib/commands.js

@@ -27,9 +27,12 @@ const allCommands = [
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source root directory or index.html file for collecting all the information.',
+                describe: 'Sets the source Piral instance path for collecting all the information.',
                 default: apps.debugPiralDefaults.entry,
             })
+                .string('target')
+                .describe('target', 'Sets the target directory or file of bundling.')
+                .default('target', apps.debugPiralDefaults.target)
                 .number('port')
                 .describe('port', 'Sets the port of the local development server.')
                 .default('port', apps.debugPiralDefaults.port)
@@ -45,12 +48,17 @@ const allCommands = [
                 .boolean('hmr')
                 .describe('hmr', 'Activates Hot Module Reloading (HMR).')
                 .default('hmr', apps.debugPiralDefaults.hmr)
+                .string('krasrc')
+                .describe('krasrc', 'Sets a config file for overwriting the default kras options.')
+                .default('krasrc', apps.debugPiralDefaults.krasrc)
                 .boolean('optimize-modules')
                 .describe('optimize-modules', 'Also includes the node modules for target transpilation.')
                 .default('optimize-modules', apps.debugPiralDefaults.optimizeModules)
                 .choices('bundler', helpers_1.availableBundlers)
                 .describe('bundler', 'Sets the bundler to use.')
                 .default('bundler', helpers_1.availableBundlers[0])
+                .string('feed')
+                .describe('feed', 'Sets the URL of a pilet feed for including remote pilets.')
                 .string('base')
                 .default('base', process.cwd())
                 .describe('base', 'Sets the base directory. By default the current directory is used.');
@@ -58,13 +66,17 @@ const allCommands = [
         run(args) {
             return apps.debugPiral(args.base, {
                 entry: args.source,
+                target: args.target,
                 port: args.port,
                 hmr: args.hmr,
+                krasrc: args.krasrc,
                 optimizeModules: args['optimize-modules'],
                 publicUrl: args['public-url'],
                 bundlerName: args.bundler,
                 logLevel: args['log-level'],
                 open: args.open,
+                hooks: args.hooks,
+                feed: args.feed,
                 _: args,
             });
         },
@@ -79,14 +91,14 @@ const allCommands = [
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source root directory or index.html file for collecting all the information.',
+                describe: 'Sets the source Piral instance path for collecting all the information.',
                 default: apps.buildPiralDefaults.entry,
             })
                 .string('target')
                 .describe('target', 'Sets the target directory or file of bundling.')
                 .default('target', apps.buildPiralDefaults.target)
                 .string('public-url')
-                .describe('public-url', 'Sets the public URL (path) of the bundle.')
+                .describe('public-url', 'Sets the public URL (path) of the bundle. Only for release output.')
                 .default('public-url', apps.buildPiralDefaults.publicUrl)
                 .number('log-level')
                 .describe('log-level', 'Sets the log level to use (1-5).')
@@ -100,6 +112,9 @@ const allCommands = [
                 .boolean('source-maps')
                 .describe('source-maps', 'Create associated source maps for the bundles.')
                 .default('source-maps', apps.buildPiralDefaults.sourceMaps)
+                .boolean('watch')
+                .describe('watch', 'Continuously re-builds while watching the source files.')
+                .default('watch', apps.buildPiralDefaults.watch)
                 .boolean('subdir')
                 .describe('subdir', `Places the build's output in an appropriate subdirectory (e.g., "emulator"). Ignored for "--all".`)
                 .default('subdir', apps.buildPiralDefaults.subdir)
@@ -109,7 +124,7 @@ const allCommands = [
                 .boolean('optimize-modules')
                 .describe('optimize-modules', 'Also includes the node modules for target transpilation.')
                 .default('optimize-modules', apps.buildPiralDefaults.optimizeModules)
-                .choices('type', helpers_1.buildTypeKeys)
+                .choices('type', helpers_1.piralBuildTypeKeys)
                 .describe('type', 'Selects the target type of the build. "all" builds all target types.')
                 .default('type', apps.buildPiralDefaults.type)
                 .choices('bundler', helpers_1.availableBundlers)
@@ -130,9 +145,11 @@ const allCommands = [
                 subdir: args.subdir,
                 contentHash: args['content-hash'],
                 sourceMaps: args['source-maps'],
+                watch: args.watch,
                 optimizeModules: args['optimize-modules'],
                 logLevel: args['log-level'],
                 type: args.type,
+                hooks: args.hooks,
                 _: args,
             });
         },
@@ -152,15 +169,18 @@ const allCommands = [
                 .number('log-level')
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.publishPiralDefaults.logLevel)
-                .choices('type', helpers_1.buildTypeKeys)
+                .choices('type', helpers_1.piralBuildTypeKeys)
                 .describe('type', 'Selects the target type to publish. "all" publishes all target types.')
                 .default('type', apps.publishPiralDefaults.type)
                 .choices('provider', helpers_1.availableReleaseProviders)
                 .describe('provider', 'Sets the provider for publishing the release assets.')
                 .default('provider', apps.publishPiralDefaults.provider)
-                .option('fields', undefined)
-                .describe('fields', 'Sets additional fields to be included in the feed service request.')
-                .default('fields', apps.publishPiralDefaults.fields)
+                .option('opts', undefined)
+                .describe('opts', 'Sets the options to forward to the chosen provider.')
+                .default('opts', apps.publishPiralDefaults.opts)
+                .boolean('interactive')
+                .describe('interactive', 'Defines if authorization tokens can be retrieved interactively.')
+                .default('interactive', apps.publishPiralDefaults.interactive)
                 .string('base')
                 .default('base', process.cwd())
                 .describe('base', 'Sets the base directory. By default the current directory is used.');
@@ -171,20 +191,21 @@ const allCommands = [
                 logLevel: args['log-level'],
                 type: args.type,
                 provider: args.provider,
-                fields: args.fields,
+                opts: args.opts,
+                interactive: args.interactive,
             });
         },
     },
     {
         name: 'declaration-piral',
         alias: ['declare-piral', 'declaration-portal', 'declare-portal'],
-        description: 'Creates the declaration file for a Piral instance.',
+        description: 'Creates the TypeScript declaration file (index.d.ts) for a Piral instance.',
         arguments: ['[source]'],
         flags(argv) {
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source root directory or index.html file for collecting all the information.',
+                describe: 'Sets the source Piral instance path for collecting all the information.',
                 default: apps.declarationPiralDefaults.entry,
             })
                 .string('target')
@@ -194,8 +215,8 @@ const allCommands = [
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.declarationPiralDefaults.logLevel)
                 .choices('force-overwrite', helpers_1.forceOverwriteKeys)
-                .describe('force-overwrite', 'Determines if files should be overwritten by the declaration.')
-                .default('force-overwrite', helpers_1.keyOfForceOverwrite(apps.declarationPiralDefaults.forceOverwrite))
+                .describe('force-overwrite', 'Determines if files should be overwritten by the command.')
+                .default('force-overwrite', (0, helpers_1.keyOfForceOverwrite)(apps.declarationPiralDefaults.forceOverwrite))
                 .string('base')
                 .default('base', process.cwd())
                 .describe('base', 'Sets the base directory. By default the current directory is used.');
@@ -204,7 +225,7 @@ const allCommands = [
             return apps.declarationPiral(args.base, {
                 entry: args.source,
                 target: args.target,
-                forceOverwrite: helpers_1.valueOfForceOverwrite(args['force-overwrite']),
+                forceOverwrite: (0, helpers_1.valueOfForceOverwrite)(args['force-overwrite']),
                 logLevel: args['log-level'],
             });
         },
@@ -229,28 +250,31 @@ const allCommands = [
                 .describe('framework', 'Sets the framework/library level to use.')
                 .default('framework', apps.newPiralDefaults.framework)
                 .boolean('install')
-                .describe('install', 'Already performs the installation of its NPM dependencies.')
+                .describe('install', 'Already performs the installation of its npm dependencies.')
                 .default('install', apps.newPiralDefaults.install)
+                .alias('install', 'package-install')
                 .string('registry')
                 .describe('registry', 'Sets the package registry to use for resolving the dependencies.')
                 .default('registry', apps.newPiralDefaults.registry)
+                .alias('registry', 'package-registry')
                 .number('log-level')
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.newPiralDefaults.logLevel)
                 .string('tag')
                 .describe('tag', 'Sets the tag or version of the package to install. By default, this uses the version of the CLI.')
                 .default('tag', apps.newPiralDefaults.version)
+                .alias('tag', 'piral-version')
                 .choices('force-overwrite', helpers_1.forceOverwriteKeys)
                 .describe('force-overwrite', 'Determines if files should be overwritten by the installation.')
-                .default('force-overwrite', helpers_1.keyOfForceOverwrite(apps.newPiralDefaults.forceOverwrite))
-                .choices('language', helpers_1.piletLanguageKeys)
+                .default('force-overwrite', (0, helpers_1.keyOfForceOverwrite)(apps.newPiralDefaults.forceOverwrite))
+                .choices('language', helpers_1.sourceLanguageKeys)
                 .describe('language', 'Determines the programming language for the new Piral instance.')
-                .default('language', helpers_1.keyOfPiletLanguage(apps.newPiralDefaults.language))
+                .default('language', apps.newPiralDefaults.language)
                 .string('template')
                 .describe('template', 'Sets the boilerplate template package to be used when scaffolding.')
                 .default('template', apps.newPiralDefaults.template)
                 .choices('npm-client', helpers_1.clientTypeKeys)
-                .describe('npm-client', 'Sets the NPM client to be used when scaffolding.')
+                .describe('npm-client', 'Sets the npm client to be used when scaffolding.')
                 .default('npm-client', apps.newPiralDefaults.npmClient)
                 .choices('bundler', helpers_1.bundlerKeys)
                 .describe('bundler', 'Sets the default bundler to install.')
@@ -260,7 +284,10 @@ const allCommands = [
                 .default('vars', apps.newPiralDefaults.variables)
                 .string('base')
                 .default('base', process.cwd())
-                .describe('base', 'Sets the base directory. By default the current directory is used.');
+                .describe('base', 'Sets the base directory. By default the current directory is used.')
+                .string('name')
+                .describe('name', 'Sets the name for the new Piral app.')
+                .default('name', apps.newPiralDefaults.name);
         },
         run(args) {
             return apps.newPiral(args.base, {
@@ -269,14 +296,15 @@ const allCommands = [
                 framework: args.framework,
                 version: args.tag,
                 registry: args.registry,
-                forceOverwrite: helpers_1.valueOfForceOverwrite(args['force-overwrite']),
-                language: helpers_1.valueOfPiletLanguage(args.language),
+                forceOverwrite: (0, helpers_1.valueOfForceOverwrite)(args['force-overwrite']),
+                language: args.language,
                 install: args.install,
                 template: args.template,
                 logLevel: args['log-level'],
                 npmClient: args['npm-client'],
                 bundlerName: args.bundler,
                 variables: args.vars,
+                name: args['name'],
             });
         },
     },
@@ -299,10 +327,11 @@ const allCommands = [
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.upgradePiralDefaults.logLevel)
                 .boolean('install')
-                .describe('install', 'Already performs the update of its NPM dependencies.')
+                .describe('install', 'Already performs the update of its npm dependencies.')
                 .default('install', apps.upgradePiralDefaults.install)
+                .alias('install', 'package-install')
                 .choices('npm-client', helpers_1.clientTypeKeys)
-                .describe('npm-client', 'Sets the NPM client to be used when upgrading.')
+                .describe('npm-client', 'Sets the npm client to be used when upgrading.')
                 .default('npm-client', apps.upgradePiralDefaults.npmClient)
                 .string('base')
                 .default('base', process.cwd())
@@ -327,7 +356,7 @@ const allCommands = [
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source root directory or index.html file for collecting all the information.',
+                describe: 'Sets the source Piral instance path for collecting all the information.',
                 default: apps.validatePiralDefaults.entry,
             })
                 .number('log-level')
@@ -357,18 +386,30 @@ const allCommands = [
                 describe: 'Sets the source file containing the pilet root module.',
                 default: apps.debugPiletDefaults.entry,
             })
+                .string('target')
+                .describe('target', 'Sets the target directory or file of bundling.')
+                .default('target', apps.debugPiletDefaults.target)
+                .string('public-url')
+                .describe('public-url', 'Sets the public URL (path) of the application.')
+                .default('public-url', apps.debugPiletDefaults.publicUrl)
                 .number('port')
                 .describe('port', 'Sets the port of the local development server.')
                 .default('port', apps.debugPiletDefaults.port)
                 .number('log-level')
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.debugPiletDefaults.logLevel)
+                .number('concurrency')
+                .describe('concurrency', 'Sets the maximum number of concurrent build jobs.')
+                .default('concurrency', apps.debugPiletDefaults.concurrency)
                 .boolean('open')
                 .describe('open', 'Opens the pilet directly in the browser.')
                 .default('open', apps.debugPiletDefaults.open)
                 .boolean('hmr')
                 .describe('hmr', 'Activates Hot Module Reloading (HMR).')
                 .default('hmr', apps.debugPiletDefaults.hmr)
+                .string('krasrc')
+                .describe('krasrc', 'Sets a config file for overwriting the default kras options.')
+                .default('krasrc', apps.debugPiletDefaults.krasrc)
                 .boolean('optimize-modules')
                 .describe('optimize-modules', 'Also includes the node modules for target transpilation.')
                 .default('optimize-modules', apps.debugPiletDefaults.optimizeModules)
@@ -380,24 +421,32 @@ const allCommands = [
                 .default('bundler', helpers_1.availableBundlers[0])
                 .string('app')
                 .describe('app', 'Sets the name of the Piral instance.')
+                .string('app-dir')
+                .describe('app-dir', 'Sets the path to a custom Piral instance for serving.')
+                .string('feed')
+                .describe('feed', 'Sets the URL of a pilet feed for including remote pilets.')
                 .string('base')
                 .default('base', process.cwd())
-                .describe('base', 'Sets the base directory. By default the current directory is used.')
-                .string('feed')
-                .describe('feed', 'Sets the URL of a pilet feed for including remote pilets.');
+                .describe('base', 'Sets the base directory. By default the current directory is used.');
         },
         run(args) {
             return apps.debugPilet(args.base, {
                 entry: args.source,
+                target: args.target,
+                publicUrl: args['public-url'],
                 port: args.port,
                 hmr: args.hmr,
                 bundlerName: args.bundler,
+                krasrc: args.krasrc,
                 optimizeModules: args['optimize-modules'],
+                appInstanceDir: args['app-dir'],
                 app: args.app,
                 logLevel: args['log-level'],
                 open: args.open,
                 schemaVersion: args.schema,
+                concurrency: args.concurrency,
                 feed: args.feed,
+                hooks: args.hooks,
                 _: args,
             });
         },
@@ -412,24 +461,36 @@ const allCommands = [
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source index.tsx file for collecting all the information.',
+                describe: 'Sets the source pilet path for collecting all the information.',
                 default: apps.buildPiletDefaults.entry,
             })
                 .string('target')
                 .describe('target', 'Sets the target file of bundling.')
                 .default('target', apps.buildPiletDefaults.target)
+                .string('public-url')
+                .describe('public-url', 'Sets the public URL (path) of the application.')
+                .default('public-url', apps.buildPiletDefaults.publicUrl)
                 .number('log-level')
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.buildPiletDefaults.logLevel)
+                .number('concurrency')
+                .describe('concurrency', 'Sets the maximum number of concurrent build jobs.')
+                .default('concurrency', apps.buildPiletDefaults.concurrency)
                 .boolean('source-maps')
                 .describe('source-maps', 'Creates source maps for the bundles.')
                 .default('source-maps', apps.buildPiletDefaults.sourceMaps)
+                .boolean('watch')
+                .describe('watch', 'Continuously re-builds while watching the source files.')
+                .default('watch', apps.buildPiletDefaults.watch)
                 .boolean('fresh')
                 .describe('fresh', 'Performs a fresh build by removing the target directory first.')
                 .default('fresh', apps.buildPiletDefaults.fresh)
                 .boolean('minify')
                 .describe('minify', 'Performs minification or other post-bundle transformations.')
                 .default('minify', apps.buildPiletDefaults.minify)
+                .boolean('declaration')
+                .describe('declaration', 'Creates a declaration file for the pilet.')
+                .default('declaration', apps.buildPiletDefaults.declaration)
                 .boolean('content-hash')
                 .describe('content-hash', 'Appends the hash to the side-bundle files.')
                 .default('content-hash', apps.buildPiletDefaults.contentHash)
@@ -442,6 +503,9 @@ const allCommands = [
                 .choices('bundler', helpers_1.availableBundlers)
                 .describe('bundler', 'Sets the bundler to use.')
                 .default('bundler', helpers_1.availableBundlers[0])
+                .choices('type', helpers_1.piletBuildTypeKeys)
+                .describe('type', 'Selects the target type of the build.')
+                .default('type', apps.buildPiletDefaults.type)
                 .string('app')
                 .describe('app', 'Sets the name of the Piral instance.')
                 .string('base')
@@ -452,15 +516,21 @@ const allCommands = [
             return apps.buildPilet(args.base, {
                 entry: args.source,
                 target: args.target,
+                publicUrl: args['public-url'],
                 minify: args.minify,
                 contentHash: args['content-hash'],
                 bundlerName: args.bundler,
+                declaration: args.declaration,
                 sourceMaps: args['source-maps'],
+                watch: args.watch,
                 optimizeModules: args['optimize-modules'],
+                type: args.type,
                 fresh: args.fresh,
                 logLevel: args['log-level'],
                 schemaVersion: args.schema,
+                concurrency: args.concurrency,
                 app: args.app,
+                hooks: args.hooks,
                 _: args,
             });
         },
@@ -474,7 +544,7 @@ const allCommands = [
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source package.json file for creating the package.',
+                describe: 'Sets the source pilet path for creating the package.',
                 default: apps.packPiletDefaults.source,
             })
                 .string('target')
@@ -505,8 +575,7 @@ const allCommands = [
             return argv
                 .positional('source', {
                 type: 'string',
-                describe: 'Sets the source previously packed *.tgz bundle to publish.',
-                default: apps.publishPiletDefaults.source,
+                describe: 'Sets the source of either the previously packed *.tgz bundle or the pilet root module to publish.',
             })
                 .string('url')
                 .describe('url', 'Sets the explicit URL where to publish the pilet to.')
@@ -526,16 +595,28 @@ const allCommands = [
                 .choices('schema', helpers_1.schemaKeys)
                 .describe('schema', 'Sets the schema to be used when making a fresh build of the pilet.')
                 .default('schema', apps.publishPiletDefaults.schemaVersion)
+                .choices('mode', helpers_1.publishModeKeys)
+                .describe('mode', 'Sets the authorization mode to use.')
+                .default('mode', apps.publishPiletDefaults.mode)
+                .alias('mode', 'auth-mode')
+                .choices('bundler', helpers_1.availableBundlers)
+                .describe('bundler', 'Sets the bundler to use.')
+                .default('bundler', helpers_1.availableBundlers[0])
                 .choices('from', helpers_1.fromKeys)
                 .describe('from', 'Sets the type of the source to use for publishing.')
                 .default('from', apps.publishPiletDefaults.from)
                 .option('fields', undefined)
                 .describe('fields', 'Sets additional fields to be included in the feed service request.')
                 .default('fields', apps.publishPiletDefaults.fields)
+                .option('headers', undefined)
+                .describe('headers', 'Sets additional headers to be included in the feed service request.')
+                .default('headers', apps.publishPiletDefaults.headers)
+                .boolean('interactive')
+                .describe('interactive', 'Defines if authorization tokens can be retrieved interactively.')
+                .default('interactive', apps.publishPiletDefaults.interactive)
                 .string('base')
                 .default('base', process.cwd())
-                .describe('base', 'Sets the base directory. By default the current directory is used.')
-                .demandOption('url');
+                .describe('base', 'Sets the base directory. By default the current directory is used.');
         },
         run(args) {
             return apps.publishPilet(args.base, {
@@ -544,10 +625,15 @@ const allCommands = [
                 url: args.url,
                 logLevel: args['log-level'],
                 cert: args['ca-cert'],
+                bundlerName: args.bundler,
                 fresh: args.fresh,
                 from: args.from,
                 schemaVersion: args.schema,
                 fields: args.fields,
+                headers: args.headers,
+                mode: args.mode,
+                interactive: args.interactive,
+                _: args,
             });
         },
     },
@@ -570,23 +656,25 @@ const allCommands = [
                 .string('registry')
                 .describe('registry', 'Sets the package registry to use for resolving the specified Piral app.')
                 .default('registry', apps.newPiletDefaults.registry)
+                .alias('registry', 'package-registry')
                 .boolean('install')
-                .describe('install', 'Already performs the installation of its NPM dependencies.')
+                .describe('install', 'Already performs the installation of its npm dependencies.')
                 .default('install', apps.newPiletDefaults.install)
+                .alias('install', 'package-install')
                 .choices('force-overwrite', helpers_1.forceOverwriteKeys)
                 .describe('force-overwrite', 'Determines if files should be overwritten by the scaffolding.')
-                .default('force-overwrite', helpers_1.keyOfForceOverwrite(apps.newPiletDefaults.forceOverwrite))
+                .default('force-overwrite', (0, helpers_1.keyOfForceOverwrite)(apps.newPiletDefaults.forceOverwrite))
                 .number('log-level')
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.newPiletDefaults.logLevel)
-                .choices('language', helpers_1.piletLanguageKeys)
+                .choices('language', helpers_1.sourceLanguageKeys)
                 .describe('language', 'Determines the programming language for the new pilet.')
-                .default('language', helpers_1.keyOfPiletLanguage(apps.newPiletDefaults.language))
+                .default('language', apps.newPiletDefaults.language)
                 .string('template')
                 .describe('template', 'Sets the boilerplate template package to be used when scaffolding.')
                 .default('template', apps.newPiletDefaults.template)
                 .choices('npm-client', helpers_1.clientTypeKeys)
-                .describe('npm-client', 'Sets the NPM client to be used when scaffolding.')
+                .describe('npm-client', 'Sets the npm client to be used when scaffolding.')
                 .default('npm-client', apps.newPiletDefaults.npmClient)
                 .choices('bundler', helpers_1.bundlerKeys)
                 .describe('bundler', 'Sets the default bundler to install.')
@@ -596,21 +684,25 @@ const allCommands = [
                 .default('vars', apps.newPiletDefaults.variables)
                 .string('base')
                 .default('base', process.cwd())
-                .describe('base', 'Sets the base directory. By default the current directory is used.');
+                .describe('base', 'Sets the base directory. By default the current directory is used.')
+                .string('name')
+                .describe('name', 'Sets the name for the new Pilet.')
+                .default('name', apps.newPiletDefaults.name);
         },
         run(args) {
             return apps.newPilet(args.base, {
                 target: args.target,
                 source: args.source,
                 registry: args.registry,
-                forceOverwrite: helpers_1.valueOfForceOverwrite(args['force-overwrite']),
-                language: helpers_1.valueOfPiletLanguage(args.language),
+                forceOverwrite: (0, helpers_1.valueOfForceOverwrite)(args['force-overwrite']),
+                language: args.language,
                 logLevel: args['log-level'],
                 install: args.install,
                 template: args.template,
                 npmClient: args['npm-client'],
                 bundlerName: args.bundler,
                 variables: args.vars,
+                name: args['name'],
             });
         },
     },
@@ -633,14 +725,18 @@ const allCommands = [
                 .describe('log-level', 'Sets the log level to use (1-5).')
                 .default('log-level', apps.upgradePiletDefaults.logLevel)
                 .boolean('install')
-                .describe('install', 'Already performs the update of its NPM dependencies.')
+                .describe('install', 'Already performs the update of its npm dependencies.')
                 .default('install', apps.upgradePiletDefaults.install)
+                .alias('install', 'package-install')
                 .choices('force-overwrite', helpers_1.forceOverwriteKeys)
                 .describe('force-overwrite', 'Determines if files should be overwritten by the upgrading process.')
-                .default('force-overwrite', helpers_1.keyOfForceOverwrite(apps.upgradePiletDefaults.forceOverwrite))
+                .default('force-overwrite', (0, helpers_1.keyOfForceOverwrite)(apps.upgradePiletDefaults.forceOverwrite))
                 .choices('npm-client', helpers_1.clientTypeKeys)
-                .describe('npm-client', 'Sets the NPM client to be used when upgrading.')
+                .describe('npm-client', 'Sets the npm client to be used when upgrading.')
                 .default('npm-client', apps.upgradePiletDefaults.npmClient)
+                .option('vars', undefined)
+                .describe('vars', 'Sets additional variables to be used when scaffolding.')
+                .default('vars', apps.upgradePiletDefaults.variables)
                 .string('base')
                 .default('base', process.cwd())
                 .describe('base', 'Sets the base directory. By default the current directory is used.');
@@ -650,9 +746,10 @@ const allCommands = [
                 target: args.target,
                 version: args['target-version'],
                 logLevel: args['log-level'],
-                forceOverwrite: helpers_1.valueOfForceOverwrite(args['force-overwrite']),
+                forceOverwrite: (0, helpers_1.valueOfForceOverwrite)(args['force-overwrite']),
                 install: args.install,
                 npmClient: args['npm-client'],
+                variables: args.vars,
             });
         },
     },
@@ -685,6 +782,129 @@ const allCommands = [
             });
         },
     },
+    {
+        name: 'add-piral-instance-pilet',
+        alias: ['add-shell-pilet', 'install-shell-pilet', 'add-app-pilet', 'with-app-pilet'],
+        description: 'Adds another Piral instance to the available apps hosting the current pilet.',
+        arguments: ['<app> [source]'],
+        flags(argv) {
+            return argv
+                .positional('app', {
+                type: 'string',
+                describe: 'Sets the name of the Piral instance to be added.',
+                default: apps.addPiralInstancePiletDefaults.app,
+            })
+                .positional('source', {
+                type: 'string',
+                describe: 'Sets the source pilet path where the Piral instance should be added.',
+                default: apps.addPiralInstancePiletDefaults.source,
+            })
+                .number('log-level')
+                .describe('log-level', 'Sets the log level to use (1-5).')
+                .default('log-level', apps.addPiralInstancePiletDefaults.logLevel)
+                .choices('npm-client', helpers_1.clientTypeKeys)
+                .describe('npm-client', 'Sets the npm client to be used for adding the Piral instance.')
+                .default('npm-client', apps.addPiralInstancePiletDefaults.npmClient)
+                .boolean('selected')
+                .describe('selected', 'Defines if the provided Piral instance should be selected initially.')
+                .default('selected', apps.addPiralInstancePiletDefaults.selected)
+                .string('base')
+                .default('base', process.cwd())
+                .describe('base', 'Sets the base directory. By default the current directory is used.');
+        },
+        run(args) {
+            return apps.addPiralInstancePilet(args.base, {
+                logLevel: args['log-level'],
+                selected: args.selected,
+                npmClient: args['npm-client'],
+                app: args.app,
+                source: args.source,
+            });
+        },
+    },
+    {
+        name: 'remove-piral-instance-pilet',
+        alias: ['remove-shell-pilet', 'uninstall-shell-pilet', 'remove-app-pilet', 'without-app-pilet'],
+        description: 'Removes an existing Piral instance from the available apps hosting the current pilet.',
+        arguments: ['<app> [source]'],
+        flags(argv) {
+            return argv
+                .positional('app', {
+                type: 'string',
+                describe: 'Sets the name of the Piral instance to be removed.',
+                default: apps.removePiralInstancePiletDefaults.app,
+            })
+                .positional('source', {
+                type: 'string',
+                describe: 'Sets the source pilet path where the Piral instance should be removed.',
+                default: apps.removePiralInstancePiletDefaults.source,
+            })
+                .number('log-level')
+                .describe('log-level', 'Sets the log level to use (1-5).')
+                .default('log-level', apps.removePiralInstancePiletDefaults.logLevel)
+                .choices('npm-client', helpers_1.clientTypeKeys)
+                .describe('npm-client', 'Sets the npm client to be used for removing the Piral instance.')
+                .default('npm-client', apps.removePiralInstancePiletDefaults.npmClient)
+                .string('base')
+                .default('base', process.cwd())
+                .describe('base', 'Sets the base directory. By default the current directory is used.');
+        },
+        run(args) {
+            return apps.removePiralInstancePilet(args.base, {
+                logLevel: args['log-level'],
+                app: args.app,
+                source: args.source,
+                npmClient: args['npm-client'],
+            });
+        },
+    },
+    {
+        name: 'run-emulator-piral',
+        alias: ['start-emulator-piral', 'dev-emulator-portal'],
+        description: 'Starts a Piral instance emulator.',
+        arguments: ['[source]'],
+        // "any" due to https://github.com/microsoft/TypeScript/issues/28663 [artifical N = 50]
+        flags(argv) {
+            return argv
+                .positional('source', {
+                type: 'string',
+                describe: 'Sets the source Piral instance emulator package name.',
+                default: apps.runEmulatorPiralDefaults.app,
+            })
+                .number('port')
+                .describe('port', 'Sets the port of the local development server.')
+                .default('port', apps.runEmulatorPiralDefaults.port)
+                .string('registry')
+                .describe('registry', 'Sets the package registry to use for resolving the emulator.')
+                .default('registry', apps.runEmulatorPiralDefaults.registry)
+                .alias('registry', 'package-registry')
+                .number('log-level')
+                .describe('log-level', 'Sets the log level to use (1-5).')
+                .default('log-level', apps.runEmulatorPiralDefaults.logLevel)
+                .choices('npm-client', helpers_1.clientTypeKeys)
+                .describe('npm-client', 'Sets the npm client to be used when installing the emulator.')
+                .default('npm-client', apps.runEmulatorPiralDefaults.npmClient)
+                .boolean('open')
+                .describe('open', 'Opens the Piral instance directly in the browser.')
+                .default('open', apps.runEmulatorPiralDefaults.open)
+                .string('feed')
+                .describe('feed', 'Sets the URL of a pilet feed for including remote pilets.')
+                .string('base')
+                .default('base', process.cwd())
+                .describe('base', 'Sets the base directory. By default the current directory is used.');
+        },
+        run(args) {
+            return apps.runEmulatorPiral(args.base, {
+                port: args.port,
+                app: args.source,
+                npmClient: args['npm-client'],
+                registry: args.registry,
+                logLevel: args['log-level'],
+                open: args.open,
+                feed: args.feed,
+            });
+        },
+    },
 ];
 class Commands {
     constructor() {