@salesforce/plugin-templates 56.3.74 → 56.4.1

package/LICENSE.txt

@@ -1,6 +1,6 @@
 Apache License Version 2.0
 
-Copyright (c) 2025 Salesforce, Inc.
+Copyright (c) 2026 Salesforce, Inc.
 All rights reserved.
 
                                  Apache License

package/README.md

@@ -171,7 +171,7 @@ FLAG DESCRIPTIONS
     directory.
 ```
 
-_See code: [src/commands/analytics/generate/template.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/analytics/generate/template.ts)_
+_See code: [src/commands/analytics/generate/template.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/analytics/generate/template.ts)_
 
 ## `sf apex generate class`
 
@@ -230,7 +230,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/apex/generate/class.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/apex/generate/class.ts)_
+_See code: [src/commands/apex/generate/class.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/apex/generate/class.ts)_
 
 ## `sf apex generate trigger`
 
@@ -299,7 +299,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/apex/generate/trigger.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/apex/generate/trigger.ts)_
+_See code: [src/commands/apex/generate/trigger.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/apex/generate/trigger.ts)_
 
 ## `sf lightning generate app`
 
@@ -354,7 +354,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/lightning/generate/app.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/lightning/generate/app.ts)_
+_See code: [src/commands/lightning/generate/app.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/lightning/generate/app.ts)_
 
 ## `sf lightning generate component`
 
@@ -423,7 +423,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/lightning/generate/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/lightning/generate/component.ts)_
+_See code: [src/commands/lightning/generate/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/lightning/generate/component.ts)_
 
 ## `sf lightning generate event`
 
@@ -478,7 +478,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/lightning/generate/event.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/lightning/generate/event.ts)_
+_See code: [src/commands/lightning/generate/event.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/lightning/generate/event.ts)_
 
 ## `sf lightning generate interface`
 
@@ -533,7 +533,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/lightning/generate/interface.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/lightning/generate/interface.ts)_
+_See code: [src/commands/lightning/generate/interface.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/lightning/generate/interface.ts)_
 
 ## `sf lightning generate test`
 
@@ -588,7 +588,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/lightning/generate/test.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/lightning/generate/test.ts)_
+_See code: [src/commands/lightning/generate/test.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/lightning/generate/test.ts)_
 
 ## `sf project generate`
 
@@ -693,7 +693,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [src/commands/project/generate.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/project/generate.ts)_
+_See code: [src/commands/project/generate.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/project/generate.ts)_
 
 ## `sf static-resource generate`
 
@@ -755,7 +755,7 @@ FLAG DESCRIPTIONS
     etc.
 ```
 
-_See code: [src/commands/static-resource/generate.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/static-resource/generate.ts)_
+_See code: [src/commands/static-resource/generate.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/static-resource/generate.ts)_
 
 ## `sf visualforce generate component`
 
@@ -811,7 +811,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/visualforce/generate/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/visualforce/generate/component.ts)_
+_See code: [src/commands/visualforce/generate/component.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/visualforce/generate/component.ts)_
 
 ## `sf visualforce generate page`
 
