@mxpicture/build-api 0.2.56 → 0.2.58

package/dist/types/types.changelog.d.ts

@@ -1,14 +1,42 @@
 import { DocumentData } from "./types.documents.js";
+/**
+ * Enumeration of change-watch source types.
+ *
+ * @remarks
+ * Determines how file changes are detected — either via a changelog file
+ * or by inspecting git history.
+ */
 export declare enum ChangeWatchType {
+    /** Watch for changes recorded in a changelog file. */
     changelog = "changelog",
+    /** Watch for changes derived from git commit history. */
     gitHistory = "gitHistory"
 }
+/**
+ * Configuration for a single change-watch rule.
+ */
 export interface ChangeWatch {
+    /** Glob pattern that identifies the files to watch. */
     pattern: string;
+    /** The source type used to detect changes. */
     type: ChangeWatchType;
 }
+/**
+ * Callback invoked when watched files change.
+ *
+ * @typeParam T - The document data shape returned by the handler.
+ * @param paths - Absolute paths of the files that changed.
+ * @param watch - The change-watch rule that triggered this event.
+ * @returns A promise resolving to the resulting document data, or `null` if no data was produced.
+ */
 export type ChangeEventHandler<T extends DocumentData> = (paths: string[], watch: ChangeWatch) => Promise<T | null>;
+/**
+ * A change-watch rule paired with its event handler.
+ *
+ * @typeParam T - The document data shape returned by the handler.
+ */
 export interface ChangeWatchHandler<T extends DocumentData> extends ChangeWatch {
+    /** The handler function to invoke when matching files change. */
     handler: ChangeEventHandler<T>;
 }
 //# sourceMappingURL=types.changelog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.changelog.d.ts","sourceRoot":"","sources":["../../src/types/types.changelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,oBAAY,eAAe;IACzB,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,YAAY,IAAI,CACvD,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,WAAW,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAEvB,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,YAAY,CACtB,SAAQ,WAAW;IACnB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAChC"}
