@aceshooting/lyra-ui 9.1.1 → 11.0.0

package/dist/components/charts/chart/box-plot.styles.js

@@ -8,14 +8,6 @@ import{css}from"lit";import{forcedColorLegendSwatchStyles}from"./chart-forced-co
     block-size: auto;
     container-type: inline-size;
     contain-intrinsic-inline-size: var(--lr-size-20rem);
-    /* Same theme tokens as chart.styles.ts's :host — Chart.js renders to
-       canvas, not the DOM, so it can't consume CSS var() directly;
-       box-plot.ts's themeColors() resolves these once per draw() via
-       getComputedStyle, mirroring chart.ts. Each is its own token (rather
-       than reusing the semantic ones directly) so a host can retheme just
-       the chart's grid/ticks/legend/tooltip without affecting unrelated
-       text/border/surface colors elsewhere in the component, while still
-       defaulting to those semantic tokens. */
     --_lr-chart-grid-color: var(--lr-color-border);
     --_lr-chart-tick-color: var(--lr-color-text-quiet);
     --_lr-chart-legend-color: var(--lr-color-text);
@@ -80,9 +72,6 @@ import{css}from"lit";import{forcedColorLegendSwatchStyles}from"./chart-forced-co
   [part~='legend-item'] {
     display: inline-flex;
     align-items: center;
-    /* Both axes, matching <lr-chart>'s legend item: a short series name leaves the swatch+label
-       pair narrower than the min-inline-size hit-area floor below, and the default
-       justify-content (normal => flex-start) dumped that slack on the trailing side. */
     justify-content: center;
     min-inline-size: var(--lr-icon-button-size);
     min-block-size: var(--lr-icon-button-size);
@@ -101,8 +90,6 @@ import{css}from"lit";import{forcedColorLegendSwatchStyles}from"./chart-forced-co
   [part~='legend-item']:where(:hover) {
     background: var(--lr-chart-legend-item-hover-bg, var(--lr-color-brand-quiet));
   }
-  /* Pressed, matching <lr-chart>'s legend item: the same quiet brand tint pushed further toward
-     the text colour, so the mousedown that toggles the series reads as distinct from hovering. */
   [part~='legend-item']:where(:active) {
     background: var(
       --lr-chart-legend-item-active-bg,
@@ -172,14 +159,7 @@ import{css}from"lit";import{forcedColorLegendSwatchStyles}from"./chart-forced-co
     min-inline-size: var(--lr-icon-button-size);
     min-block-size: var(--lr-icon-button-size);
   }
-  /* no-pressed-state: the canvas is a role="application" keyboard surface with no click handler of
-     its own -- pressing it activates a box *inside* the bitmap, which no CSS rule can reach, and
-     re-outlining the whole plot on mousedown would read as the entire chart being the target.
-     Same treatment, and same rationale, as chart.styles.ts's canvas. */
   [part='canvas']:hover {
-    /* Scoped so a consumer can retint/resize just this hover outline without also affecting every
-       other --lr-border-width-thin consumer on the page -- the same indirection rationale as the
-       --lr-chart-grid-color/-tick-color/etc. block above, applied to a state-specific rule. */
     outline: var(--lr-chart-canvas-hover-outline-width, var(--lr-border-width-thin)) solid
       var(--lr-chart-grid-color, var(--_lr-chart-grid-color));
     outline-offset: var(--lr-focus-ring-offset);
@@ -197,4 +177,32 @@ import{css}from"lit";import{forcedColorLegendSwatchStyles}from"./chart-forced-co
     max-inline-size: 100%;
     overflow-wrap: anywhere;
   }
+  [part='data-table-toggle'] {
+    align-self: flex-start;
+    font: inherit;
+    font-size: var(--lr-font-size-xs);
+    min-block-size: var(--lr-icon-button-size);
+    padding: var(--lr-size-0-15rem) var(--lr-size-0-5rem);
+    border: var(--lr-border-width-thin) solid var(--lr-color-border);
+    border-radius: var(--lr-radius);
+    background: var(--lr-color-surface);
+    color: var(--lr-color-text);
+    max-inline-size: 100%;
+    white-space: normal;
+    overflow-wrap: break-word;
+    cursor: pointer;
+  }
+  [part='data-table-toggle']:hover {
+    background: var(--lr-box-plot-data-table-toggle-hover-bg, var(--lr-color-brand-quiet));
+  }
+  [part='data-table-toggle']:active {
+    background: var(
+      --lr-box-plot-data-table-toggle-active-bg,
+      color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active))
+    );
+  }
+  [part='data-table-toggle']:focus-visible {
+    outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);
+    outline-offset: var(--lr-focus-ring-offset);
+  }
 `;export{styles};

package/dist/components/charts/chart/chart-colors.d.ts

@@ -1,4 +1,4 @@
-export { resolveCanvasColor } from '../../../internal/canvas-color.js';
+export { resolveCanvasColor, resolveCanvasColors } from '../../../internal/canvas-color.js';
 /**
  * Resolves the categorical chart ramp to concrete canvas-safe colors. Passing `null` selects the
  * deterministic fallback directly; omitting the argument reads the document theme.

package/dist/components/charts/chart/chart-colors.js

@@ -1 +1 @@
-import{resolveCanvasColor}from"../../../internal/canvas-color.js";const FALLBACK_SERIES_PALETTE=["#0e006e","#4d011a","#862002","#503983","#315fdd","#935e7c","#de6906","#8f81d3"],AREA_FILL_PERCENT=28;import{resolveCanvasColor as resolveCanvasColor2}from"../../../internal/canvas-color.js";function seriesPalette(element){const target=element===void 0&&typeof document<"u"?document.documentElement:element;if(!target||typeof getComputedStyle!="function")return[...FALLBACK_SERIES_PALETTE];const cs=getComputedStyle(target);return FALLBACK_SERIES_PALETTE.map((fallback,index)=>{const number=index+1,color=cs.getPropertyValue(`--lr-color-chart-${number}`).trim()||cs.getPropertyValue(`--lr-theme-color-chart-${number}`).trim()||fallback;return resolveCanvasColor(target,color,fallback)})}function translucentAreaColor(scope,color){if(typeof document>"u"||typeof getComputedStyle!="function")return color;const concrete=resolveCanvasColor(scope,color,color);return resolveCanvasColor(scope,`color-mix(in srgb, ${concrete} ${AREA_FILL_PERCENT}%, transparent)`,concrete)}export{resolveCanvasColor2 as resolveCanvasColor,seriesPalette,translucentAreaColor};
+import{resolveCanvasColor}from"../../../internal/canvas-color.js";const FALLBACK_SERIES_PALETTE=["#0e006e","#4d011a","#862002","#503983","#315fdd","#935e7c","#de6906","#8f81d3"],AREA_FILL_PERCENT=28;import{resolveCanvasColor as resolveCanvasColor2,resolveCanvasColors}from"../../../internal/canvas-color.js";function seriesPalette(element){const target=element===void 0&&typeof document<"u"?document.documentElement:element;if(!target||typeof getComputedStyle!="function")return[...FALLBACK_SERIES_PALETTE];const cs=getComputedStyle(target);return FALLBACK_SERIES_PALETTE.map((fallback,index)=>{const number=index+1,color=cs.getPropertyValue(`--lr-color-chart-${number}`).trim()||cs.getPropertyValue(`--lr-theme-color-chart-${number}`).trim()||fallback;return resolveCanvasColor(target,color,fallback)})}function translucentAreaColor(scope,color){if(typeof document>"u"||typeof getComputedStyle!="function")return color;const concrete=resolveCanvasColor(scope,color,color);return resolveCanvasColor(scope,`color-mix(in srgb, ${concrete} ${AREA_FILL_PERCENT}%, transparent)`,concrete)}export{resolveCanvasColor2 as resolveCanvasColor,resolveCanvasColors,seriesPalette,translucentAreaColor};

package/dist/components/charts/chart/chart-core-loader.d.ts

@@ -29,6 +29,7 @@ export interface ChartJsModule {
     LinearScale: unknown;
     CategoryScale: unknown;
     RadialLinearScale: unknown;
+    LogarithmicScale: unknown;
     Filler: unknown;
     Tooltip: unknown;
     Legend: unknown;

package/dist/components/charts/chart/chart-core-loader.js

@@ -1 +1 @@
-import{resolveOptionalPeerCapability,unwrapOptionalPeerDefault}from"../../../internal/optional-peer-capabilities.js";const CHART_REGISTERABLE_KEYS=["LineController","BarController","ScatterController","DoughnutController","PieController","RadarController","PolarAreaController","BubbleController","LineElement","PointElement","BarElement","ArcElement","LinearScale","CategoryScale","RadialLinearScale","Filler","Tooltip","Legend"];function isObjectLike(value){return(typeof value=="object"||typeof value=="function")&&value!==null}function isConstructor(value){if(typeof value!="function")return!1;try{return Reflect.construct(Object,[],value),!0}catch{return!1}}function missingChartCapability(candidate){if(!isObjectLike(candidate))return"module namespace";if(!isConstructor(candidate.Chart))return"Chart";if(typeof candidate.Chart.register!="function")return"Chart.register";if(!isObjectLike(candidate.defaults))return"defaults";for(const key of CHART_REGISTERABLE_KEYS)if(!isObjectLike(candidate[key]))return key}function isChartJsModule(candidate){return missingChartCapability(candidate)===void 0}function resolveChartJsModule(value){const module=resolveOptionalPeerCapability(value,isChartJsModule);if(module)return module;const candidate=unwrapOptionalPeerDefault(value),missing=missingChartCapability(candidate)??"module namespace";throw new Error(`Invalid optional peer \`chart.js\`: missing or invalid \`${missing}\` capability.`)}let chartJs,registered=!1;async function loadChartModule(importChart=()=>import("chart.js")){try{return resolveChartJsModule(await importChart())}catch(err){return console.warn("<lr-chart> needs the optional peer dependency `chart.js` \u2014 install it with `pnpm add chart.js`:",err),null}}function registerCore(mod){registered||(mod.Chart.register(mod.LineController,mod.BarController,mod.ScatterController,mod.DoughnutController,mod.PieController,mod.RadarController,mod.PolarAreaController,mod.BubbleController,mod.LineElement,mod.PointElement,mod.BarElement,mod.ArcElement,mod.LinearScale,mod.CategoryScale,mod.RadialLinearScale,mod.Filler,mod.Tooltip,mod.Legend),registered=!0)}async function loadAndRegisterChartModule(importChart=()=>import("chart.js"),register=registerCore){const mod=await loadChartModule(importChart);if(!mod)return null;try{return register(mod),mod}catch(error){return console.warn("<lr-chart> could not register the optional `chart.js` peer:",error),null}}function loadChartJs(){return chartJs||(chartJs=loadAndRegisterChartModule()),chartJs}export{loadAndRegisterChartModule,loadChartJs,loadChartModule};
+import{resolveOptionalPeerCapability,unwrapOptionalPeerDefault}from"../../../internal/optional-peer-capabilities.js";const CHART_REGISTERABLE_KEYS=["LineController","BarController","ScatterController","DoughnutController","PieController","RadarController","PolarAreaController","BubbleController","LineElement","PointElement","BarElement","ArcElement","LinearScale","CategoryScale","RadialLinearScale","LogarithmicScale","Filler","Tooltip","Legend"];function isObjectLike(value){return(typeof value=="object"||typeof value=="function")&&value!==null}function isConstructor(value){if(typeof value!="function")return!1;try{return Reflect.construct(Object,[],value),!0}catch{return!1}}function missingChartCapability(candidate){if(!isObjectLike(candidate))return"module namespace";if(!isConstructor(candidate.Chart))return"Chart";if(typeof candidate.Chart.register!="function")return"Chart.register";if(!isObjectLike(candidate.defaults))return"defaults";for(const key of CHART_REGISTERABLE_KEYS)if(!isObjectLike(candidate[key]))return key}function isChartJsModule(candidate){return missingChartCapability(candidate)===void 0}function resolveChartJsModule(value){const module=resolveOptionalPeerCapability(value,isChartJsModule);if(module)return module;const candidate=unwrapOptionalPeerDefault(value),missing=missingChartCapability(candidate)??"module namespace";throw new Error(`Invalid optional peer \`chart.js\`: missing or invalid \`${missing}\` capability.`)}let chartJs,registered=!1;async function loadChartModule(importChart=()=>import("chart.js")){try{return resolveChartJsModule(await importChart())}catch(err){return console.warn("<lr-chart> needs the optional peer dependency `chart.js` \u2014 install it with `pnpm add chart.js`:",err),null}}function registerCore(mod){registered||(mod.Chart.register(mod.LineController,mod.BarController,mod.ScatterController,mod.DoughnutController,mod.PieController,mod.RadarController,mod.PolarAreaController,mod.BubbleController,mod.LineElement,mod.PointElement,mod.BarElement,mod.ArcElement,mod.LinearScale,mod.CategoryScale,mod.RadialLinearScale,mod.LogarithmicScale,mod.Filler,mod.Tooltip,mod.Legend),registered=!0)}async function loadAndRegisterChartModule(importChart=()=>import("chart.js"),register=registerCore){const mod=await loadChartModule(importChart);if(!mod)return null;try{return register(mod),mod}catch(error){return console.warn("<lr-chart> could not register the optional `chart.js` peer:",error),null}}function loadChartJs(){return chartJs||(chartJs=loadAndRegisterChartModule()),chartJs}export{loadAndRegisterChartModule,loadChartJs,loadChartModule};

