@a11yst/cli 1.0.0

package/dist/presentation/finding-groups.js

@@ -0,0 +1,77 @@
+import { resolveFindingRecommendationSummary, } from "./finding-source-report.js";
+const SEVERITY_ORDER = ["critical", "high", "medium", "minor"];
+function severityRank(severity) {
+    return SEVERITY_ORDER.indexOf(severity);
+}
+function compareFindingsStable(left, right) {
+    const routeOrder = (left.route ?? "").localeCompare(right.route ?? "");
+    if (routeOrder !== 0) {
+        return routeOrder;
+    }
+    const targetLeft = left.target.join(" ");
+    const targetRight = right.target.join(" ");
+    const targetOrder = targetLeft.localeCompare(targetRight);
+    if (targetOrder !== 0) {
+        return targetOrder;
+    }
+    return left.fingerprint.localeCompare(right.fingerprint);
+}
+function recommendationKey(finding) {
+    const summary = resolveFindingRecommendationSummary(finding);
+    if (!summary) {
+        return "";
+    }
+    return [summary.title ?? "", summary.summary ?? "", summary.applicability ?? ""].join("\0");
+}
+export function buildFindingGroupKey(finding) {
+    return [
+        finding.severity,
+        finding.ruleId,
+        recommendationKey(finding),
+        finding.route ?? "",
+        finding.profile ?? "",
+        finding.flowId ?? "",
+        finding.title,
+    ].join("\0");
+}
+export function groupFindings(findings) {
+    const groups = new Map();
+    for (const finding of findings) {
+        const key = buildFindingGroupKey(finding);
+        const existing = groups.get(key);
+        if (existing) {
+            existing.findings.push(finding);
+            continue;
+        }
+        groups.set(key, {
+            key,
+            severity: finding.severity,
+            ruleId: finding.ruleId,
+            title: finding.title,
+            findings: [finding],
+            recommendation: resolveFindingRecommendationSummary(finding),
+        });
+    }
+    return [...groups.values()]
+        .map((group) => ({
+        ...group,
+        findings: [...group.findings].sort(compareFindingsStable),
+    }))
+        .sort((left, right) => {
+        const severityOrder = severityRank(left.severity) - severityRank(right.severity);
+        if (severityOrder !== 0) {
+            return severityOrder;
+        }
+        const ruleOrder = left.ruleId.localeCompare(right.ruleId);
+        if (ruleOrder !== 0) {
+            return ruleOrder;
+        }
+        const routeLeft = left.findings[0]?.route ?? "";
+        const routeRight = right.findings[0]?.route ?? "";
+        return routeLeft.localeCompare(routeRight);
+    });
+}
+export function countUniqueIssues(findings) {
+    return groupFindings(findings).length;
+}
+//# sourceMappingURL=finding-groups.js.map

package/dist/presentation/finding-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-groups.js","sourceRoot":"","sources":["../../src/presentation/finding-groups.ts"],"names":[],"mappings":"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"}

package/dist/presentation/finding-source-report.d.ts

@@ -0,0 +1,21 @@
+import type { Finding, SourceLocation, SourceMappingConfidence, SourceMappingProvenance } from "@a11yst/types";
+export type FindingReportSource = {
+    status: "mapped" | "ambiguous" | "unmapped" | "invalid";
+    location?: SourceLocation;
+    confidence?: SourceMappingConfidence;
+    provenance?: SourceMappingProvenance;
+    alternatives?: SourceLocation[];
+};
+export type FindingRecommendationSummary = {
+    status: string;
+    applicability?: string;
+    title?: string;
+    summary?: string;
+};
+export declare function resolveFindingReportSource(finding: Finding): FindingReportSource;
+export declare function formatReportSourceLocation(location: SourceLocation): string;
+/** Strip absolute or home-like paths from source URIs for human-facing reports. */
+export declare function sanitizeSourceUriForReport(uri: string): string;
+export declare function formatSafeReportSourceLocation(location: SourceLocation): string;
+export declare function resolveFindingRecommendationSummary(finding: Finding): FindingRecommendationSummary | undefined;
+//# sourceMappingURL=finding-source-report.d.ts.map

package/dist/presentation/finding-source-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-source-report.d.ts","sourceRoot":"","sources":["../../src/presentation/finding-source-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA8EF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAqChF;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAI3E;AAKD,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAK/E;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,OAAO,GACf,4BAA4B,GAAG,SAAS,CAe1C"}

package/dist/presentation/finding-source-report.js

