@fairfox/polly 0.40.0 → 0.49.0

package/dist/tools/quality/src/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Loader for the `quality` block of `polly.config.ts`.
+ *
+ * Consumers express their plugin set as
+ *
+ *   export default {
+ *     quality: {
+ *       plugins: [pollyCorePlugin, pollyUiPlugin, localPlugin],
+ *       checks: { "polly:no-as-casting": { exclude: ["build"] } },
+ *     },
+ *   };
+ *
+ * If no config is found, the loader returns `pollyCorePlugin` only —
+ * that's the minimum useful default and matches the surface every
+ * polly consumer already gets.
+ */
+import type { QualityRunConfig } from "./types";
+export declare function loadQualityConfig(rootDir: string, explicitPath?: string): Promise<QualityRunConfig>;

package/dist/tools/quality/src/host.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Plugin host for `@fairfox/polly/quality`.
+ *
+ * Loads plugins, validates check ids and per-check config, and runs
+ * checks in parallel against a `rootDir`. Each check goes through the
+ * cache layer first: a content-hash hit returns the prior outcome
+ * without invoking the body; a miss runs and persists the result.
+ *
+ * Errors thrown inside a check are caught and reported as a failed
+ * `CheckRunResult` so one broken plugin does not abort the whole run.
+ */
+import type { Check, QualityPlugin, QualityRunConfig, RunReport } from "./types";
+export type RegisteredCheck = {
+    check: Check<unknown>;
+    plugin: QualityPlugin;
+};
+/**
+ * Build a flat id-keyed registry from the configured plugins. Throws on
+ * plugin name collision or check id collision (within or across
+ * plugins) so misconfiguration fails at load time, not at run time.
+ */
+export declare function registerPlugins(plugins: QualityPlugin[]): Map<string, RegisteredCheck>;
+/**
+ * Validate that every per-check config block in the run config is
+ * accepted by the corresponding check's `validate` function. Surfaces all
+ * errors at once rather than aborting on the first.
+ */
+export declare function validateRunConfig(registry: Map<string, RegisteredCheck>, runConfig: QualityRunConfig): string[];
+export type RunOptions = {
+    rootDir: string;
+    /** When set, skip cache reads and writes. */
+    noCache?: boolean;
+    /** Concurrency cap; defaults to the number of registered checks. */
+    concurrency?: number;
+    signal?: AbortSignal;
+};
+/**
+ * Run a set of checks. If `ids` is undefined, runs every registered check.
+ * Returns a `RunReport` with per-check results plus an aggregate `ok`.
+ */
+export declare function runChecks(registry: Map<string, RegisteredCheck>, runConfig: QualityRunConfig, ids: string[] | undefined, opts: RunOptions): Promise<RunReport>;
+export declare function listChecks(registry: Map<string, RegisteredCheck>): Array<{
+    id: string;
+    description: string;
+    plugin: string;
+}>;

package/dist/tools/quality/src/index.d.ts

@@ -38,3 +38,10 @@ export { logger, type QualityLogger, resetLogger, } from "./logger.ts";
 export { type CheckResult, checkNoAsCasting, isLineClean, suggestFix, type Violation, } from "./no-as-casting";
 export { checkNoRequire, isLineRequireClean, type NoRequireCheckOptions, type NoRequireCheckResult, type NoRequireViolation, } from "./no-require";
 export { type CheckGitignoreOptions, type CheckSecretsOptions, checkGitignoreCoversAllowlist, checkSecrets, type GitignoreCheckResult, type SecretsCheckResult, } from "./secrets.ts";
+export { type AttestOptions, type AttestResult, digestRun, runAttest, summariseRunReport, } from "./attest";
+export { type CacheEntry, type CacheInputs, computeInputsHash, getCachedOutcome, setCachedOutcome, } from "./cache";
+export { loadQualityConfig } from "./config";
+export { listChecks, type RegisteredCheck, type RunOptions, registerPlugins, runChecks, validateRunConfig, } from "./host";
+export { POLLY_CORE_VERSION, pollyCorePlugin } from "./plugins/core";
+export { POLLY_UI_PLUGIN_VERSION, pollyUiPlugin } from "./plugins/polly-ui";
+export type { Check, CheckContext, CheckOutcome, CheckRunResult, QualityPlugin, QualityRunConfig, RunReport, } from "./types";