+{"version":3,"file":"types.changelog.d.ts","sourceRoot":"","sources":["../../src/types/types.changelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;GAMG;AACH,oBAAY,eAAe;IACzB,sDAAsD;IACtD,SAAS,cAAc;IACvB,yDAAyD;IACzD,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,eAAe,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,YAAY,IAAI,CACvD,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,WAAW,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAEvB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,YAAY,CACtB,SAAQ,WAAW;IACnB,iEAAiE;IACjE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAChC"}

package/dist/types/types.changelog.js

@@ -1,6 +1,15 @@
+/**
+ * Enumeration of change-watch source types.
+ *
+ * @remarks
+ * Determines how file changes are detected — either via a changelog file
+ * or by inspecting git history.
+ */
 export var ChangeWatchType;
 (function (ChangeWatchType) {
+    /** Watch for changes recorded in a changelog file. */
     ChangeWatchType["changelog"] = "changelog";
+    /** Watch for changes derived from git commit history. */
     ChangeWatchType["gitHistory"] = "gitHistory";
 })(ChangeWatchType || (ChangeWatchType = {}));
 //# sourceMappingURL=types.changelog.js.map

package/dist/types/types.changelog.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.changelog.js","sourceRoot":"","sources":["../../src/types/types.changelog.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;AAC3B,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B","sourcesContent":["import { DocumentData } from \"./types.documents.js\";\n\nexport enum ChangeWatchType {\n  changelog = \"changelog\",\n  gitHistory = \"gitHistory\",\n}\n\nexport interface ChangeWatch {\n  pattern: string;\n  type: ChangeWatchType;\n}\n\nexport type ChangeEventHandler<T extends DocumentData> = (\n  paths: string[],\n  watch: ChangeWatch,\n) => Promise<T | null>;\n\nexport interface ChangeWatchHandler<\n  T extends DocumentData,\n> extends ChangeWatch {\n  handler: ChangeEventHandler<T>;\n}\n"]}
+{"version":3,"file":"types.changelog.js","sourceRoot":"","sources":["../../src/types/types.changelog.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,sDAAsD;IACtD,0CAAuB,CAAA;IACvB,yDAAyD;IACzD,4CAAyB,CAAA;AAC3B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B","sourcesContent":["import { DocumentData } from \"./types.documents.js\";\n\n/**\n * Enumeration of change-watch source types.\n *\n * @remarks\n * Determines how file changes are detected — either via a changelog file\n * or by inspecting git history.\n */\nexport enum ChangeWatchType {\n  /** Watch for changes recorded in a changelog file. */\n  changelog = \"changelog\",\n  /** Watch for changes derived from git commit history. */\n  gitHistory = \"gitHistory\",\n}\n\n/**\n * Configuration for a single change-watch rule.\n */\nexport interface ChangeWatch {\n  /** Glob pattern that identifies the files to watch. */\n  pattern: string;\n  /** The source type used to detect changes. */\n  type: ChangeWatchType;\n}\n\n/**\n * Callback invoked when watched files change.\n *\n * @typeParam T - The document data shape returned by the handler.\n * @param paths - Absolute paths of the files that changed.\n * @param watch - The change-watch rule that triggered this event.\n * @returns A promise resolving to the resulting document data, or `null` if no data was produced.\n */\nexport type ChangeEventHandler<T extends DocumentData> = (\n  paths: string[],\n  watch: ChangeWatch,\n) => Promise<T | null>;\n\n/**\n * A change-watch rule paired with its event handler.\n *\n * @typeParam T - The document data shape returned by the handler.\n */\nexport interface ChangeWatchHandler<\n  T extends DocumentData,\n> extends ChangeWatch {\n  /** The handler function to invoke when matching files change. */\n  handler: ChangeEventHandler<T>;\n}\n"]}

package/dist/types/types.cleanup.d.ts

@@ -1,13 +1,32 @@
 import { RunRepoRootParams } from "./types.run.js";
+/**
+ * Describes an item that is scheduled for deletion.
+ */
 export interface ToBeDeleted {
+    /** Name (file or directory) to delete. */
     name: string;
+    /** Optional suffix appended to the name when moving instead of deleting. */
     moveSuffix?: string;
 }
+/**
+ * A resolved cleanup target with full path information.
+ *
+ * @remarks
+ * Extends {@link ToBeDeleted} with absolute path details so the cleanup
+ * operation knows exactly where to find the item and, optionally, where
+ * to move it.
+ */
 export interface ToCleanup extends ToBeDeleted {
+    /** Absolute path of the item to clean up. */
     path: string;
+    /** Absolute destination path when moving rather than deleting. */
     moveTo?: string;
 }
+/**
+ * Parameters for running a cleanup operation across a repository.
+ */
 export interface CleanupParams extends RunRepoRootParams {
+    /** Items to delete or move during cleanup. */
     toBeDeleted?: ToBeDeleted[];
 }
 //# sourceMappingURL=types.cleanup.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.cleanup.d.ts","sourceRoot":"","sources":["../../src/types/types.cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"types.cleanup.d.ts","sourceRoot":"","sources":["../../src/types/types.cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,8CAA8C;IAC9C,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC7B"}

package/dist/types/types.cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.cleanup.js","sourceRoot":"","sources":["../../src/types/types.cleanup.ts"],"names":[],"mappings":"","sourcesContent":["import { RunRepoRootParams } from \"./types.run.js\";\n\nexport interface ToBeDeleted {\n  name: string;\n  moveSuffix?: string;\n}\n\nexport interface ToCleanup extends ToBeDeleted {\n  path: string;\n  moveTo?: string;\n}\n\nexport interface CleanupParams extends RunRepoRootParams {\n  toBeDeleted?: ToBeDeleted[];\n}\n"]}
+{"version":3,"file":"types.cleanup.js","sourceRoot":"","sources":["../../src/types/types.cleanup.ts"],"names":[],"mappings":"","sourcesContent":["import { RunRepoRootParams } from \"./types.run.js\";\n\n/**\n * Describes an item that is scheduled for deletion.\n */\nexport interface ToBeDeleted {\n  /** Name (file or directory) to delete. */\n  name: string;\n  /** Optional suffix appended to the name when moving instead of deleting. */\n  moveSuffix?: string;\n}\n\n/**\n * A resolved cleanup target with full path information.\n *\n * @remarks\n * Extends {@link ToBeDeleted} with absolute path details so the cleanup\n * operation knows exactly where to find the item and, optionally, where\n * to move it.\n */\nexport interface ToCleanup extends ToBeDeleted {\n  /** Absolute path of the item to clean up. */\n  path: string;\n  /** Absolute destination path when moving rather than deleting. */\n  moveTo?: string;\n}\n\n/**\n * Parameters for running a cleanup operation across a repository.\n */\nexport interface CleanupParams extends RunRepoRootParams {\n  /** Items to delete or move during cleanup. */\n  toBeDeleted?: ToBeDeleted[];\n}\n"]}

package/dist/types/types.code.d.ts

@@ -1,28 +1,64 @@
 import ts from "typescript";
+/**
+ * A parsed TypeScript source file together with its type checker.
+ *
+ * @remarks
+ * Bundles the file path, the compiler's {@link ts.SourceFile} AST node,
+ * and the {@link ts.TypeChecker} so that downstream consumers can perform
+ * type-aware analysis without re-creating a program.
+ */
 export interface SourceFile {
+    /** Absolute path to the TypeScript source file. */
     filePath: string;
+    /** The TypeScript type checker associated with this file's program. */
     checker: ts.TypeChecker;
+    /** The parsed AST representation of the source file. */
     sourceFile: ts.SourceFile;
 }
+/**
+ * Metadata for a single exported symbol within a source file.
+ */
 export interface SourceExportItem {
+    /** Export name (e.g. `"foo"`, `"default"`). */
     name: string;
+    /** Human-readable kind of the export (e.g. `"function"`, `"class"`, `"type"`). */
     kind: string;
+    /** Whether TypeScript considers this export type-only. */
     isTypeOnly: boolean;
+    /** Whether the export originates from another module via `export … from` or `export *`. */
     isReExport: boolean;
+    /** Declaration kind strings useful for debugging (e.g. `["FunctionDeclaration"]`). */
     declarations: string[];
 }
+/**
+ * The complete set of exports discovered in a single source file.
+ */
 export interface SourceExport {
+    /** Individual export items found in the file. */
     items: SourceExportItem[];
+    /** Whether the file uses selective (named) exports rather than `export *`. */
     selectiveExport: boolean;
 }
