Release v0.0.8

Default false to keep current testcases running

.size-snapshot.json

@@ -1,36 +1,36 @@
 {
   "dist/react-fiber-traverse.cjs.development.js": {
-    "bundled": 9674,
-    "minified": 4533,
-    "gzipped": 1335
+    "bundled": 19424,
+    "minified": 8388,
+    "gzipped": 2612
   },
   "dist/react-fiber-traverse.cjs.production.js": {
-    "bundled": 9674,
-    "minified": 4533,
-    "gzipped": 1335
+    "bundled": 19424,
+    "minified": 8388,
+    "gzipped": 2612
   },
   "dist/react-fiber-traverse.esm.js": {
-    "bundled": 9312,
-    "minified": 4229,
-    "gzipped": 1245,
+    "bundled": 19124,
+    "minified": 8112,
+    "gzipped": 2537,
     "treeshaked": {
       "rollup": {
-        "code": 49,
-        "import_statements": 49
+        "code": 31,
+        "import_statements": 31
       },
       "webpack": {
-        "code": 1066
+        "code": 1048
       }
     }
   },
   "dist/react-fiber-traverse.umd.development.js": {
-    "bundled": 34862,
-    "minified": 9669,
-    "gzipped": 3394
+    "bundled": 34569,
+    "minified": 11581,
+    "gzipped": 4230
   },
   "dist/react-fiber-traverse.umd.production.js": {
-    "bundled": 34862,
-    "minified": 9669,
-    "gzipped": 3394
+    "bundled": 34569,
+    "minified": 11581,
+    "gzipped": 4230
   }
 }

docs/globals.md

@@ -10,6 +10,7 @@
 
 * ["findNode"](modules/_findnode_.md)
 * ["index"](modules/_index_.md)
+* ["match"](modules/_match_.md)
 * ["mocked-types/index"](modules/_mocked_types_index_.md)
 * ["traverse"](modules/_traverse_.md)
 * ["utils"](modules/_utils_.md)

docs/interfaces/_mocked_types_index_.fibernodedomcontainer.md

@@ -347,7 +347,7 @@ ___
 
 • **_reactRootContainer**: *object*
 
-*Defined in [mocked-types/index.ts:4](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L4)*
+*Defined in [mocked-types/index.ts:4](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L4)*
 
 #### Type declaration:
 

docs/interfaces/_mocked_types_index_.fibernodeforcomponentclass.md

@@ -24,7 +24,7 @@
 
 • **child**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:28](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L28)*
+*Defined in [mocked-types/index.ts:28](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L28)*
 
 ___
 
@@ -32,7 +32,7 @@ ___
 
 • **elementType**: *`ComponentClass`*
 
-*Defined in [mocked-types/index.ts:31](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L31)*
+*Defined in [mocked-types/index.ts:31](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L31)*
 
 ___
 
@@ -40,7 +40,7 @@ ___
 
 • **sibling**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:29](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L29)*
+*Defined in [mocked-types/index.ts:29](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L29)*
 
 ___
 
@@ -48,7 +48,7 @@ ___
 
 • **stateNode**: *`Component`*
 
-*Defined in [mocked-types/index.ts:34](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L34)*
+*Defined in [mocked-types/index.ts:34](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L34)*
 
 ___
 
@@ -56,4 +56,4 @@ ___
 
 • **type**: *`ComponentClass`*
 
-*Defined in [mocked-types/index.ts:32](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L32)*
+*Defined in [mocked-types/index.ts:32](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L32)*

docs/interfaces/_mocked_types_index_.fibernodeforfunctioncomponent.md

@@ -24,7 +24,7 @@
 
 • **child**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:18](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L18)*
+*Defined in [mocked-types/index.ts:18](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L18)*
 
 ___
 
@@ -32,7 +32,7 @@ ___
 
 • **elementType**: *`FunctionComponent`*
 
-*Defined in [mocked-types/index.ts:21](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L21)*
+*Defined in [mocked-types/index.ts:21](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L21)*
 
 ___
 
@@ -40,7 +40,7 @@ ___
 
 • **sibling**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:19](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L19)*
+*Defined in [mocked-types/index.ts:19](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L19)*
 
 ___
 
@@ -48,7 +48,7 @@ ___
 
 • **stateNode**: *null*
 
-*Defined in [mocked-types/index.ts:24](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L24)*
+*Defined in [mocked-types/index.ts:24](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L24)*
 
 ___
 
@@ -56,4 +56,4 @@ ___
 
 • **type**: *`FunctionComponent`*
 
-*Defined in [mocked-types/index.ts:22](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L22)*
+*Defined in [mocked-types/index.ts:22](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L22)*

docs/interfaces/_mocked_types_index_.fibernodeforinstrinsicelement.md

@@ -24,9 +24,9 @@
 
 • **child**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:38](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L38)*
