@mxpicture/build-api 0.2.56 → 0.2.58

package/dist/git/git.util.js

@@ -1,8 +1,17 @@
 import { simpleGit } from "simple-git";
 const __entries = [];
 /**
- * Creates a SimpleGit instance and verifies the cwd is a repo
- * and the commit ref is valid.
+ * Returns a verified {@link SimpleGit} instance for the given repository root.
+ *
+ * @remarks
+ * Instances are cached by `rootDir` and `commitRef` pair. On the first call
+ * for a given pair the function verifies that `rootDir` is a git repository
+ * and, when supplied, that `commitRef` resolves to a valid object.
+ *
+ * @param rootDir - Absolute path to the repository working directory.
+ * @param commitRef - Optional git ref (SHA, tag, branch) to validate.
+ * @returns A {@link SimpleGit} instance bound to `rootDir`.
+ * @throws If `rootDir` is not a git repository or `commitRef` is invalid.
  */
 export const verifiedGit = async (rootDir, commitRef) => {
     let found = __entries.find((entry) => entry.rootDir === rootDir && entry.commitRef === commitRef);
@@ -25,14 +34,52 @@ const verifyGit = async (git, rootDir, commitRef) => {
     }
     return { git, rootDir, commitRef };
 };
+/**
+ * Retrieves the most recent tag in the repository.
+ *
+ * @param rootDir - Absolute path to the repository working directory.
+ * @returns The name of the latest tag, or `null` if no tags exist.
+ */
 export const lastTag = async (rootDir) => (await (await verifiedGit(rootDir)).tags()).latest ?? null;
+/**
+ * Retrieves all tags in the repository.
+ *
+ * @param rootDir - Absolute path to the repository working directory.
+ * @returns An array of tag names.
+ */
 export const tags = async (rootDir) => (await (await verifiedGit(rootDir)).tags()).all;
+/**
+ * Retrieves the hash of the most recent commit on the current branch.
+ *
+ * @param rootDir - Absolute path to the repository working directory.
+ * @returns The SHA hash of the latest commit, or `null` if the log is empty.
+ */
 export const lastCommitHash = async (rootDir) => (await (await verifiedGit(rootDir)).log()).latest?.hash ?? null;
+/**
+ * Retrieves the full commit log as an array of {@link GitCommitHash} objects.
+ *
+ * @param rootDir - Absolute path to the repository working directory.
+ * @returns An array of commit hashes with dates and optional diff data.
+ */
 export const commitHashs = async (rootDir) => (await (await verifiedGit(rootDir)).log()).all.map((a) => ({
     date: a.date,
     hash: a.hash,
     diff: a.diff,
 }));
