reporeadmerewriter 1.0.0

package/README.md

@@ -0,0 +1,92 @@
+# RepoReadmeRewriter (npm)
+
+RepoReadmeRewriter packages the existing [.NET ReadmeRewriter CLI](https://www.nuget.org/packages/RepoReadmeRewriter.CLI) as an npm module so it can be driven directly from JavaScript tooling. It rewrites README content by turning repository-relative links and images into absolute URLs and offers several cleanup utilities that the underlying CLI already supports.
+
+## Prerequisites
+
+- Node.js (18 or newer recommended)
+- The .NET runtime available on your PATH (the CLI runs as `dotnet ReadmeRewriterCLI.dll`). You can verify with `dotnet --info`.
+
+## Installation
+
+```bash
+npm install --save-dev reporeadmerewriter
+```
+
+After installation you can invoke the binary with npm scripts, `npx`, or the per-project shim under `node_modules/.bin/reporeadmerewriter`.
+
+## Configuration and option resolution
+
+RepoReadmeRewriter operates relative to the directory you execute it from (the .NET tool defaults to the current working directory). Relative paths for `readme`, `output`, `config` are resolved against that folder.
+
+RepoReadmeRewriter resolves CLI arguments for you before spawning the .NET executable. Resolution happens in the following order:
+
+1. Look for a `repoReadmeRewriter` block inside the nearest `package.json`.
+2. If that block is missing we try `repoReadmeRewriter.config.json` next to the same `package.json`.
+
+If neither source is found the command exits with an error explaining that no configuration was detected.
+
+The configuration object maps directly to CLI switches. Each camelCase property becomes a `--kebab-case` flag when passed to the executable (for example `repoUrl` becomes `--repo-url`). Refer to `reporeadmerewriter --help` for the authoritative meaning of each option exposed by the .NET tool.
+
+### Minimal examples
+
+`package.json`:
+
+```json
+{
+  "name": "example",
+  "repoReadmeRewriter": {
+    "repoUrl": "https://github.com/owner/repo",
+    "ref": "main",
+    "output": "OUTPUT.md"
+  }
+}
+```
+
+`repoReadmeRewriter.config.json` (same directory as `package.json`):
+
+```json
+{
+  "repoUrl": "https://github.com/owner/repo",
+  "ref": "main",
+  "output": "OUTPUT.md"
+}
+```
+
+If `repoUrl` is omitted we fall back to the repository URL declared in your `package.json` `repository` field (GitHub or GitLab). Other Boolean or string properties in the configuration object are forwarded verbatim to the CLI.
+
+## Usage
+
+Once your configuration is in place you can run:
+
+```bash
+npx reporeadmerewriter
+```
+
+Passing a help flag (`--help`, `-h`, `-?`, `/h`, or `/?`) bypasses configuration and shows the CLI's built-in help text.
+
+```bash
+npx reporeadmerewriter --help
+```
+
+## Programmatic API
+
+The default export mirrors the CLI entry point so you can invoke the bundled .NET executable yourself:
+
+```ts
+import repoRepoReadmeRewrite from "reporeadmerewriter";
+
+// Launch the .NET CLI directly when you already have the final argv array
+const exitCode = await repoRepoReadmeRewrite([
+  "--repo-url",
+  "https://github.com/owner/repo",
+  "--output",
+  "outputreadme.md",
+]);
+```
+
+`repoRepoReadmeRewrite` simply executes the embedded .NET binary with whatever arguments you supply.
+
+## License
+
+ISC © Tony Hallett

package/bin/RepoReadmeRewriterOptions.d.ts

@@ -0,0 +1,12 @@
+export interface RepoReadmeRewriterOptions {
+    errorOnHtml?: boolean;
+    removeHtml?: boolean;
+    extractDetailsSummary?: boolean;
+    config?: string;
+    ref?: string;
+    gh?: string;
+    readme?: string;
+    output?: string;
+    repoUrl?: string;
+}
+export declare const packageJsonOptionsConfigKey = "repoReadmeRewriter";

package/bin/RepoReadmeRewriterOptions.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageJsonOptionsConfigKey = void 0;
+exports.packageJsonOptionsConfigKey = "repoReadmeRewriter";

package/bin/cli/DotnetToolSettings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<DotNetCliTool Version="1">
+  <Commands>
+    <Command Name="reporeadmerewriter" EntryPoint="ReadmeRewriterCLI.dll" Runner="dotnet" />
+  </Commands>
+</DotNetCliTool>

package/bin/cli/ReadmeRewriterCLI.deps.json

@@ -0,0 +1,180 @@
+{
+  "runtimeTarget": {
+    "name": ".NETCoreApp,Version=v8.0",
+    "signature": ""
+  },
+  "compilationOptions": {},
+  "targets": {
+    ".NETCoreApp,Version=v8.0": {
+      "ReadmeRewriterCLI/1.0.0": {
+        "dependencies": {
+          "Microsoft.Extensions.DependencyInjection": "10.0.1",
+          "RepoReadmeRewriter": "1.0.0",
+          "Spectre.Console": "0.54.0",
+          "System.CommandLine": "2.0.1"
+        },
+        "runtime": {
+          "ReadmeRewriterCLI.dll": {}
+        }
+      },
+      "AngleSharp/1.3.0": {
+        "runtime": {
+          "lib/net8.0/AngleSharp.dll": {
+            "assemblyVersion": "1.3.0.0",
+            "fileVersion": "1.3.0.0"
+          }
+        }
+      },
+      "Markdig/0.42.0": {
+        "runtime": {
+          "lib/net8.0/Markdig.dll": {
+            "assemblyVersion": "0.42.0.0",
+            "fileVersion": "0.42.0.0"
+          }
+        }
+      },
+      "Microsoft.Extensions.DependencyInjection/10.0.1": {
+        "dependencies": {
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "10.0.1"
+        },
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.DependencyInjection.dll": {
+            "assemblyVersion": "10.0.0.0",
+            "fileVersion": "10.0.125.57005"
+          }
+        }
+      },
+      "Microsoft.Extensions.DependencyInjection.Abstractions/10.0.1": {
+        "runtime": {
+          "lib/net8.0/Microsoft.Extensions.DependencyInjection.Abstractions.dll": {
+            "assemblyVersion": "10.0.0.0",
+            "fileVersion": "10.0.125.57005"
+          }
+        }
+      },
+      "Spectre.Console/0.54.0": {
+        "runtime": {
+          "lib/net8.0/Spectre.Console.dll": {
+            "assemblyVersion": "0.0.0.0",
+            "fileVersion": "0.54.0.0"
+          }
+        }
+      },
+      "System.CommandLine/2.0.1": {
+        "runtime": {
+          "lib/net8.0/System.CommandLine.dll": {
+            "assemblyVersion": "2.0.1.0",
+            "fileVersion": "2.0.125.57005"
+          }
+        },
+        "resources": {
+          "lib/net8.0/cs/System.CommandLine.resources.dll": {
+            "locale": "cs"
+          },
+          "lib/net8.0/de/System.CommandLine.resources.dll": {
+            "locale": "de"
+          },
+          "lib/net8.0/es/System.CommandLine.resources.dll": {
+            "locale": "es"
+          },
+          "lib/net8.0/fr/System.CommandLine.resources.dll": {
+            "locale": "fr"
+          },
+          "lib/net8.0/it/System.CommandLine.resources.dll": {
+            "locale": "it"
+          },
+          "lib/net8.0/ja/System.CommandLine.resources.dll": {
+            "locale": "ja"
+          },
+          "lib/net8.0/ko/System.CommandLine.resources.dll": {
+            "locale": "ko"
+          },
+          "lib/net8.0/pl/System.CommandLine.resources.dll": {
+            "locale": "pl"
+          },
+          "lib/net8.0/pt-BR/System.CommandLine.resources.dll": {
+            "locale": "pt-BR"
+          },
+          "lib/net8.0/ru/System.CommandLine.resources.dll": {
+            "locale": "ru"
+          },
+          "lib/net8.0/tr/System.CommandLine.resources.dll": {
+            "locale": "tr"
+          },
+          "lib/net8.0/zh-Hans/System.CommandLine.resources.dll": {
+            "locale": "zh-Hans"
+          },
+          "lib/net8.0/zh-Hant/System.CommandLine.resources.dll": {
+            "locale": "zh-Hant"
+          }
+        }
+      },
+      "RepoReadmeRewriter/1.0.0": {
+        "dependencies": {
+          "AngleSharp": "1.3.0",
+          "Markdig": "0.42.0"
+        },
+        "runtime": {
+          "RepoReadmeRewriter.dll": {
+            "assemblyVersion": "1.0.0.0",
+            "fileVersion": "1.0.0.0"
+          }
+        }
+      }
+    }
+  },
+  "libraries": {
+    "ReadmeRewriterCLI/1.0.0": {
+      "type": "project",
+      "serviceable": false,
+      "sha512": ""
+    },
+    "AngleSharp/1.3.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-iHzfn4cK6CmhuURNdEpmSQCq5/HZFldEpkbnmqT9My8+6l2Sz3F+NxoqRA8z/jTkWB+SAu5boRdp4v/WtyjuIQ==",
+      "path": "anglesharp/1.3.0",
+      "hashPath": "anglesharp.1.3.0.nupkg.sha512"
+    },
+    "Markdig/0.42.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-tINdftVfbTujqfPXrQOSl9/6XCS2Y4Zwz+i7UPBgxRNnDtI1CjyQ5UA/5sKoSOmfECyWkTztY/vbcc/u1DA8nA==",
+      "path": "markdig/0.42.0",
+      "hashPath": "markdig.0.42.0.nupkg.sha512"
+    },
+    "Microsoft.Extensions.DependencyInjection/10.0.1": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-zerXV0GAR9LCSXoSIApbWn+Dq1/T+6vbXMHGduq1LoVQRHT0BXsGQEau0jeLUBUcsoF/NaUT8ADPu8b+eNcIyg==",
+      "path": "microsoft.extensions.dependencyinjection/10.0.1",
+      "hashPath": "microsoft.extensions.dependencyinjection.10.0.1.nupkg.sha512"
+    },
+    "Microsoft.Extensions.DependencyInjection.Abstractions/10.0.1": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-oIy8fQxxbUsSrrOvgBqlVgOeCtDmrcynnTG+FQufcUWBrwyPfwlUkCDB2vaiBeYPyT+20u9/HeuHeBf+H4F/8g==",
+      "path": "microsoft.extensions.dependencyinjection.abstractions/10.0.1",
+      "hashPath": "microsoft.extensions.dependencyinjection.abstractions.10.0.1.nupkg.sha512"
+    },
+    "Spectre.Console/0.54.0": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-StDXCFayfy0yB1xzUHT2tgEpV1/HFTiS4JgsAQS49EYTfMixSwwucaQs/bIOCwXjWwIQTMuxjUIxcB5XsJkFJA==",
+      "path": "spectre.console/0.54.0",
+      "hashPath": "spectre.console.0.54.0.nupkg.sha512"
+    },
+    "System.CommandLine/2.0.1": {
+      "type": "package",
+      "serviceable": true,
+      "sha512": "sha512-GLc43eDFq8KbpxIb7UhTwV0vC5CzB0NspJvfFbfhoW4O057xCJXuO18KLpVn9x3JykQn2mRske6+I6JXHwqmDg==",
+      "path": "system.commandline/2.0.1",
+      "hashPath": "system.commandline.2.0.1.nupkg.sha512"
+    },
+    "RepoReadmeRewriter/1.0.0": {
+      "type": "project",
+      "serviceable": false,
+      "sha512": ""
+    }
+  }
+}

