Initial

Author: jquense

.babelrc

@@ -0,0 +1,10 @@
+{
+  "presets": [
+    ["es2015", { "loose": true }],
+    "stage-1",
+    "react"
+  ],
+  "plugins": [
+    "add-module-exports"
+  ],
+}

.eslintrc

@@ -0,0 +1,9 @@
+{
+  extends: 'airbnb',
+  env: {
+    jest: true,
+  },
+  rules: {
+    "react/jsx-filename-extension": 0,
+  }
+}

.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+npm-debug.log

README.md

@@ -0,0 +1,4 @@
+react-element-children
+=====
+
+Utilities for iterating only valid React Elements

lib/index.js

@@ -0,0 +1,163 @@
+'use strict';
+
+exports.__esModule = true;
+exports.map = map;
+exports.forEach = forEach;
+exports.count = count;
+exports.filter = filter;
+exports.find = find;
+exports.every = every;
+exports.some = some;
+exports.toArray = toArray;
+
+var _react = require('react');
+
+var _react2 = _interopRequireDefault(_react);
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Iterates through children that are typically specified as `props.children`,
+ * but only maps over children that are "valid components".
+ *
+ * The mapFunction provided index will be normalised to the components mapped,
+ * so an invalid component would not increase the index.
+ *
+ * @param {?*} children Children tree container.
+ * @param {function(*, int)} func.
+ * @param {*} context Context for func.
+ * @return {object} Object containing the ordered map of results.
+ */
+function map(children, func, context) {
+  var index = 0;
+
+  return _react2.default.Children.map(children, function (child) {
+    if (!_react2.default.isValidElement(child)) {
+      return child;
+    }
+
+    return func.call(context, child, index++);
+  });
+}
+
+/**
+ * Iterates through children that are "valid components".
+ *
+ * The provided forEachFunc(child, index) will be called for each
+ * leaf child with the index reflecting the position relative to "valid components".
+ *
+ * @param {?*} children Children tree container.
+ * @param {function(*, int)} func.
+ * @param {*} context Context for context.
+ */
+function forEach(children, func, context) {
+  var index = 0;
+
+  _react2.default.Children.forEach(children, function (child) {
+    if (!_react2.default.isValidElement(child)) {
+      return;
+    }
+
+    func.call(context, child, index++);
+  });
+}
+
+/**
+ * Count the number of "valid components" in the Children container.
+ *
+ * @param {?*} children Children tree container.
+ * @returns {number}
+ */
+function count(children) {
+  var result = 0;
+
+  _react2.default.Children.forEach(children, function (child) {
+    if (!_react2.default.isValidElement(child)) {
+      return;
+    }
+
+    ++result;
+  });
+
+  return result;
+}
+
+/**
+ * Finds children that are typically specified as `props.children`,
+ * but only iterates over children that are "valid components".
+ *
+ * The provided forEachFunc(child, index) will be called for each
+ * leaf child with the index reflecting the position relative to "valid components".
+ *
+ * @param {?*} children Children tree container.
+ * @param {function(*, int)} func.
+ * @param {*} context Context for func.
+ * @returns {array} of children that meet the func return statement
+ */
+function filter(children, func, context) {
+  var result = [];
+
+  forEach(children, function (child, index) {
+    if (func.call(context, child, index)) {
+      result.push(child);
+    }
+  });
+
+  return result;
+}
+
+function find(children, func, context) {
+  var result = void 0;
+
+  forEach(children, function (child, index) {
+    if (result) {
+      return;
+    }
+    if (func.call(context, child, index)) {
+      result = child;
+    }
+  });
+
+  return result;
+}
+
+function every(children, func, context) {
+  var result = true;
+
+  forEach(children, function (child, index) {
+    if (!result) {
+      return;
+    }
+    if (!func.call(context, child, index)) {
+      result = false;
+    }
+  });
+
+  return result;
+}
+
+function some(children, func, context) {
+  var result = false;
+
+  forEach(children, function (child, index) {
+    if (result) {
+      return;
+    }
+
+    if (func.call(context, child, index)) {
+      result = true;
+    }
+  });
+
+  return result;
+}
+
+function toArray(children) {
+  var result = [];
+
+  forEach(children, function (child) {
+    result.push(child);
+  });
+
+  return result;
+}

package.json

