last works on x-chart components, adding separated features ...

projects/x-framework-components/src/lib/x-chart/x-chart.component.ts

@@ -6,31 +6,43 @@ import {
 } from '@angular/core';
 import {
   nameof,
+  toArray,
   XMimeType,
   downloadFile,
   generateUuid,
   getXColorValue,
+  XOneOrManyType,
+  XColorIdentifier,
   downloadFileByUrl,
   isNullOrUndefined,
+  XResourceIdentifier,
   isNullOrEmptyString,
   XColorWithBrightness,
   downloadArrayBufferedFile,
 } from 'x-framework-core';
 import {
   isChartType,
+  XChartXAxis,
+  XChartYAxis,
   XChartAction,
+  XChartTooltip,
   XChartOptions,
   XChartEventOpts,
   XChartTextAlign,
   XChartSeriesType,
   isChartTextAlign,
+  XChartAnnotations,
   XChartActionBarItem,
   XChartDrilldownEvent,
+  XChartAnnotationLabel,
+  XChartAnnotationStyle,
+  XChartMarkerAnnotations,
+  XChartTooltipAnnotations,
   XChartContainerComponent,
   XChartStoryboardBeatInfo,
 } from './x-chart.typings';
 import ApexCharts from 'apexcharts';
-import { Subject, Subscription } from 'rxjs';
+import { Subscription } from 'rxjs';
 import {
   XActionBarItem,
   XActionBarItemSlot,
@@ -189,6 +201,58 @@ export class XChartComponent extends XChartContainerComponent {
       zoomStep = await this.getValueAsync(this.zoomStep);
     }
 
+    //
+    // Toolbar ...
+    isChanged = changeKeys.includes(nameof<XChartComponent>('tooltip'));
+    if (isChanged) {
+      //
+      if (isNullOrUndefined(this.tooltip)) {
+        this.tooltip = this.propertyProvider.tooltip;
+      }
+
+      //
+      await this.handleChartUpdate();
+    }
+
+    //
+    // XAxis ...
+    isChanged = changeKeys.includes(nameof<XChartComponent>('xAxis'));
+    if (isChanged) {
+      //
+      if (isNullOrUndefined(this.xAxis)) {
+        this.xAxis = this.propertyProvider.xAxis;
+      }
+
+      //
+      await this.handleChartUpdate();
+    }
+
+    //
+    // YAxis ...
+    isChanged = changeKeys.includes(nameof<XChartComponent>('yAxis'));
+    if (isChanged) {
+      //
+      if (isNullOrUndefined(this.yAxis)) {
+        this.yAxis = this.propertyProvider.yAxis;
+      }
+
+      //
+      await this.handleChartUpdate();
+    }
+
+    //
+    // Annotations ...
+    isChanged = changeKeys.includes(nameof<XChartComponent>('annotations'));
+    if (isChanged) {
+      //
+      if (isNullOrUndefined(this.annotations)) {
+        this.annotations = this.propertyProvider.annotations;
+      }
+
+      //
+      await this.handleChartUpdate();
+    }
+
     //
     // Chart Title ...
     isChanged = changeKeys.includes(nameof<XChartComponent>('title'));
@@ -692,7 +756,7 @@ export class XChartComponent extends XChartContainerComponent {
           printWindow.document.close();
         }
       }
