@salesforce/plugin-lightning-dev 6.2.15 → 6.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +39 -20
  2. package/lib/commands/lightning/dev/component.js +2 -2
  3. package/lib/commands/lightning/dev/component.js.map +1 -1
  4. package/messages/lightning.dev.app.md +9 -5
  5. package/messages/lightning.dev.component.md +13 -10
  6. package/messages/lightning.dev.site.md +8 -5
  7. package/npm-shrinkwrap.json +2 -3
  8. package/oclif.manifest.json +12 -12
  9. package/package.json +7 -7
package/README.md CHANGED
@@ -149,7 +149,13 @@ If a new org is required for NUTs tests, these are the steps to create and confi
149
149
 
150
150
  ## Running NUTs (integration tests) locally
151
151
 
152
- NUTs (e2e integration tests) run the plugin against a real org and, for component-preview tests, a real browser (Playwright). To run them locally:
152
+ 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:
153
+
154
+ ```bash
155
+ npx playwright install --with-deps
156
+ ```
157
+
158
+ To run NUTs locally:
153
159
 
154
160
  1. **Environment variables**
155
161
  Copy `.env.template` to `.env` and set the values for your Dev Hub org and test setup:
@@ -215,7 +221,7 @@ GLOBAL FLAGS
215
221
  DESCRIPTION
216
222
  Preview a Lightning Experience app locally and in real-time, without deploying it.
217
223
 
218
- 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
224
+ Use Local Dev to see local changes to your app in a real-time preview that you don't have to deploy or manually
219
225
  refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your app preview automatically
220
226
  refreshes when Local Dev detects source code changes.
221
227
 
@@ -233,8 +239,12 @@ DESCRIPTION
233
239
  your live app. To update your local version of the app with those changes, you must retrieve them from your org using
234
240
  the `sf project retrieve start` command.
235
241
 
242
+ If you run the command without flags, it displays a list of devices for you to choose from. Then it lists the apps
243
+ that it found in your local DX project for you to choose. Use the --device or --name flags to bypass the questions.
244
+ The command also asks if you want to enable Local Dev in your org if it isn't already.
245
+
236
246
  To learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer
