@intlayer/cli 5.5.9 → 5.5.11

package/dist/cjs/utils/getOutputFilePath.cjs

@@ -0,0 +1,89 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var getOutputFilePath_exports = {};
+__export(getOutputFilePath_exports, {
+  getOutputFilePath: () => getOutputFilePath
+});
+module.exports = __toCommonJS(getOutputFilePath_exports);
+const getOutputFilePath = (filePath, locale, baseLocale) => {
+  if (!filePath || !locale || !baseLocale) {
+    throw new Error("filePath, locale, and baseLocale are required");
+  }
+  let outputFilePath = filePath;
+  const replacements = [
+    // Template placeholders (processed first)
+    {
+      pattern: /\{\{baseLocale\}\}/g,
+      replacement: "{{locale}}"
+    },
+    {
+      pattern: /\{\{baseLocaleName\}\}/g,
+      replacement: "{{localeName}}"
+    },
+    // Path separators (most specific first)
+    {
+      // Unix path separators
+      pattern: new RegExp(`/${baseLocale}/`, "g"),
+      replacement: `/${locale}/`
+    },
+    {
+      // Windows path separators
+      pattern: new RegExp(`\\\\${baseLocale}\\\\`, "g"),
+      replacement: `\\${locale}\\`
+    },
+    // File naming patterns
+    {
+      // file_en.md → file_fr.md
+      pattern: new RegExp(`_${baseLocale}\\.`, "g"),
+      replacement: `_${locale}.`
+    },
+    {
+      // /file_en.md → /file_fr.md
+      pattern: new RegExp(`/${baseLocale}_`, "g"),
+      replacement: `/${locale}_`
+    },
+    {
+      // Start of filename pattern en_guide.md → fr_guide.md (or after path separator)
+      pattern: new RegExp(`(^|[\\/])${baseLocale}_`, "g"),
+      replacement: `$1${locale}_`
+    },
+    {
+      // Dot delimited pattern guide.en.md → guide.fr.md
+      pattern: new RegExp(`\\.${baseLocale}\\.`, "g"),
+      replacement: `.${locale}.`
+    }
+  ];
+  for (const { pattern, replacement } of replacements) {
+    outputFilePath = outputFilePath.replace(pattern, replacement);
+  }
+  if (outputFilePath === filePath) {
+    const lastDotIndex = filePath.lastIndexOf(".");
+    if (lastDotIndex > 0) {
+      return `${filePath.slice(0, lastDotIndex)}.${locale}${filePath.slice(lastDotIndex)}`;
+    } else {
+      return `${filePath}.${locale}`;
+    }
+  }
+  return outputFilePath;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getOutputFilePath
+});
+//# sourceMappingURL=getOutputFilePath.cjs.map

package/dist/cjs/utils/getOutputFilePath.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/getOutputFilePath.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/config';\n\n/**\n * Get the output file path by replacing the base locale with the target locale\n *\n * This function handles two types of replacements:\n * 1. Actual locale values (e.g., `/en/` → `/fr/`)\n * 2. Template placeholders (e.g., `{{baseLocale}}` → `{{locale}}`, `{{baseLocaleName}}` → `{{localeName}}`)\n *\n * Replacement patterns:\n * - `/baseLocale/` → `/locale/`\n * - `\\baseLocale\\` → `\\locale\\`\n * - `_baseLocale.` → `_locale.`\n * - `baseLocale_` → `locale_`\n * - `.baseLocaleName.` → `.localeName.`\n * - `{{baseLocale}}` → `{{locale}}`\n * - `{{baseLocaleName}}` → `{{localeName}}`\n *\n * If no patterns match, appends `.locale` to the file extension.\n *\n * @param filePath - The input file path\n * @param locale - The target locale\n * @param baseLocale - The base locale to replace\n * @returns The output file path with locale replacements\n */\nexport const getOutputFilePath = (\n  filePath: string,\n  locale: LocalesValues,\n  baseLocale: LocalesValues\n): string => {\n  if (!filePath || !locale || !baseLocale) {\n    throw new Error('filePath, locale, and baseLocale are required');\n  }\n\n  let outputFilePath = filePath;\n\n  // Define replacement patterns with global flag to replace all occurrences\n  const replacements = [\n    // Template placeholders (processed first)\n    {\n      pattern: /\\{\\{baseLocale\\}\\}/g,\n      replacement: '{{locale}}',\n    },\n    {\n      pattern: /\\{\\{baseLocaleName\\}\\}/g,\n      replacement: '{{localeName}}',\n    },\n\n    // Path separators (most specific first)\n    {\n      // Unix path separators\n      pattern: new RegExp(`/${baseLocale}/`, 'g'),\n      replacement: `/${locale}/`,\n    },\n    {\n      // Windows path separators\n      pattern: new RegExp(`\\\\\\\\${baseLocale}\\\\\\\\`, 'g'),\n      replacement: `\\\\${locale}\\\\`,\n    },\n\n    // File naming patterns\n    {\n      // file_en.md → file_fr.md\n      pattern: new RegExp(`_${baseLocale}\\\\.`, 'g'),\n      replacement: `_${locale}.`,\n    },\n    {\n      // /file_en.md → /file_fr.md\n      pattern: new RegExp(`/${baseLocale}_`, 'g'),\n      replacement: `/${locale}_`,\n    },\n    {\n      // Start of filename pattern en_guide.md → fr_guide.md (or after path separator)\n      pattern: new RegExp(`(^|[\\\\/])${baseLocale}_`, 'g'),\n      replacement: `$1${locale}_`,\n    },\n    {\n      // Dot delimited pattern guide.en.md → guide.fr.md\n      pattern: new RegExp(`\\\\.${baseLocale}\\\\.`, 'g'),\n      replacement: `.${locale}.`,\n    },\n  ];\n\n  // Apply all replacements\n  for (const { pattern, replacement } of replacements) {\n    outputFilePath = outputFilePath.replace(pattern, replacement);\n  }\n\n  // If no changes were made, append locale as extension\n  if (outputFilePath === filePath) {\n    const lastDotIndex = filePath.lastIndexOf('.');\n    if (lastDotIndex > 0) {\n      // Insert locale before the file extension\n      return `${filePath.slice(0, lastDotIndex)}.${locale}${filePath.slice(lastDotIndex)}`;\n    } else {\n      // No extension found, just append\n      return `${filePath}.${locale}`;\n    }\n  }\n\n  return outputFilePath;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyBO,MAAM,oBAAoB,CAC/B,UACA,QACA,eACW;AACX,MAAI,CAAC,YAAY,CAAC,UAAU,CAAC,YAAY;AACvC,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACjE;AAEA,MAAI,iBAAiB;AAGrB,QAAM,eAAe;AAAA;AAAA,IAEnB;AAAA,MACE,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA,IACA;AAAA,MACE,SAAS;AAAA,MACT,aAAa;AAAA,IACf;AAAA;AAAA,IAGA;AAAA;AAAA,MAEE,SAAS,IAAI,OAAO,IAAI,UAAU,KAAK,GAAG;AAAA,MAC1C,aAAa,IAAI,MAAM;AAAA,IACzB;AAAA,IACA;AAAA;AAAA,MAEE,SAAS,IAAI,OAAO,OAAO,UAAU,QAAQ,GAAG;AAAA,MAChD,aAAa,KAAK,MAAM;AAAA,IAC1B;AAAA;AAAA,IAGA;AAAA;AAAA,MAEE,SAAS,IAAI,OAAO,IAAI,UAAU,OAAO,GAAG;AAAA,MAC5C,aAAa,IAAI,MAAM;AAAA,IACzB;AAAA,IACA;AAAA;AAAA,MAEE,SAAS,IAAI,OAAO,IAAI,UAAU,KAAK,GAAG;AAAA,MAC1C,aAAa,IAAI,MAAM;AAAA,IACzB;AAAA,IACA;AAAA;AAAA,MAEE,SAAS,IAAI,OAAO,YAAY,UAAU,KAAK,GAAG;AAAA,MAClD,aAAa,KAAK,MAAM;AAAA,IAC1B;AAAA,IACA;AAAA;AAAA,MAEE,SAAS,IAAI,OAAO,MAAM,UAAU,OAAO,GAAG;AAAA,MAC9C,aAAa,IAAI,MAAM;AAAA,IACzB;AAAA,EACF;AAGA,aAAW,EAAE,SAAS,YAAY,KAAK,cAAc;AACnD,qBAAiB,eAAe,QAAQ,SAAS,WAAW;AAAA,EAC9D;AAGA,MAAI,mBAAmB,UAAU;AAC/B,UAAM,eAAe,SAAS,YAAY,GAAG;AAC7C,QAAI,eAAe,GAAG;AAEpB,aAAO,GAAG,SAAS,MAAM,GAAG,YAAY,CAAC,IAAI,MAAM,GAAG,SAAS,MAAM,YAAY,CAAC;AAAA,IACpF,OAAO;AAEL,aAAO,GAAG,QAAQ,IAAI,MAAM;AAAA,IAC9B;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/cjs/utils/getOutputFilePath.test.cjs