@@ -0,0 +1,134 @@
+const MAX_ALTERNATIVES = 5;
+function flatRegion(region) {
+    return {
+        startLine: region.start.line,
+        ...(region.start.column !== undefined ? { startColumn: region.start.column } : {}),
+    };
+}
+function candidateLocationKey(location) {
+    const flat = flatRegion(location.region);
+    return `${location.uri}\0${flat.startLine}\0${flat.startColumn ?? ""}`;
+}
+function readLegacySourceLocation(finding) {
+    const extension = finding;
+    const legacy = extension.sourceLocation;
+    if (!legacy?.uri || !legacy.startLine) {
+        return undefined;
+    }
+    return {
+        uri: legacy.uri,
+        region: {
+            start: {
+                line: legacy.startLine,
+                ...(legacy.startColumn !== undefined ? { column: legacy.startColumn } : {}),
+            },
+            ...(legacy.endLine !== undefined
+                ? {
+                    end: {
+                        line: legacy.endLine,
+                        ...(legacy.endColumn !== undefined ? { column: legacy.endColumn } : {}),
+                    },
+                }
+                : {}),
+        },
+    };
+}
+function compareLocations(left, right) {
+    const uriOrder = left.uri.localeCompare(right.uri);
+    if (uriOrder !== 0) {
+        return uriOrder;
+    }
+    const leftFlat = flatRegion(left.region);
+    const rightFlat = flatRegion(right.region);
+    if (leftFlat.startLine !== rightFlat.startLine) {
+        return leftFlat.startLine - rightFlat.startLine;
+    }
+    return (leftFlat.startColumn ?? 0) - (rightFlat.startColumn ?? 0);
+}
+function dedupeAlternatives(locations) {
+    const seen = new Set();
+    const result = [];
+    for (const location of [...locations].sort(compareLocations)) {
+        const key = candidateLocationKey(location);
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(location);
+        }
+    }
+    return result.slice(0, MAX_ALTERNATIVES);
+}
+export function resolveFindingReportSource(finding) {
+    const mapping = finding.sourceMapping;
+    if (mapping?.status === "mapped" && mapping.selected) {
+        return {
+            status: "mapped",
+            location: mapping.selected.location,
+            confidence: mapping.selected.confidence,
+            provenance: mapping.selected.provenance,
+        };
+    }
+    if (mapping?.status === "invalid") {
+        return { status: "invalid" };
+    }
+    if (mapping?.status === "ambiguous") {
+        return {
+            status: "ambiguous",
+            alternatives: dedupeAlternatives(mapping.candidates.map((candidate) => candidate.location)),
+        };
+    }
+    const legacy = readLegacySourceLocation(finding);
+    if (legacy) {
+        return {
+            status: "mapped",
+            location: legacy,
+            confidence: "exact",
+            provenance: "existing-source-location",
+        };
+    }
+    if (mapping?.status === "unmapped") {
+        return { status: "unmapped" };
+    }
+    return { status: "unmapped" };
+}
+export function formatReportSourceLocation(location) {
+    const flat = flatRegion(location.region);
+    const column = flat.startColumn !== undefined ? `:${flat.startColumn}` : "";
+    return `${location.uri}:${flat.startLine}${column}`;
+}
+const UNIX_ABSOLUTE = /^\//;
+const WINDOWS_ABSOLUTE = /^[A-Za-z]:[\\/]/;
+/** Strip absolute or home-like paths from source URIs for human-facing reports. */
+export function sanitizeSourceUriForReport(uri) {
+    const normalized = uri.replace(/\\/g, "/");
+    if (!UNIX_ABSOLUTE.test(normalized) && !WINDOWS_ABSOLUTE.test(normalized)) {
+        return normalized;
+    }
+    const segments = normalized.split("/").filter(Boolean);
+    if (segments.length >= 2) {
+        return segments.slice(-2).join("/");
+    }
+    return segments[segments.length - 1] ?? "source";
+}
+export function formatSafeReportSourceLocation(location) {
+    return formatReportSourceLocation({
+        ...location,
+        uri: sanitizeSourceUriForReport(location.uri),
+    });
+}
+export function resolveFindingRecommendationSummary(finding) {
+    const recommendations = finding.recommendations;
+    if (!recommendations || recommendations.recommendations.length === 0) {
+        return undefined;
+    }
+    const primary = recommendations.recommendations[0];
+    if (!primary) {
+        return undefined;
+    }
+    return {
+        status: recommendations.status,
+        applicability: primary.applicability,
+        title: primary.title,
+        summary: primary.summary,
+    };
+}
+//# sourceMappingURL=finding-source-report.js.map

package/dist/presentation/finding-source-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-source-report.js","sourceRoot":"","sources":["../../src/presentation/finding-source-report.ts"],"names":[],"mappings":"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"}

package/dist/presentation/human-output.d.ts

@@ -0,0 +1,4 @@
+import type { TerminalCapabilities } from "./types.js";
+/** Prefix human command output with a brand header. */
+export declare function prependHumanBrandHeader(body: string, _capabilities?: TerminalCapabilities): string;
+//# sourceMappingURL=human-output.d.ts.map

