chaffjs 0.19.0 → 0.20.0

package/dist/grade/rates.js

@@ -0,0 +1,26 @@
+import { lengthOf } from "../measure.js";
+import { tally } from "./order.js";
+/** Rates are findings per this many units, so a short and a long output are measured alike. */
+const RATE_BASE = 1000;
+const RATE_DECIMALS = 1;
+export const sizeOf = (doc) => ({
+    unit: doc.lengthUnit,
+    value: doc.sentences.reduce((sum, sentence) => sum + lengthOf(sentence, doc.lengthUnit), 0),
+});
+const rounded = (value) => {
+    const scale = 10 ** RATE_DECIMALS;
+    return Math.round(value * scale) / scale;
+};
+/** Findings per RATE_BASE units, unrounded: a limit is checked against this, so a rate just over it never rounds down to it. */
+export const exactRateOf = (count, size) => (size > 0 ? (count * RATE_BASE) / size : undefined);
+/** Findings per RATE_BASE units, rounded to show. Undefined for an output with no length: a rate over nothing is not zero. */
+export const rateOf = (count, size) => {
+    const exact = exactRateOf(count, size);
+    return exact === undefined ? undefined : rounded(exact);
+};
+/** Each rule's rate over one output. An output with no length gets none, its findings still listed. */
+export const ratesOf = (rules, size) => Object.fromEntries(Object.entries(tally(rules)).flatMap(([rule, count]) => {
+    const rate = rateOf(count, size.value);
+    return rate === undefined ? [] : [[rule, rate]];
+}));
+//# sourceMappingURL=rates.js.map

package/dist/grade/rates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.js","sourceRoot":"","sources":["../../src/grade/rates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMnC,+FAA+F;AAC/F,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAoD,EAAc,EAAE,CAAC,CAAC;IAC3F,IAAI,EAAE,GAAG,CAAC,UAAU;IACpB,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE;IACxC,MAAM,KAAK,GAAG,EAAE,IAAI,aAAa,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AAC3C,CAAC,CAAC;AAEF,gIAAgI;AAChI,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,IAAY,EAAsB,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAEpI,8HAA8H;AAC9H,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,IAAY,EAAsB,EAAE;IACxE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,uGAAuG;AACvG,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAwB,EAAE,IAAgB,EAA0B,EAAE,CAC5F,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CACH,CAAC"}

package/dist/grade/render-baseline.d.ts

@@ -0,0 +1,7 @@
+import type { Comparison } from "./baseline.ts";
+import type { BaselineText } from "./baseline-text.ts";
+/** For a person: what was paired, how each rule moved and where, what newly failed or passed, new facts, and the verdict. */
+export declare const renderComparison: (path: string, comparison: Comparison, text: BaselineText) => string;
+/** For a CI log: one line per regression, then the verdict. */
+export declare const renderComparisonCompact: (comparison: Comparison, text: BaselineText) => string;
+//# sourceMappingURL=render-baseline.d.ts.map

package/dist/grade/render-baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-baseline.d.ts","sourceRoot":"","sources":["../../src/grade/render-baseline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAiDvD,6HAA6H;AAC7H,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,YAAY,UAAU,EAAE,MAAM,YAAY,KAAG,MAc9E,CAAC;AAEf,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,GAAI,YAAY,UAAU,EAAE,MAAM,YAAY,KAAG,MAIvE,CAAC"}

package/dist/grade/render-baseline.js