@@ -0,0 +1,73 @@
+"use strict";
+var import_config = require("@intlayer/config");
+var import_vitest = require("vitest");
+var import_getOutputFilePath = require('./getOutputFilePath.cjs');
+const baseLocale = import_config.Locales.ENGLISH;
+const targetLocale = import_config.Locales.FRENCH;
+(0, import_vitest.describe)("getOutputFilePath", () => {
+  (0, import_vitest.it)("should replace locale in directory paths", () => {
+    (0, import_vitest.expect)(
+      (0, import_getOutputFilePath.getOutputFilePath)("/docs/en/guide.md", targetLocale, baseLocale)
+    ).toBe("/docs/fr/guide.md");
+  });
+  (0, import_vitest.it)("should handle Windows-style paths", () => {
+    (0, import_vitest.expect)(
+      (0, import_getOutputFilePath.getOutputFilePath)("\\docs\\en\\guide.md", targetLocale, baseLocale)
+    ).toBe("\\docs\\fr\\guide.md");
+  });
+  (0, import_vitest.it)("should replace locale in file naming patterns", () => {
+    (0, import_vitest.expect)((0, import_getOutputFilePath.getOutputFilePath)("guide_en.md", targetLocale, baseLocale)).toBe(
+      "guide_fr.md"
+    );
+    (0, import_vitest.expect)((0, import_getOutputFilePath.getOutputFilePath)("en_guide.md", targetLocale, baseLocale)).toBe(
+      "fr_guide.md"
+    );
+  });
+  (0, import_vitest.it)("should handle template placeholders", () => {
+    (0, import_vitest.expect)(
+      (0, import_getOutputFilePath.getOutputFilePath)(
+        "/docs/{{baseLocale}}/guide.md",
+        targetLocale,
+        baseLocale
+      )
+    ).toBe("/docs/{{locale}}/guide.md");
+    (0, import_vitest.expect)(
+      (0, import_getOutputFilePath.getOutputFilePath)("guide.{{baseLocaleName}}.md", targetLocale, baseLocale)
+    ).toBe("guide.{{localeName}}.md");
+  });
+  (0, import_vitest.it)("should handle locale name patterns", () => {
+    (0, import_vitest.expect)((0, import_getOutputFilePath.getOutputFilePath)("guide.en.md", targetLocale, baseLocale)).toBe(
+      "guide.fr.md"
+    );
+  });
+  (0, import_vitest.it)("should append locale when no patterns match", () => {
+    (0, import_vitest.expect)((0, import_getOutputFilePath.getOutputFilePath)("/docs/guide.md", targetLocale, baseLocale)).toBe(
+      "/docs/guide.fr.md"
+    );
+  });
+  (0, import_vitest.it)("should handle files without extensions", () => {
+    (0, import_vitest.expect)((0, import_getOutputFilePath.getOutputFilePath)("/docs/guide", targetLocale, baseLocale)).toBe(
+      "/docs/guide.fr"
+    );
+  });
+  (0, import_vitest.it)("should handle multiple occurrences", () => {
+    (0, import_vitest.expect)(
+      (0, import_getOutputFilePath.getOutputFilePath)("/en/docs/en/guide_en.md", targetLocale, baseLocale)
+    ).toBe("/fr/docs/fr/guide_fr.md");
+  });
+  (0, import_vitest.it)("should not duplicate locale parts for composite target locales", () => {
+    const compositeTarget = "en-GB";
+    (0, import_vitest.expect)((0, import_getOutputFilePath.getOutputFilePath)("/en/file.md", compositeTarget, baseLocale)).toBe(
+      "/en-GB/file.md"
+    );
+  });
+  (0, import_vitest.it)("should throw error for invalid inputs", () => {
+    (0, import_vitest.expect)(() => (0, import_getOutputFilePath.getOutputFilePath)("", targetLocale, baseLocale)).toThrow(
+      "filePath, locale, and baseLocale are required"
+    );
+    (0, import_vitest.expect)(
+      () => (0, import_getOutputFilePath.getOutputFilePath)("/docs/guide.md", "", baseLocale)
+    ).toThrow("filePath, locale, and baseLocale are required");
+  });
+});
+//# sourceMappingURL=getOutputFilePath.test.cjs.map

