@mxpicture/build-api 0.2.56 → 0.2.58

package/dist/vscode/vscode.workspace.js

@@ -1,15 +1,32 @@
 import { readFile } from "node:fs/promises";
-import json5 from "json5";
 import { dirname } from "node:path";
+import { jsonParse } from "../common/common.json.js";
 const __workspaces = {};
+/**
+ * Reads and returns a parsed VS Code `.code-workspace` file.
+ *
+ * @remarks
+ * The result is cached per `workspaceFile` path. A shallow copy is returned
+ * so that callers cannot mutate the cached object.
+ *
+ * @param workspaceFile - Absolute path to the `.code-workspace` file.
+ * @returns A promise that resolves to a shallow copy of the parsed
+ *   {@link VSCodeWorkspace}.
+ */
 export const vscodeWorkspace = async (workspaceFile) => {
     let found = __workspaces[workspaceFile];
     if (!found) {
         const raw = await readFile(workspaceFile, "utf-8");
-        found = json5.parse(raw);
+        found = jsonParse(raw);
         __workspaces[workspaceFile] = found;
     }
     return { ...found };
 };
+/**
+ * Returns the directory that contains the given workspace file.
+ *
+ * @param workspaceFile - Absolute path to the `.code-workspace` file.
+ * @returns The parent directory of the workspace file.
+ */
 export const vscodeWorkspaceRoot = (workspaceFile) => dirname(workspaceFile);
 //# sourceMappingURL=vscode.workspace.js.map

package/dist/vscode/vscode.workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.workspace.js","sourceRoot":"","sources":["../../src/vscode/vscode.workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,YAAY,GAAoC,EAAE,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,aAAqB,EACK,EAAE;IAC5B,IAAI,KAAK,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACnD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,YAAY,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAqB,EAAE,EAAE,CAC3D,OAAO,CAAC,aAAa,CAAC,CAAC","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { VSCodeWorkspace } from \"../types/types.vscode.js\";\nimport json5 from \"json5\";\nimport { dirname } from \"node:path\";\n\nconst __workspaces: Record<string, VSCodeWorkspace> = {};\n\nexport const vscodeWorkspace = async (\n  workspaceFile: string,\n): Promise<VSCodeWorkspace> => {\n  let found = __workspaces[workspaceFile];\n  if (!found) {\n    const raw = await readFile(workspaceFile, \"utf-8\");\n    found = json5.parse(raw);\n    __workspaces[workspaceFile] = found;\n  }\n\n  return { ...found };\n};\n\nexport const vscodeWorkspaceRoot = (workspaceFile: string) =>\n  dirname(workspaceFile);\n"]}
+{"version":3,"file":"vscode.workspace.js","sourceRoot":"","sources":["../../src/vscode/vscode.workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,YAAY,GAAoC,EAAE,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,aAAqB,EACK,EAAE;IAC5B,IAAI,KAAK,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACnD,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACvB,YAAY,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAqB,EAAE,EAAE,CAC3D,OAAO,CAAC,aAAa,CAAC,CAAC","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { VSCodeWorkspace } from \"../types/types.vscode.js\";\nimport { dirname } from \"node:path\";\nimport { jsonParse } from \"../common/common.json.js\";\n\nconst __workspaces: Record<string, VSCodeWorkspace> = {};\n\n/**\n * Reads and returns a parsed VS Code `.code-workspace` file.\n *\n * @remarks\n * The result is cached per `workspaceFile` path. A shallow copy is returned\n * so that callers cannot mutate the cached object.\n *\n * @param workspaceFile - Absolute path to the `.code-workspace` file.\n * @returns A promise that resolves to a shallow copy of the parsed\n *   {@link VSCodeWorkspace}.\n */\nexport const vscodeWorkspace = async (\n  workspaceFile: string,\n): Promise<VSCodeWorkspace> => {\n  let found = __workspaces[workspaceFile];\n  if (!found) {\n    const raw = await readFile(workspaceFile, \"utf-8\");\n    found = jsonParse(raw);\n    __workspaces[workspaceFile] = found;\n  }\n\n  return { ...found };\n};\n\n/**\n * Returns the directory that contains the given workspace file.\n *\n * @param workspaceFile - Absolute path to the `.code-workspace` file.\n * @returns The parent directory of the workspace file.\n */\nexport const vscodeWorkspaceRoot = (workspaceFile: string) =>\n  dirname(workspaceFile);\n"]}

package/dist/workspace/Workspace.d.ts

@@ -1,24 +1,109 @@
 import { PnpmWorkspace } from "../types/types.workspace.js";
 import { Pkg } from "../pkg/Pkg.js";
+/**
+ * Create and register the global {@link Workspace} singleton.
+ *
+ * @remarks
+ * This is the primary entry point for bootstrapping a workspace. It must be
+ * called before {@link workspace} can be used. Subsequent calls replace the
+ * existing singleton.
+ *
+ * @param repoRoot - Absolute path to the repository root directory.
+ * @returns The newly created {@link Workspace} instance.
+ *
+ * @example
+ * ```ts
+ * const ws = initWorkspace("/path/to/repo");
+ * await ws.read();
+ * console.log(ws.packages);
+ * ```
+ */
 export declare const initWorkspace: (repoRoot: string) => Workspace;