package/dist/components/charts/chart/chart-feature-loader.d.ts

@@ -6,6 +6,7 @@ export interface ChartPluginCapability {
 }
 export type ZoomPlugin = ChartPluginCapability;
 export type DataLabelsPlugin = ChartPluginCapability;
+export type AnnotationPlugin = ChartPluginCapability;
 /**
  * The outcome of loading an opt-in Chart.js feature after attempting to load
  * the core module. Callers can distinguish an unavailable core from an
@@ -122,3 +123,37 @@ export declare function loadChartJsWithDataLabels(importDataLabels?: () => Promi
     mod: ChartJsModule;
     plugin: DataLabelsPlugin | undefined;
 } | null>;
+/**
+ * Loads `chartjs-plugin-annotation`, validating that the module really exposes a Chart.js plugin
+ * before it is handed to a chart — registering a wrapper namespace or a malformed object would
+ * silently no-op, which is the failure mode `resolveChartPlugin` exists to prevent. Un-memoized so
+ * both the success and the degrade-with-a-warning paths stay directly testable.
+ */
+export declare function loadAnnotationPlugin(importAnnotation?: () => Promise<unknown>): Promise<AnnotationPlugin | undefined>;
+/**
+ * Loads Chart.js plus the annotation plugin and **registers it globally**, preserving a usable core
+ * when the feature peer is absent. Un-memoized twin of `loadChartJsWithAnnotationResult()`, for
+ * failure-path tests.
+ *
+ * Global registration here, per-instance for `chartjs-plugin-datalabels`, and the difference is not
+ * arbitrary. Datalabels draws on every dataset the moment it is globally registered, so registering
+ * it globally would visibly change every other chart on the page. `chartjs-plugin-annotation` is
+ * the `chartjs-plugin-zoom` shape instead: it draws nothing at all unless a chart supplies
+ * `options.plugins.annotation.annotations`, so a global registration is unobservable to a chart
+ * that sets none. It also has to be global -- registration is what installs the plugin's own
+ * element types and their defaults, and an inline `config.plugins` entry skips that, leaving the
+ * plugin to throw on missing `borderWidth`/`borderCapStyle` defaults the moment it draws.
+ */
+export declare function loadChartAndAnnotation(loadChart: () => Promise<ChartJsModule | null>, importAnnotation?: () => Promise<unknown>): Promise<ChartFeatureLoadResult<AnnotationPlugin>>;
+/**
+ * Loads `chart.js` (reusing the cached core load) plus `chartjs-plugin-annotation`, on first actual
+ * demand — most charts set no annotations.
+ *
+ * Registered globally, like `chartjs-plugin-zoom` and unlike `chartjs-plugin-datalabels` — see
+ * `loadChartAndAnnotation()` for why the two differ. The load itself still happens only on first
+ * actual demand, so a page whose charts set no annotations never downloads the peer at all.
+ *
+ * Memoized behind a single promise assigned synchronously before any `await`, closing the
+ * check-then-act race across the `await` boundary that the zoom loader's doc describes.
+ */
+export declare function loadChartJsWithAnnotationResult(importAnnotation?: () => Promise<unknown>): Promise<ChartFeatureLoadResult<AnnotationPlugin>>;

