@chartguard/quality-chartjs 0.0.0-stage → 0.1.0

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,18 @@
-# Temporary Holding Version
+# @chartguard/quality-chartjs
 
-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.
+Advisory quality review of Chart.js configs: it reads the chart the config describes (what the runtime would draw, with its defaults) and reports presentation problems such as bars that do not start at zero, unreadable colours or charts assistive technology cannot describe. Findings are advice, never a verdict: there is no error severity and no `valid`.
+
+**Status:** pre-release (0.x). Coverage is partial, and the API and settings may still change between minor versions.
+
+```ts
+import { analyze } from "@chartguard/quality-chartjs";
+
+const report = analyze({ type: "bar", data: { labels: ["a", "b"], datasets: [{ label: "Sales", data: [60, 70] }] }, options: { scales: { y: { min: 50 } } } });
+for (const finding of report.diagnostics) console.log(finding.code, finding.path, finding.message, finding.fix);
+```
+
+- **Rules:** the shared catalog of `@chartguard/quality-core` (`RULE_CATALOG`: each rule with its rationale, sources and documented limits). `analyze(config, { rules: { "value-axis-untitled": "off" } })` sets a rule's level (`off`, `info`, `warning`); `ruleset` picks rules by id or impact.
+- **Context:** facts the chart leaves to the page (`context: { background: "#ffffff" }`) let rules decide what the config alone cannot; a finding the context or a setting suppresses is kept in `report.suppressed`, with why.
+- **Fixes:** a finding may carry a `set-option` fix, offered only when it is verified to remove the finding without a new one. It changes what is drawn: apply it (`applyFix` from `@chartguard/core`) only at the user's request.
+- **Unknown stays unknown:** a fact the config does not decide (an option set by a callback, a size-dependent range) is unknown, and no rule claims anything on it.
+- `normalize(config)` gives the library-neutral `ChartSemantics` the rules read; invalid options throw `QualityOptionsError` (`assertQualityOptions` checks them up front).

package/dist/axes.d.ts

@@ -0,0 +1,14 @@
+import { type AxisSemantics, type Fact, type Item, type Listed, type SeriesSemantics } from '@chartguard/quality-core';
+import type { Scales } from './scales.js';
+/** Chart.js titles are a string or one string per line. */
+export declare const isText: (value: unknown) => value is string | string[];
+export declare const asText: (fact: Fact<string | string[]>) => Fact<string>;
+/** The datasets as read and as series: a fitted range is measured from their values. */
+interface Datasets {
+    readonly series: Listed<SeriesSemantics>;
+    readonly datasets: Listed<Item>;
+}
+/** Every scale the chart builds that is read (configured or added by a dataset), and any a dataset names. */
+export declare function axesOf(config: unknown, { series, datasets }: Datasets, scales: Scales): AxisSemantics[];
+export {};
+//# sourceMappingURL=axes.d.ts.map

package/dist/axes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axes.d.ts","sourceRoot":"","sources":["../src/axes.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,aAAa,EAGlB,KAAK,IAAI,EAMT,KAAK,IAAI,EACT,KAAK,MAAM,EAGX,KAAK,eAAe,EAEpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAQ,MAAM,EAAE,MAAM,aAAa,CAAC;AAwFhD,2DAA2D;AAC3D,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,GAAG,MAAM,EACsD,CAAC;AACvH,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,KAAG,IAAI,CAAC,MAAM,CAGjE,CAAC;AAiDF,wFAAwF;AACxF,UAAU,QAAQ;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,6GAA6G;AAC7G,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAMvG"}

package/dist/axes.js