+/**
+ * Retrieve the global {@link Workspace} singleton.
+ *
+ * @remarks
+ * Throws if {@link initWorkspace} has not been called first.
+ *
+ * @returns The current {@link Workspace} instance.
+ *
+ * @example
+ * ```ts
+ * const ws = workspace();
+ * console.log(ws.rootPackage.name);
+ * ```
+ */
 export declare const workspace: () => Workspace;
 interface WorkspaceData {
     pnpmWs: PnpmWorkspace;
     rootPackage: Pkg;
     packages: Pkg[];
 }
+/**
+ * Represents a pnpm monorepo workspace rooted at a given directory.
+ *
+ * @remarks
+ * {@link Workspace} is implemented as a singleton managed via the
+ * {@link initWorkspace} and {@link workspace} helper functions. It lazily
+ * reads the `pnpm-workspace.yaml` and every package's `package.json` on the
+ * first call to {@link Workspace.read}, and persists pending changes back to
+ * disk with {@link Workspace.write}.
+ */
 export declare class Workspace {
     readonly repoRoot: string;
     protected _data: WorkspaceData | null;
+    /**
+     * Create and register a new singleton instance.
+     *
+     * @internal
+     * @param repoRoot - Absolute path to the repository root directory.
+     * @returns The newly created {@link Workspace} instance.
+     */
     static __init(repoRoot: string): Workspace;
+    /**
+     * Return the current singleton instance.
+     *
+     * @internal
+     * @returns The existing {@link Workspace} instance.
+     * @throws {Error} If the singleton has not been initialised via {@link Workspace.__init}.
+     */
     static __get(): Workspace;
     private constructor();
+    /**
+     * A deep-cloned copy of the parsed `pnpm-workspace.yaml` configuration.
+     *
+     * @remarks
+     * Returns a clone so that callers cannot mutate the internal state.
+     */
     get pnpmWs(): PnpmWorkspace;
+    /**
+     * The list of {@link Pkg} instances representing each workspace package.
+     */
     get packages(): Pkg[];
+    /**
+     * The {@link Pkg} instance for the repository root `package.json`.
+     */
     get rootPackage(): Pkg;
     protected set data(c: WorkspaceData);
     protected get data(): WorkspaceData;
+    /**
+     * Read the workspace configuration and all package manifests from disk.
+     *
+     * @remarks
+     * This method is idempotent — if data has already been loaded it returns
+     * immediately without re-reading. It parses `pnpm-workspace.yaml`, then
+     * reads every referenced `package.json` in parallel.
+     *
+     * @returns This {@link Workspace} instance for chaining.
+     */
     read(): Promise<Workspace>;
+    /**
+     * Persist all modified package manifests back to disk.
+     *
+     * @remarks
+     * No-ops if {@link Workspace.read} has not yet been called. Writes the
+     * root package and every workspace package in parallel.
+     */
     write(): Promise<void>;
 }
 export {};

