@sybelblue/prairielearn-navigator 1.1.2 → 1.1.3

package/dist/core/config.d.ts

@@ -22,11 +22,24 @@ interface Exclude {
     base: string;
     glob: string;
 }
+/** One exact diagnostic occurrence suppressed for one file. */
+export interface IgnoredDiagnostic {
+    /** Absolute path of the file containing the diagnostic. */
+    file: string;
+    rule: RuleId;
+    /** Stable semantic identity, e.g. a question id, tag name, or set name. */
+    identifier?: string;
+    /** Exact message fallback for rules without a semantic identity. */
+    message?: string;
+    /** 1-based occurrence among diagnostics with this rule and message. */
+    occurrence?: number;
+}
 export interface NavigatorConfig {
     plVersion: PlVersion;
     /** Absolute. */
     schemaCacheDir: string;
     rules: Partial<Record<RuleId, RuleSetting>>;
+    ignoredDiagnostics: IgnoredDiagnostic[];
     /** Files never checked. Every source adds to this rather than replacing it. */
     excludes: Exclude[];
 }
@@ -73,6 +86,7 @@ declare const fields: {
     plVersion: Field;
     schemaCacheDir: Field;
     excludes: Field;
+    ignoredDiagnostics: Field;
     rules: Field;
 };
 /** Every key a config source may set, besides `$schema`. */

package/dist/core/diagnostic.d.ts

@@ -25,6 +25,8 @@ export interface Diagnostic {
     message: string;
     severity: Severity;
     code?: string;
+    /** Stable rule-specific identity used for semantic suppressions when available. */
+    identifier?: string;
     related?: RelatedInfo[];
     metadata?: DiagnosticMetadata;
 }

package/dist/core/rules/run.d.ts

@@ -18,6 +18,8 @@ export declare function runRules(filePath: string, text: string, options: {
     schemas: SchemaStore;
     references?: ReferenceIndex;
 }): Promise<Diagnostic[]>;
+/** Removes exact per-file diagnostic occurrences suppressed in the config. */
+export declare function withoutIgnoredDiagnostics(filePath: string, diagnostics: Diagnostic[], config: NavigatorConfig): Diagnostic[];
 /**
  * Runs the rules that look at a course as a whole rather than one file.
  * Returns diagnostics by the absolute path of the file each is shown on.