@salesforce/plugin-templates 56.7.2 → 56.8.1

package/README.md

@@ -122,6 +122,7 @@ Congrats, you are debugging!
 - [`sf template generate apex class`](#sf-template-generate-apex-class)
 - [`sf template generate apex trigger`](#sf-template-generate-apex-trigger)
 - [`sf template generate digital-experience site`](#sf-template-generate-digital-experience-site)
+- [`sf template generate flexipage`](#sf-template-generate-flexipage)
 - [`sf template generate lightning app`](#sf-template-generate-lightning-app)
 - [`sf template generate lightning component`](#sf-template-generate-lightning-component)
 - [`sf template generate lightning event`](#sf-template-generate-lightning-event)
@@ -174,7 +175,7 @@ FLAG DESCRIPTIONS
     directory.
 ```
 
-_See code: [src/commands/template/generate/analytics/template.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/analytics/template.ts)_
+_See code: [src/commands/template/generate/analytics/template.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/analytics/template.ts)_
 
 ## `sf template generate apex class`
 
@@ -234,7 +235,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/apex/class.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/apex/class.ts)_
+_See code: [src/commands/template/generate/apex/class.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/apex/class.ts)_
 
 ## `sf template generate apex trigger`
 
@@ -304,7 +305,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/apex/trigger.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/apex/trigger.ts)_
+_See code: [src/commands/template/generate/apex/trigger.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/apex/trigger.ts)_
 
 ## `sf template generate digital-experience site`
 
@@ -354,7 +355,89 @@ FLAG DESCRIPTIONS
     project, defaults to the current directory.
 ```
 
-_See code: [src/commands/template/generate/digital-experience/site.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/digital-experience/site.ts)_
+_See code: [src/commands/template/generate/digital-experience/site.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/digital-experience/site.ts)_
+
+## `sf template generate flexipage`
+
+Generate a FlexiPage, also known as a Lightning page.
+
+```
+USAGE
+  $ sf template generate flexipage -n <value> -t RecordPage|AppPage|HomePage [--json] [--flags-dir <value>] [-d <value>]
+    [--api-version <value>] [--label <value>] [--description <value>] [-s <value>] [--primary-field <value>]
+    [--secondary-fields <value>...] [--detail-fields <value>...]
+
+FLAGS
+  -d, --output-dir=<value>           [default: .] Directory for saving the created files.
+  -n, --name=<value>                 (required) Name of the FlexiPage.
+  -s, --sobject=<value>              API name of the Salesforce object; required when creating a RecordPage.
+  -t, --template=<option>            (required) Template type for the FlexiPage.
+                                     <options: RecordPage|AppPage|HomePage>
+      --api-version=<value>          Override the api version used for api requests made by this command
+      --description=<value>          Description for the FlexiPage, which provides context about its purpose.
+      --detail-fields=<value>...     Fields to display in the Details tab. Specify multiple fields separated by commas.
+                                     Fields are split into two columns. Used only with RecordPage.
+      --label=<value>                Label of this FlexiPage; if not specified, uses the FlexiPage name as the label.
+      --primary-field=<value>        Primary field for the dynamic highlights header; typically 'Name'. Used only with
+                                     RecordPage.
+      --secondary-fields=<value>...  Secondary fields shown in the dynamic highlights header. Specify multiple fields
+                                     separated by commas. Maximum of 11 fields. Used only with RecordPage.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Generate a FlexiPage, also known as a Lightning page.
+
+  FlexiPages are the metadata types associated with a Lightning page. A Lightning page represents a customizable screen
+  made up of regions containing Lightning components.
+
+  You can use this command to generate these types of FlexiPages; specify the type with the --template flag:
+
+  - AppPage: A Lightning page used as the home page for a custom app or a standalone application page.
+  - HomePage: A Lightning page used to override the Home page in Lightning Experience.
+  - RecordPage: A Lightning page used to override an object record page in Lightning Experience. Requires that you
+  specify the object name with the --sobject flag.
+
+EXAMPLES
+  Generate a RecordPage FlexiPage for the Account object in the current directory:
+
+    $ sf template generate flexipage --name Account_Record_Page --template RecordPage --sobject Account
+
+  Generate an AppPage FlexiPage in the "force-app/main/default/flexipages" directory:
+
+    $ sf template generate flexipage --name Sales_Dashboard --template AppPage --output-dir \
+      force-app/main/default/flexipages
+
+  Generate a HomePage FlexiPage with a custom label:
+
+    $ sf template generate flexipage --name Custom_Home --template HomePage --label "Sales Home Page"
+
+  Generate a RecordPage with dynamic highlights and detail fields:
+
+    $ sf template generate flexipage --name Property_Page --template RecordPage --sobject Rental_Property__c \
+      --primary-field Name --secondary-fields Property_Address__c,City__c --detail-fields \
+      Name,Property_Address__c,City__c,Monthly_Rent__c,Bedrooms__c
+
+FLAG DESCRIPTIONS
+  -d, --output-dir=<value>  Directory for saving the created files.
+
+    The location can be an absolute path or relative to the current working directory. The default is the current
+    directory.
+
+  -n, --name=<value>  Name of the FlexiPage.
+
+    The name can contain only alphanumeric characters, must start with a letter, and can't end with an underscore or
+    contain two consecutive underscores.
+
+  -s, --sobject=<value>  API name of the Salesforce object; required when creating a RecordPage.
+
+    For RecordPage FlexiPages, you must specify the associated object API name, such as 'Account', 'Opportunity', or
+    'Custom_Object__c'. This sets the `sobjectType` field in the FlexiPage metadata.
+```
+
+_See code: [src/commands/template/generate/flexipage/index.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/flexipage/index.ts)_
 
 ## `sf template generate lightning app`
 
@@ -410,7 +493,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/lightning/app.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/lightning/app.ts)_
+_See code: [src/commands/template/generate/lightning/app.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/lightning/app.ts)_
 
 ## `sf template generate lightning component`
 
@@ -480,7 +563,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/lightning/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/lightning/component.ts)_
+_See code: [src/commands/template/generate/lightning/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/lightning/component.ts)_
 
 ## `sf template generate lightning event`
 
@@ -536,7 +619,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/lightning/event.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/lightning/event.ts)_
+_See code: [src/commands/template/generate/lightning/event.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/lightning/event.ts)_
 
 ## `sf template generate lightning interface`
 
@@ -592,7 +675,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/lightning/interface.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/lightning/interface.ts)_
+_See code: [src/commands/template/generate/lightning/interface.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/lightning/interface.ts)_
 
 ## `sf template generate lightning test`
 
@@ -648,7 +731,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/lightning/test.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/lightning/test.ts)_
+_See code: [src/commands/template/generate/lightning/test.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/lightning/test.ts)_
 
 ## `sf template generate project`
 
@@ -754,7 +837,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [src/commands/template/generate/project/index.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/project/index.ts)_
+_See code: [src/commands/template/generate/project/index.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/project/index.ts)_
 
 ## `sf template generate static-resource`
 
@@ -817,7 +900,7 @@ FLAG DESCRIPTIONS
     etc.
 ```
 
-_See code: [src/commands/template/generate/static-resource/index.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/static-resource/index.ts)_
+_See code: [src/commands/template/generate/static-resource/index.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/static-resource/index.ts)_
 
 ## `sf template generate visualforce component`
 
@@ -874,7 +957,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/visualforce/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/visualforce/component.ts)_
+_See code: [src/commands/template/generate/visualforce/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/visualforce/component.ts)_
 
 ## `sf template generate visualforce page`
 
@@ -925,6 +1008,6 @@ FLAG DESCRIPTIONS
     The name can be up to 40 characters and must start with a letter.
 ```
 
-_See code: [src/commands/template/generate/visualforce/page.ts](https://github.com/salesforcecli/plugin-templates/blob/56.7.2/src/commands/template/generate/visualforce/page.ts)_
+_See code: [src/commands/template/generate/visualforce/page.ts](https://github.com/salesforcecli/plugin-templates/blob/56.8.1/src/commands/template/generate/visualforce/page.ts)_
 
 <!-- commandsstop -->

package/lib/commands/template/generate/flexipage/index.d.ts

@@ -0,0 +1,24 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { CreateOutput } from '@salesforce/templates';
+export default class FlexipageGenerate extends SfCommand<CreateOutput> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "beta";
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        template: import("@oclif/core/interfaces").OptionFlag<"RecordPage" | "AppPage" | "HomePage", import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sobject: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'primary-field': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'secondary-fields': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'detail-fields': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        internal: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private static readonly MAX_SECONDARY_FIELDS;
+    run(): Promise<CreateOutput>;
+}

package/lib/commands/template/generate/flexipage/index.js

@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) 2019, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, SfCommand, Ux } from '@salesforce/sf-plugins-core';
+import { TemplateType } from '@salesforce/templates';
+import { Messages } from '@salesforce/core';
+import { getCustomTemplates, runGenerator } from '../../../../utils/templateCommand.js';
+import { internalFlag, outputDirFlag } from '../../../../utils/flags.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-templates', 'flexipage');
+export default class FlexipageGenerate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'beta';
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.name.summary'),
+            description: messages.getMessage('flags.name.description'),
+            required: true,
+            aliases: ['flexipagename'],
+            deprecateAliases: true,
+        }),
+        template: Flags.option({
+            char: 't',
+            summary: messages.getMessage('flags.template.summary'),
+            required: true,
+            options: ['RecordPage', 'AppPage', 'HomePage'],
+        })(),
+        'output-dir': outputDirFlag,
+        'api-version': orgApiVersionFlagWithDeprecations,
+        label: Flags.string({
+            summary: messages.getMessage('flags.label.summary'),
+            aliases: ['masterlabel'],
+            deprecateAliases: true,
+        }),
+        description: Flags.string({
+            summary: messages.getMessage('flags.description.summary'),
+        }),
+        sobject: Flags.string({
+            char: 's',
+            summary: messages.getMessage('flags.sobject.summary'),
+            description: messages.getMessage('flags.sobject.description'),
+            aliases: ['entity-name', 'entity'],
+            deprecateAliases: true,
+        }),
+        'primary-field': Flags.string({
+            summary: messages.getMessage('flags.primary-field.summary'),
+        }),
+        'secondary-fields': Flags.string({
+            summary: messages.getMessage('flags.secondary-fields.summary'),
+            multiple: true,
+            delimiter: ',',
+        }),
+        'detail-fields': Flags.string({
+            summary: messages.getMessage('flags.detail-fields.summary'),
+            multiple: true,
+            delimiter: ',',
+        }),
+        internal: internalFlag,
+        loglevel,
+    };
+    static MAX_SECONDARY_FIELDS = 11;
+    async run() {
+        const { flags } = await this.parse(FlexipageGenerate);
+        // Validate RecordPage requires sobject
+        if (flags.template === 'RecordPage' && !flags.sobject) {
+            throw new Error(messages.getMessage('errors.recordPageRequiresSobject'));
+        }
+        // Validate RecordPage-specific flags are only used with RecordPage template
+        const recordPageOnlyFlags = ['primary-field', 'secondary-fields', 'detail-fields'];
+        if (flags.template !== 'RecordPage') {
+            for (const flagName of recordPageOnlyFlags) {
+                if (flags[flagName]) {
+                    throw new Error(messages.getMessage('errors.flagRequiresRecordPage', [flagName]));
+                }
+            }
+        }
+        // Validate secondary fields limit (Dynamic Highlights Panel supports max 11)
+        const secondaryFieldsCount = flags['secondary-fields']?.length ?? 0;
+        if (secondaryFieldsCount > FlexipageGenerate.MAX_SECONDARY_FIELDS) {
+            throw new Error(messages.getMessage('errors.tooManySecondaryFields', [
+                secondaryFieldsCount.toString(),
+                FlexipageGenerate.MAX_SECONDARY_FIELDS.toString(),
+            ]));
+        }
+        // Convert CLI flags to library options
+        const flagsAsOptions = {
+            flexipagename: flags.name,
+            template: flags.template,
+            outputdir: flags['output-dir'],
+            apiversion: flags['api-version'],
+            masterlabel: flags.label,
+            description: flags.description,
+            entityName: flags.sobject,
+            primaryField: flags['primary-field'],
+            secondaryFields: flags['secondary-fields'] ?? [],
+            detailFields: flags['detail-fields'] ?? [],
+            internal: flags.internal,
+        };
+        return runGenerator({
+            templateType: TemplateType.Flexipage,
+            opts: flagsAsOptions,
+            ux: new Ux({ jsonEnabled: this.jsonEnabled() }),
+            templates: getCustomTemplates(this.configAggregator),
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/commands/template/generate/flexipage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/template/generate/flexipage/index.ts"],"names":[],"mappings":"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"}

package/messages/digitalExperienceSite.md

@@ -12,7 +12,7 @@ Creates an Experience Cloud site with the specified template, name, and URL path
 
   <%= config.bin %> <%= command.id %> --template BuildYourOwnLWR --name mysite --url-path-prefix mysite
 
-- Generate an Experience Cloud site like the last example, but generate the files into the specified output directory: 
+- Generate an Experience Cloud site like the last example, but generate the files into the specified output directory:
 
   <%= config.bin %> <%= command.id %> --template BuildYourOwnLWR --name mysite --url-path-prefix mysite --output-dir force-app/main/default
 
@@ -28,7 +28,7 @@ Template to use when generating the site.
 
 Supported templates:
 
-- BuildYourOwnLWR - Creates blazing-fast digital experiences, such as websites, microsites, and portals, using the Lightning Web Components programming model. Powered by Lightning Web Runtime (LWR), this customizable template delivers unparalleled site performance.  For additional details, see this Salesforce Help topic: https://help.salesforce.com/s/articleView?id=experience.rss_build_your_own_lwr.htm. 
+- BuildYourOwnLWR - Creates blazing-fast digital experiences, such as websites, microsites, and portals, using the Lightning Web Components programming model. Powered by Lightning Web Runtime (LWR), this customizable template delivers unparalleled site performance. For additional details, see this Salesforce Help topic: https://help.salesforce.com/s/articleView?id=experience.rss_build_your_own_lwr.htm.
 
 # flags.url-path-prefix.summary
 

package/messages/flexipage.md

@@ -0,0 +1,83 @@
+# examples
+
+- Generate a RecordPage FlexiPage for the Account object in the current directory:
+
+  <%= config.bin %> <%= command.id %> --name Account_Record_Page --template RecordPage --sobject Account
+
+- Generate an AppPage FlexiPage in the "force-app/main/default/flexipages" directory:
+
+  <%= config.bin %> <%= command.id %> --name Sales_Dashboard --template AppPage --output-dir force-app/main/default/flexipages
+
+- Generate a HomePage FlexiPage with a custom label:
+
+  <%= config.bin %> <%= command.id %> --name Custom_Home --template HomePage --label "Sales Home Page"
+
+- Generate a RecordPage with dynamic highlights and detail fields:
+
+  <%= config.bin %> <%= command.id %> --name Property_Page --template RecordPage --sobject Rental_Property__c --primary-field Name --secondary-fields Property_Address__c,City__c --detail-fields Name,Property_Address__c,City__c,Monthly_Rent__c,Bedrooms__c
+
+# summary
+
+Generate a FlexiPage, also known as a Lightning page.
+
+# description
+
+FlexiPages are the metadata types associated with a Lightning page. A Lightning page represents a customizable screen made up of regions containing Lightning components.
+
+You can use this command to generate these types of FlexiPages; specify the type with the --template flag:
+
+- AppPage: A Lightning page used as the home page for a custom app or a standalone application page.
+- HomePage: A Lightning page used to override the Home page in Lightning Experience.
+- RecordPage: A Lightning page used to override an object record page in Lightning Experience. Requires that you specify the object name with the --sobject flag.
+
+# flags.name.summary
+
+Name of the FlexiPage.
+
+# flags.name.description
+
+The name can contain only alphanumeric characters, must start with a letter, and can't end with an underscore or contain two consecutive underscores.
+
+# flags.template.summary
+
+Template type for the FlexiPage.
+
+# flags.label.summary
+
+Label of this FlexiPage; if not specified, uses the FlexiPage name as the label.
+
+# flags.description.summary
+
+Description for the FlexiPage, which provides context about its purpose.
+
+# flags.sobject.summary
+
+API name of the Salesforce object; required when creating a RecordPage.
+
+# flags.sobject.description
+
+For RecordPage FlexiPages, you must specify the associated object API name, such as 'Account', 'Opportunity', or 'Custom_Object__c'. This sets the `sobjectType` field in the FlexiPage metadata.
+
+# flags.primary-field.summary
+
+Primary field for the dynamic highlights header; typically 'Name'. Used only with RecordPage.
+
+# flags.secondary-fields.summary
+
+Secondary fields shown in the dynamic highlights header. Specify multiple fields separated by commas. Maximum of 11 fields. Used only with RecordPage.
+
+# flags.detail-fields.summary
+
+Fields to display in the Details tab. Specify multiple fields separated by commas. Fields are split into two columns. Used only with RecordPage.
+
+# errors.recordPageRequiresSobject
+
+RecordPage template requires the --sobject flag to specify the Salesforce object API name (e.g., 'Account', 'Opportunity', 'Custom_Object__c').
+
+# errors.tooManySecondaryFields
+
+Too many secondary fields specified (%s). The Dynamic Highlights Panel supports a maximum of %s secondary fields.
+
+# errors.flagRequiresRecordPage
+
+The --%s flag can only be used with --template RecordPage.

package/messages/webApplication.md

@@ -50,4 +50,12 @@ Directory for saving the created files.
 
 # flags.output-dir.description
 
-The location can be an absolute path or relative to the current working directory. If not specified, the command reads your sfdx-project.json and defaults to the webapplications directory within your default package directory. When running outside a Salesforce DX project, defaults to the current directory.
+The location can be an absolute path or relative to the current working directory. 
+
+**Important:** The generator automatically ensures the output directory ends with "webapplications". If your specified path doesn't end with "webapplications", it's automatically appended. The web application is created at "<output-dir>/<webappname>".
+
+**Examples:**
+- "--output-dir force-app/main/default" → Creates a web application at "force-app/main/default/webapplications/MyWebApp/"
+- "--output-dir force-app/main/default/webapplications" → Creates a web application at "force-app/main/default/webapplications/MyWebApp/" (no change)
+
+If not specified, the command reads your sfdx-project.json and defaults to "webapplications" directory within your default package directory. When running outside a Salesforce DX project, defaults to the current directory.