@@ -0,0 +1,146 @@
+import { defaulted, firstSet, formatPath, isBoolean, isNumber, isString, readFact, unknown } from '@chartguard/quality-core';
+import { fitOf } from './fit.js';
+import { INDEX_AXIS } from './series.js';
+/** Bar and line charts default their index scale to `category` and their value scale to `linear`. */
+const BY_ROLE = {
+    bar: {
+        index: { value: 'category', pointer: "chart.js@4.5.1 dist/chart.js:1393 type: 'category'," },
+        value: { value: 'linear', pointer: "chart.js@4.5.1 dist/chart.js:1400 type: 'linear'," }
+    },
+    line: {
+        index: {
+            value: 'category',
+            pointer: "chart.js@4.5.1 dist/chart.js:2097 type: 'category' [in class LineController]"
+        },
+        value: { value: 'linear', pointer: "chart.js@4.5.1 dist/chart.js:2100 type: 'linear' [in class LineController]" }
+    }
+};
+/** Scatter charts default both scales to `linear`, radar charts their `r` scale to `radialLinear`. */
+const BY_AXIS = {
+    scatter: {
+        x: {
+            value: 'linear',
+            pointer: "chart.js@4.5.1 dist/chart.js:2472 type: 'linear' [in class ScatterController] [in x: {]"
+        },
+        y: {
+            value: 'linear',
+            pointer: "chart.js@4.5.1 dist/chart.js:2475 type: 'linear' [in class ScatterController] [in y: {]"
+        }
+    },
+    radar: {
+        r: {
+            value: 'radialLinear',
+            pointer: "chart.js@4.5.1 dist/chart.js:2402 type: 'radialLinear' [in class RadarController]"
+        }
+    }
+};
+/** A scale title is hidden and empty unless set (`title: { display: false, text: '' }`). */
+const TITLE_SHOWN = {
+    value: false,
+    pointer: 'chart.js@4.5.1 dist/chunks/helpers.dataset.js:956 display: false,'
+};
+const TITLE_TEXT = {
+    value: '',
+    pointer: "chart.js@4.5.1 dist/chunks/helpers.dataset.js:957 text: '',"
+};
+const REVERSE = {
+    value: false,
+    pointer: 'chart.js@4.5.1 dist/chunks/helpers.dataset.js:934 reverse: false,'
+};
+/**
+ * Scales without a `stack` share the chart area; scales with one are laid out in bands, one after the
+ * other (`buildStacks`, which skips a box without a stack): each such scale is a panel of its own.
+ */
+const UNSTACKED = {
+    value: 'chart',
+    pointer: 'chart.js@4.5.1 dist/chart.js:2923 if (!stack || !STATIC_POSITIONS.includes(pos)) {'
+};
+function panelOf(config, path, key) {
+    const stack = readFact(config, [...path, 'stack'], isString, UNSTACKED);
+    return stack.known && stack.source === 'config' ? { ...stack, value: `stack:${stack.value}:${key}` } : stack;
+}
+/** A linear scale labels its ticks with plain numbers unless a callback formats them. */
+const NUMERIC = {
+    value: '',
+    pointer: 'chart.js@4.5.1 dist/chart.js:10364 callback: Ticks.formatters.numeric [in class LinearScale extends]'
+};
+/** The unit around the tick labels: none on a linear scale without a callback; a callback decides at runtime. */
+function unitOf(config, path, scale) {
+    const callback = readFact(config, [...path, 'ticks', 'callback'], (_value) => false);
+    if (callback.known || callback.reason !== 'unset')
+        return callback;
+    return scale.known && scale.value === 'linear'
+        ? defaulted(NUMERIC, callback.path)
+        : unknown(callback.path, 'unmodelled');
+}
+const SCALE_TYPES = {
+    linear: 'linear',
+    radialLinear: 'linear',
+    logarithmic: 'log',
+    category: 'category',
+    time: 'time',
+    timeseries: 'time'
+};
+/** Chart.js titles are a string or one string per line. */
+export const isText = (value) => typeof value === 'string' || (Array.isArray(value) && value.every((line) => typeof line === 'string'));
+export const asText = (fact) => {
+    if (!fact.known || typeof fact.value === 'string')
+        return fact;
+    return { ...fact, value: fact.value.join(' ') };
+};
+/**
+ * A configured scale's type defaults from the chart type (`mergeScaleConfig` merges the chart type's
+ * scale defaults first): by its role for bar and line charts (the index axis is `options.datasets[type]`
+ * or `options.indexAxis`, else `x`), by its axis for scatter and radar charts. Otherwise not modelled.
+ */
+function defaultType(config, axis) {
+    const type = readFact(config, ['type'], isString);
+    if (!type.known || axis === undefined)
+        return undefined;
+    const roles = BY_ROLE[type.value];
+    if (roles === undefined)
+        return BY_AXIS[type.value]?.[axis];
+    const index = firstSet([
+        readFact(config, ['options', 'datasets', type.value, 'indexAxis'], isString),
+        readFact(config, ['options', 'indexAxis'], isString)
+    ], INDEX_AXIS);
+    if (!index.known || axis === 'r')
+        return undefined;
+    return axis === index.value ? roles.index : roles.value;
+}
+function scaleOf(config, path, axis) {
+    const type = readFact(config, [...path, 'type'], isString, defaultType(config, axis));
+    if (!type.known)
+        return type;
+    return { ...type, value: SCALE_TYPES[type.value] ?? 'other' };
+}
+function axisOf(config, key, axis, chart) {
+    const path = ['options', 'scales', key];
+    const scale = scaleOf(config, path, axis);
+    return {
+        key,
+        path: formatPath(path),
+        scale,
+        min: readFact(config, [...path, 'min'], isNumber),
+        max: readFact(config, [...path, 'max'], isNumber),
+        fit: fitOf(config, key, scale, chart),
+        unit: unitOf(config, path, scale),
+        panel: panelOf(config, path, key),
+        reversed: readFact(config, [...path, 'reverse'], isBoolean, REVERSE),
+        title: {
+            text: asText(readFact(config, [...path, 'title', 'text'], isText, TITLE_TEXT)),
+            shown: readFact(config, [...path, 'title', 'display'], isBoolean, TITLE_SHOWN)
+        }
+    };
+}
+/** Every scale the chart builds that is read (configured or added by a dataset), and any a dataset names. */
+export function axesOf(config, { series, datasets }, scales) {
+    const built = scales.entries.flatMap(({ id, axis }) => (id === undefined ? [] : [[id, axis]]));
+    const named = series.known ? series.items.flatMap(({ valueAxis }) => (valueAxis.known ? [valueAxis.value] : [])) : [];
+    const axes = new Map(built);
+    for (const key of named)
+        if (!axes.has(key))
+            axes.set(key, undefined);
+    return [...axes].map(([key, axis]) => axisOf(config, key, axis, { series, datasets }));
+}
+//# sourceMappingURL=axes.js.map