-    } catch (error) {}
+    } catch (error) { }
   }
 
   async handleToggleFullscreen() {
@@ -724,8 +788,18 @@ export class XChartComponent extends XChartContainerComponent {
     const type = await this.getValueAsync(this.type);
     const chartId = await this.getValueAsync(this.uuid);
     const series = await this.getValueAsync(this.series);
+
+    //
     const cOptions = await this.getValueAsync(this.options);
 
+    //
+    const xAxis = await this.getPreparedXAxis(cOptions?.xaxis);
+    const yAxis = await this.getPreparedYAxis(cOptions?.yaxis);
+
+    //
+    const tooltip = await this.getPreparedTooltip();
+    const annotations = await this.getPreparedAnnotations();
+
     //
     const title = await this.getResourceValueAsync(this.title);
     const titleAlignProp = await this.getValueAsync(this.titleAlign);
@@ -798,7 +872,15 @@ export class XChartComponent extends XChartContainerComponent {
     //
     this.CHART_OPTIONS = {
       ...cOptions,
-      series: series || cOptions.series,
+      series: 
+      { 
+        ...cOptions?.series,
+        ...series as any
+      },
+      annotations: {
+        ...cOptions?.annotations,
+        ...annotations
+      },
       title: {
         ...cOptions.title,
         text: title,
@@ -1371,10 +1453,19 @@ export class XChartComponent extends XChartContainerComponent {
         palette: cOptions.theme?.palette || 'palette1',
       },
       colors: cOptions.colors || [primaryColorValue],
+      xaxis: {
+        ...xAxis
+      },
+      yaxis: [
+        ...yAxis
+      ],
       grid: {
         ...cOptions.grid,
         borderColor: gridColorValue,
       },
+      tooltip: {
+        ...tooltip
+      },
       dataLabels: {
         ...cOptions.dataLabels,
       },
@@ -2100,15 +2191,14 @@ export class XChartComponent extends XChartContainerComponent {
 
       //
       const offset = 24;
-      height = `${
+      height = `${window.innerHeight -
-        window.innerHeight -
         offset -
         (actionBarHeight +
           (cardImageElement?.clientHeight || 0) +
           (cardHeaderElement?.clientHeight || 0) +
           (cardActionsElement?.clientHeight || 0) +
           (cardFooterElement?.clientHeight || 0))
-      }px`;
+        }px`;
     }
 
     //
@@ -2238,5 +2328,583 @@ export class XChartComponent extends XChartContainerComponent {
     this.CARD_ACTION_PROVIDER_SUBSCRIPTION.unsubscribe();
     this.CARD_ACTION_PROVIDER_SUBSCRIPTION = null;
   }
+
+  //
+  //#region Preparers ...
+  private async getPreparedTooltip() {
+    //
+    let result: XChartTooltip = undefined;
+
+    //
+    if (!isNullOrUndefined(this.tooltip)) {
+      //
+      result = await this.getValueAsync(this.tooltip);
+
+      //
+      result = await this.normalizeChartTooltip(result);
+    }
+
+    //
+    return result;;
+  }
+
+  private async getPreparedXAxis(v?: XChartXAxis) {
+    //
+    let result: XChartXAxis = undefined;
+
+    //
+    if (!isNullOrUndefined(this.xAxis)) {
+      //
+      result = {
+        ...(await this.getValueAsync(this.xAxis))
+      };
+    }
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = {
+        ...v,
+        ...result
+      };
+    }
+
+    //
+    if (!isNullOrUndefined(result)) {
+      //
+      result = {
+        ...result,
+      }
+
+      //
+      if (!isNullOrUndefined(result.labels)) {
+        //
+        result.labels = {
+          ...result.labels,
+        }
+
+        //
+        if (!isNullOrUndefined(result.labels.style)) {
+          //
+          result.labels.style = {
+            ...result.labels.style,
+            colors: toArray(result.labels.style.colors).map(c => this.normalizeColor(c))
+          }
+        }
+      }
+
+      //
+      if (!isNullOrUndefined(result.group)) {
+        //
+        result.group = {
+          ...result.group
+        }
+
+        //
+        if (!isNullOrUndefined(result.group.style)) {
+          //
+          result.group.style = {
+            ...result.group.style,
+            colors: toArray(result.group.style.colors).map(x => this.normalizeColor(x))
+          }
+        }
+      }
+
+      //
+      if (!isNullOrUndefined(result.axisBorder)) {
+        //
+        result.axisBorder = {
+          ...result.axisBorder,
+          color: this.normalizeColor(result.axisBorder.color)
+        }
+      }
+
+      //
+      if (!isNullOrUndefined(result.axisTicks)) {
+        //
+        result.axisTicks = {
+          ...result.axisTicks,
+          color: this.normalizeColor(result.axisTicks.color)
+        }
+      }
+
+      //
+      if (!isNullOrUndefined(result.title)) {
+        //
+        result.title = {
+          ...result.title,
+          text: (await this.normalizeText(result.title.text) as string)
+        }
+
+        //
+        if (!isNullOrUndefined(result.title.style)) {
+          //
+          result.title.style = {
+            ...result.title.style,
+            color: this.normalizeColor(result.title.style.color)
+          }
+        }
+      }
+
+      //
+      if (!isNullOrUndefined(result.crosshairs)) {
+        //
+        result.crosshairs = {
+          ...result.crosshairs
+        }
+
+        //
+        if (!isNullOrUndefined(result.crosshairs.stroke)) {
+          //
+          result.crosshairs.stroke = {
+            ...result.crosshairs.stroke,
+            color: this.normalizeColor(result.crosshairs.stroke.color)
+          }
+        }
+
+        //
+        if (!isNullOrUndefined(result.crosshairs.fill)) {
+          //
+          result.crosshairs.fill = {
+            ...result.crosshairs.fill,
+            color: this.normalizeColor(result.crosshairs.fill.color)
+          }
+
+          //
+          if (!isNullOrUndefined(result.crosshairs.fill.gradient)) {
+            //
+            result.crosshairs.fill.gradient = {
+              ...result.crosshairs.fill.gradient,
+              colorTo: this.normalizeColor(result.crosshairs.fill.gradient.colorTo),
+              colorFrom: this.normalizeColor(result.crosshairs.fill.gradient.colorFrom),
+            }
+          }
+        }
+      }
+    }
+
+    //
+    return result;
+  }
+
+  private async getPreparedYAxis(v?: XOneOrManyType<XChartYAxis>) {
+    //
+    let result: XChartYAxis[] = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = [
+        ...toArray(v)
+      ];
+    }
+
+    //
+    if (!isNullOrUndefined(this.yAxis)) {
+      //
+      result = [
+        ...(this.hasChild(result) ? result : []),
+        ...await this.getArrayValueAsync(this.yAxis)
+      ];
+
+      //
+      const mappers = result.map(async x => {
+        //
+        if (!isNullOrUndefined(x.labels)) {
+          //
+          x.labels = {
+            ...x.labels
+          };
+
+          //
+          if (!isNullOrUndefined(x.labels.style)) {
+            //
+            x.labels.style = {
+              ...x.labels.style,
+              colors: toArray(x.labels.style.colors).map(c => this.normalizeColor(c))
+            }
+          }
+        }
+
+        //
+        if (!isNullOrUndefined(x.axisBorder)) {
+          //
+          x.axisBorder = {
+            ...x.axisBorder,
+            color: this.normalizeColor(x.axisBorder.color)
+          }
+        }
+
+        //
+        if (!isNullOrUndefined(x.axisTicks)) {
+          //
+          x.axisTicks = {
+            ...x.axisTicks,
+            color: this.normalizeColor(x.axisTicks.color)
+          }
+        }
+
+        //
+        if (!isNullOrUndefined(x.title)) {
+          //
+          x.title = {
+            ...x.title,
+            text: (await this.normalizeText(x.title.text) as string)
+          }
+
+          //
+          if (!isNullOrUndefined(x.title.style)) {
+            //
+            x.title.style = {
+              ...x.title.style,
+              color: this.normalizeColor(x.title.style.color)
+            }
+          }
+        }
+
+        //
+        if (!isNullOrUndefined(x.crosshairs)) {
+          //
+          x.crosshairs = {
+            ...x.crosshairs,
+          }
+
+          //
+          if (!isNullOrUndefined(x.crosshairs.stroke)) {
+            //
+            x.crosshairs.stroke = {
+              ...x.crosshairs.stroke,
+              color: this.normalizeColor(x.crosshairs.stroke.color)
+            }
+          }
+        }
+
+        //
+        return x;
+      });
+
+      //
+      const items = await Promise.all(mappers);
+
+      //
+      result = [
+        ...result,
+        ...items
+      ];
+    }
+
+    //
+    return result;
+  }
+
+  private async getPreparedAnnotations() {
+    //
+    let result: XChartAnnotations = undefined;
+
+    //
+    if (!isNullOrUndefined(this.annotations)) {
+      //
+      result = await this.getValueAsync(this.annotations);
+
+      //
+      // Try to Normalize Colors and Resources ...
+
+      //
+      // Texts ...
+      if (this.hasChild(result.texts)) {
+        //
+        const mappers = result.texts.map(async x => {
+          //
+          // Normalizing Text ...
+          x.text = (await this.normalizeText(x.text)) as string;
+
+          //
+          // Normalizing Colors ...
+          x.foreColor = this.normalizeColor(x.foreColor);
+          x.borderColor = this.normalizeColor(x.borderColor);
+          x.backgroundColor = this.normalizeColor(x.backgroundColor);
+
+          //
+          return x;
+        });
+        const items = await Promise.all(mappers);
+        result.texts = [
+          ...items
+        ];
+      }
+
+      //
+      // Y Axis ...
+      if (this.hasChild(result.yaxis)) {
+        //
+        const mappers = result.yaxis.map(async x => {
+          //
+          // Normalizing Text ...
+          x.label = await this.normalizeLabel(x.label);
+
+          //
+          // Normalizing Colors ...
+          x.fillColor = this.normalizeColor(x.fillColor);
+          x.borderColor = this.normalizeColor(x.borderColor);
+
+          //
+          return x;
+        });
+        const items = await Promise.all(mappers);
+        result.yaxis = [
+          ...items
+        ];
+      }
+
+      //
+      // X Axis ...
+      if (this.hasChild(result.xaxis)) {
+        //
+        const mappers = result.xaxis.map(async x => {
+          //
+          // Normalizing Text ...
+          x.label = await this.normalizeLabel(x.label);
+
+          //
+          // Normalizing Colors ...
+          x.fillColor = this.normalizeColor(x.fillColor);
+          x.borderColor = this.normalizeColor(x.borderColor);
+
+          //
+          return x;
+        });
+        const items = await Promise.all(mappers);
+        result.yaxis = [
+          ...items
+        ];
+      }
+
+      //
+      // Points ...
+      if (this.hasChild(result.points)) {
+        //
+        const mappers = result.points.map(async x => {
+          //
+          x.marker = this.normalizeMarker(x.marker);
+          x.label = await this.normalizeLabel(x.label);
+          x.tooltip = await this.normalizeTooltip(x.tooltip);
+
+          //
+          return x;
+        });
+        const items = await Promise.all(mappers);
+        result.points = [
+          ...items
+        ];
+      }
+
+      //
+      // Images ...
+      if (this.hasChild(result.images)) {
+        //
+        result.images = [
+          ...result.images
+        ];
+      }
+    }
+
+    //
+    return result;
+  }
+  //#endregion
+
+  //
+  //#region Normalizers ...
+  private async normalizeText(
+    v: XOneOrManyType<XResourceIdentifier>,
+    forceLocale: boolean = false
+  ) {
+    //
+    let result: XOneOrManyType<string> = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      let items = toArray(v);
+      if (this.hasChild(items)) {
+        //
+        const mappers = items.map(async x => {
+          //
+          let r: string = await this.getResourceValueAsync(x);
+
+          //
+          if (forceLocale && !isNullOrEmptyString(r)) {
+            r = this.applyLocale(r);
+          }
+
+          //
+          return r;
+        });
+
+        //
+        var results = await Promise.all(mappers);
+
+        //
+        if (this.hasChild(results)) {
+          //
+          if (results.length == 1) {
+            result = results[0];
+          } else {
+            result = [
+              ...results
+            ];
+          }
+        }
+      }
+    }
+
+    //
+    return result;
+  }
+
+  private normalizeColor(v: XColorIdentifier) {
+    //
+    let result = '';
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      const titleColorValue = getXColorValue(v);
+
+      //
+      result = titleColorValue || v;
+    }
+
+    //
+    return result;
+  }
+
+  private normalizeMarker(v: XChartMarkerAnnotations) {
+    //
+    let result: XChartMarkerAnnotations = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = {
+        ...v,
+        fillColor: this.normalizeColor(v.fillColor),
+        strokeColor: this.normalizeColor(v.strokeColor),
+      }
+    }
+
+    //
+    return result;
+  }
+
+  private async normalizeStyle(v: XChartAnnotationStyle) {
+    //
+    let result: XChartAnnotationStyle = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = {
+        ...v,
+
+        //
+        color: this.normalizeColor(v.color),
+        background: this.normalizeColor(v.background),
+      };
+    }
+
+    //
+    return result;
+  }
+
+  private async normalizeLabel(v: XChartAnnotationLabel) {
+    //
+    let result: XChartAnnotationLabel = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = {
+        ...v,
+
+        //
+        text: await this.normalizeText(v.text),
+
+        //
+        style: await this.normalizeStyle(v.style),
+
+        //
+        borderColor: this.normalizeColor(v.borderColor),
+      };
+    }
+
+    //
+    return result;
+  }
+
+  private async normalizeTooltip(v: XChartTooltipAnnotations) {
+    //
+    let result: XChartTooltipAnnotations = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = {
+        ...v,
+        //
+        text: await this.normalizeText(v.text),
+      }
+    }
+
+    //
+    return result;
+  }
+
+  private async normalizeChartTooltip(v: XChartTooltip) {
+    //
+    let result: XChartTooltip = undefined;
+
+    //
+    if (!isNullOrUndefined(v)) {
+      //
+      result = {
+        ...v,
+      };
+
+      //
+      // Style ...
+      if (!isNullOrUndefined(v.style)) {
+        //
+        result.style = {
+          ...v.style,
+          background: this.normalizeColor(v.style.background)
+        };
+      }
+
+      //
+      // Z ...
+      if (!isNullOrUndefined(v.z)) {
+        //
+        result.z = {
+          ...v.z,
+          title: (await this.normalizeText(v.z.title) as string)
+        }
+      }
+
+      //
+      // Marker ...
+      if (!isNullOrUndefined(v.marker)) {
+        //
+        result.marker = {
+          ...v.marker,
+          fillColors: v.marker.fillColors?.map(fc => this.normalizeColor(fc))
+        }
+      }
+    }
+
+    //
+    return result;
+  }
+  //#endregion
   //#endregion
 }

