@teambit/harmony.content.cli-reference 1.95.127 → 1.95.129

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 +21 -16
  2. package/cli-reference.mdx +168 -2
  3. package/dist/cli-reference.json +21 -16
  4. package/dist/cli-reference.mdx.js +874 -5
  5. package/dist/cli-reference.mdx.js.map +1 -1
  6. package/dist/{preview-1678505797420.js → preview-1678982624699.js} +2 -2
  7. package/package-tar/teambit-harmony.content.cli-reference-1.95.129.tgz +0 -0
  8. package/package.json +2 -2
  9. package/package-tar/teambit-harmony.content.cli-reference-1.95.127.tgz +0 -0
package/cli-reference.json CHANGED
@@ -489,6 +489,11 @@
489
489
  "name": "login",
490
490
  "alias": "",
491
491
  "options": [
492
+ [
493
+ "d",
494
+ "hub-domain-login <url>",
495
+ "hub domain login url (default https://bit.cloud)"
496
+ ],
492
497
  [
493
498
  "p",
494
499
  "port <port>",
@@ -1834,8 +1839,8 @@
1834
1839
  ],
1835
1840
  [
1836
1841
  "e",
1837
- "entire-lane",
1838
- "write also new components that were introduced on the remote lane and do not exist locally"
1842
+ "workspace-only",
1843
+ "when on a lane, avoid introducing new components from the remote lane that do not exist locally"
1839
1844
  ],
1840
1845
  [
1841
1846
  "v",
@@ -2642,8 +2647,8 @@
2642
2647
  ],
2643
2648
  "description": "manage lanes",
2644
2649
  "extendedDescription": "",
2645
- "group": "ungrouped",
2646
- "private": true,
2650
+ "group": "collaborate",
2651
+ "private": false,
2647
2652
  "remoteOp": true,
2648
2653
  "skipWorkspace": true,
2649
2654
  "commands": [
@@ -2680,7 +2685,7 @@
2680
2685
  "description": "list lanes",
2681
2686
  "extendedDescription": "",
2682
2687
  "group": "ungrouped",
2683
- "private": true,
2688
+ "private": false,
2684
2689
  "remoteOp": true,
2685
2690
  "skipWorkspace": true
2686
2691
  },
@@ -2737,7 +2742,7 @@
2737
2742
  "description": "show lane details. if no lane specified, show the current lane",
2738
2743
  "extendedDescription": "",
2739
2744
  "group": "ungrouped",
2740
- "private": true,
2745
+ "private": false,
2741
2746
  "remoteOp": true,
2742
2747
  "skipWorkspace": true
2743
2748
  },
@@ -2753,13 +2758,13 @@
2753
2758
  [
2754
2759
  "",
2755
2760
  "alias <name>",
2756
- "a local alias to refer to this lane, defaults to the <lane-name> (can be added later with \"bit lane alias\")"
2761
+ "a local alias to refer to this lane, defaults to the `<lane-name>` (can be added later with \"bit lane alias\")"
2757
2762
  ]
2758
2763
  ],
2759
2764
  "description": "creates a new lane and switches to it",
2760
2765
  "extendedDescription": "a lane created from main (default-lane) is empty until components are snapped.\na lane created from another lane has all the components of the original lane.",
2761
2766
  "group": "ungrouped",