@@ -0,0 +1,44 @@
+import { block } from "./render.js";
+const UNITS = ["word", "char"];
+const listed = (ids, text) => (ids.length === 0 ? text.none : ids.join(", "));
+const signed = (value) => `${value > 0 ? "+" : ""}${value.toFixed(1)}`;
+const movementLine = (movement, width, text) => [
+    `  ${movement.rule.padEnd(width)}  ${movement.before.toFixed(1)} → ${movement.after.toFixed(1)}  (${signed(movement.after - movement.before)})`,
+    ...(movement.increasedIn.length === 0 ? [] : [text.more(movement.increasedIn.join(", "))]),
+    ...(movement.decreasedIn.length === 0 ? [] : [text.fewer(movement.decreasedIn.join(", "))]),
+    ...(movement.inRubric ? [text.inRubric] : []),
+].join("  ");
+const movementBlocks = (comparison, text) => UNITS.flatMap((unit) => {
+    const movements = comparison.rules.filter((movement) => movement.unit === unit);
+    const width = movements.reduce((widest, movement) => Math.max(widest, movement.rule.length), 0);
+    return block(text.ratesHeading(text.unit[unit]), movements.map((movement) => movementLine(movement, width, text)));
+});
+const factsOf = (facts, text) => facts.length === 0 ? text.none : facts.map((fact) => `${fact.kind} ${fact.text}`).join(", ");
+const itemLine = (change, text) => [
+    `  ${change.id}: ${text.droppedAdded(factsOf(change.dropped, text), factsOf(change.added, text))}`,
+    ...(change.citations.length === 0 ? [] : [text.newCitations(change.citations.map((citation) => `${citation.source} ${citation.address}`).join(", "))]),
+].join(text.separator);
+const unpairedLines = (comparison, text) => comparison.onlyBefore.length + comparison.onlyAfter.length + comparison.readOtherwise.length === 0
+    ? []
+    : [text.unpaired(listed(comparison.onlyBefore, text), listed(comparison.onlyAfter, text), listed(comparison.readOtherwise, text))];
+const regressionLines = (comparison, text) => comparison.regressions.length === 0
+    ? ["", text.noRegression]
+    : block(text.regressionsHeading(comparison.regressions.length), comparison.regressions.map((reason) => `  ✗ ${reason}`));
+/** For a person: what was paired, how each rule moved and where, what newly failed or passed, new facts, and the verdict. */
+export const renderComparison = (path, comparison, text) => [
+    text.heading(path, comparison.paired),
+    ...unpairedLines(comparison, text),
+    ...movementBlocks(comparison, text),
+    "",
+    text.newlyFailed(listed(comparison.newlyFailed, text)),
+    text.newlyPassed(listed(comparison.newlyPassed, text)),
+    ...(comparison.penalty === undefined ? [] : [text.penalty(comparison.penalty.before, comparison.penalty.after)]),
+    ...block(text.newFactsHeading, comparison.items.map((change) => itemLine(change, text))),
+    ...regressionLines(comparison, text),
+].join("\n");
+/** For a CI log: one line per regression, then the verdict. */
+export const renderComparisonCompact = (comparison, text) => [
+    ...comparison.regressions.map((reason) => `regression\t${reason}`),
+    comparison.regressions.length === 0 ? text.noRegression : text.regressionsHeading(comparison.regressions.length),
+].join("\n");
+//# sourceMappingURL=render-baseline.js.map

package/dist/grade/render-baseline.js.map

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

package/dist/grade/render-markdown.d.ts

@@ -0,0 +1,15 @@
+import type { Comparison } from "./baseline.ts";
+import type { GradeSummary } from "./summary.ts";
+import type { GradeText } from "./text.ts";
+import type { VariantComparison } from "./variants.ts";
+import type { VariantText } from "./variants-text.ts";
+export type MarkdownTexts = {
+    readonly grade: GradeText;
+    readonly variants: VariantText;
+};
+/** The totals, the failed outputs, the variants side by side (or the rates when there are none), the regressions, and the stamp. */
+export declare const renderMarkdown: (path: string, summary: GradeSummary, compared: {
+    readonly variants?: VariantComparison | undefined;
+    readonly baseline?: Comparison | undefined;
+}, texts: MarkdownTexts) => string;
+//# sourceMappingURL=render-markdown.d.ts.map

package/dist/grade/render-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-markdown.d.ts","sourceRoot":"","sources":["../../src/grade/render-markdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AA4B1F,oIAAoI;AACpI,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,SAAS,YAAY,EACrB,UAAU;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;CAAE,EAC3G,OAAO,aAAa,KACnB,MAaW,CAAC"}

package/dist/grade/render-markdown.js

