@teambit/harmony.content.cli-reference 2.0.71 → 2.0.73

package/cli-reference.docs.mdx

@@ -1,5 +1,5 @@
 ---
-description: 'Bit command synopses. Bit version: 1.3.32'
+description: 'Bit command synopses. Bit version: 1.4.1'
 labels: ['cli', 'mdx', 'docs']
 ---
       

package/cli-reference.json

@@ -1272,7 +1272,7 @@
       ]
     ],
     "description": "list the component ids matching the given pattern",
-    "extendedDescription": "this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. 'ui/button'.\na pattern can be used with wildcards for multiple component ids, e.g. 'org.scope/utils/**' or '**/utils/**' to capture all org/scopes.\nto enter multiple patterns, separate them by a comma, e.g. 'ui/*, lib/*'\nto exclude, use '!'. e.g. 'ui/**, !ui/button'\nthe matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch)\nNOTE: always wrap the pattern with single quotes '' and not double \"\" to avoid collision with shell commands\n",
+    "extendedDescription": "this command helps validating a pattern before using it in other commands.\nNOTE: always wrap the pattern with quotes to avoid collision with shell commands. depending on your shell, it might be single or double quotes.\na pattern can be a simple component-id or component-name. e.g. 'ui/button'.\na pattern can be used with wildcards for multiple component ids, e.g. 'org.scope/utils/**' or '**/utils/**' to capture all org/scopes.\nto enter multiple patterns, separate them by a comma, e.g. 'ui/*, lib/*'\nto exclude, use '!'. e.g. 'ui/**, !ui/button'\nthe matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch).\n\nto filter by a state or attribute, prefix the pattern with \"$\". e.g. '$deprecated', '$modified'.\nlist of supported states: [new, modified, deprecated, deleted, snappedOnMain, softTagged, codeModified].\nto filter by multi-params state/attribute, separate the params with \":\", e.g. '$env:teambit.react/react'.\nlist of supported multi-params states: [env].\nto match a state and another criteria, use \" AND \" keyword. e.g. '$modified AND teambit.workspace/**'. note that the state must be first.\n",
     "group": "development",
     "private": false,
     "examples": [

package/cli-reference.mdx

@@ -1424,12 +1424,18 @@ move files or directories of component(s)
 
 **Description**: list the component ids matching the given pattern  
 this command helps validating a pattern before using it in other commands.  
+NOTE: always wrap the pattern with quotes to avoid collision with shell commands. depending on your shell, it might be single or double quotes.  
 a pattern can be a simple component-id or component-name. e.g. 'ui/button'.  
 a pattern can be used with wildcards for multiple component ids, e.g. 'org.scope/utils/**' or '**/utils/**' to capture all org/scopes.  
 to enter multiple patterns, separate them by a comma, e.g. 'ui/_, lib/_'  
 to exclude, use '!'. e.g. 'ui/**, !ui/button'  
-the matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch)  
-NOTE: always wrap the pattern with single quotes '' and not double "" to avoid collision with shell commands
+the matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch).
+
+to filter by a state or attribute, prefix the pattern with "$". e.g. '$deprecated', '$modified'.  
+list of supported states: [new, modified, deprecated, deleted, snappedOnMain, softTagged, codeModified].  
+to filter by multi-params state/attribute, separate the params with ":", e.g. '$env:teambit.react/react'.  
+list of supported multi-params states: [env].  
+to match a state and another criteria, use " AND " keyword. e.g. '$modified AND teambit.workspace/\*\*'. note that the state must be first.
 
 `bit pattern <pattern>`
 

package/dist/cli-reference.docs.mdx

@@ -1,5 +1,5 @@
 ---
-description: 'Bit command synopses. Bit version: 1.3.32'
+description: 'Bit command synopses. Bit version: 1.4.1'
 labels: ['cli', 'mdx', 'docs']
 ---
       

package/dist/cli-reference.json

@@ -1272,7 +1272,7 @@
             ]
         ],
         "description": "list the component ids matching the given pattern",
-        "extendedDescription": "this command helps validating a pattern before using it in other commands.\na pattern can be a simple component-id or component-name. e.g. 'ui/button'.\na pattern can be used with wildcards for multiple component ids, e.g. 'org.scope/utils/**' or '**/utils/**' to capture all org/scopes.\nto enter multiple patterns, separate them by a comma, e.g. 'ui/*, lib/*'\nto exclude, use '!'. e.g. 'ui/**, !ui/button'\nthe matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch)\nNOTE: always wrap the pattern with single quotes '' and not double \"\" to avoid collision with shell commands\n",
+        "extendedDescription": "this command helps validating a pattern before using it in other commands.\nNOTE: always wrap the pattern with quotes to avoid collision with shell commands. depending on your shell, it might be single or double quotes.\na pattern can be a simple component-id or component-name. e.g. 'ui/button'.\na pattern can be used with wildcards for multiple component ids, e.g. 'org.scope/utils/**' or '**/utils/**' to capture all org/scopes.\nto enter multiple patterns, separate them by a comma, e.g. 'ui/*, lib/*'\nto exclude, use '!'. e.g. 'ui/**, !ui/button'\nthe matching algorithm is from multimatch (@see https://github.com/sindresorhus/multimatch).\n\nto filter by a state or attribute, prefix the pattern with \"$\". e.g. '$deprecated', '$modified'.\nlist of supported states: [new, modified, deprecated, deleted, snappedOnMain, softTagged, codeModified].\nto filter by multi-params state/attribute, separate the params with \":\", e.g. '$env:teambit.react/react'.\nlist of supported multi-params states: [env].\nto match a state and another criteria, use \" AND \" keyword. e.g. '$modified AND teambit.workspace/**'. note that the state must be first.\n",
         "group": "development",
         "private": false,
         "examples": [

package/dist/cli-reference.mdx.js

@@ -7407,6 +7407,8 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "this command helps validating a pattern before using it in other commands.", (0, _react2.mdx)("br", {
     parentName: "p"
+  }), "\n", "NOTE: always wrap the pattern with quotes to avoid collision with shell commands. depending on your shell, it might be single or double quotes.", (0, _react2.mdx)("br", {
+    parentName: "p"
   }), "\n", "a pattern can be a simple component-id or component-name. e.g. 'ui/button'.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "a pattern can be used with wildcards for multiple component ids, e.g. 'org.scope/utils/", (0, _react2.mdx)("strong", {
@@ -7424,9 +7426,15 @@ function MDXContent(_ref) {
   }), "\n", "the matching algorithm is from multimatch (@see ", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "https://github.com/sindresorhus/multimatch"
-  }, "https://github.com/sindresorhus/multimatch"), ")", (0, _react2.mdx)("br", {
+  }, "https://github.com/sindresorhus/multimatch"), ")."), (0, _react2.mdx)("p", null, "to filter by a state or attribute, prefix the pattern with \"$\". e.g. '$deprecated', '$modified'.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "list of supported states: ", "[new, modified, deprecated, deleted, snappedOnMain, softTagged, codeModified]", ".", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "to filter by multi-params state/attribute, separate the params with \":\", e.g. '$env:teambit.react/react'.", (0, _react2.mdx)("br", {
+    parentName: "p"
+  }), "\n", "list of supported multi-params states: ", "[env]", ".", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "NOTE: always wrap the pattern with single quotes '' and not double \"\" to avoid collision with shell commands"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }), "\n", "to match a state and another criteria, use \" AND \" keyword. e.g. '$modified AND teambit.workspace/", "*", "*", "'. note that the state must be first."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit pattern <pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"