package/bin/cli/ReadmeRewriterCLI.runtimeconfig.json

@@ -0,0 +1,13 @@
+{
+  "runtimeOptions": {
+    "tfm": "net8.0",
+    "framework": {
+      "name": "Microsoft.NETCore.App",
+      "version": "8.0.0"
+    },
+    "configProperties": {
+      "System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
+      "System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
+    }
+  }
+}

package/bin/findPackageJson.d.ts

@@ -0,0 +1,6 @@
+interface PackageJsonInfo {
+    content: Record<string, unknown>;
+    path: string;
+}
+export declare function findPackageJson(): PackageJsonInfo;
+export {};

package/bin/findPackageJson.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPackageJson = findPackageJson;
+const fs = __importStar(require("fs"));
+const findPackageJsonPath_1 = require("./findPackageJsonPath");
+function findPackageJson() {
+    const pkgPath = (0, findPackageJsonPath_1.findPackageJsonPath)();
+    const pkgContent = fs.readFileSync(pkgPath, "utf-8");
+    return {
+        content: JSON.parse(pkgContent),
+        path: pkgPath,
+    };
+}

package/bin/findPackageJsonPath.d.ts

@@ -0,0 +1 @@
+export declare function findPackageJsonPath(): string;

package/bin/findPackageJsonPath.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPackageJsonPath = findPackageJsonPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("node:path"));
+function findPackageJsonPath() {
+    let dir = process.cwd();
+    while (true) {
+        const pkgPath = path.join(dir, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            return pkgPath;
+        }
+        const parentDir = path.dirname(dir);
+        if (parentDir === dir) {
+            throw new Error("Could not find package.json");
+        }
+        dir = parentDir;
+    }
+}