package/dist/components/charts/chart/chart-feature-loader.js

@@ -1 +1 @@
-import{resolveOptionalPeerCapability}from"../../../internal/optional-peer-capabilities.js";import{loadChartJs,loadChartModule}from"./chart-core-loader.js";function isObjectLike(value){return(typeof value=="object"||typeof value=="function")&&value!==null}function isChartPlugin(candidate){return isObjectLike(candidate)&&typeof candidate.id=="string"&&candidate.id.trim().length>0}function resolveChartPlugin(value,packageName){const plugin=resolveOptionalPeerCapability(value,isChartPlugin);if(plugin)return plugin;throw new Error(`Invalid optional peer \`${packageName}\`: expected a plugin with a non-empty string \`id\`.`)}let zoomResultLoad,dataLabelsResultLoad,zoomLoad,dataLabelsLoad;async function loadChartAndZoom(importChart=()=>import("chart.js"),importZoom=()=>import("chartjs-plugin-zoom"),needsZoom=!1){const mod=await loadChartModule(importChart);if(!mod)return null;if(!needsZoom)return{mod,zoomPlugin:void 0};let zoomPlugin;try{zoomPlugin=resolveChartPlugin(await importZoom(),"chartjs-plugin-zoom")}catch(err){console.warn("<lr-chart> zoom support needs the optional peer dependency `chartjs-plugin-zoom` \u2014 charts still render without it, but the `zoom` attribute has no effect until it is installed with `pnpm add chartjs-plugin-zoom`:",err)}return{mod,zoomPlugin}}async function loadChartAndRegisterZoom(loadChart,importZoom=()=>import("chartjs-plugin-zoom")){const mod=await loadChart();if(!mod)return{kind:"core-unavailable"};const zoomPlugin=(await loadChartAndZoom(()=>Promise.resolve(mod),importZoom,!0))?.zoomPlugin;if(!zoomPlugin)return{kind:"feature-unavailable",mod};try{mod.Chart.register(zoomPlugin)}catch(err){return console.warn("<lr-chart> zoom support could not be enabled \u2014 charts still render without it, but the `zoom` attribute has no effect:",err),{kind:"feature-unavailable",mod}}return{kind:"available",mod,plugin:zoomPlugin}}function loadChartJsWithZoomResult(importZoom=()=>import("chartjs-plugin-zoom")){return zoomResultLoad??=loadChartAndRegisterZoom(loadChartJs,importZoom)}function loadChartJsWithZoom(importZoom=()=>import("chartjs-plugin-zoom")){return zoomLoad??=loadChartJsWithZoomResult(importZoom).then(result=>result.kind==="core-unavailable"?null:result.mod)}async function loadDataLabelsPlugin(importDataLabels=()=>import("chartjs-plugin-datalabels")){try{return resolveChartPlugin(await importDataLabels(),"chartjs-plugin-datalabels")}catch(err){console.warn("<lr-chart> data labels need the optional peer dependency `chartjs-plugin-datalabels` \u2014 charts still render without it, but the `data-labels`/`stack-totals` attributes have no effect until it is installed with `pnpm add chartjs-plugin-datalabels`:",err);return}}async function loadChartAndDataLabels(loadChart,importDataLabels=()=>import("chartjs-plugin-datalabels")){const mod=await loadChart();if(!mod)return{kind:"core-unavailable"};const plugin=await loadDataLabelsPlugin(importDataLabels);return plugin?{kind:"available",mod,plugin}:{kind:"feature-unavailable",mod}}function loadChartJsWithDataLabelsResult(importDataLabels=()=>import("chartjs-plugin-datalabels")){return dataLabelsResultLoad??=loadChartAndDataLabels(loadChartJs,importDataLabels)}function loadChartJsWithDataLabels(importDataLabels=()=>import("chartjs-plugin-datalabels")){return dataLabelsLoad??=loadChartJsWithDataLabelsResult(importDataLabels).then(result=>result.kind==="core-unavailable"?null:{mod:result.mod,plugin:result.kind==="available"?result.plugin:void 0})}export{loadChartAndDataLabels,loadChartAndRegisterZoom,loadChartAndZoom,loadChartJsWithDataLabels,loadChartJsWithDataLabelsResult,loadChartJsWithZoom,loadChartJsWithZoomResult,loadDataLabelsPlugin};
+import{resolveOptionalPeerCapability}from"../../../internal/optional-peer-capabilities.js";import{loadChartJs,loadChartModule}from"./chart-core-loader.js";function isObjectLike(value){return(typeof value=="object"||typeof value=="function")&&value!==null}function isChartPlugin(candidate){return isObjectLike(candidate)&&typeof candidate.id=="string"&&candidate.id.trim().length>0}function resolveChartPlugin(value,packageName){const plugin=resolveOptionalPeerCapability(value,isChartPlugin);if(plugin)return plugin;throw new Error(`Invalid optional peer \`${packageName}\`: expected a plugin with a non-empty string \`id\`.`)}let zoomResultLoad,dataLabelsResultLoad,annotationResultLoad,zoomLoad,dataLabelsLoad;async function loadChartAndZoom(importChart=()=>import("chart.js"),importZoom=()=>import("chartjs-plugin-zoom"),needsZoom=!1){const mod=await loadChartModule(importChart);if(!mod)return null;if(!needsZoom)return{mod,zoomPlugin:void 0};let zoomPlugin;try{zoomPlugin=resolveChartPlugin(await importZoom(),"chartjs-plugin-zoom")}catch(err){console.warn("<lr-chart> zoom support needs the optional peer dependency `chartjs-plugin-zoom` \u2014 charts still render without it, but the `zoom` attribute has no effect until it is installed with `pnpm add chartjs-plugin-zoom`:",err)}return{mod,zoomPlugin}}async function loadChartAndRegisterZoom(loadChart,importZoom=()=>import("chartjs-plugin-zoom")){const mod=await loadChart();if(!mod)return{kind:"core-unavailable"};const zoomPlugin=(await loadChartAndZoom(()=>Promise.resolve(mod),importZoom,!0))?.zoomPlugin;if(!zoomPlugin)return{kind:"feature-unavailable",mod};try{mod.Chart.register(zoomPlugin)}catch(err){return console.warn("<lr-chart> zoom support could not be enabled \u2014 charts still render without it, but the `zoom` attribute has no effect:",err),{kind:"feature-unavailable",mod}}return{kind:"available",mod,plugin:zoomPlugin}}function loadChartJsWithZoomResult(importZoom=()=>import("chartjs-plugin-zoom")){return zoomResultLoad??=loadChartAndRegisterZoom(loadChartJs,importZoom)}function loadChartJsWithZoom(importZoom=()=>import("chartjs-plugin-zoom")){return zoomLoad??=loadChartJsWithZoomResult(importZoom).then(result=>result.kind==="core-unavailable"?null:result.mod)}async function loadDataLabelsPlugin(importDataLabels=()=>import("chartjs-plugin-datalabels")){try{return resolveChartPlugin(await importDataLabels(),"chartjs-plugin-datalabels")}catch(err){console.warn("<lr-chart> data labels need the optional peer dependency `chartjs-plugin-datalabels` \u2014 charts still render without it, but the `data-labels`/`stack-totals` attributes have no effect until it is installed with `pnpm add chartjs-plugin-datalabels`:",err);return}}async function loadChartAndDataLabels(loadChart,importDataLabels=()=>import("chartjs-plugin-datalabels")){const mod=await loadChart();if(!mod)return{kind:"core-unavailable"};const plugin=await loadDataLabelsPlugin(importDataLabels);return plugin?{kind:"available",mod,plugin}:{kind:"feature-unavailable",mod}}function loadChartJsWithDataLabelsResult(importDataLabels=()=>import("chartjs-plugin-datalabels")){return dataLabelsResultLoad??=loadChartAndDataLabels(loadChartJs,importDataLabels)}function loadChartJsWithDataLabels(importDataLabels=()=>import("chartjs-plugin-datalabels")){return dataLabelsLoad??=loadChartJsWithDataLabelsResult(importDataLabels).then(result=>result.kind==="core-unavailable"?null:{mod:result.mod,plugin:result.kind==="available"?result.plugin:void 0})}async function loadAnnotationPlugin(importAnnotation=()=>import("chartjs-plugin-annotation")){try{return resolveChartPlugin(await importAnnotation(),"chartjs-plugin-annotation")}catch(err){console.warn("<lr-chart> annotations need the optional peer dependency `chartjs-plugin-annotation` \u2014 charts still render without it, but the `annotations` property has no effect until it is installed with `pnpm add chartjs-plugin-annotation`:",err);return}}async function loadChartAndAnnotation(loadChart,importAnnotation=()=>import("chartjs-plugin-annotation")){const mod=await loadChart();if(!mod)return{kind:"core-unavailable"};const plugin=await loadAnnotationPlugin(importAnnotation);if(!plugin)return{kind:"feature-unavailable",mod};try{mod.Chart.register(plugin)}catch(err){return console.warn("<lr-chart> annotations could not be enabled \u2014 charts still render without them, but the `annotations` property has no effect:",err),{kind:"feature-unavailable",mod}}return{kind:"available",mod,plugin}}function loadChartJsWithAnnotationResult(importAnnotation=()=>import("chartjs-plugin-annotation")){return annotationResultLoad??=loadChartAndAnnotation(loadChartJs,importAnnotation)}export{loadAnnotationPlugin,loadChartAndAnnotation,loadChartAndDataLabels,loadChartAndRegisterZoom,loadChartAndZoom,loadChartJsWithAnnotationResult,loadChartJsWithDataLabels,loadChartJsWithDataLabelsResult,loadChartJsWithZoom,loadChartJsWithZoomResult,loadDataLabelsPlugin};

