@teambit/harmony.content.cli-reference 1.95.29 → 1.95.32

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/cli-reference.json +334 -180
  2. package/cli-reference.mdx +159 -152
  3. package/dist/cli-reference.json +334 -180
  4. package/dist/cli-reference.mdx.js +153 -149
  5. package/dist/cli-reference.mdx.js.map +1 -1
  6. package/package-tar/teambit-harmony.content.cli-reference-1.95.32.tgz +0 -0
  7. package/package.json +2 -2
  8. package/{preview-1655177322725.js → preview-1655522887639.js} +2 -2
  9. package/package-tar/teambit-harmony.content.cli-reference-1.95.29.tgz +0 -0
package/cli-reference.mdx CHANGED
@@ -27,7 +27,7 @@ all flags support glob patterns and {PARENT} {FILE_NAME} annotations
27
27
  ## app
28
28
 
29
29
  **Workspace only**: yes
30
- **Description**: manage applications
30
+ **Description**: Manages apps
31
31
 
32
32
  `bit app <sub-command>`
33
33
 
@@ -35,7 +35,7 @@ all flags support glob patterns and {PARENT} {FILE_NAME} annotations
35
35
 
36
36
  **Usage**: `app list`
37
37
 
38
- **Description**: list all registered applications
38
+ **Description**: list all registered apps
39
39
 
40
40
  | **Option** | **Option alias** | **Description** |
41
41
  | ---------- | :--------------: | ---------------------------------------- |
@@ -74,9 +74,10 @@ and a package.tgz file generated by pkg aspect.
74
74
  **Usage**: `aspect list [pattern]`
75
75
 
76
76
  **Description**: list all aspects configured on component(s)
77
- you can use a `<pattern>` for multiple component ids, such as `bit aspect list "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
77
+ you can use a `<pattern>` for multiple component ids, such as `bit aspect list "org.scope/utils/**"`.
78
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
78
79
  always wrap the pattern with quotes to avoid collision with shell commands.
79
- to validate the pattern before running this command, run `bit pattern <pattern>`.
80
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
80
81
 
81
82
  | **Option** | **Option alias** | **Description** |
82
83
  | ---------- | :--------------: | ------------------------------------------------- |
@@ -100,18 +101,20 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
100
101
  **Description**: set an aspect to component(s) with optional config.
101
102
  enter the config as stringified JSON (e.g. '{"foo":"bar"}' ).
102
103
  if no config entered, the aspect will be set with empty config ({}).
103
- you can use a `<pattern>` for multiple component ids, such as `bit aspect set "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
104
+ you can use a `<pattern>` for multiple component ids, such as `bit aspect set "org.scope/utils/**"`.
105
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
104
106
  always wrap the pattern with quotes to avoid collision with shell commands.
105
- to validate the pattern before running this command, run `bit pattern <pattern>`.
107
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
106
108
 
107
109
  ### aspect unset
108
110
 
109
111
  **Usage**: `aspect unset <pattern> <aspect-id>`
110
112
 
111
113
  **Description**: unset an aspect from component(s).
112
- you can use a `<pattern>` for multiple component ids, such as `bit aspect unset "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
114
+ you can use a `<pattern>` for multiple component ids, such as `bit aspect unset "org.scope/utils/**"`.
115
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
113
116
  always wrap the pattern with quotes to avoid collision with shell commands.
114
- to validate the pattern before running this command, run `bit pattern <pattern>`.
117
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
115
118
 
116
119
  ### aspect update
117
120
 
@@ -119,9 +122,10 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
119
122
 
120
123
  **Description**: update a version of an aspect
121
124
  default to all components using the aspect, unless "pattern" is provided.
122
- you can use a `<pattern>` for multiple component ids, such as `bit aspect update <aspect-id> "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
125
+ you can use a `<pattern>` for multiple component ids, such as `bit aspect update <aspect-id> "org.scope/utils/**"`.
126
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
123
127
  always wrap the pattern with quotes to avoid collision with shell commands.
124
- to validate the pattern before running this command, run `bit pattern <pattern>`.
128
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
125
129
 
126
130
  examples:
127
131
  "bit aspect update scope.org/aspect '**/ui/**'" - update "ui" components that use scope.org/aspect to the latest version
@@ -134,7 +138,7 @@ examples:
134
138
  **Workspace only**: yes
135
139
  **Description**: run set of tasks for build
136
140
 