@@ -0,0 +1,41 @@
+import { factsLine } from "./render.js";
+import { resultName } from "./result-name.js";
+import { markdownTable, renderVariantsMarkdown } from "./render-variants.js";
+// `chaff grade --format markdown`: a run's summary as a pull request comment. The same numbers as the screen.
+const UNITS = ["word", "char"];
+/** One rate table per unit, as on the screen: a rate per 1,000 characters and one per 1,000 words are not on one scale. */
+const rateTables = (summary, text) => UNITS.flatMap((unit) => {
+    const rows = Object.entries(summary.rules).flatMap(([rule, entry]) => {
+        const rate = entry.rate[unit];
+        return rate === undefined ? [] : [[rule, rate.toFixed(1), text.outputsWith(entry.outputs)]];
+    });
+    return rows.length === 0 ? [] : ["", `**${text.ratesHeading(text.unit[unit])}**`, "", ...markdownTable([["", "", ""], ...rows])];
+});
+const failedLines = (summary, text) => summary.failed.length === 0
+    ? []
+    : ["", `**${text.failedHeading}**`, "", ...summary.failed.map((entry) => `- \`${resultName(entry)}\`: ${entry.failedBecause.join(", ")}`)];
+const baselineLines = (comparison, text) => {
+    if (comparison === undefined)
+        return [];
+    if (comparison.regressions.length === 0)
+        return ["", text.noRegression];
+    return ["", `**${text.regressionsHeading(comparison.regressions.length)}**`, "", ...comparison.regressions.map((reason) => `- ${reason}`)];
+};
+const stampLine = (summary, text) => summary.stamp === undefined
+    ? []
+    : ["", `<sub>${text.stamp}: ${summary.stamp.chaff} · rules ${summary.stamp.rules} · settings ${summary.stamp.settings}</sub>`];
+/** The totals, the failed outputs, the variants side by side (or the rates when there are none), the regressions, and the stamp. */
+export const renderMarkdown = (path, summary, compared, texts) => [
+    `## ${texts.variants.runHeading(path)}`,
+    "",
+    texts.variants.totals(summary.total, summary.passed),
+    ...failedLines(summary, texts.variants),
+    ...(compared.variants === undefined ? rateTables(summary, texts.grade) : ["", renderVariantsMarkdown(compared.variants, texts.variants)]),
+    "",
+    factsLine(summary, texts.grade),
+    "",
+    texts.grade.citations(summary.citations.checked, summary.citations.failed),
+    ...baselineLines(compared.baseline, texts.variants),
+    ...stampLine(summary, texts.variants),
+].join("\n");
+//# sourceMappingURL=render-markdown.js.map

package/dist/grade/render-markdown.js.map

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

package/dist/grade/render-variants.d.ts

@@ -0,0 +1,12 @@
+import type { VariantComparison } from "./variants.ts";
+import type { VariantText } from "./variants-text.ts";
+type Rows = readonly (readonly string[])[];
+/** For a person: the measures side by side, the rates, where pass or fail differs, and what could not be compared. */
+export declare const renderVariants: (comparison: VariantComparison, text: VariantText) => string;
+/** For a CI log: one line per output where pass or fail differs, then the count. */
+export declare const renderVariantsCompact: (comparison: VariantComparison, text: VariantText) => string;
+export declare const markdownTable: (rows: Rows) => string[];
+/** For a pull request comment: the same measures and rates as Markdown tables, and where pass or fail differs. */
+export declare const renderVariantsMarkdown: (comparison: VariantComparison, text: VariantText) => string;
+export {};
+//# sourceMappingURL=render-variants.d.ts.map

package/dist/grade/render-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-variants.d.ts","sourceRoot":"","sources":["../../src/grade/render-variants.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA+B,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD,KAAK,IAAI,GAAG,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;AA+C3C,sHAAsH;AACtH,eAAO,MAAM,cAAc,GAAI,YAAY,iBAAiB,EAAE,MAAM,WAAW,KAAG,MAapE,CAAC;AAEf,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,GAAI,YAAY,iBAAiB,EAAE,MAAM,WAAW,KAAG,MAM3E,CAAC;AAKf,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,MAAM,EAKhD,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,sBAAsB,GAAI,YAAY,iBAAiB,EAAE,MAAM,WAAW,KAAG,MAoB5E,CAAC"}

package/dist/grade/render-variants.js