+/**
+ * Parameters for extracting exports from a TypeScript file.
+ */
 export interface FileExportsParams {
+    /** Absolute path to the file whose exports should be extracted. */
     filePath: string;
+    /**
+     * Optional flags that control which exports are included in the result.
+     */
     opts?: {
+        /** Include type-only exports (e.g. `export type { Foo }`). */
         includeTypeOnly?: boolean;
+        /** Include re-exports originating from other modules. */
         includeReExports?: boolean;
+        /** Include the `default` export. */
         includeDefault?: boolean;
+        /** Include exports marked as private by convention. */
         includePrivate?: boolean;
     };
+    /** A pre-built {@link SourceFile} to reuse, avoiding redundant parsing. */
     preBuiltSource?: SourceFile;
 }
 //# sourceMappingURL=types.code.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.code.d.ts","sourceRoot":"","sources":["../../src/types/types.code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B"}
+{"version":3,"file":"types.code.d.ts","sourceRoot":"","sources":["../../src/types/types.code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,wDAAwD;IACxD,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,2FAA2F;IAC3F,UAAU,EAAE,OAAO,CAAC;IACpB,sFAAsF;IACtF,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,8DAA8D;QAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,yDAAyD;QACzD,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,oCAAoC;QACpC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,uDAAuD;QACvD,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,2EAA2E;IAC3E,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B"}

package/dist/types/types.code.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.code.js","sourceRoot":"","sources":["../../src/types/types.code.ts"],"names":[],"mappings":"","sourcesContent":["import ts from \"typescript\";\n\nexport interface SourceFile {\n  filePath: string;\n  checker: ts.TypeChecker;\n  sourceFile: ts.SourceFile;\n}\n\nexport interface SourceExportItem {\n  name: string; // export name (e.g. \"foo\", \"default\")\n  kind: string; // human-ish kind (e.g. \"function\", \"class\", \"type\", \"namespace\", \"unknown\")\n  isTypeOnly: boolean; // true if TS considers it type-only\n  isReExport: boolean; // true if it comes from another module via export-from / export *\n  declarations: string[]; // declaration kinds for debugging (e.g. [\"FunctionDeclaration\"])\n}\n\nexport interface SourceExport {\n  items: SourceExportItem[];\n  selectiveExport: boolean;\n}\n\nexport interface FileExportsParams {\n  filePath: string;\n  opts?: {\n    includeTypeOnly?: boolean;\n    includeReExports?: boolean;\n    includeDefault?: boolean;\n    includePrivate?: boolean;\n  };\n  preBuiltSource?: SourceFile;\n}\n"]}
+{"version":3,"file":"types.code.js","sourceRoot":"","sources":["../../src/types/types.code.ts"],"names":[],"mappings":"","sourcesContent":["import ts from \"typescript\";\n\n/**\n * A parsed TypeScript source file together with its type checker.\n *\n * @remarks\n * Bundles the file path, the compiler's {@link ts.SourceFile} AST node,\n * and the {@link ts.TypeChecker} so that downstream consumers can perform\n * type-aware analysis without re-creating a program.\n */\nexport interface SourceFile {\n  /** Absolute path to the TypeScript source file. */\n  filePath: string;\n  /** The TypeScript type checker associated with this file's program. */\n  checker: ts.TypeChecker;\n  /** The parsed AST representation of the source file. */\n  sourceFile: ts.SourceFile;\n}\n\n/**\n * Metadata for a single exported symbol within a source file.\n */\nexport interface SourceExportItem {\n  /** Export name (e.g. `\"foo\"`, `\"default\"`). */\n  name: string;\n  /** Human-readable kind of the export (e.g. `\"function\"`, `\"class\"`, `\"type\"`). */\n  kind: string;\n  /** Whether TypeScript considers this export type-only. */\n  isTypeOnly: boolean;\n  /** Whether the export originates from another module via `export … from` or `export *`. */\n  isReExport: boolean;\n  /** Declaration kind strings useful for debugging (e.g. `[\"FunctionDeclaration\"]`). */\n  declarations: string[];\n}\n\n/**\n * The complete set of exports discovered in a single source file.\n */\nexport interface SourceExport {\n  /** Individual export items found in the file. */\n  items: SourceExportItem[];\n  /** Whether the file uses selective (named) exports rather than `export *`. */\n  selectiveExport: boolean;\n}\n\n/**\n * Parameters for extracting exports from a TypeScript file.\n */\nexport interface FileExportsParams {\n  /** Absolute path to the file whose exports should be extracted. */\n  filePath: string;\n  /**\n   * Optional flags that control which exports are included in the result.\n   */\n  opts?: {\n    /** Include type-only exports (e.g. `export type { Foo }`). */\n    includeTypeOnly?: boolean;\n    /** Include re-exports originating from other modules. */\n    includeReExports?: boolean;\n    /** Include the `default` export. */\n    includeDefault?: boolean;\n    /** Include exports marked as private by convention. */\n    includePrivate?: boolean;\n  };\n  /** A pre-built {@link SourceFile} to reuse, avoiding redundant parsing. */\n  preBuiltSource?: SourceFile;\n}\n"]}

package/dist/types/types.deps.d.ts

