@cedarjs/cli-helpers 9.0.0-canary.1784 → 9.0.0-canary.3124

package/dist/packageManager/display.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 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.
+ *
+ * npm  → `npx cedar <args>`
+ * yarn → `yarn cedar <args>`
+ * pnpm → `pnpm cedar <args>`
+ */
+export declare function formatCedarCommand(args: string[]): string;
+/**
+ * Returns a formatted string for running a package.json script via the
+ * detected package manager.
+ *
+ * npm  → `npm run <script>[ -- args]`
+ * yarn → `yarn <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 transitive dependency's binary
+ * (one not listed directly in the project's package.json, e.g. Prisma) via
+ * the detected package manager.
+ *
+ * yarn → `npx <bin> [args]`
+ * npm  → `npx <bin> [args]`
+ * pnpm → `pnpm exec <bin> [args]`
+ */
+export declare function formatRunTransitiveBinCommand(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/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,CASzD;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;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,GAClB,MAAM,CASR;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/packageManager/display.js

@@ -0,0 +1,115 @@
+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}`;
+  }
+  return `${pm} 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 formatRunTransitiveBinCommand(bin, args = []) {
+  const pm = getPackageManager();
+  const argStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+  if (pm === "pnpm") {
+    return `pnpm exec ${bin}${argStr}`;
+  }
+  return `npx ${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,
+  formatRunTransitiveBinCommand,
+  formatRunWorkspaceBinCommand,
+  formatRunWorkspaceScriptCommand
+};

package/dist/packageManager/exec.d.ts

@@ -0,0 +1,77 @@
+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).
+ * Does not support running transitive dependencies, like prisma
+ *
+ * - 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>;
+export declare function runTransitiveBin(bin: string, args?: string[], options?: ExecaOptions): execa.ExecaChildProcess<string>;
+/** Synchronous variant of {@link runTransitiveBin} */
+export declare function runTransitiveBinSync(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>;
+/**
+ * Returns spawn-compatible `[cmd, args]` for running a node script.
+ *
+ * Yarn PnP requires wrapping node via `yarn node` so module resolution works.
+ * npm and pnpm use standard `node_modules`, so running `node <script>`
+ * directly is sufficient.
+ *
+ * - yarn:  `yarn node <script>`
+ * - npm:   `node <script>`
+ * - pnpm:  `node <script>`
+ */
+export declare function getNodeRunnerArgs(scriptPath: string): [string, string[]];
+/**
+ * Run a node script via execa.
+ *
+ * Yarn PnP requires wrapping node via `yarn node` so module resolution works.
+ * npm and pnpm use standard `node_modules`, so running `node <script>`
+ * directly is sufficient.
+ *
+ * - yarn:  `yarn node <script>`
+ * - npm:   `node <script>`
+ * - pnpm:  `node <script>`
+ */
+export declare function runWithNode(scriptPath: 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,sCAkB3B;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;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAcvB;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,gBAAgB,sCAc3B;AAYD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,YAAY,mCAUvB;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,gBAAgB,sCAU3B;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;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAQxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,mCAGrE"}

package/dist/packageManager/exec.js

@@ -0,0 +1,108 @@
+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") {
+    if (script === "run" && args.length === 0) {
+      return execa.sync(pm, ["run"], options);
+    }
+    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 runTransitiveBin(bin, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "pnpm") {
+    return execa(pm, ["exec", bin, ...args], options);
+  }
+  return execa("npx", [bin, ...args], options);
+}
+function runTransitiveBinSync(bin, args = [], options) {
+  const pm = getPackageManager();
+  if (pm === "pnpm") {
+    return execa.sync(pm, ["exec", bin, ...args], options);
+  }
+  return execa.sync("npx", [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);
+}
+function getNodeRunnerArgs(scriptPath) {
+  const pm = getPackageManager();
+  if (pm === "yarn") {
+    return ["yarn", ["node", scriptPath]];
+  }
+  return ["node", [scriptPath]];
+}
+function runWithNode(scriptPath, options) {
+  const [cmd, args] = getNodeRunnerArgs(scriptPath);
+  return execa(cmd, args, options);
+}
+export {
+  dlx,
+  getNodeRunnerArgs,
+  runBin,
+  runBinSync,
+  runScript,
+  runScriptSync,
+  runTransitiveBin,
+  runTransitiveBinSync,
+  runWithNode,
+  runWorkspaceBin,
+  runWorkspaceScript
+};

package/dist/packageManager/index.d.ts

@@ -0,0 +1,13 @@
+export declare function workspacePackageSpecifier(): string;
+export declare function add(): "install" | "add";
+export declare function install(): string;
+export declare function dedupe(): "dedupe" | undefined;
+export declare function dedupeIsSupported(): boolean;
+export declare function installationErrorMessage(): string;
+/**
+ * Gets a string suitable for displaying to the user when telling them to run a
+ * Cedar bin command, like `yarn cedar upgrade` or
+ * `yarn cedar generate page home /`.
+ */
+export declare function prettyPrintCedarCommand(args: string[]): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/packageManager/index.ts"],"names":[],"mappings":"AAEA,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAED,wBAAgB,GAAG,sBAGlB;AAED,wBAAgB,OAAO,WAEtB;AAED,wBAAgB,MAAM,yBAMrB;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,wBAAwB,WAYvC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAM9D"}

package/dist/packageManager/index.js

@@ -0,0 +1,43 @@
+import { getPackageManager } from "@cedarjs/project-config/packageManager";
+function workspacePackageSpecifier() {
+  if (getPackageManager() === "npm") {
+    return "*";
+  }
+  return "workspace:*";
+}
+function add() {
+  const pm = getPackageManager();
+  return pm === "npm" ? "install" : "add";
+}
+function install() {
+  return "install";
+}
+function dedupe() {
+  if (getPackageManager() === "yarn") {
+    return "dedupe";
+  }
+  return void 0;
+}
+function dedupeIsSupported() {
+  return getPackageManager() === "yarn";
+}
+function installationErrorMessage() {
+  if (getPackageManager() === "yarn") {
+    return "Could not finish installation. Please run `yarn install` and then `yarn dedupe`, before continuing";
+  }
+  return `Could not finish installation. Please run \`${getPackageManager()} ${install()}\` before continuing`;
+}
+function prettyPrintCedarCommand(args) {
+  const packageManager = getPackageManager();
+  const packageManagerBin = packageManager === "npm" ? "npx" : packageManager;
+  return `${packageManagerBin} cedar ${args.join(" ")}`;
+}
+export {
+  add,
+  dedupe,
+  dedupeIsSupported,
+  install,
+  installationErrorMessage,
+  prettyPrintCedarCommand,
+  workspacePackageSpecifier
+};

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 -w [-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,mCAQvE;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,54 @@
+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"] : [];
+  const rootFlag = pm === "pnpm" ? ["-w"] : [];
+  return execa(pm, [addCmd, ...rootFlag, ...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/packageManager/workspaces.d.ts

@@ -0,0 +1,4 @@
+import type { PackageManager } from '@cedarjs/project-config/packageManager';
+export type AddWorkspaceDirResult = 'exists' | 'added';
+export declare function addWorkspaceDir(baseDir: string, packagePath: string, pm: PackageManager): AddWorkspaceDirResult;
+//# sourceMappingURL=workspaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/packageManager/workspaces.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAE5E,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEtD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,cAAc,GACjB,qBAAqB,CAMvB"}

package/dist/packageManager/workspaces.js

@@ -0,0 +1,59 @@
+import fs from "node:fs";
+import path from "node:path";
+function addWorkspaceDir(baseDir, packagePath, pm) {
+  if (pm === "pnpm") {
+    return addPnpmWorkspaceDir(baseDir, packagePath);
+  }
+  return addPackageJsonWorkspaceDir(baseDir, packagePath);
+}
+function addPnpmWorkspaceDir(baseDir, packagePath) {
+  const yamlPath = path.join(baseDir, "pnpm-workspace.yaml");
+  if (!fs.existsSync(yamlPath)) {
+    throw new Error("Invalid workspace config in " + yamlPath);
+  }
+  const content = fs.readFileSync(yamlPath, "utf8");
+  const packageEntry = `  - ${packagePath}`;
+  if (content.includes(packageEntry)) {
+    return "exists";
+  }
+  const match = content.match(/^(packages:[\s\S]*?)(?=^\w|(?![\s\S]))/m);
+  if (!match) {
+    throw new Error("Invalid workspace config in " + yamlPath);
+  }
+  const packagesSection = match[1];
+  const lines = packagesSection.split("\n");
+  const lastPackageLine = lines.map((line, i) => ({ line, i })).filter(({ line }) => line.trimStart().startsWith("- ")).pop();
+  if (!lastPackageLine) {
+    throw new Error("Invalid workspace config in " + yamlPath);
+  }
+  const insertAfter = lastPackageLine.i;
+  lines.splice(insertAfter + 1, 0, packageEntry);
+  const updatedContent = content.replace(packagesSection, lines.join("\n"));
+  fs.writeFileSync(yamlPath, updatedContent, "utf8");
+  return "added";
+}
+function addPackageJsonWorkspaceDir(baseDir, packagePath) {
+  const pkgPath = path.join(baseDir, "package.json");
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  if (!Array.isArray(pkg.workspaces)) {
+    throw new Error("Invalid workspace config in " + pkgPath);
+  }
+  const hasWildcardPackagesWorkspace = pkg.workspaces.includes("packages/*");
+  const hasNamedPackagesWorkspace = pkg.workspaces.includes(packagePath);
+  const hasOtherNamedPackages = pkg.workspaces.some(
+    (workspace) => workspace.startsWith("packages/") && workspace !== packagePath
+  );
+  if (hasWildcardPackagesWorkspace || hasNamedPackagesWorkspace) {
+    return "exists";
+  }
+  if (hasOtherNamedPackages) {
+    pkg.workspaces.push(packagePath);
+  } else {
+    pkg.workspaces.push("packages/*");
+  }
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+  return "added";
+}
+export {
+  addWorkspaceDir
+};

package/dist/telemetry/index.d.ts

@@ -1,6 +1,6 @@
 import type { AttributeValue, Span } from '@opentelemetry/api';
 type TelemetryAttributes = {
-    [key: string]: AttributeValue;
+    [key: string]: AttributeValue | undefined;
 };
 /**
  * Safely records attributes to the opentelemetry span

package/dist/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAG9D,KAAK,mBAAmB,GAAG;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mBAAmB,EAC/B,IAAI,CAAC,EAAE,IAAI,QASZ;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,QAe3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAG9D,KAAK,mBAAmB,GAAG;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;CAC1C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mBAAmB,EAC/B,IAAI,CAAC,EAAE,IAAI,QAaZ;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,QAe3D"}

package/dist/telemetry/index.js

@@ -5,7 +5,9 @@ function recordTelemetryAttributes(attributes, span) {
     return;
   }
   for (const [key, value] of Object.entries(attributes)) {
-    spanToRecord.setAttribute(key, value);
+    if (value !== void 0) {
+      spanToRecord.setAttribute(key, value);
+    }
   }
 }
 function recordTelemetryError(error, span) {