+*Defined in [mocked-types/index.ts:38](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L38)*
 
-*Defined in [mocked-types/index.ts:48](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L48)*
+*Defined in [mocked-types/index.ts:48](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L48)*
 
 ___
 
@@ -34,9 +34,9 @@ ___
 
 • **elementType**: *keyof IntrinsicElements*
 
-*Defined in [mocked-types/index.ts:41](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L41)*
+*Defined in [mocked-types/index.ts:41](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L41)*
 
-*Defined in [mocked-types/index.ts:51](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L51)*
+*Defined in [mocked-types/index.ts:51](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L51)*
 
 ___
 
@@ -44,9 +44,9 @@ ___
 
 • **sibling**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:39](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L39)*
+*Defined in [mocked-types/index.ts:39](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L39)*
 
-*Defined in [mocked-types/index.ts:49](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L49)*
+*Defined in [mocked-types/index.ts:49](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L49)*
 
 ___
 
@@ -54,9 +54,9 @@ ___
 
 • **stateNode**: *`HTMLElement`*
 
-*Defined in [mocked-types/index.ts:44](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L44)*
+*Defined in [mocked-types/index.ts:44](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L44)*
 
-*Defined in [mocked-types/index.ts:54](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L54)*
+*Defined in [mocked-types/index.ts:54](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L54)*
 
 ___
 
@@ -64,6 +64,6 @@ ___
 
 • **type**: *keyof IntrinsicElements*
 
-*Defined in [mocked-types/index.ts:42](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L42)*
+*Defined in [mocked-types/index.ts:42](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L42)*
 
-*Defined in [mocked-types/index.ts:52](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L52)*
+*Defined in [mocked-types/index.ts:52](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L52)*

docs/interfaces/_mocked_types_index_.fibernodefortextnode.md

@@ -24,7 +24,7 @@
 
 • **child**: *null*
 
-*Defined in [mocked-types/index.ts:58](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L58)*
+*Defined in [mocked-types/index.ts:58](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L58)*
 
 ___
 
@@ -32,7 +32,7 @@ ___
 
 • **elementType**: *null*
 
-*Defined in [mocked-types/index.ts:61](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L61)*
+*Defined in [mocked-types/index.ts:61](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L61)*
 
 ___
 
