@mxpicture/build-api 0.2.56 → 0.2.57

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.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"]}

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

@@ -1,4 +1,8 @@
+/**
+ * Base parameters for operations that run against a repository root.
+ */
 export interface RunRepoRootParams {
+    /** Absolute path to the repository root directory. */
     repoRoot: string;
 }
 //# sourceMappingURL=types.run.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.run.d.ts","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.run.d.ts","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.run.js","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"","sourcesContent":["export interface RunRepoRootParams {\n  repoRoot: string;\n}\n"]}
+{"version":3,"file":"types.run.js","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Base parameters for operations that run against a repository root.\n */\nexport interface RunRepoRootParams {\n  /** Absolute path to the repository root directory. */\n  repoRoot: string;\n}\n"]}

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

@@ -1,37 +1,83 @@
+/**
+ * A resolved VS Code user profile.
+ */
 export interface VSCodeProfile {
+    /** Unique location identifier for the profile. */
     location: string;
+    /** Human-readable display name of the profile. */
     name: string;
+    /** Absolute path to the profile's `settings.json` file. */
     settingsPath: string;
 }
+/**
+ * The persisted VS Code storage structure that tracks user-data profiles
+ * and their workspace associations.
+ *
+ * @remarks
+ * Mirrors the shape of VS Code's internal `storage.json` file.
+ */
 export interface VSCodeStorage {
+    /** Array of user-data profiles configured in VS Code. */
     userDataProfiles: {
+        /** Unique location identifier for the profile. */
         location: string;
+        /** Human-readable display name. */
         name: string;
+        /** Icon identifier for the profile. */
         icon: string;
+        /** Optional flags indicating which settings categories use the default profile. */
         useDefaultFlags?: {
+            /** Use default settings. */
             settings?: boolean;
+            /** Use default keybindings. */
             keybindings?: boolean;
+            /** Use default snippets. */
             snippets?: boolean;
+            /** Use default tasks. */
             tasks?: boolean;
+            /** Use default extensions. */
             extensions?: boolean;
         };
     }[];
+    /** Maps workspace identifiers to profile locations. */
     profileAssociations: {
+        /** Workspace-to-profile mapping. */
         workspaces: {
             [key: string]: string;
         };
     };
 }
+/**
+ * A VS Code `settings.json` object represented as a generic record.
+ */
 export type VSCodeSettings = Record<string, unknown>;
+/**
+ * A single folder entry within a VS Code multi-root workspace.
+ */
 export interface VSCodeWorkspaceFolder {
+    /** Relative or absolute path to the folder. */
     path: string;
+    /** Optional display name for the folder in the VS Code explorer. */
     name?: string;
+    /** Optional URI representation of the folder. */
     uri?: string;
 }
+/**
+ * A VS Code `.code-workspace` file structure.
+ *
+ * @remarks
+ * Represents the top-level shape of a multi-root workspace configuration
+ * including folders, settings, launch configurations, and extension
+ * recommendations.
+ */
 export interface VSCodeWorkspace {
+    /** The folders included in this multi-root workspace. */
     folders: VSCodeWorkspaceFolder[];
+    /** Workspace-level settings overrides. */
     settings?: Record<string, unknown>;
+    /** Workspace-level launch/debug configurations. */
     launch?: Record<string, unknown>;
+    /** Workspace-level extension recommendations. */
     extensions?: Record<string, unknown>;
 }
 //# sourceMappingURL=types.vscode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.vscode.d.ts","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE;YAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,UAAU,CAAC,EAAE,OAAO,CAAC;SACtB,CAAC;KACH,EAAE,CAAC;IACJ,mBAAmB,EAAE;QACnB,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACvC,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}
