@mxpicture/build-api 0.2.56 → 0.2.57

package/dist/code/code.common.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.common.js","sourceRoot":"","sources":["../../src/code/code.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAmB,EAAgB,EAAE;IACrE,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE;QAC1C,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;QAC9B,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM;QAC5B,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IACzC,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,SAAmB,EACM,EAAE;IAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE;QAC1C,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM;QAC9B,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM;QAC5B,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAiB,EAAE,EAAE,CACvD,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAc,EAAU,EAAE;IAC3D,8CAA8C;IAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IACnD,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC7C,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW;QAAE,OAAO,WAAW,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAChD,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IACnD,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import ts from \"typescript\";\nimport { SourceFile } from \"../types/types.code.js\";\n\nexport const createSourceFiles = (filePaths: string[]): SourceFile[] => {\n  const program = ts.createProgram(filePaths, {\n    target: ts.ScriptTarget.ES2023,\n    module: ts.ModuleKind.Node20,\n    strict: true,\n  });\n  const checker = program.getTypeChecker();\n  const results: SourceFile[] = [];\n\n  for (const filePath of filePaths) {\n    const sourceFile = program.getSourceFile(filePath);\n    if (!sourceFile) continue;\n    results.push({ sourceFile, filePath, checker });\n  }\n\n  return results;\n};\n\n/**\n * Creates a single ts.Program for all provided file paths and returns a map\n * from filePath → SourceFile. This is much more efficient than calling\n * createSourceFiles() per file because the TypeScript compiler is only\n * instantiated once.\n */\nexport const createSourceFileMap = (\n  filePaths: string[],\n): Map<string, SourceFile> => {\n  const program = ts.createProgram(filePaths, {\n    target: ts.ScriptTarget.ES2023,\n    module: ts.ModuleKind.Node20,\n    strict: true,\n  });\n  const checker = program.getTypeChecker();\n  const map = new Map<string, SourceFile>();\n  for (const filePath of filePaths) {\n    const sourceFile = program.getSourceFile(filePath);\n    if (!sourceFile) continue;\n    map.set(filePath, { sourceFile, filePath, checker });\n  }\n  return map;\n};\n\nexport const declarationKindName = (d: ts.Declaration) =>\n  ts.SyntaxKind[d.kind] ?? \"Unknown\";\n\nexport const guessKindFromFlags = (sym: ts.Symbol): string => {\n  // Not perfect, but good enough for reporting.\n  const f = sym.getFlags();\n  if (f & ts.SymbolFlags.Function) return \"function\";\n  if (f & ts.SymbolFlags.Class) return \"class\";\n  if (f & ts.SymbolFlags.Enum) return \"enum\";\n  if (f & ts.SymbolFlags.ValueModule) return \"namespace\";\n  if (f & ts.SymbolFlags.TypeAlias) return \"type\";\n  if (f & ts.SymbolFlags.Interface) return \"interface\";\n  if (f & ts.SymbolFlags.Variable) return \"variable\";\n  if (f & ts.SymbolFlags.Alias) return \"alias\";\n  return \"unknown\";\n};\n"]}
+{"version":3,"file":"code.common.js","sourceRoot":"","sources":["../../src/code/code.common.ts"],"names":[],"mappings":"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","sourcesContent":["import ts from \"typescript\";\nimport { SourceFile } from \"../types/types.code.js\";\n\n/**\n * Creates a TypeScript program and returns an array of {@link SourceFile} entries.\n *\n * @remarks\n * A new `ts.Program` is created for every call. When you need to process many\n * files, prefer {@link createSourceFileMap} which is more efficient because the\n * compiler is only instantiated once and results are keyed by path.\n *\n * @param filePaths - Absolute paths to the TypeScript source files to load.\n * @returns An array of successfully parsed {@link SourceFile} entries.\n */\nexport const createSourceFiles = (filePaths: string[]): SourceFile[] => {\n  const program = ts.createProgram(filePaths, {\n    target: ts.ScriptTarget.ES2023,\n    module: ts.ModuleKind.Node20,\n    strict: true,\n  });\n  const checker = program.getTypeChecker();\n  const results: SourceFile[] = [];\n\n  for (const filePath of filePaths) {\n    const sourceFile = program.getSourceFile(filePath);\n    if (!sourceFile) continue;\n    results.push({ sourceFile, filePath, checker });\n  }\n\n  return results;\n};\n\n/**\n * Creates a single TypeScript program and returns a map from file path to {@link SourceFile}.\n *\n * @remarks\n * This is more efficient than {@link createSourceFiles} when processing many\n * files, because the TypeScript compiler is only instantiated once and the\n * results are keyed by path for O(1) lookup.\n *\n * @param filePaths - Absolute paths to the TypeScript source files to load.\n * @returns A map keyed by file path whose values are the parsed {@link SourceFile} entries.\n */\nexport const createSourceFileMap = (\n  filePaths: string[],\n): Map<string, SourceFile> => {\n  const program = ts.createProgram(filePaths, {\n    target: ts.ScriptTarget.ES2023,\n    module: ts.ModuleKind.Node20,\n    strict: true,\n  });\n  const checker = program.getTypeChecker();\n  const map = new Map<string, SourceFile>();\n  for (const filePath of filePaths) {\n    const sourceFile = program.getSourceFile(filePath);\n    if (!sourceFile) continue;\n    map.set(filePath, { sourceFile, filePath, checker });\n  }\n  return map;\n};\n\n/**\n * Returns the human-readable syntax-kind name for a TypeScript declaration node.\n *\n * @param d - The TypeScript declaration node to inspect.\n * @returns The name of the declaration's {@link ts.SyntaxKind}, or `\"Unknown\"` if unmapped.\n */\nexport const declarationKindName = (d: ts.Declaration) =>\n  ts.SyntaxKind[d.kind] ?? \"Unknown\";\n\n/**\n * Infers a human-readable kind label from a symbol's flags.\n *\n * @remarks\n * The mapping is approximate — it checks flags in priority order and returns\n * the first match. This is sufficient for reporting purposes but may not\n * capture every nuance of the TypeScript symbol model.\n *\n * @param sym - The TypeScript symbol whose kind should be inferred.\n * @returns A lowercase label such as `\"function\"`, `\"class\"`, or `\"unknown\"`.\n */\nexport const guessKindFromFlags = (sym: ts.Symbol): string => {\n  // Not perfect, but good enough for reporting.\n  const f = sym.getFlags();\n  if (f & ts.SymbolFlags.Function) return \"function\";\n  if (f & ts.SymbolFlags.Class) return \"class\";\n  if (f & ts.SymbolFlags.Enum) return \"enum\";\n  if (f & ts.SymbolFlags.ValueModule) return \"namespace\";\n  if (f & ts.SymbolFlags.TypeAlias) return \"type\";\n  if (f & ts.SymbolFlags.Interface) return \"interface\";\n  if (f & ts.SymbolFlags.Variable) return \"variable\";\n  if (f & ts.SymbolFlags.Alias) return \"alias\";\n  return \"unknown\";\n};\n"]}

