[changed] deprecate domUtils as a public API

Author: jquense

src/Affix.js

@@ -1,12 +1,8 @@
 import React from 'react';
 import classNames from 'classnames';
 import AffixMixin from './AffixMixin';
-import domUtils from './utils/domUtils';
 
 const Affix = React.createClass({
-  statics: {
-    domUtils
-  },
 
   mixins: [AffixMixin],
 

src/index.js

@@ -1,3 +1,5 @@
+import deprecationWarning from './utils/deprecationWarning';
+
 export Accordion from './Accordion';
 export Affix from './Affix';
 export AffixMixin from './AffixMixin';
@@ -70,16 +72,36 @@ export Fade from './Collapse';
 
 export * as FormControls from './FormControls';
 
+import domUtils from './utils/domUtils';
 import childrenValueInputValidation from './utils/childrenValueInputValidation';
 import createChainedFunction from './utils/createChainedFunction';
-import domUtils from './utils/domUtils';
 import ValidComponentChildren from './utils/ValidComponentChildren';
 import CustomPropTypes from './utils/CustomPropTypes';
 
 export const utils = {
   childrenValueInputValidation,
   createChainedFunction,
-  domUtils,
   ValidComponentChildren,
-  CustomPropTypes
+  CustomPropTypes,
+  domUtils: createDeprecationWrapper(domUtils, 'utils/domUtils', 'npm install dom-helpers'),
 };
+
+function createDeprecationWrapper(obj, deprecated, instead, link){
+  let wrapper = {};
+
+  if (process.env.NODE_ENV === 'production'){
+    return obj;
+  }
+
+  Object.keys(obj).forEach(key => {
+    Object.defineProperty(wrapper, key, {
+      get(){
+        deprecationWarning(deprecated, instead, link);
+        return obj[key];
+      },
+      set(x){ obj[key] = x; }
+    });
+  });
+
+  return wrapper;
+}

src/utils/domUtils.js

@@ -23,6 +23,11 @@ function ownerWindow(componentOrElement) {
   return getOwnerWindow(doc);
 }
 
+//TODO remove in 0.26
+function getComputedStyles(elem) {
+  return ownerDocument(elem).defaultView.getComputedStyle(elem, null);
+}
+
 /**
  * Get an element's size
  *
@@ -45,6 +50,7 @@ function getSize(elem) {
 export default {
   canUseDom,
   css,
+  getComputedStyles,
   contains,
   ownerWindow,
   ownerDocument,

src/utils/index.js

@@ -2,7 +2,10 @@ import deprecationWarning from './deprecationWarning';
 
 export childrenValueInputValidation from './childrenValueInputValidation';
 export createChainedFunction from './createChainedFunction';
+
+deprecationWarning('utils/domUtils', 'npm install dom-helpers');
 export domUtils from './domUtils';
+
 export ValidComponentChildren from './ValidComponentChildren';
 
 deprecationWarning('utils/CustomPropTypes', 'npm install react-prop-types',

webpack/docs.config.js

@@ -21,6 +21,7 @@ if (options.debug) {
 }
 
 export default _.extend({}, baseConfig, {
+
   entry: {
     bundle: options.debug ? devEntryBundle : entryFile
   },