package/dist/cjs/utils/getOutputFilePath.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/getOutputFilePath.test.ts"],"sourcesContent":["import { Locales } from '@intlayer/config';\nimport { describe, expect, it } from 'vitest';\nimport { getOutputFilePath } from './getOutputFilePath';\n\nconst baseLocale = Locales.ENGLISH;\nconst targetLocale = Locales.FRENCH;\n\ndescribe('getOutputFilePath', () => {\n  it('should replace locale in directory paths', () => {\n    expect(\n      getOutputFilePath('/docs/en/guide.md', targetLocale, baseLocale)\n    ).toBe('/docs/fr/guide.md');\n  });\n\n  it('should handle Windows-style paths', () => {\n    expect(\n      getOutputFilePath('\\\\docs\\\\en\\\\guide.md', targetLocale, baseLocale)\n    ).toBe('\\\\docs\\\\fr\\\\guide.md');\n  });\n\n  it('should replace locale in file naming patterns', () => {\n    expect(getOutputFilePath('guide_en.md', targetLocale, baseLocale)).toBe(\n      'guide_fr.md'\n    );\n\n    expect(getOutputFilePath('en_guide.md', targetLocale, baseLocale)).toBe(\n      'fr_guide.md'\n    );\n  });\n\n  it('should handle template placeholders', () => {\n    expect(\n      getOutputFilePath(\n        '/docs/{{baseLocale}}/guide.md',\n        targetLocale,\n        baseLocale\n      )\n    ).toBe('/docs/{{locale}}/guide.md');\n\n    expect(\n      getOutputFilePath('guide.{{baseLocaleName}}.md', targetLocale, baseLocale)\n    ).toBe('guide.{{localeName}}.md');\n  });\n\n  it('should handle locale name patterns', () => {\n    expect(getOutputFilePath('guide.en.md', targetLocale, baseLocale)).toBe(\n      'guide.fr.md'\n    );\n  });\n\n  it('should append locale when no patterns match', () => {\n    expect(getOutputFilePath('/docs/guide.md', targetLocale, baseLocale)).toBe(\n      '/docs/guide.fr.md'\n    );\n  });\n\n  it('should handle files without extensions', () => {\n    expect(getOutputFilePath('/docs/guide', targetLocale, baseLocale)).toBe(\n      '/docs/guide.fr'\n    );\n  });\n\n  it('should handle multiple occurrences', () => {\n    expect(\n      getOutputFilePath('/en/docs/en/guide_en.md', targetLocale, baseLocale)\n    ).toBe('/fr/docs/fr/guide_fr.md');\n  });\n\n  it('should not duplicate locale parts for composite target locales', () => {\n    const compositeTarget = 'en-GB' as unknown as Locales;\n    expect(getOutputFilePath('/en/file.md', compositeTarget, baseLocale)).toBe(\n      '/en-GB/file.md'\n    );\n  });\n\n  it('should throw error for invalid inputs', () => {\n    expect(() => getOutputFilePath('', targetLocale, baseLocale)).toThrow(\n      'filePath, locale, and baseLocale are required'\n    );\n\n    expect(() =>\n      getOutputFilePath('/docs/guide.md', '' as Locales, baseLocale)\n    ).toThrow('filePath, locale, and baseLocale are required');\n  });\n});\n"],"mappings":";AAAA,oBAAwB;AACxB,oBAAqC;AACrC,+BAAkC;AAElC,MAAM,aAAa,sBAAQ;AAC3B,MAAM,eAAe,sBAAQ;AAAA,IAE7B,wBAAS,qBAAqB,MAAM;AAClC,wBAAG,4CAA4C,MAAM;AACnD;AAAA,UACE,4CAAkB,qBAAqB,cAAc,UAAU;AAAA,IACjE,EAAE,KAAK,mBAAmB;AAAA,EAC5B,CAAC;AAED,wBAAG,qCAAqC,MAAM;AAC5C;AAAA,UACE,4CAAkB,wBAAwB,cAAc,UAAU;AAAA,IACpE,EAAE,KAAK,sBAAsB;AAAA,EAC/B,CAAC;AAED,wBAAG,iDAAiD,MAAM;AACxD,kCAAO,4CAAkB,eAAe,cAAc,UAAU,CAAC,EAAE;AAAA,MACjE;AAAA,IACF;AAEA,kCAAO,4CAAkB,eAAe,cAAc,UAAU,CAAC,EAAE;AAAA,MACjE;AAAA,IACF;AAAA,EACF,CAAC;AAED,wBAAG,uCAAuC,MAAM;AAC9C;AAAA,UACE;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF,EAAE,KAAK,2BAA2B;AAElC;AAAA,UACE,4CAAkB,+BAA+B,cAAc,UAAU;AAAA,IAC3E,EAAE,KAAK,yBAAyB;AAAA,EAClC,CAAC;AAED,wBAAG,sCAAsC,MAAM;AAC7C,kCAAO,4CAAkB,eAAe,cAAc,UAAU,CAAC,EAAE;AAAA,MACjE;AAAA,IACF;AAAA,EACF,CAAC;AAED,wBAAG,+CAA+C,MAAM;AACtD,kCAAO,4CAAkB,kBAAkB,cAAc,UAAU,CAAC,EAAE;AAAA,MACpE;AAAA,IACF;AAAA,EACF,CAAC;AAED,wBAAG,0CAA0C,MAAM;AACjD,kCAAO,4CAAkB,eAAe,cAAc,UAAU,CAAC,EAAE;AAAA,MACjE;AAAA,IACF;AAAA,EACF,CAAC;AAED,wBAAG,sCAAsC,MAAM;AAC7C;AAAA,UACE,4CAAkB,2BAA2B,cAAc,UAAU;AAAA,IACvE,EAAE,KAAK,yBAAyB;AAAA,EAClC,CAAC;AAED,wBAAG,kEAAkE,MAAM;AACzE,UAAM,kBAAkB;AACxB,kCAAO,4CAAkB,eAAe,iBAAiB,UAAU,CAAC,EAAE;AAAA,MACpE;AAAA,IACF;AAAA,EACF,CAAC;AAED,wBAAG,yCAAyC,MAAM;AAChD,8BAAO,UAAM,4CAAkB,IAAI,cAAc,UAAU,CAAC,EAAE;AAAA,MAC5D;AAAA,IACF;AAEA;AAAA,MAAO,UACL,4CAAkB,kBAAkB,IAAe,UAAU;AAAA,IAC/D,EAAE,QAAQ,+CAA+C;AAAA,EAC3D,CAAC;AACH,CAAC;","names":[]}