package/bin/getCLIArgs.d.ts

@@ -0,0 +1 @@
+export declare function getCLIArgs(args: string[]): string[];

package/bin/getCLIArgs.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCLIArgs = getCLIArgs;
+const getHelpCLIArgs_1 = require("./getHelpCLIArgs");
+const getCLIArgsFromJson_1 = require("./getCLIArgsFromJson");
+function getCLIArgs(args) {
+    return (0, getHelpCLIArgs_1.getHelpCLIArgs)(args) ?? (0, getCLIArgsFromJson_1.getCLIArgsFromJson)();
+}

package/bin/getCLIArgsFromJson.d.ts

@@ -0,0 +1,2 @@
+export declare const NoOptionsErrorMessage = "No repoReadmeRewriter package.json field or repoReadmeRewriter.config.json";
+export declare function getCLIArgsFromJson(): string[];

package/bin/getCLIArgsFromJson.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOptionsErrorMessage = void 0;
+exports.getCLIArgsFromJson = getCLIArgsFromJson;
+const findPackageJson_1 = require("./findPackageJson");
+const getCLIArgsFromPackageOptions_1 = require("./getCLIArgsFromPackageOptions");
+const getOptionsFromConfig_1 = require("./getOptionsFromConfig");
+const RepoReadmeRewriterOptions_1 = require("./RepoReadmeRewriterOptions");
+exports.NoOptionsErrorMessage = `No ${RepoReadmeRewriterOptions_1.packageJsonOptionsConfigKey} package.json field or ${getOptionsFromConfig_1.CONFIG_FILE_NAME}`;
+function getCLIArgsFromJson() {
+    const { content: packageJson, path: packageJsonPath } = (0, findPackageJson_1.findPackageJson)();
+    let options;
+    if (packageJson["repoReadmeRewriter"] == undefined) {
+        options = (0, getOptionsFromConfig_1.getOptionsFromConfig)(packageJsonPath);
+    }
+    else {
+        options = packageJson["repoReadmeRewriter"];
+    }
+    if (options == undefined) {
+        throw new Error(exports.NoOptionsErrorMessage);
+    }
+    return (0, getCLIArgsFromPackageOptions_1.getCLIArgsFromPackageOptions)({
+        repoReadmeRewriter: options,
+        repository: packageJson.repository,
+    });
+}