@@ -1,26 +1,53 @@
 import type { Pkg } from "../pkg/Pkg.js";
 import { MapEntry } from "./types.package.js";
 import { RunRepoRootParams } from "./types.run.js";
+/**
+ * The processing mode for workspace dependency operations.
+ */
 export declare enum DepsProcessMode {
+    /** Fix workspace dependency references to concrete values. */
     fix = "fix",
+    /** Restore workspace dependency references to their original form. */
     restore = "restore"
 }
+/**
+ * The replacement strategy used when fixing workspace dependencies.
+ */
 export declare enum DepsReplacementMode {
+    /** Replace workspace references with concrete version strings. */
     version = "version",
+    /** Replace workspace references with `file:` protocol paths. */
     file = "file"
 }
+/**
+ * Core data required to fix workspace dependencies for a consuming package.
+ */
 export interface FixWorkspaceDepsMain {
+    /** Mapping entries that describe package-to-package relationships. */
     mapEntries: MapEntry[];
+    /** The package whose dependencies are being fixed. */
     consumingPkg: Pkg;
+    /** Map of package names to their resolved version strings. */
     versionMap: Map<string, string>;
+    /** Set of package names that belong to the workspace. */
     workspacePackages: Set<string>;
 }
+/**
+ * Extended dependency-fix data for a specific workspace package and version.
+ */
 export interface FixWorkspaceDepsData extends FixWorkspaceDepsMain {
+    /** The name of the dependency package being processed. */
     pkg: string;
+    /** The resolved version string for the dependency. */
     version: string;
 }
+/**
+ * Parameters for running a workspace dependency fix or restore operation.
+ */
 export interface FixWorkspaceDepsParams extends RunRepoRootParams {
+    /** Whether to fix or restore workspace dependency references. */
     mode: DepsProcessMode;
+    /** The replacement strategy to apply. */
     replacement: DepsReplacementMode;
 }
 //# sourceMappingURL=types.deps.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.deps.d.ts","sourceRoot":"","sources":["../../src/types/types.deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB;AAED,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC;IAClB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,mBAAmB,CAAC;CAClC"}