package/dist/cjs/utils/getParentPackageJSON.cjs

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var getParentPackageJSON_exports = {};
+__export(getParentPackageJSON_exports, {
+  getParentPackageJSON: () => getParentPackageJSON
+});
+module.exports = __toCommonJS(getParentPackageJSON_exports);
+var import_fs = require("fs");
+var import_path = require("path");
+const getParentPackageJSON = (startDir) => {
+  let currentDir = startDir;
+  while (currentDir !== (0, import_path.dirname)(currentDir)) {
+    const packageJsonPath = (0, import_path.resolve)(currentDir, "package.json");
+    if ((0, import_fs.existsSync)(packageJsonPath)) {
+      return JSON.parse((0, import_fs.readFileSync)(packageJsonPath, "utf8"));
+    }
+    currentDir = (0, import_path.dirname)(currentDir);
+  }
+  const rootPackageJsonPath = (0, import_path.resolve)(currentDir, "package.json");
+  if ((0, import_fs.existsSync)(rootPackageJsonPath)) {
+    return JSON.parse((0, import_fs.readFileSync)(rootPackageJsonPath, "utf8"));
+  }
+  throw new Error(
+    `No package.json found in any parent directory of ${startDir}`
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getParentPackageJSON
+});
+//# sourceMappingURL=getParentPackageJSON.cjs.map