137
- `bit build [pattern]`
141
+ `bit build [component-pattern]`
138
142
 
139
143
  | **Option** | **Option alias** | **Description** |
140
144
  | ----------------------------------------------------------------------------------------------------------- | :--------------: | ----------------------------------------------------------------------------------------------- |
@@ -206,7 +210,7 @@ with no args, only workspace's capsules are deleted
206
210
  **Workspace only**: yes
207
211
  **Description**: check typescript types
208
212
 
209
- `bit check-types [pattern]`
213
+ `bit check-types [component-pattern]`
210
214
 
211
215
  | **Option** | **Option alias** | **Description** |
212
216
  | ---------- | :--------------: | --------------------------------------------------------- |
@@ -289,9 +293,9 @@ The following gets removed by this command:
289
293
  ## compile
290
294
 
291
295
  **Workspace only**: yes
292
- **Description**: compile components in the development workspace
296
+ **Description**: compile components in the workspace
293
297
 
294
- `bit compile [component...]`
298
+ `bit compile [component-names...]`
295
299
 
296
300
  | **Option** | **Option alias** | **Description** |
297
301
  | ------------------- | :--------------: | ------------------------------------------------------------- |
@@ -361,9 +365,9 @@ https://bit.dev/docs/config/bit-config
361
365
  ## create
362
366
 
363
367
  **Workspace only**: yes
364
- **Description**: create a new component from a template
368
+ **Description**: create a new component (source files and config) using a template.
365
369
 
366
- `bit create <templateName> <componentNames...>`
370
+ `bit create <template-name> <component-names...>`
367
371
 
368
372
  | **Option** | **Option alias** | **Description** |
369
373
  | ---------------------- | :--------------: | ----------------------------------------------------------------------------------- |
@@ -450,9 +454,10 @@ bit diff => compare all modified components to their model version
450
454
  **Alias**: `E`
451
455
  **Workspace only**: yes
452
456
  **Description**: replaces the components from the local scope with the corresponding packages
453
- you can use a `<pattern>` for multiple component ids, such as `bit eject "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
457
+ you can use a `<pattern>` for multiple component ids, such as `bit eject "org.scope/utils/**"`.
458
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
454
459
  always wrap the pattern with quotes to avoid collision with shell commands.
455
- to validate the pattern before running this command, run `bit pattern <pattern>`.
460
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
456
461
 
457
462
  `bit eject <pattern>`
458
463
 
@@ -468,9 +473,10 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
468
473
 
469
474
  **Workspace only**: yes
470
475
  **Description**: eject components configuration (create a `component.json` file)
471
- you can use a `<pattern>` for multiple component ids, such as `bit eject-conf "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
476
+ you can use a `<pattern>` for multiple component ids, such as `bit eject-conf "org.scope/utils/**"`.
477
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
472
478
  always wrap the pattern with quotes to avoid collision with shell commands.
473
- to validate the pattern before running this command, run `bit pattern <pattern>`.
479
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
474
480
 
475
481
  `bit eject-conf <pattern>`
476
482
 
@@ -485,7 +491,7 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
485
491
 
486
492
  **Alias**: `env`
487
493
  **Workspace only**: yes
488
- **Description**: list all components envs
494
+ **Description**: list all components maintained by the workspace and their corresponding envs
489
495
 
490
496
  `bit envs`
491
497
 
@@ -497,34 +503,32 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
497
503
 
498
504
  ### envs get
499
505
 
500
- **Usage**: `envs get <name>`
506
+ **Usage**: `envs get <component-name>`
501
507
 
502
- **Description**: show component's env details
508
+ **Description**: show information about a component's env
503
509
 
504
510
  ### envs set
505
511
 
506
- **Usage**: `envs set <pattern> <env>`
512
+ **Usage**: `envs set <component-pattern> <env>`
507
513
 
508
- **Description**: set an environment for component(s)
509
- you can use a `<pattern>` for multiple component ids, such as `bit env set "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
510
- always wrap the pattern with quotes to avoid collision with shell commands.
511
- to validate the pattern before running this command, run `bit pattern <pattern>`.
514
+ **Description**: Sets one or more components with a development environment (env)
512
515
 
513
516
  ### envs unset
514
517
 
515
- **Usage**: `envs unset <pattern>`
518
+ **Usage**: `envs unset <component-pattern>`
516
519
 
517
- **Description**: unset an environment from component(s) that was set by "bit env set"
520
+ **Description**: un-sets an env from components that were previously set by "bit env set" or by a component template
518
521
  keep in mind that this doesn't remove envs that are set in the variants.
519
522
  in only removes envs that appear in the .bitmap file, which were previously configured via "bit env set".
520
523
  the purpose of this command is to remove the specific settings and let the the variants in workspace.jsonc to control the env.
521
- you can use a `<pattern>` for multiple component ids, such as `bit env unset "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
524
+ you can use a `<pattern>` for multiple component ids, such as `bit env unset "org.scope/utils/**"`.
525
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
522
526
  always wrap the pattern with quotes to avoid collision with shell commands.
