@chartguard/quality-core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChartGuard contributors
+
+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

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# @chartguard/quality-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Library-neutral chart semantics and the advisory quality rules that read them. The adapters (`@chartguard/quality-chartjs`, `-echarts`, `-highcharts`) turn a config into `ChartSemantics`; `review(chart, options?)` returns a `QualityReport`: findings only, never a verdict, never an error.
+
+**Status:** pre-release (0.x). Coverage is partial, and the API and settings may still change between minor versions.
+
+```sh
+npm install @chartguard/quality-core
+```
+
+## Facts
+
+Every fact is one of:
+
+- **known from the config**, with the path it was read from;
+- **the runtime's default**, with a pointer to the line of the pinned package that applies it (`<package>@<version> <file>:<line> <text>`; a text that is not distinctive in that file names its context, ` [in TitleModel.defaultOption]` or ` [after …]`, and a test checks it names exactly one line);
+- **declared by the caller** (`context`), for a fact the chart leaves to the page;
+- **unknown**, with its reason: `unset`, `accessor`, `dynamic`, `shape`, `unmodelled`, `inapplicable`, `layout` (it depends on the size the chart is drawn at) or `page` (the chart leaves it to the page it is shown in).
+
+Rules claim nothing on an unknown fact. Rules about an author's choice fire only on facts from the config.
+
+## Rule catalog
+
+`RULE_CATALOG` lists every rule with its rationale, its sources and its documented limits.
+
+| Rule | Code | Severity | Reports |
+| --- | --- | --- | --- |
+| `bar-baseline` | `VIS_BAR_BASELINE` | warning | bars that do not grow from zero: a configured range that excludes it (a minimum above it, a maximum below it, or the data minimum), a range fitted to the data that leaves it out at every chart size (Chart.js `beginAtZero: false`, ECharts `scale: true`), or a base other than zero (Chart.js `base`, ECharts `startValue`, Highcharts `threshold`) |
+| `bar-log-scale` | `VIS_BAR_LOG_SCALE` | warning | bars on a logarithmic value axis |
+| `reversed-value-axis` | `VIS_REVERSED_VALUE_AXIS` | warning | a value axis the config reverses |
+| `dual-axis` | `VIS_DUAL_AXIS` | info | series of one orientation measured on two value axes |
+| `pie-negative` | `VIS_PIE_NEGATIVE` | warning | a negative value in a pie series (drawn as a positive slice or left out) |
+| `same-color-series` | `VIS_SAME_COLOR_SERIES` | warning | two cartesian series drawn in the same colour (a repeated colour, Chart.js's default grey, a wrapped palette) |
+| `low-contrast-series` | `VIS_LOW_CONTRAST_SERIES` | info | a cartesian series below 3:1 against a known background, in each colour scheme the chart can show |
+| `placeholder-text` | `VIS_PLACEHOLDER_TEXT` | warning | a chart or value-axis title drawn with the library's placeholder text (Highcharts "Chart title", "Values") |
+| `legend-placeholder` | `VIS_LEGEND_PLACEHOLDER` | warning | a series without a name whose legend entry is drawn with the library's placeholder (Highcharts "Series 1", Chart.js "undefined") |
+| `value-axis-untitled` | `VIS_VALUE_AXIS_UNTITLED` | info | a value axis whose title, and the chart's, are known to show nothing |
+| `data-not-described` | `VIS_DATA_NOT_DESCRIBED` | warning | assistive technology gets no description of the data (ECharts without `aria`, Highcharts with accessibility off) |
+| `keyboard-disabled` | `VIS_KEYBOARD_DISABLED` | warning | the config turns keyboard navigation off |
+| `long-motion` | `VIS_LONG_MOTION` | warning | motion that starts by itself and runs forever (a looping animation, a ripple effect) or longer than five seconds |
+| `empty-title` | `VIS_EMPTY_TITLE` | info | a title the config sets to blank text, unless it is known to be hidden |
+| `percent-without-unit` | `VIS_PERCENT_WITHOUT_UNIT` | info | a percent-stacked value axis whose tick labels and title show no `%` |
+
+## Fixes
+
+The adapters' `analyze` attaches a `set-option` fix to a finding only when the fix is trustworthy:
+
+- **The config decides it:** the fix sets the option the finding names, to a value decided from what the option holds.
+- **It is verified:** applied and reviewed again, the finding is gone and no new finding appears.
+
+Each catalog entry's `fix` says which edit its rule offers, or why it offers none (the remedy needs the author's words, data or design choices).
+
+| Rule | Fix |
+| --- | --- |
+| `bar-baseline` | the configured minimum, maximum or base to 0; `beginAtZero: true` (Chart.js), `scale: false` (ECharts) |
+| `bar-log-scale` | the axis type to linear |
+| `reversed-value-axis` | the reversal off |
+| `percent-without-unit` | `labels.format: '{value}%'` where the axis has no format |
+| `data-not-described` | ECharts `aria` on, Highcharts `accessibility.enabled` on (with the accessibility module) |
+| `keyboard-disabled` | Highcharts keyboard navigation on |
+| `long-motion` | a loop off, an ECharts ripple on hover only, a duration over five seconds to one second |
+
+Before/after examples for every fixable rule are in `examples/quality-fixes`. Each is checked on the pinned runtimes: both versions render, `after` is the fix applied to `before`, and what the rule is about is drawn before and not after.
+
+```json
+{
+	"code": "VIS_BAR_BASELINE",
+	"path": "$.options.scales.y.min",
+	"fix": {
+		"kind": "set-option",
+		"path": "$.options.scales.y.min",
+		"from": 60,
+		"value": 0,
+		"effect": "The bars grow from zero again, so their lengths are proportional to their values."
+	}
+}
+```
+
+`withFixes(report, config, remedies, analyze)` is the machinery: an adapter's `remedies` propose, its `analyze` verifies.
+
+## Settings and context
+
+`review(chart, options)` and every adapter's `analyze(config, options)` take the caller's options:
+
+```json
+{
+	"rules": {
+		"value-axis-untitled": "off",
+		"dual-axis": "warning",
+		"bar-baseline": { "level": "info", "ignore": [{ "path": "$.options.scales.y", "reason": "A narrow band of stock prices." }] }
+	},
+	"context": { "background": { "light": "#ffffff", "dark": "#121212" }, "describesData": true, "pausesMotion": false }
+}
+```
+
+Each rule's setting works as follows:
+
+- **A level:** `off` (the rule does not run, and is listed in `disabled`), `info` or `warning`. Never `error`: quality never decides validity.
+- **An ignore:** a finding at the path, or inside it, is not reported. Paths are compared segment by segment, and a reason is required.
+- **Suppressed findings are kept** in `suppressed`, with why (`by: 'setting'` or `'context'`), never dropped.
+
+The context declares what the config cannot show about the page:
+
+- **`background`:** the page behind a chart that draws none (a Chart.js canvas, ECharts without `backgroundColor`, a transparent Highcharts background), so its series can be measured for contrast.
+- **`describesData`:** `true` meets `data-not-described` (the page has a table or a text alternative). `false` lets the rule decide for a canvas.
+- **`pausesMotion`:** `true` meets `long-motion` (WCAG 2.2.2).
+
+Each catalog entry lists the context facts that change it (`context`).
+
+`ruleset` selects the rules that run, by rule id or impact (`misleads`, `excludes`, `omits`, `risks`): `{ "ruleset": ["misleads", "data-not-described"] }` runs the rules that mislead and `data-not-described`; every other rule is off and listed in `disabled`. `rules` shapes the selected ones (a level `off` still turns one off); a level for a rule outside the set does not make it run. An empty list, a hole or an entry that is neither an id nor an impact is a `QualityOptionsError`.
+
+Invalid options throw `QualityOptionsError`, listing every problem with where it is; `assertQualityOptions` checks them alone.
+
+A rule's default severity follows its `impact`:
+
+- `misleads` (every reader is shown the data wrongly) and `excludes` (some readers cannot get the content) are warnings;
+- `omits` and `risks` are information.
+
+Findings are advisory. A chart's purpose is not in its config, so every finding asks the reader to verify; each rule's `limits` say where it can be wrong.