package/dist/cjs/utils/getParentPackageJSON.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/getParentPackageJSON.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'fs';\nimport { dirname, resolve } from 'path';\n\ntype PackageJSON = {\n  name?: string;\n  version?: string;\n  private: boolean;\n  description?: string;\n  homepage?: string;\n  bugs: {\n    url?: string;\n  };\n  repository: {\n    type?: string;\n    url?: string;\n  };\n  license?: string;\n  author: {\n    name?: string;\n    url?: string;\n  };\n  contributors?: {\n    name?: string;\n    email?: string;\n    url?: string;\n  }[];\n  type?: string;\n  scripts: Record<string, string>;\n  devDependencies: Record<string, string>;\n  packageManager?: string;\n  engines: Record<string, string>;\n};\n\nexport const getParentPackageJSON = (startDir: string): PackageJSON => {\n  let currentDir = startDir;\n\n  while (currentDir !== dirname(currentDir)) {\n    // Stop when we reach the root\n    const packageJsonPath = resolve(currentDir, 'package.json');\n\n    if (existsSync(packageJsonPath)) {\n      return JSON.parse(readFileSync(packageJsonPath, 'utf8'));\n    }\n\n    // Move up one directory level\n    currentDir = dirname(currentDir);\n  }\n\n  // Check the root directory as well\n  const rootPackageJsonPath = resolve(currentDir, 'package.json');\n  if (existsSync(rootPackageJsonPath)) {\n    return JSON.parse(readFileSync(rootPackageJsonPath, 'utf8'));\n  }\n\n  // If no package.json is found in any parent directory\n  throw new Error(\n    `No package.json found in any parent directory of ${startDir}`\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAAyC;AACzC,kBAAiC;AAgC1B,MAAM,uBAAuB,CAAC,aAAkC;AACrE,MAAI,aAAa;AAEjB,SAAO,mBAAe,qBAAQ,UAAU,GAAG;AAEzC,UAAM,sBAAkB,qBAAQ,YAAY,cAAc;AAE1D,YAAI,sBAAW,eAAe,GAAG;AAC/B,aAAO,KAAK,UAAM,wBAAa,iBAAiB,MAAM,CAAC;AAAA,IACzD;AAGA,qBAAa,qBAAQ,UAAU;AAAA,EACjC;AAGA,QAAM,0BAAsB,qBAAQ,YAAY,cAAc;AAC9D,UAAI,sBAAW,mBAAmB,GAAG;AACnC,WAAO,KAAK,UAAM,wBAAa,qBAAqB,MAAM,CAAC;AAAA,EAC7D;AAGA,QAAM,IAAI;AAAA,IACR,oDAAoD,QAAQ;AAAA,EAC9D;AACF;","names":[]}

package/dist/cjs/utils/listSpecialChars.cjs

@@ -0,0 +1,78 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var listSpecialChars_exports = {};
+__export(listSpecialChars_exports, {
+  listSpecialChars: () => listSpecialChars
+});
+module.exports = __toCommonJS(listSpecialChars_exports);
+const SPECIAL_CHARS = [
+  "  ",
+  "\\",
+  "|",
+  "(",
+  ")",
+  "{",
+  "}",
+  "[",
+  "]",
+  "<",
+  ">",
+  '"',
+  "=",
+  "+",
+  "*",
+  "&",
+  "#",
+  "%",
+  "$",
+  "!",
+  "?",
+  ":",
+  ";",
+  "~"
+];
+const listSpecialChars = (text) => {
+  const results = [];
+  let lineIndex = 0;
+  for (let i = 0; i < text.length; i++) {
+    const currentChar = text[i];
+    if (currentChar === "\n") {
+      results.push({
+        char: "\\",
+        lineStart: lineIndex,
+        charStart: i
+      });
+      lineIndex++;
+      continue;
+    }
+    if (SPECIAL_CHARS.includes(currentChar)) {
+      results.push({
+        char: currentChar,
+        lineStart: lineIndex,
+        charStart: i
+      });
+    }
+  }
+  return results;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  listSpecialChars
+});
+//# sourceMappingURL=listSpecialChars.cjs.map

package/dist/cjs/utils/listSpecialChars.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/listSpecialChars.ts"],"sourcesContent":["type ListCharResult = {\n  char: string;\n  /** First line index contained in this chunk (0-based)             */\n  lineStart: number;\n  /** Start character index in the original text (0-based, inclusive)*/\n  charStart: number;\n}[];\n\nconst SPECIAL_CHARS = [\n  '  ',\n  '\\\\',\n  '|',\n  '(',\n  ')',\n  '{',\n  '}',\n  '[',\n  ']',\n  '<',\n  '>',\n  '\"',\n  '=',\n  '+',\n  '*',\n  '&',\n  '#',\n  '%',\n  '$',\n  '!',\n  '?',\n  ':',\n  ';',\n  '~',\n];\n\nexport const listSpecialChars = (text: string): ListCharResult => {\n  const results: ListCharResult = [];\n\n  let lineIndex = 0;\n\n  for (let i = 0; i < text.length; i++) {\n    const currentChar = text[i];\n\n    // Handle newline characters (\"\\n\"): treat them as a \"\\\\\" special char\n    if (currentChar === '\\n') {\n      results.push({\n        char: '\\\\',\n        lineStart: lineIndex,\n        charStart: i,\n      });\n\n      // Move to the next line after recording the special char\n      lineIndex++;\n      continue;\n    }\n\n    // Check if the current character is one of the special characters\n    if (SPECIAL_CHARS.includes(currentChar)) {\n      results.push({\n        char: currentChar,\n        lineStart: lineIndex,\n        charStart: i,\n      });\n    }\n  }\n\n  return results;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,MAAM,gBAAgB;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,mBAAmB,CAAC,SAAiC;AAChE,QAAM,UAA0B,CAAC;AAEjC,MAAI,YAAY;AAEhB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,cAAc,KAAK,CAAC;AAG1B,QAAI,gBAAgB,MAAM;AACxB,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb,CAAC;AAGD;AACA;AAAA,IACF;AAGA,QAAI,cAAc,SAAS,WAAW,GAAG;AACvC,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/cjs/utils/listSpecialChars.test.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_listSpecialChars = require('./listSpecialChars.cjs');
+const test = [
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit. (Quisque faucibus ex sapien vitae pellentesque sem placerat). In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.",
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit! Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.",
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit. Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.",
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit.. Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.",
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit. Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos."
+].join("\n");
+(0, import_vitest.describe)("listSpecialChars", () => {
+  (0, import_vitest.it)("should return an empty array if the text is empty", () => {
+    const text = "";
+    const result = (0, import_listSpecialChars.listSpecialChars)(text);
+    (0, import_vitest.expect)(result).toEqual([]);
+  });
+  (0, import_vitest.it)("should return an array of special characters", () => {
+    const result = (0, import_listSpecialChars.listSpecialChars)(test);
+    (0, import_vitest.expect)(result).toEqual([
+      {
+        char: "(",
+        charStart: 56,
+        lineStart: 0
+      },
+      {
+        char: ")",
+        charStart: 115,
+        lineStart: 0
+      },
+      {
+        char: "\\",
+        charStart: 439,
+        lineStart: 0
+      },
+      {
+        char: "!",
+        charStart: 494,
+        lineStart: 1
+      },
+      {
+        char: "\\",
+        charStart: 877,
+        lineStart: 1
+      },
+      {
+        char: "\\",
+        charStart: 1315,
+        lineStart: 2
+      },
+      {
+        char: "\\",
+        charStart: 1754,
+        lineStart: 3
+      }
+    ]);
+  });
+});
+//# sourceMappingURL=listSpecialChars.test.cjs.map

package/dist/cjs/utils/listSpecialChars.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/listSpecialChars.test.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { listSpecialChars } from './listSpecialChars';\n\nconst test = [\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit. (Quisque faucibus ex sapien vitae pellentesque sem placerat). In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.',\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit! Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.',\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit. Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.',\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit.. Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.',\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit. Quisque faucibus ex sapien vitae pellentesque sem placerat. In id cursus mi pretium tellus duis convallis. Tempus leo eu aenean sed diam urna tempor. Pulvinar vivamus fringilla lacus nec metus bibendum egestas. Iaculis massa nisl malesuada lacinia integer nunc posuere. Ut hendrerit semper vel class aptent taciti sociosqu. Ad litora torquent per conubia nostra inceptos himenaeos.',\n].join('\\n');\n\ndescribe('listSpecialChars', () => {\n  it('should return an empty array if the text is empty', () => {\n    const text = '';\n    const result = listSpecialChars(text);\n    expect(result).toEqual([]);\n  });\n\n  it('should return an array of special characters', () => {\n    const result = listSpecialChars(test);\n    expect(result).toEqual([\n      {\n        char: '(',\n        charStart: 56,\n        lineStart: 0,\n      },\n      {\n        char: ')',\n        charStart: 115,\n        lineStart: 0,\n      },\n      {\n        char: '\\\\',\n        charStart: 439,\n        lineStart: 0,\n      },\n      {\n        char: '!',\n        charStart: 494,\n        lineStart: 1,\n      },\n      {\n        char: '\\\\',\n        charStart: 877,\n        lineStart: 1,\n      },\n      {\n        char: '\\\\',\n        charStart: 1315,\n        lineStart: 2,\n      },\n      {\n        char: '\\\\',\n        charStart: 1754,\n        lineStart: 3,\n      },\n    ]);\n  });\n});\n"],"mappings":";AAAA,oBAAqC;AACrC,8BAAiC;AAEjC,MAAM,OAAO;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAAA,IAEX,wBAAS,oBAAoB,MAAM;AACjC,wBAAG,qDAAqD,MAAM;AAC5D,UAAM,OAAO;AACb,UAAM,aAAS,0CAAiB,IAAI;AACpC,8BAAO,MAAM,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC3B,CAAC;AAED,wBAAG,gDAAgD,MAAM;AACvD,UAAM,aAAS,0CAAiB,IAAI;AACpC,8BAAO,MAAM,EAAE,QAAQ;AAAA,MACrB;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH,CAAC;","names":[]}

package/dist/cjs/utils/reorderParagraphs.cjs

@@ -0,0 +1,125 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var reorderParagraphs_exports = {};
+__export(reorderParagraphs_exports, {
+  reorderParagraphs: () => reorderParagraphs
+});
+module.exports = __toCommonJS(reorderParagraphs_exports);
+var import_listSpecialChars = require('./listSpecialChars.cjs');
+const splitByParagraph = (text) => {
+  const paragraphs = [];
+  const tokens = text.split(/(\n{2,})/);
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    if (i % 2 === 0) {
+      if (token) paragraphs.push(token);
+      continue;
+    }
+    const pairsOfNewlines = Math.floor(token.length / 2);
+    const blankParagraphs = Math.max(0, pairsOfNewlines - 2);
+    for (let j = 0; j < blankParagraphs; j++) {
+      paragraphs.push("\n\n");
+    }
+  }
+  return paragraphs;
+};
+const paragraphMatches = (paragraph, baseParagraph, paragraphSignature, baseSignature) => {
+  if (paragraph === baseParagraph) return true;
+  if (paragraphSignature.length !== baseSignature.length) return false;
+  for (let i = 0; i < paragraphSignature.length; i++) {
+    if (paragraphSignature[i].char !== baseSignature[i].char) {
+      return false;
+    }
+  }
+  return true;
+};
+const reorderParagraphs = (textToReorder, baseFileContent) => {
+  const baseFileParagraphs = splitByParagraph(baseFileContent);
+  const textToReorderParagraphs = splitByParagraph(textToReorder);
+  const baseSignatures = baseFileParagraphs.map((p) => (0, import_listSpecialChars.listSpecialChars)(p));
+  const textSignatures = textToReorderParagraphs.map(
+    (p) => (0, import_listSpecialChars.listSpecialChars)(p)
+  );
+  const firstMatchIndexForBase = Array(
+    baseFileParagraphs.length
+  ).fill(-1);
+  const paragraphMatchedBaseIdx = Array(
+    textToReorderParagraphs.length
+  ).fill(null);
+  for (let i = 0; i < textToReorderParagraphs.length; i++) {
+    const paragraph = textToReorderParagraphs[i];
+    const sig = textSignatures[i];
+    let foundIdx = baseFileParagraphs.findIndex(
+      (baseParagraph, idx) => firstMatchIndexForBase[idx] === -1 && paragraph === baseParagraph
+    );
+    if (foundIdx === -1) {
+      foundIdx = baseFileParagraphs.findIndex(
+        (baseParagraph, idx) => firstMatchIndexForBase[idx] === -1 && paragraphMatches(paragraph, baseParagraph, sig, baseSignatures[idx])
+      );
+    }
+    if (foundIdx !== -1) {
+      firstMatchIndexForBase[foundIdx] = i;
+      paragraphMatchedBaseIdx[i] = foundIdx;
+    }
+  }
+  const insertAfterBaseIdx = Array(
+    textToReorderParagraphs.length
+  ).fill(-1);
+  let maxBaseIdxEncountered = -1;
+  for (let i = 0; i < textToReorderParagraphs.length; i++) {
+    const matchedBase = paragraphMatchedBaseIdx[i];
+    if (matchedBase !== null) {
+      if (matchedBase > maxBaseIdxEncountered) {
+        maxBaseIdxEncountered = matchedBase;
+      }
+    } else {
+      insertAfterBaseIdx[i] = maxBaseIdxEncountered;
+    }
+  }
+  const result = [];
+  const extraParagraphsBuckets = {};
+  insertAfterBaseIdx.forEach((afterIdx, paragraphIdx) => {
+    if (afterIdx === -1) return;
+    extraParagraphsBuckets[afterIdx] = extraParagraphsBuckets[afterIdx] || [];
+    extraParagraphsBuckets[afterIdx].push(paragraphIdx);
+  });
+  for (let bIdx = 0; bIdx < baseFileParagraphs.length; bIdx++) {
+    const matchedParagraphIdx = firstMatchIndexForBase[bIdx];
+    if (matchedParagraphIdx !== -1) {
+      result.push(textToReorderParagraphs[matchedParagraphIdx]);
+    }
+    if (extraParagraphsBuckets[bIdx]) {
+      extraParagraphsBuckets[bIdx].forEach((pIdx) => {
+        result.push(textToReorderParagraphs[pIdx]);
+      });
+    }
+  }
+  const leadingExtras = [];
+  insertAfterBaseIdx.forEach((afterIdx, pIdx) => {
+    if (afterIdx === -1 && paragraphMatchedBaseIdx[pIdx] === null) {
+      leadingExtras.push(textToReorderParagraphs[pIdx]);
+    }
+  });
+  return [...leadingExtras, ...result].join("\n\n");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  reorderParagraphs
+});
+//# sourceMappingURL=reorderParagraphs.cjs.map

package/dist/cjs/utils/reorderParagraphs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/reorderParagraphs.ts"],"sourcesContent":["import { listSpecialChars } from './listSpecialChars';\n\n/**\n * Split a text into paragraphs.\n *\n * We consider a paragraph boundary to be a block of at least two consecutive\n * new-lines that is immediately followed by a non-white-space character.  This\n * way, internal blank lines that are part of the same paragraph (e.g. a list\n * item that purposely contains a visual break) are preserved while true\n * paragraph breaks – the ones generated when calling `arr.join(\"\\n\\n\")` in\n * the tests – are still detected.\n */\nconst splitByParagraph = (text: string): string[] => {\n  const paragraphs: string[] = [];\n\n  // Capture the delimiter so that we can inspect how many new-lines it\n  // contains.  We know that the test strings only use LF, so we keep the\n  // regex simple here.\n  const tokens = text.split(/(\\n{2,})/);\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i];\n\n    // Even-indexed tokens are the actual paragraph contents.\n    if (i % 2 === 0) {\n      if (token) paragraphs.push(token);\n      continue;\n    }\n\n    // Odd-indexed tokens are the delimiters (>= two consecutive new-lines).\n    // The first and last pairs represent the natural separators that are\n    // added when paragraphs are later joined with \"\\n\\n\".  Any additional\n    // pairs in between correspond to *explicit* blank paragraphs that were\n    // present in the original text and must therefore be preserved.\n    const pairsOfNewlines = Math.floor(token.length / 2);\n    const blankParagraphs = Math.max(0, pairsOfNewlines - 2);\n\n    for (let j = 0; j < blankParagraphs; j++) {\n      paragraphs.push('\\n\\n');\n    }\n  }\n\n  return paragraphs;\n};\n\n/**\n * Determine whether two paragraphs match – either exactly, or by sharing the\n * same \"special-character signature\".\n */\nconst paragraphMatches = (\n  paragraph: string,\n  baseParagraph: string,\n  paragraphSignature: ReturnType<typeof listSpecialChars>,\n  baseSignature: ReturnType<typeof listSpecialChars>\n): boolean => {\n  if (paragraph === baseParagraph) return true;\n  // fallback to special-character signature comparison\n  if (paragraphSignature.length !== baseSignature.length) return false;\n\n  for (let i = 0; i < paragraphSignature.length; i++) {\n    if (paragraphSignature[i].char !== baseSignature[i].char) {\n      return false;\n    }\n  }\n  return true;\n};\n\n/**\n * Re-order `textToReorder` so that its paragraphs follow the ordering found in\n * `baseFileContent`, while preserving any extra paragraphs (those not present\n * in the base file) in a position that is intuitive for a human reader: right\n * after the closest preceding paragraph coming from the base file.\n */\nexport const reorderParagraphs = (\n  textToReorder: string,\n  baseFileContent: string\n): string => {\n  // 1. Split both texts into paragraphs and pre-compute their signatures.\n  const baseFileParagraphs = splitByParagraph(baseFileContent);\n  const textToReorderParagraphs = splitByParagraph(textToReorder);\n\n  const baseSignatures = baseFileParagraphs.map((p) => listSpecialChars(p));\n  const textSignatures = textToReorderParagraphs.map((p) =>\n    listSpecialChars(p)\n  );\n\n  // 2. For every paragraph in the text to reorder, find the *first* base\n  //    paragraph it matches.  We only allow each base paragraph to be matched\n  //    once.  Any further identical paragraphs will be treated as \"extra\" and\n  //    will be positioned later on, next to their closest neighbour.\n  const firstMatchIndexForBase: number[] = Array(\n    baseFileParagraphs.length\n  ).fill(-1);\n  const paragraphMatchedBaseIdx: (number | null)[] = Array(\n    textToReorderParagraphs.length\n  ).fill(null);\n\n  for (let i = 0; i < textToReorderParagraphs.length; i++) {\n    const paragraph = textToReorderParagraphs[i];\n    const sig = textSignatures[i];\n\n    // exact match pass first for performance\n    let foundIdx = baseFileParagraphs.findIndex(\n      (baseParagraph, idx) =>\n        firstMatchIndexForBase[idx] === -1 && paragraph === baseParagraph\n    );\n\n    if (foundIdx === -1) {\n      // fallback to the signature comparison\n      foundIdx = baseFileParagraphs.findIndex(\n        (baseParagraph, idx) =>\n          firstMatchIndexForBase[idx] === -1 &&\n          paragraphMatches(paragraph, baseParagraph, sig, baseSignatures[idx])\n      );\n    }\n\n    if (foundIdx !== -1) {\n      firstMatchIndexForBase[foundIdx] = i;\n      paragraphMatchedBaseIdx[i] = foundIdx;\n    }\n  }\n\n  // 3. For the paragraphs that *didn't* get matched to a base paragraph, we\n  //    record the highest-numbered base paragraph that was matched *before* it\n  //    in the original text.  The extra paragraph will later be placed right\n  //    after that paragraph in the final ordering.\n  const insertAfterBaseIdx: number[] = Array(\n    textToReorderParagraphs.length\n  ).fill(-1);\n  let maxBaseIdxEncountered = -1;\n\n  for (let i = 0; i < textToReorderParagraphs.length; i++) {\n    const matchedBase = paragraphMatchedBaseIdx[i];\n\n    if (matchedBase !== null) {\n      if (matchedBase > maxBaseIdxEncountered) {\n        maxBaseIdxEncountered = matchedBase;\n      }\n    } else {\n      insertAfterBaseIdx[i] = maxBaseIdxEncountered;\n    }\n  }\n\n  // 4. Build the final, reordered list of paragraphs.\n  const result: string[] = [];\n\n  // Helper: quickly retrieve all indices of paragraphs that should be inserted\n  // after a given base index, while keeping their original order.\n  const extraParagraphsBuckets: Record<number, number[]> = {};\n  insertAfterBaseIdx.forEach((afterIdx, paragraphIdx) => {\n    if (afterIdx === -1) return; // will be handled later (if any)\n    extraParagraphsBuckets[afterIdx] = extraParagraphsBuckets[afterIdx] || [];\n    extraParagraphsBuckets[afterIdx].push(paragraphIdx);\n  });\n\n  for (let bIdx = 0; bIdx < baseFileParagraphs.length; bIdx++) {\n    const matchedParagraphIdx = firstMatchIndexForBase[bIdx];\n\n    if (matchedParagraphIdx !== -1) {\n      result.push(textToReorderParagraphs[matchedParagraphIdx]);\n    }\n\n    if (extraParagraphsBuckets[bIdx]) {\n      extraParagraphsBuckets[bIdx].forEach((pIdx) => {\n        result.push(textToReorderParagraphs[pIdx]);\n      });\n    }\n  }\n\n  // Finally, if there were extra paragraphs appearing *before* any matched\n  // base paragraph (insertAfterBaseIdx === -1), we prepend them to the output\n  // in their original order.\n  const leadingExtras: string[] = [];\n  insertAfterBaseIdx.forEach((afterIdx, pIdx) => {\n    if (afterIdx === -1 && paragraphMatchedBaseIdx[pIdx] === null) {\n      leadingExtras.push(textToReorderParagraphs[pIdx]);\n    }\n  });\n\n  return [...leadingExtras, ...result].join('\\n\\n');\n};\n"],"mappings":"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","names":[]}

package/dist/cjs/utils/reorderParagraphs.test.cjs

@@ -0,0 +1,71 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_reorderParagraphs = require('./reorderParagraphs.cjs');
+const baseText = [
+  "! Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // '> Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Additional content
+  "+ Lorem dolor sit amet consectetur adipiscing elit.",
+  // Similar n1
+  "- Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "\n\n",
+  // Empty line
+  "* Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // No special char
+  "+ Lorem dolor sit amet consectetur adipiscing elit.",
+  // Similar n2
+  "+ Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // Similar n3 but different content
+  "= Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // Missing content
+  "& Lorem ipsum dolor sit amet consectetur adipiscing elit."
+].join("\n\n");
+const textToReorder = [
+  "! Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // '> Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Additional content
+  "+ Lorem dolor sit amet consectetur adipiscing elit.",
+  // Similar n1
+  "\n\n",
+  // Empty line
+  "* Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "- Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "+ Lorem dolor sit amet consectetur adipiscing elit.",
+  // Similar n2
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // No special char
+  "+ Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // Similar n3 but different content
+  "& Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "= Lorem ipsum dolor sit amet consectetur adipiscing elit."
+  // Missing content
+].join("\n\n");
+const texReordered = [
+  "! Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // '> Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Additional content
+  "+ Lorem dolor sit amet consectetur adipiscing elit.",
+  // Similar n1
+  "- Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "\n\n",
+  // Empty line
+  "* Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  "Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // No special char
+  "+ Lorem dolor sit amet consectetur adipiscing elit.",
+  // Similar n2
+  "+ Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // Similar n3 but different content
+  "= Lorem ipsum dolor sit amet consectetur adipiscing elit.",
+  // Missing content
+  "& Lorem ipsum dolor sit amet consectetur adipiscing elit."
+].join("\n\n");
+(0, import_vitest.describe)("reorderParagraphs", () => {
+  (0, import_vitest.it)("should keep the same order when input matches base text", () => {
+    const result = (0, import_reorderParagraphs.reorderParagraphs)(baseText, baseText);
+    (0, import_vitest.expect)(result).toEqual(baseText);
+  });
+  (0, import_vitest.it)("should reorder the paragraphs", () => {
+    const result = (0, import_reorderParagraphs.reorderParagraphs)(textToReorder, baseText);
+    (0, import_vitest.expect)(result).toEqual(texReordered);
+  });
+});
+//# sourceMappingURL=reorderParagraphs.test.cjs.map

package/dist/cjs/utils/reorderParagraphs.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/reorderParagraphs.test.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { reorderParagraphs } from './reorderParagraphs';\n\nconst baseText = [\n  '! Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  // '> Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Additional content\n  '+ Lorem dolor sit amet consectetur adipiscing elit.', // Similar n1\n  '- Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  '\\n\\n', // Empty line\n  '* Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit.', // No special char\n  '+ Lorem dolor sit amet consectetur adipiscing elit.', // Similar n2\n  '+ Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Similar n3 but different content\n  '= Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Missing content\n  '& Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n].join('\\n\\n');\n\nconst textToReorder = [\n  '! Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  // '> Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Additional content\n  '+ Lorem dolor sit amet consectetur adipiscing elit.', // Similar n1\n  '\\n\\n', // Empty line\n  '* Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  '- Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  '+ Lorem dolor sit amet consectetur adipiscing elit.', // Similar n2\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit.', // No special char\n  '+ Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Similar n3 but different content\n  '& Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  '= Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Missing content\n].join('\\n\\n');\n\nconst texReordered = [\n  '! Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  // '> Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Additional content\n  '+ Lorem dolor sit amet consectetur adipiscing elit.', // Similar n1\n  '- Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  '\\n\\n', // Empty line\n  '* Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n  'Lorem ipsum dolor sit amet consectetur adipiscing elit.', // No special char\n  '+ Lorem dolor sit amet consectetur adipiscing elit.', // Similar n2\n  '+ Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Similar n3 but different content\n  '= Lorem ipsum dolor sit amet consectetur adipiscing elit.', // Missing content\n  '& Lorem ipsum dolor sit amet consectetur adipiscing elit.',\n].join('\\n\\n');\n\ndescribe('reorderParagraphs', () => {\n  it('should keep the same order when input matches base text', () => {\n    const result = reorderParagraphs(baseText, baseText);\n    expect(result).toEqual(baseText);\n  });\n\n  it('should reorder the paragraphs', () => {\n    const result = reorderParagraphs(textToReorder, baseText);\n    expect(result).toEqual(texReordered);\n  });\n});\n"],"mappings":";AAAA,oBAAqC;AACrC,+BAAkC;AAElC,MAAM,WAAW;AAAA,EACf;AAAA;AAAA,EAEA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAEb,MAAM,gBAAgB;AAAA,EACpB;AAAA;AAAA,EAEA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AACF,EAAE,KAAK,MAAM;AAEb,MAAM,eAAe;AAAA,EACnB;AAAA;AAAA,EAEA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AACF,EAAE,KAAK,MAAM;AAAA,IAEb,wBAAS,qBAAqB,MAAM;AAClC,wBAAG,2DAA2D,MAAM;AAClE,UAAM,aAAS,4CAAkB,UAAU,QAAQ;AACnD,8BAAO,MAAM,EAAE,QAAQ,QAAQ;AAAA,EACjC,CAAC;AAED,wBAAG,iCAAiC,MAAM;AACxC,UAAM,aAAS,4CAAkB,eAAe,QAAQ;AACxD,8BAAO,MAAM,EAAE,QAAQ,YAAY;AAAA,EACrC,CAAC;AACH,CAAC;","names":[]}