package/dist/components/charts/chart/chart.class.d.ts

@@ -1,6 +1,7 @@
 import { type TemplateResult, type PropertyValues } from 'lit';
 import { LyraElement } from '../../../internal/lyra-element.js';
 import '../../overlays/skeleton/skeleton.class.js';
+import type { LyraVariant } from '../../../internal/variants.js';
 import { type LyraChartLegendVisibilityChangeDetail } from './chart-legend-visibility.js';
 export type { LyraChartLegendVisibilityChangeDetail } from './chart-legend-visibility.js';
 export { seriesPalette } from './chart-colors.js';
@@ -44,6 +45,24 @@ export interface LyraChartSeries {
 export type LyraChartType = 'line' | 'bar' | 'scatter' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble';
 export type LyraChartGrid = 'x' | 'y' | 'both' | 'none';
 export type LyraChartIndexAxis = 'x' | 'y';
+/** Scale type for a chart's value axis. The categorical axis is never affected. */
+export type LyraChartScaleType = 'linear' | 'logarithmic';
+/**
+ * One declarative chart annotation: a reference line (`value`) or a shaded band (`from`/`to`) on
+ * the named axis.
+ *
+ * `value` and `from`/`to` are mutually exclusive; an entry supplying neither, or non-finite
+ * numbers, is dropped rather than handed to Chart.js, where it would silently render nothing or
+ * throw. `axis` defaults to `'y'`, the value axis for the common threshold case.
+ */
+export interface LyraChartAnnotation {
+    readonly axis?: LyraChartIndexAxis;
+    readonly value?: number;
+    readonly from?: number;
+    readonly to?: number;
+    readonly label?: string;
+    readonly tone?: LyraVariant;
+}
 export type LyraChartLayoutPosition = 'left' | 'top' | 'right' | 'bottom' | 'center' | 'chartArea' | {
     [scaleId: string]: number;
 };
@@ -212,6 +231,7 @@ export interface LyraChartEventMap {
  * @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.
+ * @csspart data-table-toggle - The disclosure button rendered by `dataTableToggle`.
  * @csspart center - The chart-area-centered overlay wrapper for the `center` slot.
  * @csspart error - Static visible error shown instead of `canvas` when the optional `chart.js`
  *   peer dependency is not installed; its transition is announced through a shared light-DOM alert.
@@ -241,6 +261,11 @@ export interface LyraChartEventMap {
  *   of an actionable generated-table value.
  * @cssprop --lr-chart-data-table-button-active-bg - Pressed background of an actionable generated-
  *   table value; defaults to the standard active mix of `--lr-color-brand-quiet`.
+ * @cssprop [--lr-chart-data-table-toggle-hover-bg=var(--lr-color-brand-quiet)] - Hover background
+ *   of the `dataTableToggle` disclosure button.
+ * @cssprop --lr-chart-data-table-toggle-active-bg - Pressed background of the `dataTableToggle`
+ *   disclosure button; defaults to a mix of the hover background with the shared active mix
+ *   partner.
  * @cssprop [--lr-chart-reset-zoom-button-hover-bg=var(--lr-color-brand-quiet)] - Hover background
  *   of the reset-zoom button.
  * @cssprop --lr-chart-reset-zoom-button-active-bg - Pressed background of the reset-zoom button;
@@ -308,6 +333,33 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     label: string | null;
     /** Legend placement. `auto` uses a right legend above 480px and a bottom legend below it. */
     legendPosition: LyraChartLegendPosition;
+    /**
+     * Scale type for the **value** axis (the categorical axis is unaffected). `'logarithmic'` plots
+     * a dataset spanning several orders of magnitude honestly, where a linear axis collapses
+     * everything below the maximum into the baseline. Inherited by `lr-line-chart`,
+     * `lr-scatter-chart` and `lr-bar-chart`.
+     *
+     * A logarithmic axis cannot represent zero or negative values (`log(0)` is `-Infinity`), so
+     * `beginAtZero` is not forwarded in that mode -- Chart.js would otherwise be handed a bound it
+     * cannot place. Non-positive data points are dropped by Chart.js's own log scale.
+     */
+    scaleType: LyraChartScaleType;
+    /**
+     * Declarative reference lines and shaded bands — a threshold, an event year, a regime change, a
+     * highlighted period. Each entry marks either a single `value` or a `from`/`to` range on `axis`
+     * (default `'y'`), with an optional `label` and semantic `tone`.
+     *
+     * Needs the optional `chartjs-plugin-annotation` peer, loaded on first actual demand so a page
+     * with no annotated charts never downloads it. The plugin is registered globally, like
+     * `chartjs-plugin-zoom` and unlike `chartjs-plugin-datalabels`: it draws nothing unless a chart
+     * supplies annotation options, so the registration is unobservable to charts that set none, and
+     * registration is also what installs the plugin's own element defaults. Without the peer
+     * installed the chart still renders and a single console warning explains the no-op — the same
+     * fail-closed contract `data-labels` uses.
+     *
+     * Entries are included in the generated accessible description, mirroring `lr-heatmap`.
+     */
+    annotations: readonly LyraChartAnnotation[];
     /** Maximum value-axis bound. Non-finite values are ignored. */
     max: number | null;
     /** Minimum value-axis bound. Non-finite values are ignored. */
@@ -334,6 +386,27 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     beginAtZero: boolean;
     /** Makes the generated data table visible; it remains screen-reader available when false. */
     showDataTable: boolean;
+    /**
+     * Render a disclosure button above the accessible data table so a sighted reader can reveal the
+     * numbers behind the chart on demand. `showDataTable` alone is all-or-nothing -- the table is
+     * either permanently screen-reader-only or permanently visible -- which left a consumer wrapping
+     * a duplicated table in their own `<details>`.
+     *
+     * With this set, `showDataTable` becomes the disclosure's *initial* state rather than its whole
+     * behavior. The table stays in the DOM in both states, so assistive technology never loses it.
+     * @default false
+     */
+    dataTableToggle: boolean;
+    /**
+     * Live disclosure state. Null until the reader actually toggles, so an untouched control keeps
+     * following `showDataTable` (including a later change to it) instead of freezing a seeded copy.
+     */
+    private dataTableExpandedOverride;
+    private readonly dataTableId;
+    /** Whether the data table is currently visible. Identical to `showDataTable` whenever
+     *  `dataTableToggle` is off, which is what keeps the unset path byte-identical to before. */
+    private get dataTableVisible();
+    private toggleDataTable;
     /** Stacks the `x`/`y`(/`y2`) scale entries `buildScales()` returns; only meaningful for `bar` and `line` types. */
     stacked: boolean;
     /** Disables Chart.js animation. */
@@ -422,12 +495,15 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     private loadLibrary;
     private loadZoomFeature;
     private loadDataLabelsFeature;
+    private loadAnnotationFeature;
     private loadGeneration;
     private zoomLoadGeneration;
     private dataLabelsLoadGeneration;
+    private annotationLoadGeneration;
     private zoomFeatureState;
     private dataLabelsFeatureState;
     private dataLabelsPlugin?;
+    private annotationPlugin?;
     private zoomed;
     private visible;
     private intersectionObserver?;
@@ -488,6 +564,14 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     private get zoomFeatureAvailable();
     private featureWarningMessages;
     private requestZoomFeature;
+    private requestAnnotationFeature;
+    /**
+     * Same constraint as `applyDataLabelsPlugin()`: Chart.js reads a config's inline `plugins: [...]`
+     * array ONLY at construction, so a live chart built before the peer resolved cannot gain it
+     * through `chart.update()`. Force reconstruction so the next `draw()` takes the `new Chart()`
+     * branch that reads `config.plugins`.
+     */
+    private applyAnnotationPlugin;
     private requestDataLabelsFeature;
     /**
      * Resets a stale `zoomed` flag before the render pass that's about to call
@@ -533,6 +617,24 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     /** Whether this chart wants the optional `chartjs-plugin-datalabels` peer loaded — either to draw
      *  per-point data labels or per-stack totals. */
     private get needsDataLabels();
+    private get needsAnnotations();
+    /**
+     * The usable annotations: a finite single `value`, or a finite `from`/`to` pair. An entry
+     * supplying neither (or non-finite numbers) is dropped rather than handed to Chart.js, where it
+     * renders nothing at best. A reversed range is normalized rather than rejected — the author's
+     * intent is unambiguous.
+     */
+    private normalizedAnnotations;
+    /** Resolves an annotation tone to a canvas-ready color, through the same
+     *  `getComputedStyle`-then-`resolveCanvasColor` path every other chart color takes — canvas
+     *  silently ignores an unparseable `strokeStyle`/`fillStyle`. */
+    private annotationColor;
+    /**
+     * The `chartjs-plugin-annotation` options for this chart, keyed by a stable synthetic id.
+     * A single `value` becomes a `line` on that axis's scale; a `from`/`to` pair becomes a `box`
+     * bounded on that axis and unbounded on the other.
+     */
+    private annotationOptions;
     /**
      * `options.plugins.datalabels`. Always emitted so the chart also stays inert if
      * a consumer independently registers the peer globally — returns `{ display: false }`
@@ -578,6 +680,10 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     seriesPalette(): string[];
     private tickOptions;
     private effectiveIndexAxis;
+    /** The resolved Chart.js scale type for a value axis, honoring `scaleType`. */
+    private valueScaleType;
+    /** `beginAtZero` for a value axis, suppressed on a logarithmic scale which cannot place zero. */
+    private valueBeginAtZero;
     private scaleBounds;
     private gridAxisVisible;
     /**
@@ -673,6 +779,20 @@ export declare class LyraChart extends LyraElement<LyraChartEventMap> {
     private summarizeSeries;
     private formatSummaryValue;
     private formatTableValue;
+    /**
+     * The `'export'` surface, for CSV cells. `LyraChartFormatSurface` has always declared it and
+     * `<lr-lite-chart>` has always emitted it, but this component never did -- so one formatter
+     * written against the documented contract behaved differently depending on which chart rendered
+     * it, silently, in exactly the place unit formatting matters most.
+     *
+     * Deliberately NOT falling back to `formatSummaryValue()`: with no formatter installed a CSV cell
+     * must stay the raw machine-readable number, not a locale-grouped string a spreadsheet would
+     * misparse. `undefined` means "leave the cell as it was".
+     */
+    private formatExportValue;
+    /** The `'spoken'` surface, for the live announcement a keyboard user hears. Falls back to the
+     *  locale number format, which is what it always used. */
+    private formatSpokenValue;
     private tableStackAxes;
     private tableStackTotalLabel;
     private accessibleName;