523
- to validate the pattern before running this command, run `bit pattern <pattern>`.
527
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
524
528
 
525
529
  ### envs replace
526
530
 
527
- **Usage**: `envs replace <old-env> <new-env>`
531
+ **Usage**: `envs replace <current-env> <new-env>`
528
532
 
529
533
  **Description**: replace an existing env with another env for all components using the old env
530
534
 
@@ -534,19 +538,19 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
534
538
 
535
539
  **Alias**: `e`
536
540
  **Workspace only**: yes
537
- **Description**: Export components to a remote scope
541
+ **Description**: export components from the workspace to remote scopes
538
542
  bit export => export all staged components to their current scope, if checked out to a lane, export the lane as well
539
543
  `bit export [id...]` => export the given ids to their current scope
540
544
 
541
545
  https://bit.dev/docs/components/exporting-components
542
546
  you can use a pattern for multiple ids, such as bit export remote-scope "utils/\*". (wrap the pattern with quotes to avoid collision with shell commands)
543
547
 
544
- `bit export [remote] [id...]`
548
+ `bit export [remote] [component-names...]`
545
549
 
546
550
  | **Option** | **Option alias** | **Description** |
547
551
  | ---------------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------------------------------- |
548
- | `--eject` | `-e` | replaces the exported components from the local scope with the corresponding packages |
549
- | `--all` | `-a` | export all components include non-staged |
552
+ | `--eject` | `-e` | replace the exported components with their corresponding packages (to use these components without further maintaining them) |
553
+ | `--all` | `-a` | export all components, including non-staged |
550
554
  | `--include-dependencies` | `-d` | LEGACY ONLY. include the component's dependencies as part of the export to the remote scope |
551
555
  | `--set-current-scope` | `-s` | LEGACY ONLY. ensure the component's remote scope is set according to the target location |
552
556
  | `--rewire` | `-r` | LEGACY ONLY. when exporting to a different or new scope, replace import/require statements in the source code to match the new scope |
@@ -562,17 +566,15 @@ you can use a pattern for multiple ids, such as bit export remote-scope "utils/\
562
566
  ## fork
563
567
 
564
568
  **Workspace only**: no
565
- **Description**: EXPERIMENTAL. create a new component out of an existing one
566
- note that [target-name] is the name only without the scope.
567
- to set the default-scope, please use --scope flag
569
+ **Description**: EXPERIMENTAL. create a new component out of an existing one (copies source files and config)
568
570
 
569
- `bit fork <source-id> [target-name]`
571
+ `bit fork <source-component-id> [target-component-name]`
570
572
 
571
- | **Option** | **Option alias** | **Description** |
572
- | ------------------ | :--------------: | ----------------------------------------------------------------------------------------------- |
573
- | `--scope <string>` | `-s` | default scope for the newly created component |
574
- | `--path <string>` | `-p` | relative path in the workspace. by default the path is `<scope>/<namespace>/<name>` |
575
- | `--refactor` | `-r` | change the source code of all components using the original component with the new package-name |
573
+ | **Option** | **Option alias** | **Description** |
574
+ | ------------------ | :--------------: | --------------------------------------------------------------------------------------------------------- |
575
+ | `--scope <string>` | `-s` | default scope for the new component |
576
+ | `--path <string>` | `-p` | relative path in the workspace for the new component. by default the path is `<scope>/<namespace>/<name>` |
577
+ | `--refactor` | `-r` | update the import/require statements in all dependent components (in the same workspace) |
576
578
 
577
579
  ---
578
580
 
@@ -633,28 +635,28 @@ to set the default-scope, please use --scope flag
633
635
  ## import
634
636
 
635
637
  **Workspace only**: yes
636
- **Description**: import components into your workspace
638
+ **Description**: import components from remote scopes to the local workspace
637
639
  https://bit.dev/docs/components/importing-components
