@bridge-ds/core 0.4.0 → 0.5.1

package/dist/node/audit.d.ts

@@ -2,7 +2,7 @@ import { type BridgeConfig } from '../config';
 import { LayeredTokenSet } from '../layered';
 import { type CssFixEdit } from '../audit/report';
 import { DesignSystemIndex } from '../audit/ds-index';
-import type { AuditReport } from '../audit/types';
+import type { AllowlistEntry, AuditReport } from '../audit/types';
 export interface LoadedDesignSystem {
     root: string;
     config: BridgeConfig;
@@ -33,7 +33,11 @@ export interface RunAuditOptions {
     /** Path recorded in the report (default: target relative to cwd). */
     displayPath?: string;
     exclude?: string[];
+    /** Known violations left out of the counts, each with a reason (see loadAllowlist). */
+    allowlist?: AllowlistEntry[];
 }
+/** Read an allowlist file: `{ "entries": [{ "file", "line", "what"?, "reason" }] }`, paths relative to the audited folder. */
+export declare function loadAllowlist(path: string): AllowlistEntry[];
 /** Audit a product folder against a design system. */
 export declare function runAudit(target: string, opts?: RunAuditOptions): AuditReport;
 /** Plan (and optionally write) the safe CSS autofix for every CSS/SCSS/Less file under `target`. */

package/dist/node/index.js

@@ -5,7 +5,7 @@ import { join, resolve, relative, dirname, sep, posix } from "node:path";
 import { a as assertSafeBranch, c as collectHistory, p as packageDirCandidates, b as parseChangelog, m as mergeReleases, r as releasesFromTags, d as buildReport, e as prNumberFromSubject, l as loadConfig, h as hashSpec, C as COMPONENT_SPECS_VERSION, f as CONFIG_FILE, g as layoutOptions, v as variantKeyOf, i as buildTokenSet, t as tokenCssVar, j as iconComponentName, k as COLOR_FIELDS } from "../component-spec-cvrSvIZj.js";
 import { s as selectTokenFiles, g as globToRegExp, L as LayeredTokenSet } from "../layered-BnbmToGs.js";
 import { statSync, readFileSync, existsSync, writeFileSync, readdirSync } from "node:fs";
-import { n as isAuditable, x as planCssFixes, c as DesignSystemIndex, g as buildAuditReport, i as compareWithBaseline, a as AUDIT_IGNORE_DIRS } from "../report-Bf2HEr9t.js";
+import { v as isAuditable, Q as planCssFixes, O as parseAllowlist, c as DesignSystemIndex, k as buildAuditReport, n as compareWithBaseline, a as AUDIT_IGNORE_DIRS } from "../report-iPSnsjYi.js";
 import ts from "typescript";
 function git(root, args, opts = {}) {
   return new Promise((resolve2, reject) => {
@@ -277,13 +277,16 @@ function collectAuditFiles(target, exclude = []) {
   }
   return { root: abs, files, skipped };
 }
+function loadAllowlist(path) {
+  return parseAllowlist(JSON.parse(readFileSync(path, "utf8")));
+}
 function runAudit(target, opts = {}) {
   const dsRoot = opts.ds ?? findDesignSystemRoot(process.cwd());
   if (!dsRoot) throw new Error("No design system found: run from a repo with bridge.config.json or pass --ds <dir>.");
   const ds = loadDesignSystem(dsRoot);
   const { files, skipped } = collectAuditFiles(target, [...ds.config.audit?.exclude ?? [], ...opts.exclude ?? []]);
   const report = buildAuditReport(
-    { files, skipped, target: opts.displayPath ?? (toPosix(relative(process.cwd(), resolve(target))) || "."), ...opts.label ? { label: opts.label } : {}, ...opts.version ? { version: opts.version } : {} },
+    { files, skipped, target: opts.displayPath ?? (toPosix(relative(process.cwd(), resolve(target))) || "."), ...opts.label ? { label: opts.label } : {}, ...opts.version ? { version: opts.version } : {}, ...opts.allowlist ? { allowlist: opts.allowlist } : {} },
     ds.index
   );
   return opts.baseline ? compareWithBaseline(report, opts.baseline) : report;
@@ -1746,6 +1749,7 @@ export {
   git,
   isGitRepo,
   listFilesAt,
+  loadAllowlist,
   loadDesignSystem,
   loadLocalHistory,
   localGitHistoryBackend,