@@ -0,0 +1,80 @@
+import { widthOf } from "../render/rules-table.js";
+import { block, table } from "./render.js";
+// The variant comparison for a person (a screen table), for a CI log (one line per disagreement), and for a pull request
+// comment (Markdown tables). Every form is built from the same rows, so they never say different things.
+const UNITS = ["word", "char"];
+const passedCell = (column, text) => text.passedCell(column.passed, column.outputs, column.passRate === undefined ? "–" : `${String(column.passRate)}%`);
+/** The header and one row per measure, a column per variant. */
+const measureRows = (comparison, text) => {
+    const { columns } = comparison;
+    const scored = columns.some((column) => column.penalty !== undefined);
+    const grounded = columns.some((column) => column.contexts !== undefined);
+    return [
+        ["", ...comparison.variants],
+        [text.passed, ...columns.map((column) => passedCell(column, text))],
+        [text.factsDropped, ...columns.map((column) => String(column.facts.dropped))],
+        [text.factsAdded, ...columns.map((column) => String(column.facts.added))],
+        [text.citationsFailed, ...columns.map((column) => text.citationsCell(column.citations.failed, column.citations.checked))],
+        ...(grounded
+            ? [[text.unsupportedFacts, ...columns.map((column) => text.citationsCell(column.contexts?.unsupported ?? 0, column.contexts?.checked ?? 0))]]
+            : []),
+        ...(scored ? [[text.penalty, ...columns.map((column) => String(column.penalty ?? 0))]] : []),
+    ];
+};
+/** Each rule's rate in each variant, for one unit; empty when no rule fired in that unit. */
+const rateRowsOf = (comparison, unit) => comparison.rules.filter((row) => row.unit === unit).map((row) => [row.rule, ...comparison.variants.map((variant) => (row.rates[variant] ?? 0).toFixed(1))]);
+const disagreementLine = (entry, text) => text.disagreement(entry.id, entry.passedIn.join(", "), entry.failedIn.map((failed) => text.failedIn(failed.variant, failed.failedBecause.join(", "))).join(text.separator));
+const notComparedLines = (comparison, text) => [
+    ...comparison.missing.map((entry) => text.missing(entry.id, entry.missingFrom.join(", "))),
+    ...(comparison.readOtherwise.length === 0 ? [] : [text.readOtherwise(comparison.readOtherwise.join(", "))]),
+];
+const disagreementBlock = (comparison, text, bullet) => comparison.disagreements.length === 0
+    ? ["", text.noDisagreement]
+    : block(text.disagreeHeading(comparison.disagreements.length), comparison.disagreements.map((entry) => `${bullet}${disagreementLine(entry, text)}`));
+/** For a person: the measures side by side, the rates, where pass or fail differs, and what could not be compared. */
+export const renderVariants = (comparison, text) => [
+    text.heading(comparison.compared.length, comparison.variants.length),
+    ...table(measureRows(comparison, text), widthOf),
+    ...UNITS.flatMap((unit) => {
+        const rows = rateRowsOf(comparison, unit);
+        return rows.length === 0 ? [] : block(text.ratesHeading(text.unit[unit]), table([["", ...comparison.variants], ...rows], widthOf));
+    }),
+    ...disagreementBlock(comparison, text, "  ✗ "),
+    ...block(text.notComparedHeading, notComparedLines(comparison, text).map((line) => `  ${line}`)),
+].join("\n");
+/** For a CI log: one line per output where pass or fail differs, then the count. */
+export const renderVariantsCompact = (comparison, text) => [
+    ...comparison.disagreements.map((entry) => `disagree\t${entry.id}\tpass ${entry.passedIn.join(",")}\tfail ${entry.failedIn.map((failed) => failed.variant).join(",")}`),
+    comparison.disagreements.length === 0 ? text.noDisagreement : text.disagreeHeading(comparison.disagreements.length),
+].join("\n");
+/** A table cell: a pipe would end the cell, and a line break the row. */
+const cell = (value) => value.replaceAll("|", "\\|").replaceAll(/\r?\n/gu, " ");
+export const markdownTable = (rows) => {
+    const [header, ...body] = rows;
+    if (header === undefined)
+        return [];
+    const line = (cells) => `| ${cells.map(cell).join(" | ")} |`;
+    return [line(header), line(header.map(() => "---")), ...body.map(line)];
+};
+/** For a pull request comment: the same measures and rates as Markdown tables, and where pass or fail differs. */
+export const renderVariantsMarkdown = (comparison, text) => [
+    `### ${text.heading(comparison.compared.length, comparison.variants.length)}`,
+    "",
+    ...markdownTable(measureRows(comparison, text)),
+    ...UNITS.flatMap((unit) => {
+        const rows = rateRowsOf(comparison, unit);
+        return rows.length === 0 ? [] : ["", `**${text.ratesHeading(text.unit[unit])}**`, "", ...markdownTable([["", ...comparison.variants], ...rows])];
+    }),
+    ...(comparison.disagreements.length === 0
+        ? ["", text.noDisagreement]
+        : [
+            "",
+            `**${text.disagreeHeading(comparison.disagreements.length)}**`,
+            "",
+            ...comparison.disagreements.map((entry) => `- ${disagreementLine(entry, text)}`),
+        ]),
+    ...(notComparedLines(comparison, text).length === 0
+        ? []
+        : ["", `**${text.notComparedHeading}**`, "", ...notComparedLines(comparison, text).map((line) => `- ${line}`)]),
+].join("\n");
+//# sourceMappingURL=render-variants.js.map

