feat(turbo-utils): convert package to dual ESM/CommonJS build

This commit converts turbo-utils from a TypeScript-only package to a dual
ESM/CommonJS package with proper build outputs, addressing compatibility
requirements across different module systems.

Key changes:
- Package.json: Added "type": "module" and dual export configuration with
  separate entry points for ESM, CommonJS, and TypeScript declarations
- Build system: Implemented three-stage build process (ESM, CJS, types) with
  corresponding TypeScript configurations
- Import statements: Updated all relative imports to include .js extensions
  for ESM compatibility
- Module handling: Fixed imports for packages like tar, fast-glob, and
  picocolors to work with ESM
- Jest configuration: Added module name mapping to handle .js extension
  resolution in tests
- TypeScript configs: Created separate tsconfig files for ESM (tsconfig.json),
  CommonJS (tsconfig.cjs.json), and type declarations (tsconfig.types.json)

Build outputs:
- dist/esm/: ES module build for modern environments
- dist/cjs/: CommonJS build for Node.js compatibility
- dist/types/: TypeScript declaration files

The package now supports both import and require syntax while maintaining
backward compatibility through the dual export system.

Author: tknickman

packages/turbo-utils/jest.config.ts

@@ -7,6 +7,9 @@ const config = {
   transformIgnorePatterns: ["/node_modules/(?!(ansi-regex)/)"],
   verbose: process.env.RUNNER_DEBUG === "1",
   silent: process.env.RUNNER_DEBUG !== "1",
+  moduleNameMapper: {
+    "^(\\./.+)\\.js$": "$1",
+  },
 } as const satisfies Config;
 
 export default config;

packages/turbo-utils/package.json

@@ -15,10 +15,24 @@
   "bugs": {
     "url": "https://github.com/vercel/turborepo/issues"
   },