2762
- "private": true,
2767
+ "private": false,
2763
2768
  "arguments": [
2764
2769
  {
2765
2770
  "name": "lane-name",
@@ -2805,7 +2810,7 @@
2805
2810
  "description": "changes the remote scope of a lane",
2806
2811
  "extendedDescription": "",
2807
2812
  "group": "ungrouped",
2808
- "private": true
2813
+ "private": false
2809
2814
  },
2810
2815
  {
2811
2816
  "name": "alias <lane-name> <alias>",
@@ -2814,7 +2819,7 @@
2814
2819
  "description": "adds an alias to a lane",
2815
2820
  "extendedDescription": "an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.\nit is useful when having multiple lanes with the same name, but with different remote scopes.",
2816
2821
  "group": "ungrouped",
2817
- "private": true
2822
+ "private": false
2818
2823
  },
2819
2824
  {
2820
2825
  "name": "rename <current-name> <new-name>",
@@ -2823,7 +2828,7 @@
2823
2828
  "description": "EXPERIMENTAL. change the lane-name locally and on the remote (if exported)",
2824
2829
  "extendedDescription": "",
2825
2830
  "group": "ungrouped",
2826
- "private": true
2831
+ "private": false
2827
2832
  },
2828
2833
  {
2829
2834
  "name": "diff [values...]",
@@ -2849,7 +2854,7 @@
2849
2854
  "description": "EXPERIMENTAL. adds a readme component to a lane",
2850
2855
  "extendedDescription": "",
2851
2856
  "group": "ungrouped",
2852
- "private": true,
2857
+ "private": false,
2853
2858
  "skipWorkspace": false,
2854
2859
  "arguments": [
2855
2860
  {
@@ -2869,7 +2874,7 @@
2869
2874
  "description": "EXPERIMENTAL. remove lane readme component",
2870
2875
  "extendedDescription": "",
2871
2876
  "group": "ungrouped",
2872
- "private": true,
2877
+ "private": false,
2873
2878
  "skipWorkspace": false
2874
2879
  },
2875
2880
  {
@@ -2885,7 +2890,7 @@
2885
2890
  "description": "import a remote lane to your workspace",
2886
2891
  "extendedDescription": "",
2887
2892
  "group": "ungrouped",
2888
- "private": true,
2893
+ "private": false,
2889
2894
  "arguments": [
2890
2895
  {
2891
2896
  "name": "lane",
@@ -3860,8 +3865,8 @@
3860
3865
  ],
3861
3866
  [
3862
3867
  "",
3863
- "rename",
3864
- "rename files and variables/classes according to the new component name"
3868
+ "preserve",
3869
+ "avoid renaming files and variables/classes according to the new component name"
3865
3870
  ],
3866
3871
  [
3867
3872
  "",
package/cli-reference.mdx CHANGED
@@ -240,7 +240,7 @@ with no args, only workspace's capsules are deleted
240
240
  | `--manual` | `-m` | in case of a conflict, leave the files with a conflict state to resolve them manually later |
241
241
  | `--reset` | `-r` | revert changes that were not snapped/tagged |
242
242
  | `--all` | `-a` | all components |
243
- | `--entire-lane` | `-e` | write also new components that were introduced on the remote lane and do not exist locally |
243
+ | `--workspace-only` | `-e` | when on a lane, avoid introducing new components from the remote lane that do not exist locally |
244
244
  | `--verbose` | `-v` | showing verbose output for inspection |
245
245
  | `--reset` | | DEPRECATED. run "bit checkout reset" instead |
246
246
  | `--skip-npm-install` | | DEPRECATED. use "--skip-dependency-installation" instead |
@@ -609,7 +609,7 @@ bit export => export all staged components to their current scope, if checked ou
609
609
  | `--refactor` | `-r` | update the import/require statements in all dependent components (in the same workspace) |
610
610
  | `--skip-dependency-installation` | `-x` | do not install packages of the imported components |
611
611
  | `--skip-config` | | do not copy the config (aspects-config) to the new component. helpful when it fails during aspect loading |
612
- | `--rename` | | rename files and variables/classes according to the new component name |
612
+ | `--preserve` | | avoid renaming files and variables/classes according to the new component name |
613
613
  | `--no-link` | | avoid saving a reference to the original component |
614
614
 
615
615
  ---
@@ -745,6 +745,171 @@ when no package is specified, all workspace dependencies are installed and all w
745
745
 
746
746
  ---
747
747
 
748
+ ## lane
749
+
750
+ **Description**: manage lanes
751
+
752
+ `bit lane [lane-name]`
753
+
754
+ ### lane list
755
+
756
+ **Usage**: `lane list`
757
+
758
+ **Description**: list lanes
759
+
760
+ | **Option** | **Option alias** | **Description** |
761
+ | ------------------------------ | :--------------: | ------------------------------------------------------------- |
762
+ | `--details` | `-d` | show more details on the state of each component in each lane |
763
+ | `--json` | `-j` | show lanes details in a json format |
764
+ | `--remote <remote-scope-name>` | `-r` | show remote lanes |
765
+ | `--merged` | | show merged lanes |
766
+ | `--not-merged` | | show lanes that are not merged |
767
+
768
+ ### lane switch
769
+
770
+ **Usage**: `lane switch <lane>`
771
+
772
+ **Description**: switch to the specified lane
773
+
774
+ | **Option** | **Option alias** | **Description** |
775
+ | -------------------------------- | :--------------: | ----------------------------------------------------------------------------------------------------- |
776
+ | `--alias <string>` | `-n` | relevant when the specified lane is a remote late. name a local lane differently than the remote lane |
777
+ | `--merge [strategy]` | `-m` | merge local changes with the checked out version. strategy should be "theirs", "ours" or "manual" |
778
+ | `--get-all` | `-a` | checkout all components in a lane include ones that do not exist in the workspace |
779
+ | `--skip-dependency-installation` | `-x` | do not install packages of the imported components |
780
+ | `--json` | `-j` | return the output as JSON |
781
+
782
+ ### lane show
783
+
784
+ **Usage**: `lane show [lane-name]`
785
+
786
+ **Description**: show lane details. if no lane specified, show the current lane
787
+
788
+ | **Option** | **Option alias** | **Description** |
789
+ | ------------------- | :--------------: | ------------------------------------ |
790
+ | `--json` | `-j` | show the lane details in json format |
791
+ | `--remote <string>` | `-r` | show remote lanes |
792
+
793
+ ### lane create
794
+
795
+ **Usage**: `lane create <lane-name>`
796
+
797
+ **Description**: creates a new lane and switches to it
798
+ a lane created from main (default-lane) is empty until components are snapped.
799
+ a lane created from another lane has all the components of the original lane.
800
+
801
+ | **Option** | **Option alias** | **Description** |
802
+ | ----------------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------------------------- |
803
+ | `--remote-scope <scope-name>` | | remote scope where this lane will be exported to, default to the defaultScope (can be changed later with "bit lane change-scope") |
804
+ | `--alias <name>` | | a local alias to refer to this lane, defaults to the `<lane-name>` (can be added later with "bit lane alias") |
805
+
806
+ ### lane remove
807
+
808
+ **Usage**: `lane remove <lanes...>`
809
+
810
+ **Description**: remove lanes
811
+
812
+ | **Option** | **Option alias** | **Description** |
813
+ | ---------- | :--------------: | ----------------------------------------------------------------- |
814
+ | `--remote` | `-r` | remove a remote lane (in the lane arg, use remote/lane-id syntax) |
815
+ | `--force` | `-f` | removes the lane even when the lane was not merged yet |
816
+ | `--silent` | `-s` | skip confirmation |
817
+
818
+ ### lane change-scope
819
+
820
+ **Usage**: `lane change-scope <lane-name> <remote-scope-name>`
821
+
822
+ **Description**: changes the remote scope of a lane
823
+
824
+ ### lane alias
825
+
826
+ **Usage**: `lane alias <lane-name> <alias>`
827
+
828
+ **Description**: adds an alias to a lane
829
+ an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.
830
+ it is useful when having multiple lanes with the same name, but with different remote scopes.
831
+
832
+ ### lane rename
833
+
834
+ **Usage**: `lane rename <current-name> <new-name>`
835
+
836
+ **Description**: EXPERIMENTAL. change the lane-name locally and on the remote (if exported)
837
+
838
+ ### lane diff
839
+
840
+ **Usage**: `lane diff [values...]`
841
+
842
+ **Description**: show diff between lanes
843
+ bit lane diff => diff between the current lane and default lane. (only inside workspace).
844
+ bit lane diff to => diff between the current lane (or default-lane when in scope) and "to" lane.
845
+ bit lane diff from to => diff between "from" lane and "to" lane.
846
+
847
+ | **Option** | **Option alias** | **Description** |
848
+ | ------------------------------- | :--------------: | --------------------------------------------------------------------- |
849
+ | `--pattern <component-pattern>` | | EXPERIMENTAL. show lane-diff for the specified component-pattern only |
850
+
851
+ ### lane add-readme
852
+
853
+ **Usage**: `lane add-readme <component-name> [lane-name]`
854
+
855
+ **Description**: EXPERIMENTAL. adds a readme component to a lane
856
+
857
+ ### lane remove-readme
858
+
859
+ **Usage**: `lane remove-readme [laneName]`
860
+
861
+ **Description**: EXPERIMENTAL. remove lane readme component
862
+
863
+ ### lane import
864
+
865
+ **Usage**: `lane import <lane>`
866
+
867
+ **Description**: import a remote lane to your workspace
868
+
869
+ | **Option** | **Option alias** | **Description** |
870
+ | -------------------------------- | :--------------: | -------------------------------------------------- |
871
+ | `--skip-dependency-installation` | `-x` | do not install packages of the imported components |
872
+
873
+ ### lane merge
874
+
875
+ **Usage**: `lane merge <lane> [pattern]`
876
+
877
+ **Description**: merge a local or a remote lane
878
+ by default, the provided lane will be fetched from the remote before merging.
879
+ to merge the lane from the local scope without updating it first, use "--skip-fetch" flag.
880
+
881
+ when the current and the other lanes are diverged in history and the files could be merged with no conflicts,
882
+ it will snap-merge these components to complete the merge. use "no-snap" to opt-out, or "tag" to tag instead
883
+
884
+ | **Option** | **Option alias** | **Description** |
885
+ | -------------------------------------- | :--------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
886
+ | `--ours` | | in case of a conflict, override the used version with the current modification |
887
+ | `--theirs` | | in case of a conflict, override the current modification with the specified version |
888
+ | `--manual` | | in case of a conflict, leave the files with a conflict state to resolve them manually later |
889
+ | `--workspace` | | merge only components in a lane that exist in the workspace |
890
+ | `--no-snap` | | do not auto snap in case the merge completed without conflicts |
891
+ | `--tag` | | tag all lane components after merging into main (also tag-merge in case of snap-merge) |
892
+ | `--build` | | in case of snap during the merge, run the build-pipeline (similar to bit snap --build) |
893
+ | `--message <message>` | `-m` | override the default message for the auto snap |
894
+ | `--keep-readme` | | skip deleting the lane readme component after merging |
895
+ | `--no-squash` | | EXPERIMENTAL. relevant for merging lanes into main, which by default squash. |
896
+ | `--ignore-config-changes` | | allow merging when component are modified due to config changes (such as dependencies) only and not files |
897
+ | `--verbose` | | show details of components that were not merged legitimately |
898
+ | `--skip-dependency-installation` | `-x` | do not install packages of the imported components |
899
+ | `--skip-fetch` | | use the current target-lane if exits locally without updating it from the remote |
900
+ | `--include-deps` | | EXPERIMENTAL. relevant for "--pattern" and "--workspace". merge also dependencies of the given components |
901
+ | `--resolve-unrelated [merge-strategy]` | | EXPERIMENTAL. relevant when a component on a lane and the component on main has nothing in common. merge-strategy can be "ours" (default) or "theirs" |
902
+
903
+ | **Option** | **Option alias** | **Description** |
904
+ | ------------------- | :--------------: | ------------------------------------------------------------- |
905
+ | `--details` | `-d` | show more details on the state of each component in each lane |
906
+ | `--json` | `-j` | show lanes details in json format |
907
+ | `--remote <string>` | `-r` | show remote lanes |
908
+ | `--merged` | | show merged lanes |
909
+ | `--not-merged` | | show not merged lanes |
910
+
911
+ ---
912
+
748
913
  ## link
749
914
 
750
915
  **Description**: create links in the node_modules directory, to core aspects and to components in the workspace
@@ -831,6 +996,7 @@ https://bit.dev/docs/reference/cli-reference#log
831
996
 
832
997
  | **Option** | **Option alias** | **Description** |
833
998
  | --------------------------- | :--------------: | -------------------------------------------------------------------------------------------------- |
999
+ | `--hub-domain-login <url>` | `-d` | hub domain login url (default https://bit.cloud) |
834
1000
  | `--port <port>` | `-p` | port number to open for localhost server (default 8085) |
835
1001
  | `--suppress-browser-launch` | | do not open a browser for authentication |
836
1002
  | `--npmrc-path <path>` | | path to npmrc file to configure bit.cloud registry |
package/dist/cli-reference.json CHANGED
@@ -489,6 +489,11 @@
489
489
  "name": "login",
490
490
  "alias": "",
491
491
  "options": [
492
+ [
493
+ "d",
494
+ "hub-domain-login <url>",
495
+ "hub domain login url (default https://bit.cloud)"
496
+ ],
492
497
  [
493
498
  "p",
494
499
  "port <port>",
@@ -1834,8 +1839,8 @@
1834
1839
  ],
1835
1840
  [
1836
1841
  "e",
1837
- "entire-lane",
1838
- "write also new components that were introduced on the remote lane and do not exist locally"
1842
+ "workspace-only",
1843
+ "when on a lane, avoid introducing new components from the remote lane that do not exist locally"
1839
1844
  ],
1840
1845
  [
1841
1846
  "v",
@@ -2642,8 +2647,8 @@
2642
2647
  ],
2643
2648
  "description": "manage lanes",
2644
2649
  "extendedDescription": "",
2645
- "group": "ungrouped",
2646
- "private": true,
2650
+ "group": "collaborate",
2651
+ "private": false,
2647
2652
  "remoteOp": true,
2648
2653
  "skipWorkspace": true,
2649
2654
  "commands": [
@@ -2680,7 +2685,7 @@
2680
2685
  "description": "list lanes",
2681
2686
  "extendedDescription": "",
2682
2687
  "group": "ungrouped",
2683
- "private": true,
2688
+ "private": false,
2684
2689
  "remoteOp": true,
2685
2690
  "skipWorkspace": true
2686
2691
  },
@@ -2737,7 +2742,7 @@
2737
2742
  "description": "show lane details. if no lane specified, show the current lane",
2738
2743
  "extendedDescription": "",
2739
2744
  "group": "ungrouped",
2740
- "private": true,
2745
+ "private": false,
2741
2746
  "remoteOp": true,
2742
2747
  "skipWorkspace": true
2743
2748
  },
@@ -2753,13 +2758,13 @@
2753
2758
  [
2754
2759
  "",
2755
2760
  "alias <name>",
2756
- "a local alias to refer to this lane, defaults to the <lane-name> (can be added later with \"bit lane alias\")"
2761
+ "a local alias to refer to this lane, defaults to the `<lane-name>` (can be added later with \"bit lane alias\")"
2757
2762
  ]
2758
2763
  ],
2759
2764
  "description": "creates a new lane and switches to it",
2760
2765
  "extendedDescription": "a lane created from main (default-lane) is empty until components are snapped.\na lane created from another lane has all the components of the original lane.",
2761
2766
  "group": "ungrouped",
2762
- "private": true,
2767
+ "private": false,
2763
2768
  "arguments": [
2764
2769
  {
2765
2770
  "name": "lane-name",
@@ -2805,7 +2810,7 @@
2805
2810
  "description": "changes the remote scope of a lane",
2806
2811
  "extendedDescription": "",
2807
2812
  "group": "ungrouped",
2808
- "private": true
2813
+ "private": false
2809
2814
  },
2810
2815
  {
2811
2816
  "name": "alias <lane-name> <alias>",
@@ -2814,7 +2819,7 @@
2814
2819
  "description": "adds an alias to a lane",
2815
2820
  "extendedDescription": "an alias is a name that can be used to refer to a lane. it is saved locally and never reach the remote.\nit is useful when having multiple lanes with the same name, but with different remote scopes.",
2816
2821
  "group": "ungrouped",
2817
- "private": true
2822
+ "private": false
2818
2823
  },
2819
2824
  {
2820
2825
  "name": "rename <current-name> <new-name>",
@@ -2823,7 +2828,7 @@
2823
2828
  "description": "EXPERIMENTAL. change the lane-name locally and on the remote (if exported)",
2824
2829
  "extendedDescription": "",
2825
2830
  "group": "ungrouped",
2826
- "private": true
2831
+ "private": false
2827
2832
  },
2828
2833
  {
2829
2834
  "name": "diff [values...]",
@@ -2849,7 +2854,7 @@
2849
2854
  "description": "EXPERIMENTAL. adds a readme component to a lane",
2850
2855
  "extendedDescription": "",
2851
2856
  "group": "ungrouped",
2852
- "private": true,
2857
+ "private": false,
2853
2858
  "skipWorkspace": false,
2854
2859
  "arguments": [
2855
2860
  {
@@ -2869,7 +2874,7 @@
2869
2874
  "description": "EXPERIMENTAL. remove lane readme component",
2870
2875
  "extendedDescription": "",
2871
2876
  "group": "ungrouped",
2872
- "private": true,
2877
+ "private": false,
2873
2878
  "skipWorkspace": false
2874
2879
  },
2875
2880
  {
@@ -2885,7 +2890,7 @@
2885
2890
  "description": "import a remote lane to your workspace",
2886
2891
  "extendedDescription": "",
2887
2892
  "group": "ungrouped",
2888
- "private": true,
2893
+ "private": false,
2889
2894
  "arguments": [
2890
2895
  {
2891
2896
  "name": "lane",
@@ -3860,8 +3865,8 @@
3860
3865
  ],
3861
3866
  [
3862
3867
  "",
3863
- "rename",
3864
- "rename files and variables/classes according to the new component name"
3868
+ "preserve",
3869
+ "avoid renaming files and variables/classes according to the new component name"
3865
3870
  ],
3866
3871
  [
3867
3872
  "",