package/dist/grade/render-variants.js.map

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

package/dist/grade/render.d.ts

@@ -0,0 +1,14 @@
+import type { GradeResult } from "./result.ts";
+import type { GradeSummary } from "./summary.ts";
+import type { GradeText } from "./text.ts";
+export declare const block: (heading: string, lines: readonly string[]) => string[];
+type Measure = (cell: string) => number;
+/** Columns as wide as their widest cell, each cell measured by `measure`. */
+export declare const table: (rows: readonly (readonly string[])[], measure?: Measure) => string[];
+export declare const factsLine: (summary: GradeSummary, text: GradeText) => string;
+/** For a person: the totals, each failed output with why, the rates, facts and quotations, what did not run, and the stamp. */
+export declare const renderSummary: (path: string, summary: GradeSummary, text: GradeText) => string;
+/** For grep and a CI log: one line per output, its id, pass or fail and why, then the totals. */
+export declare const renderCompact: (path: string, results: readonly GradeResult[], summary: GradeSummary, text: GradeText) => string;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/grade/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/grade/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAI3C,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EAAE,KAAG,MAAM,EAAyD,CAAC;AAElI,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AASxC,6EAA6E;AAC7E,eAAO,MAAM,KAAK,GAAI,MAAM,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EAAE,UAAS,OAAsB,KAAG,MAAM,EAGnG,CAAC;AAmBF,eAAO,MAAM,SAAS,GAAI,SAAS,YAAY,EAAE,MAAM,SAAS,KAAG,MACiE,CAAC;AAUrI,+HAA+H;AAC/H,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,SAAS,YAAY,EAAE,MAAM,SAAS,KAAG,MAevE,CAAC;AAEf,iGAAiG;AACjG,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,SAAS,SAAS,WAAW,EAAE,EAAE,SAAS,YAAY,EAAE,MAAM,SAAS,KAAG,MAWxG,CAAC"}

package/dist/grade/render.js

@@ -0,0 +1,52 @@
+import { resultName } from "./result-name.js";
+const UNITS = ["word", "char"];
+export const block = (heading, lines) => (lines.length === 0 ? [] : ["", heading, ...lines]);
+const lengthOfCell = (cell) => cell.length;
+const padCell = (cell, width, measure) => cell + " ".repeat(Math.max(0, width - measure(cell)));
+const padded = (cells, widths, measure) => `  ${cells.map((cell, index) => padCell(cell, widths[index] ?? 0, measure)).join("  ")}`.trimEnd();
+/** Columns as wide as their widest cell, each cell measured by `measure`. */
+export const table = (rows, measure = lengthOfCell) => {
+    const widths = rows.reduce((max, row) => row.map((cell, index) => Math.max(max[index] ?? 0, measure(cell))), []);
+    return rows.map((row) => padded(row, widths, measure));
+};
+/** One table per unit: a rate per 1,000 characters and one per 1,000 words are not on one scale. */
+const rateBlocks = (summary, text) => UNITS.flatMap((unit) => {
+    const rows = Object.entries(summary.rules).flatMap(([rule, entry]) => {
+        const rate = entry.rate[unit];
+        return rate === undefined ? [] : [[rule, rate.toFixed(1), text.outputsWith(entry.outputs)]];
+    });
+    return block(text.ratesHeading(text.unit[unit]), table(rows));
+});
+const kindsLine = (counts) => Object.entries(counts)
+    .map(([kind, count]) => `${kind} ${String(count)}`)
+    .join(", ");
+const sum = (counts) => Object.values(counts).reduce((total, count) => total + count, 0);
+export const factsLine = (summary, text) => text.facts(sum(summary.facts.dropped), sum(summary.facts.added), kindsLine(summary.facts.dropped), kindsLine(summary.facts.added));
+const contextsLine = (summary, text) => summary.contexts === undefined
+    ? []
+    : [text.contexts(summary.contexts.outputs, summary.contexts.checked, sum(summary.contexts.unsupported), kindsLine(summary.contexts.unsupported))];
+const stampLines = (summary, text) => summary.stamp === undefined ? [] : ["", `${text.stamp}: ${summary.stamp.chaff}`, `  rules ${summary.stamp.rules}`, `  settings ${summary.stamp.settings}`];
+/** For a person: the totals, each failed output with why, the rates, facts and quotations, what did not run, and the stamp. */
+export const renderSummary = (path, summary, text) => [
+    text.totals(path, summary.total, summary.passed),
+    ...block(text.failedHeading, summary.failed.map((entry) => `  ✗ ${resultName(entry)}: ${entry.failedBecause.join(", ")}`)),
+    ...rateBlocks(summary, text),
+    "",
+    factsLine(summary, text),
+    text.citations(summary.citations.checked, summary.citations.failed),
+    ...contextsLine(summary, text),
+    ...(summary.penalty === undefined ? [] : [text.penalty(summary.penalty)]),
+    ...block(text.notRunHeading(summary.notRun.length), table(summary.notRun.map((entry) => [entry.rule, text.inOutputs(entry.outputs), entry.reason]))),
+    ...stampLines(summary, text),
+].join("\n");
+/** For grep and a CI log: one line per output, its id, pass or fail and why, then the totals. */
+export const renderCompact = (path, results, summary, text) => [
+    ...results.map((result) => [
+        resultName(result),
+        result.pass ? "pass" : "fail",
+        ...(result.score === undefined ? [] : [`penalty ${String(result.score.penalty)}`]),
+        ...(result.pass ? [] : [result.failedBecause.join(", ")]),
+    ].join("\t")),
+    text.totals(path, summary.total, summary.passed),
+].join("\n");
+//# sourceMappingURL=render.js.map