+/**
+ * Resolves a git reference, falling back to a secondary ref if the primary is invalid.
+ *
+ * @remarks
+ * Attempts to verify `ref` against the repository. If verification fails
+ * (e.g. the ref does not exist), `fallback` is verified and returned instead.
+ * An error is thrown only when *both* refs are invalid.
+ *
+ * @param ref - The preferred git reference to validate.
+ * @param fallback - A fallback git reference used when `ref` is invalid.
+ * @param rootDir - Absolute path to the repository working directory.
+ * @returns The verified git reference string (`ref` or `fallback`).
+ * @throws If neither `ref` nor `fallback` resolves to a valid git object.
+ */
 export const ensureCommitRef = async (ref, fallback, rootDir) => {
     try {
         await verifiedGit(rootDir, ref);
@@ -43,7 +90,15 @@ export const ensureCommitRef = async (ref, fallback, rootDir) => {
         return fallback;
     }
 };
-/** @internal test-only */
+/**
+ * Resets the internal cache of verified git entries.
+ *
+ * @remarks
+ * This is intended for test cleanup only and should never be called in
+ * production code.
+ *
+ * @internal
+ */
 export const __resetGitEntries = () => {
     __entries.length = 0;
 };

package/dist/git/git.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.util.js","sourceRoot":"","sources":["../../src/git/git.util.ts"],"names":[],"mappings":"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","sourcesContent":["import { SimpleGit, simpleGit } from \"simple-git\";\nimport { GitCommitHash } from \"../types/types.git.js\";\n\ninterface GitEntry {\n  git: SimpleGit;\n  rootDir: string;\n  commitRef?: string;\n}\n\nconst __entries: GitEntry[] = [];\n\n/**\n * Creates a SimpleGit instance and verifies the cwd is a repo\n * and the commit ref is valid.\n */\nexport const verifiedGit = async (\n  rootDir: string,\n  commitRef?: string,\n): Promise<SimpleGit> => {\n  let found = __entries.find(\n    (entry) => entry.rootDir === rootDir && entry.commitRef === commitRef,\n  );\n  if (!found) {\n    found = await verifyGit(simpleGit(rootDir), rootDir, commitRef);\n    __entries.push(found);\n  }\n\n  return found.git;\n};\n\nconst verifyGit = async (\n  git: SimpleGit,\n  rootDir: string,\n  commitRef?: string,\n): Promise<GitEntry> => {\n  if (!(await git.checkIsRepo()))\n    throw new Error(`Not a git repository: ${rootDir}`);\n\n  if (!commitRef) return { git, rootDir, commitRef };\n\n  try {\n    await git.revparse([\"--verify\", commitRef]);\n  } catch {\n    throw new Error(`Invalid git commit reference: \"${commitRef}\"`);\n  }\n\n  return { git, rootDir, commitRef };\n};\n\nexport const lastTag = async (rootDir: string): Promise<string | null> =>\n  (await (await verifiedGit(rootDir)).tags()).latest ?? null;\n\nexport const tags = async (rootDir: string): Promise<string[]> =>\n  (await (await verifiedGit(rootDir)).tags()).all;\n\nexport const lastCommitHash = async (rootDir: string): Promise<string | null> =>\n  (await (await verifiedGit(rootDir)).log()).latest?.hash ?? null;\n\nexport const commitHashs = async (rootDir: string): Promise<GitCommitHash[]> =>\n  (await (await verifiedGit(rootDir)).log()).all.map((a) => ({\n    date: a.date,\n    hash: a.hash,\n    diff: a.diff,\n  }));\n\nexport const ensureCommitRef = async (\n  ref: string,\n  fallback: string,\n  rootDir: string,\n): Promise<string> => {\n  try {\n    await verifiedGit(rootDir, ref);\n    return ref;\n  } catch {\n    await verifiedGit(rootDir, fallback);\n    return fallback;\n  }\n};\n\n/** @internal test-only */\nexport const __resetGitEntries = () => {\n  __entries.length = 0;\n};\n"]}
+{"version":3,"file":"git.util.js","sourceRoot":"","sources":["../../src/git/git.util.ts"],"names":[],"mappings":"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","sourcesContent":["import { SimpleGit, simpleGit } from \"simple-git\";\nimport { GitCommitHash } from \"../types/types.git.js\";\n\ninterface GitEntry {\n  git: SimpleGit;\n  rootDir: string;\n  commitRef?: string;\n}\n\nconst __entries: GitEntry[] = [];\n\n/**\n * Returns a verified {@link SimpleGit} instance for the given repository root.\n *\n * @remarks\n * Instances are cached by `rootDir` and `commitRef` pair. On the first call\n * for a given pair the function verifies that `rootDir` is a git repository\n * and, when supplied, that `commitRef` resolves to a valid object.\n *\n * @param rootDir - Absolute path to the repository working directory.\n * @param commitRef - Optional git ref (SHA, tag, branch) to validate.\n * @returns A {@link SimpleGit} instance bound to `rootDir`.\n * @throws If `rootDir` is not a git repository or `commitRef` is invalid.\n */\nexport const verifiedGit = async (\n  rootDir: string,\n  commitRef?: string,\n): Promise<SimpleGit> => {\n  let found = __entries.find(\n    (entry) => entry.rootDir === rootDir && entry.commitRef === commitRef,\n  );\n  if (!found) {\n    found = await verifyGit(simpleGit(rootDir), rootDir, commitRef);\n    __entries.push(found);\n  }\n\n  return found.git;\n};\n\nconst verifyGit = async (\n  git: SimpleGit,\n  rootDir: string,\n  commitRef?: string,\n): Promise<GitEntry> => {\n  if (!(await git.checkIsRepo()))\n    throw new Error(`Not a git repository: ${rootDir}`);\n\n  if (!commitRef) return { git, rootDir, commitRef };\n\n  try {\n    await git.revparse([\"--verify\", commitRef]);\n  } catch {\n    throw new Error(`Invalid git commit reference: \"${commitRef}\"`);\n  }\n\n  return { git, rootDir, commitRef };\n};\n\n/**\n * Retrieves the most recent tag in the repository.\n *\n * @param rootDir - Absolute path to the repository working directory.\n * @returns The name of the latest tag, or `null` if no tags exist.\n */\nexport const lastTag = async (rootDir: string): Promise<string | null> =>\n  (await (await verifiedGit(rootDir)).tags()).latest ?? null;\n\n/**\n * Retrieves all tags in the repository.\n *\n * @param rootDir - Absolute path to the repository working directory.\n * @returns An array of tag names.\n */\nexport const tags = async (rootDir: string): Promise<string[]> =>\n  (await (await verifiedGit(rootDir)).tags()).all;\n\n/**\n * Retrieves the hash of the most recent commit on the current branch.\n *\n * @param rootDir - Absolute path to the repository working directory.\n * @returns The SHA hash of the latest commit, or `null` if the log is empty.\n */\nexport const lastCommitHash = async (rootDir: string): Promise<string | null> =>\n  (await (await verifiedGit(rootDir)).log()).latest?.hash ?? null;\n\n/**\n * Retrieves the full commit log as an array of {@link GitCommitHash} objects.\n *\n * @param rootDir - Absolute path to the repository working directory.\n * @returns An array of commit hashes with dates and optional diff data.\n */\nexport const commitHashs = async (rootDir: string): Promise<GitCommitHash[]> =>\n  (await (await verifiedGit(rootDir)).log()).all.map((a) => ({\n    date: a.date,\n    hash: a.hash,\n    diff: a.diff,\n  }));\n\n/**\n * Resolves a git reference, falling back to a secondary ref if the primary is invalid.\n *\n * @remarks\n * Attempts to verify `ref` against the repository. If verification fails\n * (e.g. the ref does not exist), `fallback` is verified and returned instead.\n * An error is thrown only when *both* refs are invalid.\n *\n * @param ref - The preferred git reference to validate.\n * @param fallback - A fallback git reference used when `ref` is invalid.\n * @param rootDir - Absolute path to the repository working directory.\n * @returns The verified git reference string (`ref` or `fallback`).\n * @throws If neither `ref` nor `fallback` resolves to a valid git object.\n */\nexport const ensureCommitRef = async (\n  ref: string,\n  fallback: string,\n  rootDir: string,\n): Promise<string> => {\n  try {\n    await verifiedGit(rootDir, ref);\n    return ref;\n  } catch {\n    await verifiedGit(rootDir, fallback);\n    return fallback;\n  }\n};\n\n/**\n * Resets the internal cache of verified git entries.\n *\n * @remarks\n * This is intended for test cleanup only and should never be called in\n * production code.\n *\n * @internal\n */\nexport const __resetGitEntries = () => {\n  __entries.length = 0;\n};\n"]}

package/dist/logger/Logger.d.ts

@@ -1,14 +1,88 @@
+/**
+ * A function that accepts variadic arguments and logs them.
+ *
+ * @example
+ * ```ts
+ * const handler: LoggerHandler = (...data) => console.log(...data);
+ * handler("hello", 42);
+ * ```
+ */
 export type LoggerHandler = (...data: any[]) => void;
+/**
+ * Logger interface providing success, error, and info logging channels.
+ *
+ * @example
+ * ```ts
+ * const myLogger: Logger = {
+ *   success: console.log,
+ *   error: console.error,
+ *   info: console.log,
+ * };
+ * initLogger(myLogger);
+ * ```
+ */
 export interface Logger {
+    /** Logs a success message. */
     success: LoggerHandler;
+    /** Logs an error message. */
     error: LoggerHandler;
+    /** Logs an informational message. */
     info: LoggerHandler;
 }