package/bin/getCLIArgsFromPackageOptions.d.ts

@@ -0,0 +1,7 @@
+import { RepoReadmeRewriterOptions } from "./RepoReadmeRewriterOptions";
+import { RepositoryField } from "./resolveRepositoryUrl";
+export interface PackageJsonOptions {
+    repoReadmeRewriter: RepoReadmeRewriterOptions;
+    repository: RepositoryField | undefined;
+}
+export declare function getCLIArgsFromPackageOptions(packageOptions: PackageJsonOptions): string[];

package/bin/getCLIArgsFromPackageOptions.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCLIArgsFromPackageOptions = getCLIArgsFromPackageOptions;
+const resolveRepositoryUrl_1 = require("./resolveRepositoryUrl");
+function getOption(name, value) {
+    if (value === undefined) {
+        return [];
+    }
+    if (typeof value === "boolean") {
+        return value ? [`--${name}`] : [];
+    }
+    return [`--${name}`, value];
+}
+function getCLIArgsFromPackageOptions(packageOptions) {
+    const options = packageOptions.repoReadmeRewriter;
+    let repoUrl = options.repoUrl;
+    if (!repoUrl && packageOptions.repository) {
+        repoUrl = (0, resolveRepositoryUrl_1.resolveRepositoryUrl)(packageOptions.repository);
+    }
+    return [
+        ...getOption("repo-url", repoUrl),
+        ...getOption("error-on-html", options.errorOnHtml),
+        ...getOption("remove-html", options.removeHtml),
+        ...getOption("extract-details-summary", options.extractDetailsSummary),
+        ...getOption("config", options.config),
+        ...getOption("ref", options.ref),
+        ...getOption("gh", options.gh),
+        ...getOption("readme", options.readme),
+        ...getOption("output", options.output),
+    ];
+}