+{"version":3,"file":"types.deps.d.ts","sourceRoot":"","sources":["../../src/types/types.deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,oBAAY,eAAe;IACzB,8DAA8D;IAC9D,GAAG,QAAQ;IACX,sEAAsE;IACtE,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,kEAAkE;IAClE,OAAO,YAAY;IACnB,gEAAgE;IAChE,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,sDAAsD;IACtD,YAAY,EAAE,GAAG,CAAC;IAClB,8DAA8D;IAC9D,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yDAAyD;IACzD,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,iEAAiE;IACjE,IAAI,EAAE,eAAe,CAAC;IACtB,yCAAyC;IACzC,WAAW,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/types/types.deps.js

@@ -1,11 +1,21 @@
+/**
+ * The processing mode for workspace dependency operations.
+ */
 export var DepsProcessMode;
 (function (DepsProcessMode) {
+    /** Fix workspace dependency references to concrete values. */
     DepsProcessMode["fix"] = "fix";
+    /** Restore workspace dependency references to their original form. */
     DepsProcessMode["restore"] = "restore";
 })(DepsProcessMode || (DepsProcessMode = {}));
+/**
+ * The replacement strategy used when fixing workspace dependencies.
+ */
 export var DepsReplacementMode;
 (function (DepsReplacementMode) {
+    /** Replace workspace references with concrete version strings. */
     DepsReplacementMode["version"] = "version";
+    /** Replace workspace references with `file:` protocol paths. */
     DepsReplacementMode["file"] = "file";
 })(DepsReplacementMode || (DepsReplacementMode = {}));
 //# sourceMappingURL=types.deps.js.map

package/dist/types/types.deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.deps.js","sourceRoot":"","sources":["../../src/types/types.deps.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,oCAAa,CAAA;AACf,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B","sourcesContent":["import type { Pkg } from \"../pkg/Pkg.js\";\nimport { MapEntry } from \"./types.package.js\";\nimport { RunRepoRootParams } from \"./types.run.js\";\n\nexport enum DepsProcessMode {\n  fix = \"fix\",\n  restore = \"restore\",\n}\n\nexport enum DepsReplacementMode {\n  version = \"version\",\n  file = \"file\",\n}\n\nexport interface FixWorkspaceDepsMain {\n  mapEntries: MapEntry[];\n  consumingPkg: Pkg;\n  versionMap: Map<string, string>;\n  workspacePackages: Set<string>;\n}\n\nexport interface FixWorkspaceDepsData extends FixWorkspaceDepsMain {\n  pkg: string;\n  version: string;\n}\n\nexport interface FixWorkspaceDepsParams extends RunRepoRootParams {\n  mode: DepsProcessMode;\n  replacement: DepsReplacementMode;\n}\n"]}
+{"version":3,"file":"types.deps.js","sourceRoot":"","sources":["../../src/types/types.deps.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,8DAA8D;IAC9D,8BAAW,CAAA;IACX,sEAAsE;IACtE,sCAAmB,CAAA;AACrB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,kEAAkE;IAClE,0CAAmB,CAAA;IACnB,gEAAgE;IAChE,oCAAa,CAAA;AACf,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B","sourcesContent":["import type { Pkg } from \"../pkg/Pkg.js\";\nimport { MapEntry } from \"./types.package.js\";\nimport { RunRepoRootParams } from \"./types.run.js\";\n\n/**\n * The processing mode for workspace dependency operations.\n */\nexport enum DepsProcessMode {\n  /** Fix workspace dependency references to concrete values. */\n  fix = \"fix\",\n  /** Restore workspace dependency references to their original form. */\n  restore = \"restore\",\n}\n\n/**\n * The replacement strategy used when fixing workspace dependencies.\n */\nexport enum DepsReplacementMode {\n  /** Replace workspace references with concrete version strings. */\n  version = \"version\",\n  /** Replace workspace references with `file:` protocol paths. */\n  file = \"file\",\n}\n\n/**\n * Core data required to fix workspace dependencies for a consuming package.\n */\nexport interface FixWorkspaceDepsMain {\n  /** Mapping entries that describe package-to-package relationships. */\n  mapEntries: MapEntry[];\n  /** The package whose dependencies are being fixed. */\n  consumingPkg: Pkg;\n  /** Map of package names to their resolved version strings. */\n  versionMap: Map<string, string>;\n  /** Set of package names that belong to the workspace. */\n  workspacePackages: Set<string>;\n}\n\n/**\n * Extended dependency-fix data for a specific workspace package and version.\n */\nexport interface FixWorkspaceDepsData extends FixWorkspaceDepsMain {\n  /** The name of the dependency package being processed. */\n  pkg: string;\n  /** The resolved version string for the dependency. */\n  version: string;\n}\n\n/**\n * Parameters for running a workspace dependency fix or restore operation.\n */\nexport interface FixWorkspaceDepsParams extends RunRepoRootParams {\n  /** Whether to fix or restore workspace dependency references. */\n  mode: DepsProcessMode;\n  /** The replacement strategy to apply. */\n  replacement: DepsReplacementMode;\n}\n"]}

package/dist/types/types.documents.d.ts

@@ -1,4 +1,13 @@
+/**
+ * The value type for a single field within a document.
+ *
+ * @remarks
+ * Intentionally typed as `any` to allow arbitrary document shapes.
+ */
 export type DocumentFieldValue = any;
+/**
+ * A generic document represented as a string-keyed map of field values.
+ */
 export type DocumentData = {
     [field: string]: DocumentFieldValue;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"types.documents.d.ts","sourceRoot":"","sources":["../../src/types/types.documents.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.documents.d.ts","sourceRoot":"","sources":["../../src/types/types.documents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC"}

package/dist/types/types.documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.documents.js","sourceRoot":"","sources":["../../src/types/types.documents.ts"],"names":[],"mappings":"","sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type DocumentFieldValue = any;\nexport type DocumentData = { [field: string]: DocumentFieldValue };\n"]}
+{"version":3,"file":"types.documents.js","sourceRoot":"","sources":["../../src/types/types.documents.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The value type for a single field within a document.\n *\n * @remarks\n * Intentionally typed as `any` to allow arbitrary document shapes.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type DocumentFieldValue = any;\n\n/**\n * A generic document represented as a string-keyed map of field values.\n */\nexport type DocumentData = { [field: string]: DocumentFieldValue };\n"]}

package/dist/types/types.exports.d.ts

@@ -0,0 +1,42 @@
+import { RunRepoRootParams } from "./types.run.js";
+/**
+ * Represents a discovered export in a package.
+ */
+export interface ExportNode {
+    /** Export name */
+    name: string;
+    /** Type of export (function, object, class, etc.) */
+    kind: string;
+    /** Source entrypoint */
+    source: string;
+}
+/**
+ * Represents a resolved package entrypoint.
+ */
+export interface EntryPoint {
+    /** Import specifier used to load the entrypoint */
+    id: string;
+    /** Absolute path to resolved file */
+    file?: string;
+}
+/**
+ * Final API analysis result.
+ */
+export interface PackageAPI {
+    /** Absolute package root */
+    packageRoot: string;
+    /** All discovered entrypoints */
+    entrypoints: EntryPoint[];
+    /** Runtime exports discovered via module loading */
+    runtimeExports: ExportNode[];
+    /** Type exports discovered via `.d.ts` parsing */
+    typeExports: ExportNode[];
+}
+/**
+ * Parameters for bulk-updating packages that match a pattern.
+ */
+export interface ExportExtractorParams extends RunRepoRootParams {
+    package: string;
+    json?: string;
+}
+//# sourceMappingURL=types.exports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.exports.d.ts","sourceRoot":"","sources":["../../src/types/types.exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IAEX,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,oDAAoD;IACpD,cAAc,EAAE,UAAU,EAAE,CAAC;IAE7B,kDAAkD;IAClD,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/types.exports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.exports.js.map

package/dist/types/types.exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.exports.js","sourceRoot":"","sources":["../../src/types/types.exports.ts"],"names":[],"mappings":"","sourcesContent":["import { RunRepoRootParams } from \"./types.run.js\";\n\n/**\n * Represents a discovered export in a package.\n */\nexport interface ExportNode {\n  /** Export name */\n  name: string;\n\n  /** Type of export (function, object, class, etc.) */\n  kind: string;\n\n  /** Source entrypoint */\n  source: string;\n}\n\n/**\n * Represents a resolved package entrypoint.\n */\nexport interface EntryPoint {\n  /** Import specifier used to load the entrypoint */\n  id: string;\n\n  /** Absolute path to resolved file */\n  file?: string;\n}\n\n/**\n * Final API analysis result.\n */\nexport interface PackageAPI {\n  /** Absolute package root */\n  packageRoot: string;\n\n  /** All discovered entrypoints */\n  entrypoints: EntryPoint[];\n\n  /** Runtime exports discovered via module loading */\n  runtimeExports: ExportNode[];\n\n  /** Type exports discovered via `.d.ts` parsing */\n  typeExports: ExportNode[];\n}\n\n/**\n * Parameters for bulk-updating packages that match a pattern.\n */\nexport interface ExportExtractorParams extends RunRepoRootParams {\n  package: string;\n  json?: string;\n}\n"]}

package/dist/types/types.git.d.ts

@@ -1,23 +1,48 @@
 import type { DiffResult } from "simple-git";
+/**
+ * Result of checking whether a path has changed since a given git reference.
+ */
 export interface GitChangedResult {
+    /** The file or directory path that was checked. */
     path: string;
+    /** The git reference (e.g. commit SHA or tag) used as the baseline. */
     sinceRef: string;
+    /** Whether any changes were detected. */
     hasChanged: boolean;
+    /** List of individual file paths that changed. */
     changedFiles: string[];
 }
+/**
+ * The content of a single file that changed in a git diff.
+ */
 export interface GitChangedContent {
+    /** Absolute file path on disk. */
     absFilePath: string;
+    /** Repository-relative file path. */
     repoFilePath: string;
+    /** File content at the current revision, or `null` if the file was deleted. */
     content: string | null;
 }
+/**
+ * Result of retrieving file contents that changed since a given git reference.
+ */
 export interface GitChangedContentsResult {
+    /** The file or directory path that was checked. */
     path: string;
+    /** The git reference used as the baseline. */
     sinceRef: string;
+    /** The changed files with their content. */
     files: GitChangedContent[];
 }
+/**
+ * A git commit identified by its hash, with optional diff information.
+ */
 export interface GitCommitHash {
+    /** The full SHA hash of the commit. */
     hash: string;
+    /** The ISO-8601 date string of the commit. */
     date: string;
+    /** Optional diff result associated with this commit. */
     diff?: DiffResult;
 }
 //# sourceMappingURL=types.git.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.git.d.ts","sourceRoot":"","sources":["../../src/types/types.git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB"}
+{"version":3,"file":"types.git.d.ts","sourceRoot":"","sources":["../../src/types/types.git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB"}

package/dist/types/types.git.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.git.js","sourceRoot":"","sources":["../../src/types/types.git.ts"],"names":[],"mappings":"","sourcesContent":["import type { DiffResult } from \"simple-git\";\n\nexport interface GitChangedResult {\n  path: string;\n  sinceRef: string;\n  hasChanged: boolean;\n  changedFiles: string[];\n}\n\nexport interface GitChangedContent {\n  absFilePath: string;\n  repoFilePath: string;\n  content: string | null;\n}\n\nexport interface GitChangedContentsResult {\n  path: string;\n  sinceRef: string;\n  files: GitChangedContent[];\n}\n\nexport interface GitCommitHash {\n  hash: string;\n  date: string;\n  diff?: DiffResult;\n}\n"]}
+{"version":3,"file":"types.git.js","sourceRoot":"","sources":["../../src/types/types.git.ts"],"names":[],"mappings":"","sourcesContent":["import type { DiffResult } from \"simple-git\";\n\n/**\n * Result of checking whether a path has changed since a given git reference.\n */\nexport interface GitChangedResult {\n  /** The file or directory path that was checked. */\n  path: string;\n  /** The git reference (e.g. commit SHA or tag) used as the baseline. */\n  sinceRef: string;\n  /** Whether any changes were detected. */\n  hasChanged: boolean;\n  /** List of individual file paths that changed. */\n  changedFiles: string[];\n}\n\n/**\n * The content of a single file that changed in a git diff.\n */\nexport interface GitChangedContent {\n  /** Absolute file path on disk. */\n  absFilePath: string;\n  /** Repository-relative file path. */\n  repoFilePath: string;\n  /** File content at the current revision, or `null` if the file was deleted. */\n  content: string | null;\n}\n\n/**\n * Result of retrieving file contents that changed since a given git reference.\n */\nexport interface GitChangedContentsResult {\n  /** The file or directory path that was checked. */\n  path: string;\n  /** The git reference used as the baseline. */\n  sinceRef: string;\n  /** The changed files with their content. */\n  files: GitChangedContent[];\n}\n\n/**\n * A git commit identified by its hash, with optional diff information.\n */\nexport interface GitCommitHash {\n  /** The full SHA hash of the commit. */\n  hash: string;\n  /** The ISO-8601 date string of the commit. */\n  date: string;\n  /** Optional diff result associated with this commit. */\n  diff?: DiffResult;\n}\n"]}

