Function normalizeOptions

packages/cli/src/command-line.ts:400–560

(
  cliOptions: CliOptions,
  forcedAddOns?: Array<string>,
  opts?: {
    disableNameCheck?: boolean
    forcedDeployment?: string
  },
)

}

export async function normalizeOptions(
  cliOptions: CliOptions,
  forcedAddOns?: Array<string>,
  opts?: {
    disableNameCheck?: boolean
    forcedDeployment?: string
  },
): Promise<Options | undefined> {
  const projectLocation = resolveProjectLocation({
    projectName: cliOptions.projectName,
    targetDir: cliOptions.targetDir,
  })

  if (!projectLocation && !opts?.disableNameCheck) {
    return undefined
  }

  const projectName = projectLocation?.projectName ?? ''
  const targetDir = projectLocation?.targetDir ?? resolve(process.cwd())

  if (projectName) {
    const { valid, error } = validateProjectName(projectName)
    if (!valid) {
      console.error(error)
      process.exit(1)
    }
  }

  // Mode is always file-router (TanStack Start)
  let mode = 'file-router'
  let routerOnly = !!cliOptions.routerOnly

  const legacyTemplate = getLegacyTemplateValue(cliOptions.template)

  if (!cliOptions.starter) {
    if (cliOptions.template && !legacyTemplate) {
      cliOptions.starter = cliOptions.template
    } else if (cliOptions.templateId) {
      cliOptions.starter = cliOptions.templateId
    }
  }

  const template = legacyTemplate
  if (template && template !== 'file-router') {
    routerOnly = true
  }

  if (!cliOptions.starter && cliOptions.templateId) {
    cliOptions.starter = cliOptions.templateId
  }

  const preferredFramework = (cliOptions.framework || 'react').toLowerCase()

  const starter = !routerOnly && cliOptions.starter
    ? await loadStarter(
        await resolveStarterSpecifier(cliOptions.starter, preferredFramework),
      )
    : undefined