package/bin/getHelpCLIArgs.d.ts

@@ -0,0 +1 @@
+export declare function getHelpCLIArgs(args: string[]): string[] | undefined;

package/bin/getHelpCLIArgs.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHelpCLIArgs = getHelpCLIArgs;
+function getHelpCLIArgs(args) {
+    const helpFlags = new Set(["--help", "-h", "/h", "-?", "/?"]);
+    const requestedHelp = args.some((a) => helpFlags.has(a));
+    if (requestedHelp) {
+        return args;
+    }
+    return undefined;
+}

package/bin/getOptionsFromConfig.d.ts

@@ -0,0 +1,3 @@
+import { RepoReadmeRewriterOptions } from "./RepoReadmeRewriterOptions";
+export declare const CONFIG_FILE_NAME = "repoReadmeRewriter.config.json";
+export declare function getOptionsFromConfig(packageJsonPath: string): RepoReadmeRewriterOptions | undefined;

package/bin/getOptionsFromConfig.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILE_NAME = void 0;
+exports.getOptionsFromConfig = getOptionsFromConfig;
+const path = __importStar(require("node:path"));
+const loadAndParseConfigFile_1 = require("./loadAndParseConfigFile");
+exports.CONFIG_FILE_NAME = "repoReadmeRewriter.config.json";
+function asRepoReadmeRewriterOptions(value) {
+    if (value == null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${exports.CONFIG_FILE_NAME} must contain an object of repoReadmeRewriter options`);
+    }
+    return value;
+}
+function getOptionsFromConfig(packageJsonPath) {
+    const configPath = path.join(path.dirname(packageJsonPath), exports.CONFIG_FILE_NAME);
+    const parsed = (0, loadAndParseConfigFile_1.loadAndParseConfigFile)(configPath);
+    if (parsed === undefined) {
+        return undefined;
+    }
+    return asRepoReadmeRewriterOptions(parsed);
+}

package/bin/index.d.ts

@@ -0,0 +1,2 @@
+import { repoRepoReadmeRewrite } from "./repoRepoReadmeRewrite";
+export default repoRepoReadmeRewrite;

package/bin/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const repoRepoReadmeRewrite_1 = require("./repoRepoReadmeRewrite");
+exports.default = repoRepoReadmeRewrite_1.repoRepoReadmeRewrite;

package/bin/loadAndParseConfigFile.d.ts

@@ -0,0 +1 @@
+export declare function loadAndParseConfigFile(configPath: string): unknown | undefined;

package/bin/loadAndParseConfigFile.js

@@ -0,0 +1,60 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAndParseConfigFile = loadAndParseConfigFile;
+const fs = __importStar(require("fs"));
+const getOptionsFromConfig_1 = require("./getOptionsFromConfig");
+function loadAndParseConfigFile(configPath) {
+    if (!fs.existsSync(configPath)) {
+        return undefined;
+    }
+    let fileContent;
+    try {
+        fileContent = fs.readFileSync(configPath, "utf-8");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to read ${getOptionsFromConfig_1.CONFIG_FILE_NAME}: ${message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fileContent);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to parse ${getOptionsFromConfig_1.CONFIG_FILE_NAME}: ${message}`);
+    }
+    return parsed;
+}

package/bin/repoRepoReadmeRewrite.d.ts

@@ -0,0 +1 @@
+export declare function repoRepoReadmeRewrite(args: string[]): Promise<number>;

