@pbiplint/core 0.1.0

package/NOTICE

@@ -0,0 +1,29 @@
+pbiplint itself is licensed under the GNU Affero General Public License,
+version 3 or later; see LICENSE. The MIT license text below applies only
+to the third-party material described here, not to pbiplint.
+
+pbiplint bundles rule definitions derived from BPARules.json in the
+microsoft/Analysis-Services repository (https://github.com/microsoft/Analysis-Services),
+which is licensed under the MIT License:
+
+MIT License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @pbiplint/core
+
+The linter behind [pbiplint](https://pbiplint.com): parse TMDL, build the semantic model, run the
+best-practice rules, rank the findings, and format them. Pure TypeScript with no dependencies, no
+Node APIs, and no network access, so it runs in a browser tab as well as in Node 20 or later.
+
+```ts
+import { formatText, lint } from "@pbiplint/core";
+
+const result = lint([
+  { path: "definition/model.tmdl", text: modelTmdl },
+  { path: "definition/tables/Sales.tmdl", text: salesTmdl },
+]);
+
+console.log(formatText(result)); // or formatJson, formatMarkdown, formatSarif
+for (const group of result.groups) console.log(group.rule.id, group.findings.length, group.rule.url);
+```
+
+`lint(files, { config })` takes the files of one model with paths relative to the model root and an
+optional `pbiplint.config.json` object. `result.groups` is ranked by severity, then category, then
+count, exactly as the command line and the website show it. Every rule has a page at
+`https://pbiplint.com/rules/<slug>`; `group.rule.url` points at it.
+
+The rules are literal ports of the Microsoft Best Practice Analyzer ruleset, verified against
+Tabular Editor. Quirks are kept on purpose and documented on each rule's page.
+
+For the command line, install [`pbiplint`](https://www.npmjs.com/package/pbiplint). Source, issues,
+and contributing: https://github.com/pbiplint/pbiplint.
+
+## License
+
+Copyright (C) 2026 McKinley Consulting. GNU Affero General Public License, version 3 or later; see
+LICENSE. The vendored Microsoft ruleset is MIT-licensed; see NOTICE. The name pbiplint and its
+logo are trademarks of McKinley Consulting.

package/dist/engine/config.d.ts

@@ -0,0 +1,33 @@
+import type { Rule, Severity } from "../rules/types.js";
+export type SeverityName = "info" | "warning" | "error";
+/** Shape of pbiplint.config.json. */
+export interface PbiplintConfig {
+    /** Optional JSON Schema URL, so an editor can validate and complete the file. Ignored here. */
+    $schema?: string;
+    /** Per rule: "off" disables it; a severity name overrides its severity. */
+    rules?: Record<string, "off" | SeverityName>;
+    /** Lowest severity that makes the CLI exit nonzero. Default "error". */
+    failOn?: SeverityName | "none";
+}
+export interface ResolvedConfig {
+    disabled: Set<string>;
+    severity: Map<string, Severity>;
+    failOn: Severity | null;
+}
+export declare class ConfigError extends Error {
+}
+export interface BoundConfig {
+    /** The same settings keyed by the rules' own ids. */
+    config: ResolvedConfig;
+    /** Ids from the config that match no rule, as written. */
+    unknownRules: string[];
+}
+/**
+ * Map the config's rule ids onto `rules` without regard to case, so `hide_foreign_keys` reaches
+ * HIDE_FOREIGN_KEYS, and list the ids that reach nothing so a typo never disables a rule silently.
+ */
+export declare function bindConfig(config: ResolvedConfig, rules: Rule[]): BoundConfig;
+export declare const SEVERITY_BY_NAME: Record<SeverityName, Severity>;
+export declare function isResolvedConfig(v: unknown): v is ResolvedConfig;
+export declare function resolveConfig(raw?: unknown): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/engine/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/engine/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAExD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,YAAY,CAAC,CAAC;IAC7C,wEAAwE;IACxE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;CACzB;AAED,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAEzC,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,MAAM,EAAE,cAAc,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CAe7E;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAqC,CAAC;AAKlG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAEhE;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,OAAY,GAAG,cAAc,CA+B/D"}

package/dist/engine/config.js

@@ -0,0 +1,61 @@
+export class ConfigError extends Error {
+}
+/**
+ * Map the config's rule ids onto `rules` without regard to case, so `hide_foreign_keys` reaches
+ * HIDE_FOREIGN_KEYS, and list the ids that reach nothing so a typo never disables a rule silently.
+ */
+export function bindConfig(config, rules) {
+    const idByUpper = new Map(rules.map((r) => [r.id.toUpperCase(), r.id]));
+    const bound = { disabled: new Set(), severity: new Map(), failOn: config.failOn };
+    const unknownRules = [];
+    for (const id of config.disabled) {
+        const real = idByUpper.get(id.toUpperCase());
+        if (real === undefined)
+            unknownRules.push(id);
+        else
+            bound.disabled.add(real);
+    }
+    for (const [id, severity] of config.severity) {
+        const real = idByUpper.get(id.toUpperCase());
+        if (real === undefined)
+            unknownRules.push(id);
+        else
+            bound.severity.set(real, severity);
+    }
+    return { config: bound, unknownRules };
+}
+export const SEVERITY_BY_NAME = { info: 1, warning: 2, error: 3 };
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+export function isResolvedConfig(v) {
+    return isRecord(v) && v.disabled instanceof Set && v.severity instanceof Map;
+}
+export function resolveConfig(raw = {}) {
+    if (!isRecord(raw))
+        throw new ConfigError("pbiplint.config.json must be a JSON object");
+    for (const k of Object.keys(raw))
+        if (k !== "rules" && k !== "failOn" && k !== "$schema")
+            throw new ConfigError(`pbiplint.config.json: unknown key "${k}"`);
+    const out = { disabled: new Set(), severity: new Map(), failOn: 3 };
+    if (raw.rules !== undefined) {
+        if (!isRecord(raw.rules))
+            throw new ConfigError('pbiplint.config.json: "rules" must be an object of rule id to "off" | "info" | "warning" | "error"');
+        for (const [id, v] of Object.entries(raw.rules)) {
+            if (v === "off")
+                out.disabled.add(id);
+            else if (v === "info" || v === "warning" || v === "error")
+                out.severity.set(id, SEVERITY_BY_NAME[v]);
+            else
+                throw new ConfigError(`pbiplint.config.json: rules["${id}"] must be "off", "info", "warning", or "error"`);
+        }
+    }
+    if (raw.failOn !== undefined) {
+        if (raw.failOn === "none")
+            out.failOn = null;
+        else if (raw.failOn === "info" || raw.failOn === "warning" || raw.failOn === "error")
+            out.failOn = SEVERITY_BY_NAME[raw.failOn];
+        else
+            throw new ConfigError('pbiplint.config.json: "failOn" must be "info", "warning", "error", or "none"');
+    }
+    return out;
+}
+//# sourceMappingURL=config.js.map

package/dist/engine/config.js.map

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

package/dist/engine/ignore.d.ts

@@ -0,0 +1,8 @@
+import type { Named } from "../model/types.js";
+export declare const IGNORE_ANNOTATION = "pbiplint.ignore";
+/**
+ * True when the object carries `annotation pbiplint.ignore = RULE_A, RULE_B` naming this rule, or
+ * `= *`. Ids are matched without regard to case, so a hand-typed lowercase id still works.
+ */
+export declare function isIgnored(object: Named | undefined, ruleId: string): boolean;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/engine/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../src/engine/ignore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ5E"}

package/dist/engine/ignore.js

@@ -0,0 +1,17 @@
+import { unquoteValue } from "../tmdl/quote.js";
+export const IGNORE_ANNOTATION = "pbiplint.ignore";
+/**
+ * True when the object carries `annotation pbiplint.ignore = RULE_A, RULE_B` naming this rule, or
+ * `= *`. Ids are matched without regard to case, so a hand-typed lowercase id still works.
+ */
+export function isIgnored(object, ruleId) {
+    const raw = object?.annotations[IGNORE_ANNOTATION];
+    if (raw === undefined)
+        return false;
+    const wanted = ruleId.toUpperCase();
+    return unquoteValue(raw)
+        .split(",")
+        .map((s) => s.trim())
+        .some((s) => s === "*" || s.toUpperCase() === wanted);
+}
+//# sourceMappingURL=ignore.js.map

package/dist/engine/ignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.js","sourceRoot":"","sources":["../../src/engine/ignore.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAyB,EAAE,MAAc;IACjE,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,YAAY,CAAC,GAAG,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/engine/lint.d.ts

@@ -0,0 +1,38 @@
+import type { Model } from "../model/types.js";
+import type { Finding, Rule } from "../rules/types.js";
+import { type PbiplintConfig, type ResolvedConfig } from "./config.js";
+import { type RankedGroup } from "./rank.js";
+import { type RuleError, type SkippedRule } from "./run.js";
+export interface LintFile {
+    /** Path relative to the model root, forward slashes, e.g. `definition/tables/Sales.tmdl`. */
+    path: string;
+    text: string;
+}
+export interface LintOptions {
+    config?: PbiplintConfig | ResolvedConfig;
+    rules?: Rule[];
+}
+export interface LintSummary {
+    files: number;
+    findings: number;
+    errors: number;
+    warnings: number;
+    infos: number;
+    rulesRun: number;
+    rulesSkipped: SkippedRule[];
+    ruleErrors: RuleError[];
+    ignored: number;
+    /** Rule ids named in the config that match no rule, as written there. */
+    unknownRules: string[];
+}
+export interface LintResult {
+    model: Model;
+    findings: Finding[];
+    groups: RankedGroup[];
+    summary: LintSummary;
+    /** True when any finding's effective severity is at or above the configured failOn. */
+    failed: boolean;
+}
+/** The one call the web app and the CLI both make. Pure: no I/O, no network. */
+export declare function lint(files: LintFile[], options?: LintOptions): LintResult;
+//# sourceMappingURL=lint.d.ts.map

package/dist/engine/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/engine/lint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAEtE,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC;IACzC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,uFAAuF;IACvF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,gFAAgF;AAChF,wBAAgB,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CA2B7E"}

package/dist/engine/lint.js

@@ -0,0 +1,33 @@
+import { buildIndexes } from "../index/build.js";
+import { buildModel } from "../model/build.js";
+import { defaultRules } from "../rules/index.js";
+import { parseTmdl } from "../tmdl/parse.js";
+import { bindConfig, isResolvedConfig, resolveConfig, } from "./config.js";
+import { rank } from "./rank.js";
+import { runRules } from "./run.js";
+/** The one call the web app and the CLI both make. Pure: no I/O, no network. */
+export function lint(files, options = {}) {
+    const rules = options.rules ?? defaultRules;
+    const { config, unknownRules } = bindConfig(isResolvedConfig(options.config) ? options.config : resolveConfig(options.config), rules);
+    const parsed = files.map((f) => parseTmdl(f.path, f.text));
+    const model = buildModel(parsed);
+    const indexes = buildIndexes(model);
+    const run = runRules(model, indexes, rules, config);
+    const groups = rank(run.findings, rules, config);
+    const count = (severity) => groups.filter((g) => g.rule.severity === severity).reduce((n, g) => n + g.findings.length, 0);
+    const summary = {
+        files: files.length,
+        findings: run.findings.length,
+        errors: count(3),
+        warnings: count(2),
+        infos: count(1),
+        rulesRun: run.rulesRun.length,
+        rulesSkipped: run.rulesSkipped,
+        ruleErrors: run.ruleErrors,
+        ignored: run.ignored,
+        unknownRules,
+    };
+    const failed = config.failOn !== null && groups.some((g) => g.rule.severity >= config.failOn);
+    return { model, findings: run.findings, groups, summary, failed };
+}
+//# sourceMappingURL=lint.js.map

package/dist/engine/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/engine/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,GAGd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAoC,MAAM,UAAU,CAAC;AAoCtE,gFAAgF;AAChF,MAAM,UAAU,IAAI,CAAC,KAAiB,EAAE,UAAuB,EAAE;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CACzC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EACjF,KAAK,CACN,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAE,EAAE,CACjC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,OAAO,GAAgB;QAC3B,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM;QAC7B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAChB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAClB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM;QAC7B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY;KACb,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAO,CAAC,CAAC;IAC/F,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACpE,CAAC"}

package/dist/engine/rank.d.ts

@@ -0,0 +1,24 @@
+import { type Category, type Finding, type Rule, type RuleStatus, type Severity } from "../rules/types.js";
+import type { ResolvedConfig } from "./config.js";
+export interface RuleSummary {
+    id: string;
+    name: string;
+    category: Category;
+    /** Effective severity after config overrides. */
+    severity: Severity;
+    slug: string;
+    url: string;
+    status: RuleStatus;
+}
+export interface RankedGroup {
+    rule: RuleSummary;
+    findings: Finding[];
+}
+export declare const effectiveSeverity: (rule: Rule, config: ResolvedConfig) => Severity;
+export declare function summarizeRule(rule: Rule, config: ResolvedConfig): RuleSummary;
+/**
+ * Group findings by rule and order the groups by severity (error first), category priority,
+ * finding count (more first), then rule id. Findings inside a group keep model order.
+ */
+export declare function rank(findings: Finding[], rules: Rule[], config: ResolvedConfig): RankedGroup[];
+//# sourceMappingURL=rank.d.ts.map

package/dist/engine/rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../src/engine/rank.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,GAAI,MAAM,IAAI,EAAE,QAAQ,cAAc,KAAG,QACxB,CAAC;AAEhD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,GAAG,WAAW,CAU7E;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,WAAW,EAAE,CAoB9F"}

package/dist/engine/rank.js

@@ -0,0 +1,38 @@
+import { ruleUrl, slug } from "../model/names.js";
+import { CATEGORY_ORDER, } from "../rules/types.js";
+export const effectiveSeverity = (rule, config) => config.severity.get(rule.id) ?? rule.severity;
+export function summarizeRule(rule, config) {
+    return {
+        id: rule.id,
+        name: rule.name,
+        category: rule.category,
+        severity: effectiveSeverity(rule, config),
+        slug: slug(rule.id),
+        url: ruleUrl(rule.id),
+        status: rule.status,
+    };
+}
+/**
+ * Group findings by rule and order the groups by severity (error first), category priority,
+ * finding count (more first), then rule id. Findings inside a group keep model order.
+ */
+export function rank(findings, rules, config) {
+    const byId = new Map(rules.map((r) => [r.id, r]));
+    const groups = new Map();
+    for (const f of findings) {
+        let g = groups.get(f.ruleId);
+        if (!g) {
+            const rule = byId.get(f.ruleId);
+            if (!rule)
+                throw new Error(`Finding for unknown rule ${f.ruleId}`);
+            g = { rule: summarizeRule(rule, config), findings: [] };
+            groups.set(f.ruleId, g);
+        }
+        g.findings.push(f);
+    }
+    return [...groups.values()].sort((a, b) => b.rule.severity - a.rule.severity ||
+        CATEGORY_ORDER.indexOf(a.rule.category) - CATEGORY_ORDER.indexOf(b.rule.category) ||
+        b.findings.length - a.findings.length ||
+        a.rule.id.localeCompare(b.rule.id));
+}
+//# sourceMappingURL=rank.js.map

package/dist/engine/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../src/engine/rank.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACL,cAAc,GAMf,MAAM,mBAAmB,CAAC;AAmB3B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAU,EAAE,MAAsB,EAAY,EAAE,CAChF,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC;AAEhD,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,MAAsB;IAC9D,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC;QACzC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,QAAmB,EAAE,KAAa,EAAE,MAAsB;IAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ;QACjC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACjF,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM;QACrC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/dist/engine/run.d.ts

@@ -0,0 +1,21 @@
+import type { Indexes } from "../index/build.js";
+import type { Model } from "../model/types.js";
+import type { Finding, Rule } from "../rules/types.js";
+import type { ResolvedConfig } from "./config.js";
+export interface SkippedRule {
+    id: string;
+    reason: "disabled" | "needsLiveModel";
+}
+export interface RuleError {
+    id: string;
+    message: string;
+}
+export interface RunResult {
+    findings: Finding[];
+    rulesRun: string[];
+    rulesSkipped: SkippedRule[];
+    ruleErrors: RuleError[];
+    ignored: number;
+}
+export declare function runRules(model: Model, indexes: Indexes, rules: Rule[], config: ResolvedConfig): RunResult;
+//# sourceMappingURL=run.d.ts.map

package/dist/engine/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/engine/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,cAAc,GACrB,SAAS,CAqCX"}

package/dist/engine/run.js

@@ -0,0 +1,43 @@
+import { isIgnored } from "./ignore.js";
+export function runRules(model, indexes, rules, config) {
+    const result = {
+        findings: [],
+        rulesRun: [],
+        rulesSkipped: [],
+        ruleErrors: [],
+        ignored: 0,
+    };
+    for (const rule of rules) {
+        if (config.disabled.has(rule.id)) {
+            result.rulesSkipped.push({ id: rule.id, reason: "disabled" });
+            continue;
+        }
+        if (rule.status === "needsLiveModel") {
+            result.rulesSkipped.push({ id: rule.id, reason: "needsLiveModel" });
+            continue;
+        }
+        result.rulesRun.push(rule.id);
+        let raw;
+        try {
+            raw = rule.check(model, { indexes });
+        }
+        catch (e) {
+            result.ruleErrors.push({ id: rule.id, message: e instanceof Error ? e.message : String(e) });
+            continue;
+        }
+        for (const f of raw) {
+            if (isIgnored(f.object, rule.id)) {
+                result.ignored++;
+                continue;
+            }
+            const out = { ruleId: rule.id, objectType: f.objectType, objectName: f.objectName };
+            if (f.location)
+                out.location = f.location;
+            if (f.detail !== undefined)
+                out.detail = f.detail;
+            result.findings.push(out);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=run.js.map

package/dist/engine/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/engine/run.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoBxC,MAAM,UAAU,QAAQ,CACtB,KAAY,EACZ,OAAgB,EAChB,KAAa,EACb,MAAsB;IAEtB,MAAM,MAAM,GAAc;QACxB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,CAAC;KACX,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAC9D,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7F,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7F,IAAI,CAAC,CAAC,QAAQ;gBAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;YAC1C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;gBAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YAClD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/format/index.d.ts

@@ -0,0 +1,11 @@
+import type { LintResult } from "../engine/lint.js";
+import { formatJson } from "./json.js";
+import { formatMarkdown } from "./markdown.js";
+import { formatSarif } from "./sarif.js";
+import { formatText, skippedLine, summaryLine, topGroups, type FormatOptions, type RuleHelp } from "./text.js";
+export declare const FORMATS: readonly ["text", "json", "markdown", "sarif"];
+export type FormatName = (typeof FORMATS)[number];
+export declare function formatResult(name: FormatName, result: LintResult, options?: FormatOptions): string;
+export { formatJson, formatMarkdown, formatSarif, formatText, skippedLine, summaryLine, topGroups };
+export type { FormatOptions, RuleHelp };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/format/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,OAAO,gDAAiD,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACpG,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}

package/dist/format/index.js

@@ -0,0 +1,21 @@
+import { formatJson } from "./json.js";
+import { formatMarkdown } from "./markdown.js";
+import { formatSarif } from "./sarif.js";
+import { formatText, skippedLine, summaryLine, topGroups, } from "./text.js";
+export const FORMATS = ["text", "json", "markdown", "sarif"];
+export function formatResult(name, result, options = {}) {
+    switch (name) {
+        case "text":
+            return formatText(result, options);
+        case "json":
+            return formatJson(result, options);
+        case "markdown":
+            return formatMarkdown(result, options);
+        case "sarif":
+            return formatSarif(result, options);
+        default:
+            throw new Error(`Unknown format: ${String(name)}`);
+    }
+}
+export { formatJson, formatMarkdown, formatSarif, formatText, skippedLine, summaryLine, topGroups };
+//# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/format/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,GAGV,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAGtE,MAAM,UAAU,YAAY,CAC1B,IAAgB,EAChB,MAAkB,EAClB,UAAyB,EAAE;IAE3B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC"}

package/dist/format/json.d.ts

@@ -0,0 +1,4 @@
+import type { LintResult } from "../engine/lint.js";
+import type { FormatOptions } from "./text.js";
+export declare function formatJson(result: LintResult, options?: FormatOptions): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/format/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/format/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAiBlF"}

package/dist/format/json.js

@@ -0,0 +1,20 @@
+import { VERSION } from "../version.js";
+export function formatJson(result, options = {}) {
+    const doc = {
+        version: 1,
+        tool: { name: "pbiplint", version: options.toolVersion ?? VERSION },
+        summary: result.summary,
+        groups: result.groups.map((g) => ({
+            rule: g.rule,
+            count: g.findings.length,
+            findings: g.findings.map((f) => ({
+                objectType: f.objectType,
+                objectName: f.objectName,
+                ...(f.location ? { file: f.location.file, line: f.location.line } : {}),
+                ...(f.detail !== undefined ? { detail: f.detail } : {}),
+            })),
+        })),
+    };
+    return JSON.stringify(doc, null, 2) + "\n";
+}
+//# sourceMappingURL=json.js.map

package/dist/format/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/format/json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,UAAyB,EAAE;IACxE,MAAM,GAAG,GAAG;QACV,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,OAAO,EAAE;QACnE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC7C,CAAC"}

package/dist/format/markdown.d.ts

@@ -0,0 +1,4 @@
+import type { LintResult } from "../engine/lint.js";
+import { type FormatOptions } from "./text.js";
+export declare function formatMarkdown(result: LintResult, _options?: FormatOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/format/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/format/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAmD,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAIhG,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAE,aAAkB,GAAG,MAAM,CA8BvF"}

package/dist/format/markdown.js

@@ -0,0 +1,28 @@
+import { SEVERITY_LABEL } from "../rules/types.js";
+import { locationOf, skippedLine, summaryLine, topGroups } from "./text.js";
+const cell = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
+export function formatMarkdown(result, _options = {}) {
+    const out = [
+        "# pbiplint report",
+        "",
+        `${summaryLine(result)}. ${skippedLine(result)}.`,
+        "",
+    ];
+    if (result.groups.length === 0) {
+        out.push("No findings.", "");
+        return out.join("\n");
+    }
+    out.push("## Fix these first", "");
+    topGroups(result).forEach((g, i) => out.push(`${i + 1}. **${g.rule.name}** (${g.findings.length}) [${g.rule.id}](${g.rule.url})`));
+    out.push("");
+    for (const g of result.groups) {
+        out.push(`## ${SEVERITY_LABEL[g.rule.severity].toUpperCase()}: ${g.rule.name} (${g.findings.length})`, "");
+        out.push(`[${g.rule.id}](${g.rule.url}) · ${g.rule.category}`, "");
+        out.push("| Object | Type | Location | Detail |", "|---|---|---|---|");
+        for (const f of g.findings)
+            out.push(`| \`${cell(f.objectName)}\` | ${f.objectType} | ${locationOf(f)} | ${cell(f.detail ?? "")} |`);
+        out.push("");
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=markdown.js.map

package/dist/format/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/format/markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAsB,MAAM,WAAW,CAAC;AAEhG,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAEhF,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,WAA0B,EAAE;IAC7E,MAAM,GAAG,GAAa;QACpB,mBAAmB;QACnB,EAAE;QACF,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,GAAG;QACjD,EAAE;KACH,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACnC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAC9F,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CACN,MAAM,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,EAC5F,EAAE,CACH,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,uCAAuC,EAAE,mBAAmB,CAAC,CAAC;QACvE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;YACxB,GAAG,CAAC,IAAI,CACN,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,MAAM,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,CAC/F,CAAC;QACJ,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/format/sarif.d.ts

@@ -0,0 +1,4 @@
+import type { LintResult } from "../engine/lint.js";
+import type { FormatOptions } from "./text.js";
+export declare function formatSarif(result: LintResult, options?: FormatOptions): string;
+//# sourceMappingURL=sarif.d.ts.map

package/dist/format/sarif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/format/sarif.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,WAAW,CAAC;AAWzD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAqEnF"}