+{"version":3,"file":"types.vscode.d.ts","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,gBAAgB,EAAE;QAChB,kDAAkD;QAClD,QAAQ,EAAE,MAAM,CAAC;QACjB,mCAAmC;QACnC,IAAI,EAAE,MAAM,CAAC;QACb,uCAAuC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,mFAAmF;QACnF,eAAe,CAAC,EAAE;YAChB,4BAA4B;YAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,+BAA+B;YAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,4BAA4B;YAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,yBAAyB;YACzB,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,8BAA8B;YAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;SACtB,CAAC;KACH,EAAE,CAAC;IACJ,uDAAuD;IACvD,mBAAmB,EAAE;QACnB,oCAAoC;QACpC,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.vscode.js","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"","sourcesContent":["export interface VSCodeProfile {\n  location: string;\n  name: string;\n  settingsPath: string;\n}\n\nexport interface VSCodeStorage {\n  userDataProfiles: {\n    location: string;\n    name: string;\n    icon: string;\n    useDefaultFlags?: {\n      settings?: boolean;\n      keybindings?: boolean;\n      snippets?: boolean;\n      tasks?: boolean;\n      extensions?: boolean;\n    };\n  }[];\n  profileAssociations: {\n    workspaces: { [key: string]: string };\n  };\n}\n\nexport type VSCodeSettings = Record<string, unknown>;\n\nexport interface VSCodeWorkspaceFolder {\n  path: string;\n  name?: string;\n  uri?: string;\n}\n\nexport interface VSCodeWorkspace {\n  folders: VSCodeWorkspaceFolder[];\n  settings?: Record<string, unknown>;\n  launch?: Record<string, unknown>;\n  extensions?: Record<string, unknown>;\n}\n"]}
+{"version":3,"file":"types.vscode.js","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A resolved VS Code user profile.\n */\nexport interface VSCodeProfile {\n  /** Unique location identifier for the profile. */\n  location: string;\n  /** Human-readable display name of the profile. */\n  name: string;\n  /** Absolute path to the profile's `settings.json` file. */\n  settingsPath: string;\n}\n\n/**\n * The persisted VS Code storage structure that tracks user-data profiles\n * and their workspace associations.\n *\n * @remarks\n * Mirrors the shape of VS Code's internal `storage.json` file.\n */\nexport interface VSCodeStorage {\n  /** Array of user-data profiles configured in VS Code. */\n  userDataProfiles: {\n    /** Unique location identifier for the profile. */\n    location: string;\n    /** Human-readable display name. */\n    name: string;\n    /** Icon identifier for the profile. */\n    icon: string;\n    /** Optional flags indicating which settings categories use the default profile. */\n    useDefaultFlags?: {\n      /** Use default settings. */\n      settings?: boolean;\n      /** Use default keybindings. */\n      keybindings?: boolean;\n      /** Use default snippets. */\n      snippets?: boolean;\n      /** Use default tasks. */\n      tasks?: boolean;\n      /** Use default extensions. */\n      extensions?: boolean;\n    };\n  }[];\n  /** Maps workspace identifiers to profile locations. */\n  profileAssociations: {\n    /** Workspace-to-profile mapping. */\n    workspaces: { [key: string]: string };\n  };\n}\n\n/**\n * A VS Code `settings.json` object represented as a generic record.\n */\nexport type VSCodeSettings = Record<string, unknown>;\n\n/**\n * A single folder entry within a VS Code multi-root workspace.\n */\nexport interface VSCodeWorkspaceFolder {\n  /** Relative or absolute path to the folder. */\n  path: string;\n  /** Optional display name for the folder in the VS Code explorer. */\n  name?: string;\n  /** Optional URI representation of the folder. */\n  uri?: string;\n}\n\n/**\n * A VS Code `.code-workspace` file structure.\n *\n * @remarks\n * Represents the top-level shape of a multi-root workspace configuration\n * including folders, settings, launch configurations, and extension\n * recommendations.\n */\nexport interface VSCodeWorkspace {\n  /** The folders included in this multi-root workspace. */\n  folders: VSCodeWorkspaceFolder[];\n  /** Workspace-level settings overrides. */\n  settings?: Record<string, unknown>;\n  /** Workspace-level launch/debug configurations. */\n  launch?: Record<string, unknown>;\n  /** Workspace-level extension recommendations. */\n  extensions?: Record<string, unknown>;\n}\n"]}

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

@@ -1,16 +1,34 @@
+/**
+ * The structure of a `pnpm-workspace.yaml` file.
+ */
 export interface PnpmWorkspace {
+    /** Glob patterns identifying the packages in the workspace. */
     packages: string[];
 }
+/**
+ * Classification of files discovered within a workspace.
+ */
 export declare enum WorkspaceFileType {
+    /** A `package.json` file. */
     package = "package",
+    /** A workspace configuration file (e.g. `pnpm-workspace.yaml`). */
     workspace = "workspace",
+    /** Any other file type. */
     other = "other"
 }
+/**
+ * Metadata for a file discovered while scanning a workspace directory tree.
+ */
 export interface WorkspaceFile {
+    /** Absolute path to the file. */
     filePath: string;
+    /** Absolute path to the directory containing the file. */
     dirPath: string;
+    /** The base filename (e.g. `"package.json"`). */
     filename: string;
+    /** Nesting depth relative to the workspace root (0 = root). */
     level: number;
+    /** The classified type of this workspace file. */
     type: WorkspaceFileType;
 }
 //# sourceMappingURL=types.workspace.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.workspace.d.ts","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;CACzB"}
+{"version":3,"file":"types.workspace.d.ts","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,6BAA6B;IAC7B,OAAO,YAAY;IACnB,mEAAmE;IACnE,SAAS,cAAc;IACvB,2BAA2B;IAC3B,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,IAAI,EAAE,iBAAiB,CAAC;CACzB"}

package/dist/types/types.workspace.js

@@ -1,7 +1,13 @@
+/**
+ * Classification of files discovered within a workspace.
+ */
 export var WorkspaceFileType;
 (function (WorkspaceFileType) {
+    /** A `package.json` file. */
     WorkspaceFileType["package"] = "package";
+    /** A workspace configuration file (e.g. `pnpm-workspace.yaml`). */
     WorkspaceFileType["workspace"] = "workspace";
+    /** Any other file type. */
     WorkspaceFileType["other"] = "other";
 })(WorkspaceFileType || (WorkspaceFileType = {}));
 //# sourceMappingURL=types.workspace.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.workspace.js","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,oCAAe,CAAA;AACjB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B","sourcesContent":["export interface PnpmWorkspace {\n  packages: string[];\n}\n\nexport enum WorkspaceFileType {\n  package = \"package\",\n  workspace = \"workspace\",\n  other = \"other\",\n}\n\nexport interface WorkspaceFile {\n  filePath: string;\n  dirPath: string;\n  filename: string;\n  level: number;\n  type: WorkspaceFileType;\n}\n"]}
