@cedarjs/cli-helpers 3.1.1 → 3.1.2-next.126

package/dist/packageManager/display.js

@@ -0,0 +1,109 @@
+import { getPackageManager } from "@cedarjs/project-config/packageManager";
+function formatInstallCommand() {
+  return `${getPackageManager()} install`;
+}
+function formatCedarCommand(args) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "npm") {
+    return `npx cedar${argStr}`;
+  }
+  if (pm === "pnpm") {
+    return `pnpm exec cedar${argStr}`;
+  }
+  return `yarn cedar${argStr}`;
+}
+function formatRunScriptCommand(script, args = []) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "npm") {
+    const separator = args.length > 0 ? " -- " : "";
+    return `npm run ${script}${separator}${args.join(" ")}`;
+  }
+  return `${pm} ${script}${argStr}`;
+}
+function formatRunWorkspaceScriptCommand(workspace, script, args = []) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "yarn") {
+    return `yarn workspace ${workspace} ${script}${argStr}`;
+  }
+  if (pm === "npm") {
+    const separator2 = args.length > 0 ? " -- " : "";
+    return `npm run ${script} -w ${workspace}${separator2}${args.join(" ")}`;
+  }
+  const separator = args.length > 0 ? " -- " : "";
+  return `pnpm ${script} --filter ${workspace}${separator}${args.join(" ")}`;
+}
+function formatRunBinCommand(bin, args = []) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "npm") {
+    return `npx ${bin}${argStr}`;
+  }
+  if (pm === "pnpm") {
+    return `pnpm exec ${bin}${argStr}`;
+  }
+  return `yarn ${bin}${argStr}`;
+}
+function formatRunWorkspaceBinCommand(workspace, bin, args = []) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "yarn") {
+    return `yarn workspace ${workspace} ${bin}${argStr}`;
+  }
+  if (pm === "npm") {
+    return `npm exec -w ${workspace} -- ${bin}${argStr}`;
+  }
+  return `pnpm exec --filter ${workspace} ${bin}${argStr}`;
+}
+function formatDlxCommand(command, args = []) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "npm") {
+    return `npx ${command}${argStr}`;
+  }
+  return `${pm} dlx ${command}${argStr}`;
+}
+function formatAddRootPackagesCommand(packages, dev = false) {
+  const pm = getPackageManager();
+  const devFlag = dev ? " -D" : "";
+  const pkgStr = packages.join(" ");
+  const addCmd = pm === "npm" ? "install" : "add";
+  return `${pm} ${addCmd}${devFlag} ${pkgStr}`;
+}
+function formatAddWorkspacePackagesCommand(workspace, packages, dev = false) {
+  const pm = getPackageManager();
+  const devFlag = dev ? " -D" : "";
+  const pkgStr = packages.join(" ");
+  if (pm === "yarn") {
+    return `yarn workspace ${workspace} add${devFlag} ${pkgStr}`;
+  }
+  if (pm === "npm") {
+    return `npm install${devFlag} ${pkgStr} -w ${workspace}`;
+  }
+  return `pnpm add${devFlag} ${pkgStr} --filter ${workspace}`;
+}
+function formatRemoveWorkspacePackagesCommand(workspace, packages) {
+  const pm = getPackageManager();
+  const pkgStr = packages.join(" ");
+  if (pm === "yarn") {
+    return `yarn workspace ${workspace} remove ${pkgStr}`;
+  }
+  if (pm === "npm") {
+    return `npm uninstall ${pkgStr} -w ${workspace}`;
+  }
+  return `pnpm remove ${pkgStr} --filter ${workspace}`;
+}
+export {
+  formatAddRootPackagesCommand,
+  formatAddWorkspacePackagesCommand,
+  formatCedarCommand,
+  formatDlxCommand,
+  formatInstallCommand,
+  formatRemoveWorkspacePackagesCommand,
+  formatRunBinCommand,
+  formatRunScriptCommand,
+  formatRunWorkspaceBinCommand,
+  formatRunWorkspaceScriptCommand
+};