+/**
+ * Initializes the global logger instance.
+ *
+ * @param log - The {@link Logger} implementation to use globally.
+ * @returns The logger that was set.
+ *
+ * @example
+ * ```ts
+ * initLogger(consoleLogger);
+ * ```
+ */
 export declare const initLogger: (log: Logger) => Logger;
+/**
+ * Returns the current global logger, falling back to {@link silentLogger} if none has been initialized.
+ *
+ * @returns The active {@link Logger} instance.
+ */
 export declare const logger: () => Logger;
+/**
+ * Logs a success message through the global logger.
+ *
+ * @param data - The values to log.
+ */
 export declare const logSuccess: LoggerHandler;
+/**
+ * Logs an error message through the global logger.
+ *
+ * @param data - The values to log.
+ */
 export declare const logError: LoggerHandler;
+/**
+ * Logs an informational message through the global logger.
+ *
+ * @param data - The values to log.
+ */
 export declare const logInfo: LoggerHandler;
+/**
+ * A logger that silently discards all messages.
+ *
+ * @example
+ * ```ts
+ * initLogger(silentLogger);
+ * logInfo("this is discarded");
+ * ```
+ */
 export declare const silentLogger: Logger;
+/**
+ * A logger that writes to the console using {@link console.log} and {@link console.error}.
+ *
+ * @example
+ * ```ts
+ * initLogger(consoleLogger);
+ * logSuccess("build complete");
+ * ```
+ */
 export declare const consoleLogger: Logger;
 //# sourceMappingURL=Logger.d.ts.map

package/dist/logger/Logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logger/Logger.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAErD,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;CACrB;AAID,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,WAAqB,CAAC;AAC5D,eAAO,MAAM,MAAM,QAAO,MAAkC,CAAC;AAG7D,eAAO,MAAM,UAAU,EAAE,aACE,CAAC;AAG5B,eAAO,MAAM,QAAQ,EAAE,aACE,CAAC;AAG1B,eAAO,MAAM,OAAO,EAAE,aACE,CAAC;AAEzB,eAAO,MAAM,YAAY,EAAE,MAI1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAI3B,CAAC"}
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logger/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,MAAM;IACrB,8BAA8B;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,6BAA6B;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,qCAAqC;IACrC,IAAI,EAAE,aAAa,CAAC;CACrB;AAID;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,WAAqB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,MAAkC,CAAC;AAE7D;;;;GAIG;AAEH,eAAO,MAAM,UAAU,EAAE,aACE,CAAC;AAE5B;;;;GAIG;AAEH,eAAO,MAAM,QAAQ,EAAE,aACE,CAAC;AAE1B;;;;GAIG;AAEH,eAAO,MAAM,OAAO,EAAE,aACE,CAAC;AAEzB;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,MAI1B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,MAI3B,CAAC"}

package/dist/logger/Logger.js

@@ -1,17 +1,66 @@
 let __logger = null;
+/**
+ * Initializes the global logger instance.
+ *
+ * @param log - The {@link Logger} implementation to use globally.
+ * @returns The logger that was set.
+ *
+ * @example
+ * ```ts
+ * initLogger(consoleLogger);
+ * ```
+ */
 export const initLogger = (log) => (__logger = log);
+/**
+ * Returns the current global logger, falling back to {@link silentLogger} if none has been initialized.
+ *
+ * @returns The active {@link Logger} instance.
+ */
 export const logger = () => __logger ?? silentLogger;
+/**
+ * Logs a success message through the global logger.
+ *
+ * @param data - The values to log.
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const logSuccess = (...data) => logger().success(...data);
+/**
+ * Logs an error message through the global logger.
+ *
+ * @param data - The values to log.
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const logError = (...data) => logger().error(...data);
+/**
+ * Logs an informational message through the global logger.
+ *
+ * @param data - The values to log.
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const logInfo = (...data) => logger().info(...data);
+/**
+ * A logger that silently discards all messages.
+ *
+ * @example
+ * ```ts
+ * initLogger(silentLogger);
+ * logInfo("this is discarded");
+ * ```
+ */
 export const silentLogger = {
     success: () => { },
     error: () => { },
     info: () => { },
 };
