Function resolveStarterSpecifier

packages/cli/src/command-line.ts:142–211

(
  starterSpecifier: string,
  preferredFramework?: string,
)

}

export async function resolveStarterSpecifier(
  starterSpecifier: string,
  preferredFramework?: string,
) {
  const normalized = starterSpecifier.trim()

  if (!normalized || isLikelyStarterUrlOrPath(normalized)) {
    return normalized
  }

  const registry = await getRawRegistry()
  if (registry && registry.starters?.length) {
    const lookup = normalized.toLowerCase()
    const matches = registry.starters.filter((starter) => {
      const candidateIds = new Set<string>()
      candidateIds.add(starter.name.toLowerCase())
      candidateIds.add(slugifyStarterName(starter.name))

      for (const id of getStarterIdsFromUrl(starter.url)) {
        candidateIds.add(id)
      }

      return candidateIds.has(lookup)
    })

    const frameworkMatch = preferredFramework
      ? matches.find(
          (starter) => starter.framework.toLowerCase() === preferredFramework,
        )
      : undefined

    if (frameworkMatch) {
      return frameworkMatch.url
    }

    if (matches.length > 0) {
      return matches[0].url
    }
  }

  const monorepoStarterPath = resolveMonorepoStarterById(
    normalized,
    preferredFramework,
  )
  if (monorepoStarterPath) {
    return monorepoStarterPath
  }

  if (!registry || !registry.starters?.length) {
    throw new Error(
      `Could not resolve template id "${normalized}" because no template registry is configured. Pass a template URL (or set CTA_REGISTRY).`,
    )
  }

  const availableIds = Array.from(
    new Set(
      registry.starters.flatMap((starter) => {
        const ids = [slugifyStarterName(starter.name)]