typesync 0.13.3 → 0.13.5-0

package/dist/type-syncer-C_rkDNfx.js

@@ -0,0 +1,320 @@
+import * as path$1 from "node:path";
+import * as path from "node:path";
+import { cosmiconfig } from "cosmiconfig";
+import fetch from "npm-registry-fetch";
+import { compare, parse } from "semver";
+
+//#region src/types.ts
+let IDependencySection = function(IDependencySection$1) {
+	IDependencySection$1["dev"] = "dev";
+	IDependencySection$1["deps"] = "deps";
+	IDependencySection$1["optional"] = "optional";
+	IDependencySection$1["peer"] = "peer";
+	return IDependencySection$1;
+}({});
+
+//#endregion
+//#region src/util.ts
+function uniq(source) {
+	return [...new Set(source)];
+}
+function shrinkObject(source) {
+	const object = {};
+	for (const key in source) if (source[key] !== undefined) object[key] = source[key];
+	return object;
+}
+function mergeObjects(source) {
+	return source.reduce((accum, next) => ({
+		...accum,
+		...next
+	}), {});
+}
+function typed(name) {
+	if (/^@.*?\//i.test(name)) {
+		const splat = name.split("/");
+		return `@types/${splat[0].slice(1)}__${splat[1]}`;
+	}
+	return `@types/${name}`;
+}
+function orderObject(source, comparer) {
+	const keys = Object.keys(source).sort(comparer);
+	const result = {};
+	for (const key of keys) result[key] = source[key];
+	return result;
+}
+function memoizeAsync(fn) {
+	const cache = new Map();
+	async function run(...args) {
+		try {
+			return await fn(...args);
+		} catch (err) {
+			cache.delete(args[0]);
+			throw err;
+		}
+	}
+	return async function(...args) {
+		const key = args[0];
+		if (cache.has(key)) return cache.get(key);
+		const p = run(...args);
+		cache.set(key, p);
+		return p;
+	};
+}
+function ensureWorkspacesArray(data) {
+	if (!data) return [];
+	if (!Array.isArray(data)) return ensureWorkspacesArray(data.packages);
+	if (!data.every((s) => typeof s === "string")) return [];
+	return data;
+}
+
+//#endregion
+//#region src/config-service.ts
+const explorer = cosmiconfig("typesync");
+function createConfigService() {
+	return { readConfig: async (filePath, flags) => {
+		const fileConfig = await explorer.search(path$1.dirname(filePath)).then((result) => result?.config ?? {});
+		const cliConfig = readCliConfig(flags);
+		return {
+			...shrinkObject(fileConfig),
+			...shrinkObject(cliConfig)
+		};
+	} };
+}
+function readCliConfig(flags) {
+	const readValues = (key, validator) => {
+		const values = flags[key];
+		return typeof values === "string" ? values.split(",").filter((value) => validator ? validator(value) : true) : undefined;
+	};
+	return {
+		ignoreDeps: readValues("ignoredeps", isIgnoreDepConfigValue),
+		ignorePackages: readValues("ignorepackages"),
+		ignoreProjects: readValues("ignoreprojects")
+	};
+}
+function isIgnoreDepConfigValue(value) {
+	return Object.keys(IDependencySection).includes(value);
+}
+
+//#endregion
+//#region src/package-source.ts
+function createPackageSource() {
+	return { fetch: async (name) => {
+		const response = await fetch(encodeURI(name)).catch((err) => {
+			if (err.statusCode === 404) return null;
+			throw err;
+		});
+		const data = await response?.json();
+		if (!data?.versions) return null;
+		const versionIdentifiers = Object.keys(data.versions).sort(compare).reverse();
+		const versions = versionIdentifiers.map((v) => {
+			const item = data.versions[v];
+			return {
+				version: item.version,
+				containsInternalTypings: !!item.types || !!item.typings
+			};
+		});
+		return {
+			name: data.name,
+			deprecated: Boolean(data.versions[versionIdentifiers[0]].deprecated),
+			latestVersion: data["dist-tags"].latest,
+			versions
+		};
+	} };
+}
+
+//#endregion
+//#region src/versioning.ts
+function getClosestMatchingVersion(availableVersions, version) {
+	const parsedVersion = parseVersion(version);
+	if (!parsedVersion) return availableVersions[0];
+	const bestMatch = availableVersions.find((v) => {
+		const parsedAvailableVersion = parseVersion(v.version);
+		if (!parsedAvailableVersion) return false;
+		if (parsedVersion.major !== parsedAvailableVersion.major) return false;
+		if (parsedVersion.minor !== parsedAvailableVersion.minor) return false;
+		return true;
+	});
+	return bestMatch ?? availableVersions[0];
+}
+/**
+* Parses the version if possible.
+*
+* @param version
+* @returns
+*/
+function parseVersion(version) {
+	return parse(cleanVersion(version));
+}
+/**
+* Cleans the version of any semver range specifiers.
+* @param version
+* @returns
+*/
+function cleanVersion(version) {
+	return version.replace(/^[\^~=\s]/, "");
+}
+
+//#endregion
+//#region src/type-syncer.ts
+function createTypeSyncer(packageJSONService, workspaceResolverService, packageSource, configService, globber) {
+	const fetchPackageInfo = memoizeAsync(packageSource.fetch);
+	return { sync };
+	/**
+	* Syncs typings in the specified package.json.
+	*/
+	async function sync(filePath, flags) {
+		const dryRun = !!flags.dry;
+		const syncOpts = await configService.readConfig(filePath, flags);
+		const { file, subManifests } = await getManifests(filePath, globber, syncOpts.ignoreProjects ?? []);
+		const syncedFiles = await Promise.all([syncFile(filePath, file, syncOpts, dryRun), ...subManifests.map(async (p) => syncFile(p, await packageJSONService.readPackageFile(p), syncOpts, dryRun))]);
+		return { syncedFiles };
+	}
+	/**
+	* Get the `package.json` files and sub-packages.
+	*
+	* @param filePath
+	* @param globber
+	*/
+	async function getManifests(filePath, globber$1, ignoredWorkspaces) {
+		const file = await packageJSONService.readPackageFile(filePath);
+		const subPackages = await workspaceResolverService.getWorkspaces(file, path.dirname(filePath), globber$1, ignoredWorkspaces);
+		const subManifests = subPackages.map((p) => path.join(p, "package.json"));
+		return {
+			file,
+			subManifests
+		};
+	}
+	/**
+	* Syncs a single file.
+	*
+	* @param filePath
+	* @param file
+	* @param allTypings
+	* @param opts
+	*/
+	async function syncFile(filePath, file, opts, dryRun) {
+		const { ignoreDeps, ignorePackages } = opts;
+		const allLocalPackages = Object.values(IDependencySection).map((dep) => {
+			const section = getDependenciesBySection(file, dep);
+			if (!section) return [];
+			const ignoredSection = ignoreDeps?.includes(dep);
+			return getPackagesFromSection(section, ignoredSection, ignorePackages);
+		}).flat();
+		const allPackageNames = uniq(allLocalPackages.map((p) => p.name));
+		const potentiallyUntypedPackages = getPotentiallyUntypedPackages(allPackageNames);
+		const used = [];
+		const devDepsToAdd = await Promise.all(potentiallyUntypedPackages.map(async (t) => {
+			const typePackageInfoPromise = fetchPackageInfo(t.typesPackageName);
+			const codePackageInfo = await fetchPackageInfo(t.codePackageName);
+			if (!codePackageInfo) return {};
+			const localCodePackage = allLocalPackages.find((p) => p.name === t.codePackageName);
+			const closestMatchingCodeVersion = getClosestMatchingVersion(codePackageInfo.versions, localCodePackage.version);
+			if (closestMatchingCodeVersion.containsInternalTypings) return {};
+			const typePackageInfo = await typePackageInfoPromise;
+			if (!typePackageInfo || typePackageInfo.deprecated) return {};
+			const closestMatchingTypingsVersion = getClosestMatchingVersion(typePackageInfo.versions, localCodePackage.version);
+			const version = closestMatchingTypingsVersion.version;
+			const semverRangeSpecifier = "~";
+			used.push(t);
+			return { [t.typesPackageName]: semverRangeSpecifier + version };
+		})).then(mergeObjects);
+		const devDeps = file.devDependencies;
+		if (!dryRun) {
+			const newPackageFile = { ...file };
+			if (Object.keys(devDepsToAdd).length > 0) {
+				newPackageFile.devDependencies = orderObject({
+					...devDepsToAdd,
+					...devDeps
+				});
+				await packageJSONService.writePackageFile(filePath, newPackageFile);
+			}
+		}
+		return {
+			filePath,
+			newTypings: used,
+			package: file
+		};
+	}
+}
+/**
+* Returns an array of packages that do not have a `@types/` package.
+*
+* @param allPackageNames Used to filter the typings that are new.
+* @param allTypings All typings available
+*/
+function getPotentiallyUntypedPackages(allPackageNames) {
+	const existingTypings = allPackageNames.filter((x) => x.startsWith("@types/"));
+	return allPackageNames.flatMap((p) => {
+		if (p.startsWith("@types/")) return [];
+		const typingsName = getTypingsName(p);
+		const fullTypingsPackage = typed(p);
+		const alreadyHasTyping = existingTypings.includes(fullTypingsPackage);
+		if (alreadyHasTyping) return [];
+		return [{
+			typingsName,
+			typesPackageName: fullTypingsPackage,
+			codePackageName: p
+		}];
+	});
+}
+/**
+* Gets the typings name for the specified package name.
+* For example, `koa` would be `koa`, but `@koa/router` would be `koa__router`.
+*
+* @param packageName the package name to generate the typings name for
+*/
+function getTypingsName(packageName) {
+	const scopeInfo = getPackageScope(packageName);
+	return scopeInfo && scopeInfo[0] !== "types" ? `${scopeInfo[0]}__${scopeInfo[1]}` : packageName;
+}
+/**
+* If a package is scoped, returns the scope + package as a tuple, otherwise null.
+*
+* @param packageName Package name to check scope for.
+*/
+function getPackageScope(packageName) {
+	const EXPR = /^@([^/]+)\/(.*)$/i;
+	const matches = EXPR.exec(packageName);
+	if (!matches) return null;
+	return [matches[1], matches[2]];
+}
+/**
+* Get packages from a dependency section
+*
+* @param section
+* @param ignoredSection
+* @param ignorePackages
+*/
+function getPackagesFromSection(section, ignoredSection, ignorePackages) {
+	return Object.keys(section).flatMap((name) => {
+		const isTyping = name.startsWith("@types/");
+		if (!isTyping) {
+			if (ignoredSection || ignorePackages?.includes(name)) return [];
+		}
+		return [{
+			name,
+			version: section[name]
+		}];
+	});
+}
+/**
+* Get dependencies from a package section
+*
+* @param file Package file
+* @param section Package section, eg: dev, peer
+*/
+function getDependenciesBySection(file, section) {
+	const dependenciesSection = (() => {
+		switch (section) {
+			case IDependencySection.deps: return file.dependencies;
+			case IDependencySection.dev: return file.devDependencies;
+			case IDependencySection.optional: return file.optionalDependencies;
+			case IDependencySection.peer: return file.peerDependencies;
+		}
+	})();
+	return dependenciesSection;
+}
+
+//#endregion
+export { IDependencySection, createConfigService, createPackageSource, createTypeSyncer, ensureWorkspacesArray, uniq };
+//# sourceMappingURL=type-syncer-C_rkDNfx.js.map

