meodp 0.1.0 → 0.2.1

package/dist/check/index.d.cts

@@ -1,74 +1,11 @@
-interface LinkTarget {
-    url: string;
-    name?: string;
-}
-type Availability = 'reachable' | 'restricted' | 'unavailable';
-type FailureReason = 'http' | 'dns' | 'tls' | 'timeout' | 'network' | 'redirect';
-interface LinkObservation extends LinkTarget {
-    status: Availability;
-    checkedAt: string;
-    durationMs: number;
-    attempts: number;
-    finalUrl: string;
-    httpStatus?: number;
-    redirects: {
-        url: string;
-        status: number;
-        location: string;
-    }[];
-    reason?: FailureReason;
-    detail?: string;
-    consecutiveFailures: number;
-    firstFailureAt?: string;
-    lastSuccessAt?: string;
-    changed: boolean;
-    recovered: boolean;
-}
-interface CheckReport {
-    schemaVersion: 1;
-    observer: string;
-    startedAt: string;
-    completedAt: string;
-    summary: Record<Availability, number> & {
-        total: number;
-        redirected: number;
-        recovered: number;
-    };
-    results: LinkObservation[];
-}
-interface CheckOptions {
-    /** Maximum simultaneous site checks. Default: 5. */
-    concurrency?: number;
-    /** Timeout for each HTTP request, including its body. Default: 10000 ms. */
-    timeoutMs?: number;
-    /** Retries for transport errors and 5xx responses. Default: 1; 429 is not retried. */
-    retries?: number;
-    /** Maximum followed redirects per attempt. Default: 5. */
-    maxRedirects?: number;
-    /** Identifies the network/environment. Must match previousReport.observer. */
-    observer?: string;
-    previousReport?: CheckReport;
-    onResult?: (result: LinkObservation) => void | Promise<void>;
-}
-interface SitemapOptions extends CheckOptions {
-    /** Treat the input as a site URL: read robots.txt, falling back to /sitemap.xml. */
-    discover?: boolean;
-    /** Reject before page checks if discovery exceeds this many unique pages. Default: 10000. */
-    maxUrls?: number;
-    /** Maximum number of unique sitemap documents to read. Default: 100. */
-    maxSitemaps?: number;
-    /** Maximum downloaded and decompressed size per discovery document. Default: 10 MiB. */
-    maxSitemapBytes?: number;
-}
+import { L as LinkTarget, a as CheckOptions, C as CheckReport, S as SitemapOptions, A as Availability, b as LinkObservation } from '../shared/meodp.93e06e00.cjs';
+export { F as FailureReason } from '../shared/meodp.93e06e00.cjs';
+import { b as ReportSiteOptions } from '../shared/meodp.4f1da070.cjs';
+export { H as HtmlReporterOptions, a as ReportVerificationOptions, R as ReporterConfig, c as ReporterDescription, d as ReporterName, e as ReporterOptions, f as ReporterOutput, g as waitForReport, w as writeReporters } from '../shared/meodp.4f1da070.cjs';
 
 /** Check only the supplied URLs. HTTP failures become observations; invalid input rejects. */
 declare function checkLinks(input: readonly (string | LinkTarget)[], options?: CheckOptions): Promise<CheckReport>;
 
-interface ReportSiteOptions {
-    /** Automatically load this HTTP(S) or relative JSON URL when hosted. */
-    dataUrl?: string;
-}
-
 declare function formatReport(report: CheckReport, format?: 'json' | 'markdown' | 'html'): string;
 declare function writeReports(report: CheckReport, directory: string): Promise<{
     json: string;
@@ -104,4 +41,4 @@ declare function checkSitemap(source: string, options?: SitemapOptions): Promise
     results: LinkObservation[];
 }>;
 
-export { type Availability, type CheckOptions, type CheckReport, type FailureReason, type LinkObservation, type LinkTarget, type ReportSiteOptions, type SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };
+export { Availability, CheckOptions, CheckReport, LinkObservation, LinkTarget, ReportSiteOptions, SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };

package/dist/check/index.d.mts

@@ -1,74 +1,11 @@
-interface LinkTarget {
-    url: string;
-    name?: string;
-}
-type Availability = 'reachable' | 'restricted' | 'unavailable';
-type FailureReason = 'http' | 'dns' | 'tls' | 'timeout' | 'network' | 'redirect';
-interface LinkObservation extends LinkTarget {
-    status: Availability;
-    checkedAt: string;
-    durationMs: number;
-    attempts: number;
-    finalUrl: string;
-    httpStatus?: number;
-    redirects: {
-        url: string;
-        status: number;
-        location: string;
-    }[];
-    reason?: FailureReason;
-    detail?: string;
-    consecutiveFailures: number;
-    firstFailureAt?: string;
-    lastSuccessAt?: string;
-    changed: boolean;
-    recovered: boolean;
-}
-interface CheckReport {
-    schemaVersion: 1;
-    observer: string;
-    startedAt: string;
-    completedAt: string;
-    summary: Record<Availability, number> & {
-        total: number;
-        redirected: number;
-        recovered: number;
-    };
-    results: LinkObservation[];
-}
-interface CheckOptions {
-    /** Maximum simultaneous site checks. Default: 5. */
-    concurrency?: number;
-    /** Timeout for each HTTP request, including its body. Default: 10000 ms. */
-    timeoutMs?: number;
-    /** Retries for transport errors and 5xx responses. Default: 1; 429 is not retried. */
-    retries?: number;
-    /** Maximum followed redirects per attempt. Default: 5. */
-    maxRedirects?: number;
-    /** Identifies the network/environment. Must match previousReport.observer. */
-    observer?: string;
-    previousReport?: CheckReport;
-    onResult?: (result: LinkObservation) => void | Promise<void>;
-}
-interface SitemapOptions extends CheckOptions {
-    /** Treat the input as a site URL: read robots.txt, falling back to /sitemap.xml. */
-    discover?: boolean;
-    /** Reject before page checks if discovery exceeds this many unique pages. Default: 10000. */
-    maxUrls?: number;
-    /** Maximum number of unique sitemap documents to read. Default: 100. */
-    maxSitemaps?: number;
-    /** Maximum downloaded and decompressed size per discovery document. Default: 10 MiB. */
-    maxSitemapBytes?: number;
-}
+import { L as LinkTarget, a as CheckOptions, C as CheckReport, S as SitemapOptions, A as Availability, b as LinkObservation } from '../shared/meodp.93e06e00.mjs';
+export { F as FailureReason } from '../shared/meodp.93e06e00.mjs';
+import { b as ReportSiteOptions } from '../shared/meodp.a704f8db.mjs';
+export { H as HtmlReporterOptions, a as ReportVerificationOptions, R as ReporterConfig, c as ReporterDescription, d as ReporterName, e as ReporterOptions, f as ReporterOutput, g as waitForReport, w as writeReporters } from '../shared/meodp.a704f8db.mjs';
 
 /** Check only the supplied URLs. HTTP failures become observations; invalid input rejects. */
 declare function checkLinks(input: readonly (string | LinkTarget)[], options?: CheckOptions): Promise<CheckReport>;
 
-interface ReportSiteOptions {
-    /** Automatically load this HTTP(S) or relative JSON URL when hosted. */
-    dataUrl?: string;
-}
-
 declare function formatReport(report: CheckReport, format?: 'json' | 'markdown' | 'html'): string;
 declare function writeReports(report: CheckReport, directory: string): Promise<{
     json: string;
@@ -104,4 +41,4 @@ declare function checkSitemap(source: string, options?: SitemapOptions): Promise
     results: LinkObservation[];
 }>;
 
-export { type Availability, type CheckOptions, type CheckReport, type FailureReason, type LinkObservation, type LinkTarget, type ReportSiteOptions, type SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };
+export { Availability, CheckOptions, CheckReport, LinkObservation, LinkTarget, ReportSiteOptions, SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };

package/dist/check/index.d.ts

@@ -1,74 +1,11 @@
-interface LinkTarget {
-    url: string;
-    name?: string;
-}
-type Availability = 'reachable' | 'restricted' | 'unavailable';
-type FailureReason = 'http' | 'dns' | 'tls' | 'timeout' | 'network' | 'redirect';
-interface LinkObservation extends LinkTarget {
-    status: Availability;
-    checkedAt: string;
-    durationMs: number;
-    attempts: number;
-    finalUrl: string;
-    httpStatus?: number;
-    redirects: {
-        url: string;
-        status: number;
-        location: string;
-    }[];
-    reason?: FailureReason;
-    detail?: string;
-    consecutiveFailures: number;
-    firstFailureAt?: string;
-    lastSuccessAt?: string;
-    changed: boolean;
-    recovered: boolean;
-}
-interface CheckReport {
-    schemaVersion: 1;
-    observer: string;
-    startedAt: string;
-    completedAt: string;
-    summary: Record<Availability, number> & {
-        total: number;
-        redirected: number;
-        recovered: number;
-    };
-    results: LinkObservation[];
-}
-interface CheckOptions {
-    /** Maximum simultaneous site checks. Default: 5. */
-    concurrency?: number;
-    /** Timeout for each HTTP request, including its body. Default: 10000 ms. */
-    timeoutMs?: number;
-    /** Retries for transport errors and 5xx responses. Default: 1; 429 is not retried. */
-    retries?: number;
-    /** Maximum followed redirects per attempt. Default: 5. */
-    maxRedirects?: number;
-    /** Identifies the network/environment. Must match previousReport.observer. */
-    observer?: string;
-    previousReport?: CheckReport;
-    onResult?: (result: LinkObservation) => void | Promise<void>;
-}
-interface SitemapOptions extends CheckOptions {
-    /** Treat the input as a site URL: read robots.txt, falling back to /sitemap.xml. */
-    discover?: boolean;
-    /** Reject before page checks if discovery exceeds this many unique pages. Default: 10000. */
-    maxUrls?: number;
-    /** Maximum number of unique sitemap documents to read. Default: 100. */
-    maxSitemaps?: number;
-    /** Maximum downloaded and decompressed size per discovery document. Default: 10 MiB. */
-    maxSitemapBytes?: number;
-}
+import { L as LinkTarget, a as CheckOptions, C as CheckReport, S as SitemapOptions, A as Availability, b as LinkObservation } from '../shared/meodp.93e06e00.js';
+export { F as FailureReason } from '../shared/meodp.93e06e00.js';
+import { b as ReportSiteOptions } from '../shared/meodp.8369c4c1.js';
+export { H as HtmlReporterOptions, a as ReportVerificationOptions, R as ReporterConfig, c as ReporterDescription, d as ReporterName, e as ReporterOptions, f as ReporterOutput, g as waitForReport, w as writeReporters } from '../shared/meodp.8369c4c1.js';
 
 /** Check only the supplied URLs. HTTP failures become observations; invalid input rejects. */
 declare function checkLinks(input: readonly (string | LinkTarget)[], options?: CheckOptions): Promise<CheckReport>;
 
-interface ReportSiteOptions {
-    /** Automatically load this HTTP(S) or relative JSON URL when hosted. */
-    dataUrl?: string;
-}
-
 declare function formatReport(report: CheckReport, format?: 'json' | 'markdown' | 'html'): string;
 declare function writeReports(report: CheckReport, directory: string): Promise<{
     json: string;
@@ -104,4 +41,4 @@ declare function checkSitemap(source: string, options?: SitemapOptions): Promise
     results: LinkObservation[];
 }>;
 
-export { type Availability, type CheckOptions, type CheckReport, type FailureReason, type LinkObservation, type LinkTarget, type ReportSiteOptions, type SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };
+export { Availability, CheckOptions, CheckReport, LinkObservation, LinkTarget, ReportSiteOptions, SitemapOptions, checkLinks, checkSitemap, formatReport, parseReport, readReport, readSitemapUrls, saveReport, writeReportSite, writeReports };

