@a11yst/core 1.0.0

package/dist/select-runs.js

@@ -0,0 +1,128 @@
+/**
+ * Web accessibility profiles are executable for web platform runs.
+ */
+export function isExecutableRun(run) {
+    return run.platform === "web";
+}
+export function isFlowCheckpointRun(run) {
+    return run.kind === "flow-checkpoint";
+}
+export function isRouteRun(run) {
+    return run.kind === "route" || run.kind === undefined;
+}
+export function skipReasonForRun(_run) {
+    return undefined;
+}
+export class UnknownProjectError extends Error {
+    unknownNames;
+    knownNames;
+    constructor(unknownNames, knownNames) {
+        super(`Unknown project name(s): ${unknownNames.join(", ")}. ` +
+            `Known project(s): ${knownNames.length > 0 ? knownNames.join(", ") : "(none)"}.`);
+        this.name = "UnknownProjectError";
+        this.unknownNames = unknownNames;
+        this.knownNames = knownNames;
+    }
+}
+export class UnknownProfileError extends Error {
+    unknownProfiles;
+    knownProfiles;
+    constructor(unknownProfiles, knownProfiles) {
+        super(`Unknown or unconfigured profile(s): ${unknownProfiles.join(", ")}. ` +
+            `Configured profile(s): ${knownProfiles.join(", ")}.`);
+        this.name = "UnknownProfileError";
+        this.unknownProfiles = unknownProfiles;
+        this.knownProfiles = knownProfiles;
+    }
+}
+export class UnknownFlowError extends Error {
+    unknownFlows;
+    knownFlows;
+    constructor(unknownFlows, knownFlows) {
+        super(`Unknown flow id(s): ${unknownFlows.join(", ")}. ` +
+            `Configured flow(s): ${knownFlows.length > 0 ? knownFlows.join(", ") : "(none)"}.`);
+        this.name = "UnknownFlowError";
+        this.unknownFlows = unknownFlows;
+        this.knownFlows = knownFlows;
+    }
+}
+export class AuditSelectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AuditSelectionError";
+    }
+}
+function collectKnownFlowIds(plan) {
+    const ids = new Set();
+    for (const project of plan.projects ?? []) {
+        if (project.platform !== "web")
+            continue;
+        for (const flow of project.flows) {
+            ids.add(flow.id);
+        }
+    }
+    return [...ids].sort();
+}
+export function selectRuns(plan, options = {}) {
+    const { projectNames, profileNames, flowNames, routesOnly, flowsOnly } = options;
+    if (routesOnly && flowsOnly) {
+        throw new AuditSelectionError("Cannot use --routes-only and --flows-only together. Choose one audit mode.");
+    }
+    let candidateRuns = plan.runs;
+    if (projectNames && projectNames.length > 0) {
+        const knownNames = [...new Set(plan.runs.map((run) => run.projectName))];
+        const knownSet = new Set(knownNames);
+        const unknownNames = [...new Set(projectNames.filter((name) => !knownSet.has(name)))];
+        if (unknownNames.length > 0) {
+            throw new UnknownProjectError(unknownNames, knownNames);
+        }
+        const selectedNames = new Set(projectNames);
+        candidateRuns = candidateRuns.filter((run) => selectedNames.has(run.projectName));
+    }
+    if (profileNames && profileNames.length > 0) {
+        const configuredProfiles = new Set();
+        for (const project of plan.projects ?? []) {
+            for (const profile of project.profiles) {
+                configuredProfiles.add(profile);
+            }
+        }
+        const requested = [...new Set(profileNames)];
+        const unknownProfiles = requested.filter((profile) => !configuredProfiles.has(profile));
+        if (unknownProfiles.length > 0) {
+            throw new UnknownProfileError(unknownProfiles, [...configuredProfiles]);
+        }
+        const selectedProfiles = new Set(profileNames);
+        candidateRuns = candidateRuns.filter((run) => selectedProfiles.has(run.profile));
+    }
+    if (flowNames && flowNames.length > 0) {
+        const knownFlows = collectKnownFlowIds(plan);
+        const knownSet = new Set(knownFlows);
+        const unknownFlows = [...new Set(flowNames.filter((id) => !knownSet.has(id)))];
+        if (unknownFlows.length > 0) {
+            throw new UnknownFlowError(unknownFlows, knownFlows);
+        }
+        const selectedFlows = new Set(flowNames);
+        candidateRuns = candidateRuns.filter((run) => run.flowId !== undefined && selectedFlows.has(run.flowId));
+    }
+    else if (flowsOnly) {
+        candidateRuns = candidateRuns.filter((run) => isFlowCheckpointRun(run));
+    }
+    else if (routesOnly) {
+        candidateRuns = candidateRuns.filter((run) => isRouteRun(run));
+    }
+    else if (flowNames === undefined && !routesOnly && !flowsOnly) {
+        // Default: include both route and flow runs.
+    }
+    const executable = [];
+    const skipped = [];
+    for (const run of candidateRuns) {
+        if (isExecutableRun(run)) {
+            executable.push(run);
+        }
+        else {
+            skipped.push(run);
+        }
+    }
+    return { executable, skipped };
+}
+//# sourceMappingURL=select-runs.js.map

package/dist/select-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-runs.js","sourceRoot":"","sources":["../src/select-runs.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAe;IAC7C,OAAO,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAe;IACjD,OAAO,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAe;IACxC,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,YAAY,CAAW;IACvB,UAAU,CAAW;IAE9B,YAAY,YAAsB,EAAE,UAAoB;QACtD,KAAK,CACH,4BAA4B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACrD,qBAAqB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,eAAe,CAAyB;IACxC,aAAa,CAAyB;IAE/C,YAAY,eAAuC,EAAE,aAAqC;QACxF,KAAK,CACH,uCAAuC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACnE,0BAA0B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,YAAY,CAAW;IACvB,UAAU,CAAW;IAE9B,YAAY,YAAsB,EAAE,UAAoB;QACtD,KAAK,CACH,uBAAuB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAChD,uBAAuB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CACrF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAeD,SAAS,mBAAmB,CAAC,IAA0C;IACrE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK;YAAE,SAAS;QACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAoE,EACpE,UAA6B,EAAE;IAE/B,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAEjF,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAC3B,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;IAE9B,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC5C,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC3D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC1C,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACvC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACxF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/C,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,gBAAgB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,aAAa,GAAG,aAAa,CAAC,MAAM,CAClC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CACnE,CAAC;IACJ,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACrB,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,CAAC;SAAM,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;QAChE,6CAA6C;IAC/C,CAAC;IAED,MAAM,UAAU,GAAiB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@a11yst/core",
+  "version": "1.0.0",
+  "description": "Audit planning orchestrator for a11yst",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@a11yst/adapters": "1.0.0",
+    "@a11yst/artifacts": "1.0.0",
+    "@a11yst/baseline": "1.0.0",
+    "@a11yst/reporters": "1.0.0",
+    "@a11yst/flows": "1.0.0",
+    "@a11yst/source-analysis": "1.0.0",
+    "@a11yst/types": "1.0.0",
+    "@a11yst/browser": "1.0.0",
+    "@a11yst/junit": "1.0.0",
+    "@a11yst/policy": "1.0.0",
+    "@a11yst/sarif": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/angelabenavente/a11yst.git"
+  },
+  "homepage": "https://github.com/angelabenavente/a11yst#readme",
+  "bugs": {
+    "url": "https://github.com/angelabenavente/a11yst/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}