+/**
+ * A logger that writes to the console using {@link console.log} and {@link console.error}.
+ *
+ * @example
+ * ```ts
+ * initLogger(consoleLogger);
+ * logSuccess("build complete");
+ * ```
+ */
 export const consoleLogger = {
     success: console.log,
     error: console.error,

package/dist/logger/Logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/logger/Logger.ts"],"names":[],"mappings":"AASA,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,QAAQ,IAAI,YAAY,CAAC;AAE7D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAkB,CAAC,GAAG,IAAW,EAAQ,EAAE,CAChE,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAE5B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,GAAG,IAAW,EAAQ,EAAE,CAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AAE1B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAkB,CAAC,GAAG,IAAW,EAAQ,EAAE,CAC7D,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAEzB,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,OAAO,EAAE,OAAO,CAAC,GAAG;IACpB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,IAAI,EAAE,OAAO,CAAC,GAAG;CAClB,CAAC","sourcesContent":["// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type LoggerHandler = (...data: any[]) => void;\n\nexport interface Logger {\n  success: LoggerHandler;\n  error: LoggerHandler;\n  info: LoggerHandler;\n}\n\nlet __logger: Logger | null = null;\n\nexport const initLogger = (log: Logger) => (__logger = log);\nexport const logger = (): Logger => __logger ?? silentLogger;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const logSuccess: LoggerHandler = (...data: any[]): void =>\n  logger().success(...data);\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const logError: LoggerHandler = (...data: any[]): void =>\n  logger().error(...data);\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const logInfo: LoggerHandler = (...data: any[]): void =>\n  logger().info(...data);\n\nexport const silentLogger: Logger = {\n  success: () => {},\n  error: () => {},\n  info: () => {},\n};\n\nexport const consoleLogger: Logger = {\n  success: console.log,\n  error: console.error,\n  info: console.log,\n};\n"]}
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/logger/Logger.ts"],"names":[],"mappings":"AAkCA,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,QAAQ,IAAI,YAAY,CAAC;AAE7D;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAkB,CAAC,GAAG,IAAW,EAAQ,EAAE,CAChE,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAE5B;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAkB,CAAC,GAAG,IAAW,EAAQ,EAAE,CAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AAE1B;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAkB,CAAC,GAAG,IAAW,EAAQ,EAAE,CAC7D,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAEzB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,OAAO,EAAE,OAAO,CAAC,GAAG;IACpB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,IAAI,EAAE,OAAO,CAAC,GAAG;CAClB,CAAC","sourcesContent":["/**\n * A function that accepts variadic arguments and logs them.\n *\n * @example\n * ```ts\n * const handler: LoggerHandler = (...data) => console.log(...data);\n * handler(\"hello\", 42);\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type LoggerHandler = (...data: any[]) => void;\n\n/**\n * Logger interface providing success, error, and info logging channels.\n *\n * @example\n * ```ts\n * const myLogger: Logger = {\n *   success: console.log,\n *   error: console.error,\n *   info: console.log,\n * };\n * initLogger(myLogger);\n * ```\n */\nexport interface Logger {\n  /** Logs a success message. */\n  success: LoggerHandler;\n  /** Logs an error message. */\n  error: LoggerHandler;\n  /** Logs an informational message. */\n  info: LoggerHandler;\n}\n\nlet __logger: Logger | null = null;\n\n/**\n * Initializes the global logger instance.\n *\n * @param log - The {@link Logger} implementation to use globally.\n * @returns The logger that was set.\n *\n * @example\n * ```ts\n * initLogger(consoleLogger);\n * ```\n */\nexport const initLogger = (log: Logger) => (__logger = log);\n\n/**\n * Returns the current global logger, falling back to {@link silentLogger} if none has been initialized.\n *\n * @returns The active {@link Logger} instance.\n */\nexport const logger = (): Logger => __logger ?? silentLogger;\n\n/**\n * Logs a success message through the global logger.\n *\n * @param data - The values to log.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const logSuccess: LoggerHandler = (...data: any[]): void =>\n  logger().success(...data);\n\n/**\n * Logs an error message through the global logger.\n *\n * @param data - The values to log.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const logError: LoggerHandler = (...data: any[]): void =>\n  logger().error(...data);\n\n/**\n * Logs an informational message through the global logger.\n *\n * @param data - The values to log.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const logInfo: LoggerHandler = (...data: any[]): void =>\n  logger().info(...data);\n\n/**\n * A logger that silently discards all messages.\n *\n * @example\n * ```ts\n * initLogger(silentLogger);\n * logInfo(\"this is discarded\");\n * ```\n */\nexport const silentLogger: Logger = {\n  success: () => {},\n  error: () => {},\n  info: () => {},\n};\n\n/**\n * A logger that writes to the console using {@link console.log} and {@link console.error}.\n *\n * @example\n * ```ts\n * initLogger(consoleLogger);\n * logSuccess(\"build complete\");\n * ```\n */\nexport const consoleLogger: Logger = {\n  success: console.log,\n  error: console.error,\n  info: console.log,\n};\n"]}

package/dist/npmPublish/NpmPublisher.d.ts

@@ -1,8 +1,44 @@
 import { NpmPublisherParams } from "../types/types.npm.js";
 import { Pkg } from "../pkg/Pkg.js";
+/**
+ * Publishes all non-private workspace packages to the npm registry.
+ *
+ * @remarks
+ * Initialises the workspace from the given repository root, then delegates
+ * to {@link NpmPublisher.run} which publishes every public package in
+ * parallel. Already-published versions are automatically skipped.
+ *
+ * @param params - Publisher parameters containing the repository root path.
+ * @returns A promise that resolves when all packages have been processed.
+ *
+ * @example
+ * ```ts
+ * await runNpmPublisher({ repoRoot: "/path/to/repo" });
+ * ```
+ */
 export declare const runNpmPublisher: (params: NpmPublisherParams) => Promise<void>;
+/**
+ * Publishes workspace packages to the npm registry.
+ *
+ * @remarks
+ * Reads every package from the current workspace, attempts to publish each
+ * non-private package in parallel via `npm publish --access public`, and
+ * exits the process with code 1 if any publication fails. Packages whose
+ * exact version is already on the registry are silently skipped.
+ */
 export declare class NpmPublisher {
+    /** Creates a new {@link NpmPublisher} instance. */
     constructor();
+    /**
+     * Publishes all non-private workspace packages.
+     *
+     * @remarks
+     * Each package is published concurrently using `Promise.allSettled`.
+     * If one or more packages fail, the errors are logged and the process
+     * exits with code 1.
+     *
+     * @returns A promise that resolves when all publish attempts have settled.
+     */
     run(): Promise<void>;
     protected runPackage(pkg: Pkg): Promise<void>;
 }

package/dist/npmPublish/NpmPublisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NpmPublisher.d.ts","sourceRoot":"","sources":["../../src/npmPublish/NpmPublisher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC,eAAO,MAAM,eAAe,GAAU,QAAQ,kBAAkB,kBAG/D,CAAC;AAEF,qBAAa,YAAY;;IAGV,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;cAiBjB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAkCpD"}
+{"version":3,"file":"NpmPublisher.d.ts","sourceRoot":"","sources":["../../src/npmPublish/NpmPublisher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAAU,QAAQ,kBAAkB,kBAG/D,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,mDAAmD;;IAGnD;;;;;;;;;OASG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;cAiBjB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAkCpD"}

package/dist/npmPublish/NpmPublisher.js

@@ -1,12 +1,48 @@
 import { logError, logInfo, logSuccess } from "../logger/Logger.js";
 import { execAsync } from "../common/common.fs.js";
 import { initWorkspace, workspace } from "../workspace/Workspace.js";
+/**
+ * Publishes all non-private workspace packages to the npm registry.
+ *
+ * @remarks
+ * Initialises the workspace from the given repository root, then delegates
+ * to {@link NpmPublisher.run} which publishes every public package in
+ * parallel. Already-published versions are automatically skipped.
+ *
+ * @param params - Publisher parameters containing the repository root path.
+ * @returns A promise that resolves when all packages have been processed.
+ *
+ * @example
+ * ```ts
+ * await runNpmPublisher({ repoRoot: "/path/to/repo" });
+ * ```
+ */
 export const runNpmPublisher = async (params) => {
     initWorkspace(params.repoRoot);
     return new NpmPublisher().run();
 };
+/**
+ * Publishes workspace packages to the npm registry.
+ *
+ * @remarks
+ * Reads every package from the current workspace, attempts to publish each
+ * non-private package in parallel via `npm publish --access public`, and
+ * exits the process with code 1 if any publication fails. Packages whose
+ * exact version is already on the registry are silently skipped.
+ */
 export class NpmPublisher {
+    /** Creates a new {@link NpmPublisher} instance. */
     constructor() { }
+    /**
+     * Publishes all non-private workspace packages.
+     *
+     * @remarks
+     * Each package is published concurrently using `Promise.allSettled`.
+     * If one or more packages fail, the errors are logged and the process
+     * exits with code 1.
+     *
+     * @returns A promise that resolves when all publish attempts have settled.
+     */
     async run() {
         const pkgs = (await workspace().read()).packages;
         const results = await Promise.allSettled(pkgs.map((d) => this.runPackage(d)));

package/dist/npmPublish/NpmPublisher.js.map

@@ -1 +1 @@
-{"version":3,"file":"NpmPublisher.js","sourceRoot":"","sources":["../../src/npmPublish/NpmPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,MAA0B,EAAE,EAAE;IAClE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,IAAI,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,OAAO,YAAY;IACvB,gBAAsB,CAAC;IAEhB,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;QAEjD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACpC,CAAC;QAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,OAAO,QAAQ,CAAC,MAAM,gCAAgC,CAAC,CAAC;YACjE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC3B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAES,KAAK,CAAC,UAAU,CAAC,GAAQ;QACjC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAChC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QAEtC,OAAO,CACL,iBAAiB,IAAI,IAAI,OAAO,SAAS,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CACrE,CAAC;QAEF,mDAAmD;QACnD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,YAAY,IAAI,IAAI,OAAO,UAAU,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAEhC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC1B,OAAO,CAAC,OAAO,IAAI,IAAI,OAAO,+BAA+B,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yFAAyF;QAC3F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,6BAA6B,EAAE;gBAC7C,GAAG,EAAE,GAAG,CAAC,OAAO;aACjB,CAAC,CAAC;YACH,UAAU,CACR,KAAK,IAAI,IAAI,OAAO,4BAA4B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAC7E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,qBAAqB,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC;YAC1F,QAAQ,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF","sourcesContent":["import { logError, logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { execAsync } from \"../common/common.fs.js\";\nimport { NpmPublisherParams } from \"../types/types.npm.js\";\nimport { Pkg } from \"../pkg/Pkg.js\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\n\nexport const runNpmPublisher = async (params: NpmPublisherParams) => {\n  initWorkspace(params.repoRoot);\n  return new NpmPublisher().run();\n};\n\nexport class NpmPublisher {\n  public constructor() {}\n\n  public async run(): Promise<void> {\n    const pkgs = (await workspace().read()).packages;\n\n    const results = await Promise.allSettled(\n      pkgs.map((d) => this.runPackage(d)),\n    );\n\n    const failures = results.filter((r) => r.status === \"rejected\");\n    if (failures.length > 0) {\n      logError(`\\n❌ ${failures.length} package(s) failed to publish:`);\n      failures.forEach((failure) => {\n        logError(failure.reason);\n      });\n      process.exit(1);\n    }\n  }\n\n  protected async runPackage(pkg: Pkg): Promise<void> {\n    if (pkg.content.private) return;\n    const { name, version } = pkg.content;\n\n    logInfo(\n      `📦 Publishing ${name}@${version} ... (${new Date().toISOString()})`,\n    );\n\n    // Check if this exact version is already published\n    try {\n      const { stdout } = await execAsync(`npm view ${name}@${version} version`);\n      const published = stdout.trim();\n\n      if (published === version) {\n        logInfo(`⏭️  ${name}@${version} already published, skipping.`);\n        return;\n      }\n    } catch {\n      // npm view exits non-zero if the package/version doesn't exist — means we should publish\n    }\n\n    try {\n      await execAsync(\"npm publish --access public\", {\n        cwd: pkg.dirPath,\n      });\n      logSuccess(\n        `✅ ${name}@${version} published successfully (${new Date().toISOString()}).`,\n      );\n    } catch (err) {\n      const errorMessage = `Failed to publish ${name}@${version} (${new Date().toISOString()})`;\n      logError(`❌ ${errorMessage}`);\n      throw new Error(errorMessage, { cause: err });\n    }\n  }\n}\n"]}
+{"version":3,"file":"NpmPublisher.js","sourceRoot":"","sources":["../../src/npmPublish/NpmPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,MAA0B,EAAE,EAAE;IAClE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,IAAI,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACvB,mDAAmD;IACnD,gBAAsB,CAAC;IAEvB;;;;;;;;;OASG;IACI,KAAK,CAAC,GAAG;QACd,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC;QAEjD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACpC,CAAC;QAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,OAAO,QAAQ,CAAC,MAAM,gCAAgC,CAAC,CAAC;YACjE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC3B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAES,KAAK,CAAC,UAAU,CAAC,GAAQ;QACjC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAChC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QAEtC,OAAO,CACL,iBAAiB,IAAI,IAAI,OAAO,SAAS,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CACrE,CAAC;QAEF,mDAAmD;QACnD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,YAAY,IAAI,IAAI,OAAO,UAAU,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAEhC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC1B,OAAO,CAAC,OAAO,IAAI,IAAI,OAAO,+BAA+B,CAAC,CAAC;gBAC/D,OAAO;YACT,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yFAAyF;QAC3F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,6BAA6B,EAAE;gBAC7C,GAAG,EAAE,GAAG,CAAC,OAAO;aACjB,CAAC,CAAC;YACH,UAAU,CACR,KAAK,IAAI,IAAI,OAAO,4BAA4B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAC7E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,qBAAqB,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC;YAC1F,QAAQ,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF","sourcesContent":["import { logError, logInfo, logSuccess } from \"../logger/Logger.js\";\nimport { execAsync } from \"../common/common.fs.js\";\nimport { NpmPublisherParams } from \"../types/types.npm.js\";\nimport { Pkg } from \"../pkg/Pkg.js\";\nimport { initWorkspace, workspace } from \"../workspace/Workspace.js\";\n\n/**\n * Publishes all non-private workspace packages to the npm registry.\n *\n * @remarks\n * Initialises the workspace from the given repository root, then delegates\n * to {@link NpmPublisher.run} which publishes every public package in\n * parallel. Already-published versions are automatically skipped.\n *\n * @param params - Publisher parameters containing the repository root path.\n * @returns A promise that resolves when all packages have been processed.\n *\n * @example\n * ```ts\n * await runNpmPublisher({ repoRoot: \"/path/to/repo\" });\n * ```\n */\nexport const runNpmPublisher = async (params: NpmPublisherParams) => {\n  initWorkspace(params.repoRoot);\n  return new NpmPublisher().run();\n};\n\n/**\n * Publishes workspace packages to the npm registry.\n *\n * @remarks\n * Reads every package from the current workspace, attempts to publish each\n * non-private package in parallel via `npm publish --access public`, and\n * exits the process with code 1 if any publication fails. Packages whose\n * exact version is already on the registry are silently skipped.\n */\nexport class NpmPublisher {\n  /** Creates a new {@link NpmPublisher} instance. */\n  public constructor() {}\n\n  /**\n   * Publishes all non-private workspace packages.\n   *\n   * @remarks\n   * Each package is published concurrently using `Promise.allSettled`.\n   * If one or more packages fail, the errors are logged and the process\n   * exits with code 1.\n   *\n   * @returns A promise that resolves when all publish attempts have settled.\n   */\n  public async run(): Promise<void> {\n    const pkgs = (await workspace().read()).packages;\n\n    const results = await Promise.allSettled(\n      pkgs.map((d) => this.runPackage(d)),\n    );\n\n    const failures = results.filter((r) => r.status === \"rejected\");\n    if (failures.length > 0) {\n      logError(`\\n❌ ${failures.length} package(s) failed to publish:`);\n      failures.forEach((failure) => {\n        logError(failure.reason);\n      });\n      process.exit(1);\n    }\n  }\n\n  protected async runPackage(pkg: Pkg): Promise<void> {\n    if (pkg.content.private) return;\n    const { name, version } = pkg.content;\n\n    logInfo(\n      `📦 Publishing ${name}@${version} ... (${new Date().toISOString()})`,\n    );\n\n    // Check if this exact version is already published\n    try {\n      const { stdout } = await execAsync(`npm view ${name}@${version} version`);\n      const published = stdout.trim();\n\n      if (published === version) {\n        logInfo(`⏭️  ${name}@${version} already published, skipping.`);\n        return;\n      }\n    } catch {\n      // npm view exits non-zero if the package/version doesn't exist — means we should publish\n    }\n\n    try {\n      await execAsync(\"npm publish --access public\", {\n        cwd: pkg.dirPath,\n      });\n      logSuccess(\n        `✅ ${name}@${version} published successfully (${new Date().toISOString()}).`,\n      );\n    } catch (err) {\n      const errorMessage = `Failed to publish ${name}@${version} (${new Date().toISOString()})`;\n      logError(`❌ ${errorMessage}`);\n      throw new Error(errorMessage, { cause: err });\n    }\n  }\n}\n"]}

package/dist/osInfo/osInfo.common.d.ts

@@ -1,7 +1,51 @@
 import { OSInfo } from "../types/types.os.js";
+/**
+ * Returns the current operating-system information, creating it on first call.
+ *
+ * @remarks
+ * The result is lazily computed and cached for the lifetime of the process.
+ * On WSL environments (detected via the kernel release string) the info is
+ * sourced from the Windows host; otherwise the native Node.js APIs are used.
+ *
+ * @returns The cached {@link OSInfo} for the current environment.
+ * @throws {Error} If OS information cannot be determined.
+ *
+ * @example
+ * ```ts
+ * const info = osInfo();
+ * console.log(info.platform, info.homedir);
+ * ```
+ */
 export declare const osInfo: () => OSInfo;
+/**
+ * Builds OS information using native Node.js APIs.
+ *
+ * @remarks
+ * Resolves the platform-specific application configuration directory:
+ * - **Windows** (`win32`): `%APPDATA%`
+ * - **macOS** (`darwin`): `~/Library/Application Support`
+ * - **Linux / other**: `~/.config`
+ *
+ * @returns An {@link OSInfo} object for the current (non-WSL) environment.
+ */
 export declare const defaultInfo: () => OSInfo;
+/**
+ * Builds OS information for a Windows Subsystem for Linux (WSL) environment.
+ *
+ * @remarks
+ * Calls `whoami.exe` to determine the Windows username, then constructs
+ * paths that point into the Windows file system mounted under `/mnt/c`.
+ * The returned {@link OSInfo.isWSL} flag is always `true`.
+ *
+ * @returns An {@link OSInfo} object reflecting the Windows host environment.
+ * @throws {Error} If the Windows username cannot be determined from `whoami.exe`.
+ */
 export declare const wslInfo: () => OSInfo;
-/** @internal test-only */
+/**
+ * Resets the cached OS information so the next call to {@link osInfo} recomputes it.
+ *
+ * @internal
+ * This function is intended for testing purposes only.
+ */
 export declare const __resetOsInfo: () => void;
 //# sourceMappingURL=osInfo.common.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"osInfo.common.d.ts","sourceRoot":"","sources":["../../src/osInfo/osInfo.common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAM9C,eAAO,MAAM,MAAM,QAAO,MAOzB,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,MAmB9B,CAAC;AAEF,eAAO,MAAM,OAAO,QAAO,MAuB1B,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,aAAa,YAEzB,CAAC"}
+{"version":3,"file":"osInfo.common.d.ts","sourceRoot":"","sources":["../../src/osInfo/osInfo.common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAM9C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM,QAAO,MAOzB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,QAAO,MAmB9B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,QAAO,MAuB1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAEzB,CAAC"}

package/dist/osInfo/osInfo.common.js

@@ -2,6 +2,23 @@ import { join, sep } from "node:path";
 import * as os from "node:os";
 import { execSync } from "node:child_process";
 let __info = null;
+/**
+ * Returns the current operating-system information, creating it on first call.
+ *
+ * @remarks
+ * The result is lazily computed and cached for the lifetime of the process.
+ * On WSL environments (detected via the kernel release string) the info is
+ * sourced from the Windows host; otherwise the native Node.js APIs are used.
+ *
+ * @returns The cached {@link OSInfo} for the current environment.
+ * @throws {Error} If OS information cannot be determined.
+ *
+ * @example
+ * ```ts
+ * const info = osInfo();
+ * console.log(info.platform, info.homedir);
+ * ```
+ */
 export const osInfo = () => {
     if (!__info) {
         const isWSL = os.release().toLowerCase().includes("microsoft");
@@ -11,6 +28,17 @@ export const osInfo = () => {
     }
     return __info;
 };
+/**
+ * Builds OS information using native Node.js APIs.
+ *
+ * @remarks
+ * Resolves the platform-specific application configuration directory:
+ * - **Windows** (`win32`): `%APPDATA%`
+ * - **macOS** (`darwin`): `~/Library/Application Support`
+ * - **Linux / other**: `~/.config`
+ *
+ * @returns An {@link OSInfo} object for the current (non-WSL) environment.
+ */
 export const defaultInfo = () => {
     const platform = process.platform;
     const homedir = os.homedir();
@@ -32,6 +60,17 @@ export const defaultInfo = () => {
         configDir: join(...configDirParts),
     };
 };
+/**
+ * Builds OS information for a Windows Subsystem for Linux (WSL) environment.
+ *
+ * @remarks
+ * Calls `whoami.exe` to determine the Windows username, then constructs
+ * paths that point into the Windows file system mounted under `/mnt/c`.
+ * The returned {@link OSInfo.isWSL} flag is always `true`.
+ *
+ * @returns An {@link OSInfo} object reflecting the Windows host environment.
+ * @throws {Error} If the Windows username cannot be determined from `whoami.exe`.
+ */
 export const wslInfo = () => {
     const whoamiParts = execSync("whoami.exe").toString().split(sep);
     if (whoamiParts.length === 0)
@@ -54,7 +93,12 @@ export const wslInfo = () => {
         isWSL: true,
     };
 };
-/** @internal test-only */
+/**
+ * Resets the cached OS information so the next call to {@link osInfo} recomputes it.
+ *
+ * @internal
+ * This function is intended for testing purposes only.
+ */
 export const __resetOsInfo = () => {
     __info = null;
 };

package/dist/osInfo/osInfo.common.js.map

@@ -1 +1 @@
-{"version":3,"file":"osInfo.common.js","sourceRoot":"","sources":["../../src/osInfo/osInfo.common.ts"],"names":[],"mappings":"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","sourcesContent":["import { join, sep } from \"node:path\";\nimport { OSInfo } from \"../types/types.os.js\";\nimport * as os from \"node:os\";\nimport { execSync } from \"node:child_process\";\n\nlet __info: OSInfo | null = null;\n\nexport const osInfo = (): OSInfo => {\n  if (!__info) {\n    const isWSL = os.release().toLowerCase().includes(\"microsoft\");\n    __info = isWSL ? wslInfo() : defaultInfo();\n    if (!__info) throw new Error(\"Load OS info failed\");\n  }\n  return __info;\n};\n\nexport const defaultInfo = (): OSInfo => {\n  const platform = process.platform;\n  const homedir = os.homedir();\n  const configDirParts: string[] = [];\n\n  if (platform === \"win32\") {\n    if (process.env.APPDATA) configDirParts.push(process.env.APPDATA);\n  } else if (platform === \"darwin\") {\n    configDirParts.push(homedir, \"Library\", \"Application Support\");\n  } else {\n    configDirParts.push(homedir, \".config\");\n  }\n\n  return {\n    username: os.userInfo().username,\n    homedir,\n    platform,\n    configDir: join(...configDirParts),\n  };\n};\n\nexport const wslInfo = (): OSInfo => {\n  const whoamiParts = execSync(\"whoami.exe\").toString().split(sep);\n  if (whoamiParts.length === 0)\n    throw new Error(\"Windows user could not be determined\");\n\n  // const winUser = process.env[\"WINUSER\"] || process.env[\"USER\"];\n  const platform = process.platform;\n  let username = whoamiParts[whoamiParts.length - 1];\n  // remove AD group\n  const userParts = username.split(\"\\\\\");\n  username = userParts[userParts.length - 1];\n  username = username.replace(\"\\r\", \"\").replace(\"\\n\", \"\");\n  const parts: string[] = [\"/mnt\", \"c\", \"Users\", username];\n  const homedir = join(...parts);\n  const configDir = join(homedir, \"AppData\", \"Roaming\");\n\n  return {\n    username,\n    homedir,\n    configDir,\n    platform,\n    isWSL: true,\n  };\n};\n\n/** @internal test-only */\nexport const __resetOsInfo = () => {\n  __info = null;\n};\n"]}
+{"version":3,"file":"osInfo.common.js","sourceRoot":"","sources":["../../src/osInfo/osInfo.common.ts"],"names":[],"mappings":"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","sourcesContent":["import { join, sep } from \"node:path\";\nimport { OSInfo } from \"../types/types.os.js\";\nimport * as os from \"node:os\";\nimport { execSync } from \"node:child_process\";\n\nlet __info: OSInfo | null = null;\n\n/**\n * Returns the current operating-system information, creating it on first call.\n *\n * @remarks\n * The result is lazily computed and cached for the lifetime of the process.\n * On WSL environments (detected via the kernel release string) the info is\n * sourced from the Windows host; otherwise the native Node.js APIs are used.\n *\n * @returns The cached {@link OSInfo} for the current environment.\n * @throws {Error} If OS information cannot be determined.\n *\n * @example\n * ```ts\n * const info = osInfo();\n * console.log(info.platform, info.homedir);\n * ```\n */\nexport const osInfo = (): OSInfo => {\n  if (!__info) {\n    const isWSL = os.release().toLowerCase().includes(\"microsoft\");\n    __info = isWSL ? wslInfo() : defaultInfo();\n    if (!__info) throw new Error(\"Load OS info failed\");\n  }\n  return __info;\n};\n\n/**\n * Builds OS information using native Node.js APIs.\n *\n * @remarks\n * Resolves the platform-specific application configuration directory:\n * - **Windows** (`win32`): `%APPDATA%`\n * - **macOS** (`darwin`): `~/Library/Application Support`\n * - **Linux / other**: `~/.config`\n *\n * @returns An {@link OSInfo} object for the current (non-WSL) environment.\n */\nexport const defaultInfo = (): OSInfo => {\n  const platform = process.platform;\n  const homedir = os.homedir();\n  const configDirParts: string[] = [];\n\n  if (platform === \"win32\") {\n    if (process.env.APPDATA) configDirParts.push(process.env.APPDATA);\n  } else if (platform === \"darwin\") {\n    configDirParts.push(homedir, \"Library\", \"Application Support\");\n  } else {\n    configDirParts.push(homedir, \".config\");\n  }\n\n  return {\n    username: os.userInfo().username,\n    homedir,\n    platform,\n    configDir: join(...configDirParts),\n  };\n};\n\n/**\n * Builds OS information for a Windows Subsystem for Linux (WSL) environment.\n *\n * @remarks\n * Calls `whoami.exe` to determine the Windows username, then constructs\n * paths that point into the Windows file system mounted under `/mnt/c`.\n * The returned {@link OSInfo.isWSL} flag is always `true`.\n *\n * @returns An {@link OSInfo} object reflecting the Windows host environment.\n * @throws {Error} If the Windows username cannot be determined from `whoami.exe`.\n */\nexport const wslInfo = (): OSInfo => {\n  const whoamiParts = execSync(\"whoami.exe\").toString().split(sep);\n  if (whoamiParts.length === 0)\n    throw new Error(\"Windows user could not be determined\");\n\n  // const winUser = process.env[\"WINUSER\"] || process.env[\"USER\"];\n  const platform = process.platform;\n  let username = whoamiParts[whoamiParts.length - 1];\n  // remove AD group\n  const userParts = username.split(\"\\\\\");\n  username = userParts[userParts.length - 1];\n  username = username.replace(\"\\r\", \"\").replace(\"\\n\", \"\");\n  const parts: string[] = [\"/mnt\", \"c\", \"Users\", username];\n  const homedir = join(...parts);\n  const configDir = join(homedir, \"AppData\", \"Roaming\");\n\n  return {\n    username,\n    homedir,\n    configDir,\n    platform,\n    isWSL: true,\n  };\n};\n\n/**\n * Resets the cached OS information so the next call to {@link osInfo} recomputes it.\n *\n * @internal\n * This function is intended for testing purposes only.\n */\nexport const __resetOsInfo = () => {\n  __info = null;\n};\n"]}

package/dist/pkg/ExportExtractor.d.ts

@@ -0,0 +1,44 @@
+import { EntryPoint, ExportExtractorParams, ExportNode, PackageAPI } from "../types/types.exports.js";
+import { PackageJson } from "../types/types.package.js";
+export declare const runExportExtractor: (params: ExportExtractorParams) => Promise<void>;
+export declare class ExportExtractor {
+    readonly pkg: string;
+    /**
+     * Analyze an installed package and produce
+     * a structured API representation.
+     *
+     * @param pkg package name
+     */
+    constructor(pkg: string);
+    /**
+     * Analyze an installed package and build its API model.
+     */
+    run(): Promise<PackageAPI>;
+    writeJson(filePath: string, content: PackageAPI): Promise<void>;
+    toJson(content: PackageAPI): Promise<string>;
+    /**
+     * Resolve the root directory of an installed package.
+     */
+    protected resolvePackageRoot(pkg: string): string;
+    /**
+     * Resolve entrypoints using the Node exports algorithm.
+     */
+    protected resolveEntrypoints(pkg: string, pkgJson: PackageJson): EntryPoint[];
+    /**
+     * Expand wildcard export patterns.
+     */
+    protected expandWildcardEntrypoints(root: string, entrypoints: EntryPoint[]): Promise<EntryPoint[]>;
+    /**
+     * Dynamically import a module supporting ESM and CommonJS.
+     */
+    protected loadModule(id: string): Promise<Record<string, unknown>>;
+    /**
+     * Extract runtime exports from entrypoints.
+     */
+    protected inspectRuntimeExports(entrypoints: EntryPoint[]): Promise<ExportNode[]>;
+    /**
+     * Parse TypeScript declaration files to extract exported types.
+     */
+    protected parseTypeExports(root: string): Promise<ExportNode[]>;
+}
+//# sourceMappingURL=ExportExtractor.d.ts.map

package/dist/pkg/ExportExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportExtractor.d.ts","sourceRoot":"","sources":["../../src/pkg/ExportExtractor.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,UAAU,EACV,UAAU,EACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAOxD,eAAO,MAAM,kBAAkB,GAAU,QAAQ,qBAAqB,kBAWrE,CAAC;AAEF,qBAAa,eAAe;aAOS,GAAG,EAAE,MAAM;IAN9C;;;;;OAKG;gBACgC,GAAG,EAAE,MAAM;IAE9C;;OAEG;IACU,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;IAkB1B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKjD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,GACnB,UAAU,EAAE;IAmCf;;OAEG;cACa,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,UAAU,EAAE,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC;IAuBxB;;OAEG;cACa,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQxE;;OAEG;cACa,qBAAqB,CACnC,WAAW,EAAE,UAAU,EAAE,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC;IAiBxB;;OAEG;cACa,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CA0CtE"}