one/src/router/getLinkingConfig.test.ts

One is a React framework for web, iOS, and Android apps.

import { describe, expect, it } from 'vitest'
import { normalizeLinkingConfig } from '../link/getLinking'
import { getRoutes } from './getRoutes'
import { getLinkingConfig } from './getLinkingConfig'
import { getMockContext } from '../testing-utils'

describe('getLinkingConfig', () => {
  it('expands configured schemes into prefixes', () => {
    const routes = getRoutes(getMockContext(['_layout.tsx', 'index.tsx']))!
    const linking = getLinkingConfig(routes, true, {
      scheme: 'threepunchconvo',
    })

    expect(linking.prefixes).toEqual(['threepunchconvo://', 'threepunchconvo:///'])
  })

  it('merges explicit prefixes with scheme-derived prefixes', () => {
    const routes = getRoutes(getMockContext(['_layout.tsx', 'index.tsx']))!
    const linking = getLinkingConfig(routes, true, {
      scheme: 'threepunchconvo',
      prefixes: ['threepunchconvo://app'],
    })

    expect(linking.prefixes).toEqual([
      'threepunchconvo://',
      'threepunchconvo:///',
      'threepunchconvo://app',
    ])
  })

  it('assigns distinct navigation names to nested routes with the same file name', () => {
    const routes = getRoutes(
      getMockContext(['_layout.tsx', 'index/_layout.tsx', 'index/index.tsx'])
    )!
    const linking = getLinkingConfig(routes, true)
    const state = linking.getStateFromPath!('/', linking.config as never)!
    const parent = state.routes[0]!
    const child = parent.state!.routes[0]!

    expect(parent.name).not.toBe(child.name)
    expect(linking.getPathFromState!(state, linking.config as never)).toBe('/')
  })

  it('provides cold nested dynamic and catch-all params to every matched native route', () => {
    const routes = getRoutes(
      getMockContext([
        '_layout.tsx',
        'home/_layout.tsx',
        'home/[projectId]/_layout.tsx',
        'home/[projectId]/files/[...path].tsx',
      ])
    )!
    const linking = getLinkingConfig(routes, true)
    const state = linking.getStateFromPath!(
      '/home/retained/files/first/second?mode=local',
      linking.config as never
    )!
    let route = state.routes[0]!
    let matched = 0
    while (true) {
      expect(route.params).toMatchObject({
        projectId: 'retained',
        path: ['first', 'second'],
      })
      matched++
      if (!route.state) break
      route = route.state.routes[route.state.index ?? 0]!
    }
    expect(matched).toBe(3)
    expect(route.params).toMatchObject({ mode: 'local' })
  })
})

describe('normalizeLinkingConfig', () => {
  it('merges manifest-default prefixes with user-supplied scheme/prefixes', () => {
    const result = normalizeLinkingConfig(
      { scheme: 'foo', prefixes: ['https://example.test/app'] },
      ['bar://', 'bar:///']
    )

    expect(result.prefixes).toEqual([
      'bar://',
      'bar:///',
      'foo://',
      'foo:///',
      'https://example.test/app',
    ])
  })

  it('falls back to manifest-default prefixes when nothing is configured', () => {
    const result = normalizeLinkingConfig(undefined, ['bar://', 'bar:///'])
    expect(result.prefixes).toEqual(['bar://', 'bar:///'])
  })

  it('dedupes overlapping defaults and configured prefixes', () => {
    const result = normalizeLinkingConfig({ scheme: 'foo' }, ['foo://', 'foo:///'])
    expect(result.prefixes).toEqual(['foo://', 'foo:///'])
  })
})