@@ -40,7 +40,7 @@ ___
 
 • **sibling**: *[FiberNode](../modules/_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [mocked-types/index.ts:59](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L59)*
+*Defined in [mocked-types/index.ts:59](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L59)*
 
 ___
 
@@ -48,7 +48,7 @@ ___
 
 • **stateNode**: *`Text`*
 
-*Defined in [mocked-types/index.ts:64](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L64)*
+*Defined in [mocked-types/index.ts:64](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L64)*
 
 ___
 
@@ -56,4 +56,4 @@ ___
 
 • **type**: *null*
 
-*Defined in [mocked-types/index.ts:62](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L62)*
+*Defined in [mocked-types/index.ts:62](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L62)*

docs/interfaces/_traverse_.ttraverseconfig.md

@@ -0,0 +1,41 @@
+> **[react-fiber-traverse](../README.md)**
+
+[Globals](../globals.md) / ["traverse"](../modules/_traverse_.md) / [TTraverseConfig](_traverse_.ttraverseconfig.md) /
+
+# Interface: TTraverseConfig
+
+## Hierarchy
+
+* **TTraverseConfig**
+
+## Index
+
+### Properties
+
+* [order](_traverse_.ttraverseconfig.md#optional-order)
+* [skipSelfForStartNode](_traverse_.ttraverseconfig.md#optional-skipselfforstartnode)
+* [skipSiblingForStartNode](_traverse_.ttraverseconfig.md#optional-skipsiblingforstartnode)
+
+## Properties
+
+### `Optional` order
+
+• **order**? : *`Array<"self" | "child" | "sibling">`*
+
+*Defined in [traverse.ts:5](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/traverse.ts#L5)*
+
+___
+
+### `Optional` skipSelfForStartNode
+
+• **skipSelfForStartNode**? : *undefined | false | true*
+
+*Defined in [traverse.ts:7](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/traverse.ts#L7)*
+
+___
+
+### `Optional` skipSiblingForStartNode
+
+• **skipSiblingForStartNode**? : *undefined | false | true*
+
+*Defined in [traverse.ts:6](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/traverse.ts#L6)*

docs/modules/_findnode_.md

@@ -8,17 +8,37 @@
 
 ### Functions
 
+* [findAllNodesByComponentName](_findnode_.md#findallnodesbycomponentname)
 * [findNodeByComponent](_findnode_.md#findnodebycomponent)
 * [findNodeByComponentName](_findnode_.md#findnodebycomponentname)
 * [findNodeByComponentRef](_findnode_.md#findnodebycomponentref)
+* [findNodesByComponentName](_findnode_.md#findnodesbycomponentname)
 
 ## Functions
 
+###  findAllNodesByComponentName
+
+▸ **findAllNodesByComponentName**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedName`: string, `traverseConfig?`: [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)): *`Array<FiberNode>`*
+
+*Defined in [findNode.ts:58](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/findNode.ts#L58)*
+
+**Parameters:**
+
+Name | Type |
+------ | ------ |
+`node` | [FiberNode](_mocked_types_index_.md#fibernode) \| null |
+`expectedName` | string |
+`traverseConfig?` | [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md) |
+
+**Returns:** *`Array<FiberNode>`*
+
+___
+
 ###  findNodeByComponent
 
-▸ **findNodeByComponent**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedClassOrFunction`: `React.ComponentType`): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+▸ **findNodeByComponent**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedClassOrFunction`: `React.ComponentType`, `traverseConfig?`: [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [findNode.ts:67](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/findNode.ts#L67)*
+*Defined in [findNode.ts:84](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/findNode.ts#L84)*
 
 Find node by component (i.e. class or function by reference), till first match.
 
@@ -42,6 +62,7 @@ Name | Type |
 ------ | ------ |
 `node` | [FiberNode](_mocked_types_index_.md#fibernode) \| null |
 `expectedClassOrFunction` | `React.ComponentType` |
+`traverseConfig?` | [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md) |
 
 **Returns:** *[FiberNode](_mocked_types_index_.md#fibernode) | null*
 
@@ -49,9 +70,9 @@ ___
 
 ###  findNodeByComponentName
 
-▸ **findNodeByComponentName**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedName`: string): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+▸ **findNodeByComponentName**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedName`: string, `traverseConfig?`: [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [findNode.ts:21](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/findNode.ts#L21)*
+*Defined in [findNode.ts:22](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/findNode.ts#L22)*
 
 Find node by component name, till first match.
 
@@ -74,6 +95,7 @@ Name | Type |
 ------ | ------ |
 `node` | [FiberNode](_mocked_types_index_.md#fibernode) \| null |
 `expectedName` | string |
+`traverseConfig?` | [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md) |
 
 **Returns:** *[FiberNode](_mocked_types_index_.md#fibernode) | null*
 
@@ -81,9 +103,9 @@ ___
 
 ###  findNodeByComponentRef
 
-▸ **findNodeByComponentRef**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedClassInstance`: `Component`): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+▸ **findNodeByComponentRef**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedClassInstance`: `Component`, `traverseConfig?`: [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [findNode.ts:114](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/findNode.ts#L114)*
+*Defined in [findNode.ts:122](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/findNode.ts#L122)*
 
 Find node by component instance ref, till first match.
 
@@ -105,5 +127,24 @@ Name | Type |
 ------ | ------ |
 `node` | [FiberNode](_mocked_types_index_.md#fibernode) \| null |
 `expectedClassInstance` | `Component` |
+`traverseConfig?` | [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md) |
 
-**Returns:** *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+**Returns:** *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+
+___
+
+###  findNodesByComponentName
+
+▸ **findNodesByComponentName**(`node`: [FiberNode](_mocked_types_index_.md#fibernode) | null, `expectedName`: string, `traverseConfig?`: [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)): *`IterableIterator<FiberNode>`*
+
+*Defined in [findNode.ts:41](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/findNode.ts#L41)*
+
+**Parameters:**
+
+Name | Type |
+------ | ------ |
+`node` | [FiberNode](_mocked_types_index_.md#fibernode) \| null |
+`expectedName` | string |
+`traverseConfig?` | [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md) |
+
+**Returns:** *`IterableIterator<FiberNode>`*

docs/modules/_match_.md

@@ -0,0 +1,64 @@
+> **[react-fiber-traverse](../README.md)**
+
+[Globals](../globals.md) / ["match"](_match_.md) /
+
+# External module: "match"
+
+## Index
+
+### Functions
+
+* [matchAll](_match_.md#matchall)
+* [matchFirst](_match_.md#matchfirst)
+* [matchGenerator](_match_.md#matchgenerator)
+
+## Functions
+
+###  matchAll
+
+▸ **matchAll**(`node`: [FiberNode](_mocked_types_index_.md#fibernode), `match`: string | `CSSWhat.Selector`[][]): *`Array<FiberNode>`*
+
+*Defined in [match.ts:115](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/match.ts#L115)*
+
+**Parameters:**
+
+Name | Type |
+------ | ------ |
+`node` | [FiberNode](_mocked_types_index_.md#fibernode) |
+`match` | string \| `CSSWhat.Selector`[][] |
+
+**Returns:** *`Array<FiberNode>`*
+
+___
+
+###  matchFirst
+
+▸ **matchFirst**(`node`: [FiberNode](_mocked_types_index_.md#fibernode), `match`: string | `CSSWhat.Selector`[][]): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+
+*Defined in [match.ts:122](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/match.ts#L122)*
+
+**Parameters:**
+
+Name | Type |
+------ | ------ |
+`node` | [FiberNode](_mocked_types_index_.md#fibernode) |
+`match` | string \| `CSSWhat.Selector`[][] |
+
+**Returns:** *[FiberNode](_mocked_types_index_.md#fibernode) | null*
+
+___
+
+###  matchGenerator
+
+▸ **matchGenerator**(`node`: [FiberNode](_mocked_types_index_.md#fibernode), `match`: string | `CSSWhat.Selector`[][]): *`IterableIterator<FiberNode>`*
+
+*Defined in [match.ts:6](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/match.ts#L6)*
+
+**Parameters:**
+
+Name | Type |
+------ | ------ |
+`node` | [FiberNode](_mocked_types_index_.md#fibernode) |
+`match` | string \| `CSSWhat.Selector`[][] |
+
+**Returns:** *`IterableIterator<FiberNode>`*

docs/modules/_mocked_types_index_.md

@@ -25,7 +25,7 @@
 
 Ƭ **FiberNode**: *[FiberNodeForComponentClass](../interfaces/_mocked_types_index_.fibernodeforcomponentclass.md) | [FiberNodeForFunctionComponent](../interfaces/_mocked_types_index_.fibernodeforfunctioncomponent.md) | [FiberNodeForInstrinsicElement](../interfaces/_mocked_types_index_.fibernodeforinstrinsicelement.md) | [FiberNodeForTextNode](../interfaces/_mocked_types_index_.fibernodefortextnode.md)*
 
-*Defined in [mocked-types/index.ts:11](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L11)*
+*Defined in [mocked-types/index.ts:11](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L11)*
 
 ___
 
@@ -33,4 +33,4 @@ ___
 
 Ƭ **FiberNodeisHTMLLike**: *[FiberNodeForInstrinsicElement](../interfaces/_mocked_types_index_.fibernodeforinstrinsicelement.md) | [FiberNodeForTextNode](../interfaces/_mocked_types_index_.fibernodefortextnode.md)*
 
-*Defined in [mocked-types/index.ts:67](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/mocked-types/index.ts#L67)*
+*Defined in [mocked-types/index.ts:67](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/mocked-types/index.ts#L67)*

docs/modules/_traverse_.md

@@ -6,6 +6,10 @@
 
 ## Index
 
+### Interfaces
+
+* [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)
+
 ### Functions
 
 * [traverse](_traverse_.md#traverse)
@@ -15,13 +19,13 @@
 
 ###  traverse
 
-▸ **traverse**(`node`: [FiberNode](_mocked_types_index_.md#fibernode), `fn`: function): *void*
+▸ **traverse**(`node`: [FiberNode](_mocked_types_index_.md#fibernode), `fn`: function, `traverseConfig?`: [TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)): *void*
 
-*Defined in [traverse.ts:19](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/traverse.ts#L19)*
+*Defined in [traverse.ts:146](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/traverse.ts#L146)*
 
 Traverse nodes recursively in depth-first manner, starting from a start node.
 
-This is the default and basic traversal method, which covers basic use cases.
+This is the default and basic traversal function, which covers basic use cases.
 You can't do advanced things like change the order of traversal, skip or cancel traversal after any node, etc.
 For more advanced usecases, see [traverseGenerator](_traverse_.md#traversegenerator)
 
@@ -45,6 +49,8 @@ Name | Type |
 ------ | ------ |
 `node` | [FiberNode](_mocked_types_index_.md#fibernode) |
 
+▪`Optional`  **traverseConfig**: *[TTraverseConfig](../interfaces/_traverse_.ttraverseconfig.md)*
+
 **Returns:** *void*
 
 ___
@@ -53,7 +59,64 @@ ___
 
 ▸ **traverseGenerator**(`node`: [FiberNode](_mocked_types_index_.md#fibernode), `__namedParameters`: object): *`IterableIterator<FiberNode>`*
 
-*Defined in [traverse.ts:30](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/traverse.ts#L30)*
+*Defined in [traverse.ts:69](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/traverse.ts#L69)*
+
+Traverse nodes recursively using generators.
+
+This is the advanced traverse function, which can be used used
+to write other variants of traversal and find.
+
+Type signature for generator.next first argument is `{ skipChild?: boolean; skipSibling?: boolean } | void `
+Throw any error into the generator to finish the generator and let it cleanup its internals.
+
+It allows inversion of control -
+so, application code can decide to
+1. change order of traversal,
+2. skip some elements,
+3. cancel traversal mid-way.
+
+**`example`** 
+```js
+// Basic use (for-of)
+
+const nodeIterator = traverseGenerator(rootNode);
+for (const node of nodeIterator) {
+ // do something with each node here
+}
+```
+------
+
+**`example`** 
+```js
+// Breadth-first
+
+// note the order below
+const nodeIterator = traverseGenerator(rootNode, ["self", "sibling", "child"]);
+// rest - same as above
+```
+-----
+
+**`example`** 
+```js
+// Get first 3 nodes and then stop the generator
+
+const nodeIterator = traverseGenerator(rootNode);
+
+var count = 0;
+var next;
+while (
+   count < 3 &&
+   !(next = nodeIterator.next()).done
+) {
+   count++;
+   const node = next.value;
+   // do something with each node here
+}
+
+// Finish generator, to prevent memory leak
+nodeIterator.throw(new Error());
+```
+-----
 
 **Parameters:**
 
@@ -64,5 +127,7 @@ ___
 Name | Type | Default |
 ------ | ------ | ------ |
 `order` | "self" \| "child" \| "sibling"[] |  ["self", "child", "sibling"] |
+`skipSelfForStartNode` | boolean | false |
+`skipSiblingForStartNode` | boolean | true |
 
 **Returns:** *`IterableIterator<FiberNode>`*

docs/modules/_utils_.md

@@ -24,7 +24,7 @@
 
 ▸ **doesElementContainRootFiberNode**(`element`: `Element`): *boolean*
 
-*Defined in [utils.ts:65](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L65)*
+*Defined in [utils.ts:65](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L65)*
 
 **Parameters:**
 
@@ -40,7 +40,7 @@ ___
 
 ▸ **getRootFiberNodeFromDOM**(`startElement?`: [Element](../interfaces/_mocked_types_index_.fibernodedomcontainer.md#element)): *[FiberNode](_mocked_types_index_.md#fibernode) | null*
 
-*Defined in [utils.ts:82](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L82)*
+*Defined in [utils.ts:82](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L82)*
 
 Util to find root React Fiber node from html DOM tree.
 Returns null, if not found.SHould be called after ReactDOM.render is finished.
@@ -59,7 +59,7 @@ ___
 
 ▸ **isConstructorComponentClass**(`ctr`: `React.ElementType` | null): *boolean*
 
-*Defined in [utils.ts:42](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L42)*
+*Defined in [utils.ts:42](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L42)*
 
 **Parameters:**
 
@@ -75,7 +75,7 @@ ___
 
 ▸ **isConstructorFunctionComponent**(`ctr`: `React.ElementType` | null): *boolean*
 
-*Defined in [utils.ts:59](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L59)*
+*Defined in [utils.ts:59](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L59)*
 
 **Parameters:**
 
@@ -91,7 +91,7 @@ ___
 
 ▸ **isConstructorHtmlLike**(`ctr`: `React.ElementType` | null): *boolean*
 
-*Defined in [utils.ts:33](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L33)*
+*Defined in [utils.ts:33](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L33)*
 
 **Parameters:**
 
@@ -107,7 +107,7 @@ ___
 
 ▸ **isNodeComponentClass**(`node`: [FiberNode](_mocked_types_index_.md#fibernode)): *boolean*
 
-*Defined in [utils.ts:27](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L27)*
+*Defined in [utils.ts:27](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L27)*
 
 **Parameters:**
 
@@ -123,7 +123,7 @@ ___
 
 ▸ **isNodeFunctionComponent**(`node`: [FiberNode](_mocked_types_index_.md#fibernode)): *boolean*
 
-*Defined in [utils.ts:21](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L21)*
+*Defined in [utils.ts:21](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L21)*
 
 **Parameters:**
 
@@ -139,7 +139,7 @@ ___
 
 ▸ **isNodeHtmlLike**(`node`: [FiberNode](_mocked_types_index_.md#fibernode)): *boolean*
 
-*Defined in [utils.ts:11](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L11)*
+*Defined in [utils.ts:11](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L11)*
 
 **Parameters:**
 
@@ -155,7 +155,7 @@ ___
 
 ▸ **isNodeNotHtmlLike**(`node`: [FiberNode](_mocked_types_index_.md#fibernode)): *boolean*
 
-*Defined in [utils.ts:15](https://github.com/bendtherules/react-fiber-traverse/blob/fd6dad2/src/utils.ts#L15)*
+*Defined in [utils.ts:15](https://github.com/bendtherules/react-fiber-traverse/blob/c92c64b/src/utils.ts#L15)*
 
 **Parameters:**
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "react-fiber-traverse",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
@@ -3775,13 +3775,20 @@
         "css-what": "2.1",
         "domutils": "1.5.1",
         "nth-check": "~1.0.1"
+      },
+      "dependencies": {
+        "css-what": {
+          "version": "2.1.3",
+          "resolved": "https://registry.npmjs.org/css-what/-/css-what-2.1.3.tgz",
+          "integrity": "sha512-a+EPoD+uZiNfh+5fxw2nO9QwFa6nJe2Or35fGY6Ipw1R3R4AGz1d1TEZrCegvw2YTmZ0jXirGYlzxxpYSHwpEg==",
+          "dev": true
+        }
       }
     },
     "css-what": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/css-what/-/css-what-2.1.3.tgz",
-      "integrity": "sha512-a+EPoD+uZiNfh+5fxw2nO9QwFa6nJe2Or35fGY6Ipw1R3R4AGz1d1TEZrCegvw2YTmZ0jXirGYlzxxpYSHwpEg==",
-      "dev": true
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/css-what/-/css-what-3.2.0.tgz",
+      "integrity": "sha512-lukqnlbswsPmDZ5+ViDBCcrk+1fyPBA+ZoHSAQhRuEeXBKUb3Lj2kcTwMqoiFrJAnEeO9u3Oc8X617SUm3apYQ=="
     },
     "cssom": {
       "version": "0.3.8",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-fiber-traverse",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Traverse and other utils on top of React fiber tree",
   "main": "dist/index.js",
   "module": "dist/react-fiber-traverse.esm.js",
@@ -37,7 +37,7 @@
     "test:src:watch": "npm run test:src -- --watch",
     "test:umd": "jest --config ./scripts/jest/config.umd.js",
     "test:umdprod": "jest --config ./scripts/jest/config.umdprod.js",
-    "test:src:debug": "node --inspect ./node_modules/jest/bin/jest.js  --config ./scripts/jest/config.src.js",
+    "test:src:debug": "node --inspect ./node_modules/jest/bin/jest.js --runInBand --config ./scripts/jest/config.src.js",
     "version": "run-s test authors docs && git add ."
   },
   "husky": {
@@ -66,6 +66,7 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.5.4",
+    "css-what": "^3.2.0",
     "prop-types": "^15.7.2"
   },
   "devDependencies": {

src/index.ts

@@ -4,6 +4,7 @@ import {
   findNodeByComponentRef,
   findNodeByComponentName
 } from "./findNode";
+import { matchGenerator, matchAll, matchFirst } from "./match";
 import * as Utils from "./utils";
 
 export {
@@ -12,5 +13,8 @@ export {
   findNodeByComponent,
   findNodeByComponentRef,
   findNodeByComponentName,
+  matchGenerator,
+  matchAll,
+  matchFirst,
   Utils
 };

src/match.ts

@@ -0,0 +1,141 @@
+import * as CSSWhat from "css-what";
+import { traverseGenerator } from "./traverse";
+import { FiberNode } from "./mocked-types";
+import { isNodeNotHtmlLike } from "./utils";
+
+function* matchGenerator(
+  node: FiberNode,
+  match: string | CSSWhat.Selector[][]
+): IterableIterator<FiberNode> {
+  // Either parse match string or allow parsed match object as it is
+  let matchParsed: CSSWhat.Selector[][];
+  if (typeof match === "string") {
+    matchParsed = CSSWhat.parse(match, {
+      lowerCaseTags: false,
+      lowerCaseAttributeNames: false
+    });
+  } else {
+    matchParsed = match;
+  }
+  // If selector is a combination of multiple basic selectors (a, b),
+  // pass them separately to matchGenerator and combine their results one after another
+  const selectorsCount = matchParsed.length;
+  if (selectorsCount > 1) {
+    for (const selectorParsed of matchParsed) {
+      yield* matchGenerator(node, [selectorParsed]);
+    }
+
+    return;
+  }
+
+  // For simple selector (matchParsed.length == 0), actual logic starts here
+  {
+    const parsedSelector = matchParsed[0];
+    if (parsedSelector.length === 0) {
+      return;
+    }
+
+    let currentMatchingNodes: FiberNode[] = [node];
+    let currentMatchingSelectorPartIndex = 0;
+    let lastRelationshipSelectorPart: CSSWhat.Selector | undefined = undefined;
+
+    while (currentMatchingSelectorPartIndex < parsedSelector.length) {
+      const nextMatchingNodes: FiberNode[] = [];
+
+      for (const currentNode of currentMatchingNodes) {
+        const currentMatchingSelectorPart: CSSWhat.Selector =
+          parsedSelector[currentMatchingSelectorPartIndex];
+        if (["tag"].includes(currentMatchingSelectorPart.type)) {
+          const startParams = {
+            skipSelfForStartNode: true,
+            skipSiblingForStartNode: true
+          };
+
+          let nextParams: {
+            skipChild?: boolean;
+            skipSibling?: boolean;
+          } = {};
+          if (
+            lastRelationshipSelectorPart === undefined ||
+            lastRelationshipSelectorPart.type === "descendant"
+          ) {
+            nextParams = { skipChild: false, skipSibling: false };
+          } else if (lastRelationshipSelectorPart.type === "child") {
+            // visit only first level of child
+            nextParams = { skipChild: true };
+          } else if (lastRelationshipSelectorPart.type === "sibling") {
+            // visit only siblings of start node
+            nextParams = { skipChild: true, skipSibling: true };
+            startParams.skipSiblingForStartNode = false;
+          }
+
+          const traverseIterator = traverseGenerator(currentNode, startParams);
+
+          // Handle supported non-traversal parts here
+          if (currentMatchingSelectorPart.type == "tag") {
+            let tmpNode: FiberNode;
+            while (
+              !({ value: tmpNode } = traverseIterator.next(nextParams)).done
+            ) {
+              if (
+                isNodeNotHtmlLike(tmpNode) &&
+                tmpNode.type.name === currentMatchingSelectorPart.name
+              ) {
+                nextMatchingNodes.push(tmpNode);
+              }
+            }
+          }
+          // traverseIterator.throw &&
+          //   traverseIterator.throw(new Error("cleanup"));
+        } else if (
+          ["descendant", "child"].includes(currentMatchingSelectorPart.type)
+        ) {
+          // Handle traversal parts here - Save for look back in next part
+          lastRelationshipSelectorPart = currentMatchingSelectorPart;
+          // Preserve currentMatchingNodes
+          nextMatchingNodes.push(...currentMatchingNodes);
+        } else {
+          // For unhandled parts
+          lastRelationshipSelectorPart = undefined;
+        }
+      }
+
+      currentMatchingNodes = nextMatchingNodes;
+      currentMatchingSelectorPartIndex += 1;
+    }
+
+    for (const tmpNode of currentMatchingNodes) {
+      yield tmpNode;
+    }
+
+    return;
+  }
+}
+
+function matchAll(
+  node: FiberNode,
+  match: string | CSSWhat.Selector[][]
+): Array<FiberNode> {
+  return [...matchGenerator(node, match)];
+}
+
+function matchFirst(
+  node: FiberNode,
+  match: string | CSSWhat.Selector[][]
+): FiberNode | null {
+  const matchIterator = matchGenerator(node, match);
+  const firstResult = matchIterator.next();
+
+  // Cancel generator
+  matchIterator.throw && matchIterator.throw(new Error("Cleanup"));
+
+  // If match found, return that
+  if (!firstResult.done) {
+    return firstResult.value;
+  }
+
+  // Else return null
+  return null;
+}
+
+export { matchGenerator, matchAll, matchFirst };

src/traverse.ts

@@ -4,6 +4,7 @@ import { FiberNode } from "./mocked-types";
 interface TTraverseConfig {
   order?: Array<"self" | "child" | "sibling">;
   skipSiblingForStartNode?: boolean;
+  skipSelfForStartNode?: boolean;
 }
 
 /**
@@ -69,19 +70,23 @@ function* traverseGenerator(
   node: FiberNode,
   {
     order = ["self", "child", "sibling"],
-    skipSiblingForStartNode = true
+    skipSiblingForStartNode = true,
+    skipSelfForStartNode = false
   }: TTraverseConfig = {}
 ): IterableIterator<FiberNode> {
   let skipChild = false,
-    skipSibling = skipSiblingForStartNode;
+    skipSibling = skipSiblingForStartNode,
+    skipSelf = skipSelfForStartNode;
 
   function* traverseSelf() {
-    const controlInput:
-      | { skipChild?: boolean; skipSibling?: boolean }
-      | undefined = yield node;
+    if (!skipSelf) {
+      const controlInput:
+        | { skipChild?: boolean; skipSibling?: boolean }
+        | undefined = yield node;
 
-    if (controlInput !== undefined) {
-      ({ skipChild = skipChild, skipSibling = skipSibling } = controlInput);
+      if (controlInput !== undefined) {
+        ({ skipChild = skipChild, skipSibling = skipSibling } = controlInput);
+      }
     }
   }
 
@@ -90,7 +95,8 @@ function* traverseGenerator(
       const nextNode = node.child;
       yield* traverseGenerator(nextNode, {
         order,
-        skipSiblingForStartNode: false
+        skipSiblingForStartNode: false,
+        skipSelfForStartNode: false
       });
     }
   }
@@ -100,7 +106,8 @@ function* traverseGenerator(
       const nextNode = node.sibling;
       yield* traverseGenerator(nextNode, {
         order,
-        skipSiblingForStartNode: false
+        skipSiblingForStartNode: false,
+        skipSelfForStartNode: false
       });
     }
   }

src/utils.ts

@@ -89,7 +89,7 @@ function getRootFiberNodeFromDOM(startElement?: Element): FiberNode | null {
   }
 
   let returnFiberNode = null;
-  for (const childNode of startElement.children) {
+  for (const childNode of [].slice.call(startElement.children)) {
     returnFiberNode = getRootFiberNodeFromDOM(childNode);
     if (returnFiberNode !== null) {
       return returnFiberNode;

test/matchGenerator-basic.spec.tsx

@@ -0,0 +1,139 @@
+import * as React from "react";
+
+// Import stuff from src
+import {
+  // matchGenerator,
+  matchAll
+  // matchFirst
+} from "../src";
+
+import {
+  FiberNodeForComponentClass
+  // FiberNodeForInstrinsicElement,
+  // FiberNodeForFunctionComponent
+} from "../src/mocked-types";
+
+// Import test helpers and sample components
+import { mountAndGetRootNode } from "./utils/mountInEnzyme";
+import {
+  // createClassComponents,
+  // createFunctionComponents,
+  createClassComponent,
+  createClassComponents
+} from "./utils/createComponent";
+
+describe("matchGenerator", () => {
+  let container: HTMLDivElement;
+
+  beforeEach(() => {
+    container = document.body.appendChild(document.createElement("div"));
+  });
+
+  afterEach(() => {
+    document.body.removeChild(container);
+  });
+
+  describe("basic", () => {
+    it("should work for depth=1 class", () => {
+      const C1 = createClassComponent("C1");
+      function CRoot() {
+        return <C1 />;
+      }
+      const rootNode = mountAndGetRootNode(CRoot, container);
+
+      const nodes = matchAll(rootNode, "C1");
+
+      // Can't be zero, in any case
+      expect(nodes.length).not.toBe(0);
+      // Check that only one node is yielded
+      expect(nodes.length).toBe(1);
+      // Check that type is correct
+      expect((nodes[0] as FiberNodeForComponentClass).type).toBe(C1);
+    });
+
+    it("should work for depth=2 class", () => {
+      const [C1, C2] = createClassComponents(["C1", "C2"]);
+      function CRoot() {
+        return (
+          <C1>
+            <C2 />
+          </C1>
+        );
+      }
+      const rootNode = mountAndGetRootNode(CRoot, container);
+
+      const nodes = matchAll(rootNode, "C2");
+
+      // Can't be zero, in any case
+      expect(nodes.length).not.toBe(0);
+      // Check that only one node is yielded
+      expect(nodes.length).toBe(1);
+      // Check that type is correct
+      expect((nodes[0] as FiberNodeForComponentClass).type).toBe(C2);
+      expect((nodes[0] as FiberNodeForComponentClass).type).not.toBe(C1);
+    });
+
+    it("should work for depth=2 class with descendant selector", () => {
+      const [C1, C2] = createClassComponents(["C1", "C2"]);
+      function CRoot() {
+        return (
+          <C1>
+            <C2 />
+          </C1>
+        );
+      }
+      const rootNode = mountAndGetRootNode(CRoot, container);
+
+      const nodes = matchAll(rootNode, "C1 C2");
+
+      // Can't be zero, in any case
+      expect(nodes.length).not.toBe(0);
+      // Check that only one node is yielded
+      expect(nodes.length).toBe(1);
+      // Check that type is correct
+      expect((nodes[0] as FiberNodeForComponentClass).type).toBe(C2);
+      expect((nodes[0] as FiberNodeForComponentClass).type).not.toBe(C1);
+    });
+
+    it("should work for depth=2 class with child selector", () => {
+      const [C1, C2] = createClassComponents(["C1", "C2"]);
+      function CRoot() {
+        return (
+          <C1>
+            <C2 />
+          </C1>
+        );
+      }
+      const rootNode = mountAndGetRootNode(CRoot, container);
+
+      const nodes = matchAll(rootNode, "C1>C2");
+
+      // Can't be zero, in any case
+      expect(nodes.length).not.toBe(0);
+      // Check that only one node is yielded
+      expect(nodes.length).toBe(1);
+      // Check that type is correct
+      expect((nodes[0] as FiberNodeForComponentClass).type).toBe(C2);
+      expect((nodes[0] as FiberNodeForComponentClass).type).not.toBe(C1);
+    });
+
+    it("should not work with child selector for nth-level descendant", () => {
+      const [C1, C2, C3] = createClassComponents(["C1", "C2", "C3"]);
+      function CRoot() {
+        return (
+          <C1>
+            <C2>
+              <C3 />
+            </C2>
+          </C1>
+        );
+      }
+      const rootNode = mountAndGetRootNode(CRoot, container);
+
+      const nodes = matchAll(rootNode, "C1>C3");
+
+      // No matcch found
+      expect(nodes.length).toBe(0);
+    });
+  });
+});

tsconfig.base.json

@@ -17,7 +17,8 @@
     "removeComments": true,
     "sourceMap": true,
     "strict": true,
-    "target": "es6"
+    "target": "es5",
+    "downlevelIteration": true
   },
   "exclude": ["node_modules", "dist"],
   "include": ["src"]