@mxpicture/build-api 0.2.56 → 0.2.58

package/dist/pkg/UpdatePackages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpdatePackages.d.ts","sourceRoot":"","sources":["../../src/pkg/UpdatePackages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAM9E,eAAO,MAAM,iBAAiB,GAAU,QAAQ,oBAAoB,kBAGnE,CAAC;AAEF,qBAAa,cAAc;IAGN,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAFrD,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEK,OAAO,EAAE,MAAM;IAIxC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;cAwBjB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAetC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAWnD,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;IAIxE,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;cAOpD,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC;cAQJ,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;cAMpD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAK5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;cA0C9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAgDhD"}
+{"version":3,"file":"UpdatePackages.d.ts","sourceRoot":"","sources":["../../src/pkg/UpdatePackages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAM9E;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAU,QAAQ,oBAAoB,kBAGnE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IAQN,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAPrD,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;gBACmC,OAAO,EAAE,MAAM;IAIrD;;;;;;;;;OASG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;cAwBjB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAetC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAWnD,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;IAIxE,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;cAOpD,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC;cAQJ,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;cAMpD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAK5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;cA0C9B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAgDhD"}

package/dist/pkg/UpdatePackages.js

@@ -2,17 +2,53 @@ import { logInfo, logSuccess } from "../logger/Logger.js";
 import { execAsync } from "../common/common.fs.js";
 import micromatch from "micromatch";
 import { initWorkspace, workspace } from "../workspace/Workspace.js";
+/**
+ * Initializes the workspace and runs the package-update workflow.
+ *
+ * @remarks
+ * This is a convenience entry point that constructs an {@link UpdatePackages} instance
+ * and immediately invokes its {@link UpdatePackages.run} method.
+ *
+ * @param params - Configuration for the update, including the repo root and a glob pattern to select packages.
+ * @returns A promise that resolves when all matching packages have been updated and verified.
+ */
 export const runUpdatePackages = async (params) => {
     initWorkspace(params.repoRoot);
     return new UpdatePackages(params.pattern).run();
 };
+/**
+ * Bulk-updates dependencies matching a glob pattern across all workspace packages.
+ *
+ * @remarks
+ * The update pipeline performs five sequential steps:
+ * 1. Discover matching dependencies across every workspace package.
+ * 2. Run `pnpm update -r --latest` for the matched packages.
+ * 3. Deduplicate the dependency tree with `pnpm dedupe`.
+ * 4. Remove stale duplicate versions from `node_modules/.pnpm`.
+ * 5. Verify that all workspaces converge on the same version for each package.
+ */
 export class UpdatePackages {
     pattern;
     patternWoSlash;
+    /**
+     * Creates a new UpdatePackages instance.
+     *
+     * @param pattern - A glob pattern used to match dependency names (e.g. `"@angular/*"`).
+     */
     constructor(pattern) {
         this.pattern = pattern;
         this.patternWoSlash = pattern.replaceAll("/", "+");
     }
+    /**
+     * Executes the full package-update pipeline.
+     *
+     * @remarks
+     * Discovers matching packages, updates them, deduplicates, cleans old versions,
+     * and verifies consistency. Exits the process with code 1 if version
+     * inconsistencies are detected after the update.
+     *
+     * @returns A promise that resolves when the pipeline completes successfully.
+     */
     async run() {
         logInfo(`🚀 Starting ${this.pattern} packages update process...\n`);
         // Step 1: Find all packages

package/dist/pkg/UpdatePackages.js.map

@@ -1 +1 @@
-{"version":3,"file":"UpdatePackages.js","sourceRoot":"","sources":["../../src/pkg/UpdatePackages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,MAA4B,EAAE,EAAE;IACtE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,OAAO,cAAc;IAGa;IAF5B,cAAc,CAAS;IAEjC,YAAsC,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;QACnD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,GAAG;QACd,OAAO,CAAC,eAAe,IAAI,CAAC,OAAO,+BAA+B,CAAC,CAAC;QAEpE,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,QAAQ;YAAE,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QAEnD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YACrB,OAAO,UAAU,CAAC,QAAQ,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;QAE5D,wDAAwD;QACxD,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEpC,mCAAmC;QACnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,gDAAgD;QAChD,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,sDAAsD;QACtD,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IAC9B,CAAC;IAES,KAAK,CAAC,IAAI,CAAC,OAAe;QAClC,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,CACL,MAAM,SAAS,CAAC,OAAO,EAAE;gBACvB,GAAG,EAAE,SAAS,EAAE,CAAC,QAAQ;gBACzB,QAAQ,EAAE,OAAO;aAClB,CAAC,CACH,CAAC,MAAM,CAAC;QACX,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAES,KAAK,CAAC,WAAW;QACzB,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAa,CAC7B,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACnE,CAAC,IAAI,EAAE,CAAC;QAET,OAAO,IAAI,GAAG,CAAS,YAAY,CAAC,CAAC;IACvC,CAAC;IAES,cAAc,CAAC,UAAyB;QAChD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1E,CAAC;IAES,aAAa,CAAC,SAAsB;QAC5C,OAAO;YACL,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,YAAY,CAAC;YAC7C,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,eAAe,CAAC;SACjD,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,gBAAgB,CAC9B,IAAwC;QAExC,OAAO,OAAO,CAAC,OAAO,CACpB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACzC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAC1C,CACF,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,cAAc,CAAC,QAAqB;QAClD,OAAO,CAAC,iDAAiD,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,IAAI,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAC;IAC5D,CAAC;IAES,KAAK,CAAC,WAAW;QACzB,OAAO,CAAC,oCAAoC,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAES,KAAK,CAAC,aAAa;QAC3B,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CACjC,0CAA0C,IAAI,CAAC,cAAc,gCAAgC,CAC9F,CAAC;QACF,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnE,+CAA+C;QAC/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;QACpD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;YACnC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC;gBAAE,SAAS;YAChE,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5D,eAAe,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B;QACpF,CAAC;QAED,uBAAuB;QACvB,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC;YAC9C,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9C,IAAI,cAAc,CAAC,MAAM,IAAI,CAAC;gBAAE,SAAS;YACzC,OAAO,CACL,mCAAmC,GAAG,GAAG,EACzC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1B,CAAC;YACF,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,mDAAmD,CAAC,CAAC;YAC7D,OAAO,CAAC,qDAAqD,CAAC,CAAC;YAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YACpD,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAES,KAAK,CAAC,cAAc;QAC5B,UAAU,CAAC,mCAAmC,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAChC,aAAa,IAAI,CAAC,OAAO,sBAAsB,CAChD,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;QAE1D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;wBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBACzD,8DAA8D;oBAC9D,UAAU,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAG,IAAY,CAAC,OAAO,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC;YACzC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAClD,IAAI,cAAc,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,OAAO,CAAC,+BAA+B,GAAG,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,QAAQ;gBACzC,OAAO,CAAC,QAAQ,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;YAE3C,aAAa,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CACX,uEAAuE,CACxE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,iCAAiC,CAAC,CAAC;QACnE,OAAO,CACL,+EAA+E,CAChF,CAAC;QACF,OAAO,CAAC,oDAAoD,CAAC,CAAC;IAChE,CAAC;CACF","sourcesContent":["import { PackageJson, UpdatePackagesParams } from \"../types/types.package.js\";\nimport { logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { execAsync } from \"../common/common.fs.js\";\nimport micromatch from \"micromatch\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\n\nexport const runUpdatePackages = async (params: UpdatePackagesParams) => {\n  initWorkspace(params.repoRoot);\n  return new UpdatePackages(params.pattern).run();\n};\n\nexport class UpdatePackages {\n  protected patternWoSlash: string;\n\n  public constructor(protected readonly pattern: string) {\n    this.patternWoSlash = pattern.replaceAll(\"/\", \"+\");\n  }\n\n  public async run(): Promise<void> {\n    logInfo(`🚀 Starting ${this.pattern} packages update process...\\n`);\n\n    // Step 1: Find all packages\n    const packages = await this.getPackages();\n    logInfo(`📦 Found ${this.pattern} packages:`);\n    for (const pkg of packages) logInfo(`   - ${pkg}`);\n\n    if (packages.size === 0)\n      return logSuccess(`✅ No ${this.pattern} packages found.`);\n\n    // Step 2: Update packages in all workspaces recursively\n    await this.updatePackages(packages);\n\n    // Step 3: Deduplicate dependencies\n    await this.deduplicate();\n\n    // Step 4: Remove old versions from node_modules\n    await this.rmOldVersions();\n\n    // Step 5: Verify all packages are at the same version\n    await this.verifyPackages();\n  }\n\n  protected async exec(command: string): Promise<string> {\n    console.log(`\\n▶ ${command}`);\n    try {\n      return (\n        await execAsync(command, {\n          cwd: workspace().repoRoot,\n          encoding: \"utf-8\",\n        })\n      ).stdout;\n    } catch (error) {\n      console.error(`Error executing: ${command}`);\n      throw error;\n    }\n  }\n\n  protected async getPackages(): Promise<Set<string>> {\n    const ws = workspace();\n    await ws.read();\n    const pkgs = [...ws.packages, ws.rootPackage];\n    const packageNames: string[] = (\n      await Promise.all(this.filterPackages(pkgs.map((p) => p.content)))\n    ).flat();\n\n    return new Set<string>(packageNames);\n  }\n\n  protected filterPackages(wsPackages: PackageJson[]): Promise<string[]>[] {\n    return wsPackages.flatMap((wsPackage) => this.filterPackage(wsPackage));\n  }\n\n  protected filterPackage(wsPackage: PackageJson): Promise<string[]>[] {\n    return [\n      this.filterPackageDep(wsPackage.dependencies),\n      this.filterPackageDep(wsPackage.devDependencies),\n    ];\n  }\n\n  protected async filterPackageDep(\n    deps: Record<string, string> | undefined,\n  ): Promise<string[]> {\n    return Promise.resolve(\n      Object.keys(deps ?? []).filter((depName) =>\n        micromatch.isMatch(depName, this.pattern),\n      ),\n    );\n  }\n\n  protected async updatePackages(packages: Set<string>): Promise<void> {\n    logInfo(\"\\n📥 Updating packages across all workspaces...\");\n    const packageList = Array.from(packages).join(\" \");\n    await this.exec(`pnpm update -r --latest ${packageList}`);\n  }\n\n  protected async deduplicate(): Promise<void> {\n    logInfo(\"\\n🔧 Deduplicating dependencies...\");\n    await this.exec(\"pnpm dedupe\");\n  }\n\n  protected async rmOldVersions(): Promise<void> {\n    logInfo(\"\\n🧹 Checking for old versions...\");\n    const oldVersions = await this.exec(\n      `find node_modules/.pnpm -type d -name \"${this.patternWoSlash}\" -depth 1 2>/dev/null || true`,\n    );\n    const versionDirs = oldVersions.trim().split(\"\\n\").filter(Boolean);\n\n    // Group by package name to identify duplicates\n    const packageVersions = new Map<string, string[]>();\n    for (const dir of versionDirs) {\n      const match = dir.match(/\\/(@?[a-z-+]+)@(.+)$/);\n      if (!match) continue;\n      const [, pkgName, version] = match;\n      if (!micromatch.isMatch(pkgName, this.patternWoSlash)) continue;\n      const key = pkgName.replace(/\\+/g, \"/\");\n      if (!packageVersions.has(key)) packageVersions.set(key, []);\n      packageVersions.get(key)!.push(version.split(\"_\")[0]); // Remove peer dep suffixes\n    }\n\n    // Check for duplicates\n    let hasDuplicates = false;\n    for (const [pkg, versions] of packageVersions) {\n      const uniqueVersions = [...new Set(versions)];\n      if (uniqueVersions.length <= 1) continue;\n      logInfo(\n        `⚠️  Multiple versions found for ${pkg}:`,\n        uniqueVersions.join(\", \"),\n      );\n      hasDuplicates = true;\n    }\n\n    if (hasDuplicates) {\n      logInfo(\"\\n🔨 Reinstalling to remove duplicate versions...\");\n      logInfo(\"   This ensures TypeScript loads the correct types.\");\n      await this.exec(\"mv node_modules node_modules_tmp\");\n      await Promise.all([\n        this.exec(\"rm -rf node_modules_tmp\"),\n        this.exec(\"pnpm install\"),\n      ]);\n    }\n  }\n\n  protected async verifyPackages(): Promise<void> {\n    logSuccess(\"\\n✅ Verifying package versions...\");\n    const listOutput = await this.exec(\n      `pnpm list ${this.pattern} --depth=0 -r --json`,\n    );\n    const workspaces = JSON.parse(listOutput);\n\n    const versionMap = new Map<string, Map<string, string>>();\n\n    for (const workspace of workspaces) {\n      const deps = workspace.dependencies ?? {};\n      for (const [pkg, info] of Object.entries(deps)) {\n        if (micromatch.isMatch(pkg, this.pattern)) {\n          if (!versionMap.has(pkg)) versionMap.set(pkg, new Map());\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          versionMap.get(pkg)!.set(workspace.name, (info as any).version);\n        }\n      }\n    }\n\n    let allConsistent = true;\n    for (const [pkg, versions] of versionMap) {\n      const uniqueVersions = new Set(versions.values());\n      if (uniqueVersions.size <= 1) {\n        logSuccess(`✅ ${pkg}: ${[...uniqueVersions][0]}`);\n        continue;\n      }\n\n      logInfo(`❌ Inconsistent versions for ${pkg}:`);\n      for (const [workspace, version] of versions)\n        logInfo(`   - ${workspace}: ${version}`);\n\n      allConsistent = false;\n    }\n\n    if (!allConsistent) {\n      console.error(\n        \"\\n❌ Version inconsistencies detected! Please review and fix manually.\",\n      );\n      process.exit(1);\n    }\n\n    logInfo(`\\n🎉 All ${this.pattern} packages updated successfully!`);\n    logInfo(\n      \"\\n💡 Tip: Restart your TypeScript server in VS Code to pick up the new types.\",\n    );\n    logInfo('   - Cmd+Shift+P → \"TypeScript: Restart TS Server\"');\n  }\n}\n"]}
+{"version":3,"file":"UpdatePackages.js","sourceRoot":"","sources":["../../src/pkg/UpdatePackages.ts"],"names":[],"mappings":"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","sourcesContent":["import { PackageJson, UpdatePackagesParams } from \"../types/types.package.js\";\nimport { logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { execAsync } from \"../common/common.fs.js\";\nimport micromatch from \"micromatch\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\n\n/**\n * Initializes the workspace and runs the package-update workflow.\n *\n * @remarks\n * This is a convenience entry point that constructs an {@link UpdatePackages} instance\n * and immediately invokes its {@link UpdatePackages.run} method.\n *\n * @param params - Configuration for the update, including the repo root and a glob pattern to select packages.\n * @returns A promise that resolves when all matching packages have been updated and verified.\n */\nexport const runUpdatePackages = async (params: UpdatePackagesParams) => {\n  initWorkspace(params.repoRoot);\n  return new UpdatePackages(params.pattern).run();\n};\n\n/**\n * Bulk-updates dependencies matching a glob pattern across all workspace packages.\n *\n * @remarks\n * The update pipeline performs five sequential steps:\n * 1. Discover matching dependencies across every workspace package.\n * 2. Run `pnpm update -r --latest` for the matched packages.\n * 3. Deduplicate the dependency tree with `pnpm dedupe`.\n * 4. Remove stale duplicate versions from `node_modules/.pnpm`.\n * 5. Verify that all workspaces converge on the same version for each package.\n */\nexport class UpdatePackages {\n  protected patternWoSlash: string;\n\n  /**\n   * Creates a new UpdatePackages instance.\n   *\n   * @param pattern - A glob pattern used to match dependency names (e.g. `\"@angular/*\"`).\n   */\n  public constructor(protected readonly pattern: string) {\n    this.patternWoSlash = pattern.replaceAll(\"/\", \"+\");\n  }\n\n  /**\n   * Executes the full package-update pipeline.\n   *\n   * @remarks\n   * Discovers matching packages, updates them, deduplicates, cleans old versions,\n   * and verifies consistency. Exits the process with code 1 if version\n   * inconsistencies are detected after the update.\n   *\n   * @returns A promise that resolves when the pipeline completes successfully.\n   */\n  public async run(): Promise<void> {\n    logInfo(`🚀 Starting ${this.pattern} packages update process...\\n`);\n\n    // Step 1: Find all packages\n    const packages = await this.getPackages();\n    logInfo(`📦 Found ${this.pattern} packages:`);\n    for (const pkg of packages) logInfo(`   - ${pkg}`);\n\n    if (packages.size === 0)\n      return logSuccess(`✅ No ${this.pattern} packages found.`);\n\n    // Step 2: Update packages in all workspaces recursively\n    await this.updatePackages(packages);\n\n    // Step 3: Deduplicate dependencies\n    await this.deduplicate();\n\n    // Step 4: Remove old versions from node_modules\n    await this.rmOldVersions();\n\n    // Step 5: Verify all packages are at the same version\n    await this.verifyPackages();\n  }\n\n  protected async exec(command: string): Promise<string> {\n    console.log(`\\n▶ ${command}`);\n    try {\n      return (\n        await execAsync(command, {\n          cwd: workspace().repoRoot,\n          encoding: \"utf-8\",\n        })\n      ).stdout;\n    } catch (error) {\n      console.error(`Error executing: ${command}`);\n      throw error;\n    }\n  }\n\n  protected async getPackages(): Promise<Set<string>> {\n    const ws = workspace();\n    await ws.read();\n    const pkgs = [...ws.packages, ws.rootPackage];\n    const packageNames: string[] = (\n      await Promise.all(this.filterPackages(pkgs.map((p) => p.content)))\n    ).flat();\n\n    return new Set<string>(packageNames);\n  }\n\n  protected filterPackages(wsPackages: PackageJson[]): Promise<string[]>[] {\n    return wsPackages.flatMap((wsPackage) => this.filterPackage(wsPackage));\n  }\n\n  protected filterPackage(wsPackage: PackageJson): Promise<string[]>[] {\n    return [\n      this.filterPackageDep(wsPackage.dependencies),\n      this.filterPackageDep(wsPackage.devDependencies),\n    ];\n  }\n\n  protected async filterPackageDep(\n    deps: Record<string, string> | undefined,\n  ): Promise<string[]> {\n    return Promise.resolve(\n      Object.keys(deps ?? []).filter((depName) =>\n        micromatch.isMatch(depName, this.pattern),\n      ),\n    );\n  }\n\n  protected async updatePackages(packages: Set<string>): Promise<void> {\n    logInfo(\"\\n📥 Updating packages across all workspaces...\");\n    const packageList = Array.from(packages).join(\" \");\n    await this.exec(`pnpm update -r --latest ${packageList}`);\n  }\n\n  protected async deduplicate(): Promise<void> {\n    logInfo(\"\\n🔧 Deduplicating dependencies...\");\n    await this.exec(\"pnpm dedupe\");\n  }\n\n  protected async rmOldVersions(): Promise<void> {\n    logInfo(\"\\n🧹 Checking for old versions...\");\n    const oldVersions = await this.exec(\n      `find node_modules/.pnpm -type d -name \"${this.patternWoSlash}\" -depth 1 2>/dev/null || true`,\n    );\n    const versionDirs = oldVersions.trim().split(\"\\n\").filter(Boolean);\n\n    // Group by package name to identify duplicates\n    const packageVersions = new Map<string, string[]>();\n    for (const dir of versionDirs) {\n      const match = dir.match(/\\/(@?[a-z-+]+)@(.+)$/);\n      if (!match) continue;\n      const [, pkgName, version] = match;\n      if (!micromatch.isMatch(pkgName, this.patternWoSlash)) continue;\n      const key = pkgName.replace(/\\+/g, \"/\");\n      if (!packageVersions.has(key)) packageVersions.set(key, []);\n      packageVersions.get(key)!.push(version.split(\"_\")[0]); // Remove peer dep suffixes\n    }\n\n    // Check for duplicates\n    let hasDuplicates = false;\n    for (const [pkg, versions] of packageVersions) {\n      const uniqueVersions = [...new Set(versions)];\n      if (uniqueVersions.length <= 1) continue;\n      logInfo(\n        `⚠️  Multiple versions found for ${pkg}:`,\n        uniqueVersions.join(\", \"),\n      );\n      hasDuplicates = true;\n    }\n\n    if (hasDuplicates) {\n      logInfo(\"\\n🔨 Reinstalling to remove duplicate versions...\");\n      logInfo(\"   This ensures TypeScript loads the correct types.\");\n      await this.exec(\"mv node_modules node_modules_tmp\");\n      await Promise.all([\n        this.exec(\"rm -rf node_modules_tmp\"),\n        this.exec(\"pnpm install\"),\n      ]);\n    }\n  }\n\n  protected async verifyPackages(): Promise<void> {\n    logSuccess(\"\\n✅ Verifying package versions...\");\n    const listOutput = await this.exec(\n      `pnpm list ${this.pattern} --depth=0 -r --json`,\n    );\n    const workspaces = JSON.parse(listOutput);\n\n    const versionMap = new Map<string, Map<string, string>>();\n\n    for (const workspace of workspaces) {\n      const deps = workspace.dependencies ?? {};\n      for (const [pkg, info] of Object.entries(deps)) {\n        if (micromatch.isMatch(pkg, this.pattern)) {\n          if (!versionMap.has(pkg)) versionMap.set(pkg, new Map());\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          versionMap.get(pkg)!.set(workspace.name, (info as any).version);\n        }\n      }\n    }\n\n    let allConsistent = true;\n    for (const [pkg, versions] of versionMap) {\n      const uniqueVersions = new Set(versions.values());\n      if (uniqueVersions.size <= 1) {\n        logSuccess(`✅ ${pkg}: ${[...uniqueVersions][0]}`);\n        continue;\n      }\n\n      logInfo(`❌ Inconsistent versions for ${pkg}:`);\n      for (const [workspace, version] of versions)\n        logInfo(`   - ${workspace}: ${version}`);\n\n      allConsistent = false;\n    }\n\n    if (!allConsistent) {\n      console.error(\n        \"\\n❌ Version inconsistencies detected! Please review and fix manually.\",\n      );\n      process.exit(1);\n    }\n\n    logInfo(`\\n🎉 All ${this.pattern} packages updated successfully!`);\n    logInfo(\n      \"\\n💡 Tip: Restart your TypeScript server in VS Code to pick up the new types.\",\n    );\n    logInfo('   - Cmd+Shift+P → \"TypeScript: Restart TS Server\"');\n  }\n}\n"]}

package/dist/pkg/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./ExportExtractor.js";
 export * from "./Pkg.js";
 export * from "./SyncPkgVersion.js";
 export * from "./UpdatePackages.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pkg/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pkg/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/pkg/index.js

@@ -1,4 +1,5 @@
 // This file is auto-generated for build-cli. Do not edit manually.
+export * from "./ExportExtractor.js";
 export * from "./Pkg.js";
 export * from "./SyncPkgVersion.js";
 export * from "./UpdatePackages.js";

package/dist/pkg/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pkg/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC","sourcesContent":["// This file is auto-generated for build-cli. Do not edit manually.\nexport * from \"./Pkg.js\";\nexport * from \"./SyncPkgVersion.js\";\nexport * from \"./UpdatePackages.js\";\nexport * from \"./pkg.common.js\";\nexport * from \"./pkg.fs.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pkg/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC","sourcesContent":["// This file is auto-generated for build-cli. Do not edit manually.\nexport * from \"./ExportExtractor.js\";\nexport * from \"./Pkg.js\";\nexport * from \"./SyncPkgVersion.js\";\nexport * from \"./UpdatePackages.js\";\nexport * from \"./pkg.common.js\";\nexport * from \"./pkg.fs.js\";\n"]}

package/dist/pkg/pkg.common.d.ts

@@ -1,7 +1,80 @@
 import { BumpParams, PackageVersion } from "../types/types.package.js";
+/**
+ * Parses a semver version string into its constituent parts.
+ *
+ * @remarks
+ * Accepts versions with or without a `v` prefix (e.g. `"v1.2.3"` or `"1.2.3"`).
+ * Throws if any of the major, minor, or patch segments are not valid numbers.
+ *
+ * @param version - A semver version string such as `"1.2.3"` or `"v1.2.3"`.
+ * @returns A {@link PackageVersion} object with numeric `major`, `minor`, `patch` and an optional `prefix`.
+ *
+ * @example
+ * ```ts
+ * splitVersion("v1.2.3"); // { major: 1, minor: 2, patch: 3, prefix: "v" }
+ * splitVersion("0.5.10"); // { major: 0, minor: 5, patch: 10, prefix: null }
+ * ```
+ */
 export declare const splitVersion: (version: string) => PackageVersion;
+/**
+ * Concatenates a {@link PackageVersion} object back into a version string.
+ *
+ * @remarks
+ * Includes the prefix (e.g. `"v"`) when present. Minor and patch segments are
+ * only appended when they are truthy (non-zero).
+ *
+ * @param version - The parsed version object to concatenate.
+ * @returns The formatted version string, e.g. `"v1.2.3"` or `"1.0"`.
+ *
+ * @example
+ * ```ts
+ * concatVersion({ major: 1, minor: 2, patch: 3, prefix: "v" }); // "v1.2.3"
+ * concatVersion({ major: 2, minor: 0, patch: 0, prefix: null }); // "2"
+ * ```
+ */
 export declare const concatVersion: (version: PackageVersion) => string;
+/**
+ * Compares two semantic versions numerically.
+ *
+ * @remarks
+ * Accepts either a version string or a {@link PackageVersion} object for each operand.
+ * Comparison proceeds from major → minor → patch, returning `0` when components
+ * that exist are equal, and short-circuiting when a component is `null`.
+ *
+ * @param a - The first version to compare.
+ * @param b - The second version to compare.
+ * @returns A negative number if `a` is less than `b`, a positive number if greater, or `0` if equal.
+ */
 export declare const compareVersions: (a: PackageVersion | string, b: PackageVersion | string) => number;
+/**
+ * Checks whether version `a` is strictly greater than version `b`.
+ *
+ * @param a - The first version to compare.
+ * @param b - The second version to compare.
+ * @returns `true` if `a` is greater than `b`, otherwise `false`.
+ */
 export declare const compareVersionsGT: (a: PackageVersion | string, b: PackageVersion | string) => boolean;
+/**
+ * Increments a semantic version according to the specified bump parameters.
+ *
+ * @remarks
+ * Only one of `major`, `minor`, or `patch` should be set in the bump params.
+ * When bumping `major`, `minor` and `patch` are reset to `0`.
+ * When bumping `minor`, `patch` is reset to `0`.
+ * The original version object is not mutated.
+ *
+ * @param version - The current version to bump.
+ * @param bump - An object indicating which semver component to increment.
+ * @returns A new {@link PackageVersion} with the bumped values.
+ *
+ * @example
+ * ```ts
+ * bumpVersion({ major: 1, minor: 2, patch: 3, prefix: null }, { patch: true });
+ * // { major: 1, minor: 2, patch: 4, prefix: null }
+ *
+ * bumpVersion({ major: 1, minor: 2, patch: 3, prefix: null }, { major: true });
+ * // { major: 2, minor: 0, patch: 0, prefix: null }
+ * ```
+ */
 export declare const bumpVersion: (version: PackageVersion, bump: BumpParams) => PackageVersion;
 //# sourceMappingURL=pkg.common.d.ts.map

package/dist/pkg/pkg.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pkg.common.d.ts","sourceRoot":"","sources":["../../src/pkg/pkg.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,cA+B9C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,cAAc,KAAG,MAMvD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,GAAG,cAAc,GAAG,MAAM,EAC1B,GAAG,cAAc,GAAG,MAAM,KACzB,MASF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,GAAG,cAAc,GAAG,MAAM,EAC1B,GAAG,cAAc,GAAG,MAAM,KACzB,OAAoC,CAAC;AAExC,eAAO,MAAM,WAAW,GACtB,SAAS,cAAc,EACvB,MAAM,UAAU,KACf,cAaF,CAAC"}
+{"version":3,"file":"pkg.common.d.ts","sourceRoot":"","sources":["../../src/pkg/pkg.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,cA+B9C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,cAAc,KAAG,MAMvD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,GAAG,cAAc,GAAG,MAAM,EAC1B,GAAG,cAAc,GAAG,MAAM,KACzB,MASF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,GAAG,cAAc,GAAG,MAAM,EAC1B,GAAG,cAAc,GAAG,MAAM,KACzB,OAAoC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,GACtB,SAAS,cAAc,EACvB,MAAM,UAAU,KACf,cAaF,CAAC"}

package/dist/pkg/pkg.common.js

@@ -1,3 +1,19 @@
+/**
+ * Parses a semver version string into its constituent parts.
+ *
+ * @remarks
+ * Accepts versions with or without a `v` prefix (e.g. `"v1.2.3"` or `"1.2.3"`).
+ * Throws if any of the major, minor, or patch segments are not valid numbers.
+ *
+ * @param version - A semver version string such as `"1.2.3"` or `"v1.2.3"`.
+ * @returns A {@link PackageVersion} object with numeric `major`, `minor`, `patch` and an optional `prefix`.
+ *
+ * @example
+ * ```ts
+ * splitVersion("v1.2.3"); // { major: 1, minor: 2, patch: 3, prefix: "v" }
+ * splitVersion("0.5.10"); // { major: 0, minor: 5, patch: 10, prefix: null }
+ * ```
+ */
 export const splitVersion = (version) => {
     const parts = version.split(".");
     const majorStr = parts.shift();
@@ -18,6 +34,22 @@ export const splitVersion = (version) => {
         prefix,
     };
 };
+/**
+ * Concatenates a {@link PackageVersion} object back into a version string.
+ *
+ * @remarks
+ * Includes the prefix (e.g. `"v"`) when present. Minor and patch segments are
+ * only appended when they are truthy (non-zero).
+ *
+ * @param version - The parsed version object to concatenate.
+ * @returns The formatted version string, e.g. `"v1.2.3"` or `"1.0"`.
+ *
+ * @example
+ * ```ts
+ * concatVersion({ major: 1, minor: 2, patch: 3, prefix: "v" }); // "v1.2.3"
+ * concatVersion({ major: 2, minor: 0, patch: 0, prefix: null }); // "2"
+ * ```
+ */
 export const concatVersion = (version) => {
     let result = version.major.toString();
     if (version.prefix)
@@ -28,6 +60,18 @@ export const concatVersion = (version) => {
         result += "." + version.patch.toString();
     return result;
 };
+/**
+ * Compares two semantic versions numerically.
+ *
+ * @remarks
+ * Accepts either a version string or a {@link PackageVersion} object for each operand.
+ * Comparison proceeds from major → minor → patch, returning `0` when components
+ * that exist are equal, and short-circuiting when a component is `null`.
+ *
+ * @param a - The first version to compare.
+ * @param b - The second version to compare.
+ * @returns A negative number if `a` is less than `b`, a positive number if greater, or `0` if equal.
+ */
 export const compareVersions = (a, b) => {
     a = typeof a === "string" ? splitVersion(a) : a;
     b = typeof b === "string" ? splitVersion(b) : b;
@@ -43,7 +87,36 @@ export const compareVersions = (a, b) => {
         return a.patch - b.patch;
     return 0;
 };
+/**
+ * Checks whether version `a` is strictly greater than version `b`.
+ *
+ * @param a - The first version to compare.
+ * @param b - The second version to compare.
+ * @returns `true` if `a` is greater than `b`, otherwise `false`.
+ */
 export const compareVersionsGT = (a, b) => compareVersions(a, b) > 0;
+/**
+ * Increments a semantic version according to the specified bump parameters.
+ *
+ * @remarks
+ * Only one of `major`, `minor`, or `patch` should be set in the bump params.
+ * When bumping `major`, `minor` and `patch` are reset to `0`.
+ * When bumping `minor`, `patch` is reset to `0`.
+ * The original version object is not mutated.
+ *
+ * @param version - The current version to bump.
+ * @param bump - An object indicating which semver component to increment.
+ * @returns A new {@link PackageVersion} with the bumped values.
+ *
+ * @example
+ * ```ts
+ * bumpVersion({ major: 1, minor: 2, patch: 3, prefix: null }, { patch: true });
+ * // { major: 1, minor: 2, patch: 4, prefix: null }
+ *
+ * bumpVersion({ major: 1, minor: 2, patch: 3, prefix: null }, { major: true });
+ * // { major: 2, minor: 0, patch: 0, prefix: null }
+ * ```
+ */
 export const bumpVersion = (version, bump) => {
     const result = { ...version };
     if (bump.major) {

package/dist/pkg/pkg.common.js.map

@@ -1 +1 @@
-{"version":3,"file":"pkg.common.js","sourceRoot":"","sources":["../../src/pkg/pkg.common.ts"],"names":[],"mappings":"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","sourcesContent":["import { BumpParams, PackageVersion } from \"../types/types.package.js\";\n\nexport const splitVersion = (version: string): PackageVersion => {\n  const parts = version.split(\".\");\n\n  const majorStr = parts.shift()!;\n  const prefix: string | null = majorStr.startsWith(\"v\") ? \"v\" : null;\n\n  const major = Number(prefix ? majorStr.substring(prefix.length) : majorStr);\n  const minor = Number(parts.shift());\n  const patch = Number(parts.shift());\n\n  if (isNaN(major))\n    throw new Error(\n      `Version \"${version}\" does not match pattern \"/^v?major\\.minor\\.patch$/\" (major)`,\n    );\n\n  if (isNaN(minor))\n    throw new Error(\n      `Version \"${version}\" does not match pattern \"/^v?major\\.minor\\.patch$/\" (minor)`,\n    );\n\n  if (isNaN(patch))\n    throw new Error(\n      `Version \"${version}\" does not match pattern \"/^v?major\\.minor\\.patch$/\" (patch)`,\n    );\n\n  return {\n    major,\n    minor,\n    patch,\n    prefix,\n  };\n};\n\nexport const concatVersion = (version: PackageVersion): string => {\n  let result: string = version.major.toString();\n  if (version.prefix) result = version.prefix + result;\n  if (version.minor) result += \".\" + version.minor.toString();\n  if (version.patch) result += \".\" + version.patch.toString();\n  return result;\n};\n\nexport const compareVersions = (\n  a: PackageVersion | string,\n  b: PackageVersion | string,\n): number => {\n  a = typeof a === \"string\" ? splitVersion(a) : a;\n  b = typeof b === \"string\" ? splitVersion(b) : b;\n  if (a.major !== b.major) return a.major - b.major;\n  if (a.minor === null || b.minor === null) return 0;\n  if (a.minor !== b.minor) return a.minor - b.minor;\n  if (a.patch === null || b.patch === null) return 0;\n  if (a.patch !== b.patch) return a.patch - b.patch;\n  return 0;\n};\n\nexport const compareVersionsGT = (\n  a: PackageVersion | string,\n  b: PackageVersion | string,\n): boolean => compareVersions(a, b) > 0;\n\nexport const bumpVersion = (\n  version: PackageVersion,\n  bump: BumpParams,\n): PackageVersion => {\n  const result: PackageVersion = { ...version };\n  if (bump.major) {\n    result.major = result.major ? result.major + 1 : 1;\n    result.minor = 0;\n    result.patch = 0;\n  } else if (bump.minor) {\n    result.minor = result.minor ? result.minor + 1 : 1;\n    result.patch = 0;\n  } else if (bump.patch) {\n    result.patch = result.patch ? result.patch + 1 : 1;\n  }\n  return result;\n};\n"]}
+{"version":3,"file":"pkg.common.js","sourceRoot":"","sources":["../../src/pkg/pkg.common.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAkB,EAAE;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;IAChC,MAAM,MAAM,GAAkB,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,KAAK,CAAC;QACd,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,8DAA8D,CAClF,CAAC;IAEJ,IAAI,KAAK,CAAC,KAAK,CAAC;QACd,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,8DAA8D,CAClF,CAAC;IAEJ,IAAI,KAAK,CAAC,KAAK,CAAC;QACd,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,8DAA8D,CAClF,CAAC;IAEJ,OAAO;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAuB,EAAU,EAAE;IAC/D,IAAI,MAAM,GAAW,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACrD,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5D,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,CAA0B,EAC1B,CAA0B,EAClB,EAAE;IACV,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,CAA0B,EAC1B,CAA0B,EACjB,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAAuB,EACvB,IAAgB,EACA,EAAE;IAClB,MAAM,MAAM,GAAmB,EAAE,GAAG,OAAO,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;SAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC","sourcesContent":["import { BumpParams, PackageVersion } from \"../types/types.package.js\";\n\n/**\n * Parses a semver version string into its constituent parts.\n *\n * @remarks\n * Accepts versions with or without a `v` prefix (e.g. `\"v1.2.3\"` or `\"1.2.3\"`).\n * Throws if any of the major, minor, or patch segments are not valid numbers.\n *\n * @param version - A semver version string such as `\"1.2.3\"` or `\"v1.2.3\"`.\n * @returns A {@link PackageVersion} object with numeric `major`, `minor`, `patch` and an optional `prefix`.\n *\n * @example\n * ```ts\n * splitVersion(\"v1.2.3\"); // { major: 1, minor: 2, patch: 3, prefix: \"v\" }\n * splitVersion(\"0.5.10\"); // { major: 0, minor: 5, patch: 10, prefix: null }\n * ```\n */\nexport const splitVersion = (version: string): PackageVersion => {\n  const parts = version.split(\".\");\n\n  const majorStr = parts.shift()!;\n  const prefix: string | null = majorStr.startsWith(\"v\") ? \"v\" : null;\n\n  const major = Number(prefix ? majorStr.substring(prefix.length) : majorStr);\n  const minor = Number(parts.shift());\n  const patch = Number(parts.shift());\n\n  if (isNaN(major))\n    throw new Error(\n      `Version \"${version}\" does not match pattern \"/^v?major\\.minor\\.patch$/\" (major)`,\n    );\n\n  if (isNaN(minor))\n    throw new Error(\n      `Version \"${version}\" does not match pattern \"/^v?major\\.minor\\.patch$/\" (minor)`,\n    );\n\n  if (isNaN(patch))\n    throw new Error(\n      `Version \"${version}\" does not match pattern \"/^v?major\\.minor\\.patch$/\" (patch)`,\n    );\n\n  return {\n    major,\n    minor,\n    patch,\n    prefix,\n  };\n};\n\n/**\n * Concatenates a {@link PackageVersion} object back into a version string.\n *\n * @remarks\n * Includes the prefix (e.g. `\"v\"`) when present. Minor and patch segments are\n * only appended when they are truthy (non-zero).\n *\n * @param version - The parsed version object to concatenate.\n * @returns The formatted version string, e.g. `\"v1.2.3\"` or `\"1.0\"`.\n *\n * @example\n * ```ts\n * concatVersion({ major: 1, minor: 2, patch: 3, prefix: \"v\" }); // \"v1.2.3\"\n * concatVersion({ major: 2, minor: 0, patch: 0, prefix: null }); // \"2\"\n * ```\n */\nexport const concatVersion = (version: PackageVersion): string => {\n  let result: string = version.major.toString();\n  if (version.prefix) result = version.prefix + result;\n  if (version.minor) result += \".\" + version.minor.toString();\n  if (version.patch) result += \".\" + version.patch.toString();\n  return result;\n};\n\n/**\n * Compares two semantic versions numerically.\n *\n * @remarks\n * Accepts either a version string or a {@link PackageVersion} object for each operand.\n * Comparison proceeds from major → minor → patch, returning `0` when components\n * that exist are equal, and short-circuiting when a component is `null`.\n *\n * @param a - The first version to compare.\n * @param b - The second version to compare.\n * @returns A negative number if `a` is less than `b`, a positive number if greater, or `0` if equal.\n */\nexport const compareVersions = (\n  a: PackageVersion | string,\n  b: PackageVersion | string,\n): number => {\n  a = typeof a === \"string\" ? splitVersion(a) : a;\n  b = typeof b === \"string\" ? splitVersion(b) : b;\n  if (a.major !== b.major) return a.major - b.major;\n  if (a.minor === null || b.minor === null) return 0;\n  if (a.minor !== b.minor) return a.minor - b.minor;\n  if (a.patch === null || b.patch === null) return 0;\n  if (a.patch !== b.patch) return a.patch - b.patch;\n  return 0;\n};\n\n/**\n * Checks whether version `a` is strictly greater than version `b`.\n *\n * @param a - The first version to compare.\n * @param b - The second version to compare.\n * @returns `true` if `a` is greater than `b`, otherwise `false`.\n */\nexport const compareVersionsGT = (\n  a: PackageVersion | string,\n  b: PackageVersion | string,\n): boolean => compareVersions(a, b) > 0;\n\n/**\n * Increments a semantic version according to the specified bump parameters.\n *\n * @remarks\n * Only one of `major`, `minor`, or `patch` should be set in the bump params.\n * When bumping `major`, `minor` and `patch` are reset to `0`.\n * When bumping `minor`, `patch` is reset to `0`.\n * The original version object is not mutated.\n *\n * @param version - The current version to bump.\n * @param bump - An object indicating which semver component to increment.\n * @returns A new {@link PackageVersion} with the bumped values.\n *\n * @example\n * ```ts\n * bumpVersion({ major: 1, minor: 2, patch: 3, prefix: null }, { patch: true });\n * // { major: 1, minor: 2, patch: 4, prefix: null }\n *\n * bumpVersion({ major: 1, minor: 2, patch: 3, prefix: null }, { major: true });\n * // { major: 2, minor: 0, patch: 0, prefix: null }\n * ```\n */\nexport const bumpVersion = (\n  version: PackageVersion,\n  bump: BumpParams,\n): PackageVersion => {\n  const result: PackageVersion = { ...version };\n  if (bump.major) {\n    result.major = result.major ? result.major + 1 : 1;\n    result.minor = 0;\n    result.patch = 0;\n  } else if (bump.minor) {\n    result.minor = result.minor ? result.minor + 1 : 1;\n    result.patch = 0;\n  } else if (bump.patch) {\n    result.patch = result.patch ? result.patch + 1 : 1;\n  }\n  return result;\n};\n"]}

package/dist/pkg/pkg.fs.d.ts

@@ -1,6 +1,59 @@
 import { PackageJson } from "../types/types.package.js";
+/**
+ * Reads and parses a `package.json` file asynchronously.
+ *
+ * @remarks
+ * Uses JSON5 for parsing, so comments and trailing commas are permitted.
+ * If the path is a directory, `/package.json` is automatically appended.
+ *
+ * @param dirOrFilepath - An absolute path to either a directory containing `package.json` or the file itself.
+ * @returns A promise resolving to the parsed {@link PackageJson} contents.
+ *
+ * @example
+ * ```ts
+ * const pkg = await readPackageJson("/path/to/my-package");
+ * console.log(pkg.name);
+ * ```
+ */
 export declare const readPackageJson: (dirOrFilepath: string) => Promise<PackageJson>;
+/**
+ * Reads and parses a `package.json` file synchronously.
+ *
+ * @remarks
+ * Uses JSON5 for parsing, so comments and trailing commas are permitted.
+ * If the path is a directory, `/package.json` is automatically appended.
+ *
+ * @param dirOrFilepath - An absolute path to either a directory containing `package.json` or the file itself.
+ * @returns The parsed {@link PackageJson} contents.
+ *
+ * @example
+ * ```ts
+ * const pkg = readPackageJsonSync("/path/to/my-package");
+ * console.log(pkg.version);
+ * ```
+ */
 export declare const readPackageJsonSync: (dirOrFilepath: string) => PackageJson;
+/**
+ * Writes a {@link PackageJson} object to disk as formatted JSON.
+ *
+ * @remarks
+ * The output is stringified via JSON5 and then formatted with the project's
+ * standard JSON formatter before being written.
+ *
+ * @param jsonPath - The absolute file path to write the `package.json` to.
+ * @param content - The package JSON content to serialize and write.
+ * @returns A promise that resolves when the file has been written.
+ */
 export declare const writePackageJson: (jsonPath: string, content: PackageJson) => Promise<void>;
+/**
+ * Ensures a path ends with `/package.json`.
+ *
+ * @remarks
+ * If the path already ends with `/package.json` it is returned as-is;
+ * otherwise `package.json` is appended via `path.join`.
+ *
+ * @param dirOrFilepath - A directory path or a path already pointing to `package.json`.
+ * @returns The path guaranteed to end with `/package.json`.
+ */
 export declare const ensurePkgJsonPath: (dirOrFilepath: string) => string;
 //# sourceMappingURL=pkg.fs.d.ts.map

package/dist/pkg/pkg.fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pkg.fs.d.ts","sourceRoot":"","sources":["../../src/pkg/pkg.fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAKxD,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,KACpB,OAAO,CAAC,WAAW,CACiD,CAAC;AAExE,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,KAAG,WACS,CAAC;AAEtE,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,SAAS,WAAW,KACnB,OAAO,CAAC,IAAI,CAC2D,CAAC;AAE3E,eAAO,MAAM,iBAAiB,GAAI,eAAe,MAAM,KAAG,MAGjB,CAAC"}
+{"version":3,"file":"pkg.fs.d.ts","sourceRoot":"","sources":["../../src/pkg/pkg.fs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AASxD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,KACpB,OAAO,CAAC,WAAW,CAC+C,CAAC;AAEtE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,KAAG,WACO,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,SAAS,WAAW,KACnB,OAAO,CAAC,IAAI,CAIZ,CAAC;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,eAAe,MAAM,KAAG,MAGjB,CAAC"}

package/dist/pkg/pkg.fs.js

@@ -1,11 +1,63 @@
-import json5 from "json5";
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { formatJsonStringify } from "../code/code.format.js";
 import { readFileSync } from "node:fs";
-export const readPackageJson = async (dirOrFilepath) => json5.parse(await readFile(ensurePkgJsonPath(dirOrFilepath), "utf8"));
-export const readPackageJsonSync = (dirOrFilepath) => json5.parse(readFileSync(ensurePkgJsonPath(dirOrFilepath), "utf8"));
-export const writePackageJson = async (jsonPath, content) => writeFile(jsonPath, await formatJsonStringify(json5.stringify(content)));
+import { jsonParse, jsonStringify, JsonStringifyFormat, } from "../common/common.json.js";
+/**
+ * Reads and parses a `package.json` file asynchronously.
+ *
+ * @remarks
+ * Uses JSON5 for parsing, so comments and trailing commas are permitted.
+ * If the path is a directory, `/package.json` is automatically appended.
+ *
+ * @param dirOrFilepath - An absolute path to either a directory containing `package.json` or the file itself.
+ * @returns A promise resolving to the parsed {@link PackageJson} contents.
+ *
+ * @example
+ * ```ts
+ * const pkg = await readPackageJson("/path/to/my-package");
+ * console.log(pkg.name);
+ * ```
+ */
+export const readPackageJson = async (dirOrFilepath) => jsonParse(await readFile(ensurePkgJsonPath(dirOrFilepath), "utf8"));
+/**
+ * Reads and parses a `package.json` file synchronously.
+ *
+ * @remarks
+ * Uses JSON5 for parsing, so comments and trailing commas are permitted.
+ * If the path is a directory, `/package.json` is automatically appended.
+ *
+ * @param dirOrFilepath - An absolute path to either a directory containing `package.json` or the file itself.
+ * @returns The parsed {@link PackageJson} contents.
+ *
+ * @example
+ * ```ts
+ * const pkg = readPackageJsonSync("/path/to/my-package");
+ * console.log(pkg.version);
+ * ```
+ */
+export const readPackageJsonSync = (dirOrFilepath) => jsonParse(readFileSync(ensurePkgJsonPath(dirOrFilepath), "utf8"));
+/**
+ * Writes a {@link PackageJson} object to disk as formatted JSON.
+ *
+ * @remarks
+ * The output is stringified via JSON5 and then formatted with the project's
+ * standard JSON formatter before being written.
+ *
+ * @param jsonPath - The absolute file path to write the `package.json` to.
+ * @param content - The package JSON content to serialize and write.
+ * @returns A promise that resolves when the file has been written.
+ */
+export const writePackageJson = async (jsonPath, content) => writeFile(jsonPath, await jsonStringify(content, JsonStringifyFormat.jsonStringify));
+/**
+ * Ensures a path ends with `/package.json`.
+ *
+ * @remarks
+ * If the path already ends with `/package.json` it is returned as-is;
+ * otherwise `package.json` is appended via `path.join`.
+ *
+ * @param dirOrFilepath - A directory path or a path already pointing to `package.json`.
+ * @returns The path guaranteed to end with `/package.json`.
+ */
 export const ensurePkgJsonPath = (dirOrFilepath) => dirOrFilepath.endsWith("/package.json")
     ? dirOrFilepath
     : join(dirOrFilepath, "package.json");

package/dist/pkg/pkg.fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"pkg.fs.js","sourceRoot":"","sources":["../../src/pkg/pkg.fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,aAAqB,EACC,EAAE,CACxB,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAqB,EAAe,EAAE,CACxE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,QAAgB,EAChB,OAAoB,EACL,EAAE,CACjB,SAAS,CAAC,QAAQ,EAAE,MAAM,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,aAAqB,EAAU,EAAE,CACjE,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC;IACrC,CAAC,CAAC,aAAa;IACf,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC","sourcesContent":["import json5 from \"json5\";\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport { PackageJson } from \"../types/types.package.js\";\nimport { join } from \"node:path\";\nimport { formatJsonStringify } from \"../code/code.format.js\";\nimport { readFileSync } from \"node:fs\";\n\nexport const readPackageJson = async (\n  dirOrFilepath: string,\n): Promise<PackageJson> =>\n  json5.parse(await readFile(ensurePkgJsonPath(dirOrFilepath), \"utf8\"));\n\nexport const readPackageJsonSync = (dirOrFilepath: string): PackageJson =>\n  json5.parse(readFileSync(ensurePkgJsonPath(dirOrFilepath), \"utf8\"));\n\nexport const writePackageJson = async (\n  jsonPath: string,\n  content: PackageJson,\n): Promise<void> =>\n  writeFile(jsonPath, await formatJsonStringify(json5.stringify(content)));\n\nexport const ensurePkgJsonPath = (dirOrFilepath: string): string =>\n  dirOrFilepath.endsWith(\"/package.json\")\n    ? dirOrFilepath\n    : join(dirOrFilepath, \"package.json\");\n"]}
+{"version":3,"file":"pkg.fs.js","sourceRoot":"","sources":["../../src/pkg/pkg.fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,aAAqB,EACC,EAAE,CACxB,SAAS,CAAC,MAAM,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAqB,EAAe,EAAE,CACxE,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,QAAgB,EAChB,OAAoB,EACL,EAAE,CACjB,SAAS,CACP,QAAQ,EACR,MAAM,aAAa,CAAC,OAAO,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAChE,CAAC;AAEJ;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,aAAqB,EAAU,EAAE,CACjE,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC;IACrC,CAAC,CAAC,aAAa;IACf,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { PackageJson } from \"../types/types.package.js\";\nimport { join } from \"node:path\";\nimport { readFileSync } from \"node:fs\";\nimport {\n  jsonParse,\n  jsonStringify,\n  JsonStringifyFormat,\n} from \"../common/common.json.js\";\n\n/**\n * Reads and parses a `package.json` file asynchronously.\n *\n * @remarks\n * Uses JSON5 for parsing, so comments and trailing commas are permitted.\n * If the path is a directory, `/package.json` is automatically appended.\n *\n * @param dirOrFilepath - An absolute path to either a directory containing `package.json` or the file itself.\n * @returns A promise resolving to the parsed {@link PackageJson} contents.\n *\n * @example\n * ```ts\n * const pkg = await readPackageJson(\"/path/to/my-package\");\n * console.log(pkg.name);\n * ```\n */\nexport const readPackageJson = async (\n  dirOrFilepath: string,\n): Promise<PackageJson> =>\n  jsonParse(await readFile(ensurePkgJsonPath(dirOrFilepath), \"utf8\"));\n\n/**\n * Reads and parses a `package.json` file synchronously.\n *\n * @remarks\n * Uses JSON5 for parsing, so comments and trailing commas are permitted.\n * If the path is a directory, `/package.json` is automatically appended.\n *\n * @param dirOrFilepath - An absolute path to either a directory containing `package.json` or the file itself.\n * @returns The parsed {@link PackageJson} contents.\n *\n * @example\n * ```ts\n * const pkg = readPackageJsonSync(\"/path/to/my-package\");\n * console.log(pkg.version);\n * ```\n */\nexport const readPackageJsonSync = (dirOrFilepath: string): PackageJson =>\n  jsonParse(readFileSync(ensurePkgJsonPath(dirOrFilepath), \"utf8\"));\n\n/**\n * Writes a {@link PackageJson} object to disk as formatted JSON.\n *\n * @remarks\n * The output is stringified via JSON5 and then formatted with the project's\n * standard JSON formatter before being written.\n *\n * @param jsonPath - The absolute file path to write the `package.json` to.\n * @param content - The package JSON content to serialize and write.\n * @returns A promise that resolves when the file has been written.\n */\nexport const writePackageJson = async (\n  jsonPath: string,\n  content: PackageJson,\n): Promise<void> =>\n  writeFile(\n    jsonPath,\n    await jsonStringify(content, JsonStringifyFormat.jsonStringify),\n  );\n\n/**\n * Ensures a path ends with `/package.json`.\n *\n * @remarks\n * If the path already ends with `/package.json` it is returned as-is;\n * otherwise `package.json` is appended via `path.join`.\n *\n * @param dirOrFilepath - A directory path or a path already pointing to `package.json`.\n * @returns The path guaranteed to end with `/package.json`.\n */\nexport const ensurePkgJsonPath = (dirOrFilepath: string): string =>\n  dirOrFilepath.endsWith(\"/package.json\")\n    ? dirOrFilepath\n    : join(dirOrFilepath, \"package.json\");\n"]}

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ export * from "./types.cleanup.js";
 export * from "./types.code.js";
 export * from "./types.deps.js";
 export * from "./types.documents.js";
+export * from "./types.exports.js";
 export * from "./types.git.js";
 export * from "./types.npm.js";
 export * from "./types.os.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/dist/types/index.js

@@ -5,6 +5,7 @@ export * from "./types.cleanup.js";
 export * from "./types.code.js";
 export * from "./types.deps.js";
 export * from "./types.documents.js";
+export * from "./types.exports.js";
 export * from "./types.git.js";
 export * from "./types.npm.js";
 export * from "./types.os.js";

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC","sourcesContent":["// This file is auto-generated for build-cli. Do not edit manually.\nexport * from \"./types.barrel.js\";\nexport * from \"./types.changelog.js\";\nexport * from \"./types.cleanup.js\";\nexport * from \"./types.code.js\";\nexport * from \"./types.deps.js\";\nexport * from \"./types.documents.js\";\nexport * from \"./types.git.js\";\nexport * from \"./types.npm.js\";\nexport * from \"./types.os.js\";\nexport * from \"./types.package.js\";\nexport * from \"./types.run.js\";\nexport * from \"./types.vscode.js\";\nexport * from \"./types.workspace.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC","sourcesContent":["// This file is auto-generated for build-cli. Do not edit manually.\nexport * from \"./types.barrel.js\";\nexport * from \"./types.changelog.js\";\nexport * from \"./types.cleanup.js\";\nexport * from \"./types.code.js\";\nexport * from \"./types.deps.js\";\nexport * from \"./types.documents.js\";\nexport * from \"./types.exports.js\";\nexport * from \"./types.git.js\";\nexport * from \"./types.npm.js\";\nexport * from \"./types.os.js\";\nexport * from \"./types.package.js\";\nexport * from \"./types.run.js\";\nexport * from \"./types.vscode.js\";\nexport * from \"./types.workspace.js\";\n"]}

package/dist/types/types.barrel.d.ts

@@ -1,24 +1,52 @@
 import type { Pkg } from "../pkg/Pkg.js";
 import { SourceFile } from "./types.code.js";
 import { RunRepoRootParams } from "./types.run.js";
+/**
+ * A group of files within a directory that share a common barrel file.
+ *
+ * @remarks
+ * Represents one directory's barrel-file context, including the files
+ * that should be re-exported and whether the barrel already exists on disk.
+ */
 export interface BarrelGroup {
+    /** Absolute path to the directory containing the barrel file. */
     dirPath: string;
+    /** Absolute path to the barrel (index) file itself. */
     barrelFilePath: string;
+    /** Whether the barrel file already exists on disk. */
     barrelExists: boolean;
+    /** List of file paths to be re-exported through the barrel. */
     files: string[];
+    /** The package that owns this barrel group. */
     pkg: Pkg;
 }
+/**
+ * The result of a barrel-file generation operation for a single package.
+ */
 export interface BarrelResult {
+    /** Directories in which barrel files were generated or updated. */
     barrelDirs: string[];
+    /** The package for which barrels were generated. */
     pkg: Pkg;
 }
+/**
+ * Parameters for running barrel-file generation across a repository.
+ */
 export interface BarrelParams extends RunRepoRootParams {
+    /** Regular expressions used to exclude files or directories from barrel generation. */
     excludes?: RegExp[];
+    /** A header comment to prepend to each generated barrel file. */
     fileHeader?: string;
+    /** When `true`, use the TypeScript Compiler API to resolve exports. */
     useCompilerApi?: boolean;
 }
+/**
+ * Parameters for persisting a barrel file to disk.
+ */
 export interface BarrelPersistParams {
+    /** The barrel group to persist. */
     group: BarrelGroup;
+    /** Optional pre-built source-file map to avoid redundant parsing. */
     sourceFileMap?: Map<string, SourceFile>;
 }
 //# sourceMappingURL=types.barrel.d.ts.map

package/dist/types/types.barrel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.barrel.d.ts","sourceRoot":"","sources":["../../src/types/types.barrel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,GAAG,CAAC;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,EAAE,GAAG,CAAC;CACV;AAED,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACzC"}
+{"version":3,"file":"types.barrel.d.ts","sourceRoot":"","sources":["../../src/types/types.barrel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+CAA+C;IAC/C,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oDAAoD;IACpD,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,qEAAqE;IACrE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACzC"}

package/dist/types/types.barrel.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.barrel.js","sourceRoot":"","sources":["../../src/types/types.barrel.ts"],"names":[],"mappings":"","sourcesContent":["import type { Pkg } from \"../pkg/Pkg.js\";\nimport { SourceFile } from \"./types.code.js\";\nimport { RunRepoRootParams } from \"./types.run.js\";\n\nexport interface BarrelGroup {\n  dirPath: string;\n  barrelFilePath: string;\n  barrelExists: boolean;\n  files: string[];\n  pkg: Pkg;\n}\n\nexport interface BarrelResult {\n  barrelDirs: string[];\n  pkg: Pkg;\n}\n\nexport interface BarrelParams extends RunRepoRootParams {\n  excludes?: RegExp[];\n  fileHeader?: string;\n  useCompilerApi?: boolean;\n}\n\nexport interface BarrelPersistParams {\n  group: BarrelGroup;\n  sourceFileMap?: Map<string, SourceFile>;\n}\n"]}
+{"version":3,"file":"types.barrel.js","sourceRoot":"","sources":["../../src/types/types.barrel.ts"],"names":[],"mappings":"","sourcesContent":["import type { Pkg } from \"../pkg/Pkg.js\";\nimport { SourceFile } from \"./types.code.js\";\nimport { RunRepoRootParams } from \"./types.run.js\";\n\n/**\n * A group of files within a directory that share a common barrel file.\n *\n * @remarks\n * Represents one directory's barrel-file context, including the files\n * that should be re-exported and whether the barrel already exists on disk.\n */\nexport interface BarrelGroup {\n  /** Absolute path to the directory containing the barrel file. */\n  dirPath: string;\n  /** Absolute path to the barrel (index) file itself. */\n  barrelFilePath: string;\n  /** Whether the barrel file already exists on disk. */\n  barrelExists: boolean;\n  /** List of file paths to be re-exported through the barrel. */\n  files: string[];\n  /** The package that owns this barrel group. */\n  pkg: Pkg;\n}\n\n/**\n * The result of a barrel-file generation operation for a single package.\n */\nexport interface BarrelResult {\n  /** Directories in which barrel files were generated or updated. */\n  barrelDirs: string[];\n  /** The package for which barrels were generated. */\n  pkg: Pkg;\n}\n\n/**\n * Parameters for running barrel-file generation across a repository.\n */\nexport interface BarrelParams extends RunRepoRootParams {\n  /** Regular expressions used to exclude files or directories from barrel generation. */\n  excludes?: RegExp[];\n  /** A header comment to prepend to each generated barrel file. */\n  fileHeader?: string;\n  /** When `true`, use the TypeScript Compiler API to resolve exports. */\n  useCompilerApi?: boolean;\n}\n\n/**\n * Parameters for persisting a barrel file to disk.\n */\nexport interface BarrelPersistParams {\n  /** The barrel group to persist. */\n  group: BarrelGroup;\n  /** Optional pre-built source-file map to avoid redundant parsing. */\n  sourceFileMap?: Map<string, SourceFile>;\n}\n"]}