feat(route): add children and parent to route record

.gitignore

@@ -8,3 +8,4 @@ dist/*.gz
 dist/*.map
 explorations
 docs/_book
+.vscode

flow/declarations.js

@@ -98,5 +98,7 @@ declare type Route = {
   fullPath: string;
   matched: Array<RouteRecord>;
   redirectedFrom?: string;
+  parent: ?RouteRecord;
+  children: Array<RouteConfig>;
   meta?: any;
 }

src/create-route-map.js

@@ -74,6 +74,7 @@ function addRouteRecord (
     path: normalizedPath,
     regex: compileRouteRegex(normalizedPath, pathToRegexpOptions),
     components: route.components || { default: route.component },
+    children: route.children || [],
     instances: {},
     name,
     parent,

src/util/route.js

@@ -21,6 +21,8 @@ export function createRoute (
   const route: Route = {
     name: location.name || (record && record.name),
     meta: (record && record.meta) || {},
+    children: (record && record.children) || [],
+    parent: (record && record.parent),
     path: location.path || '/',
     hash: location.hash || '',
     query,

test/unit/specs/create-map.spec.js

@@ -64,6 +64,18 @@ describe('Creating Route Map', function () {
     expect(maps.nameMap['bar.baz']).not.toBeUndefined()
   })
 
+  it('has baz route in children on bar route', () => {
+    expect(maps.nameMap.bar.children[0].name).toEqual('bar.baz')
+  })
+
+  it('has bar route in bar parent', () => {
+    expect(maps.nameMap['bar.baz'].parent.name).toEqual('bar')
+  })
+
+  it('has no parent on /', () => {
+    expect(maps.nameMap.home.parent).toEqual(undefined)
+  })
+
   it('in development, has logged a warning concerning named route of parent and default subroute', function () {
     process.env.NODE_ENV = 'development'
     maps = createRouteMap(routes)

test/unit/specs/create-matcher.spec.js

@@ -3,7 +3,14 @@ import { createMatcher } from '../../../src/create-matcher'
 
 const routes = [
   { path: '/', name: 'home', component: { name: 'home' }},
-  { path: '/foo', name: 'foo', component: { name: 'foo' }},
+  {
+    path: '/foo',
+    name: 'foo',
+    component: { name: 'foo' },
+    children: [
+      { path: '', name: 'foo.baz', component: { name: 'Baz' } }
+    ]
+  }
 ]
 
 describe('Creating Matcher', function () {
@@ -32,4 +39,25 @@ describe('Creating Matcher', function () {
     match({ name: 'foo' }, routes[0])
     expect(console.warn).not.toHaveBeenCalled()
   })
+
+  it('should return the matched route with children populated', () => {
+    const route = match({ name: 'foo' })
+    expect(route.children[0].name).toEqual('foo.baz')
+  })
+
+  it('should return the matched route with its parent', () => {
+    const route = match({ name: 'foo.baz' })
+    expect(route.parent.name).toEqual('foo')
+  })
+
+  it('should have an empty children array when no children', () => {
+    const route = match({ name: 'home' })
+    expect(route.children).toEqual([])
+  })
+
+  it('should return the matched route with its children', () => {
+    const route = match({ name: 'foo' })
+    expect(route.children.length).toEqual(1)
+    expect(route.children[0].name).toEqual('foo.baz')
+  })
 })