package/dist/types/types.npm.d.ts

@@ -1,3 +1,10 @@
 import { RunRepoRootParams } from "./types.run.js";
+/**
+ * Parameters for the npm package publisher.
+ *
+ * @remarks
+ * Currently an alias for {@link RunRepoRootParams}; extend this type
+ * to add publisher-specific options in the future.
+ */
 export type NpmPublisherParams = RunRepoRootParams;
 //# sourceMappingURL=types.npm.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.npm.d.ts","sourceRoot":"","sources":["../../src/types/types.npm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"types.npm.d.ts","sourceRoot":"","sources":["../../src/types/types.npm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}

package/dist/types/types.npm.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.npm.js","sourceRoot":"","sources":["../../src/types/types.npm.ts"],"names":[],"mappings":"","sourcesContent":["import { RunRepoRootParams } from \"./types.run.js\";\n\nexport type NpmPublisherParams = RunRepoRootParams;\n"]}
+{"version":3,"file":"types.npm.js","sourceRoot":"","sources":["../../src/types/types.npm.ts"],"names":[],"mappings":"","sourcesContent":["import { RunRepoRootParams } from \"./types.run.js\";\n\n/**\n * Parameters for the npm package publisher.\n *\n * @remarks\n * Currently an alias for {@link RunRepoRootParams}; extend this type\n * to add publisher-specific options in the future.\n */\nexport type NpmPublisherParams = RunRepoRootParams;\n"]}