package/dist/grade/render.js.map

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

package/dist/grade/result-name.d.ts

@@ -0,0 +1,7 @@
+import type { GradeResult } from "./result.ts";
+/** The same task: an id within its variant. Two variants' outputs for one id are different outputs of one task. */
+/** A JSON pair, so no character a label or id may hold can make two pairs one key. */
+export declare const resultKey: (result: Pick<GradeResult, "id" | "variant">) => string;
+/** An output as a person reads its name: the id, and its variant when it has one. */
+export declare const resultName: (result: Pick<GradeResult, "id" | "variant">) => string;
+//# sourceMappingURL=result-name.d.ts.map

package/dist/grade/result-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-name.d.ts","sourceRoot":"","sources":["../../src/grade/result-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,mHAAmH;AACnH,sFAAsF;AACtF,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC,KAAG,MAA6D,CAAC;AAEtI,qFAAqF;AACrF,eAAO,MAAM,UAAU,GAAI,QAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC,KAAG,MACM,CAAC"}

package/dist/grade/result-name.js

@@ -0,0 +1,6 @@
+/** The same task: an id within its variant. Two variants' outputs for one id are different outputs of one task. */
+/** A JSON pair, so no character a label or id may hold can make two pairs one key. */
+export const resultKey = (result) => JSON.stringify([result.variant ?? null, result.id]);
+/** An output as a person reads its name: the id, and its variant when it has one. */
+export const resultName = (result) => result.variant === undefined ? result.id : `${result.id} (${result.variant})`;
+//# sourceMappingURL=result-name.js.map

package/dist/grade/result-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-name.js","sourceRoot":"","sources":["../../src/grade/result-name.ts"],"names":[],"mappings":"AAEA,mHAAmH;AACnH,sFAAsF;AACtF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAA2C,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAEtI,qFAAqF;AACrF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAA2C,EAAU,EAAE,CAChF,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,GAAG,CAAC"}

package/dist/grade/result.d.ts