@@ -861,6 +861,6 @@ FLAG DESCRIPTIONS
     The name can be up to 40 characters and must start with a letter.
 ```
 
-_See code: [src/commands/visualforce/generate/page.ts](https://github.com/salesforcecli/plugin-templates/blob/56.3.74/src/commands/visualforce/generate/page.ts)_
+_See code: [src/commands/visualforce/generate/page.ts](https://github.com/salesforcecli/plugin-templates/blob/56.4.1/src/commands/visualforce/generate/page.ts)_
 
 <!-- commandsstop -->

package/lib/commands/webapp/generate.d.ts

@@ -0,0 +1,22 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { CreateOutput } from '@salesforce/templates';
+export default class WebAppGenerate extends SfCommand<CreateOutput> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly hidden = true;
+    static readonly flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        template: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Resolves the default output directory by reading the project's sfdx-project.json.
+     * Returns the path to webApplications under the default package directory,
+     * or falls back to the current directory if not in a project context.
+     */
+    private static getDefaultOutputDir;
+    run(): Promise<CreateOutput>;
+}

package/lib/commands/webapp/generate.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2025, 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 path from 'node:path';
+import { Flags, SfCommand, Ux } from '@salesforce/sf-plugins-core';
+import { TemplateType } from '@salesforce/templates';
+import { Messages, SfProject } from '@salesforce/core';
+import { getCustomTemplates, runGenerator } from '../../utils/templateCommand.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-templates', 'webApplication');
+export default class WebAppGenerate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static hidden = true; // Hide from external developers until GA
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.name.summary'),
+            description: messages.getMessage('flags.name.description'),
+            required: true,
+        }),
+        template: Flags.string({
+            char: 't',
+            summary: messages.getMessage('flags.template.summary'),
+            description: messages.getMessage('flags.template.description'),
+            default: 'default',
+            options: ['default', 'reactbasic'],
+        }),
+        label: Flags.string({
+            char: 'l',
+            summary: messages.getMessage('flags.label.summary'),
+            description: messages.getMessage('flags.label.description'),
+        }),
+        'output-dir': Flags.directory({
+            char: 'd',
+            summary: messages.getMessage('flags.output-dir.summary'),
+            description: messages.getMessage('flags.output-dir.description'),
+        }),
+        'api-version': Flags.orgApiVersion(),
+    };
+    /**
+     * Resolves the default output directory by reading the project's sfdx-project.json.
+     * Returns the path to webApplications under the default package directory,
+     * or falls back to the current directory if not in a project context.
+     */
+    static async getDefaultOutputDir() {
+        try {
+            const project = await SfProject.resolve();
+            const defaultPackage = project.getDefaultPackage();
+            return path.join(defaultPackage.path, 'main', 'default', 'webApplications');
+        }
+        catch {
+            return '.';
+        }
+    }
+    async run() {
+        const { flags } = await this.parse(WebAppGenerate);
+        const outputDir = flags['output-dir'] ?? (await WebAppGenerate.getDefaultOutputDir());
+        const flagsAsOptions = {
+            webappname: flags.name,
+            template: flags.template,
+            masterlabel: flags.label,
+            outputdir: outputDir,
+            apiversion: flags['api-version'],
+        };
+        return runGenerator({
+            templateType: TemplateType.WebApplication,
+            opts: flagsAsOptions,
+            ux: new Ux({ jsonEnabled: this.jsonEnabled() }),
+            templates: getCustomTemplates(this.configAggregator),
+        });
+    }
+}
+//# sourceMappingURL=generate.js.map

package/lib/commands/webapp/generate.js.map

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

package/messages/webApplication.md

@@ -0,0 +1,53 @@
+# summary
+
+Generate a web application.
+
+# description
+
+Generates a web application in the specified directory or the current working directory. The web application files are created in a folder with the designated name. Web application files must be contained in a parent directory called "webApplications" in your package directory. Either run this command from an existing directory of this name, or use the --output-dir flag to create one or point to an existing one.
+
+# examples
+
+- Generate a web application called MyWebApp in the current directory:
+
+  <%= config.bin %> <%= command.id %> --name MyWebApp
+
+- Generate a React-based web application:
+
+  <%= config.bin %> <%= command.id %> --name MyReactApp --template reactbasic
+
+- Generate the web application in the "force-app/main/default/webApplications" directory:
+
+  <%= config.bin %> <%= command.id %> --name MyWebApp --output-dir force-app/main/default/webApplications
+
+# flags.name.summary
+
+Name of the generated web application.
+
+# flags.name.description
+
+This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores.
+
+# flags.template.summary
+
+Template to use for file creation.
+
+# flags.template.description
+
+Supplied parameter values or default values are filled into a copy of the template.
+
+# flags.label.summary
+
+Master label for the web application.
+
+# flags.label.description
+
+If not specified, the label is derived from the name.
+
+# flags.output-dir.summary
+
+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.

package/oclif.manifest.json

@@ -286,6 +286,104 @@
         "generate:static-resource"
       ]
     },
+    "webapp:generate": {
+      "aliases": [],
+      "args": {},
+      "description": "Generates a web application in the specified directory or the current working directory. The web application files are created in a folder with the designated name. Web application files must be contained in a parent directory called \"webApplications\" in your package directory. Either run this command from an existing directory of this name, or use the --output-dir flag to create one or point to an existing one.",
+      "examples": [
+        "Generate a web application called MyWebApp in the current directory:\n<%= config.bin %> <%= command.id %> --name MyWebApp",
+        "Generate a React-based web application:\n<%= config.bin %> <%= command.id %> --name MyReactApp --template reactbasic",
+        "Generate the web application in the \"force-app/main/default/webApplications\" directory:\n<%= config.bin %> <%= command.id %> --name MyWebApp --output-dir force-app/main/default/webApplications"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores.",
+          "name": "name",
+          "required": true,
+          "summary": "Name of the generated web application.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "template": {
+          "char": "t",
+          "description": "Supplied parameter values or default values are filled into a copy of the template.",
+          "name": "template",
+          "summary": "Template to use for file creation.",
+          "default": "default",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "default",
+            "reactbasic"
+          ],
+          "type": "option"
+        },
+        "label": {
+          "char": "l",
+          "description": "If not specified, the label is derived from the name.",
+          "name": "label",
+          "summary": "Master label for the web application.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "char": "d",
+          "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.",
+          "name": "output-dir",
+          "summary": "Directory for saving the created files.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "webapp:generate",
+      "pluginAlias": "@salesforce/plugin-templates",
+      "pluginName": "@salesforce/plugin-templates",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Generate a web application.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "webapp",
+        "generate.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "webapp:generate",
+        "generate:webapp"
+      ]
+    },
     "analytics:generate:template": {
       "aliases": [
         "force:analytics:template:create"
@@ -1806,5 +1904,5 @@
       ]
     }
   },
-  "version": "56.3.74"
+  "version": "56.4.1"
 }

package/package.json

@@ -1,22 +1,22 @@
 {
     "name": "@salesforce/plugin-templates",
     "description": "Commands to create metadata from a default or custom template",
-    "version": "56.3.74",
+    "version": "56.4.1",
     "author": "Salesforce",
     "bugs": "https://github.com/salesforcecli/plugin-templates/issues",
     "dependencies": {
         "@salesforce/core": "^8.24.0",
         "@salesforce/sf-plugins-core": "^12",
-        "@salesforce/templates": "^64.3.2"
+        "@salesforce/templates": "^65.4.1"
     },
     "devDependencies": {
         "@oclif/plugin-command-snapshot": "^5.3.8",
         "@salesforce/cli-plugins-testkit": "^5.3.41",
         "@salesforce/dev-scripts": "^11.0.4",
-        "@salesforce/plugin-command-reference": "^3.1.78",
+        "@salesforce/plugin-command-reference": "^3.1.79",
         "@types/yeoman-assert": "^3.1.4",
         "eslint-plugin-sf-plugin": "^1.20.33",
-        "oclif": "^4.22.52",
+        "oclif": "^4.22.63",
         "ts-node": "^10.9.2",
         "typescript": "^5.9.3",
         "yeoman-assert": "^3.1.1"
@@ -250,7 +250,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/56.3.74.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/56.3.74.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/56.4.1.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/56.4.1.sig"
     }
 }