package/dist/packageManager/exec.d.ts

@@ -0,0 +1,51 @@
+import execa from 'execa';
+import type { Options as ExecaOptions, SyncOptions as ExecaSyncOptions } from 'execa';
+/**
+ * Run a script defined in package.json "scripts".
+ *
+ * - yarn:  `yarn <script> [args]`
+ * - npm:   `npm run <script> [-- args]`
+ * - pnpm:  `pnpm <script> [args]`
+ */
+export declare function runScript(script: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Synchronous variant of {@link runScript}.
+ */
+export declare function runScriptSync(script: string, args?: string[], options?: ExecaSyncOptions): execa.ExecaSyncReturnValue<string>;
+/**
+ * Run a script in a workspace.
+ *
+ * - yarn:  `yarn workspace <workspace> <script> [args]`
+ * - npm:   `npm run <script> -w <workspace> [-- args]`
+ * - pnpm:  `pnpm <script> --filter <workspace> [-- args]`
+ */
+export declare function runWorkspaceScript(workspace: string, script: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Run a local binary from node_modules/.bin (PnP-safe for Yarn).
+ *
+ * - yarn:  `yarn <bin> [args]`
+ * - npm:   `npx <bin> [args]`
+ * - pnpm:  `pnpm exec <bin> [args]`
+ */
+export declare function runBin(bin: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Synchronous variant of {@link runBin}.
+ */
+export declare function runBinSync(bin: string, args?: string[], options?: ExecaSyncOptions): execa.ExecaSyncReturnValue<string>;
+/**
+ * Run a local binary in a workspace context.
+ *
+ * - yarn:  `yarn workspace <workspace> <bin> [args]`
+ * - npm:   `npm exec -w <workspace> -- <bin> [args]`
+ * - pnpm:  `pnpm exec --filter <workspace> <bin> [args]`
+ */
+export declare function runWorkspaceBin(workspace: string, bin: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * One-off package execution (equivalent to `npx`).
+ *
+ * - yarn:  `yarn dlx <command> [args]`
+ * - npm:   `npx <command> [args]`
+ * - pnpm:  `pnpm dlx <command> [args]`
+ */
+export declare function dlx(command: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/packageManager/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/packageManager/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EACV,OAAO,IAAI,YAAY,EACvB,WAAW,IAAI,gBAAgB,EAChC,MAAM,OAAO,CAAA;AAId;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAWvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,gBAAgB,sCAW3B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAsBvB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,gBAAgB,sCAc3B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCASvB"}

package/dist/packageManager/exec.js

@@ -0,0 +1,76 @@
+import execa from "execa";
+import { getPackageManager } from "@cedarjs/project-config/packageManager";
+function runScript(script, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "npm") {
+    const npmArgs = args.length > 0 ? ["run", script, "--", ...args] : ["run", script];
+    return execa(pm, npmArgs, options);
+  }
+  return execa(pm, [script, ...args], options);
+}
+function runScriptSync(script, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "npm") {
+    const npmArgs = args.length > 0 ? ["run", script, "--", ...args] : ["run", script];
+    return execa.sync(pm, npmArgs, options);
+  }
+  return execa.sync(pm, [script, ...args], options);
+}
+function runWorkspaceScript(workspace, script, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "yarn") {
+    return execa(pm, ["workspace", workspace, script, ...args], options);
+  }
+  if (pm === "npm") {
+    const npmArgs = args.length > 0 ? ["run", script, "-w", workspace, "--", ...args] : ["run", script, "-w", workspace];
+    return execa(pm, npmArgs, options);
+  }
+  const pnpmArgs = args.length > 0 ? [script, "--filter", workspace, "--", ...args] : [script, "--filter", workspace];
+  return execa(pm, pnpmArgs, options);
+}
+function runBin(bin, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "npm") {
+    return execa("npx", [bin, ...args], options);
+  }
+  if (pm === "pnpm") {
+    return execa(pm, ["exec", bin, ...args], options);
+  }
+  return execa(pm, [bin, ...args], options);
+}
+function runBinSync(bin, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "npm") {
+    return execa.sync("npx", [bin, ...args], options);
+  }
+  if (pm === "pnpm") {
+    return execa.sync(pm, ["exec", bin, ...args], options);
+  }
+  return execa.sync(pm, [bin, ...args], options);
+}
+function runWorkspaceBin(workspace, bin, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "yarn") {
+    return execa(pm, ["workspace", workspace, bin, ...args], options);
+  }
+  if (pm === "npm") {
+    return execa(pm, ["exec", "-w", workspace, "--", bin, ...args], options);
+  }
+  return execa(pm, ["exec", "--filter", workspace, bin, ...args], options);
+}
+function dlx(command, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "npm") {
+    return execa("npx", [command, ...args], options);
+  }
+  return execa(pm, ["dlx", command, ...args], options);
+}
+export {
+  dlx,
+  runBin,
+  runBinSync,
+  runScript,
+  runScriptSync,
+  runWorkspaceBin,
+  runWorkspaceScript
+};

