@hawkeyexl/manni 0.3.0 → 1.0.0

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   buildProgram,
   fail,
   runIfMain
-} from "./chunk-BKJOQHWN.js";
+} from "./chunk-HECVSJOR.js";
 import {
   ToolError,
   escapeWorkflowCommandMessage,
@@ -13,8 +13,9 @@ import {
   palette,
   programName,
   readConfigFile,
+  selectCollections,
   shouldColor
-} from "./chunk-7M2YOXVG.js";
+} from "./chunk-L7HN3AWA.js";
 
 // src/cli.ts
 import { Command as Command2 } from "commander";
@@ -178,6 +179,48 @@ async function crawl(opts, analyzer) {
   return { pages, discovered: frontier.length, skipped, duplicates };
 }
 
+// src/a11y/core/seeds.ts
+var NO_SEEDS_MESSAGE = "No URLs to check. Pass one or more, set url: on a collection, or set a11y.urls in manni.config.yaml.";
+var CONFIG_NAME = "manni.config.yaml";
+function resolveSeeds(sources) {
+  const { urls, collections: names, declared } = sources;
+  if (names.length > 0) {
+    if (urls.length > 0) {
+      throw new A11yError(
+        "--collection selects a configured collection; it cannot be combined with URLs."
+      );
+    }
+    if (sources.source == null && declared.length === 0) {
+      throw new A11yError("--collection needs a config file to select from.");
+    }
+    const selected = selectCollections(
+      declared,
+      names,
+      sources.source ?? CONFIG_NAME,
+      (message) => new A11yError(message)
+    );
+    const seeds = [];
+    for (const collection of selected) {
+      if (collection.url === void 0) {
+        throw new A11yError(`collection "${collection.name}" has no url: to check.`);
+      }
+      seeds.push(collection.url);
+    }
+    return unique(seeds);
+  }
+  if (urls.length > 0) return [...urls];
+  const configUrls = sources.configUrls ?? [];
+  if (configUrls.length > 0) return [...configUrls];
+  const published = unique(
+    declared.flatMap((collection) => collection.url === void 0 ? [] : [collection.url])
+  );
+  if (published.length > 0) return published;
+  throw new A11yError(NO_SEEDS_MESSAGE);
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+
 // src/a11y/core/sitemap.ts
 import { DOMParser } from "@xmldom/xmldom";
 var MAX_INDEX_DEPTH = 3;
@@ -311,9 +354,7 @@ async function runCheck(opts, deps) {
   const { analyzer } = deps;
   try {
     if (opts.urls.length === 0) {
-      throw new A11yError(
-        "No URLs to check. Pass one or more, or set `a11y.urls` in manni.config.yaml."
-      );
+      throw new A11yError(NO_SEEDS_MESSAGE);
     }
     for (const url of opts.urls) {
       if (!isHttpUrl(url)) throw new A11yError(`Not an http(s) URL: "${url}".`);
@@ -497,8 +538,12 @@ var CONFIG_FILE = {
 };
 async function loadA11yConfig(cwd, explicitPath) {
   const file = explicitPath === void 0 ? await findConfigFile(cwd, CONFIG_FILE) : await readConfigFile(explicitPath, cwd, CONFIG_FILE);
-  if (file === null) return { config: {}, source: null };
-  return { config: parseA11yConfig(file.value, file.source), source: file.source };
+  if (file === null) return { config: {}, source: null, collections: [] };
+  return {
+    config: parseA11yConfig(file.value, file.source),
+    source: file.source,
+    collections: file.collections
+  };
 }
 function parseA11yConfig(value, source) {
   if (value == null) return {};
@@ -783,6 +828,9 @@ function truncateMiddle(text, room) {
 }
 
 // src/a11y/cli.ts
+function collect(value, prev) {
+  return prev.concat([value]);
+}
 function splitList(value) {
   return value.split(",").map((s) => s.trim()).filter(Boolean);
 }
@@ -824,7 +872,7 @@ function buildProgram2() {
   program.name("a11y").description("Crawl a site and check every page for accessibility violations with axe-core").version(package_default.version, "-V, --version").option("--no-color", "disable colored output").showHelpAfterError("(add --help for usage)").exitOverride();
   program.command("check").description("Crawl from the given URLs and check every page with axe-core").argument(
     "[urls...]",
-    "http(s) seed URLs; falls back to a11y.urls in manni.config.yaml"
+    "http(s) seed URLs; falls back to a collection's url: or a11y.urls in manni.config.yaml"
   ).option("-f, --format <format>", `output: ${A11Y_FORMAT_LIST}`, "pretty").option("--no-crawl", "check exactly the given URLs: no sitemap, no link following").option(
     "--max-pages <n>",
     "cap on pages checked; the rest are reported as skipped (default: no cap)"
@@ -836,7 +884,12 @@ function buildProgram2() {
     "--timeout <ms>",
     "per-page navigation timeout in milliseconds",
     String(CHECK_DEFAULTS.timeout)
-  ).option("-q, --quiet", "in pretty output, hide pages with no violations").option("--progress", "report progress on stderr (default: only on a terminal)").option("--no-progress", "never report progress").option("-c, --config <path>", "path to a manni config file").option("--no-config", "ignore any discovered config file").action(async (urls, options, command) => {
+  ).option("-q, --quiet", "in pretty output, hide pages with no violations").option("--progress", "report progress on stderr (default: only on a terminal)").option("--no-progress", "never report progress").option(
+    "--collection <name>",
+    "configured collection to run over; repeatable",
+    collect,
+    []
+  ).option("-c, --config <path>", "path to a manni config file").option("--no-config", "ignore any discovered config file").action(async (urls, options, command) => {
     let clearProgress = () => void 0;
     try {
       const typed = (name) => command.getOptionValueSource(name) === "cli";
@@ -847,14 +900,21 @@ function buildProgram2() {
       const severity = assertSeverity(options.severity);
       const maxPages = options.maxPages === void 0 ? void 0 : positiveInteger(options.maxPages, "--max-pages");
       const timeout = positiveInteger(options.timeout, "--timeout");
-      const loaded = options.config === false ? { config: {}, source: null } : await loadA11yConfig(process.cwd(), options.config);
+      const loaded = options.config === false ? { config: {}, source: null, collections: [] } : await loadA11yConfig(process.cwd(), options.config);
       const cfg = loaded.config;
+      const seeds = resolveSeeds({
+        urls,
+        collections: options.collection,
+        ...cfg.urls === void 0 ? {} : { configUrls: cfg.urls },
+        declared: loaded.collections,
+        source: loaded.source
+      });
       const parent = command.parent ?? command;
       const progress = resolveProgress(parent, options.progress);
       clearProgress = progress.clear;
       const run = await runCheck(
         {
-          urls: urls.length > 0 ? urls : cfg.urls ?? [],
+          urls: seeds,
           crawl: typed("crawl") ? options.crawl : cfg.crawl ?? CHECK_DEFAULTS.crawl,
           // Typed flag > config key > no cap. There is no default to fall to.
           maxPages: maxPages ?? cfg.maxPages,