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

package/dist/internal/project/manifest.js

@@ -0,0 +1,270 @@
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+import { satisfies, valid, validRange } from "semver";
+//#region src/internal/project/manifest.ts
+/** Runtime package whose direct ownership activates Vue extraction. */
+const GT_VUE_PACKAGE = "gt-vue";
+/** Dependency fields that declare a runtime installed for one package. */
+const INSTALLED_DEPENDENCY_FIELDS = ["dependencies", "devDependencies"];
+/** Reads one package manifest without throwing for absent or malformed input. */
+function readJavaScriptPackageManifest(packagePath) {
+	try {
+		const parsed = JSON.parse(fs.readFileSync(packagePath, "utf8"));
+		return isRecord(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+/** Checks dependency fields that make a runtime available to package code. */
+function declaresInstalledJavaScriptDependency(manifest, packageName) {
+	return INSTALLED_DEPENDENCY_FIELDS.some((field) => readEffectiveDependencySpecifier(manifest, field, packageName) !== void 0);
+}
+/** Checks direct ownership, requiring optional and peer runtimes to resolve. */
+function declaresAvailableJavaScriptDependency(manifest, packageName, packageDirectory) {
+	if (readEffectiveDependencySpecifier(manifest, "devDependencies", packageName) !== void 0) return true;
+	const optionalSpecifier = readDependencySpecifier(manifest, "optionalDependencies", packageName);
+	if (optionalSpecifier !== void 0) return canResolveDependencyBinding(packageDirectory, {
+		name: packageName,
+		specifier: optionalSpecifier
+	});
+	if (readEffectiveDependencySpecifier(manifest, "dependencies", packageName) !== void 0) return true;
+	return declaresAvailableRequiredPeerDependency(manifest, packageName, packageDirectory);
+}
+/** Checks package ownership without promoting optional workspace integrations. */
+function declaresWorkspaceJavaScriptDependency(manifest, packageName, packageDirectory) {
+	return declaresInstalledJavaScriptDependency(manifest, packageName) || declaresAvailableRequiredPeerDependency(manifest, packageName, packageDirectory);
+}
+/** Lists required dependencies that can bind one workspace package to another. */
+function readWorkspaceDependencyNames(manifest, packageDirectory) {
+	const names = /* @__PURE__ */ new Set();
+	for (const binding of readWorkspaceDependencyBindings(manifest, packageDirectory)) {
+		names.add(binding.name);
+		const workspaceAlias = parseWorkspaceDependencyAlias(binding.specifier);
+		if (workspaceAlias) names.add(workspaceAlias.packageName);
+		const npmAlias = parseNpmDependencyAlias(binding.specifier);
+		if (npmAlias) names.add(npmAlias.packageName);
+		if (binding.specifier.startsWith("catalog:")) {
+			const installed = resolveInstalledJavaScriptPackage(packageDirectory, binding.name);
+			if (typeof installed?.manifest.name === "string") names.add(installed.manifest.name);
+		}
+		const localPackageName = readLocalDependencyPackageName(binding.specifier, packageDirectory);
+		if (localPackageName) names.add(localPackageName);
+	}
+	return [...names];
+}
+/** Reads installed dependencies and resolvable, non-optional required peers. */
+function readWorkspaceDependencyBindings(manifest, packageDirectory) {
+	return readDependencyBindings(manifest, packageDirectory, INSTALLED_DEPENDENCY_FIELDS);
+}
+/** Reads dependency edges that may propagate wrapper ownership to consumers. */
+function readPropagatingDependencyBindings(manifest, packageDirectory) {
+	return readDependencyBindings(manifest, packageDirectory, ["dependencies"]);
+}
+function readDependencyBindings(manifest, packageDirectory, fields) {
+	const bindings = [];
+	const seenBindings = /* @__PURE__ */ new Set();
+	const addBinding = (name, specifier) => {
+		const key = `${name}\0${specifier}`;
+		if (seenBindings.has(key)) return;
+		seenBindings.add(key);
+		bindings.push({
+			name,
+			specifier
+		});
+	};
+	for (const field of fields) for (const name of Object.keys(manifest[field] ?? {})) {
+		const specifier = readEffectiveDependencySpecifier(manifest, field, name);
+		if (specifier !== void 0) addBinding(name, specifier);
+	}
+	for (const [name, specifier] of Object.entries(manifest.peerDependencies ?? {})) if (typeof specifier === "string" && declaresAvailableRequiredPeerDependency(manifest, name, packageDirectory)) addBinding(name, specifier);
+	return bindings;
+}
+/**
+* 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.
+*/
+function resolveInstalledJavaScriptPackage(directory, bindingName) {
+	const packageSegments = readPackageNameSegments(bindingName);
+	if (!packageSegments) return void 0;
+	try {
+		const localRequire = createRequire(path.join(path.resolve(directory), "package.json"));
+		for (const modulesDirectory of localRequire.resolve.paths(bindingName) ?? []) {
+			const candidate = path.join(modulesDirectory, ...packageSegments);
+			let packageDirectory;
+			try {
+				packageDirectory = fs.realpathSync(candidate);
+			} catch {
+				continue;
+			}
+			const manifest = readJavaScriptPackageManifest(path.join(packageDirectory, "package.json"));
+			if (!manifest) return void 0;
+			return {
+				directory: packageDirectory,
+				manifest
+			};
+		}
+		try {
+			return findPackageBoundary(localRequire.resolve(bindingName));
+		} catch {}
+		const pnpLocation = resolvePnpPackageLocation(localRequire, bindingName, path.join(path.resolve(directory), "package.json"));
+		if (pnpLocation) return readPackageAtLocation(pnpLocation);
+	} catch {
+		return;
+	}
+}
+/** Resolves a package location through Yarn Plug'n'Play when it is active. */
+function resolvePnpPackageLocation(localRequire, bindingName, issuer) {
+	if (process.versions.pnp === void 0) return void 0;
+	try {
+		const location = localRequire("pnpapi").resolveToUnqualified?.(bindingName, issuer);
+		return typeof location === "string" ? location : void 0;
+	} catch {
+		return;
+	}
+}
+/** Reads a package whose resolver may return either its root or an entrypoint. */
+function readPackageAtLocation(location) {
+	try {
+		if (fs.statSync(location).isDirectory()) {
+			const packageDirectory = fs.realpathSync(location);
+			const manifest = readJavaScriptPackageManifest(path.join(packageDirectory, "package.json"));
+			return manifest ? {
+				directory: packageDirectory,
+				manifest
+			} : void 0;
+		}
+	} catch {
+		return;
+	}
+	let packageDirectory;
+	try {
+		packageDirectory = fs.realpathSync(location);
+	} catch {
+		packageDirectory = path.resolve(location);
+	}
+	const manifest = readJavaScriptPackageManifest(path.join(packageDirectory, "package.json"));
+	return manifest ? {
+		directory: packageDirectory,
+		manifest
+	} : findPackageBoundary(location);
+}
+function findPackageBoundary(entry) {
+	if (!path.isAbsolute(entry)) return void 0;
+	let directory = path.dirname(entry);
+	while (true) {
+		const manifest = readJavaScriptPackageManifest(path.join(directory, "package.json"));
+		if (manifest) return {
+			directory,
+			manifest
+		};
+		const parent = path.dirname(directory);
+		if (parent === directory) return void 0;
+		directory = parent;
+	}
+}
+/** Parses pnpm's explicit `workspace:alias@range` dependency syntax. */
+function parseWorkspaceDependencyAlias(specifier) {
+	if (!specifier.startsWith("workspace:")) return void 0;
+	const value = specifier.slice(10);
+	const separator = value.lastIndexOf("@");
+	if (separator <= 0) return void 0;
+	const packageName = value.slice(0, separator);
+	const range = value.slice(separator + 1);
+	if (!range || !readPackageNameSegments(packageName)) return void 0;
+	return {
+		packageName,
+		range
+	};
+}
+/** Reads the target package name from an npm alias dependency. */
+function parseNpmDependencyAlias(specifier) {
+	if (!specifier.startsWith("npm:")) return void 0;
+	const value = specifier.slice(4);
+	const separator = value.lastIndexOf("@");
+	const packageName = separator > 0 ? value.slice(0, separator) : value;
+	if (!readPackageNameSegments(packageName)) return void 0;
+	return {
+		packageName,
+		range: separator > 0 ? value.slice(separator + 1) : void 0
+	};
+}
+/** Reads a relative directory selected by an explicit local protocol. */
+function parseLocalDependencyPath(specifier) {
+	const localPath = specifier.match(/^(?:file|link|portal):(.+)$/)?.[1];
+	if (localPath) return localPath;
+	return specifier.match(/^workspace:(\.{1,2}(?:\/.*)?)$/)?.[1];
+}
+/** Checks whether one binding's declared range accepts a selected package. */
+function dependencyBindingAcceptsPackageVersion(binding, packageName, packageVersion) {
+	if (parseLocalDependencyPath(binding.specifier)) return true;
+	const workspaceAlias = parseWorkspaceDependencyAlias(binding.specifier);
+	if (workspaceAlias) return workspaceAlias.packageName === packageName && workspaceRangeAcceptsVersion(workspaceAlias.range, packageVersion);
+	const npmAlias = parseNpmDependencyAlias(binding.specifier);
+	if (npmAlias) return npmAlias.packageName === packageName && (npmAlias.range === void 0 || semverRangeAcceptsVersion(npmAlias.range, packageVersion, true));
+	if (binding.specifier.startsWith("catalog:")) return true;
+	if (binding.name !== packageName) return false;
+	if (binding.specifier.startsWith("workspace:")) return workspaceRangeAcceptsVersion(binding.specifier.slice(10), packageVersion);
+	return semverRangeAcceptsVersion(binding.specifier, packageVersion, true);
+}
+function canResolveDependencyBinding(directory, binding) {
+	const installed = resolveInstalledJavaScriptPackage(directory, binding.name);
+	const installedName = installed?.manifest.name;
+	if (!installed || typeof installedName !== "string") return false;
+	return installedName === (binding.specifier.startsWith("catalog:") ? installedName : parseWorkspaceDependencyAlias(binding.specifier)?.packageName ?? parseNpmDependencyAlias(binding.specifier)?.packageName ?? readLocalDependencyPackageName(binding.specifier, directory) ?? binding.name) && dependencyBindingAcceptsPackageVersion(binding, installedName, installed.manifest.version);
+}
+function declaresAvailableRequiredPeerDependency(manifest, packageName, packageDirectory) {
+	const specifier = manifest.peerDependencies?.[packageName];
+	if (typeof specifier !== "string" || manifest.peerDependenciesMeta?.[packageName]?.optional === true) return false;
+	return canResolveDependencyBinding(packageDirectory, {
+		name: packageName,
+		specifier
+	});
+}
+function readDependencySpecifier(manifest, field, packageName) {
+	const specifier = manifest[field]?.[packageName];
+	return typeof specifier === "string" ? specifier : void 0;
+}
+/** Applies npm's rule that an optional dependency replaces the same dependency. */
+function readEffectiveDependencySpecifier(manifest, field, packageName) {
+	if (field === "dependencies" && manifest.optionalDependencies !== void 0 && Object.prototype.hasOwnProperty.call(manifest.optionalDependencies, packageName)) return;
+	return readDependencySpecifier(manifest, field, packageName);
+}
+function readPackageNameSegments(packageName) {
+	if (!packageName || packageName.includes("\\")) return void 0;
+	const segments = packageName.split("/");
+	const isScoped = packageName.startsWith("@");
+	if (isScoped && segments.length !== 2 || !isScoped && segments.length !== 1) return;
+	return segments.every((segment) => segment && segment !== "." && segment !== "..") ? segments : void 0;
+}
+function readLocalDependencyPackageName(specifier, packageDirectory) {
+	const localPath = parseLocalDependencyPath(specifier);
+	if (!localPath) return void 0;
+	const packageName = readJavaScriptPackageManifest(path.join(path.resolve(packageDirectory, localPath), "package.json"))?.name;
+	return typeof packageName === "string" && packageName ? packageName : void 0;
+}
+function workspaceRangeAcceptsVersion(range, version) {
+	return range === "" || range === "*" || range === "^" || range === "~" || semverRangeAcceptsVersion(range, version, true);
+}
+function semverRangeAcceptsVersion(range, version, acceptOpaqueRange = false) {
+	const validRange$1 = validRange(range);
+	if (!validRange$1) return acceptOpaqueRange;
+	if (!version) return false;
+	try {
+		const validVersion = valid(version);
+		return Boolean(validVersion && satisfies(validVersion, validRange$1));
+	} catch {
+		return false;
+	}
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
+export { GT_VUE_PACKAGE, declaresAvailableJavaScriptDependency, declaresInstalledJavaScriptDependency, declaresWorkspaceJavaScriptDependency, dependencyBindingAcceptsPackageVersion, parseLocalDependencyPath, parseNpmDependencyAlias, parseWorkspaceDependencyAlias, readJavaScriptPackageManifest, readPropagatingDependencyBindings, readWorkspaceDependencyBindings, readWorkspaceDependencyNames, resolveInstalledJavaScriptPackage };
+
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":["validRange","validSemverRange","validSemver","satisfiesSemver"],"sources":["../../../src/internal/project/manifest.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\nimport {\n  satisfies as satisfiesSemver,\n  valid as validSemver,\n  validRange as validSemverRange,\n} from 'semver';\n\n/** Runtime package whose direct ownership activates Vue extraction. */\nexport const GT_VUE_PACKAGE = 'gt-vue';\n\n/** Dependency fields that declare a runtime installed for one package. */\nconst INSTALLED_DEPENDENCY_FIELDS = [\n  'dependencies',\n  'devDependencies',\n] as const;\n\n/** Minimal package manifest shape used by Vue project discovery. */\nexport type JavaScriptPackageManifest = {\n  name?: string;\n  version?: string;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  optionalDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n  peerDependenciesMeta?: Record<string, { optional?: boolean }>;\n  workspaces?: string[] | { packages?: string[] };\n};\n\n/** One dependency name and specifier as written by a consuming package. */\nexport type JavaScriptDependencyBinding = {\n  name: string;\n  specifier: string;\n};\n\n/** An installed package directory resolved without evaluating its entrypoint. */\nexport type InstalledJavaScriptPackage = {\n  directory: string;\n  manifest: JavaScriptPackageManifest;\n};\n\n/** Reads one package manifest without throwing for absent or malformed input. */\nexport function readJavaScriptPackageManifest(\n  packagePath: string\n): JavaScriptPackageManifest | undefined {\n  try {\n    const parsed = JSON.parse(fs.readFileSync(packagePath, 'utf8')) as unknown;\n    return isRecord(parsed) ? (parsed as JavaScriptPackageManifest) : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Checks dependency fields that make a runtime available to package code. */\nexport function declaresInstalledJavaScriptDependency(\n  manifest: JavaScriptPackageManifest,\n  packageName: string\n): boolean {\n  return INSTALLED_DEPENDENCY_FIELDS.some(\n    (field) =>\n      readEffectiveDependencySpecifier(manifest, field, packageName) !==\n      undefined\n  );\n}\n\n/** Checks direct ownership, requiring optional and peer runtimes to resolve. */\nexport function declaresAvailableJavaScriptDependency(\n  manifest: JavaScriptPackageManifest,\n  packageName: string,\n  packageDirectory: string\n): boolean {\n  if (\n    readEffectiveDependencySpecifier(\n      manifest,\n      'devDependencies',\n      packageName\n    ) !== undefined\n  ) {\n    return true;\n  }\n  const optionalSpecifier = readDependencySpecifier(\n    manifest,\n    'optionalDependencies',\n    packageName\n  );\n  if (optionalSpecifier !== undefined) {\n    return canResolveDependencyBinding(packageDirectory, {\n      name: packageName,\n      specifier: optionalSpecifier,\n    });\n  }\n  if (\n    readEffectiveDependencySpecifier(manifest, 'dependencies', packageName) !==\n    undefined\n  ) {\n    return true;\n  }\n  return declaresAvailableRequiredPeerDependency(\n    manifest,\n    packageName,\n    packageDirectory\n  );\n}\n\n/** Checks package ownership without promoting optional workspace integrations. */\nexport function declaresWorkspaceJavaScriptDependency(\n  manifest: JavaScriptPackageManifest,\n  packageName: string,\n  packageDirectory: string\n): boolean {\n  return (\n    declaresInstalledJavaScriptDependency(manifest, packageName) ||\n    declaresAvailableRequiredPeerDependency(\n      manifest,\n      packageName,\n      packageDirectory\n    )\n  );\n}\n\n/** Lists required dependencies that can bind one workspace package to another. */\nexport function readWorkspaceDependencyNames(\n  manifest: JavaScriptPackageManifest,\n  packageDirectory: string\n): string[] {\n  const names = new Set<string>();\n  for (const binding of readWorkspaceDependencyBindings(\n    manifest,\n    packageDirectory\n  )) {\n    names.add(binding.name);\n    const workspaceAlias = parseWorkspaceDependencyAlias(binding.specifier);\n    if (workspaceAlias) names.add(workspaceAlias.packageName);\n    const npmAlias = parseNpmDependencyAlias(binding.specifier);\n    if (npmAlias) names.add(npmAlias.packageName);\n    if (binding.specifier.startsWith('catalog:')) {\n      const installed = resolveInstalledJavaScriptPackage(\n        packageDirectory,\n        binding.name\n      );\n      if (typeof installed?.manifest.name === 'string') {\n        names.add(installed.manifest.name);\n      }\n    }\n    const localPackageName = readLocalDependencyPackageName(\n      binding.specifier,\n      packageDirectory\n    );\n    if (localPackageName) names.add(localPackageName);\n  }\n  return [...names];\n}\n\n/** Reads installed dependencies and resolvable, non-optional required peers. */\nexport function readWorkspaceDependencyBindings(\n  manifest: JavaScriptPackageManifest,\n  packageDirectory: string\n): JavaScriptDependencyBinding[] {\n  return readDependencyBindings(\n    manifest,\n    packageDirectory,\n    INSTALLED_DEPENDENCY_FIELDS\n  );\n}\n\n/** Reads dependency edges that may propagate wrapper ownership to consumers. */\nexport function readPropagatingDependencyBindings(\n  manifest: JavaScriptPackageManifest,\n  packageDirectory: string\n): JavaScriptDependencyBinding[] {\n  return readDependencyBindings(manifest, packageDirectory, ['dependencies']);\n}\n\nfunction readDependencyBindings(\n  manifest: JavaScriptPackageManifest,\n  packageDirectory: string,\n  fields: readonly (typeof INSTALLED_DEPENDENCY_FIELDS)[number][]\n): JavaScriptDependencyBinding[] {\n  const bindings: JavaScriptDependencyBinding[] = [];\n  const seenBindings = new Set<string>();\n  const addBinding = (name: string, specifier: string) => {\n    const key = `${name}\\0${specifier}`;\n    if (seenBindings.has(key)) return;\n    seenBindings.add(key);\n    bindings.push({ name, specifier });\n  };\n  for (const field of fields) {\n    for (const name of Object.keys(manifest[field] ?? {})) {\n      const specifier = readEffectiveDependencySpecifier(manifest, field, name);\n      if (specifier !== undefined) addBinding(name, specifier);\n    }\n  }\n  for (const [name, specifier] of Object.entries(\n    manifest.peerDependencies ?? {}\n  )) {\n    if (\n      typeof specifier === 'string' &&\n      declaresAvailableRequiredPeerDependency(manifest, name, packageDirectory)\n    ) {\n      addBinding(name, specifier);\n    }\n  }\n  return bindings;\n}\n\n/**\n * Resolves an installed package directory without selecting an export branch.\n *\n * `require.resolve()` is insufficient for availability checks because a valid\n * ESM package may intentionally expose only its `import` condition. Walking\n * Node's lookup directories finds the package boundary without importing user\n * code or depending on the package's public subpath exports.\n */\nexport function resolveInstalledJavaScriptPackage(\n  directory: string,\n  bindingName: string\n): InstalledJavaScriptPackage | undefined {\n  const packageSegments = readPackageNameSegments(bindingName);\n  if (!packageSegments) return undefined;\n\n  try {\n    const localRequire = createRequire(\n      path.join(path.resolve(directory), 'package.json')\n    );\n    for (const modulesDirectory of localRequire.resolve.paths(bindingName) ??\n      []) {\n      const candidate = path.join(modulesDirectory, ...packageSegments);\n      let packageDirectory: string;\n      try {\n        packageDirectory = fs.realpathSync(candidate);\n      } catch {\n        continue;\n      }\n      const manifest = readJavaScriptPackageManifest(\n        path.join(packageDirectory, 'package.json')\n      );\n      if (!manifest) return undefined;\n      return { directory: packageDirectory, manifest };\n    }\n    try {\n      const resolvedEntry = localRequire.resolve(bindingName);\n      return findPackageBoundary(resolvedEntry);\n    } catch {\n      // ESM-only packages can omit a `require` export.\n    }\n    const pnpLocation = resolvePnpPackageLocation(\n      localRequire,\n      bindingName,\n      path.join(path.resolve(directory), 'package.json')\n    );\n    if (pnpLocation) return readPackageAtLocation(pnpLocation);\n  } catch {\n    return undefined;\n  }\n  return undefined;\n}\n\n/** Resolves a package location through Yarn Plug'n'Play when it is active. */\nfunction resolvePnpPackageLocation(\n  localRequire: ReturnType<typeof createRequire>,\n  bindingName: string,\n  issuer: string\n): string | undefined {\n  if (process.versions.pnp === undefined) return undefined;\n  try {\n    const pnpApi = localRequire('pnpapi') as {\n      resolveToUnqualified?: (request: string, issuer: string) => string | null;\n    };\n    const location = pnpApi.resolveToUnqualified?.(bindingName, issuer);\n    return typeof location === 'string' ? location : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Reads a package whose resolver may return either its root or an entrypoint. */\nfunction readPackageAtLocation(\n  location: string\n): InstalledJavaScriptPackage | undefined {\n  try {\n    if (fs.statSync(location).isDirectory()) {\n      const packageDirectory = fs.realpathSync(location);\n      const manifest = readJavaScriptPackageManifest(\n        path.join(packageDirectory, 'package.json')\n      );\n      return manifest ? { directory: packageDirectory, manifest } : undefined;\n    }\n  } catch {\n    return undefined;\n  }\n\n  let packageDirectory: string;\n  try {\n    packageDirectory = fs.realpathSync(location);\n  } catch {\n    packageDirectory = path.resolve(location);\n  }\n  const manifest = readJavaScriptPackageManifest(\n    path.join(packageDirectory, 'package.json')\n  );\n  return manifest\n    ? { directory: packageDirectory, manifest }\n    : findPackageBoundary(location);\n}\n\nfunction findPackageBoundary(\n  entry: string\n): InstalledJavaScriptPackage | undefined {\n  if (!path.isAbsolute(entry)) return undefined;\n  let directory = path.dirname(entry);\n  while (true) {\n    const manifest = readJavaScriptPackageManifest(\n      path.join(directory, 'package.json')\n    );\n    if (manifest) return { directory, manifest };\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\n/** Parses pnpm's explicit `workspace:alias@range` dependency syntax. */\nexport function parseWorkspaceDependencyAlias(\n  specifier: string\n): { packageName: string; range: string } | undefined {\n  if (!specifier.startsWith('workspace:')) return undefined;\n  const value = specifier.slice('workspace:'.length);\n  const separator = value.lastIndexOf('@');\n  if (separator <= 0) return undefined;\n  const packageName = value.slice(0, separator);\n  const range = value.slice(separator + 1);\n  if (!range || !readPackageNameSegments(packageName)) return undefined;\n  return { packageName, range };\n}\n\n/** Reads the target package name from an npm alias dependency. */\nexport function parseNpmDependencyAlias(\n  specifier: string\n): { packageName: string; range?: string } | undefined {\n  if (!specifier.startsWith('npm:')) return undefined;\n  const value = specifier.slice('npm:'.length);\n  const separator = value.lastIndexOf('@');\n  const packageName = separator > 0 ? value.slice(0, separator) : value;\n  if (!readPackageNameSegments(packageName)) return undefined;\n  return {\n    packageName,\n    range: separator > 0 ? value.slice(separator + 1) : undefined,\n  };\n}\n\n/** Reads a relative directory selected by an explicit local protocol. */\nexport function parseLocalDependencyPath(\n  specifier: string\n): string | undefined {\n  const localPath = specifier.match(/^(?:file|link|portal):(.+)$/)?.[1];\n  if (localPath) return localPath;\n  return specifier.match(/^workspace:(\\.{1,2}(?:\\/.*)?)$/)?.[1];\n}\n\n/** Checks whether one binding's declared range accepts a selected package. */\nexport function dependencyBindingAcceptsPackageVersion(\n  binding: JavaScriptDependencyBinding,\n  packageName: string,\n  packageVersion: string | undefined\n): boolean {\n  if (parseLocalDependencyPath(binding.specifier)) return true;\n\n  const workspaceAlias = parseWorkspaceDependencyAlias(binding.specifier);\n  if (workspaceAlias) {\n    return (\n      workspaceAlias.packageName === packageName &&\n      workspaceRangeAcceptsVersion(workspaceAlias.range, packageVersion)\n    );\n  }\n\n  const npmAlias = parseNpmDependencyAlias(binding.specifier);\n  if (npmAlias) {\n    return (\n      npmAlias.packageName === packageName &&\n      (npmAlias.range === undefined ||\n        semverRangeAcceptsVersion(npmAlias.range, packageVersion, true))\n    );\n  }\n  if (binding.specifier.startsWith('catalog:')) return true;\n  if (binding.name !== packageName) return false;\n  if (binding.specifier.startsWith('workspace:')) {\n    return workspaceRangeAcceptsVersion(\n      binding.specifier.slice('workspace:'.length),\n      packageVersion\n    );\n  }\n  return semverRangeAcceptsVersion(binding.specifier, packageVersion, true);\n}\n\nfunction canResolveDependencyBinding(\n  directory: string,\n  binding: JavaScriptDependencyBinding\n): boolean {\n  const installed = resolveInstalledJavaScriptPackage(directory, binding.name);\n  const installedName = installed?.manifest.name;\n  if (!installed || typeof installedName !== 'string') return false;\n\n  const expectedName = binding.specifier.startsWith('catalog:')\n    ? installedName\n    : (parseWorkspaceDependencyAlias(binding.specifier)?.packageName ??\n      parseNpmDependencyAlias(binding.specifier)?.packageName ??\n      readLocalDependencyPackageName(binding.specifier, directory) ??\n      binding.name);\n  return (\n    installedName === expectedName &&\n    dependencyBindingAcceptsPackageVersion(\n      binding,\n      installedName,\n      installed.manifest.version\n    )\n  );\n}\n\nfunction declaresAvailableRequiredPeerDependency(\n  manifest: JavaScriptPackageManifest,\n  packageName: string,\n  packageDirectory: string\n): boolean {\n  const specifier = manifest.peerDependencies?.[packageName];\n  if (\n    typeof specifier !== 'string' ||\n    manifest.peerDependenciesMeta?.[packageName]?.optional === true\n  ) {\n    return false;\n  }\n  return canResolveDependencyBinding(packageDirectory, {\n    name: packageName,\n    specifier,\n  });\n}\n\nfunction readDependencySpecifier(\n  manifest: JavaScriptPackageManifest,\n  field: (typeof INSTALLED_DEPENDENCY_FIELDS)[number] | 'optionalDependencies',\n  packageName: string\n): string | undefined {\n  const specifier = manifest[field]?.[packageName];\n  return typeof specifier === 'string' ? specifier : undefined;\n}\n\n/** Applies npm's rule that an optional dependency replaces the same dependency. */\nfunction readEffectiveDependencySpecifier(\n  manifest: JavaScriptPackageManifest,\n  field: (typeof INSTALLED_DEPENDENCY_FIELDS)[number],\n  packageName: string\n): string | undefined {\n  if (\n    field === 'dependencies' &&\n    manifest.optionalDependencies !== undefined &&\n    Object.prototype.hasOwnProperty.call(\n      manifest.optionalDependencies,\n      packageName\n    )\n  ) {\n    return undefined;\n  }\n  return readDependencySpecifier(manifest, field, packageName);\n}\n\nfunction readPackageNameSegments(packageName: string): string[] | undefined {\n  if (!packageName || packageName.includes('\\\\')) return undefined;\n  const segments = packageName.split('/');\n  const isScoped = packageName.startsWith('@');\n  if (\n    (isScoped && segments.length !== 2) ||\n    (!isScoped && segments.length !== 1)\n  ) {\n    return undefined;\n  }\n  return segments.every(\n    (segment) => segment && segment !== '.' && segment !== '..'\n  )\n    ? segments\n    : undefined;\n}\n\nfunction readLocalDependencyPackageName(\n  specifier: string,\n  packageDirectory: string\n): string | undefined {\n  const localPath = parseLocalDependencyPath(specifier);\n  if (!localPath) return undefined;\n  const packageName = readJavaScriptPackageManifest(\n    path.join(path.resolve(packageDirectory, localPath), 'package.json')\n  )?.name;\n  return typeof packageName === 'string' && packageName\n    ? packageName\n    : undefined;\n}\n\nfunction workspaceRangeAcceptsVersion(\n  range: string,\n  version: string | undefined\n): boolean {\n  return (\n    range === '' ||\n    range === '*' ||\n    range === '^' ||\n    range === '~' ||\n    semverRangeAcceptsVersion(range, version, true)\n  );\n}\n\nfunction semverRangeAcceptsVersion(\n  range: string,\n  version: string | undefined,\n  acceptOpaqueRange = false\n): boolean {\n  const validRange = validSemverRange(range);\n  if (!validRange) return acceptOpaqueRange;\n  if (!version) return false;\n  try {\n    const validVersion = validSemver(version);\n    return Boolean(validVersion && satisfiesSemver(validVersion, validRange));\n  } catch {\n    return false;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+import type { Updates } from 'generaltranslation/types';
+import type { VueProjectExtractionOutput } from '../../types.js';
+/** Framework-neutral extraction output accepted by the CLI adapter. */
+export type InlineExtractionOutput = {
+    updates: Updates;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Appends Vue extraction to an existing framework catalog.
+ *
+ * Hash collisions represent one catalog entry. Their paths and source context
+ * are combined without duplicating identical locations, while the primary
+ * framework's ordering and catalog value remain authoritative. Primary input
+ * objects are never mutated and their diagnostics retain their original
+ * ordering and multiplicity.
+ */
+export declare function mergeVueProjectExtraction(primary: InlineExtractionOutput, vue: VueProjectExtractionOutput): InlineExtractionOutput;

package/dist/internal/project/mergeVueProjectExtraction.js

@@ -0,0 +1,79 @@
+//#region src/internal/project/mergeVueProjectExtraction.ts
+/**
+* Appends Vue extraction to an existing framework catalog.
+*
+* Hash collisions represent one catalog entry. Their paths and source context
+* are combined without duplicating identical locations, while the primary
+* framework's ordering and catalog value remain authoritative. Primary input
+* objects are never mutated and their diagnostics retain their original
+* ordering and multiplicity.
+*/
+function mergeVueProjectExtraction(primary, vue) {
+	return {
+		updates: mergeUpdates(primary.updates, vue.updates),
+		errors: [...primary.errors, ...vue.errors],
+		warnings: [...primary.warnings, ...vue.warnings]
+	};
+}
+function mergeUpdates(primary, vue) {
+	const updates = [...primary];
+	const byHash = new Map(updates.flatMap((update, index) => update.metadata.hash ? [[update.metadata.hash, index]] : []));
+	for (const update of vue) {
+		const compatibleUpdate = update;
+		const hash = update.metadata.hash;
+		const existingIndex = hash ? byHash.get(hash) : void 0;
+		if (existingIndex === void 0) {
+			if (hash) byHash.set(hash, updates.length);
+			updates.push(compatibleUpdate);
+			continue;
+		}
+		const existing = updates[existingIndex];
+		updates[existingIndex] = {
+			...existing,
+			metadata: {
+				...existing.metadata,
+				...mergeFilePaths(existing, compatibleUpdate),
+				...mergeSourceCode(existing, compatibleUpdate)
+			}
+		};
+	}
+	return updates;
+}
+function mergeFilePaths(existing, incoming) {
+	const paths = [...existing.metadata.filePaths ?? [], ...incoming.metadata.filePaths ?? []];
+	return paths.length > 0 ? { filePaths: [...new Set(paths)] } : {};
+}
+function mergeSourceCode(existing, incoming) {
+	const incomingSourceCode = asSourceCodeMap(incoming.metadata.sourceCode);
+	if (!incomingSourceCode) return {};
+	const currentSourceCode = existing.metadata.sourceCode;
+	const existingSourceCode = currentSourceCode === void 0 ? {} : asSourceCodeMap(currentSourceCode);
+	if (!existingSourceCode) return {};
+	const mergedSourceCode = Object.fromEntries(Object.entries(existingSourceCode).map(([file, entries]) => [file, [...entries]]));
+	for (const [file, entries] of Object.entries(incomingSourceCode)) {
+		const target = mergedSourceCode[file] ??= [];
+		const known = new Set(target.map(serializeSourceCodeEntry));
+		for (const entry of entries) {
+			const key = serializeSourceCodeEntry(entry);
+			if (known.has(key)) continue;
+			target.push(entry);
+			known.add(key);
+		}
+	}
+	return { sourceCode: mergedSourceCode };
+}
+function asSourceCodeMap(value) {
+	if (!isRecord(value)) return void 0;
+	if (!Object.values(value).every(Array.isArray)) return void 0;
+	return value;
+}
+function serializeSourceCodeEntry(entry) {
+	return JSON.stringify(entry);
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
+export { mergeVueProjectExtraction };
+
+//# sourceMappingURL=mergeVueProjectExtraction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mergeVueProjectExtraction.js","names":[],"sources":["../../../src/internal/project/mergeVueProjectExtraction.ts"],"sourcesContent":["import type { Updates } from 'generaltranslation/types';\nimport type {\n  VueProjectExtractionOutput,\n  VueProjectExtractionResult,\n} from '../../types.js';\n\n/** Framework-neutral extraction output accepted by the CLI adapter. */\nexport type InlineExtractionOutput = {\n  updates: Updates;\n  errors: string[];\n  warnings: string[];\n};\n\n/**\n * Appends Vue extraction to an existing framework catalog.\n *\n * Hash collisions represent one catalog entry. Their paths and source context\n * are combined without duplicating identical locations, while the primary\n * framework's ordering and catalog value remain authoritative. Primary input\n * objects are never mutated and their diagnostics retain their original\n * ordering and multiplicity.\n */\nexport function mergeVueProjectExtraction(\n  primary: InlineExtractionOutput,\n  vue: VueProjectExtractionOutput\n): InlineExtractionOutput {\n  return {\n    updates: mergeUpdates(primary.updates, vue.updates),\n    errors: [...primary.errors, ...vue.errors],\n    warnings: [...primary.warnings, ...vue.warnings],\n  };\n}\n\nfunction mergeUpdates(\n  primary: Updates,\n  vue: VueProjectExtractionResult[]\n): Updates {\n  const updates = [...primary];\n  const byHash = new Map(\n    updates.flatMap((update, index) =>\n      update.metadata.hash ? [[update.metadata.hash, index] as const] : []\n    )\n  );\n\n  for (const update of vue) {\n    // The shared Updates type predates boolean/null branch wire sources.\n    // Runtime consumers already accept them; keep the cast at this adapter.\n    const compatibleUpdate = update as Updates[number];\n    const hash = update.metadata.hash;\n    const existingIndex = hash ? byHash.get(hash) : undefined;\n    if (existingIndex === undefined) {\n      if (hash) byHash.set(hash, updates.length);\n      updates.push(compatibleUpdate);\n      continue;\n    }\n\n    const existing = updates[existingIndex]!;\n    updates[existingIndex] = {\n      ...existing,\n      metadata: {\n        ...existing.metadata,\n        ...mergeFilePaths(existing, compatibleUpdate),\n        ...mergeSourceCode(existing, compatibleUpdate),\n      },\n    };\n  }\n  return updates;\n}\n\nfunction mergeFilePaths(\n  existing: Updates[number],\n  incoming: Updates[number]\n): Pick<Updates[number]['metadata'], 'filePaths'> {\n  const paths = [\n    ...(existing.metadata.filePaths ?? []),\n    ...(incoming.metadata.filePaths ?? []),\n  ];\n  return paths.length > 0 ? { filePaths: [...new Set(paths)] } : {};\n}\n\nfunction mergeSourceCode(\n  existing: Updates[number],\n  incoming: Updates[number]\n): Pick<Updates[number]['metadata'], 'sourceCode'> {\n  const incomingSourceCode = asSourceCodeMap(incoming.metadata.sourceCode);\n  if (!incomingSourceCode) return {};\n\n  const currentSourceCode = existing.metadata.sourceCode;\n  const existingSourceCode =\n    currentSourceCode === undefined ? {} : asSourceCodeMap(currentSourceCode);\n  if (!existingSourceCode) return {};\n  const mergedSourceCode = Object.fromEntries(\n    Object.entries(existingSourceCode).map(([file, entries]) => [\n      file,\n      [...entries],\n    ])\n  );\n\n  for (const [file, entries] of Object.entries(incomingSourceCode)) {\n    const target = (mergedSourceCode[file] ??= []);\n    const known = new Set(target.map(serializeSourceCodeEntry));\n    for (const entry of entries) {\n      const key = serializeSourceCodeEntry(entry);\n      if (known.has(key)) continue;\n      target.push(entry);\n      known.add(key);\n    }\n  }\n  return { sourceCode: mergedSourceCode };\n}\n\ntype SourceCodeMap = Record<string, unknown[]>;\n\nfunction asSourceCodeMap(value: unknown): SourceCodeMap | undefined {\n  if (!isRecord(value)) return undefined;\n  if (!Object.values(value).every(Array.isArray)) return undefined;\n  return value as SourceCodeMap;\n}\n\nfunction serializeSourceCodeEntry(entry: unknown): string {\n  return JSON.stringify(entry);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n"],"mappings":";;;;;;;;;;AAsBA,SAAgB,0BACd,SACA,KACwB;AACxB,QAAO;EACL,SAAS,aAAa,QAAQ,SAAS,IAAI,QAAQ;EACnD,QAAQ,CAAC,GAAG,QAAQ,QAAQ,GAAG,IAAI,OAAO;EAC1C,UAAU,CAAC,GAAG,QAAQ,UAAU,GAAG,IAAI,SAAS;EACjD;;AAGH,SAAS,aACP,SACA,KACS;CACT,MAAM,UAAU,CAAC,GAAG,QAAQ;CAC5B,MAAM,SAAS,IAAI,IACjB,QAAQ,SAAS,QAAQ,UACvB,OAAO,SAAS,OAAO,CAAC,CAAC,OAAO,SAAS,MAAM,MAAM,CAAU,GAAG,EAAE,CACrE,CACF;AAED,MAAK,MAAM,UAAU,KAAK;EAGxB,MAAM,mBAAmB;EACzB,MAAM,OAAO,OAAO,SAAS;EAC7B,MAAM,gBAAgB,OAAO,OAAO,IAAI,KAAK,GAAG,KAAA;AAChD,MAAI,kBAAkB,KAAA,GAAW;AAC/B,OAAI,KAAM,QAAO,IAAI,MAAM,QAAQ,OAAO;AAC1C,WAAQ,KAAK,iBAAiB;AAC9B;;EAGF,MAAM,WAAW,QAAQ;AACzB,UAAQ,iBAAiB;GACvB,GAAG;GACH,UAAU;IACR,GAAG,SAAS;IACZ,GAAG,eAAe,UAAU,iBAAiB;IAC7C,GAAG,gBAAgB,UAAU,iBAAiB;IAC/C;GACF;;AAEH,QAAO;;AAGT,SAAS,eACP,UACA,UACgD;CAChD,MAAM,QAAQ,CACZ,GAAI,SAAS,SAAS,aAAa,EAAE,EACrC,GAAI,SAAS,SAAS,aAAa,EAAE,CACtC;AACD,QAAO,MAAM,SAAS,IAAI,EAAE,WAAW,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,EAAE,GAAG,EAAE;;AAGnE,SAAS,gBACP,UACA,UACiD;CACjD,MAAM,qBAAqB,gBAAgB,SAAS,SAAS,WAAW;AACxE,KAAI,CAAC,mBAAoB,QAAO,EAAE;CAElC,MAAM,oBAAoB,SAAS,SAAS;CAC5C,MAAM,qBACJ,sBAAsB,KAAA,IAAY,EAAE,GAAG,gBAAgB,kBAAkB;AAC3E,KAAI,CAAC,mBAAoB,QAAO,EAAE;CAClC,MAAM,mBAAmB,OAAO,YAC9B,OAAO,QAAQ,mBAAmB,CAAC,KAAK,CAAC,MAAM,aAAa,CAC1D,MACA,CAAC,GAAG,QAAQ,CACb,CAAC,CACH;AAED,MAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,mBAAmB,EAAE;EAChE,MAAM,SAAU,iBAAiB,UAAU,EAAE;EAC7C,MAAM,QAAQ,IAAI,IAAI,OAAO,IAAI,yBAAyB,CAAC;AAC3D,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,MAAM,yBAAyB,MAAM;AAC3C,OAAI,MAAM,IAAI,IAAI,CAAE;AACpB,UAAO,KAAK,MAAM;AAClB,SAAM,IAAI,IAAI;;;AAGlB,QAAO,EAAE,YAAY,kBAAkB;;AAKzC,SAAS,gBAAgB,OAA2C;AAClE,KAAI,CAAC,SAAS,MAAM,CAAE,QAAO,KAAA;AAC7B,KAAI,CAAC,OAAO,OAAO,MAAM,CAAC,MAAM,MAAM,QAAQ,CAAE,QAAO,KAAA;AACvD,QAAO;;AAGT,SAAS,yBAAyB,OAAwB;AACxD,QAAO,KAAK,UAAU,MAAM;;AAG9B,SAAS,SAAS,OAAkD;AAClE,QAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM"}

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

@@ -0,0 +1,18 @@
+import { type ConfigLoaderResult } from 'tsconfig-paths';
+import { type JavaScriptPackageManifest } from './manifest.js';
+/** Conditions used by the CLI when no project override is supplied. */
+export declare const DEFAULT_RESOLUTION_CONDITIONS: readonly ["module", "browser", "development|production"];
+type ProjectModuleResolverOptions = {
+    /** Package currently being inspected, for standards-compliant self imports. */
+    selfPackage?: {
+        directory: string;
+        manifest: JavaScriptPackageManifest;
+    };
+    /** Explicit tsconfig.json or jsconfig.json used for every importer. */
+    tsconfigPath?: string;
+};
+/** Loads one explicit config without honoring ambient ts-node overrides. */
+export declare function loadExplicitTypeScriptConfig(configPath: string): ConfigLoaderResult;
+/** Creates a deterministic, source-first resolver scoped to one extraction. */
+export declare function createProjectModuleResolver(conditionNames?: readonly string[], options?: ProjectModuleResolverOptions): (specifier: string, importer: string) => string | undefined;
+export {};