kdu-router 2.7.0 → 3.0.0

package/src/index.js

@@ -1,235 +0,0 @@
-/* @flow */
-
-import { install } from './install'
-import { START } from './util/route'
-import { assert } from './util/warn'
-import { inBrowser } from './util/dom'
-import { cleanPath } from './util/path'
-import { createMatcher } from './create-matcher'
-import { normalizeLocation } from './util/location'
-import { supportsPushState } from './util/push-state'
-
-import { HashHistory } from './history/hash'
-import { HTML5History } from './history/html5'
-import { AbstractHistory } from './history/abstract'
-
-import type { Matcher } from './create-matcher'
-
-export default class KduRouter {
-  static install: () => void;
-  static version: string;
-
-  app: any;
-  apps: Array<any>;
-  ready: boolean;
-  readyCbs: Array<Function>;
-  options: RouterOptions;
-  mode: string;
-  history: HashHistory | HTML5History | AbstractHistory;
-  matcher: Matcher;
-  fallback: boolean;
-  beforeHooks: Array<?NavigationGuard>;
-  resolveHooks: Array<?NavigationGuard>;
-  afterHooks: Array<?AfterNavigationHook>;
-
-  constructor (options: RouterOptions = {}) {
-    this.app = null
-    this.apps = []
-    this.options = options
-    this.beforeHooks = []
-    this.resolveHooks = []
-    this.afterHooks = []
-    this.matcher = createMatcher(options.routes || [], this)
-
-    let mode = options.mode || 'hash'
-    this.fallback = mode === 'history' && !supportsPushState && options.fallback !== false
-    if (this.fallback) {
-      mode = 'hash'
-    }
-    if (!inBrowser) {
-      mode = 'abstract'
-    }
-    this.mode = mode
-
-    switch (mode) {
-      case 'history':
-        this.history = new HTML5History(this, options.base)
-        break
-      case 'hash':
-        this.history = new HashHistory(this, options.base, this.fallback)
-        break
-      case 'abstract':
-        this.history = new AbstractHistory(this, options.base)
-        break
-      default:
-        if (process.env.NODE_ENV !== 'production') {
-          assert(false, `invalid mode: ${mode}`)
-        }
-    }
-  }
-
-  match (
-    raw: RawLocation,
-    current?: Route,
-    redirectedFrom?: Location
-  ): Route {
-    return this.matcher.match(raw, current, redirectedFrom)
-  }
-
-  get currentRoute (): ?Route {
-    return this.history && this.history.current
-  }
-
-  init (app: any /* Kdu component instance */) {
-    process.env.NODE_ENV !== 'production' && assert(
-      install.installed,
-      `not installed. Make sure to call \`Kdu.use(KduRouter)\` ` +
-      `before creating root instance.`
-    )
-
-    this.apps.push(app)
-
-    // main app already initialized.
-    if (this.app) {
-      return
-    }
-
-    this.app = app
-
-    const history = this.history
-
-    if (history instanceof HTML5History) {
-      history.transitionTo(history.getCurrentLocation())
-    } else if (history instanceof HashHistory) {
-      const setupHashListener = () => {
-        history.setupListeners()
-      }
-      history.transitionTo(
-        history.getCurrentLocation(),
-        setupHashListener,
-        setupHashListener
-      )
-    }
-
-    history.listen(route => {
-      this.apps.forEach((app) => {
-        app._route = route
-      })
-    })
-  }
-
-  beforeEach (fn: Function): Function {
-    return registerHook(this.beforeHooks, fn)
-  }
-
-  beforeResolve (fn: Function): Function {
-    return registerHook(this.resolveHooks, fn)
-  }
-
-  afterEach (fn: Function): Function {
-    return registerHook(this.afterHooks, fn)
-  }
-
-  onReady (cb: Function, errorCb?: Function) {
-    this.history.onReady(cb, errorCb)
-  }
-
-  onError (errorCb: Function) {
-    this.history.onError(errorCb)
-  }
-
-  push (location: RawLocation, onComplete?: Function, onAbort?: Function) {
-    this.history.push(location, onComplete, onAbort)
-  }
-
-  replace (location: RawLocation, onComplete?: Function, onAbort?: Function) {
-    this.history.replace(location, onComplete, onAbort)
-  }
-
-  go (n: number) {
-    this.history.go(n)
-  }
-
-  back () {
-    this.go(-1)
-  }
-
-  forward () {
-    this.go(1)
-  }
-
-  getMatchedComponents (to?: RawLocation | Route): Array<any> {
-    const route: any = to
-      ? to.matched
-        ? to
-        : this.resolve(to).route
-      : this.currentRoute
-    if (!route) {
-      return []
-    }
-    return [].concat.apply([], route.matched.map(m => {
-      return Object.keys(m.components).map(key => {
-        return m.components[key]
-      })
-    }))
-  }
-
-  resolve (
-    to: RawLocation,
-    current?: Route,
-    append?: boolean
-  ): {
-    location: Location,
-    route: Route,
-    href: string,
-    // for backwards compat
-    normalizedTo: Location,
-    resolved: Route
-  } {
-    const location = normalizeLocation(
-      to,
-      current || this.history.current,
-      append,
-      this
-    )
-    const route = this.match(location, current)
-    const fullPath = route.redirectedFrom || route.fullPath
-    const base = this.history.base
-    const href = createHref(base, fullPath, this.mode)
-    return {
-      location,
-      route,
-      href,
-      // for backwards compat
-      normalizedTo: location,
-      resolved: route
-    }
-  }
-
-  addRoutes (routes: Array<RouteConfig>) {
-    this.matcher.addRoutes(routes)
-    if (this.history.current !== START) {
-      this.history.transitionTo(this.history.getCurrentLocation())
-    }
-  }
-}
-
-function registerHook (list: Array<any>, fn: Function): Function {
-  list.push(fn)
-  return () => {
-    const i = list.indexOf(fn)
-    if (i > -1) list.splice(i, 1)
-  }
-}
-
-function createHref (base: string, fullPath: string, mode) {
-  var path = mode === 'hash' ? '#' + fullPath : fullPath
-  return base ? cleanPath(base + '/' + path) : path
-}
-
-KduRouter.install = install
-KduRouter.version = '__VERSION__'
-
-if (inBrowser && window.Kdu) {
-  window.Kdu.use(KduRouter)
-}