projects/x-framework-components/src/lib/x-chart/x-chart.typings.ts

@@ -101,6 +101,41 @@ export type XChartXAxisAnnotations = XCahrtAxisBaseAnnotations & {
   x2?: null | number | string;
 };
 
+export type XChartMarkerAnnotations = {
+  size?: number;
+  fillColor?: string;
+  strokeColor?: string;
+  strokeWidth?: number;
+  shape?: string;
+  offsetX?: number;
+  offsetY?: number;
+  cssClass?: string;
+};
+
+export type XChartTooltipAnnotations = {
+  enabled?: boolean;
+  /**
+   * Static tooltip content (HTML allowed; an array is joined with line
+   * breaks). Falls back to `label.text` when omitted.
+   */
+  text?: string | string[];
+  /**
+   * Returns the tooltip markup (HTML). Takes precedence over `text`.
+   */
+  formatter?: (opts: {
+    annotation: XChartPointAnnotations;
+    seriesIndex?: number;
+    id?: number | string;
+    w: any;
+  }) => string;
+  /**
+   * Tooltip theme. Falls back to the global `tooltip.theme`.
+   */
+  theme?: 'light' | 'dark';
+  offsetX?: number;
+  offsetY?: number;
+};
+
 export type XChartPointAnnotations = {
   id?: number | string;
   x?: number | string;
@@ -115,16 +150,7 @@ export type XChartPointAnnotations = {
   mouseEnter?: (annotation: XChartPointAnnotations, e: MouseEvent) => void;
   mouseLeave?: (annotation: XChartPointAnnotations, e: MouseEvent) => void;
   click?: (annotation: XChartPointAnnotations, e: MouseEvent) => void;
-  marker?: {
+  marker?: XChartMarkerAnnotations;
-    size?: number;
-    fillColor?: string;
-    strokeColor?: string;
-    strokeWidth?: number;
-    shape?: string;
-    offsetX?: number;
-    offsetY?: number;
-    cssClass?: string;
-  };
   label?: XChartAnnotationLabel;
   image?: {
     path?: string;
@@ -137,29 +163,7 @@ export type XChartPointAnnotations = {
    * Show a hover tooltip over the annotation marker, like a regular data
    * point. Useful for surfacing more detail than fits in the label.
    */
-  tooltip?: {
+  tooltip?: XChartTooltipAnnotations;
-    enabled?: boolean;
-    /**
-     * Static tooltip content (HTML allowed; an array is joined with line
-     * breaks). Falls back to `label.text` when omitted.
-     */
-    text?: string | string[];
-    /**
-     * Returns the tooltip markup (HTML). Takes precedence over `text`.
-     */
-    formatter?: (opts: {
-      annotation: XChartPointAnnotations;
-      seriesIndex?: number;
-      id?: number | string;
-      w: any;
-    }) => string;
-    /**
-     * Tooltip theme. Falls back to the global `tooltip.theme`.
-     */
-    theme?: 'light' | 'dark';
-    offsetX?: number;
-    offsetY?: number;
-  };
   /**
    * Render arbitrary SVG markup at the annotation's position. Deprecated in
    * favor of `image`/`marker`, but still supported.
@@ -370,71 +374,71 @@ export type XChartAxisChartSeries = {
   zIndex?: number;
   parsing?: XChartParsing;
   data:
-    | (number | null)[]
+  | (number | null)[]
-    | {
+  | {
-        /**
+    /**
-         * A category label, a timestamp, or a `Date`. On a `datetime` axis all
+     * A category label, a timestamp, or a `Date`. On a `datetime` axis all
-         * three keep millisecond resolution.
+     * three keep millisecond resolution.
-         */
+     */
-        x: string | number | Date;
+    x: string | number | Date;
-        /**
+    /**
-         * A plain value for most charts. For `candlestick`/`boxPlot`, the
+     * A plain value for most charts. For `candlestick`/`boxPlot`, the
-         * summary array (`[O,H,L,C]` / `[min,Q1,median,Q3,max]`). For `violin`, an
+     * summary array (`[O,H,L,C]` / `[min,Q1,median,Q3,max]`). For `violin`, an
-         * object carrying the precomputed density profile (`[value, weight]` pairs)
+     * object carrying the precomputed density profile (`[value, weight]` pairs)
-         * plus the raw observations rendered as jitter. For a `scatter` strip plot
+     * plus the raw observations rendered as jitter. For a `scatter` strip plot
-         * (`plotOptions.scatter.jitter`), the array of observations in this category.
+     * (`plotOptions.scatter.jitter`), the array of observations in this category.
-         */
+     */
-        y:
+    y:
-          | number
+    | number
-          | null
+    | null
-          | number[]
+    | number[]
-          | { density: [number, number][]; points?: number[] };
+    | { density: [number, number][]; points?: number[] };
-        /**
+    /**
-         * Optional raw observations for a `boxPlot` data point, rendered as jitter
+     * Optional raw observations for a `boxPlot` data point, rendered as jitter
-         * dots when `plotOptions.boxPlot.points.show` is enabled.
+     * dots when `plotOptions.boxPlot.points.show` is enabled.
-         */
+     */
-        points?: number[];
+    points?: number[];
-        fill?: XChartFill;
+    fill?: XChartFill;
-        fillColor?: string;
+    fillColor?: string;
-        strokeColor?: string;
+    strokeColor?: string;
-        meta?: unknown;
+    meta?: unknown;
-        /**
+    /**
-         * A second metric that drives this point's COLOUR, independent of `y`
+     * A second metric that drives this point's COLOUR, independent of `y`
-         * which drives its size (`treemap`). See
+     * which drives its size (`treemap`). See
-         * `plotOptions.treemap.colorScale.colorValue` to read a different key.
+     * `plotOptions.treemap.colorScale.colorValue` to read a different key.
-         */
+     */
-        colorValue?: number;
+    colorValue?: number;
-        /**
+    /**
-         * Nested hierarchy: this point is a branch containing these children,
+     * Nested hierarchy: this point is a branch containing these children,
-         * to any depth (`treemap`, `sunburst`). A branch normally omits `y` and
+     * to any depth (`treemap`, `sunburst`). A branch normally omits `y` and
-         * takes the sum of its children instead.
+     * takes the sum of its children instead.
-         */
+     */
-        children?: XChartHierarchyNode[];
+    children?: XChartHierarchyNode[];
-        /**
+    /**
-         * Drilldown target: the `id` of a `drilldown.series` entry. Clicking this
+     * Drilldown target: the `id` of a `drilldown.series` entry. Clicking this
-         * point drills into that level. Requires the Drilldown feature.
+     * point drills into that level. Requires the Drilldown feature.
-         */
+     */
-        drilldown?: string | number;
+    drilldown?: string | number;
-        goals?: {
+    goals?: {
-          name?: string;
+      name?: string;
-          value: number;
+      value: number;
-          strokeHeight?: number;
+      strokeHeight?: number;
-          strokeWidth?: number;
+      strokeWidth?: number;
-          strokeColor?: string;
+      strokeColor?: string;
-          strokeDashArray?: number;
+      strokeDashArray?: number;
-          strokeLineCap?: 'butt' | 'square' | 'round';
+      strokeLineCap?: 'butt' | 'square' | 'round';
-        }[];
+    }[];
-        barHeightOffset?: number;
+    barHeightOffset?: number;
-        columnWidthOffset?: number;
+    columnWidthOffset?: number;
-      }[]
+  }[]
-    | [number, number | null][]
+  | [number, number | null][]
-    | [number, (number | null)[]][]
+  | [number, (number | null)[]][]
-    | number[][]
+  | number[][]
-    // A `children` hierarchy for the partition charts, where a branch carries no
+  // A `children` hierarchy for the partition charts, where a branch carries no
-    // value of its own. Listed before the catch-all so authors get completion on
+  // value of its own. Listed before the catch-all so authors get completion on
-    // the node shape instead of falling through to `Record<string, any>`.
+  // the node shape instead of falling through to `Record<string, any>`.
-    | XChartHierarchyNode[]
+  | XChartHierarchyNode[]
-    | Record<string, any>[];
+  | Record<string, any>[];
 }[];
 
 export type XChartNonAxisChartSeries = number[] | XChartAxisChartSeries;
@@ -931,11 +935,11 @@ export type XChartPlotOptions = {
        * property, or an accessor to compute one.
        */
       colorValue?:
-        | string
+      | string
-        | ((
+      | ((
-            datum: any,
+        datum: any,
-            opts: { seriesIndex: number; dataPointIndex: number; w: any },
+        opts: { seriesIndex: number; dataPointIndex: number; w: any },
-          ) => number);
+      ) => number);
       /**
        * Continuous interpolation between colour stops, for the metric above.
        * Active as soon as any datum carries a colour metric; `enabled: false`
@@ -1068,13 +1072,13 @@ export type XChartPlotOptions = {
      * 'custom': positions come from `positions`.
      */
     layout?:
-      | 'grouped'
+    | 'grouped'
-      | 'packed'
+    | 'packed'
-      | 'columns'
+    | 'columns'
-      | 'grid'
+    | 'grid'
-      | 'scatter'
+    | 'scatter'
-      | 'arc'
+    | 'arc'
-      | 'custom';
+    | 'custom';
     /**
      * `layout: 'custom'` only. The layout provider: either a function returning
      * plot-pixel positions, or the name of one registered with
@@ -2102,19 +2106,19 @@ export interface XChartDrilldown {
   /** Inline child levels referenced by data-point `drilldown` ids. */
   series?: XChartDrilldownSeries[];
   breadcrumb?:
-    | false
+  | false
-    | {
+  | {
-        show?: boolean;
+    show?: boolean;
-        position?: 'top-left' | 'top-right';
+    position?: 'top-left' | 'top-right';
-        separator?: string;
+    separator?: string;
-        rootLabel?: string;
+    rootLabel?: string;
-        offsetX?: number;
+    offsetX?: number;
-        offsetY?: number;
+    offsetY?: number;
-        formatter?(
+    formatter?(
-          label: string,
+      label: string,
-          opts: { index: number; depth: number },
+      opts: { index: number; depth: number },
-        ): string;
+    ): string;
-      };
+  };
   animation?: {
     enabled?: boolean;
     /**
@@ -2163,11 +2167,11 @@ export interface XChartDrilldown {
    * name, so the default ships no user-visible English.
    */
   loading?:
-    | false
+  | false
-    | {
+  | {
-        show?: boolean;
+    show?: boolean;
-        text?: string;
+    text?: string;
-      };
+  };
   /**
    * Cache levels resolved by `onDrillDown`, keyed by id, so drilling back down
    * a branch does not re-fetch. Default true. Clear it with the drilldown
@@ -2273,12 +2277,12 @@ export type XChartStates = {
 export type XChartStroke = {
   show?: boolean;
   curve?:
-    | 'smooth'
+  | 'smooth'
-    | 'straight'
+  | 'straight'
-    | 'stepline'
+  | 'stepline'
-    | 'linestep'
+  | 'linestep'
-    | 'monotoneCubic'
+  | 'monotoneCubic'
-    | ('smooth' | 'straight' | 'stepline' | 'linestep' | 'monotoneCubic')[];
+  | ('smooth' | 'straight' | 'stepline' | 'linestep' | 'monotoneCubic')[];
   lineCap?: 'butt' | 'square' | 'round';
   colors?: string[];
   width?: number | number[];
@@ -2329,11 +2333,11 @@ export type XChartTheme = {
   };
   accessibility?: {
     colorBlindMode?:
-      | 'deuteranopia'
+    | 'deuteranopia'
-      | 'protanopia'
+    | 'protanopia'
-      | 'tritanopia'
+    | 'tritanopia'
-      | 'highContrast'
+    | 'highContrast'
-      | '';
+    | '';
   };
 };
 
@@ -2362,14 +2366,14 @@ export type XChartTooltip = {
   inverseOrder?: boolean;
   arrow?: boolean;
   custom?:
-    | ((
+  | ((
-        opts: XChartTooltipCustomOpts,
+    opts: XChartTooltipCustomOpts,
-      ) => string | number | Element | { nodeName: string })
+  ) => string | number | Element | { nodeName: string })
-    | Array<
+  | Array<
-        (
+    (
-          opts: XChartTooltipCustomOpts,
+      opts: XChartTooltipCustomOpts,
-        ) => string | number | Element | { nodeName: string }
+    ) => string | number | Element | { nodeName: string }
-      >;
+  >;
   fillSeriesColor?: boolean;
   theme?: 'light' | 'dark';
   cssClass?: string;
@@ -2446,30 +2450,30 @@ export type XChart = {
   width?: string | number;
   height?: string | number;
   type?:
-    | 'line'
+  | 'line'
-    | 'area'
+  | 'area'
-    | 'bar'
+  | 'bar'
-    | 'pie'
+  | 'pie'
-    | 'donut'
+  | 'donut'
-    | 'radialBar'
+  | 'radialBar'
-    | 'scatter'
+  | 'scatter'
-    | 'bubble'
+  | 'bubble'
-    | 'heatmap'
+  | 'heatmap'
-    | 'candlestick'
+  | 'candlestick'
-    | 'boxPlot'
+  | 'boxPlot'
-    | 'violin'
+  | 'violin'
-    | 'histogram'
+  | 'histogram'
-    | 'radar'
+  | 'radar'
-    | 'polarArea'
+  | 'polarArea'
-    | 'rangeBar'
+  | 'rangeBar'
-    | 'rangeArea'
+  | 'rangeArea'
-    | 'treemap'
+  | 'treemap'
-    | 'unit'
+  | 'unit'
-    | 'waffle'
+  | 'waffle'
-    | 'sunburst'
+  | 'sunburst'
-    | 'funnel'
+  | 'funnel'
-    | 'pyramid'
+  | 'pyramid'
-    | 'gauge';
+  | 'gauge';
   /**
    * Internal — populated when `type` is a first-class alias (`'funnel'`,
    * `'pyramid'`, `'gauge'`, `'waffle'`, `'histogram'`). The original requested
@@ -2752,9 +2756,9 @@ export type XChart = {
     dimension?: (row: any) => any;
     /** FILTER mode: reduction over a bucket's rows. @default 'count' */
     reduce?:
-      | 'count'
+    | 'count'
-      | { sum?: string; avg?: string; min?: string; max?: string }
+    | { sum?: string; avg?: string; min?: string; max?: string }
-      | ((rows: any[]) => number);
+    | ((rows: any[]) => number);
     /**
      * FILTER mode: bucket kind. Else inferred: `bins` present => 'range', a
      * heatmap chart => 'matrix' (2D), otherwise 'category'.
@@ -2872,21 +2876,21 @@ export type XChart = {
       | 'yline'
       | 'measure'
       | {
-          id?: string;
+        id?: string;
-          label?: string;
+        label?: string;
-          icon?: string;
+        icon?: string;
-          onClick?: (
+        onClick?: (
-            chart: ApexCharts,
+          chart: ApexCharts,
-            context: {
+          context: {
-              x: any;
+            x: any;
-              y: any;
+            y: any;
-              seriesIndex: number | null;
+            seriesIndex: number | null;
-              dataPointIndex: number | null;
+            dataPointIndex: number | null;
-              clientX: number;
+            clientX: number;
-              clientY: number;
+            clientY: number;
-            },
+          },
-          ) => void;
+        ) => void;
-        }
+      }
     >;
     /** Override the built-in item labels. */
     labels?: {
@@ -3225,7 +3229,7 @@ export enum XChartAction {
 
 export type XChartActionIdentifier = XChartAction | string;
 
-export interface XChartActionModel extends XBaseActionModel<XChartActionIdentifier> {}
+export interface XChartActionModel extends XBaseActionModel<XChartActionIdentifier> { }
 
 export type XChartSeriesType = XChartAxisChartSeries | XChartNonAxisChartSeries;
 
@@ -3323,6 +3327,14 @@ export interface IXChartContainer extends TXChartContainer {
   series: XStandardType<XChartSeriesType>;
   type: XStandardType<XChartTypeIdentifier>;
 
+  //
+  xAxis: XStandardType<XChartXAxis>;
+  yAxis: XStandardType<XOneOrManyType<XChartYAxis>>;
+
+  //
+  tooltip: XStandardType<XChartTooltip>;
+  annotations: XStandardType<XChartAnnotations>;
+
   //
   title: XStandardType<XResourceIdentifier>;
   titleAlign: XStandardType<XChartTextAlignIdentifier>;
@@ -3460,8 +3472,7 @@ export interface IXChartContainer extends TXChartContainer {
 })
 export class XChartContainer
   extends XBaseContainer
-  implements Readonly<IXChartContainer>
+  implements Readonly<IXChartContainer> {
-{
   //
   readonly actionProvider = new Subject<XChartActionModel>();
   readonly cssClass: XStandardType<XOneOrManyType<string>>;
@@ -3473,6 +3484,14 @@ export class XChartContainer
   readonly series: XStandardType<XChartSeriesType>;
   readonly type: XStandardType<XChartTypeIdentifier> = XChartType.Line;
 
+  //
+  readonly xAxis: XStandardType<XChartXAxis>;
+  readonly yAxis: XStandardType<XOneOrManyType<XChartYAxis>>;
+
+  //
+  readonly tooltip: XStandardType<XChartTooltip>;
+  readonly annotations: XStandardType<XChartAnnotations>;
+
   //
   readonly title: XStandardType<XResourceIdentifier>;
   readonly titleAlign: XStandardType<XChartTextAlignIdentifier> =
@@ -3671,8 +3690,7 @@ export class XChartContainer
 @Component({ template: `` })
 export abstract class XChartContainerComponent
   extends XBaseContainerComponent
-  implements IXChartContainer
+  implements IXChartContainer {
-{
   //
   //#region Props ...
   @Input()
@@ -3698,6 +3716,18 @@ export abstract class XChartContainerComponent
   @Input()
   zoomStep: XStandardType<number> = this.propertyProvider.zoomStep;
 
+  @Input()
+  xAxis: XStandardType<XChartXAxis> = this.propertyProvider.xAxis;
+
+  @Input()
+  yAxis: XStandardType<XOneOrManyType<XChartYAxis>> = this.propertyProvider.yAxis;
+
+  @Input()
+  tooltip: XStandardType<XChartTooltip> = this.propertyProvider.tooltip;
+
+  @Input()
+  annotations: XStandardType<XChartAnnotations> = this.propertyProvider.annotations;
+
   @Input()
   defaultActionBarItemColor: XStandardType<XColorIdentifier> =
     this.propertyProvider.defaultActionBarItemColor;
@@ -4034,6 +4064,14 @@ export abstract class XChartContainerComponent
       series: this.getValue(container ? container.series : this.series),
       zoomStep: this.getValue(container ? container.zoomStep : this.zoomStep),
 
+      //
+      xAxis: this.getValue(container ? container.xAxis : this.xAxis),
+      yAxis: this.getValue(container ? container.yAxis : this.yAxis),
+
+      //
+      tooltip: this.getValue(container ? container.tooltip : this.tooltip),
+      annotations: this.getValue(container ? container.annotations : this.annotations),
+
       //
       title: this.getValue(container ? container.title : this.title),
       titleAlign: this.getValue(