package/dist/check/index.mjs

@@ -1,11 +1,13 @@
-export { a as checkLinks, c as checkSitemap, f as formatReport, p as parseReport, r as readReport, d as readSitemapUrls, s as saveReport, b as writeReportSite, w as writeReports } from '../shared/meodp.d0916bc5.mjs';
+export { a as checkLinks, c as checkSitemap, r as readSitemapUrls, b as waitForReport, w as writeReporters } from '../shared/meodp.80ff918d.mjs';
+export { f as formatReport, p as parseReport, r as readReport, s as saveReport, a as writeReportSite, w as writeReports } from '../shared/meodp.9c706389.mjs';
 import 'node:timers/promises';
 import 'linkinator';
 import 'node:os';
-import 'node:crypto';
 import 'node:fs/promises';
 import 'node:path';
+import 'node:process';
 import 'node:buffer';
 import 'node:util';
 import 'node:zlib';
 import 'fast-xml-parser';
+import 'node:crypto';

package/dist/cli/main.cjs

@@ -8,7 +8,7 @@ const process__default = /*#__PURE__*/_interopDefaultCompat(process);
 
 const name = "meodp";
 const type = "module";
-const version = "0.1.0";
+const version = "0.2.1";
 const description = "Check website and friend-link availability with sitemap discovery, history, and portable reports.";
 const author = {
 	name: "YunYouJun",
@@ -47,6 +47,46 @@ const exports$1 = {
 			types: "./dist/check/index.d.cts",
 			"default": "./dist/check/index.cjs"
 		}
+	},
+	"./config": {
+		"import": {
+			types: "./dist/config/index.d.mts",
+			"default": "./dist/config/index.mjs"
+		},
+		require: {
+			types: "./dist/config/index.d.cts",
+			"default": "./dist/config/index.cjs"
+		}
+	},
+	"./notify": {
+		"import": {
+			types: "./dist/notify/index.d.mts",
+			"default": "./dist/notify/index.mjs"
+		},
+		require: {
+			types: "./dist/notify/index.d.cts",
+			"default": "./dist/notify/index.cjs"
+		}
+	},
+	"./notify/feishu": {
+		"import": {
+			types: "./dist/notify/feishu.d.mts",
+			"default": "./dist/notify/feishu.mjs"
+		},
+		require: {
+			types: "./dist/notify/feishu.d.cts",
+			"default": "./dist/notify/feishu.cjs"
+		}
+	},
+	"./notify/email": {
+		"import": {
+			types: "./dist/notify/email.d.mts",
+			"default": "./dist/notify/email.mjs"
+		},
+		require: {
+			types: "./dist/notify/email.d.cts",
+			"default": "./dist/notify/email.cjs"
+		}
 	}
 };
 const main = "./dist/index.mjs";