package/dist/access.d.ts

@@ -0,0 +1,4 @@
+/** The accessibility rules (CG-05-04 part 5): what assistive technology gets from the chart. */
+export declare const dataNotDescribed: import("./catalog.js").QualityRule;
+export declare const keyboardDisabled: import("./catalog.js").QualityRule;
+//# sourceMappingURL=access.d.ts.map

package/dist/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAEhG,eAAO,MAAM,gBAAgB,oCAwC5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,oCA6B5B,CAAC"}

package/dist/access.js

@@ -0,0 +1,58 @@
+import { rule, SOURCES } from './catalog.js';
+/** The accessibility rules (CG-05-04 part 5): what assistive technology gets from the chart. */
+export const dataNotDescribed = rule({
+    id: 'data-not-described',
+    code: 'VIS_DATA_NOT_DESCRIBED',
+    severity: 'warning',
+    impact: 'excludes',
+    context: [
+        {
+            fact: 'describesData',
+            effect: 'supplies',
+            note: '`false`: a chart that leaves its description to the page (a Chart.js canvas) gives assistive technology nothing.'
+        },
+        {
+            fact: 'describesData',
+            effect: 'satisfies',
+            note: '`true`: the page describes the data (a data table, a text alternative next to the chart); the finding is suppressed.'
+        }
+    ],
+    fix: {
+        offered: true,
+        edit: "Turns the library's description on (ECharts `aria.enabled` or `aria.label.enabled`; Highcharts `accessibility.enabled`, which needs the accessibility module loaded). A canvas is described by the page: no fix."
+    },
+    title: 'The data is not described to assistive technology',
+    rationale: 'A chart drawn as graphics gives a screen reader nothing to read unless the library labels its points or generates a description. ECharts does so only with `aria.enabled`; Highcharts only with its accessibility module enabled.',
+    evidence: [SOURCES.wcag22],
+    limits: [
+        'The page may describe the data outside the chart (a caption, a table, an `aria-label` on the container); the config does not show it. Declaring it (`context.describesData: true`) suppresses the finding.',
+        'Chart.js draws on a canvas whose text alternative is set in the page, not in the config: it is checked only when the caller declares what the page gives (`context.describesData`).'
+    ]
+}, ({ access: { dataDescribed } }, report) => dataDescribed.known && !dataDescribed.value
+    ? [
+        report(dataDescribed.path, "Assistive technology gets no description of this chart's data: enable the library's accessibility support, or describe the data next to the chart.")
+    ]
+    : []);
+export const keyboardDisabled = rule({
+    id: 'keyboard-disabled',
+    code: 'VIS_KEYBOARD_DISABLED',
+    severity: 'warning',
+    impact: 'excludes',
+    context: [],
+    fix: {
+        offered: true,
+        edit: 'Turns keyboard navigation back on (Highcharts `accessibility.keyboardNavigation.enabled` or `accessibility.enabled`).'
+    },
+    title: 'Keyboard access turned off',
+    rationale: "Keyboard users reach a chart's points, legend and menus only through the library's keyboard navigation. A config that turns it off leaves them with what a mouse user hovers over.",
+    evidence: [SOURCES.wcag22Keyboard],
+    limits: [
+        'Only keyboard access the config turns off is reported; a library without keyboard navigation (ECharts, Chart.js) is not.',
+        'A chart that only shows a picture, with nothing to operate, may not need keyboard access.'
+    ]
+}, ({ access: { keyboard } }, report) => keyboard.known && keyboard.source === 'config' && !keyboard.value
+    ? [
+        report(keyboard.path, "The config turns keyboard navigation off: keyboard users cannot reach the chart's points or legend.")
+    ]
+    : []);
+//# sourceMappingURL=access.js.map

