@aceshooting/lyra-ui 2.0.0 → 2.1.0

package/dist/components/chart/chart.js

@@ -8,9 +8,25 @@ import { html, nothing } from 'lit';
 import { property, query, state } from 'lit/decorators.js';
 import { LyraElement } from '../../internal/lyra-element.js';
 import { defineElement } from '../../internal/prefix.js';
+import { nextId, srOnly } from '../../internal/a11y.js';
 import { loadChartJs, loadChartJsWithZoom } from './chart-loader.js';
 import { styles } from './chart.styles.js';
 import '../skeleton/skeleton.js';
+const CHART_TYPES = new Set([
+    'line',
+    'bar',
+    'scatter',
+    'pie',
+    'doughnut',
+    'radar',
+    'polarArea',
+    'bubble',
+]);
+function normalizeChartType(value) {
+    return typeof value === 'string' && CHART_TYPES.has(value)
+        ? value
+        : 'line';
+}
 /**
  * Recursively merges `override` onto `base`, matching JSON-merge semantics:
  * plain objects are merged key-by-key at every depth; arrays, functions, and
@@ -39,15 +55,21 @@ const FALLBACK_TICK_COLOR = '#6b7280';
 const FALLBACK_LEGEND_COLOR = '#1a1a1a';
 const FALLBACK_TOOLTIP_BG = '#fff';
 const FALLBACK_TOOLTIP_TEXT = '#1a1a1a';
-function deepMerge(base, override) {
+function deepMerge(base, override, seen = new WeakMap()) {
+    if (typeof override === 'object' && override !== null) {
+        const previous = seen.get(override);
+        if (previous !== undefined)
+            return previous;
+    }
     if (!isPlainObject(base) || !isPlainObject(override)) {
         return (override === undefined ? base : override);
     }
     const result = { ...base };
+    seen.set(override, result);
     for (const key of Object.keys(override)) {
         if (UNSAFE_KEYS.has(key))
             continue;
-        result[key] = deepMerge(base[key], override[key]);
+        result[key] = deepMerge(base[key], override[key], seen);
     }
     return result;
 }
@@ -76,7 +98,12 @@ function deepMerge(base, override) {
  *   intersect-only — see `handlePointClick()`) a data point/segment.
  *   `detail: { datasetIndex: number, index: number, label: string |
  *   undefined, value: unknown }`.
- * @csspart base, canvas, reset-zoom-button
+ * @csspart base - The chart wrapper.
+ * @csspart canvas - The Chart.js canvas.
+ * @csspart reset-zoom-button - The reset-zoom control when zoom is active.
+ * @csspart description - The accessible chart summary.
+ * @csspart data-table - The optional generated or slotted data table.
+ * @slot data-table - An optional consumer-provided accessible table alternative.
  */
 export class LyraChart extends LyraElement {
     constructor() {
@@ -92,6 +119,12 @@ export class LyraChart extends LyraElement {
         this.yLabel = '';
         this.y2Label = '';
         this.beginAtZero = true;
+        /** Accessible name applied to the canvas. Falls back to the dataset labels. */
+        this.accessibleLabel = '';
+        /** Accessible description for the canvas. When unset, a concise data/trend summary is generated. */
+        this.accessibleDescription = '';
+        /** Makes the generated data table visible; it remains screen-reader available when false. */
+        this.showDataTable = false;
         /** Sets `options.indexAxis = 'y'`, Chart.js's own mechanism for horizontal bars (also applies to line/area types). */
         this.horizontal = false;
         /** Stacks the `x`/`y`(/`y2`) scale entries `buildScales()` returns; only meaningful for `bar` and `line` types. */
@@ -100,15 +133,15 @@ export class LyraChart extends LyraElement {
         this.loading = true;
         this.zoomed = false;
         this.visible = true;
-        this.lastSignature = '';
         // `chartjs-plugin-zoom`'s own `resetZoom()` synchronously re-invokes the
         // `onZoomComplete` callback below as part of its reset, which would emit a
         // stale `{zoomed: true}` right before `resetZoom()` emits the real
         // `{zoomed: false}`. Set while this component's own `resetZoom()` is
         // driving the plugin so that re-entrant callback is ignored.
         this.suppressZoomComplete = false;
+        this.descriptionId = nextId('chart-description');
     }
-    static { this.styles = [LyraElement.styles, styles]; }
+    static { this.styles = [LyraElement.styles, styles, srOnly]; }
     connectedCallback() {
         super.connectedCallback();
         const load = this.zoom ? loadChartJsWithZoom() : loadChartJs();
@@ -137,6 +170,27 @@ export class LyraChart extends LyraElement {
         this.chart = undefined;
         this.intersectionObserver?.disconnect();
     }
+    /**
+     * Resets a stale `zoomed` flag before the render pass that's about to call
+     * `draw()`: a `type` (or `config.type` override) change that lands on a
+     * *different* effective Chart.js type makes `draw()` destroy the old
+     * `Chart` instance and construct a brand-new one, which was never zoomed —
+     * without this, `render()`'s reset-zoom-button stays visible for an
+     * instance that has no zoom/pan state left to reset. Computed here (before
+     * render), not in `updated()`/`draw()`, because setting `zoomed` — a
+     * reactive `@state` property — from `updated()` would schedule a second,
+     * redundant update pass; `willUpdate()` runs before this cycle's render is
+     * considered complete, so the same set just folds into the render already
+     * in progress. Same rationale as `toast-item.ts`'s `willUpdate()`-vs-
+     * `updated()` split.
+     */
+    willUpdate() {
+        if (!this.zoomed)
+            return;
+        if (this.effectiveType() !== this.builtType) {
+            this.zoomed = false;
+        }
+    }
     updated(changed) {
         // Disconnected between the property change that scheduled this update
         // and Lit's (microtask-deferred) processing of it — e.g. a property
@@ -186,15 +240,27 @@ export class LyraChart extends LyraElement {
                 this.draw();
             });
         }
-        const onlyZoomChanged = changed.size === 1 && changed.has('zoomed');
-        if (onlyZoomChanged)
+        const contentChanged = [
+            'type',
+            'labels',
+            'datasets',
+            'legend',
+            'area',
+            'height',
+            'xLabel',
+            'yLabel',
+            'y2Label',
+            'beginAtZero',
+            'horizontal',
+            'stacked',
+            'config',
+            'zoom',
+            'loading',
+        ].some((name) => changed.has(name));
+        if (!contentChanged)
             return;
         if (!this.visible)
             return; // becoming visible again triggers its own draw() via the observer above
-        const signature = this.computeSignature();
-        if (signature === this.lastSignature)
-            return;
-        this.lastSignature = signature;
         this.draw();
     }
     seriesToDataset(s) {
@@ -244,29 +310,6 @@ export class LyraChart extends LyraElement {
             tooltipText: cs.getPropertyValue('--lyra-chart-tooltip-text').trim() || FALLBACK_TOOLTIP_TEXT,
         };
     }
-    /**
-     * A content-affecting-properties fingerprint used by `updated()` to skip a
-     * redundant `draw()` when neither visibility nor any of these properties
-     * actually changed since the last draw (e.g. an unrelated property/state
-     * update, or `requestUpdate()` with nothing changed). Mirrors
-     * `lite-chart.ts`'s `computeSignature()`.
-     */
-    computeSignature() {
-        return JSON.stringify([
-            this.type,
-            this.labels,
-            this.datasets,
-            this.legend,
-            this.area,
-            this.xLabel,
-            this.yLabel,
-            this.y2Label,
-            this.beginAtZero,
-            this.horizontal,
-            this.stacked,
-            this.config,
-        ]);
-    }
     /**
      * Builds `options.scales` for the effective chart type: no scale at all for
      * pie/doughnut (a proportional-area chart has no axis), the single radial
@@ -352,6 +395,17 @@ export class LyraChart extends LyraElement {
         const value = chart.data.datasets[datasetIndex]?.data?.[index] ?? null;
         this.emit('lyra-point-click', { datasetIndex, index, label, value });
     }
+    /**
+     * `config.type` (if set) overrides the attribute `type` post-merge — this
+     * is the one place that resolution logic lives, shared by `buildConfig()`
+     * (which needs it to build scales/interaction for the right type) and
+     * `willUpdate()` (which needs it to detect a type change against the last
+     * *actually built* type, `this.builtType`, before the render pass that
+     * would rebuild the `Chart` instance).
+     */
+    effectiveType() {
+        return (this.config?.type ?? normalizeChartType(this.type));
+    }
     buildConfig() {
         const theme = this.themeColors();
         // Resolve the effective type up front: `config.type` (if set) overrides
@@ -359,8 +413,7 @@ export class LyraChart extends LyraElement {
         // for *that* type, not `this.type` — otherwise a config.type override
         // (e.g. line -> radar) ships with the wrong axis shape (categorical x/y
         // instead of a radial r scale).
-        const effectiveType = this.config?.type ??
-            this.type;
+        const effectiveType = this.effectiveType();
         const generated = {
             type: effectiveType,
             data: {
@@ -463,6 +516,56 @@ export class LyraChart extends LyraElement {
     refreshTheme() {
         this.draw();
     }
+    seriesValues(series) {
+        if (series.points)
+            return series.points.map((point) => point.y).filter((value) => Number.isFinite(value));
+        return (series.data ?? []).filter((value) => value != null && Number.isFinite(value));
+    }
+    chartDescription() {
+        if (this.accessibleDescription)
+            return this.accessibleDescription;
+        const summaries = this.datasets.map((series) => {
+            const values = this.seriesValues(series);
+            if (!values.length)
+                return `${series.label}: no data`;
+            const first = values[0];
+            const last = values[values.length - 1];
+            const trend = last > first ? 'increasing' : last < first ? 'decreasing' : 'flat';
+            let min = values[0];
+            let max = values[0];
+            for (const value of values) {
+                min = Math.min(min, value);
+                max = Math.max(max, value);
+            }
+            return `${series.label}: ${values.length} values, range ${min} to ${max}, ${trend} trend`;
+        });
+        return `${this.effectiveType()} chart${summaries.length ? `. ${summaries.join('. ')}` : ' with no data'}.`;
+    }
+    renderDataTable() {
+        const rowCount = Math.max(this.labels.length, ...this.datasets.map((series) => (series.points ? series.points.length : series.data?.length ?? 0)), 0);
+        return html `
+      <table class=${this.showDataTable ? nothing : 'sr-only'}>
+        <caption>${this.accessibleLabel || 'Chart data'}</caption>
+        <thead>
+          <tr>
+            <th scope="col">Category</th>
+            ${this.datasets.map((series) => html `<th scope="col">${series.label}</th>`)}
+          </tr>
+        </thead>
+        <tbody>
+          ${Array.from({ length: rowCount }, (_, index) => html `
+            <tr>
+              <th scope="row">${this.labels[index] ?? `Point ${index + 1}`}</th>
+              ${this.datasets.map((series) => {
+            const value = series.points ? series.points[index]?.y : series.data?.[index];
+            return html `<td>${value == null || !Number.isFinite(value) ? 'No data' : value}</td>`;
+        })}
+            </tr>
+          `)}
+        </tbody>
+      </table>
+    `;
+    }
     render() {
         if (this.loading) {
             return html `
@@ -471,10 +574,16 @@ export class LyraChart extends LyraElement {
         </div>
       `;
         }
-        const label = this.datasets.map((d) => d.label).join(', ') || 'Chart';
+        const label = this.accessibleLabel || this.datasets.map((d) => d.label).join(', ') || 'Chart';
+        const description = this.chartDescription();
         return html `
       <div part="base">
-        <canvas part="canvas" role="img" aria-label=${label}></canvas>
+        <canvas part="canvas" role="img" aria-label=${label} aria-describedby=${this.descriptionId}></canvas>
+        <p part="description" id=${this.descriptionId} class="sr-only">${description}</p>
+        <div part="data-table">
+          <slot name="data-table"></slot>
+          ${this.renderDataTable()}
+        </div>
         ${this.zoom && this.zoomed
             ? html `<button part="reset-zoom-button" type="button" @click=${() => this.resetZoom()}>
               Reset zoom
@@ -485,7 +594,7 @@ export class LyraChart extends LyraElement {
     }
 }
 __decorate([
-    property()
+    property({ converter: { fromAttribute: (value) => normalizeChartType(value) } })
 ], LyraChart.prototype, "type", void 0);
 __decorate([
     property({ attribute: false })
@@ -517,6 +626,15 @@ __decorate([
 __decorate([
     property({ type: Boolean, attribute: 'begin-at-zero' })
 ], LyraChart.prototype, "beginAtZero", void 0);
+__decorate([
+    property({ attribute: 'accessible-label' })
+], LyraChart.prototype, "accessibleLabel", void 0);
+__decorate([
+    property({ attribute: 'accessible-description' })
+], LyraChart.prototype, "accessibleDescription", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'show-data-table' })
+], LyraChart.prototype, "showDataTable", void 0);
 __decorate([
     property({ type: Boolean })
 ], LyraChart.prototype, "horizontal", void 0);
@@ -539,3 +657,28 @@ __decorate([
     query('canvas')
 ], LyraChart.prototype, "canvasEl", void 0);
 defineElement('chart', LyraChart);
+/**
+ * Installs a read-only `type` accessor pair on a `LyraChart` subclass's
+ * prototype, locking it to `value` — assigning `.type` afterwards (attribute
+ * or property) is silently ignored. `LyraChart` declares `type` as a plain
+ * (decorator-managed) class field, and TypeScript forbids a subclass from
+ * re-declaring a base field as a getter/setter pair via ordinary class
+ * syntax (TS2611), so the accessor pair is installed directly on the
+ * prototype instead, which is runtime-equivalent (same shadowing semantics
+ * as a class-syntax override) without tripping that check. Shared by every
+ * `lyra-*-chart` subclass (bar/line/pie/doughnut/scatter/bubble/radar/
+ * polarArea) plus `lyra-histogram`, replacing what used to be an identical
+ * ~16-line `Object.defineProperty` block copy-pasted into each file.
+ */
+export function lockChartType(ctor, value) {
+    Object.defineProperty(ctor.prototype, 'type', {
+        configurable: true,
+        enumerable: true,
+        get() {
+            return value;
+        },
+        set(_v) {
+            /* locked to `value`; direct writes are ignored */
+        },
+    });
+}

package/dist/components/chart/doughnut-chart.js

@@ -1,4 +1,4 @@
-import { LyraChart } from './chart.js';
+import { LyraChart, lockChartType } from './chart.js';
 import { defineElement } from '../../internal/prefix.js';
 /**
  * `<lyra-doughnut-chart>` — `<lyra-chart>` with `type` locked to `"doughnut"`.
@@ -7,21 +7,5 @@ import { defineElement } from '../../internal/prefix.js';
  */
 export class LyraDoughnutChart extends LyraChart {
 }
-// `type` is locked read-only rather than a settable class field with just a
-// default value — `LyraChart` declares it as a plain (decorator-managed)
-// class field, and TypeScript forbids a subclass from re-declaring a base
-// field as a getter/setter pair via ordinary class syntax (TS2611) — so the
-// accessor pair is installed directly on the prototype instead, which is
-// runtime-equivalent (same shadowing semantics as a class-syntax override)
-// without tripping that check.
-Object.defineProperty(LyraDoughnutChart.prototype, 'type', {
-    configurable: true,
-    enumerable: true,
-    get() {
-        return 'doughnut';
-    },
-    set(_v) {
-        /* locked to 'doughnut'; direct writes are ignored */
-    },
-});
+lockChartType(LyraDoughnutChart, 'doughnut');
 defineElement('doughnut-chart', LyraDoughnutChart);

package/dist/components/chart/histogram-bin.d.ts

@@ -2,8 +2,11 @@ export interface HistogramBucket {
     label: string;
     count: number;
 }
+export declare const MAX_HISTOGRAM_BINS = 1000;
+/** Converts an untyped bucket count to a bounded, non-negative integer. */
+export declare function normalizeHistogramBinCount(binCount: unknown): number;
 /** Splits `values` into `binCount` equal-width buckets and counts membership.
  *  Non-finite `binCount` (or <= 0) yields no buckets; a fractional `binCount`
- *  is floored; non-finite samples in `values` are dropped rather than
- *  corrupting bucket-index math. */
+ *  is floored and an excessive count is capped; non-finite samples in
+ *  `values` are dropped rather than corrupting bucket-index math. */
 export declare function binValues(values: number[], binCount: number): HistogramBucket[];

package/dist/components/chart/histogram-bin.js

@@ -1,12 +1,20 @@
+export const MAX_HISTOGRAM_BINS = 1_000;
+/** Converts an untyped bucket count to a bounded, non-negative integer. */
+export function normalizeHistogramBinCount(binCount) {
+    const numeric = typeof binCount === 'number' ? binCount : Number(binCount);
+    if (!Number.isFinite(numeric))
+        return 0;
+    return Math.min(MAX_HISTOGRAM_BINS, Math.max(0, Math.floor(numeric)));
+}
 /** Splits `values` into `binCount` equal-width buckets and counts membership.
  *  Non-finite `binCount` (or <= 0) yields no buckets; a fractional `binCount`
- *  is floored; non-finite samples in `values` are dropped rather than
- *  corrupting bucket-index math. */
+ *  is floored and an excessive count is capped; non-finite samples in
+ *  `values` are dropped rather than corrupting bucket-index math. */
 export function binValues(values, binCount) {
     const finite = values.filter((v) => Number.isFinite(v));
-    if (finite.length === 0 || !Number.isFinite(binCount))
+    if (finite.length === 0)
         return [];
-    const bins = Math.floor(binCount);
+    const bins = normalizeHistogramBinCount(binCount);
     if (bins <= 0)
         return [];
     let lo = finite[0];

package/dist/components/chart/histogram.js

@@ -5,10 +5,10 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { property } from 'lit/decorators.js';
-import { LyraChart } from './chart.js';
+import { LyraChart, lockChartType } from './chart.js';
 import { LyraElement } from '../../internal/lyra-element.js';
 import { defineElement } from '../../internal/prefix.js';
-import { binValues } from './histogram-bin.js';
+import { binValues, normalizeHistogramBinCount, } from './histogram-bin.js';
 import { styles } from './histogram.styles.js';
 /**
  * `<lyra-histogram>` — bins `values` into `bins` equal-width buckets and
@@ -32,7 +32,7 @@ export class LyraHistogram extends LyraChart {
     static { this.styles = [LyraElement.styles, styles]; }
 }
 __decorate([
-    property({ type: Number })
+    property({ converter: { fromAttribute: (value) => normalizeHistogramBinCount(value) } })
 ], LyraHistogram.prototype, "bins", void 0);
 __decorate([
     property({ attribute: false })
@@ -48,12 +48,13 @@ __decorate([
 // change doesn't re-run the O(n) bucketing loop from scratch on every access.
 const bucketCache = new WeakMap();
 export function binnedBuckets(el) {
+    const bins = normalizeHistogramBinCount(el.bins);
     const cached = bucketCache.get(el);
-    if (cached && cached.values === el.values && cached.bins === el.bins) {
+    if (cached && cached.values === el.values && cached.bins === bins) {
         return cached.buckets;
     }
-    const buckets = binValues(el.values, el.bins);
-    bucketCache.set(el, { values: el.values, bins: el.bins, buckets });
+    const buckets = binValues(el.values, bins);
+    bucketCache.set(el, { values: el.values, bins, buckets });
     return buckets;
 }
 // `labels`/`datasets` are computed from `values`/`bins` rather than settable
@@ -87,14 +88,5 @@ Object.defineProperty(LyraHistogram.prototype, 'datasets', {
 // just a default value, not an enforced lock, so without this a `type="line"`
 // attribute (or `el.type = 'line'`) would silently turn a histogram into a
 // line chart of its own bucket counts.
-Object.defineProperty(LyraHistogram.prototype, 'type', {
-    configurable: true,
-    enumerable: true,
-    get() {
-        return 'bar';
-    },
-    set(_v) {
-        /* locked to 'bar'; direct writes are ignored */
-    },
-});
+lockChartType(LyraHistogram, 'bar');
 defineElement('histogram', LyraHistogram);

package/dist/components/chart/line-chart.js

@@ -1,4 +1,4 @@
-import { LyraChart } from './chart.js';
+import { LyraChart, lockChartType } from './chart.js';
 import { defineElement } from '../../internal/prefix.js';
 /**
  * `<lyra-line-chart>` — `<lyra-chart>` with `type` locked to `"line"`.
@@ -7,21 +7,5 @@ import { defineElement } from '../../internal/prefix.js';
  */
 export class LyraLineChart extends LyraChart {
 }
-// `type` is locked read-only rather than a settable class field with just a
-// default value — `LyraChart` declares it as a plain (decorator-managed)
-// class field, and TypeScript forbids a subclass from re-declaring a base
-// field as a getter/setter pair via ordinary class syntax (TS2611) — so the
-// accessor pair is installed directly on the prototype instead, which is
-// runtime-equivalent (same shadowing semantics as a class-syntax override)
-// without tripping that check.
-Object.defineProperty(LyraLineChart.prototype, 'type', {
-    configurable: true,
-    enumerable: true,
-    get() {
-        return 'line';
-    },
-    set(_v) {
-        /* locked to 'line'; direct writes are ignored */
-    },
-});
+lockChartType(LyraLineChart, 'line');
 defineElement('line-chart', LyraLineChart);

package/dist/components/chart/lite-chart.d.ts

@@ -40,6 +40,22 @@ export type LyraLiteChartLayout = 'fit' | 'scroll';
  * calendar columns — overriding the internal slot math for both bars and
  * their labels. All three are additive and no-ops when left unset.
  *
+ * Seven further additive, opt-in properties: `pointText` overrides the
+ * per-bar/per-point `<title>`/`aria-label` tooltip text (mirrors
+ * `lyra-heatmap`'s `cellText` hook), falling back to the built-in raw-value
+ * template when unset; `roundedBars` draws bars as a rounded-top path
+ * instead of a square-cornered rect; `skipZero` omits a bar entirely (not
+ * just zero-height) for an exactly-`0` value; `padLeft`/`barGapRatio`
+ * override the internal `PAD_LEFT`/`BAR_GROUP_GAP` layout constants; `scale`
+ * (`type="bar"` only) switches the bar-height mapping from the default
+ * linear `niceDomain` fraction to a `Math.sqrt(value / domainMax)`
+ * compression (mirroring `lyra-heatmap`'s matrix-mode `sqrt` scale) so a
+ * skewed dataset's smaller bars don't get washed out by one dominant value
+ * — gridlines/tick labels stay on the linear domain regardless, only the bar
+ * marks' own height changes, and `type="line"` ignores `scale` entirely; and
+ * `hideAxis` suppresses `renderGrid()`'s gridlines/tick labels altogether
+ * (x-axis category labels, rendered separately, are unaffected).
+ *
  * @customElement lyra-lite-chart
  * @event lyra-point-click - Fired when a bar/point is activated (click, or
  *   Enter/Space while focused). `detail: { datasetIndex: number, index:
@@ -55,6 +71,8 @@ export type LyraLiteChartLayout = 'fit' | 'scroll';
  * @csspart legend - The legend row, when `legend` is set.
  * @csspart legend-item - Each legend entry.
  * @csspart legend-swatch - Each legend entry's color swatch.
+ * @csspart live-region - The current mark announcement for keyboard users.
+ * @csspart data-list - A visually hidden list of all plotted data points.
  */
 export declare class LyraLiteChart extends LyraElement {
     static styles: import("lit").CSSResultGroup[];
@@ -92,21 +110,80 @@ export declare class LyraLiteChart extends LyraElement {
      *  coordinate function. Unset (the default) uses the existing internal per-category slot math,
      *  unchanged from before this property existed. */
     barX?: (index: number) => number;
+    /** Formats the per-bar/per-point `<title>`/`aria-label` tooltip text — receives the category
+     *  label, the raw value, and the dataset index. Falls back to the built-in raw-value template
+     *  when unset (mirrors `lyra-heatmap`'s `cellText` hook). */
+    pointText?: (label: string, value: number, datasetIndex: number) => string;
+    /** `type="bar"` only: draws each bar as a rounded-top-corner shape instead of the default
+     *  square-cornered rect. Default `false` renders exactly today's plain `<rect>`. */
+    roundedBars: boolean;
+    /** `type="bar"` only: omits a bar entirely (no mark, no `tabindex`, no tooltip) for a value that
+     *  is exactly `0` — `null`/non-finite values are always skipped regardless of this flag. Default
+     *  `false` preserves today's behavior of a zero-height but focusable/titled bar. */
+    skipZero: boolean;
+    /** Overrides the internal `PAD_LEFT` (36px) plot-left-padding constant. Unset (the default) keeps
+     *  today's fixed 36px. */
+    padLeft?: number;
+    /** Overrides the internal `BAR_GROUP_GAP` (0.2) fraction of a category slot left as a gap between
+     *  categories. Unset (the default) keeps today's fixed 0.2. */
+    barGapRatio?: number;
+    /** `type="bar"` only (no effect on `type="line"`): `'linear'` (default) maps a bar's value to
+     *  height via the standard `niceDomain`-based fraction, unchanged from before this property
+     *  existed. `'sqrt'` instead maps via `Math.sqrt(value / domainMax)` (mirroring `lyra-heatmap`'s
+     *  matrix-mode `sqrt` scale), boosting smaller values relative to one dominant value so a skewed
+     *  dataset's smaller bars don't get washed out. Gridlines/tick labels stay on the linear domain
+     *  either way — only the bar marks' own height mapping changes. */
+    scale: 'linear' | 'sqrt';
+    /** Suppresses `renderGrid()` entirely — no gridlines, no y-axis tick labels. x-axis category
+     *  labels (rendered separately) are unaffected. Default `false` preserves today's behavior. */
+    hideAxis: boolean;
     private plotWidth;
     private plotHeight;
     private visible;
+    /** One roving tab stop across all bar/point marks. */
+    private activeMarkIndex;
+    private liveText;
     private svgEl?;
     private resizeObserver?;
     private intersectionObserver?;
-    private lastSignature;
-    private lastResult?;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
     protected updated(changed: PropertyValues): void;
     private colorFor;
+    /** Dispatches to the host-provided `pointText` formatter when set, otherwise `undefined` (the
+     *  caller falls back to its own built-in template) — mirrors `lyra-heatmap`'s `resolveCellText()`. */
+    private resolvePointText;
+    /** The ordered set of visible marks used by both keyboard navigation and
+     * the screen-reader data alternative. */
+    private interactiveMarks;
+    private markIndexMap;
+    private normalizedMarkIndex;
+    private markAnnouncement;
+    private onMarkFocus;
+    private focusMark;
+    /**
+     * A value-to-y-pixel mapping for a bar's top/bottom edge. `'linear'` (the
+     * default) is the standard `niceDomain`-fraction formula, unchanged from
+     * before `scale` existed. `'sqrt'` instead compresses via
+     * `Math.sqrt(value / domainMax)` (mirroring `lyra-heatmap`'s matrix-mode
+     * `sqrt` branch), clamping `value` to `[0, hi]` first since a negative
+     * input has no real square root — bar charts using `scale="sqrt"` are
+     * expected to carry non-negative data, same assumption as the heatmap
+     * precedent this mirrors.
+     */
+    private barValueToY;
+    /**
+     * A rounded-top-corners `<path>` `d` string for a bar occupying
+     * `[x, y, x+w, y+h]` — an SVG `<rect>` can only express a uniform radius
+     * on all four corners, so `roundedBars` switches the mark to a path
+     * instead of adding `rx`/`ry` to keep the bottom edge square against the
+     * baseline. `r` is clamped so it never exceeds half the bar's width or its
+     * full height (a thin/short bar degrades to a plain rectangle path rather
+     * than self-intersecting).
+     */
+    private roundedBarPath;
     private domain;
-    private computeSignature;
     private emitPoint;
     private onPointKeyDown;
     private renderGrid;