package/dist/packageManager/packages.d.ts

@@ -0,0 +1,39 @@
+import execa from 'execa';
+import type { Options as ExecaOptions } from 'execa';
+type AddOptions = ExecaOptions & {
+    dev?: boolean;
+};
+/**
+ * Add packages to the project root.
+ *
+ * - yarn:  `yarn add [-D] <packages>`
+ * - npm:   `npm install [-D] <packages>`
+ * - pnpm:  `pnpm add [-D] <packages>`
+ */
+export declare function addRootPackages(packages: string[], options?: AddOptions): execa.ExecaChildProcess<string>;
+/**
+ * Add packages to a specific workspace.
+ *
+ * - yarn:  `yarn workspace <workspace> add [-D] <packages>`
+ * - npm:   `npm install [-D] <packages> -w <workspace>`
+ * - pnpm:  `pnpm add [-D] <packages> --filter <workspace>`
+ */
+export declare function addWorkspacePackages(workspace: string, packages: string[], options?: AddOptions): execa.ExecaChildProcess<string>;
+/**
+ * Remove packages from a specific workspace.
+ *
+ * - yarn:  `yarn workspace <workspace> remove <packages>`
+ * - npm:   `npm uninstall <packages> -w <workspace>`
+ * - pnpm:  `pnpm remove <packages> --filter <workspace>`
+ */
+export declare function removeWorkspacePackages(workspace: string, packages: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Install all project dependencies.
+ *
+ * - yarn:  `yarn install`
+ * - npm:   `npm install`
+ * - pnpm:  `pnpm install`
+ */
+export declare function installPackages(options?: ExecaOptions): execa.ExecaChildProcess<string>;
+export {};
+//# sourceMappingURL=packages.d.ts.map

package/dist/packageManager/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../src/packageManager/packages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAA;AAIpD,KAAK,UAAU,GAAG,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAElD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,mCAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,UAAU,mCA4BrB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,mCAGrD"}

package/dist/packageManager/packages.js

@@ -0,0 +1,53 @@
+import execa from "execa";
+import { getPackageManager } from "@cedarjs/project-config/packageManager";
+function addRootPackages(packages, options) {
+  const pm = getPackageManager();
+  const { dev, ...execaOptions } = options ?? {};
+  const addCmd = pm === "npm" ? "install" : "add";
+  const devFlag = dev ? ["-D"] : [];
+  return execa(pm, [addCmd, ...devFlag, ...packages], execaOptions);
+}
+function addWorkspacePackages(workspace, packages, options) {
+  const pm = getPackageManager();
+  const { dev, ...execaOptions } = options ?? {};
+  const devFlag = dev ? ["-D"] : [];
+  if (pm === "yarn") {
+    return execa(
+      pm,
+      ["workspace", workspace, "add", ...devFlag, ...packages],
+      execaOptions
+    );
+  }
+  if (pm === "npm") {
+    return execa(
+      pm,
+      ["install", ...devFlag, ...packages, "-w", workspace],
+      execaOptions
+    );
+  }
+  return execa(
+    pm,
+    ["add", ...devFlag, ...packages, "--filter", workspace],
+    execaOptions
+  );
+}
+function removeWorkspacePackages(workspace, packages, options) {
+  const pm = getPackageManager();
+  if (pm === "yarn") {
+    return execa(pm, ["workspace", workspace, "remove", ...packages], options);
+  }
+  if (pm === "npm") {
+    return execa(pm, ["uninstall", ...packages, "-w", workspace], options);
+  }
+  return execa(pm, ["remove", ...packages, "--filter", workspace], options);
+}
+function installPackages(options) {
+  const pm = getPackageManager();
+  return execa(pm, ["install"], options);
+}
+export {
+  addRootPackages,
+  addWorkspacePackages,
+  installPackages,
+  removeWorkspacePackages
+};

package/dist/src/lib/colors.d.ts

@@ -1,9 +1,11 @@
 /**
- * To keep a consistent color/style palette between cli packages, such as
- * @redwood/cli and @redwood/create-cedar-app, please only use the colors
- * defined here. If you *really* can't find a color that fits your needs,
- * it's better to add it here than to introduce a new one-off color in whatever
- * package you're going to use it in.
+ * Canonical color/style palette for all Cedar CLI packages.
+ *
+ * Import from here rather than defining local copies:
+ *   import { colors } from '@cedarjs/cli-helpers'
+ *
+ * If you need a color that isn't here, add it here rather than
+ * introducing a one-off in another package.
  */
 export declare const colors: {
     error: import("ansis").Ansis;

package/dist/src/lib/colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/lib/colors.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAalB,CAAA"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/lib/colors.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAalB,CAAA"}

package/dist/src/lib/installHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installHelpers.d.ts","sourceRoot":"","sources":["../../../src/lib/installHelpers.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE;;;CAMlD,CAAA;AAEF,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE;;;CAMlD,CAAA;AAEF,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,EAAE,uBAAqB;;;CASxE,CAAA;AAED,eAAO,MAAM,eAAe;;;CAM3B,CAAA"}
+{"version":3,"file":"installHelpers.d.ts","sourceRoot":"","sources":["../../../src/lib/installHelpers.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE;;;CAMlD,CAAA;AAEF,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE;;;CAMlD,CAAA;AAEF,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,EAAE,uBAAqB;;;CAQxE,CAAA;AAED,eAAO,MAAM,eAAe;;;CAM3B,CAAA"}

package/dist/src/packageManager/__tests__/display.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=display.test.d.ts.map

package/dist/src/packageManager/__tests__/display.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.test.d.ts","sourceRoot":"","sources":["../../../../src/packageManager/__tests__/display.test.ts"],"names":[],"mappings":""}

package/dist/src/packageManager/__tests__/exec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exec.test.d.ts.map

package/dist/src/packageManager/__tests__/exec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.test.d.ts","sourceRoot":"","sources":["../../../../src/packageManager/__tests__/exec.test.ts"],"names":[],"mappings":""}

package/dist/src/packageManager/__tests__/packages.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=packages.test.d.ts.map

package/dist/src/packageManager/__tests__/packages.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.test.d.ts","sourceRoot":"","sources":["../../../../src/packageManager/__tests__/packages.test.ts"],"names":[],"mappings":""}

package/dist/src/packageManager/display.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Returns the formatted install command for the detected package manager.
+ *
+ * yarn → `yarn install`
+ * npm  → `npm install`
+ * pnpm → `pnpm install`
+ */
+export declare function formatInstallCommand(): string;
+/**
+ * Returns a formatted string for running a Cedar CLI command via the detected
+ * package manager.
+ *
+ * yarn → `yarn cedar <args>`
+ * npm  → `npx cedar <args>`
+ * pnpm → `pnpm exec cedar <args>`
+ */
+export declare function formatCedarCommand(args: string[]): string;
+/**
+ * Returns a formatted string for running a package.json script via the
+ * detected package manager.
+ *
+ * yarn → `yarn <script> [args]`
+ * npm  → `npm run <script>[ -- args]`
+ * pnpm → `pnpm <script> [args]`
+ */
+export declare function formatRunScriptCommand(script: string, args?: string[]): string;
+/**
+ * Returns a formatted string for running a package.json script in a workspace
+ * via the detected package manager.
+ *
+ * yarn → `yarn workspace <workspace> <script> [args]`
+ * npm  → `npm run <script> -w <workspace>[ -- args]`
+ * pnpm → `pnpm <script> --filter <workspace>[-- args]`
+ */
+export declare function formatRunWorkspaceScriptCommand(workspace: string, script: string, args?: string[]): string;
+/**
+ * Returns a formatted string for running a local binary (from
+ * node_modules/.bin) via the detected package manager.
+ *
+ * yarn → `yarn <bin> [args]`  (PnP-safe)
+ * npm  → `npx <bin> [args]`
+ * pnpm → `pnpm exec <bin> [args]`
+ */
+export declare function formatRunBinCommand(bin: string, args?: string[]): string;
+/**
+ * Returns a formatted string for running a local binary in a workspace context
+ * via the detected package manager.
+ *
+ * yarn → `yarn workspace <workspace> <bin> [args]`
+ * npm  → `npm exec -w <workspace> -- <bin> [args]`
+ * pnpm → `pnpm exec --filter <workspace> <bin> [args]`
+ */
+export declare function formatRunWorkspaceBinCommand(workspace: string, bin: string, args?: string[]): string;
+/**
+ * Returns a formatted string for a one-off package execution via the detected
+ * package manager.
+ *
+ * yarn → `yarn dlx <command> [args]`
+ * npm  → `npx <command> [args]`
+ * pnpm → `pnpm dlx <command> [args]`
+ */
+export declare function formatDlxCommand(command: string, args?: string[]): string;
+/**
+ * Returns a formatted string for adding packages to the project root via the
+ * detected package manager.
+ *
+ * yarn → `yarn add [-D] <packages>`
+ * npm  → `npm install [-D] <packages>`
+ * pnpm → `pnpm add [-D] <packages>`
+ */
+export declare function formatAddRootPackagesCommand(packages: string[], dev?: boolean): string;
+/**
+ * Returns a formatted string for adding packages to a workspace via the
+ * detected package manager.
+ *
+ * yarn → `yarn workspace <workspace> add [-D] <packages>`
+ * npm  → `npm install [-D] <packages> -w <workspace>`
+ * pnpm → `pnpm add [-D] <packages> --filter <workspace>`
+ */
+export declare function formatAddWorkspacePackagesCommand(workspace: string, packages: string[], dev?: boolean): string;
+/**
+ * Returns a formatted string for removing packages from a workspace via the
+ * detected package manager.
+ *
+ * yarn → `yarn workspace <workspace> remove <packages>`
+ * npm  → `npm uninstall <packages> -w <workspace>`
+ * pnpm → `pnpm remove <packages> --filter <workspace>`
+ */
+export declare function formatRemoveWorkspacePackagesCommand(workspace: string, packages: string[]): string;
+//# sourceMappingURL=display.d.ts.map

package/dist/src/packageManager/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../src/packageManager/display.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAazD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,GAClB,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,GAClB,MAAM,CAgBR;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM,CAa5E;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,GAClB,MAAM,CAcR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM,CAS7E;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,UAAQ,GACV,MAAM,CAOR;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,UAAQ,GACV,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAcR"}

package/dist/src/packageManager/exec.d.ts

@@ -0,0 +1,51 @@
+import execa from 'execa';
+import type { Options as ExecaOptions, SyncOptions as ExecaSyncOptions } from 'execa';
+/**
+ * Run a script defined in package.json "scripts".
+ *
+ * - yarn:  `yarn <script> [args]`
+ * - npm:   `npm run <script> [-- args]`
+ * - pnpm:  `pnpm <script> [args]`
+ */
+export declare function runScript(script: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Synchronous variant of {@link runScript}.
+ */
+export declare function runScriptSync(script: string, args?: string[], options?: ExecaSyncOptions): execa.ExecaSyncReturnValue<string>;
+/**
+ * Run a script in a workspace.
+ *
+ * - yarn:  `yarn workspace <workspace> <script> [args]`
+ * - npm:   `npm run <script> -w <workspace> [-- args]`
+ * - pnpm:  `pnpm <script> --filter <workspace> [-- args]`
+ */
+export declare function runWorkspaceScript(workspace: string, script: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Run a local binary from node_modules/.bin (PnP-safe for Yarn).
+ *
+ * - yarn:  `yarn <bin> [args]`
+ * - npm:   `npx <bin> [args]`
+ * - pnpm:  `pnpm exec <bin> [args]`
+ */
+export declare function runBin(bin: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Synchronous variant of {@link runBin}.
+ */
+export declare function runBinSync(bin: string, args?: string[], options?: ExecaSyncOptions): execa.ExecaSyncReturnValue<string>;
+/**
+ * Run a local binary in a workspace context.
+ *
+ * - yarn:  `yarn workspace <workspace> <bin> [args]`
+ * - npm:   `npm exec -w <workspace> -- <bin> [args]`
+ * - pnpm:  `pnpm exec --filter <workspace> <bin> [args]`
+ */
+export declare function runWorkspaceBin(workspace: string, bin: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * One-off package execution (equivalent to `npx`).
+ *
+ * - yarn:  `yarn dlx <command> [args]`
+ * - npm:   `npx <command> [args]`
+ * - pnpm:  `pnpm dlx <command> [args]`
+ */
+export declare function dlx(command: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/src/packageManager/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/packageManager/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EACV,OAAO,IAAI,YAAY,EACvB,WAAW,IAAI,gBAAgB,EAChC,MAAM,OAAO,CAAA;AAId;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAWvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,gBAAgB,sCAW3B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAsBvB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,gBAAgB,sCAc3B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCASvB"}

package/dist/src/packageManager/packages.d.ts

@@ -0,0 +1,39 @@
+import execa from 'execa';
+import type { Options as ExecaOptions } from 'execa';
+type AddOptions = ExecaOptions & {
+    dev?: boolean;
+};
+/**
+ * Add packages to the project root.
+ *
+ * - yarn:  `yarn add [-D] <packages>`
+ * - npm:   `npm install [-D] <packages>`
+ * - pnpm:  `pnpm add [-D] <packages>`
+ */
+export declare function addRootPackages(packages: string[], options?: AddOptions): execa.ExecaChildProcess<string>;
+/**
+ * Add packages to a specific workspace.
+ *
+ * - yarn:  `yarn workspace <workspace> add [-D] <packages>`
+ * - npm:   `npm install [-D] <packages> -w <workspace>`
+ * - pnpm:  `pnpm add [-D] <packages> --filter <workspace>`
+ */
+export declare function addWorkspacePackages(workspace: string, packages: string[], options?: AddOptions): execa.ExecaChildProcess<string>;
+/**
+ * Remove packages from a specific workspace.
+ *
+ * - yarn:  `yarn workspace <workspace> remove <packages>`
+ * - npm:   `npm uninstall <packages> -w <workspace>`
+ * - pnpm:  `pnpm remove <packages> --filter <workspace>`
+ */
+export declare function removeWorkspacePackages(workspace: string, packages: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/**
+ * Install all project dependencies.
+ *
+ * - yarn:  `yarn install`
+ * - npm:   `npm install`
+ * - pnpm:  `pnpm install`
+ */
+export declare function installPackages(options?: ExecaOptions): execa.ExecaChildProcess<string>;
+export {};
+//# sourceMappingURL=packages.d.ts.map

package/dist/src/packageManager/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../../src/packageManager/packages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,OAAO,CAAA;AAIpD,KAAK,UAAU,GAAG,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAElD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,mCAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,UAAU,mCA4BrB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,mCAGrD"}