package/dist/code/code.exports.d.ts

@@ -1,4 +1,29 @@
 import { FileExportsParams, SourceExport } from "../types/types.code.js";
+/**
+ * Extracts exported symbols from a TypeScript file using the compiler API.
+ *
+ * @remarks
+ * Walks the module's export surface (including re-exports) and classifies each
+ * symbol by kind, type-only status, and re-export origin. Results are sorted
+ * alphabetically by name for stable output. The caller can control which
+ * categories of exports are included via {@link FileExportsParams.opts}.
+ *
+ * @param p - Parameters specifying the file path, optional filter flags, and an
+ *   optional pre-built source to avoid redundant parsing.
+ * @returns A {@link SourceExport} containing the discovered export items and
+ *   whether the file uses selective (named) exports.
+ */
 export declare const fileExportsCompilerApi: (p: FileExportsParams) => SourceExport;
+/**
+ * Non-compiler fallback that always returns an empty export list.
+ *
+ * @remarks
+ * This function exists as a no-op counterpart to {@link fileExportsCompilerApi}
+ * and is selected at call-sites that do not require TypeScript Compiler API
+ * analysis. It unconditionally reports no named exports.
+ *
+ * @param p - Parameters specifying the file whose exports would be extracted.
+ * @returns A {@link SourceExport} with an empty items array and `selectiveExport` set to `false`.
+ */
 export declare const fileExportsByFile: (p: FileExportsParams) => SourceExport;
 //# sourceMappingURL=code.exports.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"code.exports.d.ts","sourceRoot":"","sources":["../../src/code/code.exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQzE,eAAO,MAAM,sBAAsB,GAAI,GAAG,iBAAiB,KAAG,YA2E7D,CAAC;AAIF,eAAO,MAAM,iBAAiB,GAAI,GAAG,iBAAiB,KAAG,YAGvD,CAAC"}