package/dist/axes.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,8 @@
+import { type Fact, type Item, type Listed } from '@chartguard/quality-core';
+/**
+ * `colorsDefined` for one analysis, read at most once: every dataset's colour may depend on it, and
+ * reading every dataset again for each one is quadratic in a number the caller chooses.
+ */
+export declare function colorsDefinedOnce(config: unknown, datasets: Listed<Item>): () => Fact<boolean>;
+export declare function colorOf(config: unknown, item: Item, type: Fact<string>, definedAnywhere: () => Fact<boolean>): Fact<string>;
+//# 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":"AACA,OAAO,EACN,KAAK,IAAI,EAIT,KAAK,IAAI,EAET,KAAK,MAAM,EAKX,MAAM,0BAA0B,CAAC;AAkElC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAG9F;AAwBD,wBAAgB,OAAO,CACtB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAClB,eAAe,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,GAClC,IAAI,CAAC,MAAM,CAAC,CAqBd"}

package/dist/color.js

@@ -0,0 +1,123 @@
+import { isContainer, ownDataProperty } from '@chartguard/core';
+import { firstSet, formatPath, isStaticValue, known, readFact, unknown } from '@chartguard/quality-core';
+/** The option that colours a dataset, and the element whose options it falls back to. */
+const COLORED_BY = {
+    line: { key: 'borderColor', element: 'line' },
+    bar: { key: 'backgroundColor', element: 'bar' },
+    scatter: { key: 'backgroundColor', element: 'point' },
+    bubble: { key: 'backgroundColor', element: 'point' }
+};
+/** Chart.js's own colours, used when nothing else colours a dataset. */
+const DEFAULT = {
+    backgroundColor: "chart.js@4.5.1 dist/chunks/helpers.dataset.js:1024 this.backgroundColor = 'rgba(0,0,0,0.1)';",
+    borderColor: "chart.js@4.5.1 dist/chunks/helpers.dataset.js:1025 this.borderColor = 'rgba(0,0,0,0.1)';"
+};
+const NONE = { known: true, value: false, path: '$', source: 'config' };
+/** Whether `value` defines a colour as `containsColorsDefinitions` sees one (an own truthy colour); unknown behind a getter. */
+function defines(value, path) {
+    if (!isContainer(value))
+        return NONE;
+    for (const key of ['borderColor', 'backgroundColor']) {
+        const entry = ownDataProperty(value, key);
+        if (!entry.found && entry.accessor)
+            return unknown(path, 'accessor');
+        if (entry.found && Boolean(entry.value))
+            return { known: true, value: true, path, source: 'config' };
+    }
+    return NONE;
+}
+/** The element options under `options.elements`, read through own data properties. */
+function elementsOf(config) {
+    const elements = readFact(config, ['options', 'elements'], isContainer);
+    if (!elements.known)
+        return elements.reason === 'unset' ? known([], elements.path) : elements;
+    const entries = Object.keys(elements.value).map((key) => ({
+        entry: ownDataProperty(elements.value, key),
+        path: formatPath(['options', 'elements', key])
+    }));
+    const hidden = entries.find(({ entry }) => !entry.found);
+    if (hidden !== undefined)
+        return unknown(hidden.path, 'accessor');
+    return known(entries.map(({ entry, path }) => ({ value: entry.found ? entry.value : undefined, path })), elements.path);
+}
+/**
+ * Whether the config defines a colour anywhere: in a dataset, the chart options or an element's
+ * options. Then the Colors plugin stays out (`if (!options.forceOverride && containsColorDefenition)`,
+ * dist/chart.js:7428), registered or not, and an uncoloured dataset takes Chart.js's own colour.
+ */
+function colorsDefined(config, datasets) {
+    if (!datasets.known)
+        return unknown(datasets.path, datasets.reason);
+    const options = readFact(config, ['options'], isContainer);
+    if (!options.known && options.reason !== 'unset')
+        return options;
+    const elements = elementsOf(config);
+    if (!elements.known)
+        return elements;
+    const holders = [
+        ...datasets.items,
+        { value: options.known ? options.value : undefined, path: '$.options' },
+        ...elements.value
+    ];
+    return holders.map(({ value, path }) => defines(value, path)).find((fact) => !fact.known || fact.value) ?? NONE;
+}
+/**
+ * `colorsDefined` for one analysis, read at most once: every dataset's colour may depend on it, and
+ * reading every dataset again for each one is quadratic in a number the caller chooses.
+ */
+export function colorsDefinedOnce(config, datasets) {
+    let defined;
+    return () => (defined ??= colorsDefined(config, datasets));
+}
+/**
+ * The colour a dataset is drawn in: its own (`borderColor` for lines, `backgroundColor` for bars and
+ * points), else the options for its type, its element or the chart; else, when the config colours
+ * anything, Chart.js's own `rgba(0,0,0,0.1)`. Without any colour in the config the Colors plugin
+ * decides, if it is registered: not modelled. Per-point colours (arrays) are not modelled either.
+ */
+/**
+ * Whether the Colors plugin may paint over every colour: `forceOverride` skips its test for colours in
+ * the config (dist/chart.js:7428), unless the plugin is turned off. Whether it is registered is not in
+ * the config, so then no dataset colour is known (K7). Undefined when it cannot override them.
+ */
+function forcedOver(config) {
+    const at = ['options', 'plugins', 'colors'];
+    const enabled = readFact(config, [...at, 'enabled'], isStaticValue);
+    if (enabled.known && enabled.value === false)
+        return undefined;
+    const force = readFact(config, [...at, 'forceOverride'], isStaticValue);
+    if (!force.known)
+        return force.reason === 'unset' ? undefined : force;
+    return force.value === false || force.value === undefined || force.value === null
+        ? undefined
+        : unknown(force.path, 'unmodelled');
+}
+export function colorOf(config, item, type, definedAnywhere) {
+    if (!type.known)
+        return unknown(`${item.path}.backgroundColor`, type.reason);
+    const forced = forcedOver(config);
+    if (forced !== undefined)
+        return unknown(`${item.path}.backgroundColor`, forced.reason);
+    const by = COLORED_BY[type.value];
+    if (by === undefined)
+        return unknown(`${item.path}.backgroundColor`, 'unmodelled');
+    const at = (path) => readFact(config, [...path, by.key], isStaticValue);
+    const own = firstSet([
+        at(item.segments),
+        at(['options', 'datasets', type.value]),
+        at(['options', 'elements', by.element]),
+        at(['options'])
+    ]);
+    if (own.known)
+        return typeof own.value === 'string' ? own : unknown(own.path, 'unmodelled');
+    if (own.reason !== 'unset')
+        return own;
+    const defined = definedAnywhere();
+    const path = formatPath([...item.segments, by.key]);
+    if (!defined.known)
+        return unknown(path, defined.reason);
+    return defined.value
+        ? { known: true, value: 'rgba(0,0,0,0.1)', path, source: 'default', pointer: DEFAULT[by.key] }
+        : unknown(path, 'unmodelled');
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/fit.d.ts

@@ -0,0 +1,11 @@
+import { type Fact, type Item, type Listed, type ScaleType, type SeriesSemantics, type ZeroFit } from '@chartguard/quality-core';
+/**
+ * Where zero is in the range a linear value scale fits to the data when its `beginAtZero` is `false`
+ * (bar charts set it `true` for their value scale). Hidden datasets and the options in `UNMODELLED`
+ * are not modelled.
+ */
+export declare function fitOf(config: unknown, key: string, type: Fact<ScaleType>, { series, datasets }: {
+    series: Listed<SeriesSemantics>;
+    datasets: Listed<Item>;
+}): Fact<ZeroFit>;
+//# sourceMappingURL=fit.d.ts.map

package/dist/fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.d.ts","sourceRoot":"","sources":["../src/fit.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,IAAI,EAMT,KAAK,IAAI,EACT,KAAK,MAAM,EAEX,KAAK,SAAS,EACd,KAAK,eAAe,EAGpB,KAAK,OAAO,EAEZ,MAAM,0BAA0B,CAAC;AAsHlC;;;;GAIG;AACH,wBAAgB,KAAK,CACpB,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EACrB,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;CAAE,GAC/E,IAAI,CAAC,OAAO,CAAC,CAYf"}

package/dist/fit.js

@@ -0,0 +1,137 @@
+import { dataRange, formatPath, holds, isBoolean, isNumber, isString, readFact, unknown, zeroFit } from '@chartguard/quality-core';
+const NICE = [1, 2, 5];
+/** `niceNum` (chart.js@4.5.1 dist/chunks/helpers.dataset.js:301). */
+function niceNum(range) {
+    const rounded = Math.round(range);
+    const near = Math.abs(range - rounded) < range / 1000 ? rounded : range;
+    const magnitude = 10 ** Math.floor(Math.log10(near));
+    const fraction = near / magnitude;
+    return (NICE.find((step) => fraction <= step) ?? 10) * magnitude;
+}
+/** `_decimalPlaces` (dist/chunks/helpers.dataset.js:364). */
+function decimalPlaces(value) {
+    let [scale, places] = [1, 0];
+    while (Math.round(value * scale) / scale !== value)
+        [scale, places] = [scale * 10, places + 1];
+    return places;
+}
+/**
+ * The first and last tick `generateTicks$1` (dist/chart.js:10137) makes from a data range with at
+ * most `maxTicks` ticks, with `bounds: 'ticks'` and no step, count, precision or bound set.
+ */
+function tickRange(min, max, maxTicks) {
+    const spaces = maxTicks - 1;
+    let spacing = niceNum((max - min) / spaces);
+    if (spacing < 1e-14)
+        return [min, max];
+    if (Math.ceil(max / spacing) - Math.floor(min / spacing) > spaces)
+        spacing = niceNum(((Math.ceil(max / spacing) - Math.floor(min / spacing)) * spacing) / spaces);
+    const [niceMin, niceMax] = [Math.floor(min / spacing) * spacing, Math.ceil(max / spacing) * spacing];
+    const factor = 10 ** Math.max(decimalPlaces(spacing), decimalPlaces(niceMin));
+    return [Math.round(niceMin * factor) / factor, Math.round(niceMax * factor) / factor];
+}
+/**
+ * `handleTickRangeOptions` (dist/chart.js:10261) without `beginAtZero`: a single value is widened by
+ * 5 % of it (by 1 when it is zero) on both sides.
+ */
+function widened([min, max]) {
+    if (min !== max)
+        return [min, max];
+    const offset = max === 0 ? 1 : Math.abs(max * 0.05);
+    return [min - offset, max + offset];
+}
+/** Options that change the range or the ticks in ways not modelled: any of them set leaves the fit unknown. */
+const UNMODELLED = [
+    ['min'],
+    ['max'],
+    ['suggestedMin'],
+    ['suggestedMax'],
+    ['grace'],
+    ['ticks', 'stepSize'],
+    ['ticks', 'count'],
+    ['ticks', 'precision']
+];
+/** Linear scales place their range on ticks (`bounds: 'ticks'`). */
+const BOUNDS = {
+    value: 'ticks',
+    pointer: "chart.js@4.5.1 dist/chunks/helpers.dataset.js:936 bounds: 'ticks',"
+};
+/** The most ticks a linear scale makes, at least two (`Math.max(2, maxTicks)`, dist/chart.js:10312). */
+const MAX_TICKS = {
+    value: 11,
+    pointer: 'chart.js@4.5.1 dist/chart.js:10298 maxTicksLimit = maxTicksLimit || 11;'
+};
+/** Above this many ticks the sizes are not listed one by one: the range is left to the layout. */
+const MOST_LISTED = 1000;
+/**
+ * The most ticks the scale makes: `maxTicksLimit || 11`, at least two. The scale's own limit
+ * (`computeTickLimit`, its length over the font's line height) has no cap, so a larger
+ * `maxTicksLimit` is reached on a long scale (K10). A fractional limit is a count of its own (not modelled).
+ */
+function mostTicks(config, scale) {
+    const limit = readFact(config, [...scale, 'ticks', 'maxTicksLimit'], isNumber, MAX_TICKS);
+    if (!limit.known)
+        return limit;
+    if (!Number.isInteger(limit.value))
+        return unknown(limit.path, 'unmodelled');
+    if (limit.value > MOST_LISTED)
+        return unknown(limit.path, 'layout');
+    return { ...limit, value: Math.max(2, limit.value === 0 ? MAX_TICKS.value : limit.value) };
+}
+/**
+ * The ranges a linear value scale with `beginAtZero: false` can take. Its tick limit depends on the
+ * scale's length (`computeTickLimit`, :10373), so every limit from 2 to 11 (or to `ticks.maxTicksLimit`)
+ * is a size the chart can be drawn at; Chart.js widens the range over its layout passes, so the drawn
+ * range lies between them. With `bounds: 'data'` the range is the data's.
+ */
+function ranges(config, scale, data) {
+    const at = formatPath(scale);
+    const bounds = readFact(config, [...scale, 'bounds'], isString, BOUNDS);
+    if (!bounds.known)
+        return bounds;
+    const [min, max] = widened(data);
+    if (bounds.value === 'data')
+        return { known: true, value: [[min, max]], path: at, source: 'config' };
+    if (bounds.value !== 'ticks')
+        return unknown(bounds.path, 'unmodelled');
+    const most = mostTicks(config, scale);
+    if (!most.known)
+        return most;
+    const value = Array.from({ length: most.value - 1 }, (_, index) => tickRange(min, max, index + 2));
+    return { known: true, value, path: at, source: 'config' };
+}
+/**
+ * Why the fit of the scale is not modelled: an option in `UNMODELLED`, or a dataset with `hidden`
+ * (left out of the range, `getMatchingVisibleMetas`). Undefined when it is modelled.
+ */
+function unmodelled(config, scale, datasets) {
+    if (UNMODELLED.some((path) => holds(config, [...scale, ...path])))
+        return 'unmodelled';
+    if (!datasets.known)
+        return datasets.reason;
+    return datasets.items.some(({ segments }) => holds(config, [...segments, 'hidden'])) ? 'unmodelled' : undefined;
+}
+/**
+ * Where zero is in the range a linear value scale fits to the data when its `beginAtZero` is `false`
+ * (bar charts set it `true` for their value scale). Hidden datasets and the options in `UNMODELLED`
+ * are not modelled.
+ */
+export function fitOf(config, key, type, { series, datasets }) {
+    const scale = ['options', 'scales', key];
+    const asked = readFact(config, [...scale, 'beginAtZero'], isBoolean);
+    if (!asked.known)
+        return asked;
+    if (asked.value)
+        return unknown(asked.path, 'inapplicable');
+    if (!type.known || type.value !== 'linear')
+        return unknown(asked.path, type.known ? 'inapplicable' : type.reason);
+    const reason = unmodelled(config, scale, datasets);
+    if (reason !== undefined)
+        return unknown(asked.path, reason);
+    const data = dataRange(series, key, asked.path);
+    if (!data.known)
+        return data;
+    const fitted = ranges(config, scale, data.value);
+    return fitted.known ? zeroFit(fitted.value, asked) : fitted;
+}
+//# sourceMappingURL=fit.js.map

package/dist/fit.js.map

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

package/dist/fixes.d.ts

@@ -0,0 +1,6 @@
+import { type LinearScale, type Remedies } from '@chartguard/quality-core';
+/** Chart.js remedies (CG-05-06), each verified by the review before it is offered. */
+export declare const REMEDIES: Remedies;
+/** The linear scale `bar-log-scale` proposes (CG-05-07 Q2.2: only while the bars span less than 10×). */
+export declare const LINEAR: LinearScale;
+//# sourceMappingURL=fixes.d.ts.map

package/dist/fixes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../src/fixes.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,WAAW,EAEhB,KAAK,QAAQ,EAGb,MAAM,0BAA0B,CAAC;AAElC,sFAAsF;AACtF,eAAO,MAAM,QAAQ,EAAE,QAqBtB,CAAC;AAEF,yGAAyG;AACzG,eAAO,MAAM,MAAM,EAAE,WAIpB,CAAC"}

package/dist/fixes.js

@@ -0,0 +1,30 @@
+import { currentNumber, LONG_MOTION_MS, SHORT_MOTION_MS } from '@chartguard/quality-core';
+/** Chart.js remedies (CG-05-06), each verified by the review before it is offered. */
+export const REMEDIES = {
+    'bar-baseline': (now) => {
+        const value = currentNumber(now);
+        if (value !== undefined && value !== 0)
+            return { value: 0, effect: 'The bars grow from zero again, so their lengths are proportional to their values.' };
+        return now.set && now.value === false
+            ? { value: true, effect: 'The value scale includes zero again (`beginAtZero: true`), so the bars grow from it.' }
+            : undefined;
+    },
+    'reversed-value-axis': (now) => now.set && now.value === true
+        ? { value: false, effect: 'Larger values are drawn higher (or further right) again.' }
+        : undefined,
+    'long-motion': (now, path) => {
+        if (path.endsWith('.loop') && now.set && now.value === true)
+            return { value: false, effect: 'The animation runs once instead of forever.' };
+        const value = currentNumber(now);
+        return path.endsWith('.duration') && value !== undefined && value > LONG_MOTION_MS
+            ? { value: SHORT_MOTION_MS, effect: 'The animation lasts one second instead of more than five.' }
+            : undefined;
+    }
+};
+/** The linear scale `bar-log-scale` proposes (CG-05-07 Q2.2: only while the bars span less than 10×). */
+export const LINEAR = {
+    log: 'logarithmic',
+    linear: 'linear',
+    effect: 'The value scale is linear, so bar lengths encode the values; very small values may become hard to see.'
+};
+//# sourceMappingURL=fixes.js.map

package/dist/fixes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixes.js","sourceRoot":"","sources":["../src/fixes.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EAEb,cAAc,EAGd,eAAe,EACf,MAAM,0BAA0B,CAAC;AAElC,sFAAsF;AACtF,MAAM,CAAC,MAAM,QAAQ,GAAa;IACjC,cAAc,EAAE,CAAC,GAAG,EAAsB,EAAE;QAC3C,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,mFAAmF,EAAE,CAAC;QAClH,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;YACpC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,sFAAsF,EAAE;YACjH,CAAC,CAAC,SAAS,CAAC;IACd,CAAC;IACD,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE,CAC9B,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI;QAC5B,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,0DAA0D,EAAE;QACtF,CAAC,CAAC,SAAS;IACb,aAAa,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI;YAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,cAAc;YACjF,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,2DAA2D,EAAE;YACjG,CAAC,CAAC,SAAS,CAAC;IACd,CAAC;CACD,CAAC;AAEF,yGAAyG;AACzG,MAAM,CAAC,MAAM,MAAM,GAAgB;IAClC,GAAG,EAAE,aAAa;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,wGAAwG;CAChH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { QualityReport } from '@chartguard/core';
+import { type ChartSemantics, type QualityOptions } from '@chartguard/quality-core';
+/** The Chart.js config as library-neutral chart semantics (CG-05-02, CG-05-03). */
+export declare function normalize(config: unknown): ChartSemantics;
+/** The options `analyze` takes, and their check: re-exported so a consumer needs only this adapter. */
+export type { QualityOptions } from '@chartguard/quality-core';
+export { assertQualityOptions, QualityOptionsError } from '@chartguard/quality-core';
+/** The rules' advisory findings on the config, shaped by the caller's rule settings and context (CG-05-05). */
+export declare function analyze(config: unknown, options?: QualityOptions): QualityReport;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACN,KAAK,cAAc,EAOnB,KAAK,cAAc,EAMnB,MAAM,0BAA0B,CAAC;AAelC,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CA6BzD;AAED,uGAAuG;AACvG,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAErF,+GAA+G;AAC/G,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAShF"}