@mxpicture/build-api 0.2.55 → 0.2.57

package/dist/barrel/Barrel.d.ts

@@ -1,13 +1,79 @@
 import { BarrelGroup, BarrelParams, BarrelPersistParams, BarrelResult } from "../types/types.barrel.js";
 import { Pkg } from "../pkg/Pkg.js";
+/**
+ * Default file patterns excluded from barrel exports.
+ *
+ * @remarks
+ * Matches test files, declaration files, existing barrel index files,
+ * script directories, and `4testing` helper directories so they are
+ * never re-exported in generated barrel files.
+ */
 export declare const DEFAULT_EXCLUDED_PATTERNS: RegExp[];
+/**
+ * Header comment prepended to every generated barrel file.
+ *
+ * @remarks
+ * Warns consumers that the file is auto-generated and should not be
+ * edited by hand.
+ */
 export declare const DEFAULT_HEADER = "// This file is auto-generated by build-cli. Do not edit manually.\n";
+/**
+ * Run barrel-file generation for every package in the workspace.
+ *
+ * @remarks
+ * This is the main entry point for the barrel command. It initialises the
+ * workspace, then delegates to the {@link Barrel} class to collect source
+ * files and write barrel (index) files.
+ *
+ * @param params - Configuration for the barrel generation run.
+ * @returns A promise that resolves when all barrel files have been written.
+ *
+ * @example
+ * ```ts
+ * import { runBarrel } from "@mxpicture/build-api";
+ *
+ * await runBarrel({ repoRoot: process.cwd() });
+ * ```
+ */
 export declare const runBarrel: (params: BarrelParams) => Promise<void>;