package/dist/workspace/Workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../src/workspace/Workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAKpC,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,cAA+B,CAAC;AAC9E,eAAO,MAAM,SAAS,iBAA0B,CAAC;AAEjD,UAAU,aAAa;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,GAAG,CAAC;IACjB,QAAQ,EAAE,GAAG,EAAE,CAAC;CACjB;AAED,qBAAa,SAAS;aAagB,QAAQ,EAAE,MAAM;IAZpD,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAQ;WAE/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;WAInC,KAAK,IAAI,SAAS;IAMhC,OAAO;IAEP,IAAW,MAAM,IAAI,aAAa,CAEjC;IAED,IAAW,QAAQ,IAAI,GAAG,EAAE,CAE3B;IAED,IAAW,WAAW,IAAI,GAAG,CAE5B;IAED,SAAS,KAAK,IAAI,CAAC,CAAC,EAAE,aAAa,EAElC;IAED,SAAS,KAAK,IAAI,IAAI,aAAa,CAGlC;IAEY,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAqB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAOpC"}
+{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../src/workspace/Workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAKpC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,cAA+B,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,iBAA0B,CAAC;AAEjD,UAAU,aAAa;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,GAAG,CAAC;IACjB,QAAQ,EAAE,GAAG,EAAE,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,qBAAa,SAAS;aA2BgB,QAAQ,EAAE,MAAM;IA1BpD,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAQ;IAE7C;;;;;;OAMG;WACW,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAIjD;;;;;;OAMG;WACW,KAAK,IAAI,SAAS;IAMhC,OAAO;IAEP;;;;;OAKG;IACH,IAAW,MAAM,IAAI,aAAa,CAEjC;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,GAAG,EAAE,CAE3B;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,GAAG,CAE5B;IAED,SAAS,KAAK,IAAI,CAAC,CAAC,EAAE,aAAa,EAElC;IAED,SAAS,KAAK,IAAI,IAAI,aAAa,CAGlC;IAED;;;;;;;;;OASG;IACU,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAqBvC;;;;;;OAMG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAOpC"}

package/dist/workspace/Workspace.js

@@ -2,14 +2,70 @@ import { readWorkspaceYaml } from "./workspace.common.js";
 import { Pkg } from "../pkg/Pkg.js";
 import { jsonClone } from "../common/common.json.js";
 let __instance = null;
+/**
+ * Create and register the global {@link Workspace} singleton.
+ *
+ * @remarks
+ * This is the primary entry point for bootstrapping a workspace. It must be
+ * called before {@link workspace} can be used. Subsequent calls replace the
+ * existing singleton.
+ *
+ * @param repoRoot - Absolute path to the repository root directory.
+ * @returns The newly created {@link Workspace} instance.
+ *
+ * @example
+ * ```ts
+ * const ws = initWorkspace("/path/to/repo");
+ * await ws.read();
+ * console.log(ws.packages);
+ * ```
+ */
 export const initWorkspace = (repoRoot) => Workspace.__init(repoRoot);
+/**
+ * Retrieve the global {@link Workspace} singleton.
+ *
+ * @remarks
+ * Throws if {@link initWorkspace} has not been called first.
+ *
+ * @returns The current {@link Workspace} instance.
+ *
+ * @example
+ * ```ts
+ * const ws = workspace();
+ * console.log(ws.rootPackage.name);
+ * ```
+ */
 export const workspace = () => Workspace.__get();
+/**
+ * Represents a pnpm monorepo workspace rooted at a given directory.
+ *
+ * @remarks
+ * {@link Workspace} is implemented as a singleton managed via the
+ * {@link initWorkspace} and {@link workspace} helper functions. It lazily
+ * reads the `pnpm-workspace.yaml` and every package's `package.json` on the
+ * first call to {@link Workspace.read}, and persists pending changes back to
+ * disk with {@link Workspace.write}.
+ */
 export class Workspace {
     repoRoot;
     _data = null;
+    /**
+     * Create and register a new singleton instance.
+     *
+     * @internal
+     * @param repoRoot - Absolute path to the repository root directory.
+     * @returns The newly created {@link Workspace} instance.
+     */
     static __init(repoRoot) {
         return (__instance = new Workspace(repoRoot));
     }
+    /**
+     * Return the current singleton instance.
+     *
+     * @internal
+     * @returns The existing {@link Workspace} instance.
+     * @throws {Error} If the singleton has not been initialised via {@link Workspace.__init}.
+     */
     static __get() {
         if (!__instance)
             throw new Error("Workspace not initialized. initWorkspace()");
@@ -18,12 +74,24 @@ export class Workspace {
     constructor(repoRoot) {
         this.repoRoot = repoRoot;
     }
+    /**
+     * A deep-cloned copy of the parsed `pnpm-workspace.yaml` configuration.
+     *
+     * @remarks
+     * Returns a clone so that callers cannot mutate the internal state.
+     */
     get pnpmWs() {
         return jsonClone(this.data.pnpmWs);
     }
+    /**
+     * The list of {@link Pkg} instances representing each workspace package.
+     */
     get packages() {
         return this.data.packages;
     }
+    /**
+     * The {@link Pkg} instance for the repository root `package.json`.
+     */
     get rootPackage() {
         return this.data.rootPackage;
     }
@@ -35,6 +103,16 @@ export class Workspace {
             throw new Error(`Data not loaded. ${this.repoRoot}`);
         return this._data;
     }
+    /**
+     * Read the workspace configuration and all package manifests from disk.
+     *
+     * @remarks
+     * This method is idempotent — if data has already been loaded it returns
+     * immediately without re-reading. It parses `pnpm-workspace.yaml`, then
+     * reads every referenced `package.json` in parallel.
+     *
+     * @returns This {@link Workspace} instance for chaining.
+     */
     async read() {
         if (this._data)
             return this;
@@ -52,6 +130,13 @@ export class Workspace {
         };
         return this;
     }
+    /**
+     * Persist all modified package manifests back to disk.
+     *
+     * @remarks
+     * No-ops if {@link Workspace.read} has not yet been called. Writes the
+     * root package and every workspace package in parallel.
+     */
     async write() {
         if (!this._data)
             return;

package/dist/workspace/Workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../../src/workspace/Workspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,IAAI,UAAU,GAAqB,IAAI,CAAC;AAExC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;AAQjD,MAAM,OAAO,SAAS;IAagB;IAZ1B,KAAK,GAAyB,IAAI,CAAC;IAEtC,MAAM,CAAC,MAAM,CAAC,QAAgB;QACnC,OAAO,CAAC,UAAU,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC;IAEM,MAAM,CAAC,KAAK;QACjB,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,YAAoC,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExD,IAAW,MAAM;QACf,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;IAC/B,CAAC;IAED,IAAc,IAAI,CAAC,CAAgB;QACjC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,IAAc,IAAI;QAChB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAClC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAC/C,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,WAAW,CAAC,IAAI,EAAE;YAClB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG;YACV,MAAM;YACN,QAAQ;YACR,WAAW;SACZ,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE;YACxB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { PnpmWorkspace } from \"../types/types.workspace.js\";\nimport { readWorkspaceYaml } from \"./workspace.common.js\";\nimport { Pkg } from \"../pkg/Pkg.js\";\nimport { jsonClone } from \"../common/common.json.js\";\n\nlet __instance: Workspace | null = null;\n\nexport const initWorkspace = (repoRoot: string) => Workspace.__init(repoRoot);\nexport const workspace = () => Workspace.__get();\n\ninterface WorkspaceData {\n  pnpmWs: PnpmWorkspace;\n  rootPackage: Pkg;\n  packages: Pkg[];\n}\n\nexport class Workspace {\n  protected _data: WorkspaceData | null = null;\n\n  public static __init(repoRoot: string): Workspace {\n    return (__instance = new Workspace(repoRoot));\n  }\n\n  public static __get(): Workspace {\n    if (!__instance)\n      throw new Error(\"Workspace not initialized. initWorkspace()\");\n    return __instance;\n  }\n\n  private constructor(public readonly repoRoot: string) {}\n\n  public get pnpmWs(): PnpmWorkspace {\n    return jsonClone(this.data.pnpmWs);\n  }\n\n  public get packages(): Pkg[] {\n    return this.data.packages;\n  }\n\n  public get rootPackage(): Pkg {\n    return this.data.rootPackage;\n  }\n\n  protected set data(c: WorkspaceData) {\n    this._data = c;\n  }\n\n  protected get data(): WorkspaceData {\n    if (!this._data) throw new Error(`Data not loaded. ${this.repoRoot}`);\n    return this._data;\n  }\n\n  public async read(): Promise<Workspace> {\n    if (this._data) return this;\n    const pnpmWs = await readWorkspaceYaml(this.repoRoot);\n    const rootPackage = new Pkg(this.repoRoot, \".\");\n    const packages = pnpmWs.packages.map(\n      (repoPath) => new Pkg(this.repoRoot, repoPath),\n    );\n\n    await Promise.all([\n      rootPackage.read(),\n      ...packages.map((pkg) => pkg.read()),\n    ]);\n\n    this.data = {\n      pnpmWs,\n      packages,\n      rootPackage,\n    };\n    return this;\n  }\n\n  public async write(): Promise<void> {\n    if (!this._data) return;\n    await Promise.all([\n      this.rootPackage.write(),\n      ...this.packages.map((pkg) => pkg.write()),\n    ]);\n  }\n}\n"]}
+{"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../../src/workspace/Workspace.ts"],"names":[],"mappings":"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","sourcesContent":["import { PnpmWorkspace } from \"../types/types.workspace.js\";\nimport { readWorkspaceYaml } from \"./workspace.common.js\";\nimport { Pkg } from \"../pkg/Pkg.js\";\nimport { jsonClone } from \"../common/common.json.js\";\n\nlet __instance: Workspace | null = null;\n\n/**\n * Create and register the global {@link Workspace} singleton.\n *\n * @remarks\n * This is the primary entry point for bootstrapping a workspace. It must be\n * called before {@link workspace} can be used. Subsequent calls replace the\n * existing singleton.\n *\n * @param repoRoot - Absolute path to the repository root directory.\n * @returns The newly created {@link Workspace} instance.\n *\n * @example\n * ```ts\n * const ws = initWorkspace(\"/path/to/repo\");\n * await ws.read();\n * console.log(ws.packages);\n * ```\n */\nexport const initWorkspace = (repoRoot: string) => Workspace.__init(repoRoot);\n\n/**\n * Retrieve the global {@link Workspace} singleton.\n *\n * @remarks\n * Throws if {@link initWorkspace} has not been called first.\n *\n * @returns The current {@link Workspace} instance.\n *\n * @example\n * ```ts\n * const ws = workspace();\n * console.log(ws.rootPackage.name);\n * ```\n */\nexport const workspace = () => Workspace.__get();\n\ninterface WorkspaceData {\n  pnpmWs: PnpmWorkspace;\n  rootPackage: Pkg;\n  packages: Pkg[];\n}\n\n/**\n * Represents a pnpm monorepo workspace rooted at a given directory.\n *\n * @remarks\n * {@link Workspace} is implemented as a singleton managed via the\n * {@link initWorkspace} and {@link workspace} helper functions. It lazily\n * reads the `pnpm-workspace.yaml` and every package's `package.json` on the\n * first call to {@link Workspace.read}, and persists pending changes back to\n * disk with {@link Workspace.write}.\n */\nexport class Workspace {\n  protected _data: WorkspaceData | null = null;\n\n  /**\n   * Create and register a new singleton instance.\n   *\n   * @internal\n   * @param repoRoot - Absolute path to the repository root directory.\n   * @returns The newly created {@link Workspace} instance.\n   */\n  public static __init(repoRoot: string): Workspace {\n    return (__instance = new Workspace(repoRoot));\n  }\n\n  /**\n   * Return the current singleton instance.\n   *\n   * @internal\n   * @returns The existing {@link Workspace} instance.\n   * @throws {Error} If the singleton has not been initialised via {@link Workspace.__init}.\n   */\n  public static __get(): Workspace {\n    if (!__instance)\n      throw new Error(\"Workspace not initialized. initWorkspace()\");\n    return __instance;\n  }\n\n  private constructor(public readonly repoRoot: string) {}\n\n  /**\n   * A deep-cloned copy of the parsed `pnpm-workspace.yaml` configuration.\n   *\n   * @remarks\n   * Returns a clone so that callers cannot mutate the internal state.\n   */\n  public get pnpmWs(): PnpmWorkspace {\n    return jsonClone(this.data.pnpmWs);\n  }\n\n  /**\n   * The list of {@link Pkg} instances representing each workspace package.\n   */\n  public get packages(): Pkg[] {\n    return this.data.packages;\n  }\n\n  /**\n   * The {@link Pkg} instance for the repository root `package.json`.\n   */\n  public get rootPackage(): Pkg {\n    return this.data.rootPackage;\n  }\n\n  protected set data(c: WorkspaceData) {\n    this._data = c;\n  }\n\n  protected get data(): WorkspaceData {\n    if (!this._data) throw new Error(`Data not loaded. ${this.repoRoot}`);\n    return this._data;\n  }\n\n  /**\n   * Read the workspace configuration and all package manifests from disk.\n   *\n   * @remarks\n   * This method is idempotent — if data has already been loaded it returns\n   * immediately without re-reading. It parses `pnpm-workspace.yaml`, then\n   * reads every referenced `package.json` in parallel.\n   *\n   * @returns This {@link Workspace} instance for chaining.\n   */\n  public async read(): Promise<Workspace> {\n    if (this._data) return this;\n    const pnpmWs = await readWorkspaceYaml(this.repoRoot);\n    const rootPackage = new Pkg(this.repoRoot, \".\");\n    const packages = pnpmWs.packages.map(\n      (repoPath) => new Pkg(this.repoRoot, repoPath),\n    );\n\n    await Promise.all([\n      rootPackage.read(),\n      ...packages.map((pkg) => pkg.read()),\n    ]);\n\n    this.data = {\n      pnpmWs,\n      packages,\n      rootPackage,\n    };\n    return this;\n  }\n\n  /**\n   * Persist all modified package manifests back to disk.\n   *\n   * @remarks\n   * No-ops if {@link Workspace.read} has not yet been called. Writes the\n   * root package and every workspace package in parallel.\n   */\n  public async write(): Promise<void> {\n    if (!this._data) return;\n    await Promise.all([\n      this.rootPackage.write(),\n      ...this.packages.map((pkg) => pkg.write()),\n    ]);\n  }\n}\n"]}

package/dist/workspace/workspace.common.d.ts

@@ -1,8 +1,49 @@
 import { PnpmWorkspace, WorkspaceFile, WorkspaceFileType } from "../types/types.workspace.js";
+/**
+ * File extension used to identify VS Code / editor workspace files.
+ */
 export declare const DEFAULT_WORKSPACE_FILE_ENDING = ".code-workspace";
+/**
+ * Classify a filename into a {@link WorkspaceFileType}.
+ *
+ * @param filename - The base filename to classify (e.g. `"package.json"`).
+ * @returns The corresponding {@link WorkspaceFileType} enum value.
+ */
 export declare const getFileType: (filename: string) => WorkspaceFileType;
+/**
+ * Walk up the directory tree from `startPath` to locate the workspace root.
+ *
+ * @remarks
+ * The search runs every ancestor directory in parallel. A `.code-workspace`
+ * file is preferred over a bare `package.json`. The result is cached so that
+ * subsequent calls return immediately.
+ *
+ * @param startPath - Absolute path from which to begin the upward search.
+ * @returns The {@link WorkspaceFile} describing the workspace root.
+ * @throws {Error} If no workspace or package file is found in any ancestor.
+ */
 export declare const findWorkspaceRoot: (startPath: string) => Promise<WorkspaceFile>;
+/**
+ * Parse the `pnpm-workspace.yaml` file at the given repository root.
+ *
+ * @remarks
+ * Glob patterns ending with `/*` are expanded into their concrete
+ * sub-directory names by reading the filesystem. Hidden directories
+ * (names starting with `.`) are excluded from the expansion.
+ *
+ * @param repoRoot - Absolute path to the repository root containing `pnpm-workspace.yaml`.
+ * @returns The parsed {@link PnpmWorkspace} with fully-resolved package paths.
+ * @throws {Error} If the YAML file is missing or lacks a valid `packages` array.
+ */
 export declare const readWorkspaceYaml: (repoRoot: string) => Promise<PnpmWorkspace>;
-/** @internal test-only */
+/**
+ * Reset the cached workspace root to `null`.
+ *
+ * @internal
+ *
+ * @remarks
+ * Intended for test isolation only — clears the module-level cache so that
+ * {@link findWorkspaceRoot} re-discovers the workspace on the next call.
+ */
 export declare const __resetWorkspaceRoot: () => void;
 //# sourceMappingURL=workspace.common.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workspace.common.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace.common.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAIrC,eAAO,MAAM,6BAA6B,oBAAoB,CAAC;AAE/D,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,iBAKhB,CAAC;AAIhC,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,KAChB,OAAO,CAAC,aAAa,CAyDvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,KACf,OAAO,CAAC,aAAa,CAuBvB,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,oBAAoB,YAEhC,CAAC"}
+{"version":3,"file":"workspace.common.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace.common.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAIrC;;GAEG;AACH,eAAO,MAAM,6BAA6B,oBAAoB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,iBAKhB,CAAC;AAIhC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,KAChB,OAAO,CAAC,aAAa,CAyDvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,KACf,OAAO,CAAC,aAAa,CAuBvB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,YAEhC,CAAC"}

package/dist/workspace/workspace.common.js

@@ -2,13 +2,34 @@ import { readdir, readFile } from "node:fs/promises";
 import { WorkspaceFileType, } from "../types/types.workspace.js";
 import { join } from "node:path";
 import { parse } from "yaml";
+/**
+ * File extension used to identify VS Code / editor workspace files.
+ */
 export const DEFAULT_WORKSPACE_FILE_ENDING = ".code-workspace";
+/**
+ * Classify a filename into a {@link WorkspaceFileType}.
+ *
+ * @param filename - The base filename to classify (e.g. `"package.json"`).
+ * @returns The corresponding {@link WorkspaceFileType} enum value.
+ */
 export const getFileType = (filename) => filename.endsWith(DEFAULT_WORKSPACE_FILE_ENDING)
     ? WorkspaceFileType.workspace
     : filename === "package.json"
         ? WorkspaceFileType.package
         : WorkspaceFileType.other;
 let __workspaceRoot = null;
+/**
+ * Walk up the directory tree from `startPath` to locate the workspace root.
+ *
+ * @remarks
+ * The search runs every ancestor directory in parallel. A `.code-workspace`
+ * file is preferred over a bare `package.json`. The result is cached so that
+ * subsequent calls return immediately.
+ *
+ * @param startPath - Absolute path from which to begin the upward search.
+ * @returns The {@link WorkspaceFile} describing the workspace root.
+ * @throws {Error} If no workspace or package file is found in any ancestor.
+ */
 export const findWorkspaceRoot = async (startPath) => {
     if (__workspaceRoot)
         return __workspaceRoot;
@@ -58,6 +79,18 @@ export const findWorkspaceRoot = async (startPath) => {
     __workspaceRoot = result;
     return result;
 };
+/**
+ * Parse the `pnpm-workspace.yaml` file at the given repository root.
+ *
+ * @remarks
+ * Glob patterns ending with `/*` are expanded into their concrete
+ * sub-directory names by reading the filesystem. Hidden directories
+ * (names starting with `.`) are excluded from the expansion.
+ *
+ * @param repoRoot - Absolute path to the repository root containing `pnpm-workspace.yaml`.
+ * @returns The parsed {@link PnpmWorkspace} with fully-resolved package paths.
+ * @throws {Error} If the YAML file is missing or lacks a valid `packages` array.
+ */
 export const readWorkspaceYaml = async (repoRoot) => {
     const workspaceFilePath = join(repoRoot, "pnpm-workspace.yaml");
     const fileContent = await readFile(workspaceFilePath, "utf8");
@@ -75,7 +108,15 @@ export const readWorkspaceYaml = async (repoRoot) => {
     }))).flat();
     return { packages };
 };