package/dist/type-syncer-C_rkDNfx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-syncer-C_rkDNfx.js","names":["source: Array<T>","source: T","object: Partial<T>","name: string","comparer?: (a: string, b: string) => number","result: Record<string, U>","fn: (...args: U) => Promise<V>","data?: IWorkspacesSection","filePath: string","flags: ICLIArguments['flags']","fileConfig: ISyncOptions","key: string","validator?: (value: string) => boolean","value: string","availableVersions: Array<IPackageVersionInfo>","version: string","packageJSONService: IPackageJSONService","workspaceResolverService: IWorkspaceResolverService","packageSource: IPackageSource","configService: IConfigService","globber: IGlobber","filePath: string","flags: ICLIArguments['flags']","syncedFiles: Array<ISyncedFile>","ignoredWorkspaces: IWorkspacesArray","globber","file: IPackageFile","opts: ISyncOptions","dryRun: boolean","used: ReturnType<typeof getPotentiallyUntypedPackages>","newPackageFile: IPackageFile","allPackageNames: Array<string>","packageName: string","section: IDependenciesSection","ignoredSection?: boolean","ignorePackages?: Array<string>","section: IDependencySection"],"sources":["../src/types.ts","../src/util.ts","../src/config-service.ts","../src/package-source.ts","../src/versioning.ts","../src/type-syncer.ts"],"sourcesContent":["import type { IWorkspacesArray, IWorkspacesSection } from './workspace-resolver'\n\n/**\n * The guts of the program.\n */\nexport interface ITypeSyncer {\n  sync(\n    this: void,\n    filePath: string,\n    flags: ICLIArguments['flags'],\n  ): Promise<ISyncResult>\n}\n\n/**\n * Sync options.\n */\nexport interface ISyncOptions {\n  /**\n   * Ignore certain deps.\n   */\n  ignoreDeps?: Array<IDependencySection>\n\n  /**\n   * Ignore certain packages.\n   */\n  ignorePackages?: Array<string>\n\n  /**\n   * Skip resolution of certain projects in the workspace.\n   */\n  ignoreProjects?: IWorkspacesArray\n}\n\n/**\n * Package.json file.\n */\nexport interface IPackageFile {\n  name?: string\n  dependencies?: IDependenciesSection\n  devDependencies?: IDependenciesSection\n  peerDependencies?: IDependenciesSection\n  optionalDependencies?: IDependenciesSection\n  workspaces?: IWorkspacesSection\n  [key: string]: unknown\n}\n\n/**\n * Section in package.json representing dependencies.\n */\nexport type IDependenciesSection = Record<string, string>\n\n/**\n * Package + version record, collected from the {\"package\": \"^1.2.3\"} sections.\n */\nexport interface IPackageVersion {\n  name: string\n  version: string\n}\n\n/**\n * Describes how a package may be typed.\n */\nexport interface IPackageTypingDescriptor {\n  typingsName: string\n  codePackageName: string\n  typesPackageName: string\n}\n\n/**\n * A type definition with the corresponding code package name.\n */\nexport interface ISyncedTypeDefinition extends IPackageTypingDescriptor {\n  codePackageName: string\n}\n\n/**\n * Sync result.\n */\nexport interface ISyncResult {\n  /**\n   * The files that were synced.\n   */\n  syncedFiles: Array<ISyncedFile>\n}\n\n/**\n * A file that was synced.\n */\nexport interface ISyncedFile {\n  /**\n   * The cwd-relative path to the synced file.\n   */\n  filePath: string\n  /**\n   * The package file that was synced.\n   */\n  package: IPackageFile\n  /**\n   * The new typings that were added.\n   */\n  newTypings: Array<ISyncedTypeDefinition>\n}\n\n/**\n * Dependency sections.\n */\nexport enum IDependencySection {\n  dev = 'dev',\n  deps = 'deps',\n  optional = 'optional',\n  peer = 'peer',\n}\n\n/**\n * CLI arguments.\n */\nexport interface ICLIArguments {\n  flags: Record<string, boolean | string | undefined>\n  args: Array<string>\n}\n","import type { IWorkspacesArray, IWorkspacesSection } from './workspace-resolver'\n\n/**\n * Returns unique items.\n *\n * @param source The source to filter\n */\nexport function uniq<T>(source: Array<T>): Array<T> {\n  return [...new Set(source)]\n}\n\n/**\n * Remove blank attributes in a object.\n *\n * @param source\n */\nexport function shrinkObject<T extends object>(source: T): Partial<T> {\n  const object: Partial<T> = {}\n\n  for (const key in source) {\n    if (source[key] !== undefined) {\n      object[key] = source[key]\n    }\n  }\n\n  return object\n}\n\n/**\n * Merges a sequence of objects into a single object using `reduce`.\n *\n * @param source An array of objects to merge.\n */\nexport function mergeObjects<T>(source: Array<T>): T {\n  return source.reduce((accum, next) => ({ ...accum, ...next }), {} as T)\n}\n\n/**\n * Returns the assumed types package name.\n * @param name Package name\n */\nexport function typed(name: string): string {\n  // If the package is scoped, the typings scheme is slightly different.\n  if (/^@.*?\\//i.test(name)) {\n    const splat = name.split('/')\n    return `@types/${splat[0].slice(1)}__${splat[1]}`\n  }\n\n  return `@types/${name}`\n}\n\n/**\n * Returns the assumed code package name based on a types package name.\n * @param name\n */\nexport function untyped(name: string): string {\n  const prefix = '@types/'\n  if (!name.startsWith(prefix)) {\n    return name\n  }\n  name = name.substring(prefix.length)\n  const splat = name.split('__')\n  if (splat.length === 2) {\n    return `@${splat[0]}/${splat[1]}`\n  }\n  return name\n}\n\n/**\n * Orders an object.\n * @param source\n */\nexport function orderObject<T extends Record<string | number | symbol, U>, U>(\n  source: T,\n  comparer?: (a: string, b: string) => number,\n): T {\n  const keys = Object.keys(source).sort(comparer)\n  const result: Record<string, U> = {}\n  for (const key of keys) {\n    result[key] = source[key]\n  }\n\n  return result as T\n}\n\n/**\n * Async memoize.\n *\n * @param fn\n */\nexport function memoizeAsync<U extends Array<W>, V, W>(\n  fn: (...args: U) => Promise<V>,\n) {\n  const cache = new Map<W, Promise<V>>()\n\n  async function run(...args: U): Promise<V> {\n    try {\n      return await fn(...args)\n    } catch (err) {\n      cache.delete(args[0])\n      throw err\n    }\n  }\n\n  return async function (...args: U): Promise<V> {\n    const key = args[0]\n    if (cache.has(key)) {\n      return cache.get(key)!\n    }\n\n    const p = run(...args)\n    cache.set(key, p)\n    return p\n  }\n}\n\n/**\n * Ensures that we have a valid workspaces array.\n *\n * @param data\n */\nexport function ensureWorkspacesArray(\n  data?: IWorkspacesSection,\n): IWorkspacesArray {\n  if (!data) {\n    return []\n  }\n\n  if (!Array.isArray(data)) {\n    return ensureWorkspacesArray(data.packages)\n  }\n\n  if (!data.every((s) => typeof s === 'string')) {\n    return []\n  }\n\n  return data\n}\n","import * as path from 'node:path'\nimport { cosmiconfig } from 'cosmiconfig'\nimport {\n  type ICLIArguments,\n  IDependencySection,\n  type ISyncOptions,\n} from './types'\nimport { shrinkObject } from './util'\n\n/**\n * Config Service.\n */\nexport interface IConfigService {\n  /**\n   * Get typesync config.\n   */\n  readConfig(\n    this: void,\n    filePath: string,\n    flags: ICLIArguments['flags'],\n  ): Promise<ISyncOptions>\n}\n\nconst explorer = cosmiconfig('typesync')\n\nexport function createConfigService(): IConfigService {\n  return {\n    readConfig: async (filePath: string, flags: ICLIArguments['flags']) => {\n      const fileConfig: ISyncOptions = await explorer\n        .search(path.dirname(filePath))\n        .then((result) => /* v8 ignore next */ result?.config ?? {})\n\n      const cliConfig = readCliConfig(flags)\n\n      return { ...shrinkObject(fileConfig), ...shrinkObject(cliConfig) }\n    },\n  }\n}\n\nfunction readCliConfig(flags: ICLIArguments['flags']): ISyncOptions {\n  const readValues = <T extends string>(\n    key: string,\n    validator?: (value: string) => boolean,\n  ): Array<T> | undefined => {\n    const values = flags[key]\n    return typeof values === 'string'\n      ? values\n          .split(',')\n          .filter((value): value is T => (validator ? validator(value) : true))\n      : undefined\n  }\n\n  return {\n    ignoreDeps: readValues('ignoredeps', isIgnoreDepConfigValue),\n    ignorePackages: readValues('ignorepackages'),\n    ignoreProjects: readValues('ignoreprojects'),\n  }\n}\n\nfunction isIgnoreDepConfigValue(value: string): value is IDependencySection {\n  return Object.keys(IDependencySection).includes(value)\n}\n","import fetch from 'npm-registry-fetch'\nimport { compare } from 'semver'\nimport type { IPackageVersionInfo } from './versioning'\n\n/**\n * Fetches info about a package.\n */\nexport interface IPackageSource {\n  /**\n   * Fetches package info from an external source.\n   *\n   * @param packageName\n   */\n  fetch(this: void, packageName: string): Promise<IPackageInfo | null>\n}\n\n/**\n * Interface for the Package Info structure.\n */\nexport interface IPackageInfo {\n  name: string\n  latestVersion: string\n  deprecated: boolean\n  versions: Array<IPackageVersionInfo>\n}\n\n/**\n * Creates a package source.\n */\nexport function createPackageSource(): IPackageSource {\n  return {\n    /**\n     * Fetches info about a package, or `null` if not found.\n     */\n    fetch: async (name) => {\n      const response = await fetch(encodeURI(name)).catch((err) => {\n        if (err.statusCode === 404) {\n          return null\n          /* v8 ignore next */\n        }\n\n        /* v8 ignore next */\n        throw err\n      })\n\n      const data = await response?.json()\n\n      if (!data?.versions) {\n        return null\n      }\n\n      const versionIdentifiers = Object.keys(data.versions)\n        .sort(compare)\n        .reverse()\n      const versions = versionIdentifiers.map<IPackageVersionInfo>((v) => {\n        const item = data.versions[v]\n        return {\n          version: item.version,\n          containsInternalTypings: !!item.types || !!item.typings,\n        }\n      })\n\n      return {\n        name: data.name,\n        deprecated: Boolean(data.versions[versionIdentifiers[0]].deprecated),\n        latestVersion: data['dist-tags'].latest,\n        // Sort by version, highest version first.\n        versions: versions,\n      }\n    },\n  }\n}\n","import { parse } from 'semver'\n\n/**\n * Version descriptor for versions returned in remote package info.\n */\nexport interface IPackageVersionInfo {\n  version: string\n  containsInternalTypings: boolean\n}\n\n/**\n * Gets the closest matching package version info.\n *\n * @param availableVersions\n * @param version\n */\nexport function getClosestMatchingVersion(\n  availableVersions: Array<IPackageVersionInfo>,\n  version: string,\n): IPackageVersionInfo {\n  const parsedVersion = parseVersion(version)\n  if (!parsedVersion) {\n    return availableVersions[0]\n  }\n\n  const bestMatch = availableVersions.find((v) => {\n    const parsedAvailableVersion = parseVersion(v.version)\n    if (!parsedAvailableVersion) {\n      return false\n    }\n\n    if (parsedVersion.major !== parsedAvailableVersion.major) {\n      return false\n    }\n\n    if (parsedVersion.minor !== parsedAvailableVersion.minor) {\n      return false\n    }\n\n    return true\n  })\n\n  return bestMatch ?? availableVersions[0]\n}\n\n/**\n * Parses the version if possible.\n *\n * @param version\n * @returns\n */\nfunction parseVersion(version: string) {\n  return parse(cleanVersion(version))\n}\n\n/**\n * Cleans the version of any semver range specifiers.\n * @param version\n * @returns\n */\nfunction cleanVersion(version: string) {\n  return version.replace(/^[\\^~=\\s]/, '')\n}\n","import * as path from 'node:path'\nimport type { IConfigService } from './config-service'\nimport type { IGlobber } from './globber'\nimport type { IPackageJSONService } from './package-json-file-service'\nimport type { IPackageSource } from './package-source'\nimport {\n  type ICLIArguments,\n  type IDependenciesSection,\n  IDependencySection,\n  type IPackageFile,\n  type IPackageTypingDescriptor,\n  type IPackageVersion,\n  type ISyncOptions,\n  type ISyncResult,\n  type ISyncedFile,\n  type ITypeSyncer,\n} from './types'\nimport { memoizeAsync, mergeObjects, orderObject, typed, uniq } from './util'\nimport { getClosestMatchingVersion } from './versioning'\nimport type {\n  IWorkspaceResolverService,\n  IWorkspacesArray,\n} from './workspace-resolver'\n\n/**\n * Creates a type syncer.\n *\n * @param packageJSONservice\n * @param typeDefinitionSource\n */\nexport function createTypeSyncer(\n  packageJSONService: IPackageJSONService,\n  workspaceResolverService: IWorkspaceResolverService,\n  packageSource: IPackageSource,\n  configService: IConfigService,\n  globber: IGlobber,\n): ITypeSyncer {\n  const fetchPackageInfo = memoizeAsync(packageSource.fetch)\n\n  return {\n    sync,\n  }\n\n  /**\n   * Syncs typings in the specified package.json.\n   */\n  async function sync(\n    filePath: string,\n    flags: ICLIArguments['flags'],\n  ): Promise<ISyncResult> {\n    const dryRun = !!flags.dry\n    const syncOpts = await configService.readConfig(filePath, flags)\n    const { file, subManifests } = await getManifests(\n      filePath,\n      globber,\n      syncOpts.ignoreProjects ?? [],\n    )\n\n    const syncedFiles: Array<ISyncedFile> = await Promise.all([\n      syncFile(filePath, file, syncOpts, dryRun),\n      ...subManifests.map(async (p) =>\n        syncFile(\n          p,\n          await packageJSONService.readPackageFile(p),\n          syncOpts,\n          dryRun,\n        ),\n      ),\n    ])\n\n    return {\n      syncedFiles,\n    }\n  }\n\n  /**\n   * Get the `package.json` files and sub-packages.\n   *\n   * @param filePath\n   * @param globber\n   */\n  async function getManifests(\n    filePath: string,\n    globber: IGlobber,\n    ignoredWorkspaces: IWorkspacesArray,\n  ) {\n    const file = await packageJSONService.readPackageFile(filePath)\n    const subPackages = await workspaceResolverService.getWorkspaces(\n      file,\n      path.dirname(filePath),\n      globber,\n      ignoredWorkspaces,\n    )\n    const subManifests = subPackages.map((p) => path.join(p, 'package.json'))\n\n    return {\n      file,\n      subManifests,\n    }\n  }\n\n  /**\n   * Syncs a single file.\n   *\n   * @param filePath\n   * @param file\n   * @param allTypings\n   * @param opts\n   */\n  async function syncFile(\n    filePath: string,\n    file: IPackageFile,\n    opts: ISyncOptions,\n    dryRun: boolean,\n  ): Promise<ISyncedFile> {\n    const { ignoreDeps, ignorePackages } = opts\n\n    const allLocalPackages = Object.values(IDependencySection)\n      .map((dep) => {\n        const section = getDependenciesBySection(file, dep)\n        if (!section) return []\n\n        const ignoredSection = ignoreDeps?.includes(dep)\n        return getPackagesFromSection(section, ignoredSection, ignorePackages)\n      })\n      .flat()\n    const allPackageNames = uniq(allLocalPackages.map((p) => p.name))\n    const potentiallyUntypedPackages =\n      getPotentiallyUntypedPackages(allPackageNames)\n\n    // This is pushed to in the inner `map`, because packages that have DT-typings\n    // *as well* as internal typings should be excluded.\n    const used: ReturnType<typeof getPotentiallyUntypedPackages> = []\n    const devDepsToAdd = await Promise.all(\n      potentiallyUntypedPackages.map(async (t) => {\n        // Fetch the code package from the source.\n        const typePackageInfoPromise = fetchPackageInfo(t.typesPackageName)\n        const codePackageInfo = await fetchPackageInfo(t.codePackageName)\n\n        // If the code package was not found, there's nothing else to do.\n        if (!codePackageInfo) {\n          return {}\n        }\n\n        const localCodePackage = allLocalPackages.find(\n          (p) => p.name === t.codePackageName,\n        )!\n\n        // Find the closest matching code package version relative to what's in our package.json\n        const closestMatchingCodeVersion = getClosestMatchingVersion(\n          codePackageInfo.versions,\n          localCodePackage.version,\n        )\n\n        // If the closest matching version contains internal typings, don't include it.\n        if (closestMatchingCodeVersion.containsInternalTypings) {\n          return {}\n        }\n\n        // Look for the closest matching typings package.\n        const typePackageInfo = await typePackageInfoPromise\n\n        // If the types package was not found, or if it was deprecated, there's nothing else to do.\n        if (!typePackageInfo || typePackageInfo.deprecated) {\n          return {}\n        }\n\n        // Gets the closest matching typings version, or the newest one.\n        const closestMatchingTypingsVersion = getClosestMatchingVersion(\n          typePackageInfo.versions,\n          localCodePackage.version,\n        )\n\n        const version = closestMatchingTypingsVersion.version\n        const semverRangeSpecifier = '~'\n        used.push(t)\n        return {\n          [t.typesPackageName]: semverRangeSpecifier + version,\n        }\n      }),\n    ).then(mergeObjects)\n    const devDeps = file.devDependencies\n    if (!dryRun) {\n      const newPackageFile: IPackageFile = { ...file }\n\n      if (Object.keys(devDepsToAdd).length > 0) {\n        newPackageFile.devDependencies = orderObject({\n          ...devDepsToAdd,\n          ...devDeps,\n        })\n\n        await packageJSONService.writePackageFile(filePath, newPackageFile)\n      }\n    }\n\n    return {\n      filePath,\n      newTypings: used,\n      package: file,\n    }\n  }\n}\n\n/**\n * Returns an array of packages that do not have a `@types/` package.\n *\n * @param allPackageNames Used to filter the typings that are new.\n * @param allTypings All typings available\n */\nfunction getPotentiallyUntypedPackages(\n  allPackageNames: Array<string>,\n): Array<IPackageTypingDescriptor> {\n  const existingTypings = allPackageNames.filter((x) => x.startsWith('@types/'))\n\n  return allPackageNames.flatMap((p) => {\n    // Ignore typings packages themselves.\n    if (p.startsWith('@types/')) {\n      return []\n    }\n\n    const typingsName = getTypingsName(p)\n    const fullTypingsPackage = typed(p)\n    const alreadyHasTyping = existingTypings.includes(fullTypingsPackage)\n    if (alreadyHasTyping) {\n      return []\n    }\n\n    return [\n      {\n        typingsName: typingsName,\n        typesPackageName: fullTypingsPackage,\n        codePackageName: p,\n      },\n    ]\n  })\n}\n\n/**\n * Gets the typings name for the specified package name.\n * For example, `koa` would be `koa`, but `@koa/router` would be `koa__router`.\n *\n * @param packageName the package name to generate the typings name for\n */\nfunction getTypingsName(packageName: string) {\n  const scopeInfo = getPackageScope(packageName)\n\n  return scopeInfo && scopeInfo[0] !== 'types'\n    ? `${scopeInfo[0]}__${scopeInfo[1]}`\n    : packageName\n}\n\n/**\n * If a package is scoped, returns the scope + package as a tuple, otherwise null.\n *\n * @param packageName Package name to check scope for.\n */\nfunction getPackageScope(packageName: string): [string, string] | null {\n  const EXPR = /^@([^/]+)\\/(.*)$/i\n  const matches = EXPR.exec(packageName)\n  if (!matches) {\n    return null\n  }\n\n  return [matches[1], matches[2]]\n}\n\n/**\n * Get packages from a dependency section\n *\n * @param section\n * @param ignoredSection\n * @param ignorePackages\n */\nfunction getPackagesFromSection(\n  section: IDependenciesSection,\n  ignoredSection?: boolean,\n  ignorePackages?: Array<string>,\n): Array<IPackageVersion> {\n  return Object.keys(section).flatMap((name) => {\n    const isTyping = name.startsWith('@types/')\n\n    // Never ignore `@types` packages.\n    if (!isTyping) {\n      // If it's not a `@types` package, check whether the section or package is ignored.\n      // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- We want to check for false as well.\n      if (ignoredSection || ignorePackages?.includes(name)) {\n        return []\n      }\n    }\n\n    return [{ name, version: section[name] }]\n  })\n}\n\n/**\n * Get dependencies from a package section\n *\n * @param file Package file\n * @param section Package section, eg: dev, peer\n */\nfunction getDependenciesBySection(\n  file: IPackageFile,\n  section: IDependencySection,\n): IDependenciesSection | undefined {\n  const dependenciesSection = (() => {\n    switch (section) {\n      case IDependencySection.deps:\n        return file.dependencies\n      case IDependencySection.dev:\n        return file.devDependencies\n      case IDependencySection.optional:\n        return file.optionalDependencies\n      case IDependencySection.peer:\n        return file.peerDependencies\n    }\n  })()\n  return dependenciesSection\n}\n"],"mappings":"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"}

package/dist/type-syncer.d.ts

@@ -0,0 +1,13 @@
+import type { IConfigService } from "./config-service.js";
+import type { IGlobber } from "./globber.js";
+import type { IPackageJSONService } from "./package-json-file-service.js";
+import type { IPackageSource } from "./package-source.js";
+import { type ITypeSyncer } from "./types.js";
+import type { IWorkspaceResolverService } from "./workspace-resolver.js";
+/**
+* Creates a type syncer.
+*
+* @param packageJSONservice
+* @param typeDefinitionSource
+*/
+export declare function createTypeSyncer(packageJSONService: IPackageJSONService, workspaceResolverService: IWorkspaceResolverService, packageSource: IPackageSource, configService: IConfigService, globber: IGlobber): ITypeSyncer;

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+import type { IWorkspacesArray, IWorkspacesSection } from "./workspace-resolver.js";
+/**
+* The guts of the program.
+*/
+export interface ITypeSyncer {
+	sync(this: void, filePath: string, flags: ICLIArguments["flags"]): Promise<ISyncResult>;
+}
+/**
+* Sync options.
+*/
+export interface ISyncOptions {
+	/**
+	* Ignore certain deps.
+	*/
+	ignoreDeps?: Array<IDependencySection>;
+	/**
+	* Ignore certain packages.
+	*/
+	ignorePackages?: Array<string>;
+	/**
+	* Skip resolution of certain projects in the workspace.
+	*/
+	ignoreProjects?: IWorkspacesArray;
+}
+/**
+* Package.json file.
+*/
+export interface IPackageFile {
+	name?: string;
+	dependencies?: IDependenciesSection;
+	devDependencies?: IDependenciesSection;
+	peerDependencies?: IDependenciesSection;
+	optionalDependencies?: IDependenciesSection;
+	workspaces?: IWorkspacesSection;
+	[key: string]: unknown;
+}
+/**
+* Section in package.json representing dependencies.
+*/
+export type IDependenciesSection = Record<string, string>;
+/**
+* Package + version record, collected from the {"package": "^1.2.3"} sections.
+*/
+export interface IPackageVersion {
+	name: string;
+	version: string;
+}
+/**
+* Describes how a package may be typed.
+*/
+export interface IPackageTypingDescriptor {
+	typingsName: string;
+	codePackageName: string;
+	typesPackageName: string;
+}
+/**
+* A type definition with the corresponding code package name.
+*/
+export interface ISyncedTypeDefinition extends IPackageTypingDescriptor {
+	codePackageName: string;
+}
+/**
+* Sync result.
+*/
+export interface ISyncResult {
+	/**
+	* The files that were synced.
+	*/
+	syncedFiles: Array<ISyncedFile>;
+}
+/**
+* A file that was synced.
+*/
+export interface ISyncedFile {
+	/**
+	* The cwd-relative path to the synced file.
+	*/
+	filePath: string;
+	/**
+	* The package file that was synced.
+	*/
+	package: IPackageFile;
+	/**
+	* The new typings that were added.
+	*/
+	newTypings: Array<ISyncedTypeDefinition>;
+}
+/**
+* Dependency sections.
+*/
+export declare enum IDependencySection {
+	dev = "dev",
+	deps = "deps",
+	optional = "optional",
+	peer = "peer",
+}
+/**
+* CLI arguments.
+*/
+export interface ICLIArguments {
+	flags: Record<string, boolean | string | undefined>;
+	args: Array<string>;
+}

package/dist/util.d.ts

@@ -0,0 +1,53 @@
+import type { IWorkspacesArray, IWorkspacesSection } from "./workspace-resolver.js";
+/**
+* Returns unique items.
+*
+* @param source The source to filter
+*/
+export declare function uniq<T>(source: Array<T>): Array<T>;
+/**
+* Remove blank attributes in a object.
+*
+* @param source
+*/
+export declare function shrinkObject<T extends object>(source: T): Partial<T>;
+/**
+* Merges a sequence of objects into a single object using `reduce`.
+*
+* @param source An array of objects to merge.
+*/
+export declare function mergeObjects<T>(source: Array<T>): T;
+/**
+* Returns the assumed types package name.
+* @param name Package name
+*/
+export declare function typed(name: string): string;
+/**
+* Returns the assumed code package name based on a types package name.
+* @param name
+*/
+export declare function untyped(name: string): string;
+/**
+* Orders an object.
+* @param source
+*/
+export declare function orderObject<
+	T extends Record<string | number | symbol, U>,
+	U
+>(source: T, comparer?: (a: string, b: string) => number): T;
+/**
+* Async memoize.
+*
+* @param fn
+*/
+export declare function memoizeAsync<
+	U extends Array<W>,
+	V,
+	W
+>(fn: (...args: U) => Promise<V>): (...args: U) => Promise<V>;
+/**
+* Ensures that we have a valid workspaces array.
+*
+* @param data
+*/
+export declare function ensureWorkspacesArray(data?: IWorkspacesSection): IWorkspacesArray;

package/dist/versioning.d.ts

@@ -0,0 +1,14 @@
+/**
+* Version descriptor for versions returned in remote package info.
+*/
+export interface IPackageVersionInfo {
+	version: string;
+	containsInternalTypings: boolean;
+}
+/**
+* Gets the closest matching package version info.
+*
+* @param availableVersions
+* @param version
+*/
+export declare function getClosestMatchingVersion(availableVersions: Array<IPackageVersionInfo>, version: string): IPackageVersionInfo;

package/dist/workspace-resolver.d.ts

@@ -0,0 +1,75 @@
+import type * as fsUtils from "./fs-utils.js";
+import type { IGlobber } from "./globber.js";
+import type { IPackageFile } from "./types.js";
+/**
+* Service for fetching monorepo workspaces in a standardized format agnostic of the package manager used.
+* It is used to allow syncing all types in a workspace when run from the root of a monorepo.
+*/
+export interface IWorkspaceResolverService {
+	/**
+	* Reads, parses, and normalizes a workspaces configuration from the following files, in this order:
+	* - `package.json` `workspaces` field, as an array of globs.
+	* - `package.json` `workspaces` field, as an object with a `packages` field, which is an array of globs.
+	* - `pnpm-workspace.yaml` `packages` field, as an array of globs.
+	*
+	* Path is relative to the current working directory.
+	* Note that this returns a list of directories, not paths to the manifests themselves.
+	*/
+	getWorkspaces(this: void, packageJson: IPackageFile, root: string, globber: IGlobber, ignored: IWorkspacesArray): Promise<IWorkspacesArray>;
+}
+/**
+* @example
+* ```json
+* "workspaces": [
+*  "packages/*",
+* ]
+* ```
+*/
+export type IWorkspacesArray = Array<string>;
+/**
+* @example
+* ```yaml
+* packages:
+* - 'packages/*'
+* ```
+*/
+export interface IWorkspacesObject {
+	packages?: IWorkspacesArray;
+}
+/**
+* @see {@link IWorkspacesArray}
+*/
+export type NpmWorkspacesConfig = IWorkspacesArray;
+/**
+* Yarn is a special snowflake.
+*
+* @example
+* ```json
+* "workspaces": {
+*   "packages": [
+*     "packages/*",
+*   ],
+*   "nohoist": []
+* }
+* ```
+*/
+export type YarnWorkspacesConfig = IWorkspacesArray | (IWorkspacesObject & { nohoist?: Array<string> });
+/**
+* The contents of a `pnpm-workspace.yaml` file.
+*
+* @example
+* ```yaml
+* packages:
+* - 'packages/*'
+* ```
+*/
+export type PnpmWorkspacesConfig = IWorkspacesObject;
+/**
+* @see {@link IWorkspacesArray}
+*/
+export type BunWorkspacesConfig = IWorkspacesArray;
+/**
+* Section in `package.json` representing workspaces.
+*/
+export type IWorkspacesSection = NpmWorkspacesConfig | YarnWorkspacesConfig | BunWorkspacesConfig;
+export declare function createWorkspaceResolverService({ readFileContents }: { readFileContents: typeof fsUtils.readFileContents }): IWorkspaceResolverService;