package/src/install.js

@@ -1,52 +0,0 @@
-import View from './components/view'
-import Link from './components/link'
-
-export let _Kdu
-
-export function install (Kdu) {
-  if (install.installed) return
-  install.installed = true
-
-  _Kdu = Kdu
-
-  const isDef = v => v !== undefined
-
-  const registerInstance = (vm, callVal) => {
-    let i = vm.$options._parentVnode
-    if (isDef(i) && isDef(i = i.data) && isDef(i = i.registerRouteInstance)) {
-      i(vm, callVal)
-    }
-  }
-
-  Kdu.mixin({
-    beforeCreate () {
-      if (isDef(this.$options.router)) {
-        this._routerRoot = this
-        this._router = this.$options.router
-        this._router.init(this)
-        Kdu.util.defineReactive(this, '_route', this._router.history.current)
-      } else {
-        this._routerRoot = (this.$parent && this.$parent._routerRoot) || this
-      }
-      registerInstance(this, this)
-    },
-    destroyed () {
-      registerInstance(this)
-    }
-  })
-
-  Object.defineProperty(Kdu.prototype, '$router', {
-    get () { return this._routerRoot._router }
-  })
-
-  Object.defineProperty(Kdu.prototype, '$route', {
-    get () { return this._routerRoot._route }
-  })
-
-  Kdu.component('router-view', View)
-  Kdu.component('router-link', Link)
-
-  const strats = Kdu.config.optionMergeStrategies
-  // use the same hook merging strategy for route hooks
-  strats.beforeRouteEnter = strats.beforeRouteLeave = strats.beforeRouteUpdate = strats.created
-}

package/src/util/async.js

@@ -1,18 +0,0 @@
-/* @flow */
-
-export function runQueue (queue: Array<?NavigationGuard>, fn: Function, cb: Function) {
-  const step = index => {
-    if (index >= queue.length) {
-      cb()
-    } else {
-      if (queue[index]) {
-        fn(queue[index], () => {
-          step(index + 1)
-        })
-      } else {
-        step(index + 1)
-      }
-    }
-  }
-  step(0)
-}

package/src/util/dom.js

@@ -1,3 +0,0 @@
-/* @flow */
-
-export const inBrowser = typeof window !== 'undefined'

package/src/util/location.js