-/** @internal test-only */
+/**
+ * Reset the cached workspace root to `null`.
+ *
+ * @internal
+ *
+ * @remarks
+ * Intended for test isolation only — clears the module-level cache so that
+ * {@link findWorkspaceRoot} re-discovers the workspace on the next call.
+ */
 export const __resetWorkspaceRoot = () => {
     __workspaceRoot = null;
 };

package/dist/workspace/workspace.common.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.common.js","sourceRoot":"","sources":["../../src/workspace/workspace.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAGL,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,MAAM,CAAC,MAAM,6BAA6B,GAAG,iBAAiB,CAAC;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAqB,EAAE,CACjE,QAAQ,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC9C,CAAC,CAAC,iBAAiB,CAAC,SAAS;IAC7B,CAAC,CAAC,QAAQ,KAAK,cAAc;QAC3B,CAAC,CAAC,iBAAiB,CAAC,OAAO;QAC3B,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC;AAEhC,IAAI,eAAe,GAAyB,IAAI,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,SAAiB,EACO,EAAE;IAC1B,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAC5C,IAAI,IAAI,GAAG,SAAS,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAE9C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,CAAC,KAAK,IAAI,EAAE;YACV,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,KAAK,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,GAAG,GAAyB,IAAI,CAAC;YAErC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAErC,IAAI,IAAI,KAAK,iBAAiB,CAAC,SAAS;oBACtC,OAAO;wBACL,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC;wBACvC,OAAO,EAAE,WAAW;wBACpB,QAAQ,EAAE,KAAK,CAAC,IAAI;wBACpB,KAAK,EAAE,CAAC;wBACR,IAAI;qBACL,CAAC;gBAEJ,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,iBAAiB,CAAC,OAAO;oBAC5C,GAAG,GAAG;wBACJ,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC;wBACvC,OAAO,EAAE,WAAW;wBACpB,QAAQ,EAAE,KAAK,CAAC,IAAI;wBACpB,KAAK,EAAE,CAAC;wBACR,IAAI;qBACL,CAAC;YACN,CAAC;YAED,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9B,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,EAAE,CACL,CAAC;QACF,KAAK,EAAE,CAAC;QACR,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CACzD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAChC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtD,MAAM,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,SAAS,CAAC,EAAE,KAAK;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAEzE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,eAAe,GAAG,MAAM,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,QAAgB,EACQ,EAAE;IAC1B,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAA2B,CAAC;IAE5D,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAEtE,MAAM,QAAQ,GAAa,CACzB,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC9B,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAEjD,OAAO,IAAI;aACR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CACH,CACF,CAAC,IAAI,EAAE,CAAC;IAET,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE;IACvC,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC,CAAC","sourcesContent":["import { readdir, readFile } from \"node:fs/promises\";\nimport {\n  PnpmWorkspace,\n  WorkspaceFile,\n  WorkspaceFileType,\n} from \"../types/types.workspace.js\";\nimport { join } from \"node:path\";\nimport { parse } from \"yaml\";\n\nexport const DEFAULT_WORKSPACE_FILE_ENDING = \".code-workspace\";\n\nexport const getFileType = (filename: string): WorkspaceFileType =>\n  filename.endsWith(DEFAULT_WORKSPACE_FILE_ENDING)\n    ? WorkspaceFileType.workspace\n    : filename === \"package.json\"\n      ? WorkspaceFileType.package\n      : WorkspaceFileType.other;\n\nlet __workspaceRoot: WorkspaceFile | null = null;\n\nexport const findWorkspaceRoot = async (\n  startPath: string,\n): Promise<WorkspaceFile> => {\n  if (__workspaceRoot) return __workspaceRoot;\n  let path = startPath;\n  let level = 0;\n  const promises: Promise<WorkspaceFile>[] = [];\n\n  while (path.length > 0) {\n    promises.push(\n      (async () => {\n        const workingPath = path.substring(0);\n        const l = level;\n        const entries = await readdir(workingPath, { withFileTypes: true });\n        let pkg: WorkspaceFile | null = null;\n\n        for (const entry of entries) {\n          if (!entry.isFile()) continue;\n          const type = getFileType(entry.name);\n\n          if (type === WorkspaceFileType.workspace)\n            return {\n              filePath: join(workingPath, entry.name),\n              dirPath: workingPath,\n              filename: entry.name,\n              level: l,\n              type,\n            };\n\n          if (!pkg && type === WorkspaceFileType.package)\n            pkg = {\n              filePath: join(workingPath, entry.name),\n              dirPath: workingPath,\n              filename: entry.name,\n              level: l,\n              type,\n            };\n        }\n\n        if (!pkg) throw new Error(\"\");\n        return pkg;\n      })(),\n    );\n    level++;\n    path = path.replace(/\\/?[^\\/]+\\/?$/, \"\"); // remove last dir\n  }\n\n  const results = (await Promise.allSettled(promises)).filter(\n    (r) => r.status === \"fulfilled\",\n  );\n  results.sort((a, b) => a.value.level - b.value.level);\n\n  const result =\n    results.find((r) => r.value.type === WorkspaceFileType.workspace)?.value ??\n    results.find((r) => r.value.type === WorkspaceFileType.package)?.value;\n\n  if (!result) throw new Error(\"findWorkspaceRoot: no file found\");\n  __workspaceRoot = result;\n  return result;\n};\n\nexport const readWorkspaceYaml = async (\n  repoRoot: string,\n): Promise<PnpmWorkspace> => {\n  const workspaceFilePath = join(repoRoot, \"pnpm-workspace.yaml\");\n  const fileContent = await readFile(workspaceFilePath, \"utf8\");\n  const parsed = parse(fileContent) as Partial<PnpmWorkspace>;\n\n  if (!parsed || !parsed.packages || !Array.isArray(parsed.packages))\n    throw new Error(\"No 'packages' field found in pnpm-workspace.yaml\");\n\n  const packages: string[] = (\n    await Promise.all(\n      parsed.packages.map(async (p) => {\n        if (!p.endsWith(\"/*\")) return [p];\n        const base = p.substring(0, p.length - 2);\n        const pkgs = await readdir(join(repoRoot, base));\n\n        return pkgs\n          .filter((pkg) => !pkg.startsWith(\".\"))\n          .map((pkg) => join(base, pkg));\n      }),\n    )\n  ).flat();\n\n  return { packages };\n};\n\n/** @internal test-only */\nexport const __resetWorkspaceRoot = () => {\n  __workspaceRoot = null;\n};\n"]}
+{"version":3,"file":"workspace.common.js","sourceRoot":"","sources":["../../src/workspace/workspace.common.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdir, readFile } from \"node:fs/promises\";\nimport {\n  PnpmWorkspace,\n  WorkspaceFile,\n  WorkspaceFileType,\n} from \"../types/types.workspace.js\";\nimport { join } from \"node:path\";\nimport { parse } from \"yaml\";\n\n/**\n * File extension used to identify VS Code / editor workspace files.\n */\nexport const DEFAULT_WORKSPACE_FILE_ENDING = \".code-workspace\";\n\n/**\n * Classify a filename into a {@link WorkspaceFileType}.\n *\n * @param filename - The base filename to classify (e.g. `\"package.json\"`).\n * @returns The corresponding {@link WorkspaceFileType} enum value.\n */\nexport const getFileType = (filename: string): WorkspaceFileType =>\n  filename.endsWith(DEFAULT_WORKSPACE_FILE_ENDING)\n    ? WorkspaceFileType.workspace\n    : filename === \"package.json\"\n      ? WorkspaceFileType.package\n      : WorkspaceFileType.other;\n\nlet __workspaceRoot: WorkspaceFile | null = null;\n\n/**\n * Walk up the directory tree from `startPath` to locate the workspace root.\n *\n * @remarks\n * The search runs every ancestor directory in parallel. A `.code-workspace`\n * file is preferred over a bare `package.json`. The result is cached so that\n * subsequent calls return immediately.\n *\n * @param startPath - Absolute path from which to begin the upward search.\n * @returns The {@link WorkspaceFile} describing the workspace root.\n * @throws {Error} If no workspace or package file is found in any ancestor.\n */\nexport const findWorkspaceRoot = async (\n  startPath: string,\n): Promise<WorkspaceFile> => {\n  if (__workspaceRoot) return __workspaceRoot;\n  let path = startPath;\n  let level = 0;\n  const promises: Promise<WorkspaceFile>[] = [];\n\n  while (path.length > 0) {\n    promises.push(\n      (async () => {\n        const workingPath = path.substring(0);\n        const l = level;\n        const entries = await readdir(workingPath, { withFileTypes: true });\n        let pkg: WorkspaceFile | null = null;\n\n        for (const entry of entries) {\n          if (!entry.isFile()) continue;\n          const type = getFileType(entry.name);\n\n          if (type === WorkspaceFileType.workspace)\n            return {\n              filePath: join(workingPath, entry.name),\n              dirPath: workingPath,\n              filename: entry.name,\n              level: l,\n              type,\n            };\n\n          if (!pkg && type === WorkspaceFileType.package)\n            pkg = {\n              filePath: join(workingPath, entry.name),\n              dirPath: workingPath,\n              filename: entry.name,\n              level: l,\n              type,\n            };\n        }\n\n        if (!pkg) throw new Error(\"\");\n        return pkg;\n      })(),\n    );\n    level++;\n    path = path.replace(/\\/?[^\\/]+\\/?$/, \"\"); // remove last dir\n  }\n\n  const results = (await Promise.allSettled(promises)).filter(\n    (r) => r.status === \"fulfilled\",\n  );\n  results.sort((a, b) => a.value.level - b.value.level);\n\n  const result =\n    results.find((r) => r.value.type === WorkspaceFileType.workspace)?.value ??\n    results.find((r) => r.value.type === WorkspaceFileType.package)?.value;\n\n  if (!result) throw new Error(\"findWorkspaceRoot: no file found\");\n  __workspaceRoot = result;\n  return result;\n};\n\n/**\n * Parse the `pnpm-workspace.yaml` file at the given repository root.\n *\n * @remarks\n * Glob patterns ending with `/*` are expanded into their concrete\n * sub-directory names by reading the filesystem. Hidden directories\n * (names starting with `.`) are excluded from the expansion.\n *\n * @param repoRoot - Absolute path to the repository root containing `pnpm-workspace.yaml`.\n * @returns The parsed {@link PnpmWorkspace} with fully-resolved package paths.\n * @throws {Error} If the YAML file is missing or lacks a valid `packages` array.\n */\nexport const readWorkspaceYaml = async (\n  repoRoot: string,\n): Promise<PnpmWorkspace> => {\n  const workspaceFilePath = join(repoRoot, \"pnpm-workspace.yaml\");\n  const fileContent = await readFile(workspaceFilePath, \"utf8\");\n  const parsed = parse(fileContent) as Partial<PnpmWorkspace>;\n\n  if (!parsed || !parsed.packages || !Array.isArray(parsed.packages))\n    throw new Error(\"No 'packages' field found in pnpm-workspace.yaml\");\n\n  const packages: string[] = (\n    await Promise.all(\n      parsed.packages.map(async (p) => {\n        if (!p.endsWith(\"/*\")) return [p];\n        const base = p.substring(0, p.length - 2);\n        const pkgs = await readdir(join(repoRoot, base));\n\n        return pkgs\n          .filter((pkg) => !pkg.startsWith(\".\"))\n          .map((pkg) => join(base, pkg));\n      }),\n    )\n  ).flat();\n\n  return { packages };\n};\n\n/**\n * Reset the cached workspace root to `null`.\n *\n * @internal\n *\n * @remarks\n * Intended for test isolation only — clears the module-level cache so that\n * {@link findWorkspaceRoot} re-discovers the workspace on the next call.\n */\nexport const __resetWorkspaceRoot = () => {\n  __workspaceRoot = null;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxpicture/build-api",
-  "version": "0.2.56",
+  "version": "0.2.58",
   "description": "Build utilities API",
   "type": "module",
   "author": "MXPicture",
@@ -42,9 +42,11 @@
   "dependencies": {
     "@mxpicture/dep-analyzer": "^0.1.0",
     "@types/micromatch": "^4.0.10",
+    "glob": "^13.0.6",
     "json5": "^2.2.3",
     "micromatch": "^4.0.8",
     "prettier": "^3.8.1",
+    "resolve.exports": "^2.0.3",
     "simple-git": "^3.32.3",
     "typescript": "^5.9.3",
     "yaml": "^2.8.2"