+{"version":3,"file":"code.exports.d.ts","sourceRoot":"","sources":["../../src/code/code.exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQzE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,GAAI,GAAG,iBAAiB,KAAG,YA2E7D,CAAC;AAEF;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,iBAAiB,GAAI,GAAG,iBAAiB,KAAG,YAGvD,CAAC"}

package/dist/code/code.exports.js

@@ -1,6 +1,20 @@
 import ts from "typescript";
 import { resolve } from "node:path";
 import { createSourceFiles, declarationKindName, guessKindFromFlags, } from "./code.common.js";
+/**
+ * Extracts exported symbols from a TypeScript file using the compiler API.
+ *
+ * @remarks
+ * Walks the module's export surface (including re-exports) and classifies each
+ * symbol by kind, type-only status, and re-export origin. Results are sorted
+ * alphabetically by name for stable output. The caller can control which
+ * categories of exports are included via {@link FileExportsParams.opts}.
+ *
+ * @param p - Parameters specifying the file path, optional filter flags, and an
+ *   optional pre-built source to avoid redundant parsing.
+ * @returns A {@link SourceExport} containing the discovered export items and
+ *   whether the file uses selective (named) exports.
+ */
 export const fileExportsCompilerApi = (p) => {
     const includeTypeOnly = p.opts?.includeTypeOnly ?? true;
     const includeReExports = p.opts?.includeReExports ?? true;
@@ -69,7 +83,17 @@ export const fileExportsCompilerApi = (p) => {
     result.items.sort((a, b) => a.name.localeCompare(b.name));
     return result;
 };
-//only a dummy function to return force
+/**
+ * Non-compiler fallback that always returns an empty export list.
+ *
+ * @remarks
+ * This function exists as a no-op counterpart to {@link fileExportsCompilerApi}
+ * and is selected at call-sites that do not require TypeScript Compiler API
+ * analysis. It unconditionally reports no named exports.
+ *
+ * @param p - Parameters specifying the file whose exports would be extracted.
+ * @returns A {@link SourceExport} with an empty items array and `selectiveExport` set to `false`.
+ */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 export const fileExportsByFile = (p) => ({
     items: [],

package/dist/code/code.exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.exports.js","sourceRoot":"","sources":["../../src/code/code.exports.ts"],"names":[],"mappings":"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","sourcesContent":["import ts from \"typescript\";\nimport { FileExportsParams, SourceExport } from \"../types/types.code.js\";\nimport { resolve } from \"node:path\";\nimport {\n  createSourceFiles,\n  declarationKindName,\n  guessKindFromFlags,\n} from \"./code.common.js\";\n\nexport const fileExportsCompilerApi = (p: FileExportsParams): SourceExport => {\n  const includeTypeOnly = p.opts?.includeTypeOnly ?? true;\n  const includeReExports = p.opts?.includeReExports ?? true;\n  const abs = resolve(p.filePath);\n\n  const files = p.preBuiltSource\n    ? [p.preBuiltSource]\n    : createSourceFiles([p.filePath]);\n  if (files.length === 0) throw new Error(`Could not load source file: ${abs}`);\n\n  const { checker, sourceFile } = files[0];\n\n  const result: SourceExport = {\n    items: [],\n    selectiveExport: true,\n  };\n\n  const moduleSymbol = checker.getSymbolAtLocation(sourceFile);\n  if (!moduleSymbol) return result;\n\n  // This gives the \"export surface\" of the module (including re-exports).\n  const exports = checker.getExportsOfModule(moduleSymbol);\n\n  for (const sym of exports) {\n    const name = sym.getName();\n    if (name === \"default\") {\n      result.selectiveExport = false;\n      if (!p.opts?.includeDefault) continue;\n    } else if (name.startsWith(\"_\")) {\n      if (!p.opts?.includePrivate) continue;\n    }\n\n    // Determine if it's type-only (TypeScript 5.x provides isTypeOnlySymbol).\n    // Fallback: approximate using flags.\n    const isTypeOnly =\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      typeof (checker as any).isTypeOnlySymbol === \"function\"\n        ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          ((checker as any).isTypeOnlySymbol(sym) as boolean)\n        : !!(\n            sym.getFlags() &\n            (ts.SymbolFlags.Type |\n              ts.SymbolFlags.Interface |\n              ts.SymbolFlags.TypeAlias)\n          );\n\n    if (!includeTypeOnly && isTypeOnly) continue;\n\n    // Re-export detection: if symbol is an alias and resolves elsewhere\n    let isReExport = false;\n    let resolved = sym;\n    if (sym.getFlags() & ts.SymbolFlags.Alias) {\n      const aliased = checker.getAliasedSymbol(sym);\n      if (aliased && aliased !== sym) {\n        isReExport = true;\n        resolved = aliased;\n      }\n    }\n\n    if (!includeReExports && isReExport) continue;\n\n    const decls = (resolved.getDeclarations() ?? []).map(declarationKindName);\n\n    result.items.push({\n      name,\n      kind: guessKindFromFlags(resolved),\n      isTypeOnly,\n      isReExport,\n      declarations: decls,\n    });\n  }\n\n  // stable-ish output\n  result.items.sort((a, b) => a.name.localeCompare(b.name));\n  return result;\n};\n\n//only a dummy function to return force\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport const fileExportsByFile = (p: FileExportsParams): SourceExport => ({\n  items: [],\n  selectiveExport: false,\n});\n"]}
+{"version":3,"file":"code.exports.js","sourceRoot":"","sources":["../../src/code/code.exports.ts"],"names":[],"mappings":"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","sourcesContent":["import ts from \"typescript\";\nimport { FileExportsParams, SourceExport } from \"../types/types.code.js\";\nimport { resolve } from \"node:path\";\nimport {\n  createSourceFiles,\n  declarationKindName,\n  guessKindFromFlags,\n} from \"./code.common.js\";\n\n/**\n * Extracts exported symbols from a TypeScript file using the compiler API.\n *\n * @remarks\n * Walks the module's export surface (including re-exports) and classifies each\n * symbol by kind, type-only status, and re-export origin. Results are sorted\n * alphabetically by name for stable output. The caller can control which\n * categories of exports are included via {@link FileExportsParams.opts}.\n *\n * @param p - Parameters specifying the file path, optional filter flags, and an\n *   optional pre-built source to avoid redundant parsing.\n * @returns A {@link SourceExport} containing the discovered export items and\n *   whether the file uses selective (named) exports.\n */\nexport const fileExportsCompilerApi = (p: FileExportsParams): SourceExport => {\n  const includeTypeOnly = p.opts?.includeTypeOnly ?? true;\n  const includeReExports = p.opts?.includeReExports ?? true;\n  const abs = resolve(p.filePath);\n\n  const files = p.preBuiltSource\n    ? [p.preBuiltSource]\n    : createSourceFiles([p.filePath]);\n  if (files.length === 0) throw new Error(`Could not load source file: ${abs}`);\n\n  const { checker, sourceFile } = files[0];\n\n  const result: SourceExport = {\n    items: [],\n    selectiveExport: true,\n  };\n\n  const moduleSymbol = checker.getSymbolAtLocation(sourceFile);\n  if (!moduleSymbol) return result;\n\n  // This gives the \"export surface\" of the module (including re-exports).\n  const exports = checker.getExportsOfModule(moduleSymbol);\n\n  for (const sym of exports) {\n    const name = sym.getName();\n    if (name === \"default\") {\n      result.selectiveExport = false;\n      if (!p.opts?.includeDefault) continue;\n    } else if (name.startsWith(\"_\")) {\n      if (!p.opts?.includePrivate) continue;\n    }\n\n    // Determine if it's type-only (TypeScript 5.x provides isTypeOnlySymbol).\n    // Fallback: approximate using flags.\n    const isTypeOnly =\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      typeof (checker as any).isTypeOnlySymbol === \"function\"\n        ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          ((checker as any).isTypeOnlySymbol(sym) as boolean)\n        : !!(\n            sym.getFlags() &\n            (ts.SymbolFlags.Type |\n              ts.SymbolFlags.Interface |\n              ts.SymbolFlags.TypeAlias)\n          );\n\n    if (!includeTypeOnly && isTypeOnly) continue;\n\n    // Re-export detection: if symbol is an alias and resolves elsewhere\n    let isReExport = false;\n    let resolved = sym;\n    if (sym.getFlags() & ts.SymbolFlags.Alias) {\n      const aliased = checker.getAliasedSymbol(sym);\n      if (aliased && aliased !== sym) {\n        isReExport = true;\n        resolved = aliased;\n      }\n    }\n\n    if (!includeReExports && isReExport) continue;\n\n    const decls = (resolved.getDeclarations() ?? []).map(declarationKindName);\n\n    result.items.push({\n      name,\n      kind: guessKindFromFlags(resolved),\n      isTypeOnly,\n      isReExport,\n      declarations: decls,\n    });\n  }\n\n  // stable-ish output\n  result.items.sort((a, b) => a.name.localeCompare(b.name));\n  return result;\n};\n\n/**\n * Non-compiler fallback that always returns an empty export list.\n *\n * @remarks\n * This function exists as a no-op counterpart to {@link fileExportsCompilerApi}\n * and is selected at call-sites that do not require TypeScript Compiler API\n * analysis. It unconditionally reports no named exports.\n *\n * @param p - Parameters specifying the file whose exports would be extracted.\n * @returns A {@link SourceExport} with an empty items array and `selectiveExport` set to `false`.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport const fileExportsByFile = (p: FileExportsParams): SourceExport => ({\n  items: [],\n  selectiveExport: false,\n});\n"]}

package/dist/code/code.format.d.ts

@@ -1,4 +1,27 @@
+/**
+ * Formats TypeScript code using Prettier.
+ *
+ * @param lines - One or more code strings that are joined with newlines before formatting.
+ * @returns The formatted TypeScript source code.
+ */
 export declare const formatCode: (...lines: string[]) => Promise<string>;
+/**
+ * Formats a JSON document using Prettier.
+ *
+ * @param lines - One or more JSON strings that are joined with newlines before formatting.
+ * @returns The formatted JSON string.
+ */
 export declare const formatJson: (...lines: string[]) => Promise<string>;
+/**
+ * Formats a JSON value using Prettier's `json-stringify` parser.
+ *
+ * @remarks
+ * Unlike {@link formatJson}, this uses the `json-stringify` parser which
+ * produces output closer to `JSON.stringify` — for example it does not add a
+ * trailing newline after the top-level value.
+ *
+ * @param lines - One or more JSON strings that are joined with newlines before formatting.
+ * @returns The formatted JSON string.
+ */
 export declare const formatJsonStringify: (...lines: string[]) => Promise<string>;
 //# sourceMappingURL=code.format.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"code.format.d.ts","sourceRoot":"","sources":["../../src/code/code.format.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAU,GAAG,OAAO,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAChB,CAAC;AAErD,eAAO,MAAM,UAAU,GAAU,GAAG,OAAO,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CACtB,CAAC;AAE/C,eAAO,MAAM,mBAAmB,GAC9B,GAAG,OAAO,MAAM,EAAE,KACjB,OAAO,CAAC,MAAM,CAA2D,CAAC"}
+{"version":3,"file":"code.format.d.ts","sourceRoot":"","sources":["../../src/code/code.format.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAU,GAAG,OAAO,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAChB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAU,GAAG,OAAO,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CACtB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC9B,GAAG,OAAO,MAAM,EAAE,KACjB,OAAO,CAAC,MAAM,CAA2D,CAAC"}

package/dist/code/code.format.js

@@ -1,5 +1,28 @@
 import { format } from "prettier";
+/**
+ * Formats TypeScript code using Prettier.
+ *
+ * @param lines - One or more code strings that are joined with newlines before formatting.
+ * @returns The formatted TypeScript source code.
+ */
 export const formatCode = async (...lines) => format(lines.join("\n"), { parser: "typescript" });
+/**
+ * Formats a JSON document using Prettier.
+ *
+ * @param lines - One or more JSON strings that are joined with newlines before formatting.
+ * @returns The formatted JSON string.
+ */
 export const formatJson = async (...lines) => format(lines.join("\n"), { parser: "json" });
+/**
+ * Formats a JSON value using Prettier's `json-stringify` parser.
+ *
+ * @remarks
+ * Unlike {@link formatJson}, this uses the `json-stringify` parser which
+ * produces output closer to `JSON.stringify` — for example it does not add a
+ * trailing newline after the top-level value.
+ *
+ * @param lines - One or more JSON strings that are joined with newlines before formatting.
+ * @returns The formatted JSON string.
+ */
 export const formatJsonStringify = async (...lines) => format(lines.join("\n"), { parser: "json-stringify" });
 //# sourceMappingURL=code.format.js.map

package/dist/code/code.format.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.format.js","sourceRoot":"","sources":["../../src/code/code.format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,KAAe,EAAmB,EAAE,CACtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,KAAe,EAAmB,EAAE,CACtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,GAAG,KAAe,EACD,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC","sourcesContent":["import { format } from \"prettier\";\n\nexport const formatCode = async (...lines: string[]): Promise<string> =>\n  format(lines.join(\"\\n\"), { parser: \"typescript\" });\n\nexport const formatJson = async (...lines: string[]): Promise<string> =>\n  format(lines.join(\"\\n\"), { parser: \"json\" });\n\nexport const formatJsonStringify = async (\n  ...lines: string[]\n): Promise<string> => format(lines.join(\"\\n\"), { parser: \"json-stringify\" });\n"]}
+{"version":3,"file":"code.format.js","sourceRoot":"","sources":["../../src/code/code.format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,KAAe,EAAmB,EAAE,CACtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,KAAe,EAAmB,EAAE,CACtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,GAAG,KAAe,EACD,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC","sourcesContent":["import { format } from \"prettier\";\n\n/**\n * Formats TypeScript code using Prettier.\n *\n * @param lines - One or more code strings that are joined with newlines before formatting.\n * @returns The formatted TypeScript source code.\n */\nexport const formatCode = async (...lines: string[]): Promise<string> =>\n  format(lines.join(\"\\n\"), { parser: \"typescript\" });\n\n/**\n * Formats a JSON document using Prettier.\n *\n * @param lines - One or more JSON strings that are joined with newlines before formatting.\n * @returns The formatted JSON string.\n */\nexport const formatJson = async (...lines: string[]): Promise<string> =>\n  format(lines.join(\"\\n\"), { parser: \"json\" });\n\n/**\n * Formats a JSON value using Prettier's `json-stringify` parser.\n *\n * @remarks\n * Unlike {@link formatJson}, this uses the `json-stringify` parser which\n * produces output closer to `JSON.stringify` — for example it does not add a\n * trailing newline after the top-level value.\n *\n * @param lines - One or more JSON strings that are joined with newlines before formatting.\n * @returns The formatted JSON string.\n */\nexport const formatJsonStringify = async (\n  ...lines: string[]\n): Promise<string> => format(lines.join(\"\\n\"), { parser: \"json-stringify\" });\n"]}

package/dist/common/common.fs.d.ts

@@ -1,5 +1,27 @@
 import { exec as execCb } from "node:child_process";
 import { PathLike } from "node:fs";
+/**
+ * Promise-based wrapper around {@link exec} from `node:child_process`.
+ *
+ * @example
+ * ```ts
+ * const { stdout } = await execAsync("echo hello");
+ * console.log(stdout); // "hello\n"
+ * ```
+ */
 export declare const execAsync: typeof execCb.__promisify__;
+/**
+ * Checks whether a file or directory exists at the given path.
+ *
+ * @param path - The file-system path to check.
+ * @returns `true` if the path points to an existing file or directory, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * if (await existsAsync("package.json")) {
+ *   console.log("found");
+ * }
+ * ```
+ */
 export declare const existsAsync: (path: PathLike) => Promise<boolean>;
 //# sourceMappingURL=common.fs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"common.fs.d.ts","sourceRoot":"","sources":["../../src/common/common.fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAInC,eAAO,MAAM,SAAS,6BAAoB,CAAC;AAE3C,eAAO,MAAM,WAAW,GAAU,MAAM,QAAQ,KAAG,OAAO,CAAC,OAAO,CAOjE,CAAC"}
+{"version":3,"file":"common.fs.d.ts","sourceRoot":"","sources":["../../src/common/common.fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAInC;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,6BAAoB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAU,MAAM,QAAQ,KAAG,OAAO,CAAC,OAAO,CAOjE,CAAC"}

package/dist/common/common.fs.js

@@ -1,7 +1,29 @@
 import { exec as execCb } from "node:child_process";
 import { stat } from "node:fs/promises";
 import { promisify } from "node:util";
+/**
+ * Promise-based wrapper around {@link exec} from `node:child_process`.
+ *
+ * @example
+ * ```ts
+ * const { stdout } = await execAsync("echo hello");
+ * console.log(stdout); // "hello\n"
+ * ```
+ */
 export const execAsync = promisify(execCb);
+/**
+ * Checks whether a file or directory exists at the given path.
+ *
+ * @param path - The file-system path to check.
+ * @returns `true` if the path points to an existing file or directory, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * if (await existsAsync("package.json")) {
+ *   console.log("found");
+ * }
+ * ```
+ */
 export const existsAsync = async (path) => {
     try {
         const s = await stat(path);

package/dist/common/common.fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.fs.js","sourceRoot":"","sources":["../../src/common/common.fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAc,EAAoB,EAAE;IACpE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { exec as execCb } from \"node:child_process\";\nimport { PathLike } from \"node:fs\";\nimport { stat } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\n\nexport const execAsync = promisify(execCb);\n\nexport const existsAsync = async (path: PathLike): Promise<boolean> => {\n  try {\n    const s = await stat(path);\n    return s.isFile() || s.isDirectory();\n  } catch {\n    return false;\n  }\n};\n"]}
+{"version":3,"file":"common.fs.js","sourceRoot":"","sources":["../../src/common/common.fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAc,EAAoB,EAAE;IACpE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { exec as execCb } from \"node:child_process\";\nimport { PathLike } from \"node:fs\";\nimport { stat } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\n\n/**\n * Promise-based wrapper around {@link exec} from `node:child_process`.\n *\n * @example\n * ```ts\n * const { stdout } = await execAsync(\"echo hello\");\n * console.log(stdout); // \"hello\\n\"\n * ```\n */\nexport const execAsync = promisify(execCb);\n\n/**\n * Checks whether a file or directory exists at the given path.\n *\n * @param path - The file-system path to check.\n * @returns `true` if the path points to an existing file or directory, `false` otherwise.\n *\n * @example\n * ```ts\n * if (await existsAsync(\"package.json\")) {\n *   console.log(\"found\");\n * }\n * ```\n */\nexport const existsAsync = async (path: PathLike): Promise<boolean> => {\n  try {\n    const s = await stat(path);\n    return s.isFile() || s.isDirectory();\n  } catch {\n    return false;\n  }\n};\n"]}

package/dist/common/common.json.d.ts

@@ -1,3 +1,30 @@
+/**
+ * Performs a deep-equality comparison of two values.
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns `true` if `a` and `b` are deeply equal, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * jsonEqual({ x: 1 }, { x: 1 }); // true
+ * jsonEqual([1, 2], [1, 3]);      // false
+ * ```
+ */
 export declare const jsonEqual: <T>(a: T, b: T) => boolean;
+/**
+ * Creates a deep clone of the given value using the structured clone algorithm.
+ *
+ * @param value - The value to clone.
+ * @returns A deep copy of `value`.
+ *
+ * @example
+ * ```ts
+ * const original = { nested: { key: "value" } };
+ * const copy = jsonClone(original);
+ * copy.nested.key = "changed";
+ * console.log(original.nested.key); // "value"
+ * ```
+ */
 export declare const jsonClone: <T>(value: T) => T;
 //# sourceMappingURL=common.json.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"common.json.d.ts","sourceRoot":"","sources":["../../src/common/common.json.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAG,OAAkC,CAAC;AAC7E,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAA2B,CAAC"}
+{"version":3,"file":"common.json.d.ts","sourceRoot":"","sources":["../../src/common/common.json.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAG,OAAkC,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAA2B,CAAC"}

package/dist/common/common.json.js

@@ -1,4 +1,31 @@
 import { isDeepStrictEqual } from "node:util";
+/**
+ * Performs a deep-equality comparison of two values.
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns `true` if `a` and `b` are deeply equal, `false` otherwise.
+ *
+ * @example
+ * ```ts
+ * jsonEqual({ x: 1 }, { x: 1 }); // true
+ * jsonEqual([1, 2], [1, 3]);      // false
+ * ```
+ */
 export const jsonEqual = (a, b) => isDeepStrictEqual(a, b);
+/**
+ * Creates a deep clone of the given value using the structured clone algorithm.
+ *
+ * @param value - The value to clone.
+ * @returns A deep copy of `value`.
+ *
+ * @example
+ * ```ts
+ * const original = { nested: { key: "value" } };
+ * const copy = jsonClone(original);
+ * copy.nested.key = "changed";
+ * console.log(original.nested.key); // "value"
+ * ```
+ */
 export const jsonClone = (value) => structuredClone(value);
 //# sourceMappingURL=common.json.js.map

package/dist/common/common.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.json.js","sourceRoot":"","sources":["../../src/common/common.json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,CAAI,EAAE,CAAI,EAAW,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAAQ,EAAK,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import { isDeepStrictEqual } from \"node:util\";\n\nexport const jsonEqual = <T>(a: T, b: T): boolean => isDeepStrictEqual(a, b);\nexport const jsonClone = <T>(value: T): T => structuredClone(value);\n"]}
+{"version":3,"file":"common.json.js","sourceRoot":"","sources":["../../src/common/common.json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,CAAI,EAAE,CAAI,EAAW,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAAQ,EAAK,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC","sourcesContent":["import { isDeepStrictEqual } from \"node:util\";\n\n/**\n * Performs a deep-equality comparison of two values.\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n * @returns `true` if `a` and `b` are deeply equal, `false` otherwise.\n *\n * @example\n * ```ts\n * jsonEqual({ x: 1 }, { x: 1 }); // true\n * jsonEqual([1, 2], [1, 3]);      // false\n * ```\n */\nexport const jsonEqual = <T>(a: T, b: T): boolean => isDeepStrictEqual(a, b);\n\n/**\n * Creates a deep clone of the given value using the structured clone algorithm.\n *\n * @param value - The value to clone.\n * @returns A deep copy of `value`.\n *\n * @example\n * ```ts\n * const original = { nested: { key: \"value\" } };\n * const copy = jsonClone(original);\n * copy.nested.key = \"changed\";\n * console.log(original.nested.key); // \"value\"\n * ```\n */\nexport const jsonClone = <T>(value: T): T => structuredClone(value);\n"]}

package/dist/deps/FixWorkspaceDeps.d.ts

@@ -1,27 +1,159 @@
 import { Pkg } from "../pkg/Pkg.js";
 import { DepsProcessMode, DepsReplacementMode, FixWorkspaceDepsData, FixWorkspaceDepsMain, FixWorkspaceDepsParams } from "../types/types.deps.js";
 import { MapEntry } from "../types/types.package.js";
+/**
+ * Fix or restore workspace dependency references across all packages.
+ *
+ * @remarks
+ * Initializes the workspace from the given repository root, selects the
+ * appropriate replacement strategy ({@link FixWorkspaceDepsVersion} or
+ * {@link FixWorkspaceDepsFile}), and executes the full fix/restore run.
+ *
+ * @param p - Parameters specifying the repo root, processing mode, and replacement strategy.
+ * @returns A promise that resolves when all workspace dependencies have been processed and written.
+ *
+ * @example
+ * ```ts
+ * await runFixDeps({
+ *   repoRoot: "/path/to/repo",
+ *   mode: DepsProcessMode.fix,
+ *   replacement: DepsReplacementMode.version,
+ * });
+ * ```
+ */
 export declare const runFixDeps: (p: FixWorkspaceDepsParams) => Promise<void>;
+/**
+ * Create the appropriate {@link IFixWorkspaceDeps} instance for the given replacement mode.
+ *
+ * @remarks
+ * Acts as a factory function that returns a {@link FixWorkspaceDepsVersion}
+ * when the replacement mode is `version`, or a {@link FixWorkspaceDepsFile}
+ * when it is `file`.
+ *
+ * @param p - Object containing the processing mode and replacement strategy.
+ * @returns A concrete {@link IFixWorkspaceDeps} subclass ready to execute.
+ */
 export declare const instanceFixDeps: (p: {
     mode: DepsProcessMode;
     replacement: DepsReplacementMode;
 }) => FixWorkspaceDepsVersion | FixWorkspaceDepsFile;
+/**
+ * Abstract base class for fixing or restoring workspace dependency references.
+ *
+ * @remarks
+ * Implements the template-method pattern: subclasses provide concrete
+ * {@link IFixWorkspaceDeps.fixVersion | fixVersion} and
+ * {@link IFixWorkspaceDeps.restoreVersion | restoreVersion} implementations
+ * while the base class orchestrates reading, processing, and writing all
+ * workspace packages.
+ */
 export declare abstract class IFixWorkspaceDeps {
     readonly mode: DepsProcessMode;
+    /**
+     * Create a new workspace dependency fixer.
+     *
+     * @param mode - Whether to `fix` (replace `workspace:*`) or `restore` (revert to `workspace:*`).
+     */
     constructor(mode: DepsProcessMode);
+    /**
+     * Compute the replacement version string when fixing a dependency.
+     *
+     * @param p - Data about the dependency being processed.
+     * @returns The replacement version string, or `null` if no replacement is needed.
+     */
     protected abstract fixVersion(p: FixWorkspaceDepsData): string | null;
+    /**
+     * Compute the original version string when restoring a dependency.
+     *
+     * @param p - Data about the dependency being processed.
+     * @returns The restored version string, or `null` if no restoration is needed.
+     */
     protected abstract restoreVersion(p: FixWorkspaceDepsData): string | null;
+    /**
+     * Execute the full fix or restore operation across every workspace package.
+     *
+     * @remarks
+     * Reads the workspace, builds a version map and map entries, iterates over
+     * each package to apply the appropriate transformation, and writes all
+     * modified `package.json` files back to disk.
+     *
+     * @returns A promise that resolves when all packages have been written.
+     */
     run(): Promise<void>;
+    /**
+     * Process a single dependency map, replacing matching versions in place.
+     *
+     * @param deps - The dependency record (e.g. `dependencies`, `devDependencies`) to mutate.
+     * @param p - Contextual data for the consuming package and workspace.
+     */
     protected handleDependencies(deps: Record<string, string> | undefined, p: FixWorkspaceDepsMain): void;
+    /**
+     * Process all dependency groups for a single consuming package.
+     *
+     * @param p - Contextual data including the consuming package, map entries, and version map.
+     */
     protected runSingle(p: FixWorkspaceDepsMain): void;
+    /**
+     * Build pairwise mapping entries between all workspace packages.
+     *
+     * @remarks
+     * Produces a cartesian product (excluding self-pairs) of packages, computing
+     * the relative filesystem path from each source package to every other
+     * target package.
+     *
+     * @param pkgs - The list of workspace packages.
+     * @returns An array of {@link MapEntry} objects describing each package-to-package relationship.
+     */
     protected buildMapEntries(pkgs: Pkg[]): MapEntry[];
 }
+/**
+ * Workspace dependency fixer that replaces `workspace:*` with caret version ranges.
+ *
+ * @remarks
+ * During a `fix` pass, `workspace:*` is replaced with `^{resolved-version}`.
+ * During a `restore` pass, caret-prefixed versions that match the workspace
+ * version map are reverted back to `workspace:*`.
+ */
 export declare class FixWorkspaceDepsVersion extends IFixWorkspaceDeps {
+    /**
+     * Replace a `workspace:*` reference with a caret version range.
+     *
+     * @param p - Data about the dependency being processed.
+     * @returns A string like `^1.2.3`, or `null` if the dependency is not `workspace:*`.
+     * @throws Error if the package cannot be found in the workspace version map.
+     */
     protected fixVersion(p: FixWorkspaceDepsData): string | null;
+    /**
+     * Restore a caret version range back to `workspace:*`.
+     *
+     * @param p - Data about the dependency being processed.
+     * @returns The string `workspace:*` if the version matches the expected caret range, or `null` otherwise.
+     */
     protected restoreVersion(p: FixWorkspaceDepsData): string | null;
 }
+/**
+ * Workspace dependency fixer that replaces `workspace:*` with `file:` protocol paths.
+ *
+ * @remarks
+ * During a `fix` pass, `workspace:*` is replaced with a relative `file:` path
+ * pointing to the dependency's package directory.
+ * During a `restore` pass, any `file:`-prefixed version is reverted to `workspace:*`.
+ */
 export declare class FixWorkspaceDepsFile extends IFixWorkspaceDeps {
+    /**
+     * Replace a `workspace:*` reference with a relative `file:` path.
+     *
+     * @param p - Data about the dependency being processed.
+     * @returns A string like `file:../sibling-pkg`, or `null` if the dependency is not `workspace:*`.
+     * @throws Error if no map entry can be found for the dependency.
+     */
     protected fixVersion(p: FixWorkspaceDepsData): string | null;
+    /**
+     * Restore a `file:` path reference back to `workspace:*`.
+     *
+     * @param p - Data about the dependency being processed.
+     * @returns The string `workspace:*` if the version uses the `file:` protocol, or `null` otherwise.
+     */
     protected restoreVersion(p: FixWorkspaceDepsData): string | null;
 }
 //# sourceMappingURL=FixWorkspaceDeps.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FixWorkspaceDeps.d.ts","sourceRoot":"","sources":["../../src/deps/FixWorkspaceDeps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,eAAO,MAAM,UAAU,GAAU,GAAG,sBAAsB,kBAGzD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,GAAG;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,mBAAmB,CAAC;CAClC,mDAGqC,CAAC;AAEvC,8BAAsB,iBAAiB;aACF,IAAI,EAAE,eAAe;gBAArB,IAAI,EAAE,eAAe;IAExD,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IACrE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAE5D,GAAG;IA6ChB,SAAS,CAAC,kBAAkB,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACxC,CAAC,EAAE,oBAAoB,GACtB,IAAI;IAaP,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAOlD,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE;CAYnD;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;cACzC,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;cAYlD,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;CAU1E;AAED,qBAAa,oBAAqB,SAAQ,iBAAiB;cACtC,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;cAkBlD,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;CAI1E"}
+{"version":3,"file":"FixWorkspaceDeps.d.ts","sourceRoot":"","sources":["../../src/deps/FixWorkspaceDeps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,UAAU,GAAU,GAAG,sBAAsB,kBAGzD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,GAAG;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,mBAAmB,CAAC;CAClC,mDAGqC,CAAC;AAEvC;;;;;;;;;GASG;AACH,8BAAsB,iBAAiB;aAMF,IAAI,EAAE,eAAe;IALxD;;;;OAIG;gBACgC,IAAI,EAAE,eAAe;IAExD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAErE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAEzE;;;;;;;;;OASG;IACU,GAAG;IA4ChB;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACxC,CAAC,EAAE,oBAAoB,GACtB,IAAI;IAaP;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAMlD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE;CAYnD;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D;;;;;;OAMG;cACgB,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAYrE;;;;;OAKG;cACgB,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;CAU1E;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD;;;;;;OAMG;cACgB,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAkBrE;;;;;OAKG;cACgB,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;CAI1E"}