+/**
+ * Generates and maintains barrel (index) files for workspace packages.
+ *
+ * @remarks
+ * The generation is split into two phases:
+ *
+ * 1. **Collect** – recursively scan each package's `src` directory to build
+ *    {@link BarrelGroup} instances that describe which files belong together.
+ * 2. **Build & Persist** – optionally create a TypeScript `SourceFile` map for
+ *    selective exports, then write every barrel file to disk in parallel.
+ *
+ * After barrels are written the class also updates each package's
+ * `package.json` exports map when the set of entry-points has changed.
+ */
 export declare class Barrel {
     protected readonly excludes: RegExp[];
     protected readonly fileHeader: string;
     protected readonly selectiveExport: boolean;
+    /**
+     * Create a new Barrel generator.
+     *
+     * @param excludes - Regular expressions that match file paths to skip.
+     * @param fileHeader - Comment block prepended to every generated barrel file.
+     * @param selectiveExport - When `true`, use the TypeScript Compiler API
+     *   to emit named exports instead of wildcard re-exports.
+     */
     constructor(excludes: RegExp[], fileHeader: string, selectiveExport: boolean);
+    /**
+     * Execute barrel generation for all packages in the current workspace.
+     *
+     * @remarks
+     * Reads the workspace, collects barrel groups per package, then builds
+     * and persists every barrel file. Package `exports` fields are updated
+     * when the set of entry-points changes.
+     *
+     * @returns A promise that resolves when all barrel files have been written
+     *   and all `package.json` exports have been updated.
+     */
     run(): Promise<void>;
     protected isExcluded(fileName: string): boolean;
     protected persistBarrel(p: BarrelPersistParams): Promise<BarrelGroup>;

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

@@ -1 +1 @@
-{"version":3,"file":"Barrel.d.ts","sourceRoot":"","sources":["../../src/barrel/Barrel.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAYpC,eAAO,MAAM,yBAAyB,EAAE,MAAM,EAQ7C,CAAC;AAGF,eAAO,MAAM,cAAc,yEAC6C,CAAC;AAEzE,eAAO,MAAM,SAAS,GAAU,QAAQ,YAAY,kBAOnD,CAAC;AAEF,qBAAa,MAAM;IAEf,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IACrC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM;IACrC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO;gBAFxB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,OAAO;IAGhC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;cAI/B,aAAa,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA4C3E;;;;OAIG;cACa,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;cAmBH,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;cAsClD,aAAa,CAC3B,QAAQ,EAAE,GAAG,EAAE,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;cAiBtB,oBAAoB,CAClC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAoBjC,SAAS,CAAC,iBAAiB,CACzB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACpC,OAAO;IAcV,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAUtD,eAAe,CAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;CA+EjB"}
+{"version":3,"file":"Barrel.d.ts","sourceRoot":"","sources":["../../src/barrel/Barrel.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AASpC;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,EAQ7C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,yEAC6C,CAAC;AAEzE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GAAU,QAAQ,YAAY,kBAOnD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,qBAAa,MAAM;IAUf,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IACrC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM;IACrC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO;IAX7C;;;;;;;OAOG;gBAEkB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,OAAO;IAG7C;;;;;;;;;;OAUG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;cAI/B,aAAa,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA4C3E;;;;OAIG;cACa,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;cAmBH,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;cAsClD,aAAa,CAC3B,QAAQ,EAAE,GAAG,EAAE,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;cAiBtB,oBAAoB,CAClC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAoBjC,SAAS,CAAC,iBAAiB,CACzB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACpC,OAAO;IAcV,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAUtD,eAAe,CAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;CA+EjB"}

package/dist/barrel/Barrel.js

@@ -5,8 +5,14 @@ import { initWorkspace, workspace } from "../workspace/Workspace.js";
 import { formatCode } from "../code/code.format.js";
 import { fileExportsByFile, fileExportsCompilerApi, } from "../code/code.exports.js";
 import { createSourceFileMap } from "../code/code.common.js";
-// todo restore old version only using "export *" --> make both available
-// /** File patterns to exclude from barrel exports */
+/**
+ * Default file patterns excluded from barrel exports.
+ *
+ * @remarks
+ * Matches test files, declaration files, existing barrel index files,
+ * script directories, and `4testing` helper directories so they are
+ * never re-exported in generated barrel files.
+ */
 export const DEFAULT_EXCLUDED_PATTERNS = [
     /\.test\.ts$/,
     /\.spec\.ts$/,
@@ -16,21 +22,78 @@ export const DEFAULT_EXCLUDED_PATTERNS = [
     /(.+\/|^)src\/(.+\/|)scripts?\/.+\.m?ts$/,
     /\/4testing(\/|$)/,
 ];
-// /** Header comment added to every generated barrel file */
+/**
+ * Header comment prepended to every generated barrel file.
+ *
+ * @remarks
+ * Warns consumers that the file is auto-generated and should not be
+ * edited by hand.
+ */
 export const DEFAULT_HEADER = "// This file is auto-generated by build-cli. Do not edit manually.\n";
+/**
+ * Run barrel-file generation for every package in the workspace.
+ *
+ * @remarks
+ * This is the main entry point for the barrel command. It initialises the
+ * workspace, then delegates to the {@link Barrel} class to collect source
+ * files and write barrel (index) files.
+ *
+ * @param params - Configuration for the barrel generation run.
+ * @returns A promise that resolves when all barrel files have been written.
+ *
+ * @example
+ * ```ts
+ * import { runBarrel } from "@mxpicture/build-api";
+ *
+ * await runBarrel({ repoRoot: process.cwd() });
+ * ```
+ */
 export const runBarrel = async (params) => {
     initWorkspace(params.repoRoot);
     return new Barrel(params.excludes ?? DEFAULT_EXCLUDED_PATTERNS, params.fileHeader ?? DEFAULT_HEADER, !!params.useCompilerApi).run();
 };
+/**
+ * Generates and maintains barrel (index) files for workspace packages.
+ *
+ * @remarks
+ * The generation is split into two phases:
+ *
+ * 1. **Collect** – recursively scan each package's `src` directory to build
+ *    {@link BarrelGroup} instances that describe which files belong together.
+ * 2. **Build & Persist** – optionally create a TypeScript `SourceFile` map for
+ *    selective exports, then write every barrel file to disk in parallel.
+ *
+ * After barrels are written the class also updates each package's
+ * `package.json` exports map when the set of entry-points has changed.
+ */
 export class Barrel {
     excludes;
     fileHeader;
     selectiveExport;
+    /**
+     * Create a new Barrel generator.
+     *
+     * @param excludes - Regular expressions that match file paths to skip.
+     * @param fileHeader - Comment block prepended to every generated barrel file.
+     * @param selectiveExport - When `true`, use the TypeScript Compiler API
+     *   to emit named exports instead of wildcard re-exports.
+     */
     constructor(excludes, fileHeader, selectiveExport) {
         this.excludes = excludes;
         this.fileHeader = fileHeader;
         this.selectiveExport = selectiveExport;
     }
+    /**
+     * Execute barrel generation for all packages in the current workspace.
+     *
+     * @remarks
+     * Reads the workspace, collects barrel groups per package, then builds
+     * and persists every barrel file. Package `exports` fields are updated
+     * when the set of entry-points changes.
+     *
+     * @returns A promise that resolves when all barrel files have been written
+     *   and all `package.json` exports have been updated.
+     */
     async run() {
         const ws = workspace();
         await ws.read();

package/dist/barrel/Barrel.js.map

@@ -1 +1 @@
-{"version":3,"file":"Barrel.js","sourceRoot":"","sources":["../../src/barrel/Barrel.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename, dirname, join, relative } from \"node:path\";\nimport {\n  BarrelGroup,\n  BarrelParams,\n  BarrelPersistParams,\n  BarrelResult,\n} from \"../types/types.barrel.js\";\nimport { readdir, rm, stat, writeFile } from \"node:fs/promises\";\nimport { logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\nimport { Pkg } from \"../pkg/Pkg.js\";\nimport { formatCode } from \"../code/code.format.js\";\nimport {\n  fileExportsByFile,\n  fileExportsCompilerApi,\n} from \"../code/code.exports.js\";\nimport { createSourceFileMap } from \"../code/code.common.js\";\nimport { FileExportsParams, SourceFile } from \"../types/types.code.js\";\n\n// todo restore old version only using \"export *\" --> make both available\n\n// /** File patterns to exclude from barrel exports */\nexport const DEFAULT_EXCLUDED_PATTERNS: RegExp[] = [\n  /\\.test\\.ts$/,\n  /\\.spec\\.ts$/,\n  /(^|\\/)__tests__(\\/|$)/,\n  /\\.d\\.ts$/,\n  /index\\.ts$/,\n  /(.+\\/|^)src\\/(.+\\/|)scripts?\\/.+\\.m?ts$/,\n  /\\/4testing(\\/|$)/,\n];\n\n// /** Header comment added to every generated barrel file */\nexport const DEFAULT_HEADER =\n  \"// This file is auto-generated by build-cli. Do not edit manually.\\n\";\n\nexport const runBarrel = async (params: BarrelParams) => {\n  initWorkspace(params.repoRoot);\n  return new Barrel(\n    params.excludes ?? DEFAULT_EXCLUDED_PATTERNS,\n    params.fileHeader ?? DEFAULT_HEADER,\n    !!params.useCompilerApi,\n  ).run();\n};\n\nexport class Barrel {\n  public constructor(\n    protected readonly excludes: RegExp[],\n    protected readonly fileHeader: string,\n    protected readonly selectiveExport: boolean,\n  ) {}\n\n  public async run(): Promise<void> {\n    const ws = workspace();\n    await ws.read();\n\n    // Phase 1: collect all barrel groups, keyed by package name\n    const groupsByPkg = await this.collectGroups(ws.packages);\n\n    // todo Phase 1.5: find changed files\n\n    // Phase 2: build one ts.Program per package, then persist all groups in parallel\n    await this.buildAndPersist(groupsByPkg);\n  }\n\n  protected isExcluded(fileName: string): boolean {\n    return this.excludes.some((pattern) => pattern.test(fileName));\n  }\n\n  protected async persistBarrel(p: BarrelPersistParams): Promise<BarrelGroup> {\n    // no files --> skip/delete index.ts\n    if (p.group.files.length === 0) {\n      await rm(p.group.barrelFilePath, { recursive: true, force: true });\n      return p.group;\n    }\n\n    // todo Skip if all source files are older than the existing barrel\n    // if (!(await this.hasGroupChanged(group, group.barrelFilePath)))\n    //   return group;\n\n    const exportLines: string[] = [];\n    for (const file of p.group.files.sort()) {\n      const filePath = join(p.group.dirPath, file);\n\n      const params: FileExportsParams = {\n        filePath,\n        preBuiltSource: p.sourceFileMap?.get(filePath),\n      };\n\n      const expResult = this.selectiveExport\n        ? fileExportsCompilerApi(params)\n        : fileExportsByFile(params);\n\n      if (expResult.selectiveExport && expResult.items.length === 0) continue;\n\n      const exports = expResult.items.map((item) => item.name);\n      const moduleRef = `./${basename(file, \".ts\")}.js`;\n\n      if (!expResult.selectiveExport) {\n        exportLines.push(`export * from \"${moduleRef}\";`);\n      } else if (exports.length > 0) {\n        exportLines.push(\n          `export { ${exports.join(\", \")} } from \"${moduleRef}\";`,\n        );\n      }\n    }\n\n    let content = `${this.fileHeader}${exportLines.length > 0 ? exportLines.join(\"\\n\") + \"\\n\" : \"\"}`;\n    content = await formatCode(content);\n    await writeFile(p.group.barrelFilePath, content);\n    return p.group;\n  }\n\n  /**\n   * Returns true if any source file in the group is newer than the barrel\n   * file, or if the barrel file does not yet exist. File deletions are handled\n   * implicitly because the group is rebuilt from readdir on every run.\n   */\n  protected async hasGroupChanged(\n    group: BarrelGroup,\n    barrelPath: string,\n  ): Promise<boolean> {\n    let barrelMtime: number;\n    try {\n      barrelMtime = (await stat(barrelPath)).mtimeMs;\n    } catch {\n      return true; // barrel doesn't exist yet\n    }\n\n    for (const file of group.files) {\n      try {\n        const fileMtime = (await stat(join(group.dirPath, file))).mtimeMs;\n        if (fileMtime > barrelMtime) return true;\n      } catch {\n        return true; // file accessibility changed\n      }\n    }\n    return false;\n  }\n\n  protected async collectPkgGroups(pkg: Pkg): Promise<BarrelGroup[]> {\n    const items = (await readdir(pkg.srcPath, { recursive: true })).sort();\n    const groups: BarrelGroup[] = [];\n    let currentGroup: BarrelGroup | undefined;\n\n    const pushGroup = (g: BarrelGroup) => groups.push({ ...g });\n\n    for (const item of items) {\n      const filename = basename(item);\n      const dirPath = join(pkg.srcPath, dirname(item));\n      const filePath = join(dirPath, filename);\n\n      if (dirPath !== currentGroup?.dirPath) {\n        if (currentGroup) pushGroup(currentGroup);\n        currentGroup = {\n          dirPath,\n          files: [],\n          pkg,\n          barrelFilePath: join(dirPath, \"index.ts\"),\n          barrelExists: false,\n        };\n      }\n\n      if (filename === \"index.ts\") currentGroup.barrelExists = true;\n\n      if (\n        this.isExcluded(filePath) ||\n        (!filename.endsWith(\".ts\") && !filename.endsWith(\".mts\"))\n      )\n        continue;\n\n      currentGroup.files.push(filename);\n    }\n\n    if (currentGroup) pushGroup(currentGroup);\n    return groups;\n  }\n\n  protected async collectGroups(\n    packages: Pkg[],\n  ): Promise<Map<string, BarrelGroup[]>> {\n    const groupsByPkg = new Map<string, BarrelGroup[]>();\n\n    const pushGroup = (g: BarrelGroup) => {\n      const key = g.pkg.content.name;\n      if (!groupsByPkg.has(key)) groupsByPkg.set(key, []);\n      groupsByPkg.get(key)!.push({ ...g });\n    };\n\n    const results = (\n      await Promise.all(packages.map((pkg) => this.collectPkgGroups(pkg)))\n    ).flat();\n\n    results.map(pushGroup);\n    return groupsByPkg;\n  }\n\n  protected async updatePackageExports(\n    pkg: Pkg,\n    exports: Record<string, string>,\n  ) {\n    try {\n      // const pkgName = relative(this.paths.workspacesDir, packageDir);\n      // // const pkgs = await workspace().loadPackages();\n\n      logInfo(`📦 updating ${pkg.repoDirPath} package.json ...`);\n      // const pkg = await readPackageJsonThrow(packageJsonPath);\n      if (!this.hasExportsChanged(exports, pkg.content.exports)) {\n        logInfo(`🧹 No changes in ${pkg.repoDirPath}, nothing to do`);\n        return;\n      }\n      pkg.content.exports = { ...exports };\n      await pkg.write();\n      logSuccess(`✅ ${pkg.repoDirPath} update successful`);\n    } catch (error) {\n      logInfo(error);\n    }\n  }\n\n  protected hasExportsChanged(\n    a: Record<string, string> | undefined,\n    b: Record<string, string> | undefined,\n  ): boolean {\n    if (!a) a = {};\n    if (!b) b = {};\n\n    if (Object.keys(a).length !== Object.keys(b).length) return true;\n    if (!a && !b) return false;\n    if (!a || !b) return true;\n\n    for (const entryA of Object.entries(a)) {\n      if (b[entryA[0]] !== entryA[1]) return true;\n    }\n    return false;\n  }\n\n  protected extractExports(result: BarrelResult): Record<string, string> {\n    const record: Record<string, string> = {};\n    for (const barrelDir of result.barrelDirs) {\n      const ex = relative(result.pkg.srcPath, barrelDir);\n      record[`./${ex}`] = `./dist/${ex}/index.js`;\n    }\n    record[\"./package.json\"] = \"./package.json\";\n    return record;\n  }\n\n  protected async buildAndPersist(\n    groupsByPkg: Map<string, BarrelGroup[]>,\n  ): Promise<void> {\n    const promises: Promise<BarrelGroup>[] = [];\n\n    for (const groups of groupsByPkg.values()) {\n      const allFilePaths = groups.flatMap((g) =>\n        g.files.map((f) => join(g.dirPath, f)),\n      );\n\n      const sourceFileMap: Map<string, SourceFile> | undefined = !this\n        .selectiveExport\n        ? undefined\n        : allFilePaths.length > 0\n          ? createSourceFileMap(allFilePaths)\n          : new Map<string, SourceFile>();\n\n      for (const group of groups) {\n        promises.push(\n          this.persistBarrel({ group: { ...group }, sourceFileMap }),\n        );\n      }\n    }\n\n    const barrelGroups = (await Promise.all(promises)).filter(\n      (prom) => prom.files.length > 0,\n    );\n\n    const results: BarrelResult[] = [];\n\n    for (const barrelGroup of barrelGroups) {\n      let found = results.find(\n        (res) => barrelGroup.dirPath === res.pkg.dirPath,\n      );\n      if (!found) {\n        found = {\n          barrelDirs: [],\n          pkg: barrelGroup.pkg,\n        };\n        results.push(found);\n      }\n\n      found.barrelDirs.push(barrelGroup.dirPath);\n    }\n\n    const pkgExps: Record<string, { pkg: Pkg; exps: Record<string, string> }> =\n      {};\n    for (const res of results) {\n      if (!(res.pkg.content.name in pkgExps))\n        pkgExps[res.pkg.content.name] = { pkg: res.pkg, exps: {} };\n\n      pkgExps[res.pkg.content.name].exps = {\n        ...pkgExps[res.pkg.content.name].exps,\n        ...this.extractExports(res),\n      };\n    }\n\n    await Promise.all(\n      Object.values(pkgExps).map(async (pkgExp) =>\n        this.updatePackageExports(pkgExp.pkg, pkgExp.exps),\n      ),\n    );\n  }\n\n  // protected async persistBarrel(p: BarrelPersistParams): Promise<BarrelGroup> {\n  //   const barrelPath = join(p.group.dirPath, \"index.ts\");\n  //   // no files --> skip/delete index.ts\n  //   if (p.group.files.length === 0) {\n  //     await rm(barrelPath, { recursive: true, force: true });\n  //     return p.group;\n  //   }\n\n  //   let content = `${this.fileHeader}${p.group.files\n  //     .sort()\n  //     .map((f) => `export * from \"./${basename(f, \".ts\")}.js\";`)\n  //     .join(\"\\n\")}\\n`;\n\n  //   content = await formatCode(content);\n  //   await writeFile(barrelPath, content);\n  //   return p.group;\n  // }\n}\n"]}
+{"version":3,"file":"Barrel.js","sourceRoot":"","sources":["../../src/barrel/Barrel.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename, dirname, join, relative } from \"node:path\";\nimport {\n  BarrelGroup,\n  BarrelParams,\n  BarrelPersistParams,\n  BarrelResult,\n} from \"../types/types.barrel.js\";\nimport { readdir, rm, stat, writeFile } from \"node:fs/promises\";\nimport { logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\nimport { Pkg } from \"../pkg/Pkg.js\";\nimport { formatCode } from \"../code/code.format.js\";\nimport {\n  fileExportsByFile,\n  fileExportsCompilerApi,\n} from \"../code/code.exports.js\";\nimport { createSourceFileMap } from \"../code/code.common.js\";\nimport { FileExportsParams, SourceFile } from \"../types/types.code.js\";\n\n/**\n * Default file patterns excluded from barrel exports.\n *\n * @remarks\n * Matches test files, declaration files, existing barrel index files,\n * script directories, and `4testing` helper directories so they are\n * never re-exported in generated barrel files.\n */\nexport const DEFAULT_EXCLUDED_PATTERNS: RegExp[] = [\n  /\\.test\\.ts$/,\n  /\\.spec\\.ts$/,\n  /(^|\\/)__tests__(\\/|$)/,\n  /\\.d\\.ts$/,\n  /index\\.ts$/,\n  /(.+\\/|^)src\\/(.+\\/|)scripts?\\/.+\\.m?ts$/,\n  /\\/4testing(\\/|$)/,\n];\n\n/**\n * Header comment prepended to every generated barrel file.\n *\n * @remarks\n * Warns consumers that the file is auto-generated and should not be\n * edited by hand.\n */\nexport const DEFAULT_HEADER =\n  \"// This file is auto-generated by build-cli. Do not edit manually.\\n\";\n\n/**\n * Run barrel-file generation for every package in the workspace.\n *\n * @remarks\n * This is the main entry point for the barrel command. It initialises the\n * workspace, then delegates to the {@link Barrel} class to collect source\n * files and write barrel (index) files.\n *\n * @param params - Configuration for the barrel generation run.\n * @returns A promise that resolves when all barrel files have been written.\n *\n * @example\n * ```ts\n * import { runBarrel } from \"@mxpicture/build-api\";\n *\n * await runBarrel({ repoRoot: process.cwd() });\n * ```\n */\nexport const runBarrel = async (params: BarrelParams) => {\n  initWorkspace(params.repoRoot);\n  return new Barrel(\n    params.excludes ?? DEFAULT_EXCLUDED_PATTERNS,\n    params.fileHeader ?? DEFAULT_HEADER,\n    !!params.useCompilerApi,\n  ).run();\n};\n\n/**\n * Generates and maintains barrel (index) files for workspace packages.\n *\n * @remarks\n * The generation is split into two phases:\n *\n * 1. **Collect** – recursively scan each package's `src` directory to build\n *    {@link BarrelGroup} instances that describe which files belong together.\n * 2. **Build & Persist** – optionally create a TypeScript `SourceFile` map for\n *    selective exports, then write every barrel file to disk in parallel.\n *\n * After barrels are written the class also updates each package's\n * `package.json` exports map when the set of entry-points has changed.\n */\nexport class Barrel {\n  /**\n   * Create a new Barrel generator.\n   *\n   * @param excludes - Regular expressions that match file paths to skip.\n   * @param fileHeader - Comment block prepended to every generated barrel file.\n   * @param selectiveExport - When `true`, use the TypeScript Compiler API\n   *   to emit named exports instead of wildcard re-exports.\n   */\n  public constructor(\n    protected readonly excludes: RegExp[],\n    protected readonly fileHeader: string,\n    protected readonly selectiveExport: boolean,\n  ) {}\n\n  /**\n   * Execute barrel generation for all packages in the current workspace.\n   *\n   * @remarks\n   * Reads the workspace, collects barrel groups per package, then builds\n   * and persists every barrel file. Package `exports` fields are updated\n   * when the set of entry-points changes.\n   *\n   * @returns A promise that resolves when all barrel files have been written\n   *   and all `package.json` exports have been updated.\n   */\n  public async run(): Promise<void> {\n    const ws = workspace();\n    await ws.read();\n\n    // Phase 1: collect all barrel groups, keyed by package name\n    const groupsByPkg = await this.collectGroups(ws.packages);\n\n    // todo Phase 1.5: find changed files\n\n    // Phase 2: build one ts.Program per package, then persist all groups in parallel\n    await this.buildAndPersist(groupsByPkg);\n  }\n\n  protected isExcluded(fileName: string): boolean {\n    return this.excludes.some((pattern) => pattern.test(fileName));\n  }\n\n  protected async persistBarrel(p: BarrelPersistParams): Promise<BarrelGroup> {\n    // no files --> skip/delete index.ts\n    if (p.group.files.length === 0) {\n      await rm(p.group.barrelFilePath, { recursive: true, force: true });\n      return p.group;\n    }\n\n    // todo Skip if all source files are older than the existing barrel\n    // if (!(await this.hasGroupChanged(group, group.barrelFilePath)))\n    //   return group;\n\n    const exportLines: string[] = [];\n    for (const file of p.group.files.sort()) {\n      const filePath = join(p.group.dirPath, file);\n\n      const params: FileExportsParams = {\n        filePath,\n        preBuiltSource: p.sourceFileMap?.get(filePath),\n      };\n\n      const expResult = this.selectiveExport\n        ? fileExportsCompilerApi(params)\n        : fileExportsByFile(params);\n\n      if (expResult.selectiveExport && expResult.items.length === 0) continue;\n\n      const exports = expResult.items.map((item) => item.name);\n      const moduleRef = `./${basename(file, \".ts\")}.js`;\n\n      if (!expResult.selectiveExport) {\n        exportLines.push(`export * from \"${moduleRef}\";`);\n      } else if (exports.length > 0) {\n        exportLines.push(\n          `export { ${exports.join(\", \")} } from \"${moduleRef}\";`,\n        );\n      }\n    }\n\n    let content = `${this.fileHeader}${exportLines.length > 0 ? exportLines.join(\"\\n\") + \"\\n\" : \"\"}`;\n    content = await formatCode(content);\n    await writeFile(p.group.barrelFilePath, content);\n    return p.group;\n  }\n\n  /**\n   * Returns true if any source file in the group is newer than the barrel\n   * file, or if the barrel file does not yet exist. File deletions are handled\n   * implicitly because the group is rebuilt from readdir on every run.\n   */\n  protected async hasGroupChanged(\n    group: BarrelGroup,\n    barrelPath: string,\n  ): Promise<boolean> {\n    let barrelMtime: number;\n    try {\n      barrelMtime = (await stat(barrelPath)).mtimeMs;\n    } catch {\n      return true; // barrel doesn't exist yet\n    }\n\n    for (const file of group.files) {\n      try {\n        const fileMtime = (await stat(join(group.dirPath, file))).mtimeMs;\n        if (fileMtime > barrelMtime) return true;\n      } catch {\n        return true; // file accessibility changed\n      }\n    }\n    return false;\n  }\n\n  protected async collectPkgGroups(pkg: Pkg): Promise<BarrelGroup[]> {\n    const items = (await readdir(pkg.srcPath, { recursive: true })).sort();\n    const groups: BarrelGroup[] = [];\n    let currentGroup: BarrelGroup | undefined;\n\n    const pushGroup = (g: BarrelGroup) => groups.push({ ...g });\n\n    for (const item of items) {\n      const filename = basename(item);\n      const dirPath = join(pkg.srcPath, dirname(item));\n      const filePath = join(dirPath, filename);\n\n      if (dirPath !== currentGroup?.dirPath) {\n        if (currentGroup) pushGroup(currentGroup);\n        currentGroup = {\n          dirPath,\n          files: [],\n          pkg,\n          barrelFilePath: join(dirPath, \"index.ts\"),\n          barrelExists: false,\n        };\n      }\n\n      if (filename === \"index.ts\") currentGroup.barrelExists = true;\n\n      if (\n        this.isExcluded(filePath) ||\n        (!filename.endsWith(\".ts\") && !filename.endsWith(\".mts\"))\n      )\n        continue;\n\n      currentGroup.files.push(filename);\n    }\n\n    if (currentGroup) pushGroup(currentGroup);\n    return groups;\n  }\n\n  protected async collectGroups(\n    packages: Pkg[],\n  ): Promise<Map<string, BarrelGroup[]>> {\n    const groupsByPkg = new Map<string, BarrelGroup[]>();\n\n    const pushGroup = (g: BarrelGroup) => {\n      const key = g.pkg.content.name;\n      if (!groupsByPkg.has(key)) groupsByPkg.set(key, []);\n      groupsByPkg.get(key)!.push({ ...g });\n    };\n\n    const results = (\n      await Promise.all(packages.map((pkg) => this.collectPkgGroups(pkg)))\n    ).flat();\n\n    results.map(pushGroup);\n    return groupsByPkg;\n  }\n\n  protected async updatePackageExports(\n    pkg: Pkg,\n    exports: Record<string, string>,\n  ) {\n    try {\n      // const pkgName = relative(this.paths.workspacesDir, packageDir);\n      // // const pkgs = await workspace().loadPackages();\n\n      logInfo(`📦 updating ${pkg.repoDirPath} package.json ...`);\n      // const pkg = await readPackageJsonThrow(packageJsonPath);\n      if (!this.hasExportsChanged(exports, pkg.content.exports)) {\n        logInfo(`🧹 No changes in ${pkg.repoDirPath}, nothing to do`);\n        return;\n      }\n      pkg.content.exports = { ...exports };\n      await pkg.write();\n      logSuccess(`✅ ${pkg.repoDirPath} update successful`);\n    } catch (error) {\n      logInfo(error);\n    }\n  }\n\n  protected hasExportsChanged(\n    a: Record<string, string> | undefined,\n    b: Record<string, string> | undefined,\n  ): boolean {\n    if (!a) a = {};\n    if (!b) b = {};\n\n    if (Object.keys(a).length !== Object.keys(b).length) return true;\n    if (!a && !b) return false;\n    if (!a || !b) return true;\n\n    for (const entryA of Object.entries(a)) {\n      if (b[entryA[0]] !== entryA[1]) return true;\n    }\n    return false;\n  }\n\n  protected extractExports(result: BarrelResult): Record<string, string> {\n    const record: Record<string, string> = {};\n    for (const barrelDir of result.barrelDirs) {\n      const ex = relative(result.pkg.srcPath, barrelDir);\n      record[`./${ex}`] = `./dist/${ex}/index.js`;\n    }\n    record[\"./package.json\"] = \"./package.json\";\n    return record;\n  }\n\n  protected async buildAndPersist(\n    groupsByPkg: Map<string, BarrelGroup[]>,\n  ): Promise<void> {\n    const promises: Promise<BarrelGroup>[] = [];\n\n    for (const groups of groupsByPkg.values()) {\n      const allFilePaths = groups.flatMap((g) =>\n        g.files.map((f) => join(g.dirPath, f)),\n      );\n\n      const sourceFileMap: Map<string, SourceFile> | undefined = !this\n        .selectiveExport\n        ? undefined\n        : allFilePaths.length > 0\n          ? createSourceFileMap(allFilePaths)\n          : new Map<string, SourceFile>();\n\n      for (const group of groups) {\n        promises.push(\n          this.persistBarrel({ group: { ...group }, sourceFileMap }),\n        );\n      }\n    }\n\n    const barrelGroups = (await Promise.all(promises)).filter(\n      (prom) => prom.files.length > 0,\n    );\n\n    const results: BarrelResult[] = [];\n\n    for (const barrelGroup of barrelGroups) {\n      let found = results.find(\n        (res) => barrelGroup.dirPath === res.pkg.dirPath,\n      );\n      if (!found) {\n        found = {\n          barrelDirs: [],\n          pkg: barrelGroup.pkg,\n        };\n        results.push(found);\n      }\n\n      found.barrelDirs.push(barrelGroup.dirPath);\n    }\n\n    const pkgExps: Record<string, { pkg: Pkg; exps: Record<string, string> }> =\n      {};\n    for (const res of results) {\n      if (!(res.pkg.content.name in pkgExps))\n        pkgExps[res.pkg.content.name] = { pkg: res.pkg, exps: {} };\n\n      pkgExps[res.pkg.content.name].exps = {\n        ...pkgExps[res.pkg.content.name].exps,\n        ...this.extractExports(res),\n      };\n    }\n\n    await Promise.all(\n      Object.values(pkgExps).map(async (pkgExp) =>\n        this.updatePackageExports(pkgExp.pkg, pkgExp.exps),\n      ),\n    );\n  }\n\n  // protected async persistBarrel(p: BarrelPersistParams): Promise<BarrelGroup> {\n  //   const barrelPath = join(p.group.dirPath, \"index.ts\");\n  //   // no files --> skip/delete index.ts\n  //   if (p.group.files.length === 0) {\n  //     await rm(barrelPath, { recursive: true, force: true });\n  //     return p.group;\n  //   }\n\n  //   let content = `${this.fileHeader}${p.group.files\n  //     .sort()\n  //     .map((f) => `export * from \"./${basename(f, \".ts\")}.js\";`)\n  //     .join(\"\\n\")}\\n`;\n\n  //   content = await formatCode(content);\n  //   await writeFile(barrelPath, content);\n  //   return p.group;\n  // }\n}\n"]}

package/dist/cleanup/Cleanup.d.ts

@@ -1,11 +1,81 @@
 import { CleanupParams, ToBeDeleted, ToCleanup } from "../types/types.cleanup.js";
+/**
+ * Run the cleanup operation across all workspace packages.
+ *
+ * @remarks
+ * This is the main entry point for the cleanup command. It initialises the
+ * workspace, then delegates to the {@link Cleanup} class to resolve and
+ * remove the configured targets.
+ *
+ * @param params - Configuration for the cleanup run, including which items
+ *   to delete and the repository root path.
+ * @returns A promise that resolves when all items have been cleaned up.
+ *
+ * @example
+ * ```ts
+ * import { runCleanup } from "@mxpicture/build-api";
+ *
+ * await runCleanup({ repoRoot: process.cwd() });
+ * ```
+ */
 export declare const runCleanup: (params: CleanupParams) => Promise<void>;
+/**
+ * Removes build artifacts and temporary directories from workspace packages.
+ *
+ * @remarks
+ * For each configured target the class supports two strategies:
+ *
+ * - **Direct removal** – delete the item immediately via `rm -rf`.
+ * - **Move-then-remove** – rename the item first (appending a suffix) so the
+ *   directory is freed instantly, then delete the renamed copy asynchronously.
+ *
+ * The move strategy is useful for large directories like `node_modules` where
+ * an immediate `rm -rf` would block the event loop for a noticeable duration.
+ */
 export declare class Cleanup {
     protected readonly toBeDeleted: ToBeDeleted[];
+    /**
+     * Create a new Cleanup instance.
+     *
+     * @param toBeDeleted - Items to remove from every workspace package and the
+     *   repository root.
+     */
     constructor(toBeDeleted: ToBeDeleted[]);
+    /**
+     * Execute the full cleanup: read targets then remove them.
+     *
+     * @returns A promise that resolves when every target has been cleaned up.
+     */
     run(): Promise<void>;
+    /**
+     * Resolve cleanup targets for every workspace package and the repo root.
+     *
+     * @remarks
+     * Reads the workspace to discover all packages, then maps each configured
+     * {@link ToBeDeleted} entry to a fully-resolved {@link ToCleanup} with
+     * absolute paths.
+     *
+     * @returns An array of resolved cleanup targets.
+     */
     read(): Promise<ToCleanup[]>;
+    /**
+     * Remove all resolved cleanup targets in parallel.
+     *
+     * @param toCleanups - Resolved targets to remove.
+     * @returns A promise that resolves when every target has been processed.
+     */
     cleanup(toCleanups: ToCleanup[]): Promise<void>;
+    /**
+     * Clean up a single target, using the move-then-remove strategy when a
+     * {@link ToCleanup.moveTo | moveTo} path is configured.
+     *
+     * @remarks
+     * When `moveTo` is set the item is renamed first so the original path is
+     * freed immediately. The actual deletion of the renamed copy happens
+     * asynchronously (fire-and-forget) to avoid blocking.
+     *
+     * @param toCleanup - The resolved cleanup target to process.
+     */
     cleanupSingle(toCleanup: ToCleanup): Promise<void>;
     protected buildRemovePaths(basePath: string): ToCleanup[];
     protected move(toCleanup: ToCleanup): Promise<void>;

package/dist/cleanup/Cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cleanup.d.ts","sourceRoot":"","sources":["../../src/cleanup/Cleanup.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,WAAW,EACX,SAAS,EACV,MAAM,2BAA2B,CAAC;AAanC,eAAO,MAAM,UAAU,GAAU,QAAQ,aAAa,kBAGrD,CAAC;AAEF,qBAAa,OAAO;IACC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE;gBAA1B,WAAW,EAAE,WAAW,EAAE;IAEnD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpB,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAU5B,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/D,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;cAWzC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;cAIzC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5D"}
+{"version":3,"file":"Cleanup.d.ts","sourceRoot":"","sources":["../../src/cleanup/Cleanup.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,WAAW,EACX,SAAS,EACV,MAAM,2BAA2B,CAAC;AAanC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU,GAAU,QAAQ,aAAa,kBAGrD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAO;IAOC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE;IANhE;;;;;OAKG;gBACmC,WAAW,EAAE,WAAW,EAAE;IAEhE;;;;OAIG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;;;;;;;;OASG;IACU,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAUzC;;;;;OAKG;IACU,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;;;;;;OAUG;IACU,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/D,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;cAWzC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;cAIzC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5D"}

package/dist/cleanup/Cleanup.js

@@ -9,19 +9,72 @@ const DEFAULT_TO_BE_DELETED = [
     { name: "tsconfig.tsbuildinfo" },
     { name: ".tsbuildinfo" },
 ];
+/**
+ * Run the cleanup operation across all workspace packages.
+ *
+ * @remarks
+ * This is the main entry point for the cleanup command. It initialises the
+ * workspace, then delegates to the {@link Cleanup} class to resolve and
+ * remove the configured targets.
+ *
+ * @param params - Configuration for the cleanup run, including which items
+ *   to delete and the repository root path.
+ * @returns A promise that resolves when all items have been cleaned up.
+ *
+ * @example
+ * ```ts
+ * import { runCleanup } from "@mxpicture/build-api";
+ *
+ * await runCleanup({ repoRoot: process.cwd() });
+ * ```
+ */
 export const runCleanup = async (params) => {
     initWorkspace(params.repoRoot);
     return new Cleanup(params.toBeDeleted ?? DEFAULT_TO_BE_DELETED).run();
 };
+/**
+ * Removes build artifacts and temporary directories from workspace packages.
+ *
+ * @remarks
+ * For each configured target the class supports two strategies:
+ *
+ * - **Direct removal** – delete the item immediately via `rm -rf`.
+ * - **Move-then-remove** – rename the item first (appending a suffix) so the
+ *   directory is freed instantly, then delete the renamed copy asynchronously.
+ *
+ * The move strategy is useful for large directories like `node_modules` where
+ * an immediate `rm -rf` would block the event loop for a noticeable duration.
+ */
 export class Cleanup {
     toBeDeleted;
+    /**
+     * Create a new Cleanup instance.
+     *
+     * @param toBeDeleted - Items to remove from every workspace package and the
+     *   repository root.
+     */
     constructor(toBeDeleted) {
         this.toBeDeleted = toBeDeleted;
     }
+    /**
+     * Execute the full cleanup: read targets then remove them.
+     *
+     * @returns A promise that resolves when every target has been cleaned up.
+     */
     async run() {
         const items = await this.read();
         return this.cleanup(items);
     }
+    /**
+     * Resolve cleanup targets for every workspace package and the repo root.
+     *
+     * @remarks
+     * Reads the workspace to discover all packages, then maps each configured
+     * {@link ToBeDeleted} entry to a fully-resolved {@link ToCleanup} with
+     * absolute paths.
+     *
+     * @returns An array of resolved cleanup targets.
+     */
     async read() {
         const ws = workspace();
         await ws.read();
@@ -29,9 +82,26 @@ export class Cleanup {
         const toCleanups = this.buildRemovePaths(workspace().repoRoot);
         return [...toCleanups, ...toCleanupsTmp];
     }
+    /**
+     * Remove all resolved cleanup targets in parallel.
+     *
+     * @param toCleanups - Resolved targets to remove.
+     * @returns A promise that resolves when every target has been processed.
+     */
     async cleanup(toCleanups) {
         await Promise.all(toCleanups.map(async (x) => this.cleanupSingle(x)));
     }
+    /**
+     * Clean up a single target, using the move-then-remove strategy when a
+     * {@link ToCleanup.moveTo | moveTo} path is configured.
+     *
+     * @remarks
+     * When `moveTo` is set the item is renamed first so the original path is
+     * freed immediately. The actual deletion of the renamed copy happens
+     * asynchronously (fire-and-forget) to avoid blocking.
+     *
+     * @param toCleanup - The resolved cleanup target to process.
+     */
     async cleanupSingle(toCleanup) {
         logInfo(`🧹 Cleanup started ${toCleanup.name} ...`);
         try {

package/dist/cleanup/Cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"Cleanup.js","sourceRoot":"","sources":["../../src/cleanup/Cleanup.ts"],"names":[],"mappings":"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","sourcesContent":["import { rename, rm } from \"node:fs/promises\";\nimport {\n  CleanupParams,\n  ToBeDeleted,\n  ToCleanup,\n} from \"../types/types.cleanup.js\";\nimport { join } from \"node:path\";\nimport { logError, logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\n\n// moveSuffix: e.g. mv node_modules node_modules_tmp && rm -rf node_modules_tmp (async)\nconst DEFAULT_TO_BE_DELETED: ToBeDeleted[] = [\n  { name: \"node_modules\", moveSuffix: \"_tmp\" },\n  { name: \"dist\", moveSuffix: \"_tmp\" },\n  { name: \"tsconfig.tsbuildinfo\" },\n  { name: \".tsbuildinfo\" },\n];\n\nexport const runCleanup = async (params: CleanupParams) => {\n  initWorkspace(params.repoRoot);\n  return new Cleanup(params.toBeDeleted ?? DEFAULT_TO_BE_DELETED).run();\n};\n\nexport class Cleanup {\n  public constructor(protected readonly toBeDeleted: ToBeDeleted[]) {}\n\n  public async run(): Promise<void> {\n    const items = await this.read();\n    return this.cleanup(items);\n  }\n\n  public async read(): Promise<ToCleanup[]> {\n    const ws = workspace();\n    await ws.read();\n    const toCleanupsTmp = ws.packages.flatMap((pkg) =>\n      this.buildRemovePaths(pkg.dirPath),\n    );\n    const toCleanups = this.buildRemovePaths(workspace().repoRoot);\n    return [...toCleanups, ...toCleanupsTmp];\n  }\n\n  public async cleanup(toCleanups: ToCleanup[]): Promise<void> {\n    await Promise.all(toCleanups.map(async (x) => this.cleanupSingle(x)));\n  }\n\n  public async cleanupSingle(toCleanup: ToCleanup): Promise<void> {\n    logInfo(`🧹 Cleanup started ${toCleanup.name} ...`);\n    try {\n      if (!toCleanup.moveTo) {\n        await this.remove(toCleanup);\n        logSuccess(`✅ ${toCleanup.name} removed sucessfully`);\n        return;\n      }\n\n      logInfo(\n        `📦 Moving ${toCleanup.name} to ${toCleanup.name}${toCleanup.moveSuffix}`,\n      );\n      await this.move(toCleanup);\n\n      logInfo(\n        `📦 Start async removing ${toCleanup.name} (${toCleanup.name}${toCleanup.moveSuffix})`,\n      );\n\n      this.remove(toCleanup)\n        .then(() =>\n          logSuccess(`✅ ${toCleanup.name} (async) removed sucessfully`),\n        )\n        .catch((e) => {\n          logError(`❌ Removing ${toCleanup.name} (async) failed ${e}`);\n        });\n    } catch (error) {\n      logError(`❌ Removing ${toCleanup.name} failed ${error}`);\n    }\n  }\n\n  protected buildRemovePaths(basePath: string): ToCleanup[] {\n    return this.toBeDeleted.map((d) => {\n      const path = join(basePath, d.name);\n      return {\n        ...d,\n        path,\n        moveTo: d.moveSuffix ? `${path}${d.moveSuffix}` : undefined,\n      };\n    });\n  }\n\n  protected async move(toCleanup: ToCleanup): Promise<void> {\n    if (toCleanup.moveTo) return rename(toCleanup.path, toCleanup.moveTo);\n  }\n\n  protected async remove(toCleanup: ToCleanup): Promise<void> {\n    return rm(toCleanup.moveTo ?? toCleanup.path, {\n      force: true,\n      recursive: true,\n    });\n  }\n}\n"]}
+{"version":3,"file":"Cleanup.js","sourceRoot":"","sources":["../../src/cleanup/Cleanup.ts"],"names":[],"mappings":"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","sourcesContent":["import { rename, rm } from \"node:fs/promises\";\nimport {\n  CleanupParams,\n  ToBeDeleted,\n  ToCleanup,\n} from \"../types/types.cleanup.js\";\nimport { join } from \"node:path\";\nimport { logError, logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\n\n// moveSuffix: e.g. mv node_modules node_modules_tmp && rm -rf node_modules_tmp (async)\nconst DEFAULT_TO_BE_DELETED: ToBeDeleted[] = [\n  { name: \"node_modules\", moveSuffix: \"_tmp\" },\n  { name: \"dist\", moveSuffix: \"_tmp\" },\n  { name: \"tsconfig.tsbuildinfo\" },\n  { name: \".tsbuildinfo\" },\n];\n\n/**\n * Run the cleanup operation across all workspace packages.\n *\n * @remarks\n * This is the main entry point for the cleanup command. It initialises the\n * workspace, then delegates to the {@link Cleanup} class to resolve and\n * remove the configured targets.\n *\n * @param params - Configuration for the cleanup run, including which items\n *   to delete and the repository root path.\n * @returns A promise that resolves when all items have been cleaned up.\n *\n * @example\n * ```ts\n * import { runCleanup } from \"@mxpicture/build-api\";\n *\n * await runCleanup({ repoRoot: process.cwd() });\n * ```\n */\nexport const runCleanup = async (params: CleanupParams) => {\n  initWorkspace(params.repoRoot);\n  return new Cleanup(params.toBeDeleted ?? DEFAULT_TO_BE_DELETED).run();\n};\n\n/**\n * Removes build artifacts and temporary directories from workspace packages.\n *\n * @remarks\n * For each configured target the class supports two strategies:\n *\n * - **Direct removal** – delete the item immediately via `rm -rf`.\n * - **Move-then-remove** – rename the item first (appending a suffix) so the\n *   directory is freed instantly, then delete the renamed copy asynchronously.\n *\n * The move strategy is useful for large directories like `node_modules` where\n * an immediate `rm -rf` would block the event loop for a noticeable duration.\n */\nexport class Cleanup {\n  /**\n   * Create a new Cleanup instance.\n   *\n   * @param toBeDeleted - Items to remove from every workspace package and the\n   *   repository root.\n   */\n  public constructor(protected readonly toBeDeleted: ToBeDeleted[]) {}\n\n  /**\n   * Execute the full cleanup: read targets then remove them.\n   *\n   * @returns A promise that resolves when every target has been cleaned up.\n   */\n  public async run(): Promise<void> {\n    const items = await this.read();\n    return this.cleanup(items);\n  }\n\n  /**\n   * Resolve cleanup targets for every workspace package and the repo root.\n   *\n   * @remarks\n   * Reads the workspace to discover all packages, then maps each configured\n   * {@link ToBeDeleted} entry to a fully-resolved {@link ToCleanup} with\n   * absolute paths.\n   *\n   * @returns An array of resolved cleanup targets.\n   */\n  public async read(): Promise<ToCleanup[]> {\n    const ws = workspace();\n    await ws.read();\n    const toCleanupsTmp = ws.packages.flatMap((pkg) =>\n      this.buildRemovePaths(pkg.dirPath),\n    );\n    const toCleanups = this.buildRemovePaths(workspace().repoRoot);\n    return [...toCleanups, ...toCleanupsTmp];\n  }\n\n  /**\n   * Remove all resolved cleanup targets in parallel.\n   *\n   * @param toCleanups - Resolved targets to remove.\n   * @returns A promise that resolves when every target has been processed.\n   */\n  public async cleanup(toCleanups: ToCleanup[]): Promise<void> {\n    await Promise.all(toCleanups.map(async (x) => this.cleanupSingle(x)));\n  }\n\n  /**\n   * Clean up a single target, using the move-then-remove strategy when a\n   * {@link ToCleanup.moveTo | moveTo} path is configured.\n   *\n   * @remarks\n   * When `moveTo` is set the item is renamed first so the original path is\n   * freed immediately. The actual deletion of the renamed copy happens\n   * asynchronously (fire-and-forget) to avoid blocking.\n   *\n   * @param toCleanup - The resolved cleanup target to process.\n   */\n  public async cleanupSingle(toCleanup: ToCleanup): Promise<void> {\n    logInfo(`🧹 Cleanup started ${toCleanup.name} ...`);\n    try {\n      if (!toCleanup.moveTo) {\n        await this.remove(toCleanup);\n        logSuccess(`✅ ${toCleanup.name} removed sucessfully`);\n        return;\n      }\n\n      logInfo(\n        `📦 Moving ${toCleanup.name} to ${toCleanup.name}${toCleanup.moveSuffix}`,\n      );\n      await this.move(toCleanup);\n\n      logInfo(\n        `📦 Start async removing ${toCleanup.name} (${toCleanup.name}${toCleanup.moveSuffix})`,\n      );\n\n      this.remove(toCleanup)\n        .then(() =>\n          logSuccess(`✅ ${toCleanup.name} (async) removed sucessfully`),\n        )\n        .catch((e) => {\n          logError(`❌ Removing ${toCleanup.name} (async) failed ${e}`);\n        });\n    } catch (error) {\n      logError(`❌ Removing ${toCleanup.name} failed ${error}`);\n    }\n  }\n\n  protected buildRemovePaths(basePath: string): ToCleanup[] {\n    return this.toBeDeleted.map((d) => {\n      const path = join(basePath, d.name);\n      return {\n        ...d,\n        path,\n        moveTo: d.moveSuffix ? `${path}${d.moveSuffix}` : undefined,\n      };\n    });\n  }\n\n  protected async move(toCleanup: ToCleanup): Promise<void> {\n    if (toCleanup.moveTo) return rename(toCleanup.path, toCleanup.moveTo);\n  }\n\n  protected async remove(toCleanup: ToCleanup): Promise<void> {\n    return rm(toCleanup.moveTo ?? toCleanup.path, {\n      force: true,\n      recursive: true,\n    });\n  }\n}\n"]}

package/dist/code/code.common.d.ts

@@ -1,13 +1,46 @@
 import ts from "typescript";
 import { SourceFile } from "../types/types.code.js";
+/**
+ * Creates a TypeScript program and returns an array of {@link SourceFile} entries.
+ *
+ * @remarks
+ * A new `ts.Program` is created for every call. When you need to process many
+ * files, prefer {@link createSourceFileMap} which is more efficient because the
+ * compiler is only instantiated once and results are keyed by path.
+ *
+ * @param filePaths - Absolute paths to the TypeScript source files to load.
+ * @returns An array of successfully parsed {@link SourceFile} entries.
+ */
 export declare const createSourceFiles: (filePaths: string[]) => SourceFile[];
 /**
- * Creates a single ts.Program for all provided file paths and returns a map
- * from filePath → SourceFile. This is much more efficient than calling
- * createSourceFiles() per file because the TypeScript compiler is only
- * instantiated once.
+ * Creates a single TypeScript program and returns a map from file path to {@link SourceFile}.
+ *
+ * @remarks
+ * This is more efficient than {@link createSourceFiles} when processing many
+ * files, because the TypeScript compiler is only instantiated once and the
+ * results are keyed by path for O(1) lookup.
+ *
+ * @param filePaths - Absolute paths to the TypeScript source files to load.
+ * @returns A map keyed by file path whose values are the parsed {@link SourceFile} entries.
  */
 export declare const createSourceFileMap: (filePaths: string[]) => Map<string, SourceFile>;
+/**
+ * Returns the human-readable syntax-kind name for a TypeScript declaration node.
+ *
+ * @param d - The TypeScript declaration node to inspect.
+ * @returns The name of the declaration's {@link ts.SyntaxKind}, or `"Unknown"` if unmapped.
+ */
 export declare const declarationKindName: (d: ts.Declaration) => string;
+/**
+ * Infers a human-readable kind label from a symbol's flags.
+ *
+ * @remarks
+ * The mapping is approximate — it checks flags in priority order and returns
+ * the first match. This is sufficient for reporting purposes but may not
+ * capture every nuance of the TypeScript symbol model.
+ *
+ * @param sym - The TypeScript symbol whose kind should be inferred.
+ * @returns A lowercase label such as `"function"`, `"class"`, or `"unknown"`.
+ */
 export declare const guessKindFromFlags: (sym: ts.Symbol) => string;
 //# sourceMappingURL=code.common.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"code.common.d.ts","sourceRoot":"","sources":["../../src/code/code.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,EAAE,KAAG,UAAU,EAgBjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,MAAM,EAAE,KAClB,GAAG,CAAC,MAAM,EAAE,UAAU,CAcxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,GAAG,EAAE,CAAC,WAAW,WACjB,CAAC;AAErC,eAAO,MAAM,kBAAkB,GAAI,KAAK,EAAE,CAAC,MAAM,KAAG,MAYnD,CAAC"}
+{"version":3,"file":"code.common.d.ts","sourceRoot":"","sources":["../../src/code/code.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,EAAE,KAAG,UAAU,EAgBjE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,MAAM,EAAE,KAClB,GAAG,CAAC,MAAM,EAAE,UAAU,CAcxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,GAAG,EAAE,CAAC,WAAW,WACjB,CAAC;AAErC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,EAAE,CAAC,MAAM,KAAG,MAYnD,CAAC"}

package/dist/code/code.common.js

@@ -1,4 +1,15 @@
 import ts from "typescript";
+/**
+ * Creates a TypeScript program and returns an array of {@link SourceFile} entries.
+ *
+ * @remarks
+ * A new `ts.Program` is created for every call. When you need to process many
+ * files, prefer {@link createSourceFileMap} which is more efficient because the
+ * compiler is only instantiated once and results are keyed by path.
+ *
+ * @param filePaths - Absolute paths to the TypeScript source files to load.
+ * @returns An array of successfully parsed {@link SourceFile} entries.
+ */
 export const createSourceFiles = (filePaths) => {
     const program = ts.createProgram(filePaths, {
         target: ts.ScriptTarget.ES2023,
@@ -16,10 +27,15 @@ export const createSourceFiles = (filePaths) => {
     return results;
 };
 /**
- * Creates a single ts.Program for all provided file paths and returns a map
- * from filePath → SourceFile. This is much more efficient than calling
- * createSourceFiles() per file because the TypeScript compiler is only
- * instantiated once.
+ * Creates a single TypeScript program and returns a map from file path to {@link SourceFile}.
+ *
+ * @remarks
+ * This is more efficient than {@link createSourceFiles} when processing many
+ * files, because the TypeScript compiler is only instantiated once and the
+ * results are keyed by path for O(1) lookup.
+ *
+ * @param filePaths - Absolute paths to the TypeScript source files to load.
+ * @returns A map keyed by file path whose values are the parsed {@link SourceFile} entries.
  */
 export const createSourceFileMap = (filePaths) => {
     const program = ts.createProgram(filePaths, {
@@ -37,7 +53,24 @@ export const createSourceFileMap = (filePaths) => {
     }
     return map;
 };
+/**
+ * Returns the human-readable syntax-kind name for a TypeScript declaration node.
+ *
+ * @param d - The TypeScript declaration node to inspect.
+ * @returns The name of the declaration's {@link ts.SyntaxKind}, or `"Unknown"` if unmapped.
+ */
 export const declarationKindName = (d) => ts.SyntaxKind[d.kind] ?? "Unknown";
+/**
+ * Infers a human-readable kind label from a symbol's flags.
+ *
+ * @remarks
+ * The mapping is approximate — it checks flags in priority order and returns
+ * the first match. This is sufficient for reporting purposes but may not
+ * capture every nuance of the TypeScript symbol model.
+ *
+ * @param sym - The TypeScript symbol whose kind should be inferred.
+ * @returns A lowercase label such as `"function"`, `"class"`, or `"unknown"`.
+ */
 export const guessKindFromFlags = (sym) => {
     // Not perfect, but good enough for reporting.
     const f = sym.getFlags();