@@ -0,0 +1,101 @@
+import type { AtomKind } from "../compare/atom.ts";
+import type { CitationStatus } from "../structure/cite.ts";
+import type { Severity } from "../plugin.ts";
+import type { OutputSize } from "./rates.ts";
+export type GradeFinding = {
+    readonly rule: string;
+    readonly level: Severity;
+    readonly line: number;
+    readonly column: number;
+    readonly message: string;
+};
+/** A dropped or added fact, as `compare --json` writes it. */
+export type GradeFact = {
+    readonly kind: AtomKind;
+    readonly key: string;
+    readonly text: string;
+    readonly line: number;
+    readonly allowed: boolean;
+};
+/** `compare`'s outcome against the item's reference. */
+export type GradeFacts = {
+    readonly dropped: readonly GradeFact[];
+    readonly added: readonly GradeFact[];
+    readonly reformed: number;
+};
+export type FailedCitation = {
+    readonly source: string;
+    readonly address: string;
+    readonly quote: string;
+    readonly status: Exclude<CitationStatus, "ok">;
+    readonly foundAt?: string | undefined;
+    readonly line?: number | undefined;
+};
+export type GradeCitations = {
+    readonly checked: number;
+    readonly failed: readonly FailedCitation[];
+};
+/** A fact of the output that a retrieved passage states, and the first passage (0-based) that does. */
+export type SupportedFact = {
+    readonly kind: AtomKind;
+    readonly text: string;
+    readonly line: number;
+    readonly passage: number;
+};
+/** The output's checkable facts against the item's retrieved passages (`contexts`). */
+export type GradeContexts = {
+    readonly passages: number;
+    /** Facts of the kinds checked against the passages: numbers, dates, times, URLs, code, names and quotations. */
+    readonly checked: number;
+    readonly supported: readonly SupportedFact[];
+    /** Facts no passage states; a quotation not found word for word in any passage. */
+    readonly unsupported: readonly GradeFact[];
+    /** Sentences that state no checkable fact: whether a passage supports them needs reading, which chaff does not do. */
+    readonly uncheckedSentences: number;
+};
+/** A rule, or a check (`compare`, `cite`), that did not run on this output, and why. */
+export type NotRunEntry = {
+    readonly rule: string;
+    readonly reason: string;
+};
+/** What makes two results comparable (spec §29.7): the same rules and settings. */
+export type Stamp = {
+    readonly chaff: string;
+    readonly rules: string;
+    readonly settings: string;
+};
+/** One finding's penalty points, so every point names the finding it came from. */
+export type ScoreItem = {
+    readonly points: number;
+    readonly rule: string;
+    readonly line: number;
+};
+/** The penalty sum under a `grade:` rubric (spec §29.4). Never a score out of a maximum. */
+export type GradeScore = {
+    readonly penalty: number;
+    readonly items: readonly ScoreItem[];
+};
+export type GradeResult = {
+    readonly id: string;
+    /** The item's variant label, when it had one. */
+    readonly variant?: string | undefined;
+    readonly language: string;
+    readonly genre: string;
+    readonly size: OutputSize;
+    readonly findings: readonly GradeFinding[];
+    readonly rates: Readonly<Record<string, number>>;
+    readonly notRun: readonly NotRunEntry[];
+    /** Null when the item had no reference. */
+    readonly facts: GradeFacts | null;
+    /** Null when the item gave no citations. */
+    readonly citations: GradeCitations | null;
+    /** Only when the item gave contexts, so results of items without them keep their shape. */
+    readonly contexts?: GradeContexts | undefined;
+    /** Only with a `grade:` rubric. */
+    readonly score?: GradeScore | undefined;
+    readonly pass: boolean;
+    /** Each condition the output failed, with how far: `facts.dropped 3 > 0`. */
+    readonly failedBecause: readonly string[];
+    readonly stamp: Stamp;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/grade/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/grade/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnJ,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErI,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC;AAEtG,uGAAuG;AACvG,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhI,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gHAAgH;IAChH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,sHAAsH;IACtH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,mFAAmF;AACnF,MAAM,MAAM,KAAK,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,4FAA4F;AAC5F,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,CAAC"}

package/dist/grade/result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=result.js.map

package/dist/grade/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/grade/result.ts"],"names":[],"mappings":""}

package/dist/grade/results-read.d.ts

@@ -0,0 +1,10 @@
+import type { GradeResult } from "./result.ts";
+/** A line `--out` writes, every field checked: a line that only looks like one would be compared as if it had been graded. */
+export declare const isGradeResult: (value: unknown) => value is GradeResult;
+/** Every result line, or the line numbers that are not one (or repeat an id). No result at all is not a baseline. */
+export declare const parseResults: (text: string) => {
+    readonly results: readonly GradeResult[];
+} | {
+    readonly badLines: readonly number[];
+};
+//# sourceMappingURL=results-read.d.ts.map

package/dist/grade/results-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results-read.d.ts","sourceRoot":"","sources":["../../src/grade/results-read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA4D/C,8HAA8H;AAC9H,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAe/B,CAAC;AAqB1B,qHAAqH;AACrH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAWhI,CAAC"}