package/bin/repoRepoReadmeRewrite.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repoRepoReadmeRewrite = repoRepoReadmeRewrite;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+function repoRepoReadmeRewrite(args) {
+    return new Promise((resolve) => {
+        const dllPath = path_1.default.join(__dirname, "cli", "ReadmeRewriterCLI.dll");
+        const child = (0, child_process_1.spawn)("dotnet", [dllPath, ...args], {
+            stdio: "inherit",
+        });
+        child.on("error", (err) => {
+            console.error([
+                "Failed to launch 'dotnet' (spawn error).",
+                "Ensure .NET is installed and available on PATH (try 'dotnet --info').",
+                String(err),
+            ].join("\n"));
+            resolve(1);
+        });
+        child.on("close", (code) => {
+            // Non-zero exits are emitted by the CLI itself (e.g., missing args).
+            // We inherit stdio so the CLI already printed context; just propagate the code.
+            resolve(code ?? 1);
+        });
+    });
+}

package/bin/resolveRepositoryUrl.d.ts

@@ -0,0 +1,6 @@
+export type RepositoryField = string | {
+    url: string;
+    type?: string;
+    directory?: string;
+};
+export declare function resolveRepositoryUrl(repo: RepositoryField): string;

package/bin/resolveRepositoryUrl.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRepositoryUrl = resolveRepositoryUrl;
+const hosted_git_info_1 = __importDefault(require("hosted-git-info"));
+function resolveRepositoryUrl(repo) {
+    const raw = typeof repo === "string" ? repo : repo.url;
+    if (!raw) {
+        throw new Error("Repository field is empty or invalid.");
+    }
+    const info = hosted_git_info_1.default.fromUrl(raw);
+    if (!info) {
+        throw new Error(`Unable to parse repository URL: ${raw}`);
+    }
+    throwIfNotSupportedHost(info);
+    // Clean HTTPS URL without git+ prefix or .git suffix
+    return info.browse({ noGitPlus: true });
+}
+function throwIfNotSupportedHost(info) {
+    const supportedHosts = ["github", "gitlab"];
+    const supportedHost = supportedHosts.includes(info.type);
+    if (!supportedHost) {
+        throw new Error("Only GitHub and GitLab repositories are supported.");
+    }
+}

package/bin/rewriter.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/rewriter.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const runProcessArgs_1 = require("./runProcessArgs");
+function run() {
+    return (0, runProcessArgs_1.runProcessArgs)(process.argv.slice(2));
+}
+// Only execute when run directly as a CLI, not when imported.
+if (require.main === module) {
+    run().then((code) => process.exit(code));
+}

package/bin/runProcessArgs.d.ts

@@ -0,0 +1 @@
+export declare function runProcessArgs(args: string[]): Promise<number>;

package/bin/runProcessArgs.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runProcessArgs = runProcessArgs;
+const getCLIArgs_1 = require("./getCLIArgs");
+const repoRepoReadmeRewrite_1 = require("./repoRepoReadmeRewrite");
+async function runProcessArgs(args) {
+    try {
+        return await (0, repoRepoReadmeRewrite_1.repoRepoReadmeRewrite)((0, getCLIArgs_1.getCLIArgs)(args));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(msg);
+        return 1;
+    }
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "reporeadmerewriter",
+  "version": "1.0.0",
+  "description": "tool that rewrites repo relative asset links ( Gitlab / Github ) to absolute. Can also remove / replace ",
+  "main": "bin/index.js",
+  "types": "bin/index.d.ts",
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('bin', { recursive: true, force: true });\"",
+    "copy-cli": "tsx ./scripts/copy-cli.ts",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "set-bin-exec": "node ./scripts/set-bin-exec.js",
+    "prepare": "npm run build && npm run copy-cli && npm run set-bin-exec",
+    "pretest:integration": "npm run prepare && npm pack",
+    "test": "npm run test:unit && npm run test:integration",
+    "test:unit": "jest __tests__/rewriter",
+    "test:integration": "jest __tests__/integration.test.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tonyhallett/RepoReadmeRewriter.git"
+  },
+  "keywords": [
+    "readme",
+    "GitHub",
+    "GitLab",
+    "relative",
+    "links",
+    "images"
+  ],
+  "author": "Tony Hallett",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/tonyhallett/RepoReadmeRewriter/issues"
+  },
+  "homepage": "https://github.com/tonyhallett/RepoReadmeRewriter#readme",
+  "bin": {
+    "reporeadmerewriter": "bin/rewriter.js"
+  },
+  "dependencies": {
+    "@types/node": "^25.0.8",
+    "adm-zip": "^0.5.16",
+    "hosted-git-info": "^9.0.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/hosted-git-info": "^3.0.5",
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.21.0"
+  }
+}