@eagami/ui 5.50.0 → 5.52.0

package/types/eagami-ui.d.ts

@@ -57,6 +57,23 @@ export interface EagamiMessages {
   breadcrumbs: {
     label: string;
   };
+  chart: {
+    /** Announced role of a chart's plot, in place of the generic "group". */
+    roleDescription: string;
+    lineChart: string;
+    barChart: string;
+    pieChart: string;
+    /** Header of the data table's label column. */
+    category: string;
+    value: string;
+    /** Header of a pie chart's percentage column. */
+    share: string;
+    noData: string;
+    /** Announces the highlighted point of a line or bar chart. */
+    point: (series: string, label: string, value: string) => string;
+    /** Announces the highlighted slice of a pie chart. */
+    slice: (label: string, value: string, percent: string) => string;
+  };
   codeInput: {
     groupLabel: (length: number) => string;
     digitLabel: (index: number, length: number) => string;
@@ -604,6 +621,8 @@ export declare class AccordionItemComponent implements OnInit, OnDestroy {
   private readonly accordion;
   readonly value: import("@angular/core").InputSignal<string>;
   readonly label: import("@angular/core").InputSignal<string>;
+  /** Optional icon component rendered before the label in the header button. */
+  readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly isExpanded: import("@angular/core").Signal<boolean>;
@@ -624,6 +643,11 @@ export declare class AccordionItemComponent implements OnInit, OnDestroy {
       "required": true;
       "isSignal": true;
     };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -1273,6 +1297,322 @@ export declare class BadgeComponent {
     };
   }, {}, never, ["*"], true, never>;
 }
+/** Visual size of a chart; scales its axis, legend, and tooltip text. */
+type ChartSize = EaSize;
+/** One named run of values plotted by a line or bar chart. */
+interface ChartSeries {
+  /** Name shown in the legend, tooltip, and data table. */
+  name: string;
+  /** One value per label; `null` leaves a gap. */
+  data: (number | null)[];
+  /** Any CSS color; defaults to the next slot of the `--color-chart-*` palette. */
+  color?: string;
+}
+/** Payload describing a single plotted value of a line or bar chart. */
+interface ChartPointEvent {
+  seriesIndex: number;
+  seriesName: string;
+  /** Position of the value within its series (and of its label within `labels`). */
+  index: number;
+  label: string;
+  value: number;
+}
+/** Number of categorical colors in the `--color-chart-*` palette. */
+declare const CHART_COLOR_COUNT = 8;
+/** Resolves a series' color, falling back to its slot of the chart palette. */
+declare function chartColor(index: number, override?: string): string;
+/** A value axis extended to round numbers, with the ticks drawn along it. */
+interface NiceScale {
+  min: number;
+  max: number;
+  ticks: number[];
+}
+/** Extends `[min, max]` outward to round tick values, about `maxTicks` of them. */
+declare function niceScale(min: number, max: number, maxTicks?: number): NiceScale;
+/** Rough rendered width of `text` in px, for reserving axis room without a layout pass. */
+declare function estimateTextWidth(text: string, fontPx: number): number;
+/** Live size of a chart's host, re-measured on resize and whenever `size` changes. */
+interface ChartViewport {
+  width: Signal<number>;
+  fontSize: Signal<number>;
+}
+/**
+ * Measures the host's width and font-size so the chart can lay out its SVG in
+ * real pixels, keeping text and stroke widths crisp at every width.
+ */
+declare function injectChartViewport(size: Signal<ChartSize>): ChartViewport;
+/** Localized value formatter honouring a consumer's own `formatValue`. */
+declare function injectChartFormatter(formatValue: Signal<((value: number) => string) | null>): Signal<(value: number) => string>;
+/** Keeps a value inside `[min, max]`. */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * How category or x-axis labels are set: level, at 45 degrees, at 90 degrees, or
+ * `auto`, which stays level while the labels fit and turns them 45 then 90 degrees
+ * as they crowd.
+ */
+type ChartLabelOrientation = 'horizontal' | 'diagonal' | 'vertical' | 'auto';
+declare const CHART_LABEL_ANGLES: Record<Exclude<ChartLabelOrientation, 'auto'>, number>;
+declare const TICK_EXTRA_PX = 2;
+declare const TICK_LABEL_GAP_PX = 2;
+declare const BREAK_CLEARANCE = 6;
+declare const BREAK_HEIGHT = 2.5;
+/** Length of a tick mark below the axis. */
+declare function tickLength(axisPx: number): number;
+/** Room along the axis a label needs: its width when level, a line's height when turned. */
+declare function labelRoom(text: string, angle: number, axisPx: number): number;
+/** Space below the plot for the axis labels, turned to `angle` degrees, and their ticks. */
+declare function labelBand(widest: number, angle: number, axisPx: number, height: number): number;
+/** Baseline of the axis labels below an axis at `axisY`. */
+declare function labelLine(axisY: number, angle: number, axisPx: number): number;
+interface AxisBreak {
+  axis: string;
+  slashes: string;
+  gap: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+}
+/** A y-axis line up the plot's left edge, cut where two parallel slashes cross it. */
+declare function axisBreak(x: number, top: number, bottom: number, y: number, axisPx: number): AxisBreak;
+/** Direction the bars extend from the baseline. */
+export type BarChartOrientation = 'vertical' | 'horizontal';
+/**
+ * Entrance animation, replayed whenever the data changes. `grow` extends every
+ * bar out of the baseline together, `cascade` grows them one category after
+ * another, and `fade` fades the bars in.
+ */
+export type BarChartAnimation = 'grow' | 'cascade' | 'fade' | 'none';
+interface PlotBar {
+  series: number;
+  index: number;
+  value: number;
+  color: string;
+  path: string;
+  delay: number;
+}
+interface PlotValueLabel {
+  key: string;
+  x: number;
+  y: number;
+  text: string;
+  anchor: 'start' | 'middle' | 'end';
+}
+interface ActiveBar {
+  series: number;
+  index: number;
+}
+/**
+ * Compares values across labels as vertical columns or horizontal bars, with
+ * several series grouped side by side or stacked. Hovering or arrowing through
+ * the chart reveals each label's values in a tooltip, and a visually hidden
+ * table carries the full data for screen readers.
+ */
+export declare class BarChartComponent {
+  protected readonly i18n: EagamiI18nService;
+  /** Category labels along the category axis, one per value. */
+  readonly labels: import("@angular/core").InputSignal<string[]>;
+  /** The series to plot. */
+  readonly series: import("@angular/core").InputSignal<ChartSeries[]>;
+  /** Direction the bars extend from the baseline. */
+  readonly orientation: import("@angular/core").InputSignal<BarChartOrientation>;
+  /** Stacks the series of each label into one bar instead of grouping them side by side. */
+  readonly stacked: import("@angular/core").InputSignal<boolean>;
+  /** Draws gridlines at each value-axis tick. */
+  readonly showGrid: import("@angular/core").InputSignal<boolean>;
+  /** Shows a legend beneath the chart when it plots more than one series. */
+  readonly showLegend: import("@angular/core").InputSignal<boolean>;
+  /** Prints each bar's value at its end, or each stack's total when stacked. */
+  readonly showValues: import("@angular/core").InputSignal<boolean>;
+  /** How the category labels under a vertical chart are set; `auto` turns them as they run out of room. */
+  readonly xLabelOrientation: import("@angular/core").InputSignal<ChartLabelOrientation>;
+  /**
+   * Starts the value axis of a vertical chart near its shortest bar instead of at
+   * zero, when every value is positive, and marks the cut with a break symbol.
+   */
+  readonly showAxisBreak: import("@angular/core").InputSignal<boolean>;
+  /** Height of the plot in pixels; the width fills the container. */
+  readonly height: import("@angular/core").InputSignal<number>;
+  /** Visual size; scales the axis, legend, and tooltip text and the bar thickness cap. */
+  readonly size: import("@angular/core").InputSignal<import("@eagami/ui").EaSize>;
+  /** Entrance animation, replayed whenever the data changes. */
+  readonly animation: import("@angular/core").InputSignal<BarChartAnimation>;
+  /** Length of the entrance animation in milliseconds. */
+  readonly animationDuration: import("@angular/core").InputSignal<number>;
+  /** Formats values on the axis, tooltip, and data table; locale-grouped by default. */
+  readonly formatValue: import("@angular/core").InputSignal<((value: number) => string) | null>;
+  /** Accessible name for the chart; defaults to a localized "Bar chart". */
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Fires when a bar is clicked, or chosen with Enter or Space. */
+  readonly pointClick: import("@angular/core").OutputEmitterRef<ChartPointEvent>;
+  /** Fires when the highlighted bar changes by pointer or keyboard, with `null` once cleared. */
+  readonly activePointChange: import("@angular/core").OutputEmitterRef<ChartPointEvent | null>;
+  private readonly viewport;
+  private readonly format;
+  protected readonly active: import("@angular/core").WritableSignal<ActiveBar | null>;
+  protected readonly label: import("@angular/core").Signal<string>;
+  protected readonly count: import("@angular/core").Signal<number>;
+  protected readonly hasData: import("@angular/core").Signal<boolean>;
+  protected readonly renderPass: import("@angular/core").Signal<{}[]>;
+  protected readonly hostClasses: import("@angular/core").Signal<{
+    [x: string]: boolean;
+  }>;
+  protected readonly layout: import("@angular/core").Signal<{
+    vertical: boolean;
+    width: number;
+    height: number;
+    top: number;
+    left: number;
+    plotWidth: number;
+    plotHeight: number;
+    baseline: number;
+    band: number;
+    categoryStart: number;
+    groupWidth: number;
+    thickness: number;
+    axisPx: number;
+    ticks: {
+      value: number;
+      text: string;
+      pos: number;
+    }[];
+    categories: {
+      text: string;
+      index: number;
+      pos: number;
+    }[];
+    bars: PlotBar[];
+    valueLabels: PlotValueLabel[];
+    valuePos: (v: number) => number;
+    axisY: number;
+    tickEndY: number;
+    labelAngle: number;
+    labelY: number;
+    axisBreak: AxisBreak | null;
+  }>;
+  protected readonly tooltip: import("@angular/core").Signal<{
+    x: number;
+    y: number;
+    title: string;
+    rows: {
+      name: string;
+      color: string;
+      value: string;
+      active: boolean;
+    }[];
+    key: string;
+  } | null>;
+  protected readonly tooltips: import("@angular/core").Signal<{
+    x: number;
+    y: number;
+    title: string;
+    rows: {
+      name: string;
+      color: string;
+      value: string;
+      active: boolean;
+    }[];
+    key: string;
+  }[]>;
+  protected readonly announcement: import("@angular/core").Signal<string>;
+  protected readonly showsLegend: import("@angular/core").Signal<boolean>;
+  protected seriesColor(index: number): string;
+  protected isDimmed(bar: PlotBar): boolean;
+  protected tableValue(value: number | null | undefined): string;
+  protected onPointerMove(event: PointerEvent): void;
+  protected onPointerLeave(): void;
+  protected onClick(): void;
+  protected onFocus(): void;
+  protected onBlur(): void;
+  protected onKeydown(event: KeyboardEvent): void;
+  private valueAt;
+  private stackEnd;
+  private firstIn;
+  private eventFor;
+  private setActive;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BarChartComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BarChartComponent, "ea-bar-chart", never, {
+    "labels": {
+      "alias": "labels";
+      "required": false;
+      "isSignal": true;
+    };
+    "series": {
+      "alias": "series";
+      "required": false;
+      "isSignal": true;
+    };
+    "orientation": {
+      "alias": "orientation";
+      "required": false;
+      "isSignal": true;
+    };
+    "stacked": {
+      "alias": "stacked";
+      "required": false;
+      "isSignal": true;
+    };
+    "showGrid": {
+      "alias": "showGrid";
+      "required": false;
+      "isSignal": true;
+    };
+    "showLegend": {
+      "alias": "showLegend";
+      "required": false;
+      "isSignal": true;
+    };
+    "showValues": {
+      "alias": "showValues";
+      "required": false;
+      "isSignal": true;
+    };
+    "xLabelOrientation": {
+      "alias": "xLabelOrientation";
+      "required": false;
+      "isSignal": true;
+    };
+    "showAxisBreak": {
+      "alias": "showAxisBreak";
+      "required": false;
+      "isSignal": true;
+    };
+    "height": {
+      "alias": "height";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "animation": {
+      "alias": "animation";
+      "required": false;
+      "isSignal": true;
+    };
+    "animationDuration": {
+      "alias": "animationDuration";
+      "required": false;
+      "isSignal": true;
+    };
+    "formatValue": {
+      "alias": "formatValue";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "pointClick": "pointClick";
+    "activePointChange": "activePointChange";
+  }, never, never, true, never>;
+}
 /** Visual style of the separator rendered between breadcrumb items. */
 export type BreadcrumbsSeparator = 'chevron' | 'slash';
 /** Visual size of the breadcrumb trail. */
@@ -3993,6 +4333,352 @@ export declare class InputComponent implements ControlValueAccessor {
     "blurred": "blurred";
   }, never, ["[slot=prefix]", "[slot=suffix]"], true, never>;
 }
+/** How the line bends between points. */
+export type LineChartCurve = 'linear' | 'smooth' | 'step';
+/**
+ * Entrance animation, replayed whenever the data changes. `draw` traces each
+ * line along its length, `reveal` wipes every line in together from left to
+ * right, `fade` fades the plot in, and `rise` grows it up from the baseline.
+ */
+export type LineChartAnimation = 'draw' | 'reveal' | 'fade' | 'rise' | 'none';
+/** A labelled mark along the x-axis, placed on the same scale as `xValues`. */
+export interface LineChartTick {
+  value: number;
+  label: string;
+}
+/** The stretch of the x scale a windowed line chart currently shows. */
+export interface LineChartVisibleRange {
+  start: number;
+  end: number;
+}
+interface PlotPoint {
+  x: number;
+  y: number;
+  index: number;
+  value: number;
+}
+interface PlotSeries {
+  name: string;
+  color: string;
+  paths: string[];
+  areas: string[];
+  points: PlotPoint[];
+}
+interface ActivePoint {
+  series: number;
+  index: number;
+}
+interface XLabel {
+  key: number;
+  text: string;
+  x: number;
+}
+interface PlacedXLabel extends XLabel {
+  textX: number;
+}
+interface XDomain {
+  /** First and last positions on the x scale. */
+  first: number;
+  last: number;
+  /** Positions at the plot's left and right edges. */
+  start: number;
+  end: number;
+  /** Width of the visible window, set only when the data outgrows it. */
+  span: number | null;
+}
+/**
+ * Plots one or more series of values as lines, with optional points and area
+ * fills. Points are spaced evenly by default, or placed along a numeric scale
+ * by `xValues`, with the x-axis labelled per point or by `xTicks`. A
+ * `visibleXSpan` window makes a long run of data pannable. Hovering or
+ * arrowing through the chart reveals each point's values in a tooltip, and a
+ * visually hidden table carries the full data for screen readers.
+ */
+export declare class LineChartComponent {
+  protected readonly i18n: EagamiI18nService;
+  /**
+   * Each point's name, one per value, titling its tooltip and its row in the
+   * data table. Also labels the x-axis, unless `xTicks` is set.
+   */
+  readonly labels: import("@angular/core").InputSignal<string[]>;
+  /** The series to plot. */
+  readonly series: import("@angular/core").InputSignal<ChartSeries[]>;
+  /**
+   * Position of each point along the x-axis, one per value in ascending
+   * order, so points sit proportionally apart. Spaced evenly by index when
+   * unset.
+   */
+  readonly xValues: import("@angular/core").InputSignal<readonly number[] | null>;
+  /**
+   * Marks drawn along the x-axis in place of the per-point labels, each at its
+   * value on the x scale (`xValues`, or the index when unset). They need not
+   * line up with any point, and the axis widens to take in any beyond the points.
+   */
+  readonly xTicks: import("@angular/core").InputSignal<readonly LineChartTick[] | null>;
+  /**
+   * Width of the x range shown at once, in the units of `xValues` (or of
+   * indices when unset). When the data spans more, the chart opens on its
+   * latest stretch and pans by trackpad, Shift + wheel, drag, or the arrow
+   * keys, and a trackpad pinch or Ctrl + wheel widens or narrows the window,
+   * fitting the y-axis to the points in view. `null` shows everything.
+   */
+  readonly visibleXSpan: import("@angular/core").InputSignal<number | null>;
+  /** How the line bends between points. */
+  readonly curve: import("@angular/core").InputSignal<LineChartCurve>;
+  /** Fills the area beneath each line with a light wash of its color. */
+  readonly showArea: import("@angular/core").InputSignal<boolean>;
+  /** Marks every value with a point. */
+  readonly showPoints: import("@angular/core").InputSignal<boolean>;
+  /** Draws horizontal gridlines at each y-axis tick. */
+  readonly showGrid: import("@angular/core").InputSignal<boolean>;
+  /** Shows a legend beneath the chart when it plots more than one series. */
+  readonly showLegend: import("@angular/core").InputSignal<boolean>;
+  /** Lower bound of the y-axis; derived from the data when unset. */
+  readonly yMin: import("@angular/core").InputSignal<number | undefined>;
+  /** Upper bound of the y-axis; derived from the data when unset. */
+  readonly yMax: import("@angular/core").InputSignal<number | undefined>;
+  /** How the x-axis labels are set; `auto` turns them as they run out of room. */
+  readonly xLabelOrientation: import("@angular/core").InputSignal<ChartLabelOrientation>;
+  /** Marks the foot of a y-axis that stops short of zero with a break symbol. */
+  readonly showAxisBreak: import("@angular/core").InputSignal<boolean>;
+  /** Height of the plot in pixels; the width fills the container. */
+  readonly height: import("@angular/core").InputSignal<number>;
+  /** Visual size; scales the axis, legend, and tooltip text. */
+  readonly size: import("@angular/core").InputSignal<import("@eagami/ui").EaSize>;
+  /** Entrance animation, replayed whenever the data changes. */
+  readonly animation: import("@angular/core").InputSignal<LineChartAnimation>;
+  /** Length of the entrance animation in milliseconds. */
+  readonly animationDuration: import("@angular/core").InputSignal<number>;
+  /** Formats values on the axis, tooltip, and data table; locale-grouped by default. */
+  readonly formatValue: import("@angular/core").InputSignal<((value: number) => string) | null>;
+  /** Accessible name for the chart; defaults to a localized "Line chart". */
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Fires when a point is clicked, or chosen with Enter or Space. */
+  readonly pointClick: import("@angular/core").OutputEmitterRef<ChartPointEvent>;
+  /** Fires when the highlighted point changes by pointer or keyboard, with `null` once cleared. */
+  readonly activePointChange: import("@angular/core").OutputEmitterRef<ChartPointEvent | null>;
+  /** Fires with the newly visible x range whenever a windowed chart pans or zooms. */
+  readonly visibleRangeChange: import("@angular/core").OutputEmitterRef<LineChartVisibleRange>;
+  private readonly viewport;
+  private readonly format;
+  protected readonly active: import("@angular/core").WritableSignal<ActivePoint | null>;
+  protected readonly clipId: string;
+  protected readonly breakMaskId: string;
+  private readonly panEnd;
+  private readonly zoomSpan;
+  private gestureSpan;
+  protected readonly panning: import("@angular/core").WritableSignal<boolean>;
+  private drag;
+  private suppressClick;
+  protected readonly label: import("@angular/core").Signal<string>;
+  protected readonly count: import("@angular/core").Signal<number>;
+  protected readonly hasData: import("@angular/core").Signal<boolean>;
+  private readonly positions;
+  protected readonly domain: import("@angular/core").Signal<XDomain>;
+  protected readonly windowed: import("@angular/core").Signal<boolean>;
+  protected readonly renderPass: import("@angular/core").Signal<{}[]>;
+  protected readonly hostClasses: import("@angular/core").Signal<{
+    [x: string]: boolean;
+    'ea-line-chart--pannable': boolean;
+    'ea-line-chart--panning': boolean;
+  }>;
+  private readonly runs;
+  private readonly visibleValues;
+  protected readonly layout: import("@angular/core").Signal<{
+    width: number;
+    height: number;
+    top: number;
+    left: number;
+    plotWidth: number;
+    plotHeight: number;
+    baselineY: number;
+    windowed: boolean;
+    axisBreak: AxisBreak | null;
+    axisY: number;
+    tickEndY: number;
+    labelAngle: number;
+    labelY: number;
+    tickX: number;
+    ticks: {
+      y: number;
+      value: number;
+      text: string;
+    }[];
+    xLabels: PlacedXLabel[];
+    series: PlotSeries[];
+    x: (i: number) => number;
+    y: (v: number) => number;
+  }>;
+  private plotArea;
+  protected readonly tooltip: import("@angular/core").Signal<{
+    x: number;
+    y: number;
+    title: string;
+    rows: {
+      name: string;
+      color: string;
+      value: string;
+      active: boolean;
+    }[];
+    key: string;
+  } | null>;
+  protected readonly tooltips: import("@angular/core").Signal<{
+    x: number;
+    y: number;
+    title: string;
+    rows: {
+      name: string;
+      color: string;
+      value: string;
+      active: boolean;
+    }[];
+    key: string;
+  }[]>;
+  protected readonly announcement: import("@angular/core").Signal<string>;
+  protected readonly showsLegend: import("@angular/core").Signal<boolean>;
+  protected seriesColor(index: number): string;
+  protected isDimmed(index: number): boolean;
+  protected isActivePoint(seriesIndex: number, index: number): boolean;
+  protected tableValue(value: number | null | undefined): string;
+  protected onPointerDown(event: PointerEvent): void;
+  protected onPointerMove(event: PointerEvent): void;
+  protected onPointerUp(event: PointerEvent): void;
+  protected onPointerLeave(): void;
+  protected onWheel(event: WheelEvent): void;
+  protected onClick(): void;
+  protected onFocus(): void;
+  protected onBlur(): void;
+  protected onKeydown(event: KeyboardEvent): void;
+  private isValue;
+  private yScale;
+  private atPosition;
+  private xLabelCandidates;
+  private labelsFit;
+  private xLabels;
+  private widestXLabel;
+  protected onGestureStart(event: Event): void;
+  protected onGestureChange(event: Event): void;
+  protected onGestureEnd(): void;
+  private zoomTo;
+  private minSpan;
+  private unitsPerPx;
+  private panTo;
+  private endDrag;
+  private reveal;
+  private indexAt;
+  private valueAt;
+  private firstPoint;
+  private nearestValid;
+  private eventFor;
+  private setActive;
+  static ɵfac: i0.ɵɵFactoryDeclaration<LineChartComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<LineChartComponent, "ea-line-chart", never, {
+    "labels": {
+      "alias": "labels";
+      "required": false;
+      "isSignal": true;
+    };
+    "series": {
+      "alias": "series";
+      "required": false;
+      "isSignal": true;
+    };
+    "xValues": {
+      "alias": "xValues";
+      "required": false;
+      "isSignal": true;
+    };
+    "xTicks": {
+      "alias": "xTicks";
+      "required": false;
+      "isSignal": true;
+    };
+    "visibleXSpan": {
+      "alias": "visibleXSpan";
+      "required": false;
+      "isSignal": true;
+    };
+    "curve": {
+      "alias": "curve";
+      "required": false;
+      "isSignal": true;
+    };
+    "showArea": {
+      "alias": "showArea";
+      "required": false;
+      "isSignal": true;
+    };
+    "showPoints": {
+      "alias": "showPoints";
+      "required": false;
+      "isSignal": true;
+    };
+    "showGrid": {
+      "alias": "showGrid";
+      "required": false;
+      "isSignal": true;
+    };
+    "showLegend": {
+      "alias": "showLegend";
+      "required": false;
+      "isSignal": true;
+    };
+    "yMin": {
+      "alias": "yMin";
+      "required": false;
+      "isSignal": true;
+    };
+    "yMax": {
+      "alias": "yMax";
+      "required": false;
+      "isSignal": true;
+    };
+    "xLabelOrientation": {
+      "alias": "xLabelOrientation";
+      "required": false;
+      "isSignal": true;
+    };
+    "showAxisBreak": {
+      "alias": "showAxisBreak";
+      "required": false;
+      "isSignal": true;
+    };
+    "height": {
+      "alias": "height";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "animation": {
+      "alias": "animation";
+      "required": false;
+      "isSignal": true;
+    };
+    "animationDuration": {
+      "alias": "animationDuration";
+      "required": false;
+      "isSignal": true;
+    };
+    "formatValue": {
+      "alias": "formatValue";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "pointClick": "pointClick";
+    "activePointChange": "activePointChange";
+    "visibleRangeChange": "visibleRangeChange";
+  }, never, never, true, never>;
+}
 /** Placement of the menu list relative to its trigger. */
 export type MenuPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
 /** Visual size of the menu, shared by all of its items. */
@@ -5030,6 +5716,183 @@ export declare class PaginatorComponent {
     "changed": "changed";
   }, never, never, true, never>;
 }
+/** A solid pie, or a ring with an empty center. */
+export type PieChartVariant = 'pie' | 'donut';
+/**
+ * Entrance animation, replayed whenever the data changes. `sweep` reveals the
+ * slices clockwise from twelve o'clock, `grow` scales the chart out from its
+ * center, and `fade` fades it in.
+ */
+export type PieChartAnimation = 'sweep' | 'grow' | 'fade' | 'none';
+/** One slice of an `<ea-pie-chart>`. */
+export interface PieChartSlice {
+  /** Name shown in the legend, tooltip, and data table. */
+  label: string;
+  /** Size of the slice; negative values count as zero. */
+  value: number;
+  /** Any CSS color; defaults to the next slot of the `--color-chart-*` palette. */
+  color?: string;
+}
+/** Payload describing a single slice of a pie chart. */
+export interface PieChartSliceEvent {
+  index: number;
+  label: string;
+  value: number;
+  /** Share of the total, from 0 to 100. */
+  percent: number;
+}
+interface PlotSlice {
+  index: number;
+  path: string;
+  color: string;
+  midAngle: number;
+  start: number;
+  end: number;
+}
+/**
+ * Shows how parts make up a whole as slices of a pie or donut, with a legend
+ * of labels and shares. Hovering or arrowing through the slices reveals each
+ * one's value in a tooltip, and a visually hidden table carries the full data
+ * for screen readers.
+ */
+export declare class PieChartComponent {
+  protected readonly i18n: EagamiI18nService;
+  /** The slices to draw, clockwise from twelve o'clock. */
+  readonly data: import("@angular/core").InputSignal<PieChartSlice[]>;
+  /** A solid pie, or a ring with an empty center. */
+  readonly variant: import("@angular/core").InputSignal<PieChartVariant>;
+  /** Shows a legend of every slice beside the chart. */
+  readonly showLegend: import("@angular/core").InputSignal<boolean>;
+  /** Adds each slice's share of the total to its legend entry. */
+  readonly showPercentages: import("@angular/core").InputSignal<boolean>;
+  /** Largest diameter of the chart in pixels; it shrinks to fit a narrower container. */
+  readonly height: import("@angular/core").InputSignal<number>;
+  /** Visual size; scales the legend and tooltip text. */
+  readonly size: import("@angular/core").InputSignal<import("@eagami/ui").EaSize>;
+  /** Entrance animation, replayed whenever the data changes. */
+  readonly animation: import("@angular/core").InputSignal<PieChartAnimation>;
+  /** Length of the entrance animation in milliseconds. */
+  readonly animationDuration: import("@angular/core").InputSignal<number>;
+  /** Formats values in the tooltip and data table; locale-grouped by default. */
+  readonly formatValue: import("@angular/core").InputSignal<((value: number) => string) | null>;
+  /** Accessible name for the chart; defaults to a localized "Pie chart". */
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Fires when a slice is clicked, or chosen with Enter or Space. */
+  readonly sliceClick: import("@angular/core").OutputEmitterRef<PieChartSliceEvent>;
+  /** Fires when the highlighted slice changes by pointer or keyboard, with `null` once cleared. */
+  readonly activeSliceChange: import("@angular/core").OutputEmitterRef<PieChartSliceEvent | null>;
+  private readonly viewport;
+  private readonly format;
+  protected readonly active: import("@angular/core").WritableSignal<number | null>;
+  protected readonly label: import("@angular/core").Signal<string>;
+  protected readonly total: import("@angular/core").Signal<number>;
+  protected readonly hasData: import("@angular/core").Signal<boolean>;
+  protected readonly renderPass: import("@angular/core").Signal<{}[]>;
+  protected readonly hostClasses: import("@angular/core").Signal<{
+    [x: string]: boolean;
+  }>;
+  protected readonly layout: import("@angular/core").Signal<{
+    diameter: number;
+    cx: number;
+    cy: number;
+    outer: number;
+    inner: number;
+    slices: PlotSlice[];
+  }>;
+  protected readonly legend: import("@angular/core").Signal<{
+    label: string;
+    color: string;
+    percent: string;
+  }[]>;
+  protected readonly tooltip: import("@angular/core").Signal<{
+    x: number;
+    y: number;
+    title: string;
+    color: string;
+    detail: string;
+    key: number;
+  } | null>;
+  protected readonly tooltips: import("@angular/core").Signal<{
+    x: number;
+    y: number;
+    title: string;
+    color: string;
+    detail: string;
+    key: number;
+  }[]>;
+  protected readonly announcement: import("@angular/core").Signal<string>;
+  protected tableValue(slice: PieChartSlice): string;
+  protected tablePercent(index: number): string;
+  protected isDimmed(index: number): boolean;
+  protected offset(slice: PlotSlice): string | null;
+  protected onPointerMove(event: PointerEvent): void;
+  protected onPointerLeave(): void;
+  protected onClick(): void;
+  protected onFocus(): void;
+  protected onBlur(): void;
+  protected onKeydown(event: KeyboardEvent): void;
+  private sliceValue;
+  private percentOf;
+  private formatPercent;
+  private eventFor;
+  private setActive;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PieChartComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<PieChartComponent, "ea-pie-chart", never, {
+    "data": {
+      "alias": "data";
+      "required": false;
+      "isSignal": true;
+    };
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "showLegend": {
+      "alias": "showLegend";
+      "required": false;
+      "isSignal": true;
+    };
+    "showPercentages": {
+      "alias": "showPercentages";
+      "required": false;
+      "isSignal": true;
+    };
+    "height": {
+      "alias": "height";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "animation": {
+      "alias": "animation";
+      "required": false;
+      "isSignal": true;
+    };
+    "animationDuration": {
+      "alias": "animationDuration";
+      "required": false;
+      "isSignal": true;
+    };
+    "formatValue": {
+      "alias": "formatValue";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "sliceClick": "sliceClick";
+    "activeSliceChange": "activeSliceChange";
+  }, never, never, true, never>;
+}
 /** Semantic colour scheme of the progress bar. */
 export type ProgressBarVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 /** Visual height of the progress bar. */
@@ -6387,6 +7250,12 @@ export declare class TooltipDirective implements OnDestroy {
    * reach its scrollbar. Bubbles that fit hide immediately.
    */
   readonly dismissDelay: import("@angular/core").InputSignal<number>;
+  /**
+   * Shows or hides the bubble programmatically, for a trigger whose moment to
+   * explain itself is not a hover or focus of its own (a chart's highlighted
+   * point, say). `null` leaves it to hover and focus. Escape still dismisses it.
+   */
+  readonly tooltipOpen: import("@angular/core").InputSignal<boolean | null>;
   private tooltipEl;
   /** Side the open bubble settled on, held across repositions while it fits. */
   private placedPosition;
@@ -6411,6 +7280,7 @@ export declare class TooltipDirective implements OnDestroy {
   private readonly scrollListenerOptions;
   private resizeObserver;
   constructor();
+  private controlled;
   ngOnDestroy(): void;
   private syncPointerListeners;
   private show;
@@ -6458,6 +7328,11 @@ export declare class TooltipDirective implements OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "tooltipOpen": {
+      "alias": "tooltipOpen";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 /** Semantic colour scheme of a tag. */
@@ -11365,4 +12240,4 @@ export declare class ZoomOutIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<ZoomOutIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ZoomOutIconComponent, "ea-icon-zoom-out", never, {}, {}, never, never, true, never>;
 }
-export type { EaErrorMessages, EaValidationErrorKey };
+export type { ChartLabelOrientation, ChartPointEvent, ChartSeries, ChartSize, EaErrorMessages, EaValidationErrorKey };