mdrefine 0.1.0-beta.1

package/CONTRIBUTING.md

@@ -0,0 +1,10 @@
+# Contributing
+
+Human and agent-authored issues and pull requests are welcome. Read the
+[contribution guide](https://viell-dev.github.io/slop-markdown-tools/contributing.html)
+for defect reports, development, verification, and PR policy. This project is
+agent-maintained, as described in [README.md](README.md).
+
+Changes to document rendering need a minimal synthetic regression example.
+Remove private vault content and credentials from all reports. Report security
+vulnerabilities through the channel in [SECURITY.md](SECURITY.md).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 viell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# mdrefine — Markdown Tools
+
+Configurable linting and formatting for CommonMark, GitHub Markdown, and
+Obsidian. Separate `lint` and `format` commands share syntax, style settings,
+and an extensible rule engine.
+
+## Maintenance
+
+This project is developed and maintained by AI agents. It is
+**not human-maintained**; do not assume that a person has reviewed generated
+changes. Human and agent-authored issues and pull requests are welcome.
+Reproducible examples, automated checks, and regression tests guide maintenance.
+
+The project is currently an early prerelease. Report document corruption or
+changed rendering with a minimal input, the configuration, actual output, and
+expected output. Remove private content before posting examples. Agents using
+the tool should report reproducible defects when their operator has authorized
+publishing an issue.
+
+## Documentation
+
+Read the
+[quick start](https://viell-dev.github.io/slop-markdown-tools/quick-start.html)
+or browse the
+[documentation site](https://viell-dev.github.io/slop-markdown-tools/). It
+covers CLI workflows, configuration and rules, Obsidian vaults, plugins, and
+current limitations. The Markdown source lives in `docs/`.
+
+## Getting started
+
+The CLI requires Node.js 22.12 or newer. The npm package is `mdrefine`; the
+executable is `mdtools`. To install the beta in your document workspace:
+
+```sh
+npm install --save-dev --save-exact mdrefine@0.1.0-beta.1
+npx --no-install mdtools --help
+```
+
+See the
+[release procedure](https://viell-dev.github.io/slop-markdown-tools/releases.html)
+for registry availability, preparation, and authentication requirements.
+
+Inspect your documents from the workspace where you installed the package:
+
+```sh
+npx --no-install mdtools lint --root /path/to/documents --json
+npx --no-install mdtools format --root /path/to/documents --diff
+npx --no-install mdtools format --root /path/to/documents --write
+npx --no-install mdtools format --root /path/to/documents --check
+```
+
+`lint` never writes documents. `format` previews a diff by default for file
+inputs and writes only with `--write`. For stdin, `format -` returns formatted
+Markdown on stdout. Diagnostics use stderr unless `--json` requests a structured
+report. `--no-install` prevents fetching a different package if the local
+executable is missing.
+
+## Build from source
+
+For development, use Node.js 22.22.2+ or 24.15.0+ and npm 10 or newer; Node.js
+24 LTS is preferred.
+
+```sh
+git clone https://github.com/viell-dev/slop-markdown-tools.git
+cd slop-markdown-tools
+npm ci
+npm run build
+node dist/cli/main.js --help
+```
+
+From the checkout, use `node dist/cli/main.js` in place of
+`npx --no-install mdtools` in the examples above. You can also install the built
+checkout as a local dependency.
+
+## Contributions and verification
+
+All changes to `main` require a pull request and passing CI, including
+prerelease maintenance. Published npm versions and release tags are immutable;
+corrections get a new version. See [CONTRIBUTING.md](CONTRIBUTING.md) and
+[SECURITY.md](SECURITY.md) for contribution and vulnerability reporting.
+
+Issues and PRs from people and agents are welcome. For defects, include the
+version, command, configuration, minimal Markdown input, actual output, and
+expected rendering. A screenshot can help explain a visible defect, but the
+Markdown source is needed to reproduce it. For agents, include the JSON
+diagnostic output when available. Automatic issue reporting is not built into
+the tool.
+
+```sh
+npm run check
+npm run test:package
+```
+
+The project uses Markdown Tools to lint and format its own Markdown at the
+default 80-column width. `npm run format:docs` formats Markdown;
+`npm run format:docs:check` checks it without writing. Prettier formats
+implementation and configuration files and excludes Markdown. `npm run format`
+runs both formatters. Markdown fixtures under `tests/fixtures/` are excluded
+from documentation passes.
+
+`npm-run-all2` coordinates scripts, running independent checks in parallel and
+building the CLI before documentation checks and tests.
+
+`check` runs strict TypeScript checks, ESLint, Prettier for non-Markdown files,
+Markdown Tools for documentation, the VitePress site build, and
+regression/property/CLI tests. GitHub Actions runs checks on Linux with Node.js
+22 and 24, plus macOS and Windows with Node.js 24. Changes to formatting need
+tests for expected output, idempotence, and preserved semantics; defects should
+add a regression example. Keep fixes scoped and describe remaining limitations
+in the PR.
+
+Agent contributors should read
+[AGENTS.md](https://github.com/viell-dev/slop-markdown-tools/blob/main/AGENTS.md)
+for maintenance-specific instructions. `test:package` packs and installs a
+temporary consumer project, then exercises the installed CLI and library; it can
+require access to the npm registry.
+
+## Documentation website
+
+```sh
+npm run docs:dev
+npm run docs:build
+npm run docs:preview
+```
+
+VitePress renders `docs/`; Markdown Tools formats its Markdown sources. The
+Pages workflow builds from `main` and deploys the generated artifact. No
+publishing branch or committed build output is needed. See the
+[documentation workflow](https://viell-dev.github.io/slop-markdown-tools/contributing.html#write-and-preview-documentation).
+
+## License
+
+[MIT](LICENSE).

package/SECURITY.md

@@ -0,0 +1,16 @@
+# Security policy
+
+Report suspected vulnerabilities through
+[GitHub private vulnerability reporting](https://github.com/viell-dev/slop-markdown-tools/security/advisories/new).
+Include the affected version, configuration, and a minimal synthetic example. Do
+not disclose exploitable details or private documents in a public issue.
+
+This project is maintained by agents, without a guaranteed response time.
+Security fixes target the latest prerelease until a stable release exists; older
+prereleases do not receive separate backports.
+
+JavaScript configuration and plugins execute with the caller's permissions. Only
+load trusted code. JSON configuration is data, but its plugin entries can still
+load executable code. Link validation does not fetch external URLs. Document
+rendering defects without a security impact belong in ordinary issues; remove
+private content before posting.

package/dist/cli/main.d.ts

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

package/dist/cli/main.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { createTwoFilesPatch } from "diff";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { format, lint, ruleRegistry } from "../core/engine.js";
+import { loadConfig } from "../config/load.js";
+import { resolveConfig } from "../config/resolve.js";
+import { discover, writeAtomic } from "../workspace/files.js";
+import { createWorkspace } from "../workspace/index.js";
+const manifest = JSON.parse(await readFile(fileURLToPath(new URL("../../package.json", import.meta.url)), "utf8"));
+const program = new Command()
+    .name("mdtools")
+    .description("Lint and format Markdown with explicit dialects and configurable rules.")
+    .version(manifest.version);
+function common(command) {
+    return command
+        .option("--config <file>", "Explicit JSON, JSONC, or .mjs configuration")
+        .option("--root <directory>", "Workspace root (default: configuration directory or cwd)")
+        .option("--dialect <dialect>", "commonmark, github, or obsidian")
+        .option("--json", "Machine-readable output")
+        .option("--stdin-filepath <file>", "Filename context for stdin")
+        .option("--max-warnings <count>", "Fail when warning count exceeds this nonnegative integer", (value) => {
+        const number = Number(value);
+        if (!Number.isInteger(number) || number < 0)
+            throw new Error("--max-warnings must be a nonnegative integer.");
+        return number;
+    });
+}
+async function run(mode, inputs, flags) {
+    if ([flags.check, flags.diff, flags.write].filter(Boolean).length > 1)
+        throw new Error("Choose only one of --check, --diff, and --write.");
+    const loaded = await loadConfig(path.resolve(flags.root ?? "."), flags.config);
+    const root = path.resolve(flags.root ?? loaded.root);
+    if (flags.dialect)
+        loaded.config.dialect = flags.dialect;
+    const resolved = resolveConfig(loaded.config, "document.md", loaded.plugins);
+    const stdin = inputs.includes("-");
+    if (stdin && (inputs.length !== 1 || flags.write))
+        throw new Error("stdin must be the only input and cannot be combined with --write.");
+    const set = await discover(root, stdin ? [] : inputs, resolved.ignore);
+    if (stdin) {
+        const name = path
+            .relative(root, path.resolve(flags.stdinFilepath ?? path.join(root, "stdin.md")))
+            .split(path.sep)
+            .join("/");
+        if (name.startsWith("../") || path.isAbsolute(name))
+            throw new Error("--stdin-filepath must be within the workspace.");
+        let source = "";
+        process.stdin.setEncoding("utf8");
+        for await (const chunk of process.stdin)
+            source += String(chunk);
+        set.files[name] = source;
+        set.selected = [name];
+    }
+    const reports = [];
+    const changes = [];
+    // One index per active dialect; build lazily for mixed documentation workspaces.
+    const indexes = new Map();
+    for (const name of set.selected) {
+        const config = resolveConfig(loaded.config, name, loaded.plugins);
+        if (!indexes.has(config.dialect))
+            indexes.set(config.dialect, createWorkspace(set.files, {
+                dialect: config.dialect,
+                ...(set.strictLineBreaks !== undefined ? { strictLineBreaks: set.strictLineBreaks } : {}),
+            }));
+        const options = {
+            path: name,
+            config: loaded.config,
+            plugins: loaded.plugins,
+            workspace: indexes.get(config.dialect),
+        };
+        const source = set.files[name];
+        if (source === null)
+            continue;
+        if (mode === "lint")
+            reports.push({ path: name, diagnostics: lint(source, options) });
+        else {
+            const result = format(source, options);
+            reports.push({
+                path: name,
+                changed: result.changed,
+                diagnostics: result.diagnostics,
+                ...(stdin && !flags.check ? { output: result.output } : {}),
+            });
+            if (result.changed)
+                changes.push({ file: name, before: source, after: result.output });
+        }
+    }
+    const unsafe = reports.some((report) => report.diagnostics.some((item) => item.rule === "engine/unsafe-format"));
+    if (flags.write && !unsafe)
+        for (const change of changes)
+            await writeAtomic(path.join(set.root, change.file), change.before, change.after);
+    if (flags.json)
+        process.stdout.write(JSON.stringify({
+            version: manifest.version,
+            mode,
+            files: reports,
+            written: flags.write === true && !unsafe,
+        }, null, 2) + "\n");
+    else {
+        if (stdin && mode === "format" && !flags.check && !flags.diff)
+            process.stdout.write(reports[0]?.output ?? "");
+        else if (mode === "format" && !flags.check && !flags.write)
+            for (const change of changes)
+                process.stdout.write(createTwoFilesPatch(`a/${change.file}`, `b/${change.file}`, change.before, change.after));
+        for (const report of reports)
+            for (const item of report.diagnostics)
+                process.stderr.write(`${report.path}:${item.line}:${item.column}: ${item.severity} ${item.rule}: ${item.message}\n`);
+        if (!stdin)
+            process.stderr.write(`${set.selected.length} file(s) ${mode === "lint" ? "linted" : "processed"}; ${changes.length} ${flags.write && !unsafe ? "written" : "would change"}.\n`);
+    }
+    const diagnostics = reports.flatMap((report) => report.diagnostics);
+    const errors = diagnostics.some((item) => item.severity === "error");
+    const tooManyWarnings = flags.maxWarnings !== undefined &&
+        diagnostics.filter((item) => item.severity === "warn").length > flags.maxWarnings;
+    process.exitCode = unsafe
+        ? 2
+        : errors || tooManyWarnings || (flags.check && changes.length > 0)
+            ? 1
+            : 0;
+}
+common(program.command("lint").argument("[paths...]", "Markdown files/directories, or - for stdin")).action((inputs, flags) => run("lint", inputs, flags));
+common(program.command("format").argument("[paths...]", "Markdown files/directories, or - for stdin"))
+    .option("--check", "Fail if formatting changes would be needed")
+    .option("--diff", "Preview the complete diff (default for file inputs)")
+    .option("--write", "Write validated formatting changes")
+    .action((inputs, flags) => run("format", inputs, flags));
+common(program.command("config").description("Inspect effective configuration"))
+    .command("explain <file>")
+    .action(async (file, _flags, command) => {
+    const flags = command.parent.opts();
+    const loaded = await loadConfig(path.resolve(flags.root ?? "."), flags.config);
+    if (flags.dialect)
+        loaded.config.dialect = flags.dialect;
+    const root = path.resolve(flags.root ?? loaded.root);
+    process.stdout.write(JSON.stringify({
+        root,
+        file: loaded.file ?? null,
+        effective: resolveConfig(loaded.config, path.relative(root, path.resolve(file)).split(path.sep).join("/"), loaded.plugins),
+    }, null, 2) + "\n");
+});
+program
+    .command("rules")
+    .description("List built-in rules")
+    .action(() => {
+    for (const [name, rule] of Object.entries(ruleRegistry()))
+        process.stdout.write(`${name}\t${rule.kind}\t${rule.description}\n`);
+});
+try {
+    await program.parseAsync();
+}
+catch (error) {
+    process.stderr.write(`mdtools: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 2;
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { createTwoFilesPatch } from \"diff\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { format, lint, ruleRegistry } from \"../core/engine.js\";\nimport { loadConfig } from \"../config/load.js\";\nimport { resolveConfig } from \"../config/resolve.js\";\nimport { discover, writeAtomic } from \"../workspace/files.js\";\nimport { createWorkspace } from \"../workspace/index.js\";\nimport type { Diagnostic, Dialect, ProcessOptions } from \"../core/types.js\";\n\ninterface Flags {\n  config?: string;\n  root?: string;\n  dialect?: Dialect;\n  json?: boolean;\n  check?: boolean;\n  diff?: boolean;\n  write?: boolean;\n  stdinFilepath?: string;\n  maxWarnings?: number;\n}\nconst manifest = JSON.parse(\n  await readFile(fileURLToPath(new URL(\"../../package.json\", import.meta.url)), \"utf8\"),\n) as { version: string };\nconst program = new Command()\n  .name(\"mdtools\")\n  .description(\"Lint and format Markdown with explicit dialects and configurable rules.\")\n  .version(manifest.version);\nfunction common(command: Command): Command {\n  return command\n    .option(\"--config <file>\", \"Explicit JSON, JSONC, or .mjs configuration\")\n    .option(\"--root <directory>\", \"Workspace root (default: configuration directory or cwd)\")\n    .option(\"--dialect <dialect>\", \"commonmark, github, or obsidian\")\n    .option(\"--json\", \"Machine-readable output\")\n    .option(\"--stdin-filepath <file>\", \"Filename context for stdin\")\n    .option(\n      \"--max-warnings <count>\",\n      \"Fail when warning count exceeds this nonnegative integer\",\n      (value: string) => {\n        const number = Number(value);\n        if (!Number.isInteger(number) || number < 0)\n          throw new Error(\"--max-warnings must be a nonnegative integer.\");\n        return number;\n      },\n    );\n}\ninterface Report {\n  path: string;\n  changed?: boolean;\n  diagnostics: Diagnostic[];\n  output?: string;\n}\nasync function run(mode: \"lint\" | \"format\", inputs: string[], flags: Flags) {\n  if ([flags.check, flags.diff, flags.write].filter(Boolean).length > 1)\n    throw new Error(\"Choose only one of --check, --diff, and --write.\");\n  const loaded = await loadConfig(path.resolve(flags.root ?? \".\"), flags.config);\n  const root = path.resolve(flags.root ?? loaded.root);\n  if (flags.dialect) loaded.config.dialect = flags.dialect;\n  const resolved = resolveConfig(loaded.config, \"document.md\", loaded.plugins);\n  const stdin = inputs.includes(\"-\");\n  if (stdin && (inputs.length !== 1 || flags.write))\n    throw new Error(\"stdin must be the only input and cannot be combined with --write.\");\n  const set = await discover(root, stdin ? [] : inputs, resolved.ignore);\n  if (stdin) {\n    const name = path\n      .relative(root, path.resolve(flags.stdinFilepath ?? path.join(root, \"stdin.md\")))\n      .split(path.sep)\n      .join(\"/\");\n    if (name.startsWith(\"../\") || path.isAbsolute(name))\n      throw new Error(\"--stdin-filepath must be within the workspace.\");\n    let source = \"\";\n    process.stdin.setEncoding(\"utf8\");\n    for await (const chunk of process.stdin) source += String(chunk);\n    set.files[name] = source;\n    set.selected = [name];\n  }\n  const reports: Report[] = [];\n  const changes: { file: string; before: string; after: string }[] = [];\n  // One index per active dialect; build lazily for mixed documentation workspaces.\n  const indexes = new Map<Dialect, ReturnType<typeof createWorkspace>>();\n  for (const name of set.selected) {\n    const config = resolveConfig(loaded.config, name, loaded.plugins);\n    if (!indexes.has(config.dialect))\n      indexes.set(\n        config.dialect,\n        createWorkspace(set.files, {\n          dialect: config.dialect,\n          ...(set.strictLineBreaks !== undefined ? { strictLineBreaks: set.strictLineBreaks } : {}),\n        }),\n      );\n    const options: ProcessOptions = {\n      path: name,\n      config: loaded.config,\n      plugins: loaded.plugins,\n      workspace: indexes.get(config.dialect)!,\n    };\n    const source = set.files[name]!;\n    if (source === null) continue;\n    if (mode === \"lint\") reports.push({ path: name, diagnostics: lint(source, options) });\n    else {\n      const result = format(source, options);\n      reports.push({\n        path: name,\n        changed: result.changed,\n        diagnostics: result.diagnostics,\n        ...(stdin && !flags.check ? { output: result.output } : {}),\n      });\n      if (result.changed) changes.push({ file: name, before: source, after: result.output });\n    }\n  }\n  const unsafe = reports.some((report) =>\n    report.diagnostics.some((item) => item.rule === \"engine/unsafe-format\"),\n  );\n  if (flags.write && !unsafe)\n    for (const change of changes)\n      await writeAtomic(path.join(set.root, change.file), change.before, change.after);\n  if (flags.json)\n    process.stdout.write(\n      JSON.stringify(\n        {\n          version: manifest.version,\n          mode,\n          files: reports,\n          written: flags.write === true && !unsafe,\n        },\n        null,\n        2,\n      ) + \"\\n\",\n    );\n  else {\n    if (stdin && mode === \"format\" && !flags.check && !flags.diff)\n      process.stdout.write(reports[0]?.output ?? \"\");\n    else if (mode === \"format\" && !flags.check && !flags.write)\n      for (const change of changes)\n        process.stdout.write(\n          createTwoFilesPatch(`a/${change.file}`, `b/${change.file}`, change.before, change.after),\n        );\n    for (const report of reports)\n      for (const item of report.diagnostics)\n        process.stderr.write(\n          `${report.path}:${item.line}:${item.column}: ${item.severity} ${item.rule}: ${item.message}\\n`,\n        );\n    if (!stdin)\n      process.stderr.write(\n        `${set.selected.length} file(s) ${mode === \"lint\" ? \"linted\" : \"processed\"}; ${changes.length} ${flags.write && !unsafe ? \"written\" : \"would change\"}.\\n`,\n      );\n  }\n  const diagnostics = reports.flatMap((report) => report.diagnostics);\n  const errors = diagnostics.some((item) => item.severity === \"error\");\n  const tooManyWarnings =\n    flags.maxWarnings !== undefined &&\n    diagnostics.filter((item) => item.severity === \"warn\").length > flags.maxWarnings;\n  process.exitCode = unsafe\n    ? 2\n    : errors || tooManyWarnings || (flags.check && changes.length > 0)\n      ? 1\n      : 0;\n}\ncommon(\n  program.command(\"lint\").argument(\"[paths...]\", \"Markdown files/directories, or - for stdin\"),\n).action((inputs: string[], flags: Flags) => run(\"lint\", inputs, flags));\ncommon(\n  program.command(\"format\").argument(\"[paths...]\", \"Markdown files/directories, or - for stdin\"),\n)\n  .option(\"--check\", \"Fail if formatting changes would be needed\")\n  .option(\"--diff\", \"Preview the complete diff (default for file inputs)\")\n  .option(\"--write\", \"Write validated formatting changes\")\n  .action((inputs: string[], flags: Flags) => run(\"format\", inputs, flags));\ncommon(program.command(\"config\").description(\"Inspect effective configuration\"))\n  .command(\"explain <file>\")\n  .action(async (file: string, _flags: unknown, command: Command) => {\n    const flags = command.parent!.opts<Flags>();\n    const loaded = await loadConfig(path.resolve(flags.root ?? \".\"), flags.config);\n    if (flags.dialect) loaded.config.dialect = flags.dialect;\n    const root = path.resolve(flags.root ?? loaded.root);\n    process.stdout.write(\n      JSON.stringify(\n        {\n          root,\n          file: loaded.file ?? null,\n          effective: resolveConfig(\n            loaded.config,\n            path.relative(root, path.resolve(file)).split(path.sep).join(\"/\"),\n            loaded.plugins,\n          ),\n        },\n        null,\n        2,\n      ) + \"\\n\",\n    );\n  });\nprogram\n  .command(\"rules\")\n  .description(\"List built-in rules\")\n  .action(() => {\n    for (const [name, rule] of Object.entries(ruleRegistry()))\n      process.stdout.write(`${name}\\t${rule.kind}\\t${rule.description}\\n`);\n  });\ntry {\n  await program.parseAsync();\n} catch (error) {\n  process.stderr.write(`mdtools: ${error instanceof Error ? error.message : String(error)}\\n`);\n  process.exitCode = 2;\n}\n"]}

package/dist/config/load.d.ts

@@ -0,0 +1,9 @@
+import type { Config, Plugin } from "../core/types.js";
+export interface LoadedConfig {
+    config: Config;
+    plugins: Plugin[];
+    root: string;
+    file?: string;
+}
+export declare function exists(file: string): Promise<boolean>;
+export declare function loadConfig(start: string, explicit?: string): Promise<LoadedConfig>;

package/dist/config/load.js

@@ -0,0 +1,75 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { createRequire } from "node:module";
+import { parse, printParseErrorCode } from "jsonc-parser";
+import { validateConfig } from "./resolve.js";
+export async function exists(file) {
+    try {
+        await stat(file);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+export async function loadConfig(start, explicit) {
+    let file = explicit ? path.resolve(explicit) : undefined;
+    let fallbackRoot = path.resolve(start);
+    if (!file) {
+        let directory = path.resolve(start);
+        for (;;) {
+            const found = [];
+            for (const name of ["mdtools.config.jsonc", "mdtools.config.json", "mdtools.config.mjs"])
+                if (await exists(path.join(directory, name)))
+                    found.push(path.join(directory, name));
+            if (found.length > 1)
+                throw new Error(`Multiple mdtools configuration files in ${directory}. Use --config.`);
+            if (found.length) {
+                file = found[0];
+                break;
+            }
+            if ((await exists(path.join(directory, ".git"))) ||
+                (await exists(path.join(directory, ".obsidian")))) {
+                fallbackRoot = directory;
+                break;
+            }
+            if (path.dirname(directory) === directory)
+                break;
+            directory = path.dirname(directory);
+        }
+    }
+    let value = {};
+    if (file?.endsWith(".mjs"))
+        value = (await import(pathToFileURL(file).href)).default;
+    else if (file) {
+        const errors = [];
+        value = parse(await readFile(file, "utf8"), errors, {
+            allowTrailingComma: true,
+            disallowComments: file.endsWith(".json"),
+        });
+        if (errors.length)
+            throw new Error(`Invalid JSON configuration: ${errors.map((error) => `${printParseErrorCode(error.error)} at offset ${error.offset}`).join(", ")}`);
+    }
+    validateConfig(value);
+    const root = file ? path.dirname(file) : fallbackRoot;
+    const plugins = [];
+    const require = createRequire(path.join(root, "mdtools.config.mjs"));
+    for (const specifier of value.plugins ?? []) {
+        const location = specifier.startsWith(".") || path.isAbsolute(specifier)
+            ? path.resolve(root, specifier)
+            : require.resolve(specifier);
+        const plugin = (await import(pathToFileURL(location).href))
+            .default;
+        if (!plugin ||
+            typeof plugin !== "object" ||
+            !("name" in plugin) ||
+            typeof plugin.name !== "string")
+            throw new Error(`Invalid plugin export: ${specifier}`);
+        plugins.push(plugin);
+    }
+    return { config: value, plugins, root, ...(file ? { file } : {}) };
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { createRequire } from \"node:module\";\nimport { parse, printParseErrorCode } from \"jsonc-parser\";\nimport type { ParseError } from \"jsonc-parser\";\nimport type { Config, Plugin } from \"../core/types.js\";\nimport { validateConfig } from \"./resolve.js\";\n\nexport interface LoadedConfig {\n  config: Config;\n  plugins: Plugin[];\n  root: string;\n  file?: string;\n}\nexport async function exists(file: string): Promise<boolean> {\n  try {\n    await stat(file);\n    return true;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return false;\n    throw error;\n  }\n}\nexport async function loadConfig(start: string, explicit?: string): Promise<LoadedConfig> {\n  let file = explicit ? path.resolve(explicit) : undefined;\n  let fallbackRoot = path.resolve(start);\n  if (!file) {\n    let directory = path.resolve(start);\n    for (;;) {\n      const found: string[] = [];\n      for (const name of [\"mdtools.config.jsonc\", \"mdtools.config.json\", \"mdtools.config.mjs\"])\n        if (await exists(path.join(directory, name))) found.push(path.join(directory, name));\n      if (found.length > 1)\n        throw new Error(`Multiple mdtools configuration files in ${directory}. Use --config.`);\n      if (found.length) {\n        file = found[0];\n        break;\n      }\n      if (\n        (await exists(path.join(directory, \".git\"))) ||\n        (await exists(path.join(directory, \".obsidian\")))\n      ) {\n        fallbackRoot = directory;\n        break;\n      }\n      if (path.dirname(directory) === directory) break;\n      directory = path.dirname(directory);\n    }\n  }\n  let value: unknown = {};\n  if (file?.endsWith(\".mjs\"))\n    value = ((await import(pathToFileURL(file).href)) as { default: unknown }).default;\n  else if (file) {\n    const errors: ParseError[] = [];\n    value = parse(await readFile(file, \"utf8\"), errors, {\n      allowTrailingComma: true,\n      disallowComments: file.endsWith(\".json\"),\n    });\n    if (errors.length)\n      throw new Error(\n        `Invalid JSON configuration: ${errors.map((error) => `${printParseErrorCode(error.error)} at offset ${error.offset}`).join(\", \")}`,\n      );\n  }\n  validateConfig(value);\n  const root = file ? path.dirname(file) : fallbackRoot;\n  const plugins: Plugin[] = [];\n  const require = createRequire(path.join(root, \"mdtools.config.mjs\"));\n  for (const specifier of value.plugins ?? []) {\n    const location =\n      specifier.startsWith(\".\") || path.isAbsolute(specifier)\n        ? path.resolve(root, specifier)\n        : require.resolve(specifier);\n    const plugin: unknown = ((await import(pathToFileURL(location).href)) as { default: unknown })\n      .default;\n    if (\n      !plugin ||\n      typeof plugin !== \"object\" ||\n      !(\"name\" in plugin) ||\n      typeof plugin.name !== \"string\"\n    )\n      throw new Error(`Invalid plugin export: ${specifier}`);\n    plugins.push(plugin as Plugin);\n  }\n  return { config: value, plugins, root, ...(file ? { file } : {}) };\n}\n"]}

package/dist/config/resolve.d.ts

@@ -0,0 +1,93 @@
+import type { Config, Plugin, ResolvedConfig, RuleSetting } from "../core/types.js";
+export declare const presets: Record<string, Config>;
+export declare const configSchema: {
+    $schema: string;
+    type: string;
+    additionalProperties: boolean;
+    properties: {
+        $schema: {
+            type: string;
+        };
+        extends: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+        dialect: {
+            enum: string[];
+        };
+        rules: {
+            type: string;
+            additionalProperties: {
+                anyOf: ({
+                    enum: string[];
+                } | {
+                    type: string;
+                    items: ({
+                        enum: string[];
+                    } | {
+                        type: string;
+                    })[];
+                    minItems: number;
+                    maxItems: number;
+                })[];
+            };
+        };
+        ignore: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+        plugins: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+        overrides: {
+            type: string;
+            items: {
+                type: string;
+                required: string[];
+                additionalProperties: boolean;
+                properties: {
+                    files: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        minItems: number;
+                    };
+                    dialect: {
+                        enum: string[];
+                    };
+                    rules: {
+                        type: string;
+                        additionalProperties: {
+                            anyOf: ({
+                                enum: string[];
+                            } | {
+                                type: string;
+                                items: ({
+                                    enum: string[];
+                                } | {
+                                    type: string;
+                                })[];
+                                minItems: number;
+                                maxItems: number;
+                            })[];
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+export declare function validateConfig(value: unknown): asserts value is Config;
+export declare function setting(value: RuleSetting): {
+    severity: "off" | "warn" | "error";
+    options: Record<string, unknown>;
+};
+export declare function resolveConfig(config?: Config, path?: string, plugins?: Plugin[]): ResolvedConfig;