638
640
  you can use a pattern for multiple ids, such as bit import "utils/\*". (wrap the pattern with quotes to avoid collision with shell commands)
639
641
 
640
- `bit import [ids...]`
642
+ `bit import [component-ids...]`
641
643
 
642
- | **Option** | **Option alias** | **Description** |
643
- | -------------------------------- | :--------------: | ----------------------------------------------------------------------------------------------------------------------------------- |
644
- | `--path <path>` | `-p` | import components into a specific directory |
645
- | `--objects` | `-o` | import components objects only, don't write the components to the file system. This is a default behavior for import with no id |
646
- | `--display-dependencies` | `-d` | display the imported dependencies |
647
- | `--override` | `-O` | override local changes |
648
- | `--verbose` | `-v` | showing verbose output for inspection |
649
- | `--json` | `-j` | return the output as JSON |
650
- | `--conf` | | write the configuration file (component.json) of the component (harmony components only) |
651
- | `--skip-npm-install` | | DEPRECATED. use "--skip-dependency-installation" instead |
652
- | `--skip-dependency-installation` | | do not install packages of the imported components |
653
- | `--merge [strategy]` | `-m` | merge local changes with the imported version. strategy should be "theirs", "ours" or "manual" |
654
- | `--dependencies` | | EXPERIMENTAL. import all dependencies and write them to the workspace |
655
- | `--dependents` | | EXPERIMENTAL. import component dependents to allow auto-tag updating them upon tag |
656
- | `--save-in-lane` | | EXPERIMENTAL. when checked out to a lane and the component is not on the remote-lane, save it in the lane (default to save on main) |
657
- | `--all-history` | | relevant for fetching all components objects. avoid optimizations, fetch all history versions, always |
644
+ | **Option** | **Option alias** | **Description** |
645
+ | -------------------------------- | :--------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
646
+ | `--path <path>` | `-p` | import components into a specific directory (a relative path in the workspace) |
647
+ | `--objects` | `-o` | import components objects to the local scope without checkout (without writing them to the file system). This is a default behavior for import with no id argument |
648
+ | `--display-dependencies` | `-d` | display the imported dependencies |
649
+ | `--override` | `-O` | override local changes |
650
+ | `--verbose` | `-v` | show verbose output for inspection |
651
+ | `--json` | `-j` | return the output as JSON |
652
+ | `--conf` | | write the configuration file (component.json) of the component |
653
+ | `--skip-npm-install` | | DEPRECATED. use "--skip-dependency-installation" instead |
654
+ | `--skip-dependency-installation` | | do not install packages of the imported components |
655
+ | `--merge [strategy]` | `-m` | merge local changes with the imported version. strategy should be "theirs", "ours" or "manual" |
656
+ | `--dependencies` | | EXPERIMENTAL. import all dependencies and write them to the workspace |
657
+ | `--dependents` | | EXPERIMENTAL. import component dependents to allow auto-tag updating them upon tag |
658
+ | `--save-in-lane` | | EXPERIMENTAL. when checked out to a lane and the component is not on the remote-lane, save it in the lane (default to save on main) |
659
+ | `--all-history` | | relevant for fetching all components objects. avoid optimizations, fetch all history versions, always |
658
660
 
659
661
  ---
660
662
 
@@ -686,7 +688,8 @@ https://bit.dev/docs/workspace/creating-workspaces#initialize-a-workspace-on-an-
686
688
 
687
689
  **Alias**: `in`
688
690
  **Workspace only**: yes
689
- **Description**: install development workspace dependencies
691
+ **Description**: installs workspace dependencies
692
+ when no package is specified, all workspace dependencies are installed and all workspace components are imported.
690
693
 
691
694
  `bit install [packages...]`
692
695
 
@@ -749,8 +752,6 @@ https://bit.dev/docs/reference/cli-reference#list
749
752
  | ---------------------- | :--------------: | ------------------------------------------------------------------------------- |
750
753
  | `--ids` | `-i` | show only component ids unformatted |
751
754
  | `--scope` | `-s` | show only components stored in the local scope, including indirect dependencies |
752
- | `--bare` | `-b` | DEPRECATED. use --raw instead |
753
- | `--raw` | `-r` | show raw output (only components ids, no styling) |
754
755
  | `--outdated` | `-o` | show latest versions from remotes |
755
756
  | `--json` | `-j` | show the output in JSON format |
756
757
  | `--namespace <string>` | `-n` | show only specified namespace by using wildcards |