package/dist/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE7C,gGAAgG;AAEhG,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CACnC;IACC,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE;QACR;YACC,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,kHAAkH;SACxH;QACD;YACC,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,sHAAsH;SAC5H;KACD;IACD,GAAG,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,kNAAkN;KACxN;IACD,KAAK,EAAE,mDAAmD;IAC1D,SAAS,EACR,mOAAmO;IACpO,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE;QACP,4MAA4M;QAC5M,qLAAqL;KACrL;CACD,EACD,CAAC,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CACzC,aAAa,CAAC,KAAK,IAAI,CAAC,aAAa,CAAC,KAAK;IAC1C,CAAC,CAAC;QACA,MAAM,CACL,aAAa,CAAC,IAAI,EAClB,oJAAoJ,CACpJ;KACD;IACF,CAAC,CAAC,EAAE,CACN,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CACnC;IACC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,EAAE;IACX,GAAG,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,uHAAuH;KAC7H;IACD,KAAK,EAAE,4BAA4B;IACnC,SAAS,EACR,oLAAoL;IACrL,QAAQ,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;IAClC,MAAM,EAAE;QACP,0HAA0H;QAC1H,2FAA2F;KAC3F;CACD,EACD,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CACpC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK;IAChE,CAAC,CAAC;QACA,MAAM,CACL,QAAQ,CAAC,IAAI,EACb,qGAAqG,CACrG;KACD;IACF,CAAC,CAAC,EAAE,CACN,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,146 @@
+import type { Diagnostic } from '@chartguard/core';
+import type { ChartSemantics } from './chart.js';
+/** A published source a rule rests on. */
+export interface Evidence {
+    readonly authors: string;
+    readonly title: string;
+    readonly venue: string;
+    readonly year: number;
+}
+/**
+ * What a finding means for readers, which decides its default severity (`SEVERITY_OF_IMPACT`):
+ * `misleads`: the chart as drawn shows the data wrongly to every reader; `excludes`: some readers
+ * cannot get the content at all; `omits`: something readers may need is missing, and the text around
+ * the chart may give it; `risks`: the reading depends on choices readers cannot see, or other cues
+ * may carry what is at risk.
+ */
+export type Impact = 'misleads' | 'excludes' | 'omits' | 'risks';
+/** The default severity of each impact: a rule's `severity` is always this (tested). */
+export declare const SEVERITY_OF_IMPACT: Readonly<Record<Impact, 'warning' | 'info'>>;
+/** A fact about where the chart is shown, which the config cannot show and the caller declares (`QualityContext`). */
+export type ContextFact = 'background' | 'describesData' | 'pausesMotion';
+/**
+ * How a context fact the caller declares changes a rule (CG-05-05). `supplies`: it fills a fact the
+ * chart leaves to the page, so the rule can decide where it could not; `satisfies`: a `true` value meets
+ * the rule's concern, and its findings are suppressed (`by: 'context'`), never dropped.
+ */
+export interface ContextCondition {
+    readonly fact: ContextFact;
+    readonly effect: 'supplies' | 'satisfies';
+    readonly note: string;
+}
+/**
+ * A rule's fix (CG-05-06): `offered`, the edit the adapters propose where the config decides it and
+ * it is verified to resolve the finding; or why there is none (what a fix would need that only the
+ * author knows, or an edit that would silence the finding without removing the harm).
+ */
+export type FixPolicy = {
+    readonly offered: true;
+    readonly edit: string;
+} | {
+    readonly offered: false;
+    readonly why: string;
+};
+/**
+ * What a rule is and why (CG-05-04): its finding code and severity (advisory only: never an error),
+ * the reasoning, the sources it rests on, and the cases where it is knowingly wrong or silent.
+ */
+export interface RuleInfo {
+    readonly id: string;
+    readonly code: string;
+    readonly severity: 'warning' | 'info';
+    /** What the finding means for readers; it decides `severity`. */
+    readonly impact: Impact;
+    /** The context facts that change what the rule reports (CG-05-05). */
+    readonly context: readonly ContextCondition[];
+    /** Whether the adapters offer a fix for the rule's findings, and which edit, or why none (CG-05-06). */
+    readonly fix: FixPolicy;
+    readonly title: string;
+    readonly rationale: string;
+    readonly evidence: readonly Evidence[];
+    /** Where the rule can be wrong or says nothing: the documented false-positive and false-negative limits. */
+    readonly limits: readonly string[];
+}
+export interface QualityRule extends RuleInfo {
+    readonly check: (chart: ChartSemantics) => readonly Diagnostic[];
+}
+/** Reports a finding of the rule at `path`. */
+export type Report = (path: string, message: string) => Diagnostic;
+/** A rule from its catalog entry and its check, which reports through `report` (code, severity and id come from `info`). */
+export declare function rule(info: RuleInfo, check: (chart: ChartSemantics, report: Report) => readonly Diagnostic[]): QualityRule;
+/** Sources several rules share. */
+export declare const SOURCES: {
+    readonly pandey2015: {
+        readonly authors: "Pandey, Rall, Satterthwaite, Nov, Bertini";
+        readonly title: "How Deceptive are Deceptive Visualizations? An Empirical Analysis of Common Distortion Techniques";
+        readonly venue: "Proceedings of CHI 2015";
+        readonly year: 2015;
+    };
+    readonly correll2020: {
+        readonly authors: "Correll, Bertini, Franconeri";
+        readonly title: "Truncating the Y-Axis: Threat or Menace?";
+        readonly venue: "Proceedings of CHI 2020";
+        readonly year: 2020;
+    };
+    readonly cleveland1984: {
+        readonly authors: "Cleveland, McGill";
+        readonly title: "Graphical Perception: Theory, Experimentation, and Application to the Development of Graphical Methods";
+        readonly venue: "Journal of the American Statistical Association 79(387)";
+        readonly year: 1984;
+    };
+    readonly isenberg2011: {
+        readonly authors: "Isenberg, Bezerianos, Dragicevic, Fekete";
+        readonly title: "A Study on Dual-Scale Data Charts";
+        readonly venue: "IEEE Transactions on Visualization and Computer Graphics 17(12)";
+        readonly year: 2011;
+    };
+    readonly spence1991: {
+        readonly authors: "Spence, Lewandowsky";
+        readonly title: "Displaying Proportions and Percentages";
+        readonly venue: "Applied Cognitive Psychology 5(1)";
+        readonly year: 1991;
+    };
+    readonly few2012: {
+        readonly authors: "Few";
+        readonly title: "Show Me the Numbers: Designing Tables and Graphs to Enlighten (2nd edition)";
+        readonly venue: "Analytics Press";
+        readonly year: 2012;
+    };
+    readonly ware2012: {
+        readonly authors: "Ware";
+        readonly title: "Information Visualization: Perception for Design (3rd edition)";
+        readonly venue: "Morgan Kaufmann";
+        readonly year: 2012;
+    };
+    readonly wcag22Labels: {
+        readonly authors: "W3C";
+        readonly title: "Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 2.4.6 Headings and Labels";
+        readonly venue: "W3C Recommendation";
+        readonly year: 2023;
+    };
+    readonly wcag22Keyboard: {
+        readonly authors: "W3C";
+        readonly title: "Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 2.1.1 Keyboard";
+        readonly venue: "W3C Recommendation";
+        readonly year: 2023;
+    };
+    readonly wcag22Contrast: {
+        readonly authors: "W3C";
+        readonly title: "Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 1.4.11 Non-text Contrast";
+        readonly venue: "W3C Recommendation";
+        readonly year: 2023;
+    };
+    readonly wcag22Pause: {
+        readonly authors: "W3C";
+        readonly title: "Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 2.2.2 Pause, Stop, Hide";
+        readonly venue: "W3C Recommendation";
+        readonly year: 2023;
+    };
+    readonly wcag22: {
+        readonly authors: "W3C";
+        readonly title: "Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 1.1.1 Non-text Content";
+        readonly venue: "W3C Recommendation";
+        readonly year: 2023;
+    };
+};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjE,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAK3E,CAAC;AAEF,sHAAsH;AACtH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACpB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,wGAAwG;IACxG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC;IACvC,4GAA4G;IAC5G,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,UAAU,EAAE,CAAC;CACjE;AAED,+CAA+C;AAC/C,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC;AAEnE,4HAA4H;AAC5H,wBAAgB,IAAI,CACnB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,UAAU,EAAE,GACrE,WAAW,CAEb;AAOD,mCAAmC;AACnC,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEyB,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,91 @@
+/** The default severity of each impact: a rule's `severity` is always this (tested). */
+export const SEVERITY_OF_IMPACT = {
+    misleads: 'warning',
+    excludes: 'warning',
+    omits: 'info',
+    risks: 'info'
+};
+/** A rule from its catalog entry and its check, which reports through `report` (code, severity and id come from `info`). */
+export function rule(info, check) {
+    return { ...info, check: (chart) => check(chart, (path, message) => finding(info, path, message)) };
+}
+/** A finding of a rule at `path`: inferred, as every quality finding (a chart's intent is not in its config). */
+function finding({ id, code, severity }, path, message) {
+    return { code, severity, path, message, confidence: 'inferred', ruleId: id };
+}
+/** Sources several rules share. */
+export const SOURCES = {
+    pandey2015: {
+        authors: 'Pandey, Rall, Satterthwaite, Nov, Bertini',
+        title: 'How Deceptive are Deceptive Visualizations? An Empirical Analysis of Common Distortion Techniques',
+        venue: 'Proceedings of CHI 2015',
+        year: 2015
+    },
+    correll2020: {
+        authors: 'Correll, Bertini, Franconeri',
+        title: 'Truncating the Y-Axis: Threat or Menace?',
+        venue: 'Proceedings of CHI 2020',
+        year: 2020
+    },
+    cleveland1984: {
+        authors: 'Cleveland, McGill',
+        title: 'Graphical Perception: Theory, Experimentation, and Application to the Development of Graphical Methods',
+        venue: 'Journal of the American Statistical Association 79(387)',
+        year: 1984
+    },
+    isenberg2011: {
+        authors: 'Isenberg, Bezerianos, Dragicevic, Fekete',
+        title: 'A Study on Dual-Scale Data Charts',
+        venue: 'IEEE Transactions on Visualization and Computer Graphics 17(12)',
+        year: 2011
+    },
+    spence1991: {
+        authors: 'Spence, Lewandowsky',
+        title: 'Displaying Proportions and Percentages',
+        venue: 'Applied Cognitive Psychology 5(1)',
+        year: 1991
+    },
+    few2012: {
+        authors: 'Few',
+        title: 'Show Me the Numbers: Designing Tables and Graphs to Enlighten (2nd edition)',
+        venue: 'Analytics Press',
+        year: 2012
+    },
+    ware2012: {
+        authors: 'Ware',
+        title: 'Information Visualization: Perception for Design (3rd edition)',
+        venue: 'Morgan Kaufmann',
+        year: 2012
+    },
+    wcag22Labels: {
+        authors: 'W3C',
+        title: 'Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 2.4.6 Headings and Labels',
+        venue: 'W3C Recommendation',
+        year: 2023
+    },
+    wcag22Keyboard: {
+        authors: 'W3C',
+        title: 'Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 2.1.1 Keyboard',
+        venue: 'W3C Recommendation',
+        year: 2023
+    },
+    wcag22Contrast: {
+        authors: 'W3C',
+        title: 'Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 1.4.11 Non-text Contrast',
+        venue: 'W3C Recommendation',
+        year: 2023
+    },
+    wcag22Pause: {
+        authors: 'W3C',
+        title: 'Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 2.2.2 Pause, Stop, Hide',
+        venue: 'W3C Recommendation',
+        year: 2023
+    },
+    wcag22: {
+        authors: 'W3C',
+        title: 'Web Content Accessibility Guidelines (WCAG) 2.2, Success Criterion 1.1.1 Non-text Content',
+        venue: 'W3C Recommendation',
+        year: 2023
+    }
+};
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAqBA,wFAAwF;AACxF,MAAM,CAAC,MAAM,kBAAkB,GAAiD;IAC/E,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;CACb,CAAC;AAoDF,4HAA4H;AAC5H,MAAM,UAAU,IAAI,CACnB,IAAc,EACd,KAAuE;IAEvE,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,iHAAiH;AACjH,SAAS,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAY,EAAE,IAAY,EAAE,OAAe;IAC/E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC9E,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,UAAU,EAAE;QACX,OAAO,EAAE,2CAA2C;QACpD,KAAK,EAAE,mGAAmG;QAC1G,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,IAAI;KACV;IACD,WAAW,EAAE;QACZ,OAAO,EAAE,8BAA8B;QACvC,KAAK,EAAE,0CAA0C;QACjD,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,IAAI;KACV;IACD,aAAa,EAAE;QACd,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE,wGAAwG;QAC/G,KAAK,EAAE,yDAAyD;QAChE,IAAI,EAAE,IAAI;KACV;IACD,YAAY,EAAE;QACb,OAAO,EAAE,0CAA0C;QACnD,KAAK,EAAE,mCAAmC;QAC1C,KAAK,EAAE,iEAAiE;QACxE,IAAI,EAAE,IAAI;KACV;IACD,UAAU,EAAE;QACX,OAAO,EAAE,qBAAqB;QAC9B,KAAK,EAAE,wCAAwC;QAC/C,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,IAAI;KACV;IACD,OAAO,EAAE;QACR,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,6EAA6E;QACpF,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,IAAI;KACV;IACD,QAAQ,EAAE;QACT,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,gEAAgE;QACvE,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,IAAI;KACV;IACD,YAAY,EAAE;QACb,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,8FAA8F;QACrG,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,IAAI;KACV;IACD,cAAc,EAAE;QACf,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,mFAAmF;QAC1F,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,IAAI;KACV;IACD,cAAc,EAAE;QACf,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,6FAA6F;QACpG,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,IAAI;KACV;IACD,WAAW,EAAE;QACZ,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,4FAA4F;QACnG,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,IAAI;KACV;IACD,MAAM,EAAE;QACP,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,2FAA2F;QAClG,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,IAAI;KACV;CAC2C,CAAC"}