-  "module": "src/index.ts",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
+    }
+  },
   "scripts": {
+    "build": "pnpm build:esm && pnpm build:cjs && pnpm build:types && pnpm post-build",
+    "post-build": "echo '{ \"type\": \"commonjs\" }' > dist/cjs/package.json",
+    "build:esm": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
     "test": "jest",
     "lint": "eslint src/",
     "check-types": "tsc --noEmit",

packages/turbo-utils/src/createProject.ts

@@ -2,18 +2,18 @@ import path from "node:path";
 import retry from "async-retry";
 import picocolors from "picocolors";
 import fs from "fs-extra";
-import * as logger from "./logger";
+import * as logger from "./logger.js";
 import {
   downloadAndExtractExample,
   downloadAndExtractRepo,
   getRepoInfo,
   existsInRepo,
   hasRepo,
   type RepoInfo,
-} from "./examples";
-import { isWriteable } from "./isWriteable";
-import { isFolderEmpty } from "./isFolderEmpty";
-import type { PackageJson } from "./types";
+} from "./examples.js";
+import { isWriteable } from "./isWriteable.js";
+import { isFolderEmpty } from "./isFolderEmpty.js";
+import type { PackageJson } from "./types.js";
 
 function isErrorLike(err: unknown): err is { message: string } {
   return (

packages/turbo-utils/src/examples.ts

@@ -3,9 +3,11 @@ import { promisify } from "node:util";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { createWriteStream, promises as fs } from "node:fs";
-import { x as extract } from "tar";
+import tar from "tar";
 import got from "got";
 
+const { x: extract } = tar;
+
 const pipeline = promisify(Stream.pipeline);
 
 export interface RepoInfo {

packages/turbo-utils/src/getTurboConfigs.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import yaml from "js-yaml";
-import { sync } from "fast-glob";
+import glob from "fast-glob";
 import JSON5 from "json5";
 import type {
   BaseSchemaV1,
@@ -10,9 +10,11 @@ import type {
   BaseSchemaV2,
   PipelineV2,
 } from "@turbo/types";
-import * as logger from "./logger";
-import { getTurboRoot } from "./getTurboRoot";
-import type { PackageJson, PNPMWorkspaceConfig } from "./types";
+import * as logger from "./logger.js";
+import { getTurboRoot } from "./getTurboRoot.js";
+import type { PackageJson, PNPMWorkspaceConfig } from "./types.js";
+
+const { sync } = glob;
 
 const ROOT_GLOB = "{turbo.json,turbo.jsonc}";
 const ROOT_WORKSPACE_GLOB = "package.json";

packages/turbo-utils/src/getTurboRoot.ts

@@ -1,7 +1,7 @@
 import type { Schema } from "@turbo/types";
 import { findRootSync } from "@manypkg/find-root";
 import json5 from "json5";
-import { searchUp } from "./searchUp";
+import { searchUp } from "./searchUp.js";
 
 interface Options {
   cache?: boolean;

packages/turbo-utils/src/index.ts

@@ -1,36 +1,36 @@
 // utils
-export { getTurboRoot } from "./getTurboRoot";
+export { getTurboRoot } from "./getTurboRoot.js";
 export {
   getTurboConfigs,
   getWorkspaceConfigs,
   forEachTaskDef,
-} from "./getTurboConfigs";
-export { searchUp } from "./searchUp";
+} from "./getTurboConfigs.js";
+export { searchUp } from "./searchUp.js";
 export {
   getAvailablePackageManagers,
   getPackageManagersBinPaths,
-} from "./managers";
-export { isFolderEmpty } from "./isFolderEmpty";
-export { validateDirectory } from "./validateDirectory";
+} from "./managers.js";
+export { isFolderEmpty } from "./isFolderEmpty.js";
+export { validateDirectory } from "./validateDirectory.js";
 export {
   isUrlOk,
   getRepoInfo,
   hasRepo,
   existsInRepo,
   downloadAndExtractRepo,
   downloadAndExtractExample,
-} from "./examples";
-export { isWriteable } from "./isWriteable";
-export { createProject, DownloadError } from "./createProject";
-export { convertCase } from "./convertCase";
+} from "./examples.js";
+export { isWriteable } from "./isWriteable.js";
+export { createProject, DownloadError } from "./createProject.js";
+export { convertCase } from "./convertCase.js";
 
-export * as logger from "./logger";
+export * as logger from "./logger.js";
 
 // types
-export type { RepoInfo } from "./examples";
+export type { RepoInfo } from "./examples.js";
 export type {
   TurboConfig,
   TurboConfigs,
   WorkspaceConfig,
-} from "./getTurboConfigs";
-export * from "./types";
+} from "./getTurboConfigs.js";
+export * from "./types.js";

packages/turbo-utils/src/logger.ts

@@ -1,13 +1,9 @@
-import {
-  reset,
-  bold as pcBold,
-  underline as pcUnderline,
-  gray,
-  dim,
-} from "picocolors";
+import pc from "picocolors";
 import ora from "ora";
 import gradient from "gradient-string";
 
+const { reset, bold: pcBold, underline: pcUnderline, gray, dim } = pc;
+
 const BLUE = "#0099F7";
 const RED = "#F11712";
 const YELLOW = "#FFFF00";

packages/turbo-utils/src/managers.ts

@@ -1,7 +1,7 @@
 import os from "node:os";
 import type { Options } from "execa";
 import execa from "execa";
-import type { PackageManager } from "./types";
+import type { PackageManager } from "./types.js";
 
 async function exec(command: string, args: Array<string> = [], opts?: Options) {
   // run the check from tmpdir to avoid corepack conflicting -

packages/turbo-utils/src/validateDirectory.ts

@@ -1,7 +1,7 @@
 import path from "node:path";
 import fs from "fs-extra";
 import picocolors from "picocolors";
-import { isFolderEmpty } from "./isFolderEmpty";
+import { isFolderEmpty } from "./isFolderEmpty.js";
 
 export function validateDirectory(directory: string): {
   valid: boolean;