@@ -842,18 +843,18 @@ move files or directories of component(s)
842
843
  ## new
843
844
 
844
845
  **Workspace only**: yes
845
- **Description**: Create a new workspace from a template
846
+ **Description**: create a new workspace from a template
846
847
 
847
- `bit new <templateName> <workspaceName>`
848
+ `bit new <template-name> <workspace-name>`
848
849
 
849
- | **Option** | **Option alias** | **Description** |
850
- | -------------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------- |
851
- | `--aspect <string>` | `-a` | aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision |
852
- | `--default-scope <string>` | `-d` | set defaultScope in the new workspace.jsonc |
853
- | `--standalone` | | DEPRECATED. use --skip-git instead |
854
- | `--skip-git` | `-s` | skip generation of Git repository |
855
- | `--empty` | `-e` | empty workspace with no components (relevant for templates that add components by default) |
856
- | `--load-from <string>` | | path to the workspace containing the template. helpful during a development of a workspace-template |
850
+ | **Option** | **Option alias** | **Description** |
851
+ | -------------------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------- |
852
+ | `--aspect <aspect-id>` | `-a` | aspect-id of the template. mandatory for non-core aspects. helpful for core aspects in case of a name collision |
853
+ | `--default-scope <scope-name>` | `-d` | set defaultScope in the new workspace.jsonc |
854
+ | `--standalone` | | DEPRECATED. use --skip-git instead |
855
+ | `--skip-git` | `-s` | skip generation of Git repository |
856
+ | `--empty` | `-e` | empty workspace with no components (relevant for templates that add components by default) |
857
+ | `--load-from <path-to-template>` | | path to the workspace containing the template. helpful during a development of a workspace-template |
857
858
 
858
859
  ---
859
860
 
@@ -877,7 +878,14 @@ move files or directories of component(s)
877
878
  ## pattern
878
879
 
879
880
  **Workspace only**: yes