package/dist/presentation/human-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-output.d.ts","sourceRoot":"","sources":["../../src/presentation/human-output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,uDAAuD;AACvD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,oBAAoD,GAClE,MAAM,CAGR"}

package/dist/presentation/human-output.js

@@ -0,0 +1,8 @@
+import { createBrandHeader } from "./brand-header.js";
+import { resolveTerminalCapabilities } from "./capabilities.js";
+/** Prefix human command output with a brand header. */
+export function prependHumanBrandHeader(body, _capabilities = resolveTerminalCapabilities()) {
+    const header = createBrandHeader({ tagline: true });
+    return `${header}\n\n${body}`;
+}
+//# sourceMappingURL=human-output.js.map

package/dist/presentation/human-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-output.js","sourceRoot":"","sources":["../../src/presentation/human-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAGhE,uDAAuD;AACvD,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,gBAAsC,2BAA2B,EAAE;IAEnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,GAAG,MAAM,OAAO,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/presentation/index.d.ts

@@ -0,0 +1,15 @@
+export { createBrandHeader, createPlainBrandHeader } from "./brand-header.js";
+export { resolveTerminalCapabilities } from "./capabilities.js";
+export { shouldRenderBranding } from "./boundary.js";
+export { AUDIT_HELP_DISCLAIMER } from "./disclaimers.js";
+export { prependHumanBrandHeader } from "./human-output.js";
+export { resolveTerminalPresentationMode } from "./mode.js";
+export { formatHumanHint, formatHumanStatus, HUMAN_STATUS_LABELS, type HumanStatusKind, } from "./status.js";
+export type { ColorMode } from "./color.js";
+export { parseColorMode, resolveColorEnabled } from "./color.js";
+export { parseProgressMode, resolveProgressAnimationEnabled, resolveProgressModeFromCli, resolveProgressStaticEnabled, type ProgressMode, } from "./progress-mode.js";
+export { createProgressReporter, stopActiveProgressReporter } from "./progress-reporter.js";
+export { registerProgressSignalHandlers } from "./progress-signals.js";
+export { buildFindingGroupKey, countUniqueIssues, formatAuditExecutionHeader, formatAuditFindingsPresentation, formatAuditFooterSummary, formatAuditRunSummaries, formatProfileReviewSections, groupFindings, type AuditPresentationOptions, type FindingGroup, } from "./audit-presentation.js";
+export type { BrandHeaderOptions, OutputKind, TerminalCapabilities, TerminalCapabilitiesInput, TerminalPresentationMode, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/presentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,+BAA+B,EAC/B,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,aAAa,EACb,KAAK,wBAAwB,EAC7B,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/presentation/index.js

@@ -0,0 +1,13 @@
+export { createBrandHeader, createPlainBrandHeader } from "./brand-header.js";
+export { resolveTerminalCapabilities } from "./capabilities.js";
+export { shouldRenderBranding } from "./boundary.js";
+export { AUDIT_HELP_DISCLAIMER } from "./disclaimers.js";
+export { prependHumanBrandHeader } from "./human-output.js";
+export { resolveTerminalPresentationMode } from "./mode.js";
+export { formatHumanHint, formatHumanStatus, HUMAN_STATUS_LABELS, } from "./status.js";
+export { parseColorMode, resolveColorEnabled } from "./color.js";
+export { parseProgressMode, resolveProgressAnimationEnabled, resolveProgressModeFromCli, resolveProgressStaticEnabled, } from "./progress-mode.js";
+export { createProgressReporter, stopActiveProgressReporter } from "./progress-reporter.js";
+export { registerProgressSignalHandlers } from "./progress-signals.js";
+export { buildFindingGroupKey, countUniqueIssues, formatAuditExecutionHeader, formatAuditFindingsPresentation, formatAuditFooterSummary, formatAuditRunSummaries, formatProfileReviewSections, groupFindings, } from "./audit-presentation.js";
+//# sourceMappingURL=index.js.map

package/dist/presentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,+BAA+B,EAC/B,0BAA0B,EAC1B,4BAA4B,GAE7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,+BAA+B,EAC/B,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,aAAa,GAGd,MAAM,yBAAyB,CAAC"}

package/dist/presentation/mode.d.ts

@@ -0,0 +1,4 @@
+import type { TerminalCapabilities, TerminalPresentationMode } from "./types.js";
+/** Conservative interactive detection: TTY, not CI, not a dumb terminal. */
+export declare function resolveTerminalPresentationMode(capabilities: TerminalCapabilities): TerminalPresentationMode;
+//# sourceMappingURL=mode.d.ts.map

package/dist/presentation/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../src/presentation/mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEjF,4EAA4E;AAC5E,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,oBAAoB,GACjC,wBAAwB,CAK1B"}

package/dist/presentation/mode.js

@@ -0,0 +1,8 @@
+/** Conservative interactive detection: TTY, not CI, not a dumb terminal. */
+export function resolveTerminalPresentationMode(capabilities) {
+    if (!capabilities.isTTY || capabilities.isCI || capabilities.isDumbTerminal) {
+        return "plain";
+    }
+    return "interactive";
+}
+//# sourceMappingURL=mode.js.map

package/dist/presentation/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../src/presentation/mode.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,UAAU,+BAA+B,CAC7C,YAAkC;IAElC,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,cAAc,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/presentation/progress-mode.d.ts

@@ -0,0 +1,20 @@
+import type { TerminalCapabilities } from "./types.js";
+export type ProgressMode = "auto" | "always" | "never";
+export declare function parseProgressMode(value: string | undefined): ProgressMode;
+export interface ResolveProgressEnabledInput {
+    mode: ProgressMode;
+    machineOutput: boolean;
+    capabilities: TerminalCapabilities;
+}
+/**
+ * Whether transient spinner/progress animation should run.
+ * Distinct from `--color`: progress may animate without ANSI color.
+ */
+export declare function resolveProgressAnimationEnabled(input: ResolveProgressEnabledInput): boolean;
+/** Whether static textual milestones may be printed (always mode, non-interactive). */
+export declare function resolveProgressStaticEnabled(input: ResolveProgressEnabledInput): boolean;
+export declare function resolveProgressModeFromCli(input: {
+    progress?: string;
+    noProgress?: boolean;
+}): ProgressMode;
+//# sourceMappingURL=progress-mode.d.ts.map

package/dist/presentation/progress-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-mode.d.ts","sourceRoot":"","sources":["../../src/presentation/progress-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAKzE;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAY3F;AAED,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAQxF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,YAAY,CAKf"}

package/dist/presentation/progress-mode.js

@@ -0,0 +1,38 @@
+export function parseProgressMode(value) {
+    if (value === "always" || value === "never") {
+        return value;
+    }
+    return "auto";
+}
+/**
+ * Whether transient spinner/progress animation should run.
+ * Distinct from `--color`: progress may animate without ANSI color.
+ */
+export function resolveProgressAnimationEnabled(input) {
+    if (input.mode === "never" || input.machineOutput) {
+        return false;
+    }
+    if (input.mode === "always") {
+        return input.capabilities.isStderrTTY && !input.capabilities.isDumbTerminal;
+    }
+    return (input.capabilities.isStderrTTY &&
+        !input.capabilities.isCI &&
+        !input.capabilities.isDumbTerminal);
+}
+/** Whether static textual milestones may be printed (always mode, non-interactive). */
+export function resolveProgressStaticEnabled(input) {
+    if (input.mode === "never" || input.machineOutput) {
+        return false;
+    }
+    if (input.mode === "always") {
+        return !resolveProgressAnimationEnabled(input);
+    }
+    return false;
+}
+export function resolveProgressModeFromCli(input) {
+    if (input.noProgress) {
+        return "never";
+    }
+    return parseProgressMode(input.progress);
+}
+//# sourceMappingURL=progress-mode.js.map

package/dist/presentation/progress-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-mode.js","sourceRoot":"","sources":["../../src/presentation/progress-mode.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAAkC;IAChF,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,YAAY,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC;IAC9E,CAAC;IACD,OAAO,CACL,KAAK,CAAC,YAAY,CAAC,WAAW;QAC9B,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI;QACxB,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,CACnC,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,4BAA4B,CAAC,KAAkC;IAC7E,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAG1C;IACC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/presentation/progress-reporter.d.ts

@@ -0,0 +1,18 @@
+import type { ProgressReporter } from "@a11yst/types";
+import type { ColorMode } from "./color.js";
+import { type ProgressMode } from "./progress-mode.js";
+import type { TerminalCapabilities } from "./types.js";
+export interface CreateProgressReporterOptions {
+    mode: ProgressMode;
+    machineOutput: boolean;
+    capabilities: TerminalCapabilities;
+    colorMode?: ColorMode;
+    stream?: NodeJS.WriteStream;
+    setIntervalFn?: typeof setInterval;
+    clearIntervalFn?: typeof clearInterval;
+    setTimeoutFn?: typeof setTimeout;
+    clearTimeoutFn?: typeof clearTimeout;
+}
+export declare function stopActiveProgressReporter(): void;
+export declare function createProgressReporter(options: CreateProgressReporterOptions): ProgressReporter;
+//# sourceMappingURL=progress-reporter.d.ts.map

package/dist/presentation/progress-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reporter.d.ts","sourceRoot":"","sources":["../../src/presentation/progress-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AASvD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,WAAW,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,aAAa,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;CACtC;AAID,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AA6ND,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,gBAAgB,CA4BlB"}