@@ -1,68 +0,0 @@
-/* @flow */
-
-import type KduRouter from '../index'
-import { parsePath, resolvePath } from './path'
-import { resolveQuery } from './query'
-import { fillParams } from './params'
-import { warn } from './warn'
-
-export function normalizeLocation (
-  raw: RawLocation,
-  current: ?Route,
-  append: ?boolean,
-  router: ?KduRouter
-): Location {
-  let next: Location = typeof raw === 'string' ? { path: raw } : raw
-  // named target
-  if (next.name || next._normalized) {
-    return next
-  }
-
-  // relative params
-  if (!next.path && next.params && current) {
-    next = assign({}, next)
-    next._normalized = true
-    const params: any = assign(assign({}, current.params), next.params)
-    if (current.name) {
-      next.name = current.name
-      next.params = params
-    } else if (current.matched.length) {
-      const rawPath = current.matched[current.matched.length - 1].path
-      next.path = fillParams(rawPath, params, `path ${current.path}`)
-    } else if (process.env.NODE_ENV !== 'production') {
-      warn(false, `relative params navigation requires a current route.`)
-    }
-    return next
-  }
-
-  const parsedPath = parsePath(next.path || '')
-  const basePath = (current && current.path) || '/'
-  const path = parsedPath.path
-    ? resolvePath(parsedPath.path, basePath, append || next.append)
-    : basePath
-
-  const query = resolveQuery(
-    parsedPath.query,
-    next.query,
-    router && router.options.parseQuery
-  )
-
-  let hash = next.hash || parsedPath.hash
-  if (hash && hash.charAt(0) !== '#') {
-    hash = `#${hash}`
-  }
-
-  return {
-    _normalized: true,
-    path,
-    query,
-    hash
-  }
-}
-
-function assign (a, b) {
-  for (const key in b) {
-    a[key] = b[key]
-  }
-  return a
-}

package/src/util/params.js

@@ -1,26 +0,0 @@
-/* @flow */
-
-import { warn } from './warn'
-import Regexp from 'path-to-regexp'
-
-const regexpCompileCache: {
-  [key: string]: Function
-} = Object.create(null)
-
-export function fillParams (
-  path: string,
-  params: ?Object,
-  routeMsg: string
-): string {
-  try {
-    const filler =
-      regexpCompileCache[path] ||
-      (regexpCompileCache[path] = Regexp.compile(path))
-    return filler(params || {}, { pretty: true })
-  } catch (e) {
-    if (process.env.NODE_ENV !== 'production') {
-      warn(false, `missing param for ${routeMsg}: ${e.message}`)
-    }
-    return ''
-  }
-}

package/src/util/path.js