package/dist/chart.d.ts

@@ -0,0 +1,138 @@
+import type { Fact, KnownFact, Listed } from './facts.js';
+/** What a series draws, across libraries; `other` keeps the library type for rules that need it. */
+export type SeriesKind = 'bar' | 'line' | 'area' | 'scatter' | 'pie' | 'other';
+/** The direction a series' values grow in: up (`vertical`, the values on the y axis) or across (`horizontal`). */
+export type Orientation = 'vertical' | 'horizontal';
+/** Whether a series' values are stacked onto the series sharing its stack, as amounts or as shares (`percent`). */
+export type Stacking = 'none' | 'stacked' | 'percent';
+/** The coordinate system a series is drawn in. */
+export type CoordinateSystem = 'cartesian' | 'polar';
+/**
+ * A colour as it is shown in each colour scheme the chart can be shown in: `light`, `dark`, or both
+ * (the same colour in both when it does not depend on the scheme). The payload of a `Fact`; each shade
+ * carries where it was read from, or the runtime default it comes from.
+ */
+export interface Shades {
+    readonly light: KnownFact<string> | undefined;
+    readonly dark: KnownFact<string> | undefined;
+}
+/** A value of a series and where it is in the config. */
+export interface ValueAt {
+    readonly value: number;
+    readonly path: string;
+}
+/**
+ * The numeric values a series draws: how many, the smallest and the largest. The payload of a
+ * `Fact`: known only when every element of the data could be read (gaps, `null`, are skipped).
+ */
+export interface ValueSummary {
+    readonly count: number;
+    readonly min: ValueAt | undefined;
+    readonly max: ValueAt | undefined;
+}
+/** One series (dataset): its library type, what it draws, its name and the axis its values are measured on. */
+export interface SeriesSemantics {
+    /** Where the series is in the config. */
+    readonly path: string;
+    readonly type: Fact<string>;
+    readonly kind: Fact<SeriesKind>;
+    readonly name: Fact<string>;
+    /** The `key` of the axis in `ChartSemantics.axes` its values are plotted against. */
+    readonly valueAxis: Fact<string>;
+    readonly coordinateSystem: Fact<CoordinateSystem>;
+    /** Cartesian series only; `inapplicable` in polar and axis-less series. */
+    readonly orientation: Fact<Orientation>;
+    readonly stacking: Fact<Stacking>;
+    /**
+     * The value a bar grows from (Chart.js `base`, ECharts `startValue` of its value axis, Highcharts
+     * `threshold`); zero by default. `inapplicable` for series that are not bars.
+     */
+    readonly base: Fact<number>;
+    /**
+     * The colour the series is drawn in, as the runtime sets it: a CSS colour (Highcharts palette colours
+     * are CSS variables). Per-point colours and gradients are `unmodelled`.
+     */
+    readonly color: Fact<string>;
+    /** Its colour as shown in each colour scheme: CSS variables resolved, for contrast. */
+    readonly shades: Fact<Shades>;
+    /** Its values as the runtime reads them from `data`; `unmodelled` for shapes not read yet (datasets, parsing keys, ranges). */
+    readonly values: Fact<ValueSummary>;
+    /**
+     * Its entry in the legend (CG-05-04 part 9): the text drawn for it, its name or what the runtime
+     * makes up for a series without one (`source: 'default'`); and whether the legend draws an entry for
+     * the series itself (`inapplicable` where the legend lists its points instead).
+     */
+    readonly legend: TitleSemantics;
+}
+/**
+ * Where a range the runtime fits to the data puts zero: `excluded` at every size the chart can be
+ * drawn at, or `included` at every size.
+ */
+export type ZeroFit = 'excluded' | 'included';
+/** How an axis maps values to positions. */
+export type ScaleType = 'linear' | 'log' | 'category' | 'time' | 'other';
+/** One axis: the key series refer to it by, its scale, range, direction and title. */
+export interface AxisSemantics {
+    /** Library-neutral and unique in the chart: `y`, `y-left` (Chart.js scale ids), `yAxis[0]`. */
+    readonly key: string;
+    /** Where the axis is configured, or would be. */
+    readonly path: string;
+    readonly scale: Fact<ScaleType>;
+    /** A number, or `data`: the axis starts at the smallest value shown (ECharts `min: 'dataMin'`). */
+    readonly min: Fact<number | 'data'>;
+    readonly max: Fact<number | 'data'>;
+    /**
+     * Whether the range the runtime fits to the data leaves zero out, when the config asks for a range
+     * fitted to the data (Chart.js `beginAtZero: false`, ECharts `scale: true`) and sets no bound: the
+     * path is that switch. `unset` when the config does not ask; `layout` when it depends on the size.
+     */
+    readonly fit: Fact<ZeroFit>;
+    /**
+     * The unit the tick labels show around each value (`%` from a format `{value}%`); empty when they
+     * show bare numbers. A function that formats them is `dynamic`.
+     */
+    readonly unit: Fact<string>;
+    /**
+     * The plot region the axis spans: axes whose known panels are equal are drawn over one another,
+     * in one plot; different panels are separate (a grid of their own, a stacked band, a pane), or
+     * not known to overlap.
+     */
+    readonly panel: Fact<string>;
+    /** Values grow towards the origin of the screen direction (down, or left). */
+    readonly reversed: Fact<boolean>;
+    readonly title: TitleSemantics;
+}
+/** A title or label (of the chart, an axis, a series' legend entry): its text and whether it is shown. */
+export interface TitleSemantics {
+    readonly text: Fact<string>;
+    readonly shown: Fact<boolean>;
+}
+/** What assistive technology gets from the chart (CG-05-04 part 5). */
+export interface AccessSemantics {
+    /** Whether the data is described to assistive technology: point labels, or a generated description. */
+    readonly dataDescribed: Fact<boolean>;
+    /** Whether the chart can be operated with a keyboard. */
+    readonly keyboard: Fact<boolean>;
+}
+/** The motion a chart starts by itself when it is drawn (CG-05-04 part 7). */
+export interface MotionSemantics {
+    /** Whether something keeps moving without end (a looping animation, a ripple effect). */
+    readonly endless: Fact<boolean>;
+    /** The longest animation that runs when the chart is drawn, in milliseconds (0 when none). */
+    readonly longest: Fact<number>;
+}
+/**
+ * Library-neutral chart semantics (CG-05-02). Every fact is known, with the path it was read from
+ * (or the runtime default and its pointer), or unknown with why: rules claim nothing on an unknown fact.
+ */
+export interface ChartSemantics {
+    readonly library: string;
+    readonly title: TitleSemantics;
+    readonly series: Listed<SeriesSemantics>;
+    readonly axes: readonly AxisSemantics[];
+    readonly access: AccessSemantics;
+    /** The background the series are drawn on, in each colour scheme; unknown when the page shows through. */
+    readonly background: Fact<Shades>;
+    readonly motion: MotionSemantics;
+}
+//# sourceMappingURL=chart.d.ts.map

package/dist/chart.d.ts.map

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

package/dist/chart.js

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

package/dist/chart.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A key under which two CSS colours that are the same compare equal: `#f00`, `#ff0000` and
+ * `rgb(255, 0, 0)` share one. Other forms (names, `hsl()`, CSS variables) keep their own text, so two
+ * identical texts are the same colour; a text and an equivalent other form are not recognised as
+ * the same (a rule claims only sameness it can see, never distinctness).
+ */
+export declare function colorKey(color: string): string;
+/**
+ * The contrast ratio (WCAG 2.2, 1 to 21) of `foreground` drawn over `background`: a translucent
+ * foreground is composited over the background first. Undefined when either colour is not in a hex or
+ * `rgb()` form, or the background is not opaque (whatever is behind it shows through).
+ */
+export declare function contrastRatio(foreground: string, background: string): number | undefined;
+/** Whether a colour draws nothing: `transparent`, or a hex or `rgb()` colour with zero alpha. */
+export declare function isTransparent(color: string): boolean;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO9C;AAkBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxF;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD"}