@@ -0,0 +1,49 @@
+{
+  "name": "react-element-children",
+  "version": "1.0.0",
+  "description": "Utilities for iterating children elements",
+  "main": "index.js",
+  "scripts": {
+    "test": "eslint src && jest",
+    "tdd": "jest --watch=skip",
+    "build": "rm -rf lib/* && babel src --out-dir lib",
+    "release": "release"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/react-bootstrap/react-child-elements.git"
+  },
+  "author": "react-bootstrap contributors",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/react-bootstrap/react-child-elements/issues"
+  }
+  "homepage": "https://github.com/react-bootstrap/react-child-elements#readme",
+  "jest": {
+    "automock": false,
+    "testRegex": "tests/.*\\.js$"
+  },
+  "release-script": {
+    "altPkgRootFolder": "lib"
+  },
+  "peerDependencies": {
+    "react": "^15.0.0"
+  },
+  "devDependencies": {
+    "babel-cli": "^6.11.4",
+    "babel-jest": "^14.1.0",
+    "babel-plugin-add-module-exports": "^0.2.1",
+    "babel-polyfill": "^6.13.0",
+    "babel-preset-es2015": "^6.13.2",
+    "babel-preset-react": "^6.11.1",
+    "babel-preset-stage-1": "^6.13.0",
+    "eslint": "^3.2.2",
+    "eslint-config-airbnb": "^10.0.0",
+    "eslint-plugin-import": "^1.13.0",
+    "eslint-plugin-jsx-a11y": "^2.1.0",
+    "eslint-plugin-react": "^6.0.0",
+    "jest-cli": "^14.1.0",
+    "react": "^15.3.0",
+    "release-script": "^1.0.2"
+  }
+}

src/index.js

@@ -0,0 +1,147 @@
+import React from 'react';
+
+/**
+ * Iterates through children that are typically specified as `props.children`,
+ * but only maps over children that are "valid components".
+ *
+ * The mapFunction provided index will be normalised to the components mapped,
+ * so an invalid component would not increase the index.
+ *
+ * @param {?*} children Children tree container.
+ * @param {function(*, int)} func.
+ * @param {*} context Context for func.
+ * @return {object} Object containing the ordered map of results.
+ */
+export function map(children, func, context) {
+  let index = 0;
+
+  return React.Children.map(children, child => {
+    if (!React.isValidElement(child)) {
+      return child;
+    }
+
+    return func.call(context, child, index++);
+  });
+}
+
+/**
+ * Iterates through children that are "valid components".
+ *
+ * The provided forEachFunc(child, index) will be called for each
+ * leaf child with the index reflecting the position relative to "valid components".
+ *
+ * @param {?*} children Children tree container.
+ * @param {function(*, int)} func.
+ * @param {*} context Context for context.
+ */
+export function forEach(children, func, context) {
+  let index = 0;
+
+  React.Children.forEach(children, child => {
+    if (!React.isValidElement(child)) {
+      return;
+    }
+
+    func.call(context, child, index++);
+  });
+}
+
+/**
+ * Count the number of "valid components" in the Children container.
+ *
+ * @param {?*} children Children tree container.
+ * @returns {number}
+ */
+export function count(children) {
+  let result = 0;
+
+  React.Children.forEach(children, child => {
+    if (!React.isValidElement(child)) {
+      return;
+    }
+
+    ++result;
+  });
+
+  return result;
+}
+
+/**
+ * Finds children that are typically specified as `props.children`,
+ * but only iterates over children that are "valid components".
+ *
+ * The provided forEachFunc(child, index) will be called for each
+ * leaf child with the index reflecting the position relative to "valid components".
+ *
+ * @param {?*} children Children tree container.
+ * @param {function(*, int)} func.
+ * @param {*} context Context for func.
+ * @returns {array} of children that meet the func return statement
+ */
+export function filter(children, func, context) {
+  const result = [];
+
+  forEach(children, (child, index) => {
+    if (func.call(context, child, index)) {
+      result.push(child);
+    }
+  });
+
+  return result;
+}
+
+export function find(children, func, context) {
+  let result;
+
+  forEach(children, (child, index) => {
+    if (result) {
+      return;
+    }
+    if (func.call(context, child, index)) {
+      result = child;
+    }
+  });
+
+  return result;
+}
+
+export function every(children, func, context) {
+  let result = true;
+
+  forEach(children, (child, index) => {
+    if (!result) {
+      return;
+    }
+    if (!func.call(context, child, index)) {
+      result = false;
+    }
+  });
+
+  return result;
+}
+
+export function some(children, func, context) {
+  let result = false;
+
+  forEach(children, (child, index) => {
+    if (result) {
+      return;
+    }
+
+    if (func.call(context, child, index)) {
+      result = true;
+    }
+  });
+
+  return result;
+}
+
+export function toArray(children) {
+  const result = [];
+
+  forEach(children, child => {
+    result.push(child);
+  });
+
+  return result;
+}