+{"version":3,"file":"types.workspace.js","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,6BAA6B;IAC7B,wCAAmB,CAAA;IACnB,mEAAmE;IACnE,4CAAuB,CAAA;IACvB,2BAA2B;IAC3B,oCAAe,CAAA;AACjB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B","sourcesContent":["/**\n * The structure of a `pnpm-workspace.yaml` file.\n */\nexport interface PnpmWorkspace {\n  /** Glob patterns identifying the packages in the workspace. */\n  packages: string[];\n}\n\n/**\n * Classification of files discovered within a workspace.\n */\nexport enum WorkspaceFileType {\n  /** A `package.json` file. */\n  package = \"package\",\n  /** A workspace configuration file (e.g. `pnpm-workspace.yaml`). */\n  workspace = \"workspace\",\n  /** Any other file type. */\n  other = \"other\",\n}\n\n/**\n * Metadata for a file discovered while scanning a workspace directory tree.\n */\nexport interface WorkspaceFile {\n  /** Absolute path to the file. */\n  filePath: string;\n  /** Absolute path to the directory containing the file. */\n  dirPath: string;\n  /** The base filename (e.g. `\"package.json\"`). */\n  filename: string;\n  /** Nesting depth relative to the workspace root (0 = root). */\n  level: number;\n  /** The classified type of this workspace file. */\n  type: WorkspaceFileType;\n}\n"]}

package/dist/vscode/vscode.config.d.ts

@@ -1,3 +1,21 @@
+/**
+ * Returns the absolute path to the VS Code configuration directory.
+ *
+ * @remarks
+ * The path is resolved by appending `"Code"` to the OS-specific
+ * configuration directory provided by {@link osInfo}.
+ *
+ * @returns The absolute path to the VS Code `Code` configuration directory.
+ */
 export declare const configPath: () => string;
+/**
+ * Returns the absolute path to the VS Code `User` configuration directory.
+ *
+ * @remarks
+ * This is the directory that contains per-user settings, keybindings,
+ * snippets, and profile data.
+ *
+ * @returns The absolute path to the `User` subdirectory inside {@link configPath}.
+ */
 export declare const configUserPath: () => string;
 //# sourceMappingURL=vscode.config.d.ts.map

package/dist/vscode/vscode.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.config.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,QAAO,MAA0C,CAAC;AACzE,eAAO,MAAM,cAAc,QAAO,MAAoC,CAAC"}
+{"version":3,"file":"vscode.config.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAAO,MAA0C,CAAC;AAEzE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,QAAO,MAAoC,CAAC"}

package/dist/vscode/vscode.config.js

@@ -1,5 +1,23 @@
 import { join } from "node:path";
 import { osInfo } from "../osInfo/osInfo.common.js";
+/**
+ * Returns the absolute path to the VS Code configuration directory.
+ *
+ * @remarks
+ * The path is resolved by appending `"Code"` to the OS-specific
+ * configuration directory provided by {@link osInfo}.
+ *
+ * @returns The absolute path to the VS Code `Code` configuration directory.
+ */
 export const configPath = () => join(osInfo().configDir, "Code");
+/**
+ * Returns the absolute path to the VS Code `User` configuration directory.
+ *
+ * @remarks
+ * This is the directory that contains per-user settings, keybindings,
+ * snippets, and profile data.
+ *
+ * @returns The absolute path to the `User` subdirectory inside {@link configPath}.
+ */
 export const configUserPath = () => join(configPath(), "User");
 //# sourceMappingURL=vscode.config.js.map

package/dist/vscode/vscode.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.config.js","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport { osInfo } from \"../osInfo/osInfo.common.js\";\n\nexport const configPath = (): string => join(osInfo().configDir, \"Code\");\nexport const configUserPath = (): string => join(configPath(), \"User\");\n"]}
+{"version":3,"file":"vscode.config.js","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport { osInfo } from \"../osInfo/osInfo.common.js\";\n\n/**\n * Returns the absolute path to the VS Code configuration directory.\n *\n * @remarks\n * The path is resolved by appending `\"Code\"` to the OS-specific\n * configuration directory provided by {@link osInfo}.\n *\n * @returns The absolute path to the VS Code `Code` configuration directory.\n */\nexport const configPath = (): string => join(osInfo().configDir, \"Code\");\n\n/**\n * Returns the absolute path to the VS Code `User` configuration directory.\n *\n * @remarks\n * This is the directory that contains per-user settings, keybindings,\n * snippets, and profile data.\n *\n * @returns The absolute path to the `User` subdirectory inside {@link configPath}.\n */\nexport const configUserPath = (): string => join(configPath(), \"User\");\n"]}