package/dist/types/types.os.d.ts

@@ -1,8 +1,16 @@
+/**
+ * Information about the current operating-system environment.
+ */
 export interface OSInfo {
+    /** Absolute path to the current user's home directory. */
     homedir: string;
+    /** The login name of the current user. */
     username: string;
+    /** The Node.js platform identifier (e.g. `"linux"`, `"darwin"`, `"win32"`). */
     platform: NodeJS.Platform;
+    /** Absolute path to the application configuration directory. */
     configDir: string;
+    /** Whether the environment is running under Windows Subsystem for Linux. */
     isWSL?: boolean;
 }
 //# sourceMappingURL=types.os.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.os.d.ts","sourceRoot":"","sources":["../../src/types/types.os.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"types.os.d.ts","sourceRoot":"","sources":["../../src/types/types.os.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/types.os.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.os.js","sourceRoot":"","sources":["../../src/types/types.os.ts"],"names":[],"mappings":"","sourcesContent":["export interface OSInfo {\n  homedir: string;\n  username: string;\n  platform: NodeJS.Platform;\n  configDir: string;\n  isWSL?: boolean;\n}\n"]}
+{"version":3,"file":"types.os.js","sourceRoot":"","sources":["../../src/types/types.os.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Information about the current operating-system environment.\n */\nexport interface OSInfo {\n  /** Absolute path to the current user's home directory. */\n  homedir: string;\n  /** The login name of the current user. */\n  username: string;\n  /** The Node.js platform identifier (e.g. `\"linux\"`, `\"darwin\"`, `\"win32\"`). */\n  platform: NodeJS.Platform;\n  /** Absolute path to the application configuration directory. */\n  configDir: string;\n  /** Whether the environment is running under Windows Subsystem for Linux. */\n  isWSL?: boolean;\n}\n"]}

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

@@ -1,37 +1,85 @@
 import type { Pkg } from "../pkg/Pkg.js";
 import { RunRepoRootParams } from "./types.run.js";
+/**
+ * A parsed semantic version split into its numeric components.
+ */
 export interface PackageVersion {
+    /** The major version number. */
     major: number;
+    /** The minor version number. */
     minor: number;
+    /** The patch version number. */
     patch: number;
+    /** An optional prefix such as `"^"` or `"~"`, or `null` if none. */
     prefix: string | null;
 }
+/**
+ * A minimal representation of a `package.json` file.
+ *
+ * @remarks
+ * Contains the most commonly accessed fields and allows arbitrary
+ * additional fields via the index signature.
+ */
 export interface PackageJson {
+    /** The package name as published to npm. */
     name: string;
+    /** Whether the package is marked as private (not publishable). */
     private?: boolean;
+    /** The current version string (semver). */
     version: string;
+    /** The `exports` field mapping entry points to file paths. */
     exports?: Record<string, string>;
+    /** Runtime dependency map (`name → version range`). */
     dependencies?: Record<string, string>;
+    /** Development dependency map (`name → version range`). */
     devDependencies?: Record<string, string>;
+    /** Peer dependency map (`name → version range`). */
     peerDependencies?: Record<string, string>;
+    /** Any other `package.json` fields. */
     [key: string]: unknown;
 }
+/**
+ * Describes a dependency mapping between two packages in a workspace.
+ */
 export interface MapEntry {
+    /** The package that declares the dependency. */
     fromPkg: Pkg;
+    /** The package that is depended upon. */
     toPkg: Pkg;
+    /** The relative file-system path from the source to the target package. */
     relPath: string;
 }
+/**
+ * Flags indicating which semver component to bump.
+ *
+ * @remarks
+ * At most one flag should be `true`. If none are set, the default
+ * bump behavior of the consumer applies.
+ */
 export interface BumpParams {
+    /** Bump the major version. */
     major?: boolean;
+    /** Bump the minor version. */
     minor?: boolean;
+    /** Bump the patch version. */
     patch?: boolean;
 }
