@generaltranslation/vue-extractor 0.0.0 → 0.1.0-iris.0

package/dist/internal/project/extractFromVueProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractFromVueProject.js","names":[],"sources":["../../../src/internal/project/extractFromVueProject.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport type { JsxChildren } from '@generaltranslation/format/types';\nimport fg from 'fast-glob';\nimport { hashSource } from 'generaltranslation/id';\nimport {\n  createDiagnosticMessage,\n  formatDiagnosticErrorDetails,\n} from 'generaltranslation/internal';\nimport { extractFromVueSource } from '../extractFromVueSource.js';\nimport {\n  resolveVueCompilerOptions,\n  type VueCompilerOptionsResolution,\n} from '../config/resolveVueCompilerOptions.js';\nimport { NUXT_CONFIG_FILES, VITE_CONFIG_FILES } from '../config/configFiles.js';\nimport {\n  createProjectModuleResolver,\n  DEFAULT_RESOLUTION_CONDITIONS,\n  loadExplicitTypeScriptConfig,\n} from './moduleResolver.js';\nimport { resolveVueProjectAliasConfiguration } from './viteAliases.js';\nimport {\n  declaresInstalledJavaScriptDependency,\n  GT_VUE_PACKAGE,\n  readJavaScriptPackageManifest,\n} from './manifest.js';\nimport {\n  discoverVueProject,\n  findVueSourceScope,\n  readDefaultVueSourcePatterns,\n  resolveProjectDirectory,\n  type VueSourceScope,\n} from './scopes.js';\nimport {\n  isVueSfcSource,\n  readVueProjectInspection,\n} from './inspectVueProject.js';\nimport type {\n  VueCompilerOptions,\n  VueExtractionOutput,\n  VueExtractionResult,\n  VueProjectExtractionOptions,\n  VueProjectExtractionOutput,\n  VueProjectExtractionResult,\n  VueSourceCode,\n} from '../../types.js';\n\nconst SCRIPT_EXTENSIONS = new Set([\n  '.js',\n  '.jsx',\n  '.mjs',\n  '.cjs',\n  '.ts',\n  '.tsx',\n  '.mts',\n  '.cts',\n]);\n\nconst JSX_CONFIG_EXTENSIONS = new Set(['.jsx', '.tsx']);\n\n/**\n * Extracts, hashes, and deduplicates every gt-vue message owned by a project.\n *\n * This is the package-level orchestration boundary used by host CLIs. It owns\n * workspace discovery, source matching, compiler/config resolution, static\n * module resolution, and catalog hashing so framework hosts do not need Vue\n * implementation details. Configuration failures return no partial updates.\n */\nexport async function extractFromVueProject(\n  options: VueProjectExtractionOptions = {}\n): Promise<VueProjectExtractionOutput> {\n  const projectRoot = resolveProjectDirectory(\n    options.cwd ?? options.inspection?.projectRoot ?? process.cwd()\n  );\n  const discovery =\n    readVueProjectInspection(options.inspection, projectRoot) ??\n    discoverVueProject(projectRoot);\n  const discoveryErrors =\n    options.filePatterns === undefined\n      ? validateNuxtSourceScopes(discovery.scopes, options.vueCompilerOptions)\n      : [];\n  if (discoveryErrors.length > 0) {\n    return { updates: [], errors: discoveryErrors, warnings: [] };\n  }\n  const patterns =\n    options.filePatterns ?? readDefaultVueSourcePatterns(discovery.scopes);\n  if (patterns.length === 0) {\n    return { updates: [], errors: [], warnings: [] };\n  }\n\n  const fileMatches = matchProjectFiles(projectRoot, patterns);\n  if (fileMatches.errors.length > 0) {\n    return { updates: [], errors: fileMatches.errors, warnings: [] };\n  }\n  const matchedFiles = fileMatches.files;\n  const scopes = addExplicitSourceScopes(\n    projectRoot,\n    discovery.scopes,\n    options.filePatterns === undefined ? [] : matchedFiles\n  );\n  const sourceByFile = new Map<string, string>();\n  const standaloneResults = new Map<string, VueExtractionOutput>();\n  const fileScopes = new Map(\n    matchedFiles.map((file) => [file, findVueSourceScope(file, scopes)])\n  );\n  // Explicit globs can also match files owned by another framework package.\n  // They are not Vue inputs unless discovery placed them in a Vue scope.\n  const ownedFiles = matchedFiles.filter(\n    (file) => fileScopes.get(file) !== undefined\n  );\n  const files = await filterVueSourceFiles(ownedFiles, sourceByFile);\n  if (files.length === 0) {\n    return { updates: [], errors: [], warnings: [] };\n  }\n  const errors: string[] = [];\n  const warnings = new Set<string>();\n  const tsconfigPath = resolveExplicitTypeScriptConfigPath(\n    projectRoot,\n    options.tsconfigPath,\n    errors\n  );\n  if (errors.length > 0) {\n    return { updates: [], errors, warnings: [] };\n  }\n  let explicitCompilerResolution = validateExplicitCompilerConfig(\n    projectRoot,\n    options,\n    files.some((file) => path.extname(file).toLowerCase() === '.vue'),\n    errors\n  );\n  if (errors.length > 0) {\n    return { updates: [], errors, warnings: [] };\n  }\n\n  const moduleResolution = createVueModuleResolver(\n    projectRoot,\n    scopes,\n    fileScopes,\n    options,\n    createProjectModuleResolver(\n      options.conditionNames ?? DEFAULT_RESOLUTION_CONDITIONS,\n      { tsconfigPath }\n    )\n  );\n  errors.push(...moduleResolution.errors);\n  if (errors.length > 0) {\n    return { updates: [], errors, warnings: [] };\n  }\n  const resolveModuleForFile = moduleResolution.resolveModuleForFile;\n\n  for (const file of files) {\n    const extension = path.extname(file).toLowerCase();\n    if (extension !== '.vue' && !SCRIPT_EXTENSIONS.has(extension)) continue;\n    let source = sourceByFile.get(file);\n    if (source === undefined) {\n      try {\n        source = await fs.promises.readFile(file, 'utf8');\n      } catch (error) {\n        errors.push(createReadDiagnostic(projectRoot, file, error));\n        continue;\n      }\n      sourceByFile.set(file, source);\n    }\n    if (extension === '.vue') continue;\n    standaloneResults.set(\n      file,\n      await extractFromVueSource(source, file, {\n        compilerOptions: {},\n        includeSourceCodeContext: options.includeSourceCodeContext,\n        projectRoot,\n        requireGTProvenance: true,\n        resolveModule: resolveModuleForFile(file),\n        surroundingLineCount: options.surroundingLineCount,\n      })\n    );\n  }\n\n  if (\n    explicitCompilerResolution === undefined &&\n    [...standaloneResults.values()].some(hasExtractionSignal)\n  ) {\n    explicitCompilerResolution = validateExplicitCompilerConfig(\n      projectRoot,\n      options,\n      true,\n      errors\n    );\n  }\n\n  const potentialAliasProvenanceScopes = await probePotentialAliasProvenance(\n    files,\n    sourceByFile,\n    fileScopes,\n    standaloneResults,\n    moduleResolution.resolvePotentialModulesForFile,\n    projectRoot\n  );\n\n  validateIncompleteAliasScopes(\n    files,\n    fileScopes,\n    standaloneResults,\n    moduleResolution.incompleteAliasScopes,\n    potentialAliasProvenanceScopes,\n    errors\n  );\n\n  // I/O failures make project discovery incomplete, so never return a partial\n  // catalog that a caller could mistake for a successful extraction.\n  if (errors.length > 0) {\n    return { updates: [], errors, warnings: [] };\n  }\n\n  const configAffectedFiles = files.filter((file) => {\n    const extension = path.extname(file).toLowerCase();\n    if (extension === '.vue') return true;\n    const standaloneResult = standaloneResults.get(file);\n    return (\n      hasExtractionSignal(standaloneResult) &&\n      (JSX_CONFIG_EXTENSIONS.has(extension) ||\n        standaloneResult?.results.some(\n          ({ dataFormat }) => dataFormat === 'JSX'\n        ) === true)\n    );\n  });\n  const compilerOptionsByScope = resolveCompilerOptionsByScope(\n    projectRoot,\n    configAffectedFiles,\n    fileScopes,\n    scopes,\n    options,\n    explicitCompilerResolution,\n    errors\n  );\n  if (errors.length > 0) {\n    return { updates: [], errors, warnings: [] };\n  }\n\n  const results: VueExtractionResult[] = [];\n  for (const file of files) {\n    const extension = path.extname(file).toLowerCase();\n    if (extension !== '.vue' && !SCRIPT_EXTENSIONS.has(extension)) continue;\n    const source = sourceByFile.get(file);\n    if (source === undefined) continue;\n    const result =\n      extension === '.vue'\n        ? await extractFromVueSource(source, file, {\n            compilerOptions:\n              compilerOptionsByScope.get(\n                fileScopes.get(file)?.directory ?? ''\n              ) ?? {},\n            includeSourceCodeContext: options.includeSourceCodeContext,\n            projectRoot,\n            requireGTProvenance: true,\n            resolveModule: resolveModuleForFile(file),\n            surroundingLineCount: options.surroundingLineCount,\n          })\n        : standaloneResults.get(file);\n    if (!result) continue;\n    results.push(...result.results);\n    errors.push(...result.errors);\n    for (const warning of result.warnings) warnings.add(warning);\n  }\n\n  const updates = results.map(addCatalogHash);\n  deduplicateProjectUpdates(updates);\n  return {\n    updates: errors.length > 0 ? [] : updates,\n    errors,\n    warnings: [...warnings],\n  };\n}\n\n/** Excludes script modules whose filename happens to end in `.vue`. */\nasync function filterVueSourceFiles(\n  files: readonly string[],\n  sourceByFile: Map<string, string>\n): Promise<string[]> {\n  const included = await Promise.all(\n    files.map(async (file) => {\n      if (path.extname(file).toLowerCase() !== '.vue') return true;\n      try {\n        const source = await fs.promises.readFile(file, 'utf8');\n        sourceByFile.set(file, source);\n        return isVueSfcSource(source);\n      } catch {\n        // Preserve the file so the normal extraction pass reports its I/O error.\n        return true;\n      }\n    })\n  );\n  return files.filter((_file, index) => included[index]);\n}\n\n/** Returns whether a standalone file has observable gt-vue extraction work. */\nfunction hasExtractionSignal(result: VueExtractionOutput | undefined): boolean {\n  return Boolean(\n    result &&\n    (result.results.length > 0 ||\n      result.errors.length > 0 ||\n      result.warnings.length > 0)\n  );\n}\n\n/**\n * Proves whether a statically observed alias candidate can expose gt-vue.\n *\n * Incomplete config candidates are diagnostic evidence only: results from\n * these probes are never published. Reusing the normal provenance analyzer\n * avoids treating ordinary React/local helpers with GT-shaped names as Vue.\n */\nasync function probePotentialAliasProvenance(\n  files: readonly string[],\n  sourceByFile: ReadonlyMap<string, string>,\n  fileScopes: ReadonlyMap<string, VueSourceScope | undefined>,\n  standaloneResults: ReadonlyMap<string, VueExtractionOutput>,\n  resolvePotentialModulesForFile: (\n    sourceFile: string\n  ) => Array<(specifier: string, importer: string) => string | undefined>,\n  projectRoot: string\n): Promise<Set<string>> {\n  const provenScopes = new Set<string>();\n  for (const file of files) {\n    if (path.extname(file).toLowerCase() === '.vue') continue;\n    const scope = fileScopes.get(file);\n    const source = sourceByFile.get(file);\n    if (\n      !scope ||\n      source === undefined ||\n      provenScopes.has(scope.directory) ||\n      hasExtractionSignal(standaloneResults.get(file))\n    ) {\n      continue;\n    }\n    for (const resolveModule of resolvePotentialModulesForFile(file)) {\n      const probe = await extractFromVueSource(source, file, {\n        compilerOptions: {},\n        projectRoot,\n        requireGTProvenance: true,\n        resolveModule,\n      });\n      if (!hasExtractionSignal(probe)) continue;\n      provenScopes.add(scope.directory);\n      break;\n    }\n  }\n  return provenScopes;\n}\n\n/** Maximum diagnostic-only alias combinations explored for one application. */\nconst MAX_POTENTIAL_ALIAS_CONFIGURATIONS = 128;\n\n/** Builds deterministic candidate maps without trusting any as active config. */\nfunction createPotentialAliasConfigurations(\n  potentialAliases: ReadonlyMap<string, ReadonlySet<string>> | undefined\n): Map<string, string>[] {\n  if (!potentialAliases || potentialAliases.size === 0) return [];\n  let configurations: Map<string, string>[] = [new Map()];\n  for (const [key, replacements] of potentialAliases) {\n    if (replacements.size === 0) continue;\n    const next: Map<string, string>[] = [];\n    for (const configuration of configurations) {\n      for (const replacement of replacements) {\n        next.push(new Map(configuration).set(key, replacement));\n        if (next.length >= MAX_POTENTIAL_ALIAS_CONFIGURATIONS) break;\n      }\n      if (next.length >= MAX_POTENTIAL_ALIAS_CONFIGURATIONS) break;\n    }\n    configurations = next;\n    if (configurations.length === 0) return [];\n  }\n  return configurations;\n}\n\nfunction addCatalogHash(\n  result: VueExtractionResult\n): VueProjectExtractionResult {\n  const hash = hashSource({\n    // hashSource's historical shared type omits boolean/null branch sources,\n    // although its runtime sanitizer has always supported those React values.\n    source: result.source as JsxChildren | string,\n    ...(result.metadata.context && { context: result.metadata.context }),\n    ...(result.metadata.maxChars != null && {\n      maxChars: result.metadata.maxChars,\n    }),\n    ...(result.metadata.requiresReview === true && { requiresReview: true }),\n    dataFormat: result.dataFormat,\n  });\n  return {\n    ...result,\n    metadata: { ...result.metadata, hash },\n  } as VueProjectExtractionResult;\n}\n\n/** Merges duplicate Vue hashes without repeating source-location metadata. */\nfunction deduplicateProjectUpdates(\n  updates: VueProjectExtractionResult[]\n): void {\n  const byHash = new Map<string, VueProjectExtractionResult>();\n  for (const update of updates) {\n    const existing = byHash.get(update.metadata.hash);\n    if (!existing) {\n      byHash.set(update.metadata.hash, update);\n      continue;\n    }\n    existing.metadata.filePaths = mergeUnique(\n      existing.metadata.filePaths,\n      update.metadata.filePaths\n    );\n    existing.metadata.sourceCode = mergeSourceCode(\n      existing.metadata.sourceCode,\n      update.metadata.sourceCode\n    );\n  }\n  updates.splice(0, updates.length, ...byHash.values());\n}\n\nfunction mergeUnique(\n  left: string[] | undefined,\n  right: string[] | undefined\n): string[] | undefined {\n  const merged = [...new Set([...(left ?? []), ...(right ?? [])])];\n  return merged.length > 0 ? merged : undefined;\n}\n\nfunction mergeSourceCode(\n  left: Record<string, VueSourceCode[]> | undefined,\n  right: Record<string, VueSourceCode[]> | undefined\n): Record<string, VueSourceCode[]> | undefined {\n  if (!left && !right) return undefined;\n  const merged: Record<string, VueSourceCode[]> = {};\n  for (const sourceCode of [left, right]) {\n    for (const [file, entries] of Object.entries(sourceCode ?? {})) {\n      const known = new Set(\n        (merged[file] ?? []).map((entry) => JSON.stringify(entry))\n      );\n      for (const entry of entries) {\n        const key = JSON.stringify(entry);\n        if (known.has(key)) continue;\n        (merged[file] ??= []).push(entry);\n        known.add(key);\n      }\n    }\n  }\n  return merged;\n}\n\n/** Matches source patterns without hiding filesystem discovery failures. */\nfunction matchProjectFiles(\n  cwd: string,\n  patterns: readonly string[]\n): { files: string[]; errors: string[] } {\n  let matches: string[];\n  try {\n    matches = fg.sync([...patterns], {\n      absolute: true,\n      cwd,\n      followSymbolicLinks: false,\n      ignore: ['**/node_modules/**'],\n      onlyFiles: true,\n      unique: true,\n    });\n  } catch (error) {\n    return {\n      files: [],\n      errors: [createGlobDiagnostic(patterns, error)],\n    };\n  }\n  let realRoot: string;\n  try {\n    realRoot = fs.realpathSync(cwd);\n  } catch (error) {\n    return {\n      files: [],\n      errors: [createRootRealpathDiagnostic(cwd, error)],\n    };\n  }\n  const files = new Set<string>();\n  const errors: string[] = [];\n  for (const file of matches) {\n    let realFile: string;\n    try {\n      realFile = fs.realpathSync(file);\n    } catch (error) {\n      errors.push(createMatchedFileRealpathDiagnostic(cwd, file, error));\n      continue;\n    }\n    const relative = path.relative(realRoot, realFile);\n    if (\n      relative === '' ||\n      relative === '..' ||\n      relative.startsWith(`..${path.sep}`) ||\n      path.isAbsolute(relative)\n    ) {\n      // Symlinks outside the project are intentionally outside its catalog.\n      continue;\n    }\n    files.add(realFile);\n  }\n  return {\n    errors,\n    files: [...files].sort((left, right) => left.localeCompare(right)),\n  };\n}\n\n/**\n * Makes custom Nuxt source layouts fail closed before another scope can make\n * an incomplete project look successful. Vite config does not influence\n * source discovery and remains gated on a matched SFC or proven gt-vue JSX.\n */\nfunction validateNuxtSourceScopes(\n  scopes: readonly VueSourceScope[],\n  explicitOptions: VueCompilerOptions | undefined\n): string[] {\n  const errors: string[] = [];\n  for (const scope of scopes) {\n    if (\n      !NUXT_CONFIG_FILES.some((file) =>\n        fs.existsSync(path.join(scope.directory, file))\n      )\n    ) {\n      continue;\n    }\n    errors.push(\n      ...resolveVueCompilerOptions(scope.directory, explicitOptions).errors\n    );\n  }\n  return errors;\n}\n\n/** Adds independent package boundaries only for explicit user-selected sources. */\nfunction addExplicitSourceScopes(\n  projectRoot: string,\n  discoveredScopes: readonly VueSourceScope[],\n  files: readonly string[]\n): VueSourceScope[] {\n  const scopes = [...discoveredScopes];\n  const known = new Set(scopes.map(({ directory }) => directory));\n  for (const file of files) {\n    const directory = findNearestPackageDirectory(file, projectRoot);\n    if (known.has(directory)) continue;\n    const inheritedScope = findVueSourceScope(file, scopes);\n    if (!inheritedScope) continue;\n    if (!ownsIndependentVueConfiguration(directory)) {\n      continue;\n    }\n    known.add(directory);\n    scopes.push({\n      directory,\n      includeByDefault: false,\n      relativeDirectory: toPosixPath(path.relative(projectRoot, directory)),\n    });\n  }\n  return scopes;\n}\n\n/** Returns whether a package must resolve its own Vue build configuration. */\nfunction ownsIndependentVueConfiguration(directory: string): boolean {\n  if (\n    [...VITE_CONFIG_FILES, ...NUXT_CONFIG_FILES].some((file) =>\n      fs.existsSync(path.join(directory, file))\n    )\n  ) {\n    return true;\n  }\n  const manifest = readJavaScriptPackageManifest(\n    path.join(directory, 'package.json')\n  );\n  return Boolean(\n    manifest && declaresInstalledJavaScriptDependency(manifest, GT_VUE_PACKAGE)\n  );\n}\n\nfunction findNearestPackageDirectory(\n  file: string,\n  projectRoot: string\n): string {\n  let current = path.dirname(file);\n  const root = path.resolve(projectRoot);\n  while (current !== root && isWithin(root, current)) {\n    if (fs.existsSync(path.join(current, 'package.json'))) return current;\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  return root;\n}\n\n/** Applies each Vue app's statically resolved Vite/Nuxt aliases before Node resolution. */\nfunction createVueModuleResolver(\n  projectRoot: string,\n  scopes: readonly VueSourceScope[],\n  fileScopes: ReadonlyMap<string, VueSourceScope | undefined>,\n  options: VueProjectExtractionOptions,\n  resolveModule: (specifier: string, importer: string) => string | undefined\n): {\n  resolveModuleForFile: (\n    sourceFile: string\n  ) => (specifier: string, importer: string) => string | undefined;\n  resolvePotentialModulesForFile: (\n    sourceFile: string\n  ) => Array<(specifier: string, importer: string) => string | undefined>;\n  errors: string[];\n  incompleteAliasScopes: Set<string>;\n} {\n  const matchedScopes = uniqueSourceScopes(fileScopes.values());\n  const ownedMatchedScopes = matchedScopes.filter(\n    ({ includeByDefault }) => includeByDefault\n  );\n  const candidateExplicitScopes =\n    ownedMatchedScopes.length > 0 ? ownedMatchedScopes : matchedScopes;\n  const aliasesByScope = new Map<string, Map<string, string>>();\n  const errors: string[] = [];\n  const incompleteAliasScopes = new Set<string>();\n  const potentialAliasesByScope = new Map<string, Map<string, Set<string>>>();\n  if (options.viteConfigPath !== undefined) {\n    const explicitConfig = path.resolve(projectRoot, options.viteConfigPath);\n    const explicitScope =\n      candidateExplicitScopes.length === 1\n        ? candidateExplicitScopes[0]\n        : findVueSourceScope(explicitConfig, candidateExplicitScopes);\n    if (!explicitScope) {\n      errors.push(\n        createExplicitConfigOwnershipDiagnostic(options.viteConfigPath)\n      );\n    } else {\n      for (const scope of matchedScopes) {\n        addAliasesForScope(\n          aliasesByScope,\n          incompleteAliasScopes,\n          potentialAliasesByScope,\n          scope,\n          scope.directory === explicitScope.directory\n            ? {\n                directory: projectRoot,\n                viteConfigPath: options.viteConfigPath,\n              }\n            : { directory: scope.directory }\n        );\n      }\n    }\n  } else {\n    for (const scope of matchedScopes) {\n      addAliasesForScope(\n        aliasesByScope,\n        incompleteAliasScopes,\n        potentialAliasesByScope,\n        scope,\n        { directory: scope.directory }\n      );\n    }\n  }\n\n  return {\n    errors,\n    incompleteAliasScopes,\n    resolveModuleForFile(sourceFile) {\n      // Keep aliases attached to the application that initiated traversal.\n      // A local barrel can live in a sibling/linked package and import another\n      // application alias transitively; selecting by that barrel's directory\n      // would either lose the alias or leak a different app's configuration.\n      const sourceScope = findVueSourceScope(sourceFile, scopes);\n      return (specifier, importer) => {\n        const scope = sourceScope ?? findVueSourceScope(importer, scopes);\n        const aliases = scope ? aliasesByScope.get(scope.directory) : undefined;\n        return resolveModule(applyStaticAlias(specifier, aliases), importer);\n      };\n    },\n    resolvePotentialModulesForFile(sourceFile) {\n      const sourceScope = findVueSourceScope(sourceFile, scopes);\n      if (!sourceScope) return [];\n      return createPotentialAliasConfigurations(\n        potentialAliasesByScope.get(sourceScope.directory)\n      ).map(\n        (aliases) => (specifier: string, importer: string) =>\n          resolveModule(applyStaticAlias(specifier, aliases), importer)\n      );\n    },\n  };\n}\n\nfunction addAliasesForScope(\n  aliasesByScope: Map<string, Map<string, string>>,\n  incompleteAliasScopes: Set<string>,\n  potentialAliasesByScope: Map<string, Map<string, Set<string>>>,\n  scope: VueSourceScope,\n  config: { directory: string; viteConfigPath?: string }\n): void {\n  const resolution = resolveVueProjectAliasConfiguration(config.directory, {\n    viteConfigPath: config.viteConfigPath,\n  });\n  if (!resolution.complete) {\n    incompleteAliasScopes.add(scope.directory);\n    if (resolution.potentialAliases) {\n      potentialAliasesByScope.set(scope.directory, resolution.potentialAliases);\n    }\n    aliasesByScope.set(scope.directory, new Map());\n    return;\n  }\n  aliasesByScope.set(scope.directory, resolution.aliases);\n}\n\n/** Blocks incomplete aliases only after a source proves Vue ownership. */\nfunction validateIncompleteAliasScopes(\n  files: readonly string[],\n  fileScopes: ReadonlyMap<string, VueSourceScope | undefined>,\n  standaloneResults: ReadonlyMap<string, VueExtractionOutput>,\n  incompleteScopes: ReadonlySet<string>,\n  potentialAliasProvenanceScopes: ReadonlySet<string>,\n  errors: string[]\n): void {\n  const diagnosedScopes = new Set<string>();\n  for (const file of files) {\n    const scope = fileScopes.get(file);\n    if (\n      !scope ||\n      !incompleteScopes.has(scope.directory) ||\n      diagnosedScopes.has(scope.directory)\n    ) {\n      continue;\n    }\n    const isVueSource = path.extname(file).toLowerCase() === '.vue';\n    const hasVueSignal = hasExtractionSignal(standaloneResults.get(file));\n    const hasPotentialAliasProvenance = potentialAliasProvenanceScopes.has(\n      scope.directory\n    );\n    if (!isVueSource && !hasVueSignal && !hasPotentialAliasProvenance) {\n      continue;\n    }\n    diagnosedScopes.add(scope.directory);\n    errors.push(createIncompleteAliasDiagnostic(scope));\n  }\n}\n\nfunction createIncompleteAliasDiagnostic(scope: VueSourceScope): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/vue-extractor',\n    severity: 'Error',\n    whatHappened:\n      'Could not statically resolve the Vue application module aliases',\n    why: 'Dynamic alias behavior can hide gt-vue imports and produce an incomplete translation catalog',\n    fix: 'Define Vite or Nuxt aliases with static string values and remove custom alias resolvers',\n    details: scope.relativeDirectory || '.',\n  });\n}\n\nfunction uniqueSourceScopes(\n  scopes: Iterable<VueSourceScope | undefined>\n): VueSourceScope[] {\n  const unique = new Map<string, VueSourceScope>();\n  for (const scope of scopes) {\n    if (scope) unique.set(scope.directory, scope);\n  }\n  return [...unique.values()];\n}\n\nfunction applyStaticAlias(\n  specifier: string,\n  aliases: ReadonlyMap<string, string> | undefined\n): string {\n  if (!aliases) return specifier;\n  for (const [find, replacement] of aliases) {\n    const normalized =\n      find.endsWith('/') && replacement.endsWith('/')\n        ? {\n            find: find.slice(0, -1),\n            replacement: replacement.slice(0, -1),\n          }\n        : { find, replacement };\n    if (\n      specifier === normalized.find ||\n      specifier.startsWith(`${normalized.find}/`)\n    ) {\n      return specifier.replace(normalized.find, normalized.replacement);\n    }\n  }\n  return specifier;\n}\n\n/** Resolves every affected scope before parsing any SFC catalog content. */\nfunction resolveCompilerOptionsByScope(\n  projectRoot: string,\n  files: readonly string[],\n  fileScopes: ReadonlyMap<string, VueSourceScope | undefined>,\n  scopes: readonly VueSourceScope[],\n  options: VueProjectExtractionOptions,\n  explicitCompilerResolution: VueCompilerOptionsResolution | undefined,\n  errors: string[]\n): Map<string, VueCompilerOptions> {\n  const optionsByScope = new Map<string, VueCompilerOptions>();\n  const affectedScopes = new Map<string, VueSourceScope>();\n  for (const file of files) {\n    const scope = fileScopes.get(file);\n    if (scope) affectedScopes.set(scope.directory, scope);\n  }\n  if (affectedScopes.size === 0) return optionsByScope;\n\n  if (options.viteConfigPath !== undefined) {\n    const explicitConfig = path.resolve(projectRoot, options.viteConfigPath);\n    const explicitResolution =\n      explicitCompilerResolution ??\n      resolveVueCompilerOptions(projectRoot, options.vueCompilerOptions, {\n        viteConfigPath: options.viteConfigPath,\n        sourceDiscoveryIsExplicit: options.filePatterns !== undefined,\n      });\n    errors.push(...explicitResolution.errors);\n    if (explicitResolution.errors.length > 0) return optionsByScope;\n    const explicitScope =\n      affectedScopes.size === 1\n        ? [...affectedScopes.values()][0]\n        : findVueSourceScope(explicitConfig, scopes);\n    if (!explicitScope || !affectedScopes.has(explicitScope.directory)) {\n      errors.push(\n        createExplicitConfigOwnershipDiagnostic(options.viteConfigPath)\n      );\n      return optionsByScope;\n    }\n\n    for (const scope of affectedScopes.values()) {\n      const resolution =\n        scope.directory === explicitScope.directory\n          ? explicitResolution\n          : resolveVueCompilerOptions(\n              scope.directory,\n              options.vueCompilerOptions,\n              {\n                sourceDiscoveryIsExplicit: options.filePatterns !== undefined,\n              }\n            );\n      errors.push(...resolution.errors);\n      optionsByScope.set(scope.directory, resolution.compilerOptions);\n    }\n    return optionsByScope;\n  }\n\n  for (const scope of affectedScopes.values()) {\n    const resolution = resolveVueCompilerOptions(\n      scope.directory,\n      options.vueCompilerOptions,\n      {\n        sourceDiscoveryIsExplicit: options.filePatterns !== undefined,\n      }\n    );\n    errors.push(...resolution.errors);\n    optionsByScope.set(scope.directory, resolution.compilerOptions);\n  }\n  return optionsByScope;\n}\n\n/** Validates an explicitly selected config even when every match is STRING. */\nfunction validateExplicitCompilerConfig(\n  projectRoot: string,\n  options: VueProjectExtractionOptions,\n  hasPotentialVueSource: boolean,\n  errors: string[]\n): VueCompilerOptionsResolution | undefined {\n  if (!hasPotentialVueSource || options.viteConfigPath === undefined) {\n    return undefined;\n  }\n  const resolution = resolveVueCompilerOptions(\n    projectRoot,\n    options.vueCompilerOptions,\n    {\n      viteConfigPath: options.viteConfigPath,\n      sourceDiscoveryIsExplicit: options.filePatterns !== undefined,\n    }\n  );\n  errors.push(...resolution.errors);\n  return resolution;\n}\n\nfunction createExplicitConfigOwnershipDiagnostic(configPath: string): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/vue-extractor',\n    severity: 'Error',\n    whatHappened:\n      'The configured Vite config does not own any matched Vue sources',\n    fix: 'Run extraction from that application root, include only one centrally configured Vue application, or remove files.gt.parsingFlags.viteConfigPath',\n    details: configPath,\n  });\n}\n\n/** Resolves and validates one explicit TypeScript project file atomically. */\nfunction resolveExplicitTypeScriptConfigPath(\n  projectRoot: string,\n  configuredPath: string | undefined,\n  errors: string[]\n): string | undefined {\n  if (configuredPath === undefined) return undefined;\n  const absolutePath = path.resolve(projectRoot, configuredPath);\n  try {\n    const configPath = fs.realpathSync(absolutePath);\n    if (!fs.statSync(configPath).isFile()) {\n      throw new Error('The configured path is not a file');\n    }\n    const resolution = loadExplicitTypeScriptConfig(configPath);\n    if (resolution.resultType === 'failed') {\n      throw new Error(resolution.message);\n    }\n    const loadedPath = fs.realpathSync(resolution.configFileAbsolutePath);\n    if (loadedPath !== configPath) {\n      throw new Error(\n        `The resolver selected a different config file: ${loadedPath}`\n      );\n    }\n    return configPath;\n  } catch (error) {\n    errors.push(\n      createDiagnosticMessage({\n        source: '@generaltranslation/vue-extractor',\n        severity: 'Error',\n        whatHappened: 'Could not load the configured TypeScript project file',\n        why: 'Unresolved path aliases can hide gt-vue imports and produce an incomplete translation catalog',\n        fix: 'Set tsconfigPath to a readable tsconfig.json or jsconfig.json file',\n        details: [\n          configuredPath,\n          formatDiagnosticErrorDetails(error) ?? 'Unknown config error',\n        ],\n      })\n    );\n    return undefined;\n  }\n}\n\nfunction createReadDiagnostic(\n  projectRoot: string,\n  file: string,\n  error: unknown\n): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/vue-extractor',\n    severity: 'Error',\n    whatHappened: 'Could not read a matched Vue source file',\n    fix: 'Restore read access or exclude the file from the configured source patterns',\n    details: [\n      toPosixPath(path.relative(projectRoot, file)),\n      formatDiagnosticErrorDetails(error) ?? 'Unknown read error',\n    ],\n  });\n}\n\nfunction createGlobDiagnostic(\n  patterns: readonly string[],\n  error: unknown\n): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/vue-extractor',\n    severity: 'Error',\n    whatHappened: 'Could not match the configured Vue source patterns',\n    fix: 'Correct the source patterns and rerun extraction',\n    details: [\n      patterns.join(', ') || '(no patterns)',\n      formatDiagnosticErrorDetails(error) ?? 'Unknown glob error',\n    ],\n  });\n}\n\nfunction createRootRealpathDiagnostic(\n  projectRoot: string,\n  error: unknown\n): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/vue-extractor',\n    severity: 'Error',\n    whatHappened: 'Could not resolve the Vue project root',\n    fix: 'Restore access to the project directory and rerun extraction',\n    details: [\n      projectRoot,\n      formatDiagnosticErrorDetails(error) ?? 'Unknown filesystem error',\n    ],\n  });\n}\n\nfunction createMatchedFileRealpathDiagnostic(\n  projectRoot: string,\n  file: string,\n  error: unknown\n): string {\n  return createDiagnosticMessage({\n    source: '@generaltranslation/vue-extractor',\n    severity: 'Error',\n    whatHappened: 'Could not resolve a matched Vue source file',\n    fix: 'Restore the file or exclude it from the configured source patterns',\n    details: [\n      toPosixPath(path.relative(projectRoot, file)),\n      formatDiagnosticErrorDetails(error) ?? 'Unknown filesystem error',\n    ],\n  });\n}\n\nfunction isWithin(root: string, candidate: string): boolean {\n  const relative = path.relative(path.resolve(root), path.resolve(candidate));\n  return (\n    relative === '' ||\n    (relative !== '..' &&\n      !relative.startsWith(`..${path.sep}`) &&\n      !path.isAbsolute(relative))\n  );\n}\n\nfunction toPosixPath(filePath: string): string {\n  return filePath.split(path.sep).join(path.posix.sep);\n}\n"],"mappings":"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"}

package/dist/internal/project/inspectVueProject.d.ts

@@ -0,0 +1,48 @@
+import type { VueProjectInspection } from '../../types.js';
+import { type VueProjectDiscovery } from './scopes.js';
+export { isVueSfcSource } from './vueSourceClassification.js';
+/** Discovers Vue workspace ownership once and returns a reusable opaque plan. */
+export declare function inspectVueProject(cwd?: string): VueProjectInspection;
+/**
+ * Discovers Vue ownership while reading declared workspace manifests with
+ * bounded asynchronous I/O.
+ *
+ * The asynchronous traversal pre-populates the same per-inspection cache used
+ * by `discoverVueProject`, preserving its ownership semantics while allowing a
+ * host framework to continue its existing extraction concurrently.
+ */
+export declare function inspectVueProjectAsync(cwd?: string): Promise<VueProjectInspection>;
+/**
+ * Inspects Vue ownership for the high-level framework planner.
+ *
+ * An explicitly selected `gt-vue` runtime owns its root even when a host CLI
+ * supplied that selection independently of package-manifest detection. This
+ * override remains package-private so ordinary discovery cannot promote a
+ * React or file-only project.
+ */
+export declare function inspectVueProjectForRuntime(cwd: string, forceRootOwnership: boolean): Promise<VueProjectInspection>;
+/**
+ * Returns exact negative globs for real Vue SFCs selected by explicit input.
+ *
+ * A `.vue` suffix alone is insufficient because the historical React parser
+ * accepts arbitrary JSX modules with that extension. Only files inside a
+ * discovered Vue scope whose source is classified as an SFC are partitioned.
+ */
+export declare function readVueSfcExclusionPatterns(inspection: VueProjectInspection, filePatterns: readonly string[]): string[];
+/**
+ * Partitions explicitly selected `.vue` files between a historical parser and
+ * the companion Vue extractor.
+ *
+ * A lone `<template>`, `<script>`, or `<style>` expression is valid both as a
+ * Vue block and as a Babel JSX module. Those ambiguous files stay with the
+ * historical parser so adding Vue support cannot remove existing messages,
+ * while the companion Vue pass skips them to avoid duplicate or invalid SFC
+ * diagnostics. Vue-primary and default Vue discovery do not use this explicit
+ * mixed-framework partition and continue to accept template-only SFCs.
+ */
+export declare function partitionVueSourcePatterns(inspection: VueProjectInspection, filePatterns: readonly string[]): {
+    primaryExclusionPatterns: string[];
+    vueExclusionPatterns: string[];
+};
+/** Returns the package-private discovery carried by a valid inspection. */
+export declare function readVueProjectInspection(inspection: VueProjectInspection | undefined, projectRoot: string): VueProjectDiscovery | undefined;

package/dist/internal/project/inspectVueProject.js

@@ -0,0 +1,143 @@
+import { readJavaScriptPackageManifest } from "./manifest.js";
+import { classifyVueSource, isVueSfcSource } from "./vueSourceClassification.js";
+import { createWorkspaceDiscoveryCache, readDeclaredWorkspacePackagesAsync } from "./workspaces.js";
+import { discoverVueProject, findVueSourceScope, resolveProjectDirectory } from "./scopes.js";
+import fs from "node:fs";
+import path from "node:path";
+import fg from "fast-glob";
+//#region src/internal/project/inspectVueProject.ts
+const discoveryByInspection = /* @__PURE__ */ new WeakMap();
+/** Discovers Vue workspace ownership once and returns a reusable opaque plan. */
+function inspectVueProject(cwd = process.cwd()) {
+	return createVueProjectInspection(discoverVueProject(cwd));
+}
+/**
+* Discovers Vue ownership while reading declared workspace manifests with
+* bounded asynchronous I/O.
+*
+* The asynchronous traversal pre-populates the same per-inspection cache used
+* by `discoverVueProject`, preserving its ownership semantics while allowing a
+* host framework to continue its existing extraction concurrently.
+*/
+async function inspectVueProjectAsync(cwd = process.cwd()) {
+	return inspectVueProjectForRuntime(cwd, false);
+}
+/**
+* Inspects Vue ownership for the high-level framework planner.
+*
+* An explicitly selected `gt-vue` runtime owns its root even when a host CLI
+* supplied that selection independently of package-manifest detection. This
+* override remains package-private so ordinary discovery cannot promote a
+* React or file-only project.
+*/
+async function inspectVueProjectForRuntime(cwd, forceRootOwnership) {
+	const projectRoot = resolveProjectDirectory(cwd);
+	const rootManifest = readJavaScriptPackageManifest(path.join(projectRoot, "package.json"));
+	const cache = createWorkspaceDiscoveryCache();
+	if (rootManifest) await readDeclaredWorkspacePackagesAsync(projectRoot, rootManifest, cache);
+	const discovery = discoverVueProject(projectRoot, cache);
+	return createVueProjectInspection(forceRootOwnership ? addRootOwnership(discovery) : discovery);
+}
+/** Adds one forced root scope without changing discovered child scopes. */
+function addRootOwnership(discovery) {
+	if (discovery.rootOwnsVue) return discovery;
+	return {
+		...discovery,
+		rootOwnsVue: true,
+		scopes: [{
+			directory: discovery.projectRoot,
+			includeByDefault: true,
+			relativeDirectory: ""
+		}, ...discovery.scopes.filter(({ directory }) => directory !== discovery.projectRoot)]
+	};
+}
+function createVueProjectInspection(discovery) {
+	const inspection = Object.freeze({
+		projectRoot: discovery.projectRoot,
+		rootOwnsVue: discovery.rootOwnsVue,
+		hasVueScopes: discovery.scopes.length > 0
+	});
+	discoveryByInspection.set(inspection, discovery);
+	return inspection;
+}
+/**
+* Returns exact negative globs for real Vue SFCs selected by explicit input.
+*
+* A `.vue` suffix alone is insufficient because the historical React parser
+* accepts arbitrary JSX modules with that extension. Only files inside a
+* discovered Vue scope whose source is classified as an SFC are partitioned.
+*/
+function readVueSfcExclusionPatterns(inspection, filePatterns) {
+	return partitionVueSourcePatterns(inspection, filePatterns).primaryExclusionPatterns;
+}
+/**
+* Partitions explicitly selected `.vue` files between a historical parser and
+* the companion Vue extractor.
+*
+* A lone `<template>`, `<script>`, or `<style>` expression is valid both as a
+* Vue block and as a Babel JSX module. Those ambiguous files stay with the
+* historical parser so adding Vue support cannot remove existing messages,
+* while the companion Vue pass skips them to avoid duplicate or invalid SFC
+* diagnostics. Vue-primary and default Vue discovery do not use this explicit
+* mixed-framework partition and continue to accept template-only SFCs.
+*/
+function partitionVueSourcePatterns(inspection, filePatterns) {
+	const discovery = readVueProjectInspection(inspection, inspection.projectRoot);
+	if (!discovery) return {
+		primaryExclusionPatterns: [],
+		vueExclusionPatterns: []
+	};
+	let matches;
+	try {
+		matches = fg.sync([...filePatterns], {
+			absolute: true,
+			cwd: discovery.projectRoot,
+			followSymbolicLinks: false,
+			ignore: ["**/node_modules/**"],
+			onlyFiles: true,
+			unique: true
+		});
+	} catch {
+		return {
+			primaryExclusionPatterns: [],
+			vueExclusionPatterns: []
+		};
+	}
+	const primaryExclusionPatterns = [];
+	const vueExclusionPatterns = [];
+	for (const file of matches) {
+		let realFile;
+		try {
+			realFile = fs.realpathSync(file);
+		} catch {
+			continue;
+		}
+		if (path.extname(realFile).toLowerCase() !== ".vue" || !findVueSourceScope(realFile, discovery.scopes)) continue;
+		let source;
+		try {
+			source = fs.readFileSync(realFile, "utf8");
+		} catch {
+			continue;
+		}
+		const classification = classifyVueSource(source);
+		const exclusion = `!${fg.escapePath(toPosixPath(path.resolve(file)))}`;
+		if (classification === "definitive-sfc") primaryExclusionPatterns.push(exclusion);
+		else if (classification === "ambiguous-standard-tag-jsx") vueExclusionPatterns.push(exclusion);
+	}
+	return {
+		primaryExclusionPatterns: [...new Set(primaryExclusionPatterns)],
+		vueExclusionPatterns: [...new Set(vueExclusionPatterns)]
+	};
+}
+/** Returns the package-private discovery carried by a valid inspection. */
+function readVueProjectInspection(inspection, projectRoot) {
+	if (!inspection || resolveProjectDirectory(inspection.projectRoot) !== resolveProjectDirectory(projectRoot)) return;
+	return discoveryByInspection.get(inspection);
+}
+function toPosixPath(filePath) {
+	return filePath.split(path.sep).join(path.posix.sep);
+}
+//#endregion
+export { inspectVueProject, inspectVueProjectAsync, inspectVueProjectForRuntime, isVueSfcSource, partitionVueSourcePatterns, readVueProjectInspection, readVueSfcExclusionPatterns };
+
+//# sourceMappingURL=inspectVueProject.js.map

package/dist/internal/project/inspectVueProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectVueProject.js","names":[],"sources":["../../../src/internal/project/inspectVueProject.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport fg from 'fast-glob';\nimport type { VueProjectInspection } from '../../types.js';\nimport {\n  discoverVueProject,\n  findVueSourceScope,\n  resolveProjectDirectory,\n  type VueProjectDiscovery,\n} from './scopes.js';\nimport { readJavaScriptPackageManifest } from './manifest.js';\nimport {\n  createWorkspaceDiscoveryCache,\n  readDeclaredWorkspacePackagesAsync,\n} from './workspaces.js';\nimport { classifyVueSource } from './vueSourceClassification.js';\n\nexport { isVueSfcSource } from './vueSourceClassification.js';\n\nconst discoveryByInspection = new WeakMap<\n  VueProjectInspection,\n  VueProjectDiscovery\n>();\n\n/** Discovers Vue workspace ownership once and returns a reusable opaque plan. */\nexport function inspectVueProject(\n  cwd: string = process.cwd()\n): VueProjectInspection {\n  return createVueProjectInspection(discoverVueProject(cwd));\n}\n\n/**\n * Discovers Vue ownership while reading declared workspace manifests with\n * bounded asynchronous I/O.\n *\n * The asynchronous traversal pre-populates the same per-inspection cache used\n * by `discoverVueProject`, preserving its ownership semantics while allowing a\n * host framework to continue its existing extraction concurrently.\n */\nexport async function inspectVueProjectAsync(\n  cwd: string = process.cwd()\n): Promise<VueProjectInspection> {\n  return inspectVueProjectForRuntime(cwd, false);\n}\n\n/**\n * Inspects Vue ownership for the high-level framework planner.\n *\n * An explicitly selected `gt-vue` runtime owns its root even when a host CLI\n * supplied that selection independently of package-manifest detection. This\n * override remains package-private so ordinary discovery cannot promote a\n * React or file-only project.\n */\nexport async function inspectVueProjectForRuntime(\n  cwd: string,\n  forceRootOwnership: boolean\n): Promise<VueProjectInspection> {\n  const projectRoot = resolveProjectDirectory(cwd);\n  const rootManifest = readJavaScriptPackageManifest(\n    path.join(projectRoot, 'package.json')\n  );\n  const cache = createWorkspaceDiscoveryCache();\n  if (rootManifest) {\n    await readDeclaredWorkspacePackagesAsync(projectRoot, rootManifest, cache);\n  }\n  const discovery = discoverVueProject(projectRoot, cache);\n  return createVueProjectInspection(\n    forceRootOwnership ? addRootOwnership(discovery) : discovery\n  );\n}\n\n/** Adds one forced root scope without changing discovered child scopes. */\nfunction addRootOwnership(discovery: VueProjectDiscovery): VueProjectDiscovery {\n  if (discovery.rootOwnsVue) return discovery;\n  return {\n    ...discovery,\n    rootOwnsVue: true,\n    scopes: [\n      {\n        directory: discovery.projectRoot,\n        includeByDefault: true,\n        relativeDirectory: '',\n      },\n      ...discovery.scopes.filter(\n        ({ directory }) => directory !== discovery.projectRoot\n      ),\n    ],\n  };\n}\n\nfunction createVueProjectInspection(\n  discovery: VueProjectDiscovery\n): VueProjectInspection {\n  const inspection = Object.freeze({\n    projectRoot: discovery.projectRoot,\n    rootOwnsVue: discovery.rootOwnsVue,\n    hasVueScopes: discovery.scopes.length > 0,\n  });\n  discoveryByInspection.set(inspection, discovery);\n  return inspection;\n}\n\n/**\n * Returns exact negative globs for real Vue SFCs selected by explicit input.\n *\n * A `.vue` suffix alone is insufficient because the historical React parser\n * accepts arbitrary JSX modules with that extension. Only files inside a\n * discovered Vue scope whose source is classified as an SFC are partitioned.\n */\nexport function readVueSfcExclusionPatterns(\n  inspection: VueProjectInspection,\n  filePatterns: readonly string[]\n): string[] {\n  return partitionVueSourcePatterns(inspection, filePatterns)\n    .primaryExclusionPatterns;\n}\n\n/**\n * Partitions explicitly selected `.vue` files between a historical parser and\n * the companion Vue extractor.\n *\n * A lone `<template>`, `<script>`, or `<style>` expression is valid both as a\n * Vue block and as a Babel JSX module. Those ambiguous files stay with the\n * historical parser so adding Vue support cannot remove existing messages,\n * while the companion Vue pass skips them to avoid duplicate or invalid SFC\n * diagnostics. Vue-primary and default Vue discovery do not use this explicit\n * mixed-framework partition and continue to accept template-only SFCs.\n */\nexport function partitionVueSourcePatterns(\n  inspection: VueProjectInspection,\n  filePatterns: readonly string[]\n): {\n  primaryExclusionPatterns: string[];\n  vueExclusionPatterns: string[];\n} {\n  const discovery = readVueProjectInspection(\n    inspection,\n    inspection.projectRoot\n  );\n  if (!discovery) {\n    return { primaryExclusionPatterns: [], vueExclusionPatterns: [] };\n  }\n\n  let matches: string[];\n  try {\n    matches = fg.sync([...filePatterns], {\n      absolute: true,\n      cwd: discovery.projectRoot,\n      followSymbolicLinks: false,\n      ignore: ['**/node_modules/**'],\n      onlyFiles: true,\n      unique: true,\n    });\n  } catch {\n    return { primaryExclusionPatterns: [], vueExclusionPatterns: [] };\n  }\n\n  const primaryExclusionPatterns: string[] = [];\n  const vueExclusionPatterns: string[] = [];\n  for (const file of matches) {\n    let realFile: string;\n    try {\n      realFile = fs.realpathSync(file);\n    } catch {\n      continue;\n    }\n    if (\n      path.extname(realFile).toLowerCase() !== '.vue' ||\n      !findVueSourceScope(realFile, discovery.scopes)\n    ) {\n      continue;\n    }\n    let source: string;\n    try {\n      source = fs.readFileSync(realFile, 'utf8');\n    } catch {\n      continue;\n    }\n    const classification = classifyVueSource(source);\n    const exclusion = `!${fg.escapePath(toPosixPath(path.resolve(file)))}`;\n    if (classification === 'definitive-sfc') {\n      primaryExclusionPatterns.push(exclusion);\n    } else if (classification === 'ambiguous-standard-tag-jsx') {\n      vueExclusionPatterns.push(exclusion);\n    }\n  }\n  return {\n    primaryExclusionPatterns: [...new Set(primaryExclusionPatterns)],\n    vueExclusionPatterns: [...new Set(vueExclusionPatterns)],\n  };\n}\n\n/** Returns the package-private discovery carried by a valid inspection. */\nexport function readVueProjectInspection(\n  inspection: VueProjectInspection | undefined,\n  projectRoot: string\n): VueProjectDiscovery | undefined {\n  if (\n    !inspection ||\n    resolveProjectDirectory(inspection.projectRoot) !==\n      resolveProjectDirectory(projectRoot)\n  ) {\n    return undefined;\n  }\n  return discoveryByInspection.get(inspection);\n}\n\nfunction toPosixPath(filePath: string): string {\n  return filePath.split(path.sep).join(path.posix.sep);\n}\n"],"mappings":";;;;;;;;AAmBA,MAAM,wCAAwB,IAAI,SAG/B;;AAGH,SAAgB,kBACd,MAAc,QAAQ,KAAK,EACL;AACtB,QAAO,2BAA2B,mBAAmB,IAAI,CAAC;;;;;;;;;;AAW5D,eAAsB,uBACpB,MAAc,QAAQ,KAAK,EACI;AAC/B,QAAO,4BAA4B,KAAK,MAAM;;;;;;;;;;AAWhD,eAAsB,4BACpB,KACA,oBAC+B;CAC/B,MAAM,cAAc,wBAAwB,IAAI;CAChD,MAAM,eAAe,8BACnB,KAAK,KAAK,aAAa,eAAe,CACvC;CACD,MAAM,QAAQ,+BAA+B;AAC7C,KAAI,aACF,OAAM,mCAAmC,aAAa,cAAc,MAAM;CAE5E,MAAM,YAAY,mBAAmB,aAAa,MAAM;AACxD,QAAO,2BACL,qBAAqB,iBAAiB,UAAU,GAAG,UACpD;;;AAIH,SAAS,iBAAiB,WAAqD;AAC7E,KAAI,UAAU,YAAa,QAAO;AAClC,QAAO;EACL,GAAG;EACH,aAAa;EACb,QAAQ,CACN;GACE,WAAW,UAAU;GACrB,kBAAkB;GAClB,mBAAmB;GACpB,EACD,GAAG,UAAU,OAAO,QACjB,EAAE,gBAAgB,cAAc,UAAU,YAC5C,CACF;EACF;;AAGH,SAAS,2BACP,WACsB;CACtB,MAAM,aAAa,OAAO,OAAO;EAC/B,aAAa,UAAU;EACvB,aAAa,UAAU;EACvB,cAAc,UAAU,OAAO,SAAS;EACzC,CAAC;AACF,uBAAsB,IAAI,YAAY,UAAU;AAChD,QAAO;;;;;;;;;AAUT,SAAgB,4BACd,YACA,cACU;AACV,QAAO,2BAA2B,YAAY,aAAa,CACxD;;;;;;;;;;;;;AAcL,SAAgB,2BACd,YACA,cAIA;CACA,MAAM,YAAY,yBAChB,YACA,WAAW,YACZ;AACD,KAAI,CAAC,UACH,QAAO;EAAE,0BAA0B,EAAE;EAAE,sBAAsB,EAAE;EAAE;CAGnE,IAAI;AACJ,KAAI;AACF,YAAU,GAAG,KAAK,CAAC,GAAG,aAAa,EAAE;GACnC,UAAU;GACV,KAAK,UAAU;GACf,qBAAqB;GACrB,QAAQ,CAAC,qBAAqB;GAC9B,WAAW;GACX,QAAQ;GACT,CAAC;SACI;AACN,SAAO;GAAE,0BAA0B,EAAE;GAAE,sBAAsB,EAAE;GAAE;;CAGnE,MAAM,2BAAqC,EAAE;CAC7C,MAAM,uBAAiC,EAAE;AACzC,MAAK,MAAM,QAAQ,SAAS;EAC1B,IAAI;AACJ,MAAI;AACF,cAAW,GAAG,aAAa,KAAK;UAC1B;AACN;;AAEF,MACE,KAAK,QAAQ,SAAS,CAAC,aAAa,KAAK,UACzC,CAAC,mBAAmB,UAAU,UAAU,OAAO,CAE/C;EAEF,IAAI;AACJ,MAAI;AACF,YAAS,GAAG,aAAa,UAAU,OAAO;UACpC;AACN;;EAEF,MAAM,iBAAiB,kBAAkB,OAAO;EAChD,MAAM,YAAY,IAAI,GAAG,WAAW,YAAY,KAAK,QAAQ,KAAK,CAAC,CAAC;AACpE,MAAI,mBAAmB,iBACrB,0BAAyB,KAAK,UAAU;WAC/B,mBAAmB,6BAC5B,sBAAqB,KAAK,UAAU;;AAGxC,QAAO;EACL,0BAA0B,CAAC,GAAG,IAAI,IAAI,yBAAyB,CAAC;EAChE,sBAAsB,CAAC,GAAG,IAAI,IAAI,qBAAqB,CAAC;EACzD;;;AAIH,SAAgB,yBACd,YACA,aACiC;AACjC,KACE,CAAC,cACD,wBAAwB,WAAW,YAAY,KAC7C,wBAAwB,YAAY,CAEtC;AAEF,QAAO,sBAAsB,IAAI,WAAW;;AAG9C,SAAS,YAAY,UAA0B;AAC7C,QAAO,SAAS,MAAM,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI"}

package/dist/internal/project/manifest.d.ts

@@ -0,0 +1,64 @@
+/** Runtime package whose direct ownership activates Vue extraction. */
+export declare const GT_VUE_PACKAGE = "gt-vue";
+/** Minimal package manifest shape used by Vue project discovery. */
+export type JavaScriptPackageManifest = {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, {
+        optional?: boolean;
+    }>;
+    workspaces?: string[] | {
+        packages?: string[];
+    };
+};
+/** One dependency name and specifier as written by a consuming package. */
+export type JavaScriptDependencyBinding = {
+    name: string;
+    specifier: string;
+};
+/** An installed package directory resolved without evaluating its entrypoint. */
+export type InstalledJavaScriptPackage = {
+    directory: string;
+    manifest: JavaScriptPackageManifest;
+};
+/** Reads one package manifest without throwing for absent or malformed input. */
+export declare function readJavaScriptPackageManifest(packagePath: string): JavaScriptPackageManifest | undefined;
+/** Checks dependency fields that make a runtime available to package code. */
+export declare function declaresInstalledJavaScriptDependency(manifest: JavaScriptPackageManifest, packageName: string): boolean;
+/** Checks direct ownership, requiring optional and peer runtimes to resolve. */
+export declare function declaresAvailableJavaScriptDependency(manifest: JavaScriptPackageManifest, packageName: string, packageDirectory: string): boolean;
+/** Checks package ownership without promoting optional workspace integrations. */
+export declare function declaresWorkspaceJavaScriptDependency(manifest: JavaScriptPackageManifest, packageName: string, packageDirectory: string): boolean;
+/** Lists required dependencies that can bind one workspace package to another. */
+export declare function readWorkspaceDependencyNames(manifest: JavaScriptPackageManifest, packageDirectory: string): string[];
+/** Reads installed dependencies and resolvable, non-optional required peers. */
+export declare function readWorkspaceDependencyBindings(manifest: JavaScriptPackageManifest, packageDirectory: string): JavaScriptDependencyBinding[];
+/** Reads dependency edges that may propagate wrapper ownership to consumers. */
+export declare function readPropagatingDependencyBindings(manifest: JavaScriptPackageManifest, packageDirectory: string): JavaScriptDependencyBinding[];
+/**
+ * Resolves an installed package directory without selecting an export branch.
+ *
+ * `require.resolve()` is insufficient for availability checks because a valid
+ * ESM package may intentionally expose only its `import` condition. Walking
+ * Node's lookup directories finds the package boundary without importing user
+ * code or depending on the package's public subpath exports.
+ */
+export declare function resolveInstalledJavaScriptPackage(directory: string, bindingName: string): InstalledJavaScriptPackage | undefined;
+/** Parses pnpm's explicit `workspace:alias@range` dependency syntax. */
+export declare function parseWorkspaceDependencyAlias(specifier: string): {
+    packageName: string;
+    range: string;
+} | undefined;
+/** Reads the target package name from an npm alias dependency. */
+export declare function parseNpmDependencyAlias(specifier: string): {
+    packageName: string;
+    range?: string;
+} | undefined;
+/** Reads a relative directory selected by an explicit local protocol. */
+export declare function parseLocalDependencyPath(specifier: string): string | undefined;
+/** Checks whether one binding's declared range accepts a selected package. */
+export declare function dependencyBindingAcceptsPackageVersion(binding: JavaScriptDependencyBinding, packageName: string, packageVersion: string | undefined): boolean;