@teambit/harmony.content.cli-reference 1.95.18 → 1.95.21

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.
package/cli-reference.mdx CHANGED
@@ -553,6 +553,7 @@ you can use a pattern for multiple ids, such as bit export remote-scope "utils/\
553
553
  | `--origin-directly` | | HARMONY ONLY. avoid export to the central hub, instead, export directly to the original scopes. not recommended! |
554
554
  | `--resume <string>` | | in case the previous export failed and suggested to resume with an export-id, enter the id |
555
555
  | `--ignore-missing-artifacts` | | EXPERIMENTAL. don't throw an error when artifact files are missing. not recommended, unless you're sure the artifacts are in the remote |
556
+ | `--json` | `-j` | show output in json format |
556
557
 
557
558
  ---
558
559
 
@@ -947,7 +948,8 @@ Legacy support [file, ssh]. Harmony supports [file, http].
947
948
  | ---------------- | :--------------: | ---------------------------------------------------------------------------------------------------------------------------------- |
948
949
  | `--remote` | `-r` | remove a component from a remote scope |
949
950
  | `--track` | `-t` | keep tracking component (default = false) |
950
- | `--delete-files` | `-d` | delete local component files (authored components only. for imported components the files are always deleted) |
951
+ | `--delete-files` | `-d` | DEPRECATED (this is now the default). delete local component files |
952
+ | `--keep-files` | | keep component files (just untrack the component) |
951
953
  | `--force` | `-f` | removes the component from the scope, even if used as a dependency. WARNING: components that depend on this component will corrupt |
952
954
  | `--silent` | `-s` | skip confirmation |
953
955
 
@@ -1017,6 +1019,15 @@ alternatively, exporting to any one of the failed scopes, throws server-is-busy
1017
1019
 
1018
1020
  `bit scope <sub-command>`
1019
1021
 
1022
+ ### scope set
1023
+
1024
+ **Usage**: `scope set <pattern> <scope-name>`
1025
+
1026
+ **Description**: set a scope name for component(s)
1027
+ you can use a `<pattern>` for multiple component ids, such as `bit scope set "org.scope/utils/**"`. use comma to separate patterns and "!" to exclude. e.g. "ui/\*\*, !ui/button"
1028
+ 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>`.
1030
+
1020
1031
  ### scope rename
1021
1032
 
1022
1033
  **Usage**: `scope rename <old-name> <new-name>`
@@ -2230,7 +2230,22 @@ function MDXContent(_ref) {
2230
2230
  }), (0, _react2.mdx)("td", {
2231
2231
  parentName: "tr",
2232
2232
  "align": null
2233
- }, "EXPERIMENTAL. don't throw an error when artifact files are missing. not recommended, unless you're sure the artifacts are in the remote")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "fork"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
2233
+ }, "EXPERIMENTAL. don't throw an error when artifact files are missing. not recommended, unless you're sure the artifacts are in the remote")), (0, _react2.mdx)("tr", {
2234
+ parentName: "tbody"
2235
+ }, (0, _react2.mdx)("td", {
2236
+ parentName: "tr",
2237
+ "align": null
2238
+ }, (0, _react2.mdx)("inlineCode", {
2239
+ parentName: "td"
2240
+ }, "--json")), (0, _react2.mdx)("td", {
2241
+ parentName: "tr",
2242
+ "align": "center"
2243
+ }, (0, _react2.mdx)("inlineCode", {
2244
+ parentName: "td"
2245
+ }, "-j")), (0, _react2.mdx)("td", {
2246
+ parentName: "tr",
2247
+ "align": null
2248
+ }, "show output in json format")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "fork"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
2234
2249
  parentName: "p"
2235
2250
  }, "Workspace only"), ": no", (0, _react2.mdx)("br", {
2236
2251
  parentName: "p"
@@ -4295,7 +4310,20 @@ function MDXContent(_ref) {
4295
4310
  }, "-d")), (0, _react2.mdx)("td", {
4296
4311
  parentName: "tr",
4297
4312
  "align": null
4298
- }, "delete local component files (authored components only. for imported components the files are always deleted)")), (0, _react2.mdx)("tr", {
4313
+ }, "DEPRECATED (this is now the default). delete local component files")), (0, _react2.mdx)("tr", {
4314
+ parentName: "tbody"
4315
+ }, (0, _react2.mdx)("td", {
4316
+ parentName: "tr",
4317
+ "align": null
4318
+ }, (0, _react2.mdx)("inlineCode", {
4319
+ parentName: "td"
4320
+ }, "--keep-files")), (0, _react2.mdx)("td", {
4321
+ parentName: "tr",
4322
+ "align": "center"
4323
+ }), (0, _react2.mdx)("td", {
4324
+ parentName: "tr",
4325
+ "align": null
4326
+ }, "keep component files (just untrack the component)")), (0, _react2.mdx)("tr", {
4299
4327
  parentName: "tbody"
4300
4328
  }, (0, _react2.mdx)("td", {
4301
4329
  parentName: "tr",
@@ -4549,7 +4577,25 @@ function MDXContent(_ref) {
4549
4577
  parentName: "p"
4550
4578
  }, "Description"), ": EXPERIMENTAL. manage scope-name"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
4551
4579
  parentName: "p"
4552
- }, "bit scope <sub-command>")), (0, _react2.mdx)("h3", null, "scope rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
4580
+ }, "bit scope <sub-command>")), (0, _react2.mdx)("h3", null, "scope set"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
4581
+ parentName: "p"
4582
+ }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
4583
+ parentName: "p"
4584
+ }, "scope set <pattern> <scope-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
4585
+ parentName: "p"
4586
+ }, "Description"), ": set a scope name for component(s)", (0, _react2.mdx)("br", {
4587
+ parentName: "p"
4588
+ }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
4589
+ parentName: "p"
4590
+ }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
4591
+ parentName: "p"
4592
+ }, "bit scope set \"org.scope/utils/**\""), ". use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
4593
+ parentName: "p"
4594
+ }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
4595
+ parentName: "p"
4596
+ }), "\n", "to validate the pattern before running this command, run ", (0, _react2.mdx)("inlineCode", {
4597
+ parentName: "p"
4598
+ }, "bit pattern <pattern>"), "."), (0, _react2.mdx)("h3", null, "scope rename"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
4553
4599
  parentName: "p"
4554
4600
  }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
4555
4601
  parentName: "p"