+/**
+ * Parameters for synchronizing package versions across a workspace.
+ */
 export interface SyncPkgVersionParams extends RunRepoRootParams {
+    /** Optional bump configuration controlling which semver component to increment. */
     bump?: BumpParams;
+    /** When `true`, skip version bumping entirely. */
     noBump?: boolean;
+    /** When `true`, skip creating a git tag after the version sync. */
     noTag?: boolean;
 }
+/**
+ * Parameters for bulk-updating packages that match a pattern.
+ */
 export interface UpdatePackagesParams extends RunRepoRootParams {
+    /** Glob pattern used to select packages to update. */
     pattern: string;
 }
 //# sourceMappingURL=types.package.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.package.d.ts","sourceRoot":"","sources":["../../src/types/types.package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.package.d.ts","sourceRoot":"","sources":["../../src/types/types.package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uCAAuC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,OAAO,EAAE,GAAG,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,GAAG,CAAC;IACX,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,mFAAmF;IACnF,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.package.js","sourceRoot":"","sources":["../../src/types/types.package.ts"],"names":[],"mappings":"","sourcesContent":["import type { Pkg } from \"../pkg/Pkg.js\";\nimport { RunRepoRootParams } from \"./types.run.js\";\n\nexport interface PackageVersion {\n  major: number;\n  minor: number;\n  patch: number;\n  prefix: string | null;\n}\n\nexport interface PackageJson {\n  name: string;\n  private?: boolean;\n  version: string;\n  exports?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n  [key: string]: unknown;\n}\n\n// export interface PackageEntry {\n//   jsonPath: string;\n//   repoPath: string | null;\n//   content: PackageJson;\n//   modified: boolean;\n// }\n\nexport interface MapEntry {\n  fromPkg: Pkg;\n  toPkg: Pkg;\n  relPath: string;\n}\n\nexport interface BumpParams {\n  major?: boolean;\n  minor?: boolean;\n  patch?: boolean;\n}\n\nexport interface SyncPkgVersionParams extends RunRepoRootParams {\n  bump?: BumpParams;\n  noBump?: boolean;\n  noTag?: boolean;\n}\n\nexport interface UpdatePackagesParams extends RunRepoRootParams {\n  pattern: string;\n}\n"]}
+{"version":3,"file":"types.package.js","sourceRoot":"","sources":["../../src/types/types.package.ts"],"names":[],"mappings":"","sourcesContent":["import type { Pkg } from \"../pkg/Pkg.js\";\nimport { RunRepoRootParams } from \"./types.run.js\";\n\n/**\n * A parsed semantic version split into its numeric components.\n */\nexport interface PackageVersion {\n  /** The major version number. */\n  major: number;\n  /** The minor version number. */\n  minor: number;\n  /** The patch version number. */\n  patch: number;\n  /** An optional prefix such as `\"^\"` or `\"~\"`, or `null` if none. */\n  prefix: string | null;\n}\n\n/**\n * A minimal representation of a `package.json` file.\n *\n * @remarks\n * Contains the most commonly accessed fields and allows arbitrary\n * additional fields via the index signature.\n */\nexport interface PackageJson {\n  /** The package name as published to npm. */\n  name: string;\n  /** Whether the package is marked as private (not publishable). */\n  private?: boolean;\n  /** The current version string (semver). */\n  version: string;\n  /** The `exports` field mapping entry points to file paths. */\n  exports?: Record<string, string>;\n  /** Runtime dependency map (`name → version range`). */\n  dependencies?: Record<string, string>;\n  /** Development dependency map (`name → version range`). */\n  devDependencies?: Record<string, string>;\n  /** Peer dependency map (`name → version range`). */\n  peerDependencies?: Record<string, string>;\n  /** Any other `package.json` fields. */\n  [key: string]: unknown;\n}\n\n// export interface PackageEntry {\n//   jsonPath: string;\n//   repoPath: string | null;\n//   content: PackageJson;\n//   modified: boolean;\n// }\n\n/**\n * Describes a dependency mapping between two packages in a workspace.\n */\nexport interface MapEntry {\n  /** The package that declares the dependency. */\n  fromPkg: Pkg;\n  /** The package that is depended upon. */\n  toPkg: Pkg;\n  /** The relative file-system path from the source to the target package. */\n  relPath: string;\n}\n\n/**\n * Flags indicating which semver component to bump.\n *\n * @remarks\n * At most one flag should be `true`. If none are set, the default\n * bump behavior of the consumer applies.\n */\nexport interface BumpParams {\n  /** Bump the major version. */\n  major?: boolean;\n  /** Bump the minor version. */\n  minor?: boolean;\n  /** Bump the patch version. */\n  patch?: boolean;\n}\n\n/**\n * Parameters for synchronizing package versions across a workspace.\n */\nexport interface SyncPkgVersionParams extends RunRepoRootParams {\n  /** Optional bump configuration controlling which semver component to increment. */\n  bump?: BumpParams;\n  /** When `true`, skip version bumping entirely. */\n  noBump?: boolean;\n  /** When `true`, skip creating a git tag after the version sync. */\n  noTag?: boolean;\n}\n\n/**\n * Parameters for bulk-updating packages that match a pattern.\n */\nexport interface UpdatePackagesParams extends RunRepoRootParams {\n  /** Glob pattern used to select packages to update. */\n  pattern: string;\n}\n"]}