@@ -65,17 +105,22 @@ const engines = {
 const scripts = {
 	build: "tsx scripts/build-report-viewer.ts && unbuild",
 	dev: "tsx scripts/build-report-viewer.ts && unbuild --stub",
-	test: "tsx scripts/build-report-viewer.ts && tsx --test test/check.test.ts test/sitemap.test.ts",
+	test: "tsx scripts/build-report-viewer.ts && tsx --test test/*.test.ts",
 	"test:e2e": "tsx scripts/build-report-viewer.ts && playwright test",
 	typecheck: "tsx scripts/build-report-viewer.ts && tsc --noEmit -p tsconfig.json",
 	prepack: "npm run build",
+	"verify:package": "pnpm build && tsx scripts/verify-package.ts",
 	release: "npm version --no-git-tag-version"
 };
 const peerDependencies = {
+	nodemailer: "^10.0.3",
 	playwright: "^1",
 	typescript: "^5.0.0"
 };
 const peerDependenciesMeta = {
+	nodemailer: {
+		optional: true
+	},
 	playwright: {
 		optional: true
 	},
@@ -84,7 +129,7 @@ const peerDependenciesMeta = {
 	}
 };
 const dependencies = {
-	c12: "^2.0.1",
+	c12: "^3.3.4",
 	"cli-progress": "^3.12.0",
 	consola: "^3.2.3",
 	"date-fns": "^4.1.0",
@@ -106,9 +151,11 @@ const devDependencies = {
 	"@types/fs-extra": "^11.0.4",
 	"@types/js-yaml": "^4.0.9",
 	"@types/node": "^22.9.0",
+	"@types/nodemailer": "^8.0.1",
 	"@types/yargs": "^17.0.33",
 	cilicili: "^0.1.1",
 	esbuild: "^0.28.2",
+	nodemailer: "^10.0.3",
 	playwright: "^1.48.2",
 	tsx: "^4.19.2",
 	unbuild: "^2.0.0",
@@ -149,7 +196,8 @@ const help = `Usage: meodp <command> [options]
 Commands:
   check <links.json|links.yml>  Request listed HTTP(S) URLs and write fresh reports
   sitemap <sitemap-url>        Check pages listed in an XML sitemap or nested index
-  report [report.json]         Export a static viewer from saved data; no site checks
+  report [report.json]         Render saved data using JSON, Markdown or HTML reporters
+  notify                      Send configured report notifications; supports --dry-run
   scan [root]                 Run the legacy browser scanner using meodp.config.ts
   export [root]               Export a legacy browser-scan report
 
@@ -161,6 +209,7 @@ Examples:
   meodp check links.yml --output reports/links
   meodp sitemap https://example.com/sitemap.xml --output reports/pages
   meodp report reports/links/report.json --output reports/site
+  meodp report reports/links/report.json --reporter json,markdown,html
   meodp check --help
   meodp help report
 
@@ -185,10 +234,14 @@ async function runCli(args = process__default.argv.slice(2)) {
     if (command === "help") {
       if (!rest.length)
         return runCli(["--help"]);
-      if (rest.length !== 1 || !["check", "sitemap", "report", "scan", "export"].includes(rest[0]))
-        throw new Error("Use meodp help <check|sitemap|report|scan|export>");
+      if (rest.length !== 1 || !["check", "sitemap", "report", "notify", "scan", "export"].includes(rest[0]))
+        throw new Error("Use meodp help <check|sitemap|report|notify|scan|export>");
       return runCli([rest[0], "--help"]);
     }
+    if (command === "notify") {
+      const { runNotifyCli } = await import('../notify/cli.cjs');
+      return runNotifyCli(rest);
+    }
     if (command === "check") {
       const { runCheckCli } = await import('../check/cli.cjs');
       return runCheckCli(rest);

package/dist/cli/main.mjs

@@ -2,7 +2,7 @@ import process from 'node:process';
 
 const name = "meodp";
 const type = "module";
-const version = "0.1.0";
+const version = "0.2.1";
 const description = "Check website and friend-link availability with sitemap discovery, history, and portable reports.";
 const author = {
 	name: "YunYouJun",
@@ -41,6 +41,46 @@ const exports = {
 			types: "./dist/check/index.d.cts",
 			"default": "./dist/check/index.cjs"
 		}
+	},
+	"./config": {
+		"import": {
+			types: "./dist/config/index.d.mts",
+			"default": "./dist/config/index.mjs"
+		},
+		require: {
+			types: "./dist/config/index.d.cts",
+			"default": "./dist/config/index.cjs"
+		}
+	},
+	"./notify": {
+		"import": {
+			types: "./dist/notify/index.d.mts",
+			"default": "./dist/notify/index.mjs"
+		},
+		require: {
+			types: "./dist/notify/index.d.cts",
+			"default": "./dist/notify/index.cjs"
+		}
+	},
+	"./notify/feishu": {
+		"import": {
+			types: "./dist/notify/feishu.d.mts",
+			"default": "./dist/notify/feishu.mjs"
+		},
+		require: {
+			types: "./dist/notify/feishu.d.cts",
+			"default": "./dist/notify/feishu.cjs"
+		}
+	},
+	"./notify/email": {
+		"import": {
+			types: "./dist/notify/email.d.mts",
+			"default": "./dist/notify/email.mjs"
+		},
+		require: {
+			types: "./dist/notify/email.d.cts",
+			"default": "./dist/notify/email.cjs"
+		}
 	}
 };
 const main = "./dist/index.mjs";
@@ -59,17 +99,22 @@ const engines = {
 const scripts = {
 	build: "tsx scripts/build-report-viewer.ts && unbuild",
 	dev: "tsx scripts/build-report-viewer.ts && unbuild --stub",
-	test: "tsx scripts/build-report-viewer.ts && tsx --test test/check.test.ts test/sitemap.test.ts",
+	test: "tsx scripts/build-report-viewer.ts && tsx --test test/*.test.ts",
 	"test:e2e": "tsx scripts/build-report-viewer.ts && playwright test",
 	typecheck: "tsx scripts/build-report-viewer.ts && tsc --noEmit -p tsconfig.json",
 	prepack: "npm run build",
+	"verify:package": "pnpm build && tsx scripts/verify-package.ts",
 	release: "npm version --no-git-tag-version"
 };
 const peerDependencies = {
+	nodemailer: "^10.0.3",
 	playwright: "^1",
 	typescript: "^5.0.0"
 };
 const peerDependenciesMeta = {
+	nodemailer: {
+		optional: true
+	},
 	playwright: {
 		optional: true
 	},
@@ -78,7 +123,7 @@ const peerDependenciesMeta = {
 	}
 };
 const dependencies = {
-	c12: "^2.0.1",
+	c12: "^3.3.4",
 	"cli-progress": "^3.12.0",
 	consola: "^3.2.3",
 	"date-fns": "^4.1.0",
@@ -100,9 +145,11 @@ const devDependencies = {
 	"@types/fs-extra": "^11.0.4",
 	"@types/js-yaml": "^4.0.9",
 	"@types/node": "^22.9.0",
+	"@types/nodemailer": "^8.0.1",
 	"@types/yargs": "^17.0.33",
 	cilicili: "^0.1.1",
 	esbuild: "^0.28.2",
+	nodemailer: "^10.0.3",
 	playwright: "^1.48.2",
 	tsx: "^4.19.2",
 	unbuild: "^2.0.0",
@@ -143,7 +190,8 @@ const help = `Usage: meodp <command> [options]
 Commands:
   check <links.json|links.yml>  Request listed HTTP(S) URLs and write fresh reports
   sitemap <sitemap-url>        Check pages listed in an XML sitemap or nested index
-  report [report.json]         Export a static viewer from saved data; no site checks
+  report [report.json]         Render saved data using JSON, Markdown or HTML reporters
+  notify                      Send configured report notifications; supports --dry-run
   scan [root]                 Run the legacy browser scanner using meodp.config.ts
   export [root]               Export a legacy browser-scan report
 
@@ -155,6 +203,7 @@ Examples:
   meodp check links.yml --output reports/links
   meodp sitemap https://example.com/sitemap.xml --output reports/pages
   meodp report reports/links/report.json --output reports/site
+  meodp report reports/links/report.json --reporter json,markdown,html
   meodp check --help
   meodp help report
 
@@ -179,10 +228,14 @@ async function runCli(args = process.argv.slice(2)) {
     if (command === "help") {
       if (!rest.length)
         return runCli(["--help"]);
-      if (rest.length !== 1 || !["check", "sitemap", "report", "scan", "export"].includes(rest[0]))
-        throw new Error("Use meodp help <check|sitemap|report|scan|export>");
+      if (rest.length !== 1 || !["check", "sitemap", "report", "notify", "scan", "export"].includes(rest[0]))
+        throw new Error("Use meodp help <check|sitemap|report|notify|scan|export>");
       return runCli([rest[0], "--help"]);
     }
+    if (command === "notify") {
+      const { runNotifyCli } = await import('../notify/cli.mjs');
+      return runNotifyCli(rest);
+    }
     if (command === "check") {
       const { runCheckCli } = await import('../check/cli.mjs');
       return runCheckCli(rest);

package/dist/config/index.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function defineConfig(config) {
+  return config;
+}
+
+exports.defineConfig = defineConfig;

package/dist/config/index.d.cts

@@ -0,0 +1,47 @@
+import { R as ReporterConfig, a as ReportVerificationOptions } from '../shared/meodp.4f1da070.cjs';
+import { S as SitemapOptions } from '../shared/meodp.93e06e00.cjs';
+import { EmailOptions } from '../notify/email.cjs';
+import { FeishuOptions } from '../notify/feishu.cjs';
+import { NotificationOptions } from '../notify/index.cjs';
+
+interface ScanConfig extends Omit<SitemapOptions, 'previousReport' | 'onResult'> {
+    input?: string;
+    reporter?: ReporterConfig;
+    output?: string;
+    history?: string;
+    /** Seed missing history from a committed snapshot. */
+    historySeed?: string;
+    observerMismatch?: 'error' | 'reset';
+    site?: string;
+    failOn?: 'unavailable' | 'review' | 'none';
+}
+interface NotificationConfig extends Omit<NotificationOptions, 'previousReport' | 'mode'> {
+    input: string;
+    previousReport?: string;
+    timeZone?: string;
+    maxItems?: number;
+    feishu?: FeishuOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+    email?: EmailOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+}
+interface MeodpConfig {
+    /** Shared reporters; command sections may override this selection. */
+    reporter?: ReporterConfig;
+    check?: ScanConfig;
+    sitemap?: ScanConfig;
+    report?: {
+        reporter?: ReporterConfig;
+        input?: string;
+        output?: string;
+        dataUrl?: string;
+        verify?: ReportVerificationOptions;
+    };
+    notify?: NotificationConfig;
+}
+/** Lightweight configuration entry; importing it does not load browser or mail clients. */
+declare function defineConfig<const T extends MeodpConfig>(config: T): T;
+
+export { type MeodpConfig, type NotificationConfig, type ScanConfig, defineConfig };

package/dist/config/index.d.mts

@@ -0,0 +1,47 @@
+import { R as ReporterConfig, a as ReportVerificationOptions } from '../shared/meodp.a704f8db.mjs';
+import { S as SitemapOptions } from '../shared/meodp.93e06e00.mjs';
+import { EmailOptions } from '../notify/email.mjs';
+import { FeishuOptions } from '../notify/feishu.mjs';
+import { NotificationOptions } from '../notify/index.mjs';
+
+interface ScanConfig extends Omit<SitemapOptions, 'previousReport' | 'onResult'> {
+    input?: string;
+    reporter?: ReporterConfig;
+    output?: string;
+    history?: string;
+    /** Seed missing history from a committed snapshot. */
+    historySeed?: string;
+    observerMismatch?: 'error' | 'reset';
+    site?: string;
+    failOn?: 'unavailable' | 'review' | 'none';
+}
+interface NotificationConfig extends Omit<NotificationOptions, 'previousReport' | 'mode'> {
+    input: string;
+    previousReport?: string;
+    timeZone?: string;
+    maxItems?: number;
+    feishu?: FeishuOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+    email?: EmailOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+}
+interface MeodpConfig {
+    /** Shared reporters; command sections may override this selection. */
+    reporter?: ReporterConfig;
+    check?: ScanConfig;
+    sitemap?: ScanConfig;
+    report?: {
+        reporter?: ReporterConfig;
+        input?: string;
+        output?: string;
+        dataUrl?: string;
+        verify?: ReportVerificationOptions;
+    };
+    notify?: NotificationConfig;
+}
+/** Lightweight configuration entry; importing it does not load browser or mail clients. */
+declare function defineConfig<const T extends MeodpConfig>(config: T): T;
+
+export { type MeodpConfig, type NotificationConfig, type ScanConfig, defineConfig };