Merge branch 'main' into dependabot-npm_and_yarn-oclif-4.22.81

wjhsf · web-flow · commit 1cd61cf0b9a3 · 2026-04-02T17:53:35.000Z
diff --git a/.github/workflows/onRelease.yml b/.github/workflows/onRelease.yml
@@ -47,8 +47,6 @@ jobs:
     with:
       ctc: true
       sign: true
-      # At CLCO, the new patch branch's version will be released as 'prerelease'. After R2b, delete the logic below for 'latest' and update 'prerelease' candidate to 'latest'
-      tag: ${{ needs.getDistTag.outputs.tag || (needs.getMajorVersion.outputs.major == '4' && 'latest') || (needs.getMajorVersion.outputs.major == '5' && 'prerelease') || 'next' }}
       githubTag: ${{ github.event.release.tag_name || inputs.tag }}
 
     secrets: inherit
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [6.2.17](https://github.com/salesforcecli/plugin-lightning-dev/compare/6.2.16...6.2.17) (2026-03-27)
+
+## [6.2.16](https://github.com/salesforcecli/plugin-lightning-dev/compare/6.2.15...6.2.16) (2026-03-12)
+
+### Bug Fixes
+
+- use CODE_BUILDER_PROXY_URI since it's already authenticated ([f71e77e](https://github.com/salesforcecli/plugin-lightning-dev/commit/f71e77ebd602dabb31211dfa5afde6059589d3a9))
+
 ## [6.2.15](https://github.com/salesforcecli/plugin-lightning-dev/compare/6.2.14...6.2.15) (2026-02-28)
 
 ### Bug Fixes
diff --git a/README.md b/README.md
@@ -149,7 +149,13 @@ If a new org is required for NUTs tests, these are the steps to create and confi
 
 ## Running NUTs (integration tests) locally
 
-NUTs (e2e integration tests) run the plugin against a real org and, for component-preview tests, a real browser (Playwright). To run them locally:
+NUTs (e2e integration tests) run the plugin against a real org and, for component-preview tests, a real browser (Playwright). Playwright browsers are installed automatically on CI but must be installed manually for local runs:
+
+```bash
+npx playwright install --with-deps
+```
+
+To run NUTs locally:
 
 1. **Environment variables**  
    Copy `.env.template` to `.env` and set the values for your Dev Hub org and test setup:
@@ -215,7 +221,7 @@ GLOBAL FLAGS
 DESCRIPTION
   Preview a Lightning Experience app locally and in real-time, without deploying it.
 
-  Use Local Dev (Beta) to see local changes to your app in a real-time preview that you don't have to deploy or manually
+  Use Local Dev to see local changes to your app in a real-time preview that you don't have to deploy or manually
   refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your app preview automatically
   refreshes when Local Dev detects source code changes.
 
@@ -233,8 +239,12 @@ DESCRIPTION
   your live app. To update your local version of the app with those changes, you must retrieve them from your org using
   the `sf project retrieve start` command.
 
+  If you run the command without flags, it displays a list of devices for you to choose from. Then it lists the apps
+  that it found in your local DX project for you to choose. Use the --device or --name flags to bypass the questions.
+  The command also asks if you want to enable Local Dev in your org if it isn't already.
+
   To learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer
-  Guide.
+  Guide (https://developer.salesforce.com/docs/platform/lwc/guide/get-started-test-components.html).
 
 EXAMPLES
   Preview the default app for the target org "myOrg" in a desktop environment:
@@ -250,18 +260,18 @@ EXAMPLES
     $ sf lightning dev app --target-org myOrg --device-type ios --device-id "iPhone 15 Pro Max"
 ```
 
-_See code: [src/commands/lightning/dev/app.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/6.2.15/src/commands/lightning/dev/app.ts)_
+_See code: [src/commands/lightning/dev/app.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/6.2.17/src/commands/lightning/dev/app.ts)_
 
 ## `sf lightning dev component`
 
-[Beta] Preview LWC components in isolation.
+Preview LWC components in isolation.
 
 ```
 USAGE
   $ sf lightning dev component -o <value> [--json] [--flags-dir <value>] [-n <value>] [--api-version <value>] [-c]
 
 FLAGS
-  -c, --client-select        Launch component preview without selecting a component
+  -c, --client-select        Launch component preview without selecting a component.
   -n, --name=<value>         Name of a component to preview.
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                              configuration variable is already set.
@@ -272,7 +282,7 @@ GLOBAL FLAGS
   --json               Format output as json.
 
 DESCRIPTION
-  [Beta] Preview LWC components in isolation.
+  Preview LWC components in isolation.
 
   Component preview launches an isolated development environment for Lightning Web Components, enabling rapid iteration
   without needing to deploy changes. The server provides real-time previews of your components through hot module
@@ -286,31 +296,36 @@ DESCRIPTION
   - Adding or updating internal component dependencies
   - Modifying static resources used by the component
 
-  See the LWC Development Guide for more information about component development best practices and limitations.
+  If you run the command without flags, it displays a list of components that it found in your local DX project for you
+  to choose to preview. Use the --name flag to bypass the question. The command also asks if you want to enable Local
+  Dev in your org if it isn't already.
+
+  See the LWC Developer Guide for more information about component development best practices and limitations
+  (https://developer.salesforce.com/docs/platform/lwc/guide/get-started-best-practices.html).
 
 EXAMPLES
-  Select a component and launch the component preview:
+  Select a component interactively and launch the component preview; use your default org:
 
     $ sf lightning dev component
 
-  Launch component preview for "myComponent":
+  Launch component preview for "myComponent"; use the org with alias "myscratch":
 
-    $ sf lightning dev component --name myComponent
+    $ sf lightning dev component --name myComponent --target-org myscratch
 ```
 
-_See code: [src/commands/lightning/dev/component.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/6.2.15/src/commands/lightning/dev/component.ts)_
+_See code: [src/commands/lightning/dev/component.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/6.2.17/src/commands/lightning/dev/component.ts)_
 
 ## `sf lightning dev site`
 
-[Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
+Preview an Experience Builder site locally and in real-time, without deploying it.
 
 ```
 USAGE
   $ sf lightning dev site -o <value> [--flags-dir <value>] [-n <value>] [--api-version <value>]
 
 FLAGS
-  -n, --name=<value>         Name of the Experience Builder site to preview. It has to match a site name from the
-                             current org.
+  -n, --name=<value>         Name of the Experience Builder site to preview. It must match a site name from the current
+                             org.
   -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                              configuration variable is already set.
       --api-version=<value>  Override the api version used for api requests made by this command
@@ -319,7 +334,7 @@ GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
 
 DESCRIPTION
-  [Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
+  Preview an Experience Builder site locally and in real-time, without deploying it.
 
   Enable Local Dev to see local changes to your site in a real-time preview that you don't have to deploy or manually
   refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your site preview automatically
@@ -335,18 +350,22 @@ DESCRIPTION
   To apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy
   start` command. Then republish your site and restart the server for the Local Dev experience.
 
+  If you run the command without flags, it displays a list of Experience Builder sites that it found in your local DX
+  project for you to choose from. Use the --name flag to bypass the question. The command also asks if you want to
+  enable Local Dev in your org if it isn't already.
+
   For more considerations and limitations, see the Lightning Web Components Developer Guide.
 
 EXAMPLES
-  Select a site to preview from the org "myOrg":
+  Select a site to preview from the org with alias "myOrg":
 
     $ sf lightning dev site --target-org myOrg
 
-  Preview the site "Partner Central" from the org "myOrg":
+  Preview the site "Partner Central" from your default org:
 
-    $ sf lightning dev site --name "Partner Central" --target-org myOrg
+    $ sf lightning dev site --name "Partner Central"
 ```
 
-_See code: [src/commands/lightning/dev/site.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/6.2.15/src/commands/lightning/dev/site.ts)_
+_See code: [src/commands/lightning/dev/site.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/6.2.17/src/commands/lightning/dev/site.ts)_
 
 <!-- commandsstop -->
diff --git a/messages/lightning.dev.app.md b/messages/lightning.dev.app.md
@@ -4,7 +4,7 @@ Preview a Lightning Experience app locally and in real-time, without deploying i
 
 # description
 
-Use Local Dev (Beta) to see local changes to your app in a real-time preview that you don't have to deploy or manually refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your app preview automatically refreshes when Local Dev detects source code changes.
+Use Local Dev to see local changes to your app in a real-time preview that you don't have to deploy or manually refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your app preview automatically refreshes when Local Dev detects source code changes.
 
 When you edit these local files with Local Dev enabled, your org automatically reflects these changes.
 
@@ -17,7 +17,9 @@ To apply any other local changes not listed above, you must deploy them to your
 
 When you make changes directly in your org (like saving new component properties), they're automatically deployed to your live app. To update your local version of the app with those changes, you must retrieve them from your org using the `sf project retrieve start` command.
 
-To learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer Guide.
+If you run the command without flags, it displays a list of devices for you to choose from. Then it lists the apps that it found in your local DX project for you to choose. Use the --device or --name flags to bypass the questions. The command also asks if you want to enable Local Dev in your org if it isn't already.
+
+To learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer Guide (https://developer.salesforce.com/docs/platform/lwc/guide/get-started-test-components.html).
 
 # flags.name.summary
 
@@ -33,15 +35,15 @@ ID of the mobile device to display the preview if device type is set to `ios` or
 
 # error.fetching.app-id
 
-Unable to determine App Id for %s
+Unable to determine App Id for %s.
 
 # error.device.notfound
 
-Unable to find device %s
+Unable to find device %s.
 
 # error.device.google.play
 
-Google Play devices are not supported. %s is a Google Play device. Please use a Google APIs device instead.
+Google Play devices aren't supported. %s is a Google Play device. Use a Google APIs device instead.
 
 # spinner.device.boot
 
@@ -87,7 +89,9 @@ Note: Your desktop browser requires additional configuration to trust the local
 
 - Preview the default app for the target org "myOrg" in a desktop environment:
   <%= config.bin %> <%= command.id %> --target-org myOrg
+
 - Preview the app "myApp" for the target org "myOrg" in a desktop environment:
   <%= config.bin %> <%= command.id %> --name MyApp --target-org myOrg --device-type desktop
+
 - Preview the default app for target org "myOrg" on an iOS device:
   <%= config.bin %> <%= command.id %> --target-org myOrg --device-type ios --device-id "iPhone 15 Pro Max"
diff --git a/messages/lightning.dev.component.md b/messages/lightning.dev.component.md
@@ -1,6 +1,6 @@
 # summary
 
-[Beta] Preview LWC components in isolation.
+Preview LWC components in isolation.
 
 # description
 
@@ -14,35 +14,38 @@ When running the development server, these changes are immediately reflected:
 - Adding or updating internal component dependencies
 - Modifying static resources used by the component
 
-See the LWC Development Guide for more information about component development best practices and limitations.
+If you run the command without flags, it displays a list of components that it found in your local DX project for you to choose to preview. Use the --name flag to bypass the question. The command also asks if you want to enable Local Dev in your org if it isn't already.
+
+See the LWC Developer Guide for more information about component development best practices and limitations (https://developer.salesforce.com/docs/platform/lwc/guide/get-started-best-practices.html).
 
 # flags.name.summary
 
 Name of a component to preview.
 
 # flags.client-select.summary
 
-Launch component preview without selecting a component
+Launch component preview without selecting a component.
 
 # error.directory
 
-Unable to find components
+Unable to find components.
 
 # error.component
 
-Unable to determine component name
+Unable to determine component name.
 
 # error.component-metadata
 
-Failed to parse component metadata at: %s
+Failed to parse component metadata at: %s.
 
 # error.component-not-found
 
-Unable to find component with name: %s
+Unable to find component with name: %s.
 
 # examples
 
-- Select a component and launch the component preview:
+- Select a component interactively and launch the component preview; use your default org:
   <%= config.bin %> <%= command.id %>
-- Launch component preview for "myComponent":
-  <%= config.bin %> <%= command.id %> --name myComponent
+
+- Launch component preview for "myComponent"; use the org with alias "myscratch":
+  <%= config.bin %> <%= command.id %> --name myComponent --target-org myscratch
diff --git a/messages/lightning.dev.site.md b/messages/lightning.dev.site.md
@@ -1,6 +1,6 @@
 # summary
 
-[Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
+Preview an Experience Builder site locally and in real-time, without deploying it.
 
 # description
 
@@ -15,15 +15,18 @@ When you edit these local files with Local Dev enabled, your org automatically r
 
 To apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy start` command. Then republish your site and restart the server for the Local Dev experience.
 
+If you run the command without flags, it displays a list of Experience Builder sites that it found in your local DX project for you to choose from. Use the --name flag to bypass the question. The command also asks if you want to enable Local Dev in your org if it isn't already.
+
 For more considerations and limitations, see the Lightning Web Components Developer Guide.
 
 # flags.name.summary
 
-Name of the Experience Builder site to preview. It has to match a site name from the current org.
+Name of the Experience Builder site to preview. It must match a site name from the current org.
 
 # examples
 
-- Select a site to preview from the org "myOrg":
+- Select a site to preview from the org with alias "myOrg":
   <%= config.bin %> <%= command.id %> --target-org myOrg
-- Preview the site "Partner Central" from the org "myOrg":
-  <%= config.bin %> <%= command.id %> --name "Partner Central" --target-org myOrg
+
+- Preview the site "Partner Central" from your default org:
+  <%= config.bin %> <%= command.id %> --name "Partner Central" 
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/plugin-lightning-dev",
   "description": "Lightning development tools for LEX, Mobile, and Experience Sites",
-  "version": "6.2.15",
+  "version": "6.2.17",
   "author": "Salesforce",
   "bugs": "https://github.com/forcedotcom/cli/issues",
   "dependencies": {
@@ -80,6 +80,7 @@
     "topics": {
       "lightning": {
         "external": true,
+        "description": "Commands to work with Lightning applications.",
         "subtopics": {
           "dev": {
             "description": "Preview applications and sites locally and in real-time, without deploying them."
@@ -101,14 +102,13 @@
     "link-check": "wireit",
     "link-lwr": "yarn link @lwrjs/api @lwrjs/app-service @lwrjs/asset-registry @lwrjs/asset-transformer @lwrjs/auth-middleware @lwrjs/base-view-provider @lwrjs/base-view-transformer @lwrjs/client-modules @lwrjs/config @lwrjs/core @lwrjs/dev-proxy-server @lwrjs/diagnostics @lwrjs/esbuild @lwrjs/everywhere @lwrjs/fs-asset-provider @lwrjs/fs-watch @lwrjs/html-view-provider @lwrjs/instrumentation @lwrjs/label-module-provider @lwrjs/lambda @lwrjs/legacy-npm-module-provider @lwrjs/loader @lwrjs/lwc-module-provider @lwrjs/lwc-ssr @lwrjs/markdown-view-provider @lwrjs/module-bundler @lwrjs/module-registry @lwrjs/npm-module-provider @lwrjs/nunjucks-view-provider @lwrjs/o11y @lwrjs/resource-registry @lwrjs/router @lwrjs/security @lwrjs/server @lwrjs/shared-utils @lwrjs/static @lwrjs/tools @lwrjs/types @lwrjs/view-registry lwr",
     "lint": "wireit",
-    "postinstall": "npx playwright install --with-deps",
     "postpack": "sf-clean --ignore-signing-artifacts",
     "prepack": "sf-prepack",
     "prepare": "sf-install",
     "test": "wireit",
-    "test:nuts": "mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
-    "test:nuts:local": "node -r dotenv/config ./node_modules/.bin/nyc mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
-    "test:nut:local": "node -r dotenv/config ./node_modules/.bin/nyc mocha --slow 30000 --timeout 600000",
+    "test:nuts": "npx playwright install --with-deps && mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
+    "test:nuts:local": "npx playwright install --with-deps && node -r dotenv/config ./node_modules/.bin/nyc mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
+    "test:nut:local": "npx playwright install --with-deps && node -r dotenv/config ./node_modules/.bin/nyc mocha --slow 30000 --timeout 600000",
     "test:only": "wireit",
     "unlink-lwr": "yarn unlink @lwrjs/api @lwrjs/app-service @lwrjs/asset-registry @lwrjs/asset-transformer @lwrjs/auth-middleware @lwrjs/base-view-provider @lwrjs/base-view-transformer @lwrjs/client-modules @lwrjs/config @lwrjs/core @lwrjs/dev-proxy-server @lwrjs/diagnostics @lwrjs/esbuild @lwrjs/everywhere @lwrjs/fs-asset-provider @lwrjs/fs-watch @lwrjs/html-view-provider @lwrjs/instrumentation @lwrjs/label-module-provider @lwrjs/lambda @lwrjs/legacy-npm-module-provider @lwrjs/loader @lwrjs/lwc-module-provider @lwrjs/lwc-ssr @lwrjs/markdown-view-provider @lwrjs/module-bundler @lwrjs/module-registry @lwrjs/npm-module-provider @lwrjs/nunjucks-view-provider @lwrjs/o11y @lwrjs/resource-registry @lwrjs/router @lwrjs/security @lwrjs/server @lwrjs/shared-utils @lwrjs/static @lwrjs/tools @lwrjs/types @lwrjs/view-registry lwr",
     "update-snapshots": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" snapshot:generate",
diff --git a/src/commands/lightning/dev/component.ts b/src/commands/lightning/dev/component.ts
@@ -91,9 +91,9 @@ export default class LightningDevComponent extends SfCommand<ComponentPreviewRes
     let ldpServerUrl;
 
     // In Code Builder, we cannot go to localhost - we need to use a proxy URI to get to the ldpServer
-    if (process.env.SF_CONTAINER_MODE && process.env.VSCODE_PROXY_URI) {
+    if (process.env.SF_CONTAINER_MODE && process.env.CODE_BUILDER_PROXY_URI) {
       logger.debug('In Code Builder Mode - using proxy URI');
-      ldpServerUrl = process.env.VSCODE_PROXY_URI.replace('https://', 'ws://').replace(
+      ldpServerUrl = process.env.CODE_BUILDER_PROXY_URI.replace('https://', 'ws://').replace(
         '{{port}}',
         `${serverPorts.httpPort}`,
       );
