@package-pal/core 0.0.1 → 0.0.3

package/{dist/index.js → index.js}

@@ -1,5 +1,5 @@
 // @bun
-// src/lib/types/bump-version-type.ts
+// packages/core/src/lib/types/bump-version-type.ts
 var BumpVersionType = {
   Major: "major",
   Minor: "minor",
@@ -9,17 +9,19 @@ var BumpVersionType = {
   Prepatch: "prepatch",
   Prerelease: "prerelease"
 };
-// src/lib/api.ts
+// packages/core/src/lib/api.ts
 import { isDefined as isDefined5 } from "@package-pal/util";
 
-// src/lib/configuration/functions/check-bun.ts
+// packages/core/src/lib/configuration/functions/check-bun.ts
 var checkBun = () => {
   if (!Bun) {
     throw new Error("This package must be run with the Bun runtime.");
   }
 };
 
-// src/lib/configuration/functions/load-config.ts
+// packages/core/src/lib/configuration/functions/load-config.ts
+import { dirname as dirname3 } from "path";
+import { cwd } from "process";
 import {
   deepMergeDefined,
   formatSimpleLogObject,
@@ -30,7 +32,7 @@ import {
   dim
 } from "yoctocolors";
 
-// src/lib/configuration/functions/get-default-logger.ts
+// packages/core/src/lib/configuration/functions/get-default-logger.ts
 import {
   assertDefined,
   noOp
@@ -52,10 +54,10 @@ var getDefaultLogger = (logLevel) => {
   };
 };
 
-// src/lib/configuration/schemas/config.ts
+// packages/core/src/lib/configuration/schemas/config.ts
 import * as z3 from "zod/mini";
 
-// src/lib/configuration/functions/z-loose-function.ts
+// packages/core/src/lib/configuration/functions/z-loose-function.ts
 import { z } from "zod/mini";
 var zLooseFunction = () => {
   return z.transform((arg, ctx) => {
@@ -71,13 +73,13 @@ var zLooseFunction = () => {
   });
 };
 
-// src/lib/configuration/functions/z-loose-object-without-index-signature.ts
+// packages/core/src/lib/configuration/functions/z-loose-object-without-index-signature.ts
 import * as z2 from "zod/mini";
 var zLooseObjectWithoutIndexSignature = (shape, params) => {
   return z2.looseObject(shape, params);
 };
 
-// src/lib/configuration/schemas/config.ts
+// packages/core/src/lib/configuration/schemas/config.ts
 var LogLevel = z3.enum([
   "debug",
   "info",
@@ -112,13 +114,13 @@ var Config = z3.object({
   logLevel: z3.optional(LogLevel)
 });
 
-// src/lib/configuration/functions/validate-config-path.ts
+// packages/core/src/lib/configuration/functions/validate-config-path.ts
 import {
   basename,
   extname
 } from "path";
 
-// src/lib/configuration/types/supported-config-type.ts
+// packages/core/src/lib/configuration/types/supported-config-type.ts
 var SupportedConfigType = {
   TS: "ts",
   CTS: "cts",
@@ -128,7 +130,7 @@ var SupportedConfigType = {
   MJS: "mjs"
 };
 
-// src/lib/configuration/functions/validate-config-path.ts
+// packages/core/src/lib/configuration/functions/validate-config-path.ts
 var CONFIG_SUPPORTED_BASE_NAME = "ppal.config";
 var CONFIG_SUPPORTED_TYPES = Object.values(SupportedConfigType);
 var CONFIG_SUPPORTED_NAMES = CONFIG_SUPPORTED_TYPES.map((type) => `${CONFIG_SUPPORTED_BASE_NAME}.${type}`);
@@ -149,7 +151,7 @@ var validateConfigPath = (path) => {
   };
 };
 
-// src/lib/configuration/functions/parse-config.ts
+// packages/core/src/lib/configuration/functions/parse-config.ts
 var parseConfig = async (path) => {
   const result = validateConfigPath(path);
   if (!result.valid) {
@@ -160,7 +162,7 @@ var parseConfig = async (path) => {
   return Config.parse(base);
 };
 
-// src/lib/configuration/functions/search-config-path.ts
+// packages/core/src/lib/configuration/functions/search-config-path.ts
 import {
   isAbsolute,
   join,
@@ -168,13 +170,13 @@ import {
 } from "path";
 import { isDefined } from "@package-pal/util";
 
-// src/lib/configuration/functions/is-root-dir.ts
+// packages/core/src/lib/configuration/functions/is-root-dir.ts
 import { dirname } from "path";
 var isRootDir = (path) => {
   return dirname(path) === path;
 };
 
-// src/lib/configuration/functions/search-config-path.ts
+// packages/core/src/lib/configuration/functions/search-config-path.ts
 var dirDistLimit = 25;
 var checkForConfigInDir = async (dir) => {
   return new Promise((resolve) => {
@@ -217,7 +219,7 @@ var searchConfigPath = async (pathOverride) => {
   return checkForConfigInDir(activeDir);
 };
 
-// src/lib/configuration/functions/load-config.ts
+// packages/core/src/lib/configuration/functions/load-config.ts
 var defaultConfig = {
   packages: "packages/*",
   version: {
@@ -249,12 +251,15 @@ var loadConfig = async (overrideConfigPath) => {
   const path = await searchConfigPath(overrideConfigPath);
   if (!path) {
     defaultConfig.logger.info("No config file found. Defaults will be applied.");
-    return defaultConfig;
+    return {
+      config: defaultConfig,
+      rootDir: cwd()
+    };
   }
   const parsedConfig = await parseConfig(path);
   const parsedLogger = parsedConfig["logger"];
   const logger = parsedLogger ?? (!parsedConfig.logLevel || parsedConfig.logLevel === defaultConfig.logLevel ? defaultConfig.logger : getDefaultLogger(parsedConfig.logLevel));
-  logger.info(`Successfully loaded config file '${path}'.`);
+  logger.debug(`Successfully loaded config file '${path}'.`);
   logger.debug(dim(bgGray("User config:")), `
 ${dim(formatSimpleLogObject(parsedConfig))}`);
   logger.debug(dim(bgGray("Default config:")), `
@@ -263,10 +268,13 @@ ${dim(formatSimpleLogObject(defaultConfig))}`);
   activatedConfig.logger = logger;
   logger.debug(dim(bgGray("Activated config:")), `
 ${dim(formatSimpleLogObject(activatedConfig))}`);
-  return activatedConfig;
+  return {
+    config: activatedConfig,
+    rootDir: dirname3(path)
+  };
 };
 
-// src/lib/graph/functions/generate-graphs.ts
+// packages/core/src/lib/graph/functions/generate-graphs.ts
 import { assertDefined as assertDefined2 } from "@package-pal/util";
 import { dim as dim2 } from "yoctocolors";
 var trackPackageEntryDependencies = ({
@@ -324,14 +332,14 @@ var generateGraphs = (packages, logger) => {
   };
 };
 
-// src/lib/graph/functions/generate-package-circular-dependency-paths.ts
+// packages/core/src/lib/graph/functions/generate-package-circular-dependency-paths.ts
 import { assertDefined as assertDefined6 } from "@package-pal/util";
 import {
   dim as dim3,
   yellow
 } from "yoctocolors";
 
-// src/lib/graph/functions/dfs-traverse-graph-paths.ts
+// packages/core/src/lib/graph/functions/dfs-traverse-graph-paths.ts
 import { assertDefined as assertDefined3 } from "@package-pal/util";
 var dfsTraverseGraphPaths = function* (graph, traverseFromPackages) {
   const globalVisited = new Set;
@@ -381,10 +389,10 @@ var dfsTraverseGraphPaths = function* (graph, traverseFromPackages) {
   }
 };
 
-// src/lib/graph/functions/extract-subgraph.ts
+// packages/core/src/lib/graph/functions/extract-subgraph.ts
 import { assertDefined as assertDefined5 } from "@package-pal/util";
 
-// src/lib/graph/functions/dfs-traverse-graph.ts
+// packages/core/src/lib/graph/functions/dfs-traverse-graph.ts
 import { assertDefined as assertDefined4 } from "@package-pal/util";
 var dfsTraverseGraph = function* (graph, traverseFromPackages) {
   const visited = new Set;
@@ -408,7 +416,7 @@ var dfsTraverseGraph = function* (graph, traverseFromPackages) {
   }
 };
 
-// src/lib/graph/functions/extract-subgraph.ts
+// packages/core/src/lib/graph/functions/extract-subgraph.ts
 var extractSubgraph = (graph, fromPackages) => {
   const reachablePackages = new Set(dfsTraverseGraph(graph, fromPackages).map((packageData) => packageData.name));
   const subgraph = new Map;
@@ -423,7 +431,7 @@ var extractSubgraph = (graph, fromPackages) => {
   return subgraph;
 };
 
-// src/lib/graph/functions/generate-package-circular-dependency-paths.ts
+// packages/core/src/lib/graph/functions/generate-package-circular-dependency-paths.ts
 var findStronglyConnectedComponents = (graph) => {
   let index = 0;
   const indices = new Map;
@@ -497,7 +505,7 @@ ${sampleCycleContents}`));
   return sampleCycles;
 };
 
-// src/lib/graph/functions/generate-topological-sorted-groups.ts
+// packages/core/src/lib/graph/functions/generate-topological-sorted-groups.ts
 import { assertDefined as assertDefined7 } from "@package-pal/util";
 import {
   dim as dim4,
@@ -557,12 +565,12 @@ var generateTopologicalSortedGroups = (packageGraph, logger) => {
   };
 };
 
-// src/lib/package/functions/load-packages.ts
+// packages/core/src/lib/package/functions/load-packages.ts
 import { dim as dim6 } from "yoctocolors";
 
-// src/lib/package/functions/scan-packages.ts
+// packages/core/src/lib/package/functions/scan-packages.ts
 import {
-  dirname as dirname4,
+  dirname as dirname5,
   join as join2
 } from "path";
 import { formatUnknownError } from "@package-pal/util";
@@ -571,9 +579,9 @@ import {
   red
 } from "yoctocolors";
 
-// src/lib/package/functions/parse-package.ts
+// packages/core/src/lib/package/functions/parse-package.ts
 import {
-  dirname as dirname3,
+  dirname as dirname4,
   basename as basename2
 } from "path";
 import { isDefined as isDefined2 } from "@package-pal/util";
@@ -595,7 +603,7 @@ var parsePackage = (path, text) => {
     rawContent: text,
     path,
     name: props.name ?? path,
-    dir: basename2(dirname3(path)),
+    dir: basename2(dirname4(path)),
     version: props.version ?? undefined,
     dependencies: dependencies ?? undefined,
     peerDependencies: peerDependencies ?? undefined,
@@ -603,22 +611,28 @@ var parsePackage = (path, text) => {
   };
 };
 
-// src/lib/package/functions/scan-package-paths.ts
+// packages/core/src/lib/package/functions/scan-package-paths.ts
 import { scanGlobPatternPaths } from "@package-pal/util";
-var scanPackagePaths = (packages) => {
+var scanPackagePaths = (packages, cwd2) => {
   return scanGlobPatternPaths(packages, {
     absolute: true,
-    onlyFiles: false
+    onlyFiles: false,
+    cwd: cwd2
   });
 };
 
-// src/lib/package/functions/scan-packages.ts
-var scanPackages = async function* (patterns, logger) {
-  for await (const path of scanPackagePaths(patterns)) {
+// packages/core/src/lib/package/functions/scan-packages.ts
+var scanPackages = async function* (patterns, logger, cwd2) {
+  for await (const path of scanPackagePaths(patterns, cwd2)) {
     const packagePath = join2(path, "package.json");
-    const dir = dirname4(packagePath);
+    const dir = dirname5(packagePath);
     try {
+      logger.debug(dim5(`Trying to read read package.json in '${dir}'.`));
       const file = Bun.file(packagePath);
+      if (!file.size) {
+        logger.debug(dim5(`Failed to read package.json in '${dir}' - ${red("File not found")}.`));
+        continue;
+      }
       const text = await file.text();
       const packageData = parsePackage(packagePath, text);
       if (!packageData) {
@@ -633,13 +647,13 @@ var scanPackages = async function* (patterns, logger) {
   }
 };
 
-// src/lib/package/functions/load-packages.ts
-var loadPackages = async (packagePatterns, logger) => {
+// packages/core/src/lib/package/functions/load-packages.ts
+var loadPackages = async (rootDir, packagePatterns, logger) => {
   const patternContent = packagePatterns.map((pattern) => `'${pattern}'`).join(", ");
-  logger.debug(dim6(`Loading packages matching pattern/s ${patternContent}...`));
+  logger.debug(dim6(`Loading packages matching pattern/s ${patternContent}...${rootDir ? ` from ${rootDir}` : ""}`));
   const packages = [];
   const seen = new Set;
-  for await (const packageData of scanPackages(Array.from(new Set(packagePatterns)), logger)) {
+  for await (const packageData of scanPackages(Array.from(new Set(packagePatterns)), logger, rootDir)) {
     if (seen.has(packageData.name)) {
       continue;
     }
@@ -652,10 +666,285 @@ var loadPackages = async (packagePatterns, logger) => {
   return packages;
 };
 
-// src/lib/package/functions/update-package-version.ts
+// packages/core/src/lib/package/functions/run-for-each-package.ts
+import { dirname as dirname6 } from "path";
+import {
+  assertDefined as assertDefined9,
+  runAsync,
+  RunAsyncType
+} from "@package-pal/util";
+
+// packages/core/src/lib/process/functions/run-subprocess.ts
+import {
+  dim as dim7,
+  red as red2
+} from "yoctocolors";
+
+// packages/core/src/lib/process/types/exit-state.ts
+var ExitState = {
+  Completed: "Completed",
+  Errored: "Errored",
+  Cancelled: "Cancelled"
+};
+
+// packages/core/src/lib/process/types/std-type.ts
+var StdType = {
+  Out: "Out",
+  Err: "Err"
+};
+
+// packages/core/src/lib/process/functions/get-commands-for-shell.ts
+import {
+  escapeShellArg,
+  getShell,
+  Shell
+} from "@package-pal/util";
+
+// packages/core/src/lib/process/functions/parse-ps-flags.ts
+import { assertDefined as assertDefined8 } from "@package-pal/util";
+var knownFlagsWithParams = new Set([
+  "-executionpolicy",
+  "-windowstyle",
+  "-version",
+  "-file",
+  "-inputformat",
+  "-outputformat",
+  "-workingdirectory",
+  "-psconsolefile",
+  "-pshome",
+  "-configurationname",
+  "-argumentlist",
+  "-warningaction",
+  "-erroraction",
+  "-informationaction",
+  "-informationvariable",
+  "-warningvariable",
+  "-errorvariable",
+  "-outvariable",
+  "-outbuffer",
+  "-throttlelimit",
+  "-culture",
+  "-uiculture"
+]);
+var knownFlagsNoParams = new Set([
+  "-noprofile",
+  "-noninteractive",
+  "-nologo",
+  "-sta",
+  "-mta",
+  "-encodedcommand",
+  "-command",
+  "-help",
+  "-?",
+  "-verbose",
+  "-debug",
+  "-whatif",
+  "-confirm",
+  "-usewindowspowershell",
+  "-noexit"
+]);
+var parsePsFlags = (input) => {
+  const tokens = input.trim().split(/\s+/);
+  const flags = [];
+  let i = 0;
+  while (i < tokens.length) {
+    const token = assertDefined8(tokens[i]);
+    const tokenLower = token.toLowerCase();
+    if (knownFlagsWithParams.has(tokenLower)) {
+      if (i + 1 >= tokens.length) {
+        break;
+      }
+      flags.push(token, assertDefined8(tokens[i + 1]));
+      i += 2;
+      continue;
+    }
+    if (knownFlagsNoParams.has(tokenLower)) {
+      flags.push(token);
+      i += 1;
+      continue;
+    }
+    break;
+  }
+  const command = tokens.slice(i).join(" ");
+  return {
+    flags,
+    command
+  };
+};
+
+// packages/core/src/lib/process/functions/get-commands-for-shell.ts
+var shell;
+var getCommandsForShell = (shellCommand) => {
+  shell = shell ?? getShell();
+  switch (shell) {
+    case Shell.cmd:
+      return [
+        shell,
+        "/c",
+        escapeShellArg(shellCommand, shell)
+      ];
+    case Shell.pwsh:
+    case Shell.powershell:
+      const {
+        flags,
+        command
+      } = parsePsFlags(shellCommand);
+      const encodedCommand = Buffer.from(command, "utf16le").toString("base64");
+      return [
+        shell,
+        ...flags,
+        ...encodedCommand ? ["-EncodedCommand", encodedCommand] : []
+      ];
+    default:
+      return [
+        shell,
+        "-c",
+        escapeShellArg(shellCommand, shell)
+      ];
+  }
+};
+
+// packages/core/src/lib/process/functions/get-line-buffered-writer.ts
+import { identity } from "@package-pal/util";
+var getLineBufferedWriter = (prefix, style = identity, write = process.stdout.write.bind(process.stdout)) => {
+  let buffer = "";
+  return (chunk) => {
+    buffer += chunk;
+    const lines = buffer.split(`
+`);
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      write(`${prefix}${style(line)}
+`);
+    }
+  };
+};
+
+// packages/core/src/lib/process/functions/read-stream.ts
+var readStream = async (stream, use) => {
+  if (!stream) {
+    return;
+  }
+  const decoder = new TextDecoder;
+  const reader = stream.getReader();
+  let result = await reader.read();
+  while (!result.done) {
+    use(decoder.decode(result.value, { stream: true }));
+    result = await reader.read();
+  }
+  const flush = decoder.decode();
+  if (flush) {
+    use(flush);
+  }
+};
+
+// packages/core/src/lib/process/functions/run-subprocess.ts
+var sigintCode = 130;
+var sigtermCode = 143;
+var sigkillCode = 137;
+var cancelCodes = new Set([
+  sigintCode,
+  sigtermCode,
+  sigkillCode
+]);
+var runSubprocess = async (opts) => {
+  if (opts.signal?.aborted) {
+    opts.logger.debug(dim7(`Skipped '${opts.debugName}' subprocess command; signal already cancelled.`));
+    return ExitState.Cancelled;
+  }
+  const commands = getCommandsForShell(opts.shellCommand);
+  const subprocess = Bun.spawn(commands, {
+    cwd: opts.cwd,
+    stdout: "pipe",
+    stderr: "pipe",
+    stdin: "ignore",
+    signal: opts.signal
+  });
+  const pid = subprocess.pid.toString();
+  const minPrefixLen = 14;
+  const [readStdout, readStderr] = [{
+    source: subprocess.stdout,
+    type: StdType.Out,
+    write: getLineBufferedWriter(dim7(`[O-${pid}]`.padEnd(minPrefixLen, " ")))
+  }, {
+    source: subprocess.stderr,
+    type: StdType.Err,
+    write: getLineBufferedWriter(red2(dim7(`[E-${pid}]`.padEnd(minPrefixLen, " "))))
+  }].map(({
+    source,
+    type,
+    write
+  }) => {
+    return readStream(source, (chunk) => {
+      write(chunk);
+      if (opts.onStdChunk) {
+        opts.onStdChunk(chunk, type);
+      }
+    });
+  });
+  const executedCommand = commands.join(" ");
+  opts.logger.debug(dim7(`Started '${opts.debugName}' subprocess command '${opts.shellCommand}' (${executedCommand}) with PID ${pid}.`));
+  const [
+    ,
+    ,
+    exitState
+  ] = await Promise.all([
+    readStdout,
+    readStderr,
+    subprocess.exited.then((exitCode) => {
+      if (cancelCodes.has(exitCode)) {
+        opts.logger.debug(dim7(`Cancelled '${opts.debugName}' subprocess command; PID ${pid} exited.`));
+        return ExitState.Cancelled;
+      }
+      if (exitCode !== 0) {
+        opts.logger.error(red2(`'${opts.debugName}' command '${opts.shellCommand}' (${executedCommand}) with PID ${pid} failed with exit code ${exitCode.toString()}.`));
+        return ExitState.Errored;
+      }
+      opts.logger.debug(dim7(`Completed '${opts.debugName}' subprocess command; PID ${pid} exited.`));
+      return ExitState.Completed;
+    })
+  ]);
+  return exitState;
+};
+
+// packages/core/src/lib/package/functions/run-for-each-package.ts
+var runForEachPackage = async (packageGraphs, packageOrder, getCommand, parallel, topological, logger) => {
+  const controller = new AbortController;
+  let processPackageOrder = packageOrder.groups.concat(packageOrder.circular);
+  if (!topological) {
+    processPackageOrder = [processPackageOrder.flat()];
+  }
+  for (const group of processPackageOrder) {
+    await runAsync(parallel ? RunAsyncType.Parallel : RunAsyncType.Sequential, group.map((packageName) => async () => {
+      const packageNode = assertDefined9(packageGraphs.dependencies.get(packageName));
+      const processPackageProps = {
+        name: packageName,
+        dir: packageNode.packageData.dir
+      };
+      const processPackageCwd = dirname6(packageNode.packageData.path);
+      const shellCommand = await getCommand(processPackageProps);
+      if (!shellCommand) {
+        return;
+      }
+      const exitState = await runSubprocess({
+        debugName: `run for ${packageName}`,
+        shellCommand,
+        cwd: processPackageCwd,
+        signal: controller.signal,
+        logger
+      });
+      if (exitState === ExitState.Errored) {
+        controller.abort();
+        throw new Error("Command failed.");
+      }
+    }));
+  }
+};
+
+// packages/core/src/lib/package/functions/update-package-version.ts
 var {semver } = globalThis.Bun;
 import { inc } from "semver";
-import { dim as dim7 } from "yoctocolors";
+import { dim as dim8 } from "yoctocolors";
 var findAndReplaceVersion = ({
   raw,
   field,
@@ -715,7 +1004,7 @@ var findAndReplaceVersion = ({
   return `${before}${updatedVersion}${after}`;
 };
 var updatePackageVersion = async (packageName, type, packageGraphs, preId, exact, logger) => {
-  logger.debug(dim7(`Bumping package '${packageName}'...`));
+  logger.debug(dim8(`Bumping package '${packageName}'...`));
   const packageNode = packageGraphs.dependencies.get(packageName);
   if (!packageNode) {
     throw new Error(`Package '${packageName}' not found.`);
@@ -747,7 +1036,7 @@ var updatePackageVersion = async (packageName, type, packageGraphs, preId, exact
         return [];
       }
       if (exact ? depVersion === bumpedVersion : semver.satisfies(bumpedVersion, depVersion)) {
-        logger.debug(dim7(`Skipping '${dependent.name}': ${field} version '${depVersion}' already satisfies '${bumpedVersion}'.`));
+        logger.debug(dim8(`Skipping '${dependent.name}': ${field} version '${depVersion}' already satisfies '${bumpedVersion}'.`));
         return [];
       }
       const updatedContent2 = findAndReplaceVersion({
@@ -767,28 +1056,67 @@ var updatePackageVersion = async (packageName, type, packageGraphs, preId, exact
   });
 };
 
-// src/lib/watch/functions/watch-package-changes.ts
+// packages/core/src/lib/watch/functions/watch-package-changes.ts
 import {
   watch
 } from "fs";
 import {
-  dirname as dirname6,
+  dirname as dirname8,
   join as join4
 } from "path";
 import {
-  assertDefined as assertDefined9,
+  assertDefined as assertDefined12,
   DedupePathsBy,
   dedupeSharedPaths,
   getDeferredPromise,
   getStringMatcher,
-  isDefined as isDefined4
+  isDefined as isDefined4,
+  RunAsyncType as RunAsyncType2,
+  runAsync as runAsync2
 } from "@package-pal/util";
 import {
-  dim as dim9,
+  dim as dim10,
   red as red3
 } from "yoctocolors";
 
-// src/lib/graph/functions/generate-topological-ranking-range.ts
+// packages/core/src/lib/graph/functions/merge-graphs.ts
+var mergeGraphs = (a, b) => {
+  const merged = new Map;
+  for (const [name, node] of a) {
+    merged.set(name, {
+      packageData: node.packageData,
+      pointsToPackages: new Set(node.pointsToPackages)
+    });
+  }
+  for (const [name, node] of b) {
+    merged.set(name, {
+      packageData: node.packageData,
+      pointsToPackages: new Set(node.pointsToPackages)
+    });
+  }
+  return merged;
+};
+
+// packages/core/src/lib/watch/types/change-action.ts
+var ChangeAction = {
+  Ignore: "Ignore",
+  Partial: "Partial",
+  Restart: "Restart"
+};
+
+// packages/core/src/lib/watch/functions/filter-files-modified-since.ts
+var filterFilesModifiedSince = (paths, sinceMs) => {
+  return paths.filter((path) => {
+    const changedFile = Bun.file(path);
+    return changedFile.lastModified >= sinceMs;
+  });
+};
+
+// packages/core/src/lib/watch/functions/get-change-logic.ts
+import { assertDefined as assertDefined11 } from "@package-pal/util";
+import { dim as dim9 } from "yoctocolors";
+
+// packages/core/src/lib/graph/functions/generate-topological-ranking-range.ts
 import { isDefined as isDefined3 } from "@package-pal/util";
 var generateTopologicalRankingRange = (graph, ranking) => {
   let min = Infinity;
@@ -811,19 +1139,19 @@ var generateTopologicalRankingRange = (graph, ranking) => {
   return [min, max];
 };
 
-// src/lib/graph/functions/generate-topological-ranking.ts
-import { assertDefined as assertDefined8 } from "@package-pal/util";
+// packages/core/src/lib/graph/functions/generate-topological-ranking.ts
+import { assertDefined as assertDefined10 } from "@package-pal/util";
 var generateTopologicalRanking = (packageProcessOrder) => {
   const rankMap = new Map;
   for (let i = 0;i < packageProcessOrder.length; i++) {
-    for (const packageName of assertDefined8(packageProcessOrder[i])) {
+    for (const packageName of assertDefined10(packageProcessOrder[i])) {
       rankMap.set(packageName, i);
     }
   }
   return rankMap;
 };
 
-// src/lib/graph/functions/is-disjoint.ts
+// packages/core/src/lib/graph/functions/is-disjoint.ts
 var isDisjoint = (a, b) => {
   for (const key of a.keys()) {
     if (b.has(key)) {
@@ -833,7 +1161,7 @@ var isDisjoint = (a, b) => {
   return true;
 };
 
-// src/lib/graph/functions/is-ranked-greater-than-or-equal.ts
+// packages/core/src/lib/graph/functions/is-ranked-greater-than-or-equal.ts
 var isRankedGreaterThanOrEqual = (a, b, ranking) => {
   const [prevMin] = generateTopologicalRankingRange(a, ranking);
   for (const key of b.keys()) {
@@ -845,7 +1173,7 @@ var isRankedGreaterThanOrEqual = (a, b, ranking) => {
   return true;
 };
 
-// src/lib/graph/functions/is-subgraph.ts
+// packages/core/src/lib/graph/functions/is-subgraph.ts
 var recordEqual = (a, b) => {
   if (!a && !b) {
     return true;
@@ -881,220 +1209,8 @@ var isSubgraph = (a, b) => {
   return true;
 };
 
-// src/lib/watch/types/change-action.ts
-var ChangeAction = {
-  Ignore: "Ignore",
-  Partial: "Partial",
-  Restart: "Restart"
-};
-
-// src/lib/watch/types/exit-state.ts
-var ExitState = {
-  Completed: "Completed",
-  Errored: "Errored",
-  Cancelled: "Cancelled"
-};
-
-// src/lib/watch/types/run-async-type.ts
-var RunAsyncType = {
-  Sequential: "Sequential",
-  Parallel: "Parallel"
-};
-
-// src/lib/watch/functions/filter-files-modified-since.ts
-var filterFilesModifiedSince = (paths, sinceMs) => {
-  return paths.filter((path) => {
-    const changedFile = Bun.file(path);
-    return changedFile.lastModified >= sinceMs;
-  });
-};
-
-// src/lib/watch/functions/normalise-watched-file-path.ts
-import {
-  basename as basename3,
-  dirname as dirname5,
-  join as join3
-} from "path";
-var removeTrailing = [
-  "~",
-  ".tmp",
-  ".temp",
-  ".bak",
-  ".backup",
-  ".swp",
-  ".swo",
-  ".swn"
-];
-var normaliseWatchedFilePath = (filePath) => {
-  const dir = dirname5(filePath);
-  let base = basename3(filePath);
-  for (const trailing of removeTrailing) {
-    if (base.toLowerCase().endsWith(trailing)) {
-      const sliceStart = base.startsWith(".") ? 1 : 0;
-      base = base.slice(sliceStart, -trailing.length);
-      break;
-    }
-  }
-  return join3(dir, base);
-};
-
-// src/lib/watch/functions/run-async.ts
-var runAsync = async (type, tasks) => {
-  if (type === RunAsyncType.Parallel) {
-    return Promise.all(tasks.map((task) => task()));
-  }
-  const outputs = [];
-  for (const task of tasks) {
-    const result = await task();
-    outputs.push(result);
-  }
-  return outputs;
-};
-
-// src/lib/watch/functions/run-subprocess.ts
-import {
-  dim as dim8,
-  red as red2
-} from "yoctocolors";
-
-// src/lib/watch/types/std-type.ts
-var StdType = {
-  Out: "Out",
-  Err: "Err"
-};
-
-// src/lib/watch/functions/get-commands-for-shell.ts
-var getCommandsForShell = (shellCommand) => {
-  const isWindows = process.platform === "win32";
-  if (!isWindows) {
-    return [
-      "sh",
-      "-c",
-      `"${shellCommand}"`
-    ];
-  }
-  const shell = Bun.which("pwsh") ? "pwsh" : Bun.which("powershell") ? "powershell" : "cmd";
-  if (shell === "cmd") {
-    return [
-      shell,
-      "/c",
-      `"${shellCommand}"`
-    ];
-  }
-  const encodedCommand = Buffer.from(shellCommand, "utf16le").toString("base64");
-  return [
-    shell,
-    "-EncodedCommand",
-    encodedCommand
-  ];
-};
-
-// src/lib/watch/functions/get-line-buffered-writer.ts
-import { identity } from "@package-pal/util";
-var getLineBufferedWriter = (prefix, style = identity, write = process.stdout.write.bind(process.stdout)) => {
-  let buffer = "";
-  return (chunk) => {
-    buffer += chunk;
-    const lines = buffer.split(`
-`);
-    buffer = lines.pop() ?? "";
-    for (const line of lines) {
-      write(`${prefix}${style(line)}
-`);
-    }
-  };
-};
-
-// src/lib/watch/functions/read-stream.ts
-var readStream = async (stream, use) => {
-  if (!stream) {
-    return;
-  }
-  const decoder = new TextDecoder;
-  const reader = stream.getReader();
-  let result = await reader.read();
-  while (!result.done) {
-    use(decoder.decode(result.value, { stream: true }));
-    result = await reader.read();
-  }
-  const flush = decoder.decode();
-  if (flush) {
-    use(flush);
-  }
-};
-
-// src/lib/watch/functions/run-subprocess.ts
-var sigintCode = 130;
-var sigtermCode = 143;
-var sigkillCode = 137;
-var cancelCodes = new Set([
-  sigintCode,
-  sigtermCode,
-  sigkillCode
-]);
-var runSubprocess = async (opts) => {
-  if (opts.signal?.aborted) {
-    opts.logger.debug(dim8(`Skipped '${opts.debugName}' subprocess command; signal already cancelled.`));
-    return ExitState.Cancelled;
-  }
-  const commands = getCommandsForShell(opts.shellCommand);
-  const subprocess = Bun.spawn(commands, {
-    cwd: opts.cwd,
-    stdout: "pipe",
-    stderr: "pipe",
-    stdin: "ignore",
-    signal: opts.signal
-  });
-  const pid = subprocess.pid.toString();
-  const [readStdout, readStderr] = [{
-    source: subprocess.stdout,
-    type: StdType.Out,
-    write: getLineBufferedWriter(dim8(`[OUT-${pid}]	`))
-  }, {
-    source: subprocess.stderr,
-    type: StdType.Err,
-    write: getLineBufferedWriter(red2(dim8(`[ERR-${pid}]	`)))
-  }].map(({
-    source,
-    type,
-    write
-  }) => {
-    return readStream(source, (chunk) => {
-      write(chunk);
-      if (opts.onStdChunk) {
-        opts.onStdChunk(chunk, type);
-      }
-    });
-  });
-  const executedCommand = commands.join(" ");
-  opts.logger.debug(dim8(`Started '${opts.debugName}' subprocess command '${opts.shellCommand}' (${executedCommand}) with PID ${pid}.`));
-  const [
-    ,
-    ,
-    exitState
-  ] = await Promise.all([
-    readStdout,
-    readStderr,
-    subprocess.exited.then((exitCode) => {
-      if (cancelCodes.has(exitCode)) {
-        opts.logger.debug(dim8(`Cancelled '${opts.debugName}' subprocess command; PID ${pid} exited.`));
-        return ExitState.Cancelled;
-      }
-      if (exitCode !== 0) {
-        opts.logger.error(red2(`'${opts.debugName}' command '${opts.shellCommand}' (${executedCommand}) with PID ${pid} failed with exit code ${exitCode.toString()}.`));
-        return ExitState.Errored;
-      }
-      opts.logger.debug(dim8(`Completed '${opts.debugName}' subprocess command; PID ${pid} exited.`));
-      return ExitState.Completed;
-    })
-  ]);
-  return exitState;
-};
-
-// src/lib/watch/functions/watch-package-changes.ts
-var fileModifiedThresholdMs = 5000;
-var lastProcessedSubgraph;
-var getChangeLogic = (packageGraphs, packageChanges, config, logger) => {
+// packages/core/src/lib/watch/functions/get-change-logic.ts
+var getChangeLogic = (packageGraphs, packageChanges, lastProcessedSubgraph, config, logger) => {
   const changedPackages = Array.from(packageChanges.keys());
   const changedFilePaths = Array.from(packageChanges.values()).flat();
   if (packageChanges.size) {
@@ -1124,9 +1240,9 @@ var getChangeLogic = (packageGraphs, packageChanges, config, logger) => {
     action = ChangeAction.Partial;
   }
   if (action === ChangeAction.Partial && isRankedGreaterThanOrEqualToPrevious) {
-    const [prevMinRank] = generateTopologicalRankingRange(assertDefined9(lastProcessedSubgraph), packageRankings);
+    const [prevMinRank] = generateTopologicalRankingRange(assertDefined11(lastProcessedSubgraph), packageRankings);
     for (let i = 0;i < changedPackageProcessOrder.length; i++) {
-      changedPackageProcessOrder[i] = assertDefined9(changedPackageProcessOrder[i]).filter((packageName) => {
+      changedPackageProcessOrder[i] = assertDefined11(changedPackageProcessOrder[i]).filter((packageName) => {
         const rank = packageRankings.get(packageName);
         return rank !== undefined && rank >= prevMinRank;
       });
@@ -1139,15 +1255,48 @@ var getChangeLogic = (packageGraphs, packageChanges, config, logger) => {
     action
   };
 };
+
+// packages/core/src/lib/watch/functions/normalise-watched-file-path.ts
+import {
+  basename as basename3,
+  dirname as dirname7,
+  join as join3
+} from "path";
+var removeTrailing = [
+  "~",
+  ".tmp",
+  ".temp",
+  ".bak",
+  ".backup",
+  ".swp",
+  ".swo",
+  ".swn"
+];
+var normaliseWatchedFilePath = (filePath) => {
+  const dir = dirname7(filePath);
+  let base = basename3(filePath);
+  for (const trailing of removeTrailing) {
+    if (base.toLowerCase().endsWith(trailing)) {
+      const sliceStart = base.startsWith(".") ? 1 : 0;
+      base = base.slice(sliceStart, -trailing.length);
+      break;
+    }
+  }
+  return join3(dir, base);
+};
+
+// packages/core/src/lib/watch/functions/watch-package-changes.ts
+var fileModifiedThresholdMs = 5000;
+var lastProcessedSubgraph;
 var onProcessPackage = async (packageGraphs, packageChanges, watchConfig, determineAbortController, logger) => {
   const {
     action,
     changedPackageProcessOrder,
     changedPackageSubgraph
-  } = getChangeLogic(packageGraphs, packageChanges, watchConfig, logger);
+  } = getChangeLogic(packageGraphs, packageChanges, lastProcessedSubgraph, watchConfig, logger);
   const controller = determineAbortController(action === ChangeAction.Restart);
   const onProcessFailure = () => {
-    logger.debug(dim9("Aborting controller: process failed."));
+    logger.debug(dim10("Aborting controller: process failed."));
     controller.abort();
     lastProcessedSubgraph = undefined;
   };
@@ -1157,7 +1306,7 @@ var onProcessPackage = async (packageGraphs, packageChanges, watchConfig, determ
   }
   if (packageChanges.size) {
     logger.info(`Changes detected. ${action === ChangeAction.Restart ? "Restarting processing" : "Initiating partial processing"} ${watchConfig.subprocess.parallelProcessing ? "in parallel" : "sequentially"}.`);
-    lastProcessedSubgraph = changedPackageSubgraph;
+    lastProcessedSubgraph = lastProcessedSubgraph ? mergeGraphs(lastProcessedSubgraph, changedPackageSubgraph) : changedPackageSubgraph;
   }
   for (const group of changedPackageProcessOrder) {
     const {
@@ -1165,12 +1314,12 @@ var onProcessPackage = async (packageGraphs, packageChanges, watchConfig, determ
       resolve: matchedParallelLongReadyRunningOutput
     } = getDeferredPromise();
     let matchedLongRunningOutputCount = 0;
-    await runAsync(watchConfig.subprocess.parallelProcessing ? RunAsyncType.Parallel : RunAsyncType.Sequential, group.map((packageName) => async () => {
+    await runAsync2(watchConfig.subprocess.parallelProcessing ? RunAsyncType2.Parallel : RunAsyncType2.Sequential, group.map((packageName) => async () => {
       const {
         promise: longRunningSequentialProcessReady,
         resolve: matchedSequentialLongRunningReadyOutput
       } = getDeferredPromise();
-      const packageNode = assertDefined9(packageGraphs.dependencies.get(packageName));
+      const packageNode = assertDefined12(packageGraphs.dependencies.get(packageName));
       const changedPaths = packageChanges.get(packageName) ?? [];
       const processPackageProps = {
         name: packageName,
@@ -1180,7 +1329,7 @@ var onProcessPackage = async (packageGraphs, packageChanges, watchConfig, determ
         totalProcessOrder: changedPackageProcessOrder,
         signal: controller.signal
       };
-      const processPackageCwd = dirname6(packageNode.packageData.path);
+      const processPackageCwd = dirname8(packageNode.packageData.path);
       const beforeProcessPackageShellCommand = await watchConfig.hooks.onBeforeProcessPackage(processPackageProps);
       if (beforeProcessPackageShellCommand) {
         await runSubprocess({
@@ -1209,13 +1358,13 @@ var onProcessPackage = async (packageGraphs, packageChanges, watchConfig, determ
             if (!ready && readyMatcher?.push(chunk).matched()) {
               ready = true;
               matchedLongRunningOutputCount++;
-              logger.debug(`'${packageName}' (${matchedLongRunningOutputCount.toString()}/${group.length.toString()}) subprocess matched ready text '${assertDefined9(longRunningOutputReadyText)}'.`);
+              logger.debug(`'${packageName}' (${matchedLongRunningOutputCount.toString()}/${group.length.toString()}) subprocess matched ready text '${assertDefined12(longRunningOutputReadyText)}'.`);
               if (!watchConfig.subprocess.parallelProcessing && matchedLongRunningOutputCount) {
                 matchedSequentialLongRunningReadyOutput();
               }
             }
             if (!errored && erroredMatcher?.push(chunk).matched()) {
-              logger.error(red3(`'${packageName}' subprocess matched error text '${assertDefined9(longRunningOutputErroredText)}'.`));
+              logger.error(red3(`'${packageName}' subprocess matched error text '${assertDefined12(longRunningOutputErroredText)}'.`));
               errored = true;
               Promise.resolve(watchConfig.hooks.onProcessPackageError(processPackageProps)).then((processPackageErrorCommand) => {
                 if (!processPackageErrorCommand) {
@@ -1298,23 +1447,23 @@ var onProcessPackage = async (packageGraphs, packageChanges, watchConfig, determ
   }
 };
 var watchPackageChanges = (packageData, packageGraphs, watchConfig, logger) => {
-  const dedupedRootPackageData = dedupeSharedPaths(packageData.map((packageData2) => packageData2.path), DedupePathsBy.Parent).map((packagePath) => assertDefined9(packageData.find((data) => data.path === packagePath)));
-  logger.debug(dim9(`Starting ${dedupedRootPackageData.length.toString()} watchers for ${packageData.length.toString()} packages.`));
+  const dedupedRootPackageData = dedupeSharedPaths(packageData.map((packageData2) => packageData2.path), DedupePathsBy.Parent).map((packagePath) => assertDefined12(packageData.find((data) => data.path === packagePath)));
+  logger.debug(dim10(`Starting ${dedupedRootPackageData.length.toString()} watchers for ${packageData.length.toString()} packages.`));
   let closed = false;
   let debounceTimeout;
   let startedDebounceMs;
-  let abortController;
+  let controller;
   const changedPackagePaths = new Map;
   const useController = (reset) => {
-    if (abortController && (reset || abortController.signal.aborted)) {
+    if (controller && (reset || controller.signal.aborted)) {
       if (reset) {
-        logger.debug(dim9("Aborting controller: reset for new packages."));
-        abortController.abort();
+        logger.debug(dim10("Aborting controller: reset for new packages."));
+        controller.abort();
       }
-      abortController = undefined;
+      controller = undefined;
     }
-    abortController ??= new AbortController;
-    return abortController;
+    controller ??= new AbortController;
+    return controller;
   };
   const onWatchEvent = (watchPath, packageName, _event, filePath, forceEmpty = false) => {
     if (!isDefined4(startedDebounceMs)) {
@@ -1338,7 +1487,7 @@ var watchPackageChanges = (packageData, packageGraphs, watchConfig, logger) => {
       }
       const packageChanges = new Map;
       for (const [packageName2, paths] of changedPackagePaths) {
-        const processedPaths = filterFilesModifiedSince(dedupeSharedPaths(Array.from(paths), DedupePathsBy.Child).sort(), assertDefined9(startedDebounceMs) - fileModifiedThresholdMs);
+        const processedPaths = filterFilesModifiedSince(dedupeSharedPaths(Array.from(paths), DedupePathsBy.Child).sort(), assertDefined12(startedDebounceMs) - fileModifiedThresholdMs);
         if (processedPaths.length) {
           packageChanges.set(packageName2, processedPaths);
         }
@@ -1355,7 +1504,7 @@ var watchPackageChanges = (packageData, packageGraphs, watchConfig, logger) => {
     name,
     path
   }) => {
-    const watchPath = dirname6(path);
+    const watchPath = dirname8(path);
     return watch(watchPath, { recursive: true }, (event, filePath) => {
       onWatchEvent(watchPath, name, event, filePath);
     });
@@ -1364,27 +1513,27 @@ var watchPackageChanges = (packageData, packageGraphs, watchConfig, logger) => {
     watchers.forEach((watcher) => {
       watcher.close();
     });
-    logger.debug(dim9("Aborting controller: closing watchers."));
-    abortController?.abort();
+    logger.debug(dim10("Aborting controller: closing watchers."));
+    controller?.abort();
     closed = true;
   };
   process.on("SIGINT", () => {
-    logger.debug(dim9("Received SIGINT: closing watchers."));
+    logger.debug(dim10("Received SIGINT: closing watchers."));
     closeWatchers();
     process.exit(0);
   });
   onWatchEvent(undefined, undefined, undefined, null, true);
   return { close: () => {
     if (closed) {
-      logger.debug(dim9("Watchers already closed."));
+      logger.debug(dim10("Watchers already closed."));
       return;
     }
-    logger.debug(dim9("Closing watchers."));
+    logger.debug(dim10("Closing watchers."));
     closeWatchers();
   } };
 };
 
-// src/lib/api.ts
+// packages/core/src/lib/api.ts
 var readPackagePalConfig = (options) => {
   checkBun();
   return loadConfig(options?.overrideConfigPath);
@@ -1392,7 +1541,7 @@ var readPackagePalConfig = (options) => {
 var readPackageData = async (options) => {
   checkBun();
   const packagePatterns = Array.isArray(options.config.packages) ? options.config.packages : [options.config.packages];
-  return loadPackages(packagePatterns, options.config.logger);
+  return loadPackages(options.rootDir, packagePatterns, options.config.logger);
 };
 var getPackageGraphs = (options) => {
   checkBun();
@@ -1416,6 +1565,10 @@ var watchPackages = (options) => {
   checkBun();
   watchPackageChanges(options.packageData, options.packageGraphs, options.config.watch, options.config.logger);
 };
+var forEachPackage = (options) => {
+  checkBun();
+  return runForEachPackage(options.packageGraphs, options.packageOrder, options.getCommand, options.parallel ?? true, options.topological ?? true, options.config.logger);
+};
 export {
   watchPackages,
   readPackagePalConfig,
@@ -1423,9 +1576,10 @@ export {
   getPackageOrder,
   getPackageGraphs,
   getPackageCircularDependencyPaths,
+  forEachPackage,
   bumpPackageVersion,
   BumpVersionType
 };
 
-//# debugId=E0ED0EB8F615FC9B64756E2164756E21
+//# debugId=F0FEFB088F7E727464756E2164756E21
 //# sourceMappingURL=index.js.map