Feature/dependencies

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});

README.md

@@ -353,7 +353,8 @@ The structure of the JSON blob / JavaScript object is as follows:
  },
  ...
  },]
- ["composes": <componentNames>]
+ ["composes": <componentNames>],
+ ["dependencies": <componentNames>]
 }
 ```
 (`[...]` means the property may not exist if such information was not found in the component definition)

src/__tests__/main-test.js

@@ -40,6 +40,7 @@ describe('main', () => {
  required: false,
  },
  },
+ dependencies: ['div'],
  });
  });
 
@@ -76,6 +77,9 @@ describe('main', () => {
  propTypes,
  getDefaultProps: function() {
  return defaultProps;
+ },
+ render: function() {
+ return <div />
  }
  });
  module.exports = Component
@@ -103,6 +107,9 @@ describe('main', () => {
  export default class Component extends React.Component {
  static propTypes = propTypes;
  // ...
+ render () {
+ return <div />
+ }
  }
  Component.defaultProps = defaultProps;
  Component.displayName = 'ABC';

src/handlers/__tests__/componentDependencyHandler-test.js

@@ -0,0 +1,300 @@
+
+/*global jest, describe, it, expect, beforeEach*/
+
+jest.disableAutomock();
+jest.mock('../../Documentation');
+
+describe('componentDependencyHandler', () => {
+ var statement, expression;
+ var documentation;
+ var componentDependencyHandler;
+
+ beforeEach(() => {
+ ({statement, expression} = require('../../../tests/utils'));
+
+ documentation = new (require('../../Documentation'))();
+ componentDependencyHandler = require('../componentDependencyHandler').default;
+ });
+
+ function test(getSrc, parse) {
+ it('extracts dependencies', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('extracts dependencies with resolved root', () => {
+ var renderSrc = getSrc(`
+ var SubComponent = SubComponentx;
+ return React.createElement(SubComponent);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts dependencies with nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty)
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts dependencies with nested array components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponentz)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with multi-level nested components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: React.createElement(SubComponenty, {
+ children: React.createElement(SubComponentz)
+ }),
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('extracts dependencies with duplicated components', () => {
+ var renderSrc = getSrc(`
+ return React.createElement(SubComponentx, {
+ children: [
+ React.createElement(SubComponenty),
+ React.createElement(SubComponenty)
+ ]
+ });
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty']);
+ });
+
+ it('extracts only react components', () => {
+ var renderSrc = getSrc(`
+ var randomVar = getRandomVar(random);
+ return React.createElement(SubComponentx);
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx']);
+ });
+
+ it('extracts for jsx', () => {
+ var renderSrc = getSrc(`
+ const SubComponent = SubComponentx;
+ return (
+ <SubComponent>
+ <SubComponenty>
+ <SubComponentz />
+ </SubComponenty>
+ </SubComponent>
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx',
+ 'SubComponenty', 'SubComponentz']);
+ });
+
+ it('does not extract other identifiers', () => {
+ var renderSrc = getSrc(`
+ const somethingElse = true;
+ return (
+ <SubComponent />
+ )
+ `);
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+ }
+
+ describe('React.createClass', () => {
+ test(
+ renderSrc => `({ render: function() {${renderSrc}} })`,
+ src => statement(src).get('expression')
+ );
+ });
+
+ describe('class definition', () => {
+ test(
+ renderSrc => `
+ class Component {
+ render() {
+ ${renderSrc}
+ }
+ }
+ `,
+ src => statement(src)
+ );
+ });
+
+ describe('stateless function', () => {
+ test(
+ renderSrc => `
+ () => { ${renderSrc} }
+ `,
+ src => expression(src)
+ );
+ });
+
+ describe('Sub-rendering methods', () => {
+ const parse = src => statement(src)
+
+ it('handles external methods', () => {
+ const renderSrc = `
+ const Sub = () => <SubComponentx />
+ const Sub2 = () => <SubComponenty />
+ const Component = () => {
+ return <Sub><Sub2 /><div /></Sub>
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentx', 'SubComponenty', 'div'])
+ });
+
+ it('handles variable declarations', () => {
+ const renderSrc = `
+ import SubComponentz from '../SubComponentz/SubComponentz'
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponentz
+ const getX = () => <SubComponentx z='1' a={<div />} />
+ const Component = () => {
+ return getX()
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponentz', 'div']);
+ })
+
+ it('ignore non-jsx variables', () => {
+ const renderSrc = `
+ const x = 1
+ const y = x
+ const SubComponentx = SubComponenty
+ const Component = () => {
+ return <SubComponentx />
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponenty']);
+ })
+
+ it('handles class methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSub () {
+ return <SubComponent />
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['SubComponent']);
+ });
+
+ it('handles nested methods', () => {
+ const renderSrc = `
+ class Component {
+ renderSubz () {
+ return <div />
+ }
+ renderSuby () {
+ return <SubComponenty>{this.renderSubz()}</SubComponenty>
+ }
+ renderSub () {
+ return <SubComponentx>{this.renderSuby()}</SubComponentx>
+ }
+ render() {
+ return this.renderSub()
+ }
+ }
+ `
+
+ documentation = new (require('../../Documentation'))();
+ var definition = parse(renderSrc);
+
+ componentDependencyHandler(documentation, definition);
+ expect(documentation.dependencies).toEqual(['div', 'SubComponenty', 'SubComponentx']);
+ });
+ });
+
+ it('does not error if there are no dependencies', () => {
+ var definition = expression('{ render: function(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+
+ definition = statement('class Foo { render(){ return null } }');
+ expect(() => componentDependencyHandler(documentation, definition))
+ .not.toThrow();
+ });
+});