@@ -1,74 +0,0 @@
-/* @flow */
-
-export function resolvePath (
-  relative: string,
-  base: string,
-  append?: boolean
-): string {
-  const firstChar = relative.charAt(0)
-  if (firstChar === '/') {
-    return relative
-  }
-
-  if (firstChar === '?' || firstChar === '#') {
-    return base + relative
-  }
-
-  const stack = base.split('/')
-
-  // remove trailing segment if:
-  // - not appending
-  // - appending to trailing slash (last segment is empty)
-  if (!append || !stack[stack.length - 1]) {
-    stack.pop()
-  }
-
-  // resolve relative path
-  const segments = relative.replace(/^\//, '').split('/')
-  for (let i = 0; i < segments.length; i++) {
-    const segment = segments[i]
-    if (segment === '..') {
-      stack.pop()
-    } else if (segment !== '.') {
-      stack.push(segment)
-    }
-  }
-
-  // ensure leading slash
-  if (stack[0] !== '') {
-    stack.unshift('')
-  }
-
-  return stack.join('/')
-}
-
-export function parsePath (path: string): {
-  path: string;
-  query: string;
-  hash: string;
-} {
-  let hash = ''
-  let query = ''
-
-  const hashIndex = path.indexOf('#')
-  if (hashIndex >= 0) {
-    hash = path.slice(hashIndex)
-    path = path.slice(0, hashIndex)
-  }
-
-  const queryIndex = path.indexOf('?')
-  if (queryIndex >= 0) {
-    query = path.slice(queryIndex + 1)
-    path = path.slice(0, queryIndex)
-  }
-
-  return {
-    path,
-    query,
-    hash
-  }
-}
-
-export function cleanPath (path: string): string {
-  return path.replace(/\/\//g, '/')
-}

package/src/util/push-state.js

@@ -1,59 +0,0 @@
-/* @flow */
-
-import { inBrowser } from './dom'
-import { saveScrollPosition } from './scroll'
-
-export const supportsPushState = inBrowser && (function () {
-  const ua = window.navigator.userAgent
-
-  if (
-    (ua.indexOf('Android 2.') !== -1 || ua.indexOf('Android 4.0') !== -1) &&
-    ua.indexOf('Mobile Safari') !== -1 &&
-    ua.indexOf('Chrome') === -1 &&
-    ua.indexOf('Windows Phone') === -1
-  ) {
-    return false
-  }
-
-  return window.history && 'pushState' in window.history
-})()
-
-// use User Timing api (if present) for more accurate key precision
-const Time = inBrowser && window.performance && window.performance.now
-  ? window.performance
-  : Date
-
-let _key: string = genKey()
-
-function genKey (): string {
-  return Time.now().toFixed(3)
-}
-
-export function getStateKey () {
-  return _key
-}
-
-export function setStateKey (key: string) {
-  _key = key
-}
-
-export function pushState (url?: string, replace?: boolean) {
-  saveScrollPosition()
-  // try...catch the pushState call to get around Safari
-  // DOM Exception 18 where it limits to 100 pushState calls
-  const history = window.history
-  try {
-    if (replace) {
-      history.replaceState({ key: _key }, '', url)
-    } else {
-      _key = genKey()
-      history.pushState({ key: _key }, '', url)
-    }
-  } catch (e) {
-    window.location[replace ? 'replace' : 'assign'](url)
-  }
-}
-
-export function replaceState (url?: string) {
-  pushState(url, true)
-}

package/src/util/query.js

@@ -1,96 +0,0 @@
-/* @flow */
-
-import { warn } from './warn'
-
-const encodeReserveRE = /[!'()*]/g
-const encodeReserveReplacer = c => '%' + c.charCodeAt(0).toString(16)
-const commaRE = /%2C/g
-
-// fixed encodeURIComponent which is more conformant to RFC3986:
-// - escapes [!'()*]
-// - preserve commas
-const encode = str => encodeURIComponent(str)
-  .replace(encodeReserveRE, encodeReserveReplacer)
-  .replace(commaRE, ',')
-
-const decode = decodeURIComponent
-
-export function resolveQuery (
-  query: ?string,
-  extraQuery: Dictionary<string> = {},
-  _parseQuery: ?Function
-): Dictionary<string> {
-  const parse = _parseQuery || parseQuery
-  let parsedQuery
-  try {
-    parsedQuery = parse(query || '')
-  } catch (e) {
-    process.env.NODE_ENV !== 'production' && warn(false, e.message)
-    parsedQuery = {}
-  }
-  for (const key in extraQuery) {
-    const val = extraQuery[key]
-    parsedQuery[key] = Array.isArray(val) ? val.slice() : val
-  }
-  return parsedQuery
-}
-
-function parseQuery (query: string): Dictionary<string> {
-  const res = {}
-
-  query = query.trim().replace(/^(\?|#|&)/, '')
-
-  if (!query) {
-    return res
-  }
-
-  query.split('&').forEach(param => {
-    const parts = param.replace(/\+/g, ' ').split('=')
-    const key = decode(parts.shift())
-    const val = parts.length > 0
-      ? decode(parts.join('='))
-      : null
-
-    if (res[key] === undefined) {
-      res[key] = val
-    } else if (Array.isArray(res[key])) {
-      res[key].push(val)
-    } else {
-      res[key] = [res[key], val]
-    }
-  })
-
-  return res
-}
-
-export function stringifyQuery (obj: Dictionary<string>): string {
-  const res = obj ? Object.keys(obj).map(key => {
-    const val = obj[key]
-
-    if (val === undefined) {
-      return ''
-    }
-
-    if (val === null) {
-      return encode(key)
-    }
-
-    if (Array.isArray(val)) {
-      const result = []
-      val.forEach(val2 => {
-        if (val2 === undefined) {
-          return
-        }
-        if (val2 === null) {
-          result.push(encode(key))
-        } else {
-          result.push(encode(key) + '=' + encode(val2))
-        }
-      })
-      return result.join('&')
-    }
-
-    return encode(key) + '=' + encode(val)
-  }).filter(x => x.length > 0).join('&') : null
-  return res ? `?${res}` : ''
-}