237
- Guide.
247
+ Guide (https://developer.salesforce.com/docs/platform/lwc/guide/get-started-test-components.html).
238
248
 
239
249
  EXAMPLES
240
250
  Preview the default app for the target org "myOrg" in a desktop environment:
@@ -250,18 +260,18 @@ EXAMPLES
250
260
  $ sf lightning dev app --target-org myOrg --device-type ios --device-id "iPhone 15 Pro Max"
251
261
  ```
252
262
 
253
- _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)_
263
+ _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)_
254
264
 
255
265
  ## `sf lightning dev component`
256
266
 
257
- [Beta] Preview LWC components in isolation.
267
+ Preview LWC components in isolation.
258
268
 
259
269
  ```
260
270
  USAGE
261
271
  $ sf lightning dev component -o <value> [--json] [--flags-dir <value>] [-n <value>] [--api-version <value>] [-c]
262
272
 
263
273
  FLAGS
264
- -c, --client-select Launch component preview without selecting a component
274
+ -c, --client-select Launch component preview without selecting a component.
265
275
  -n, --name=<value> Name of a component to preview.
266
276
  -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
267
277
  configuration variable is already set.
@@ -272,7 +282,7 @@ GLOBAL FLAGS
272
282
  --json Format output as json.
273
283
 
274
284
  DESCRIPTION
275
- [Beta] Preview LWC components in isolation.
285
+ Preview LWC components in isolation.
276
286
 
277
287
  Component preview launches an isolated development environment for Lightning Web Components, enabling rapid iteration
278
288
  without needing to deploy changes. The server provides real-time previews of your components through hot module
@@ -286,31 +296,36 @@ DESCRIPTION
286
296
  - Adding or updating internal component dependencies
287
297
  - Modifying static resources used by the component
288
298
 
289
- See the LWC Development Guide for more information about component development best practices and limitations.
299
+ If you run the command without flags, it displays a list of components that it found in your local DX project for you
300
+ to choose to preview. Use the --name flag to bypass the question. The command also asks if you want to enable Local
301
+ Dev in your org if it isn't already.
302
+
303
+ See the LWC Developer Guide for more information about component development best practices and limitations
304
+ (https://developer.salesforce.com/docs/platform/lwc/guide/get-started-best-practices.html).
290
305
 
291
306
  EXAMPLES
292
- Select a component and launch the component preview:
307
+ Select a component interactively and launch the component preview; use your default org:
293
308
 
294
309
  $ sf lightning dev component
295
310
 
296
- Launch component preview for "myComponent":
311
+ Launch component preview for "myComponent"; use the org with alias "myscratch":
297
312
 
298
- $ sf lightning dev component --name myComponent
313
+ $ sf lightning dev component --name myComponent --target-org myscratch
299
314
  ```
300
315
 
301
- _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)_
316
+ _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)_
302
317
 
303
318
  ## `sf lightning dev site`
304
319
 
305
- [Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
320
+ Preview an Experience Builder site locally and in real-time, without deploying it.
306
321
 
307
322
  ```
308
323
  USAGE
309
324
  $ sf lightning dev site -o <value> [--flags-dir <value>] [-n <value>] [--api-version <value>]
310
325
 
311
326
  FLAGS
312
- -n, --name=<value> Name of the Experience Builder site to preview. It has to match a site name from the
313
- current org.
327
+ -n, --name=<value> Name of the Experience Builder site to preview. It must match a site name from the current
328
+ org.
314
329
  -o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
315
330
  configuration variable is already set.
316
331
  --api-version=<value> Override the api version used for api requests made by this command
@@ -319,7 +334,7 @@ GLOBAL FLAGS
319
334
  --flags-dir=<value> Import flag values from a directory.
320
335
 
321
336
  DESCRIPTION
322
- [Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
337
+ Preview an Experience Builder site locally and in real-time, without deploying it.
323
338
 
324
339
  Enable Local Dev to see local changes to your site in a real-time preview that you don't have to deploy or manually
325
340
  refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your site preview automatically
@@ -335,18 +350,22 @@ DESCRIPTION
335
350
  To apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy
336
351
  start` command. Then republish your site and restart the server for the Local Dev experience.
337
352
 
353
+ If you run the command without flags, it displays a list of Experience Builder sites that it found in your local DX
354
+ project for you to choose from. Use the --name flag to bypass the question. The command also asks if you want to
355
+ enable Local Dev in your org if it isn't already.
356
+
338
357
  For more considerations and limitations, see the Lightning Web Components Developer Guide.
339
358
 
340
359
  EXAMPLES
341
- Select a site to preview from the org "myOrg":
360
+ Select a site to preview from the org with alias "myOrg":
342
361
 
343
362
  $ sf lightning dev site --target-org myOrg
344
363
 
345
- Preview the site "Partner Central" from the org "myOrg":
364
+ Preview the site "Partner Central" from your default org:
346
365
 
347
- $ sf lightning dev site --name "Partner Central" --target-org myOrg
366
+ $ sf lightning dev site --name "Partner Central"
348
367
  ```
349
368
 
350
- _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)_
369
+ _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)_
351
370
 
352
371
  <!-- commandsstop -->
package/lib/commands/lightning/dev/component.js CHANGED
@@ -69,9 +69,9 @@ export default class LightningDevComponent extends SfCommand {
69
69
  logger.debug('Determining Local Dev Server url');
70
70
  let ldpServerUrl;
71
71
  // In Code Builder, we cannot go to localhost - we need to use a proxy URI to get to the ldpServer
72
- if (process.env.SF_CONTAINER_MODE && process.env.VSCODE_PROXY_URI) {
72
+ if (process.env.SF_CONTAINER_MODE && process.env.CODE_BUILDER_PROXY_URI) {
73
73
  logger.debug('In Code Builder Mode - using proxy URI');
74
- ldpServerUrl = process.env.VSCODE_PROXY_URI.replace('https://', 'ws://').replace('{{port}}', `${serverPorts.httpPort}`);
74
+ ldpServerUrl = process.env.CODE_BUILDER_PROXY_URI.replace('https://', 'ws://').replace('{{port}}', `${serverPorts.httpPort}`);
75
75
  }
76
76
  else {
77
77
  // Default behavior
package/lib/commands/lightning/dev/component.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../src/commands/lightning/dev/component.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"component.js","sourceRoot":"","sources":["../../../../src/commands/lightning/dev/component.ts"],"names":[],"mappings":"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"}
package/messages/lightning.dev.app.md CHANGED
@@ -4,7 +4,7 @@ Preview a Lightning Experience app locally and in real-time, without deploying i
4
4
 
5
5
  # description
6
6
 
7
- 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.
7
+ 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.
8
8
 
9
9
  When you edit these local files with Local Dev enabled, your org automatically reflects these changes.
10
10
 
@@ -17,7 +17,9 @@ To apply any other local changes not listed above, you must deploy them to your
17
17
 
18
18
  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.
19
19
 
20
- To learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer Guide.
20
+ 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.
21
+
22
+ 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).
21
23
 
22
24
  # flags.name.summary
23
25
 
@@ -33,15 +35,15 @@ ID of the mobile device to display the preview if device type is set to `ios` or
33
35
 
34
36
  # error.fetching.app-id
35
37
 
36
- Unable to determine App Id for %s
38
+ Unable to determine App Id for %s.
37
39
 
38
40
  # error.device.notfound
39
41
 
40
- Unable to find device %s
42
+ Unable to find device %s.
41
43
 
42
44
  # error.device.google.play
43
45
 
44
- Google Play devices are not supported. %s is a Google Play device. Please use a Google APIs device instead.
46
+ Google Play devices aren't supported. %s is a Google Play device. Use a Google APIs device instead.
45
47
 
46
48
  # spinner.device.boot
47
49
 
@@ -87,7 +89,9 @@ Note: Your desktop browser requires additional configuration to trust the local
87
89
 
88
90
  - Preview the default app for the target org "myOrg" in a desktop environment:
89
91
  <%= config.bin %> <%= command.id %> --target-org myOrg
92
+
90
93
  - Preview the app "myApp" for the target org "myOrg" in a desktop environment:
91
94
  <%= config.bin %> <%= command.id %> --name MyApp --target-org myOrg --device-type desktop
95
+
92
96
  - Preview the default app for target org "myOrg" on an iOS device:
93
97
  <%= config.bin %> <%= command.id %> --target-org myOrg --device-type ios --device-id "iPhone 15 Pro Max"
package/messages/lightning.dev.component.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # summary
2
2
 
3
- [Beta] Preview LWC components in isolation.
3
+ Preview LWC components in isolation.
4
4
 
5
5
  # description
6
6
 
@@ -14,7 +14,9 @@ When running the development server, these changes are immediately reflected:
14
14
  - Adding or updating internal component dependencies
15
15
  - Modifying static resources used by the component
16
16
 
17
- See the LWC Development Guide for more information about component development best practices and limitations.
17
+ 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.
18
+
19
+ 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).
18
20
 
19
21
  # flags.name.summary
20
22
 
@@ -22,27 +24,28 @@ Name of a component to preview.
22
24
 
23
25
  # flags.client-select.summary
24
26
 
25
- Launch component preview without selecting a component
27
+ Launch component preview without selecting a component.
26
28
 
27
29
  # error.directory
28
30
 
29
- Unable to find components
31
+ Unable to find components.
30
32
 
31
33
  # error.component
32
34
 
33
- Unable to determine component name
35
+ Unable to determine component name.
34
36
 
35
37
  # error.component-metadata
36
38
 
37
- Failed to parse component metadata at: %s
39
+ Failed to parse component metadata at: %s.
38
40
 
39
41
  # error.component-not-found
40
42
 
41
- Unable to find component with name: %s
43
+ Unable to find component with name: %s.
42
44
 
43
45
  # examples
44
46
 
45
- - Select a component and launch the component preview:
47
+ - Select a component interactively and launch the component preview; use your default org:
46
48
  <%= config.bin %> <%= command.id %>
47
- - Launch component preview for "myComponent":
48
- <%= config.bin %> <%= command.id %> --name myComponent
49
+
50
+ - Launch component preview for "myComponent"; use the org with alias "myscratch":
51
+ <%= config.bin %> <%= command.id %> --name myComponent --target-org myscratch
package/messages/lightning.dev.site.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # summary
2
2
 
3
- [Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
3
+ Preview an Experience Builder site locally and in real-time, without deploying it.
4
4
 
5
5
  # description
6
6
 
@@ -15,15 +15,18 @@ When you edit these local files with Local Dev enabled, your org automatically r
15
15
 
16
16
  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.
17
17
 
18
+ 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.
19
+
18
20
  For more considerations and limitations, see the Lightning Web Components Developer Guide.
19
21
 
20
22
  # flags.name.summary
21
23
 
22
- Name of the Experience Builder site to preview. It has to match a site name from the current org.
24
+ Name of the Experience Builder site to preview. It must match a site name from the current org.
23
25
 
24
26
  # examples
25
27
 
26
- - Select a site to preview from the org "myOrg":
28
+ - Select a site to preview from the org with alias "myOrg":
27
29
  <%= config.bin %> <%= command.id %> --target-org myOrg
28
- - Preview the site "Partner Central" from the org "myOrg":
29
- <%= config.bin %> <%= command.id %> --name "Partner Central" --target-org myOrg
30
+
31
+ - Preview the site "Partner Central" from your default org:
32
+ <%= config.bin %> <%= command.id %> --name "Partner Central"
package/npm-shrinkwrap.json CHANGED
@@ -1,13 +1,12 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-lightning-dev",
3
- "version": "6.2.15",
3
+ "version": "6.2.17",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@salesforce/plugin-lightning-dev",
9
- "version": "6.2.15",
10
- "hasInstallScript": true,
9
+ "version": "6.2.17",
11
10
  "license": "Apache-2.0",
12
11
  "dependencies": {
13
12
  "@inquirer/prompts": "^5.3.8",
package/oclif.manifest.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "lightning:dev:app": {
4
4
  "aliases": [],
5
5
  "args": {},
6
- "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.\n\nWhen you edit these local files with Local Dev enabled, your org automatically reflects these changes.\n\n- Basic HTML and CSS edits to LWCs\n- JavaScript changes to LWCs that don't affect the component's public API\n- Importing new custom LWCs\n- Importing another instance of an existing LWC\n\nTo apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy start` command.\n\nWhen 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.\n\nTo learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer Guide.",
6
+ "description": "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.\n\nWhen you edit these local files with Local Dev enabled, your org automatically reflects these changes.\n\n- Basic HTML and CSS edits to LWCs\n- JavaScript changes to LWCs that don't affect the component's public API\n- Importing new custom LWCs\n- Importing another instance of an existing LWC\n\nTo apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy start` command.\n\nWhen 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.\n\nIf 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.\n\nTo 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).",
7
7
  "examples": [
8
8
  "Preview the default app for the target org \"myOrg\" in a desktop environment:\n<%= config.bin %> <%= command.id %> --target-org myOrg",
9
9
  "Preview the app \"myApp\" for the target org \"myOrg\" in a desktop environment:\n<%= config.bin %> <%= command.id %> --name MyApp --target-org myOrg --device-type desktop",
@@ -95,10 +95,10 @@
95
95
  "lightning:dev:component": {
96
96
  "aliases": [],
97
97
  "args": {},
98
- "description": "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 replacement (HMR), automatically refreshing the view when source files are modified.\n\nWhen running the development server, these changes are immediately reflected:\n\n- Component template (HTML) modifications\n- Styling updates in component CSS files\n- JavaScript logic changes that don't modify the component's API\n- Adding or updating internal component dependencies\n- Modifying static resources used by the component\n\nSee the LWC Development Guide for more information about component development best practices and limitations.",
98
+ "description": "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 replacement (HMR), automatically refreshing the view when source files are modified.\n\nWhen running the development server, these changes are immediately reflected:\n\n- Component template (HTML) modifications\n- Styling updates in component CSS files\n- JavaScript logic changes that don't modify the component's API\n- Adding or updating internal component dependencies\n- Modifying static resources used by the component\n\nIf 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.\n\nSee 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).",
99
99
  "examples": [
100
- "Select a component and launch the component preview:\n<%= config.bin %> <%= command.id %>",
101
- "Launch component preview for \"myComponent\":\n<%= config.bin %> <%= command.id %> --name myComponent"
100
+ "Select a component interactively and launch the component preview; use your default org:\n<%= config.bin %> <%= command.id %>",
101
+ "Launch component preview for \"myComponent\"; use the org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --name myComponent --target-org myscratch"
102
102
  ],
103
103
  "flags": {
104
104
  "json": {
@@ -134,7 +134,7 @@
134
134
  "client-select": {
135
135
  "char": "c",
136
136
  "name": "client-select",
137
- "summary": "Launch component preview without selecting a component",
137
+ "summary": "Launch component preview without selecting a component.",
138
138
  "allowNo": false,
139
139
  "type": "boolean"
140
140
  },
@@ -156,7 +156,7 @@
156
156
  "pluginName": "@salesforce/plugin-lightning-dev",
157
157
  "pluginType": "core",
158
158
  "strict": true,
159
- "summary": "[Beta] Preview LWC components in isolation.",
159
+ "summary": "Preview LWC components in isolation.",
160
160
  "enableJsonFlag": true,
161
161
  "isESM": true,
162
162
  "relativePath": [
@@ -179,10 +179,10 @@
179
179
  "lightning:dev:site": {
180
180
  "aliases": [],
181
181
  "args": {},
182
- "description": "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 refreshes when Local Dev detects source code changes.\n\nWhen you edit these local files with Local Dev enabled, your org automatically reflects these changes.\n\n- Basic HTML and CSS edits to LWCs\n- JavaScript changes to LWCs that don't affect the component's public API\n- Importing new custom LWCs\n- Importing another instance of an existing LWC\n\nTo 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.\n\nFor more considerations and limitations, see the Lightning Web Components Developer Guide.",
182
+ "description": "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 refreshes when Local Dev detects source code changes.\n\nWhen you edit these local files with Local Dev enabled, your org automatically reflects these changes.\n\n- Basic HTML and CSS edits to LWCs\n- JavaScript changes to LWCs that don't affect the component's public API\n- Importing new custom LWCs\n- Importing another instance of an existing LWC\n\nTo 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.\n\nIf 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.\n\nFor more considerations and limitations, see the Lightning Web Components Developer Guide.",
183
183
  "examples": [
184
- "Select a site to preview from the org \"myOrg\":\n<%= config.bin %> <%= command.id %> --target-org myOrg",
185
- "Preview the site \"Partner Central\" from the org \"myOrg\":\n<%= config.bin %> <%= command.id %> --name \"Partner Central\" --target-org myOrg"
184
+ "Select a site to preview from the org with alias \"myOrg\":\n<%= config.bin %> <%= command.id %> --target-org myOrg",
185
+ "Preview the site \"Partner Central\" from your default org:\n<%= config.bin %> <%= command.id %> --name \"Partner Central\""
186
186
  ],
187
187
  "flags": {
188
188
  "flags-dir": {
@@ -196,7 +196,7 @@
196
196
  "name": {
197
197
  "char": "n",
198
198
  "name": "name",
199
- "summary": "Name of the Experience Builder site to preview. It has to match a site name from the current org.",
199
+ "summary": "Name of the Experience Builder site to preview. It must match a site name from the current org.",
200
200
  "hasDynamicHelp": false,
201
201
  "multiple": false,
202
202
  "type": "option"
@@ -226,7 +226,7 @@
226
226
  "pluginName": "@salesforce/plugin-lightning-dev",
227
227
  "pluginType": "core",
228
228
  "strict": true,
229
- "summary": "[Beta] Preview an Experience Builder site locally and in real-time, without deploying it.",
229
+ "summary": "Preview an Experience Builder site locally and in real-time, without deploying it.",
230
230
  "enableJsonFlag": false,
231
231
  "isESM": true,
232
232
  "relativePath": [
@@ -247,5 +247,5 @@
247
247
  ]
248
248
  }
249
249
  },
250
- "version": "6.2.15"
250
+ "version": "6.2.17"
251
251
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-lightning-dev",
3
3
  "description": "Lightning development tools for LEX, Mobile, and Experience Sites",
4
- "version": "6.2.15",
4
+ "version": "6.2.17",
5
5
  "author": "Salesforce",
6
6
  "bugs": "https://github.com/forcedotcom/cli/issues",
7
7
  "dependencies": {
@@ -80,6 +80,7 @@
80
80
  "topics": {
81
81
  "lightning": {
82
82
  "external": true,
83
+ "description": "Commands to work with Lightning applications.",
83
84
  "subtopics": {
84
85
  "dev": {
85
86
  "description": "Preview applications and sites locally and in real-time, without deploying them."
@@ -101,14 +102,13 @@
101
102
  "link-check": "wireit",
102
103
  "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",
103
104
  "lint": "wireit",
104
- "postinstall": "npx playwright install --with-deps",
105
105
  "postpack": "sf-clean --ignore-signing-artifacts",
106
106
  "prepack": "sf-prepack",
107
107
  "prepare": "sf-install",
108
108
  "test": "wireit",
109
- "test:nuts": "mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
110
- "test:nuts:local": "node -r dotenv/config ./node_modules/.bin/nyc mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
111
- "test:nut:local": "node -r dotenv/config ./node_modules/.bin/nyc mocha --slow 30000 --timeout 600000",
109
+ "test:nuts": "npx playwright install --with-deps && mocha \"**/*.nut.ts\" --slow 30000 --timeout 600000 --parallel=false",
110
+ "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",
111
+ "test:nut:local": "npx playwright install --with-deps && node -r dotenv/config ./node_modules/.bin/nyc mocha --slow 30000 --timeout 600000",
112
112
  "test:only": "wireit",
113
113
  "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",
114
114
  "update-snapshots": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" snapshot:generate",
@@ -256,7 +256,7 @@
256
256
  "yarn": "1.22.22"
257
257
  },
258
258
  "sfdx": {
259
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-lightning-dev/6.2.15.crt",
260
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-lightning-dev/6.2.15.sig"
259
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-lightning-dev/6.2.17.crt",
260
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-lightning-dev/6.2.17.sig"
261
261
  }
262
262
  }