880
- **Description**: list the component ids matching the given pattern
881
+ **Description**: list the component ids matching the given pattern
882
+ this command helps validating a pattern before using it in other commands.
883
+ a pattern can be a simple component-id or component-name. e.g. "ui/button".
884
+ a pattern can be used with wildcards for multiple component ids, e.g. "org.scope/utils/**".
885
+ to enter multiple patterns, separate them by a comma, e.g. "ui/_, lib/_"
886
+ to exclude, use "!". e.g. "ui/**, !ui/button"
887
+ always wrap the pattern with quotes to avoid collision with shell commands.
888
+ the matching algorithm is done by multimatch (@see https://github.com/sindresorhus/multimatch)
881
889
 
882
890
  `bit pattern <pattern>`
883
891
 
@@ -981,9 +989,9 @@ to assign a default-scope to this component, please use "--scope" flag
981
989
 
982
990
  **Alias**: `c`
983
991
  **Workspace only**: yes
984
- **Description**: run an application
992
+ **Description**: run an app (independent of bit's dev server)
985
993
 
986
- `bit run <app>`
994
+ `bit run <app-name>`
987
995
 
988
996
  | **Option** | **Option alias** | **Description** |
989
997
  | -------------- | :--------------: | -------------------------------------------------------------------------- |
@@ -997,9 +1005,10 @@ to assign a default-scope to this component, please use "--scope" flag
997
1005
 
998
1006
  **Workspace only**: yes
999
1007
  **Description**: shows the API schema of a certain component.
1000
- you can use a `<pattern>` for multiple component ids, such as `bit schema "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
1008
+ you can use a `<pattern>` for multiple component ids, such as `bit schema "org.scope/utils/**"`.
1009
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
1001
1010
  always wrap the pattern with quotes to avoid collision with shell commands.
1002
- to validate the pattern before running this command, run `bit pattern <pattern>`.
1011
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
1003
1012
 
1004
1013
  `bit schema <pattern>`
1005
1014
 
@@ -1012,27 +1021,27 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
1012
1021
  ## scope
1013
1022
 
1014
1023
  **Workspace only**: yes
1015
- **Description**: EXPERIMENTAL. manage scope-name
1024
+ **Description**: EXPERIMENTAL. manage the scope-name for components
1016
1025
 
1017
1026
  `bit scope <sub-command>`
1018
1027
 
1019
1028
  ### scope set
1020
1029
 
1021
- **Usage**: `scope set <scope-name> [pattern]`
1030
+ **Usage**: `scope set <scope-name> [component-pattern]`
1022
1031
 
1023
- **Description**: set the default-scope
1024
- set a new scope in the workspace.jsonc.
1025
- if "pattern" is provided, the default-scope will be set to the new components matching the criteria.
1032
+ **Description**: Sets components with a default-scope. If no component is specified, sets the workspace with a default scope
1033
+ default scopes for components are set in the bitmap file. the default scope for a workspace is set in the workspace.jsonc. a component is set with a scope (as oppose to default scope) only once it is versioned.'
1026
1034
 
1027
- you can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
1035
+ you can use a `<pattern>` for multiple component ids, such as `bit scope set scope-name "org.scope/utils/**"`.
1036
+ use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
1028
1037
  always wrap the pattern with quotes to avoid collision with shell commands.
1029
- to validate the pattern before running this command, run `bit pattern <pattern>`.
1038
+ use `bit pattern --help` to understand patterns better and `bit pattern <pattern>` to validate the pattern.
1030
1039
 
1031
1040
  ### scope rename
1032
1041
 
1033
- **Usage**: `scope rename <old-name> <new-name>`
1042
+ **Usage**: `scope rename <current-scope-name> <new-scope-name>`
1034
1043
 
1035
- **Description**: rename a scope for components using the old-name, optionally change the dependencies source-code
1044
+ **Description**: Renames the scope name for all components with the specified 'current scope name'
1036
1045
 
1037
1046
  | **Option** | **Option alias** | **Description** |
1038
1047
  | ------------ | :--------------: | ---------------------------------------------------------------------------------------------- |
@@ -1082,16 +1091,16 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
1082
1091
  ## show
1083
1092
 
1084
1093
  **Workspace only**: yes
1085
- **Description**: show a component
1094
+ **Description**: display the component's essential information
1086
1095
 
1087
- `bit show <id>`
1096
+ `bit show <component-name>`
1088
1097
 
1089
- | **Option** | **Option alias** | **Description** |
1090
- | ----------- | :--------------: | -------------------------------------------------------------------------------------------------------- |
1091
- | `--json` | `-j` | return the component data in json format |
1092
- | `--legacy` | `-l` | use the legacy bit show. |
1093
- | `--remote` | `-r` | show a remote component |
1094
- | `--compare` | `-c` | compare current file system component to latest tagged component [default=latest]. only works in legacy. |
1098
+ | **Option** | **Option alias** | **Description** |
1099
+ | ----------- | :--------------: | ------------------------------------------------------------------------------------------------------------ |
1100
+ | `--json` | `-j` | return the component data in a json format |
1101
+ | `--legacy` | `-l` | use the legacy bit show. |
1102
+ | `--remote` | `-r` | show a remote component |
1103
+ | `--compare` | `-c` | compare current file system component to the latest tagged component [default=latest]. only works in legacy. |
1095
1104
 
1096
1105
  ---
1097
1106
 
@@ -1099,18 +1108,18 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
1099
1108
 
1100
1109
  **Alias**: `c`
1101
1110
  **Workspace only**: yes
1102
- **Description**: Start a dev environment for a workspace or a specific component
1111
+ **Description**: run the ui/development server
1103
1112
 
1104
1113
  `bit start [type] [pattern]`
1105
1114
 
1106
- | **Option** | **Option alias** | **Description** |
1107
- | -------------------- | :--------------: | ------------------------------------------------------------ |
1108
- | `--dev` | `-d` | start UI server in dev mode. |
1109
- | `--port [number]` | `-p` | port of the UI server. |
1110
- | `--rebuild` | `-r` | rebuild the UI |
1111
- | `--verbose` | `-v` | showing verbose output for inspection and prints stack trace |
1112
- | `--no-browser` | | do not automatically open browser when ready |
1113
- | `--skip-compilation` | | skip the auto-compilation before starting the web-server |
1115
+ | **Option** | **Option alias** | **Description** |
1116
+ | ---------------------- | :--------------: | --------------------------------------------------------- |
1117
+ | `--dev` | `-d` | start UI server in dev mode. |
1118
+ | `--port [port-number]` | `-p` | port of the UI server. |
1119
+ | `--rebuild` | `-r` | rebuild the UI |
1120
+ | `--verbose` | `-v` | show verbose output for inspection and prints stack trace |
1121
+ | `--no-browser` | | do not automatically open browser when ready |
1122
+ | `--skip-compilation` | | skip the auto-compilation before starting the web-server |
1114
1123
 
1115
1124
  ---
1116
1125
 
@@ -1118,8 +1127,7 @@ to validate the pattern before running this command, run `bit pattern <pattern>`
1118
1127
 
1119
1128
  **Alias**: `s`
1120
1129
  **Workspace only**: yes
1121
- **Description**: show the working area component(s) status
1122
- https://bit.dev/docs/workspace/workspace-status
1130
+ **Description**: present the current status of components in the workspace, and notifies when issues are detected
1123
1131
 
1124
1132
  `bit status`
1125
1133
 
@@ -1134,35 +1142,34 @@ https://bit.dev/docs/workspace/workspace-status
1134
1142
 
1135
1143
  **Alias**: `t`
1136
1144
  **Workspace only**: yes
1137
- **Description**: record component changes and lock versions
1138
- if no ids are provided, it will tag all new and modified components.
1139
- if component ids are entered, you can specify a version per id using "@" sign, e.g. bit tag foo@1.0.0 bar@minor baz@major
1140
- https://bit.dev/components/tags
1141
- you can use a pattern for multiple ids, such as bit tag "utils/\*". (wrap the pattern with quotes to avoid collision with shell commands)
1142
-
1143
- `bit tag [id...]`
1144
-
1145
- | **Option** | **Option alias** | **Description** |
1146
- | ---------------------------- | :--------------: | ----------------------------------------------------------------------------------------------------------------------- |
1147
- | `--message <message>` | `-m` | log message describing the user changes |
1148
- | `--unmodified` | | include unmodified components (by default, only new and modified components are tagged) |
1149
- | `--editor [editor]` | | EXPERIMENTAL. open an editor to edit the tag messages per component, optionally specify the editor-name, default to vim |
1150
- | `--ver <version>` | `-v` | tag with the given version |
1151
- | `--increment <level>` | `-l` | options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch |
1152
- | `--prerelease-id <id>` | | prerelease identifier (e.g. "dev" to get "1.0.0-dev.1") |
1153
- | `--patch` | `-p` | syntactic sugar for "--increment patch" |
1154
- | `--minor` | | syntactic sugar for "--increment minor" |
1155
- | `--major` | | syntactic sugar for "--increment major" |
1156
- | `--snapped` | | EXPERIMENTAL. tag components that their head is a snap (not a tag) |
1157
- | `--pre-release [identifier]` | | DEPRECATED. use "-l prerelease" (and --prerelease-id) instead |
1158
- | `--skip-tests` | | skip running component tests during tag process |
1159
- | `--skip-auto-tag` | | skip auto tagging dependents |
1160
- | `--soft` | | do not persist. only keep note of the changes to be made |
1161
- | `--persist` | | persist the changes generated by --soft tag |
1162
- | `--disable-tag-pipeline` | | skip the tag pipeline to avoid publishing the components |
1163
- | `--force-deploy` | | run the tag pipeline although the build failed |
1164
- | `--increment-by <number>` | | (default to 1) increment semver flag (patch/minor/major) by. e.g. incrementing patch by 2: 0.0.1 -> 0.0.3. |
1165
- | `--ignore-issues [issues]` | `-i` | ignore component issues (shown in "bit status" as "issues found"), issues to ignore: |
1145
+ **Description**: create an immutable and exportable component snapshot, tagged with a release version.
1146
+ if no patterns are provided, it will tag all new and modified components.
1147
+ if patterns are entered, you can specify a version per pattern using "@" sign, e.g. bit tag foo@1.0.0 bar@minor baz@major
1148
+ https://bit.dev/components/tags
1149
+
1150
+ `bit tag [patterns...]`
1151
+
1152
+ | **Option** | **Option alias** | **Description** |
1153
+ | ---------------------------- | :--------------: | ------------------------------------------------------------------------------------------------------------------------------ |
1154
+ | `--message <message>` | `-m` | a log message describing latest changes |
1155
+ | `--unmodified` | | include unmodified components (by default, only new and modified components are tagged) |
1156
+ | `--editor [editor]` | | EXPERIMENTAL. open an editor to write a tag message for each component. optionally, specify the editor-name (defaults to vim). |
1157
+ | `--ver <version>` | `-v` | tag with the given version |
1158
+ | `--increment <level>` | `-l` | options are: [major, premajor, minor, preminor, patch, prepatch, prerelease], default to patch |
1159
+ | `--prerelease-id <id>` | | prerelease identifier (e.g. "dev" to get "1.0.0-dev.1") |
1160
+ | `--patch` | `-p` | syntactic sugar for "--increment patch" |
1161
+ | `--minor` | | syntactic sugar for "--increment minor" |
1162
+ | `--major` | | syntactic sugar for "--increment major" |
1163
+ | `--snapped` | | EXPERIMENTAL. tag components that their head is a snap (not a tag) |
1164
+ | `--pre-release [identifier]` | | DEPRECATED. use "-l prerelease" (and --prerelease-id) instead |
1165
+ | `--skip-tests` | | skip running component tests during tag process |
1166
+ | `--skip-auto-tag` | | skip auto tagging dependents |
1167
+ | `--soft` | | do not persist. only keep note of the changes to be made |
1168
+ | `--persist` | | persist the changes generated by --soft tag |
1169
+ | `--disable-tag-pipeline` | | skip the tag pipeline to avoid publishing the components |
1170
+ | `--force-deploy` | | run the tag pipeline although the build failed |
1171
+ | `--increment-by <number>` | | (default to 1) increment semver flag (patch/minor/major) by. e.g. incrementing patch by 2: 0.0.1 -> 0.0.3. |
1172
+ | `--ignore-issues [issues]` | `-i` | ignore component issues (shown in "bit status" as "issues found"), issues to ignore: |
1166
1173
 
1167
1174
  [MissingPackagesDependenciesOnFs, MissingComponents, UntrackedDependencies, ResolveErrors, RelativeComponents, RelativeComponentsAuthored, ParseErrors, MissingLinks, MissingDists, LegacyInsideHarmony, MissingDependenciesOnFs, MissingCustomModuleResolutionLinks, ImportNonMainFiles, CustomModuleResolutionUsed, MultipleEnvs, MissingLinksFromNodeModulesToSrc, CircularDependencies]
1168
1175
  to ignore multiple issues, separate them by a comma and wrap with quotes. to ignore all issues, specify "\*".|
@@ -1193,19 +1200,19 @@ list components templates when inside bit-workspace (for bit-create), otherwise,
1193
1200
 
1194
1201
  **Alias**: `at`
1195
1202
  **Workspace only**: yes
1196
- **Description**: test set of components in your workspace
1203
+ **Description**: test components in the workspace
1197
1204
 
1198
- `bit test [pattern]`
1205
+ `bit test [component-pattern]`
1199
1206
 
1200
- | **Option** | **Option alias** | **Description** |
1201
- | -------------------- | :--------------: | -------------------------------------------------------------------- |
1202
- | `--watch` | `-w` | start the tester in watch mode. |
1203
- | `--debug` | `-d` | start the tester in debug mode. |
1204
- | `--all` | `-a` | test all components, not only new and modified |
1205
- | `--junit <filepath>` | | write tests results as JUnit XML format into the specified file path |
1206
- | `--coverage` | | show code coverage data |
1207
- | `--env <id>` | `-e` | test only the given env |
1208
- | `--scope <scope>` | `-s` | name of the scope to test |
1207
+ | **Option** | **Option alias** | **Description** |
1208
+ | ---------------------- | :--------------: | --------------------------------------------------------------------------------------- |
1209
+ | `--watch` | `-w` | start the tester in watch mode. |
1210
+ | `--debug` | `-d` | start the tester in debug mode. |
1211
+ | `--all` | `-a` | test all components, not only new and modified |
1212
+ | `--junit <filepath>` | | write tests results as JUnit XML format into the specified file path |
1213
+ | `--coverage` | | show code coverage data |
1214
+ | `--env <id>` | `-e` | test only the given env |
1215
+ | `--scope <scope-name>` | `-s` | DEPRECATED. (use the pattern instead, e.g. "scopeName/\*\*"). name of the scope to test |
1209
1216
 
1210
1217
  ---
1211
1218
 
@@ -1272,9 +1279,9 @@ you can use a pattern for multiple ids, such as bit untag "utils/\*". (wrap the
1272
1279
  ## use
1273
1280
 
1274
1281
  **Workspace only**: yes
1275
- **Description**: set up aspects in the workspace/scope config
1282
+ **Description**: set aspects in the workspace/scope config to make them loadable by the workspace/scope
1276
1283
 
1277
- `bit use [ids...]`
1284
+ `bit use [component-ids...]`
1278
1285
 
1279
1286
  ---
1280
1287