Function parsePackageChanges

scripts/changes/changes.ts:60–187

* Parses and validates all change files for a package. * Returns changes if valid, or errors if invalid.

(packageDirName: string)

 * Returns changes if valid, or errors if invalid.
 */
function parsePackageChanges(packageDirName: string): ParsedPackageChanges {
  let packagePath = getPackagePath(packageDirName);
  let changesDir = path.join(packagePath, ".changes");
  let changes: ChangeFile[] = [];
  let errors: ValidationError[] = [];

  // Changes directory should exist (with at least .gitkeep)
  if (!fs.existsSync(changesDir)) {
    return {
      valid: false,
      errors: [
        {
          packageDirName,
          file: ".changes/",
          error: "Changes directory does not exist",
        },
      ],
    };
  }

  // .gitkeep should exist in .changes directory so it persists between releases
  let gitkeepPath = path.join(changesDir, ".gitkeep");
  if (!fs.existsSync(gitkeepPath)) {
    errors.push({
      packageDirName,
      file: ".changes/.gitkeep",
      error: ".gitkeep is missing from .changes directory",
    });
  }

  // Get package version to determine validation rules
  let packageJsonPath = getPackageFile(packageDirName, "package.json");
  let packageJson = readJson(packageJsonPath);
  let currentVersion = packageJson.version as string;

  // Read all files in .changes directory
  let changeFileNames = fs
    .readdirSync(changesDir)
    .filter((file) => file.endsWith(".md"));

  for (let file of changeFileNames) {
    // Parse and validate filename format (e.g. "minor.add-feature.md")
    let bump: BumpType | null = null;

    let withoutExt = path.basename(file, ".md");
    let dotIndex = withoutExt.indexOf(".");
    if (dotIndex !== -1) {
      let bumpStr = withoutExt.slice(0, dotIndex);
      let name = withoutExt.slice(dotIndex + 1);
      if (bumpTypes.includes(bumpStr as BumpType) && name.length > 0) {
        bump = bumpStr as BumpType;
      }
    }

    if (bump == null) {
      errors.push({
        packageDirName,
        file,