@dynatrace/strato-components 3.4.0 → 3.5.0

package/charts/xy-chart-adoption/histogram/iterate-histogram-slots.js

@@ -21,17 +21,50 @@ __export(iterate_histogram_slots_exports, {
 });
 module.exports = __toCommonJS(iterate_histogram_slots_exports);
 var import_react = require("react");
+var import_react_is = require("react-is");
 var import_Intent = require("../../../core/slots/Intent/Intent.js");
 var import_is_slot = require("../../../core/utils/is-slot.js");
+var import_populate_missing_marker_props = require("../../core/components/annotations/utils/populate-missing-marker-props.js");
+var import_populate_missing_track_props = require("../../core/components/annotations/utils/populate-missing-track-props.js");
 var import_ColorRule = require("../../core/slots/ColorRule.js");
 var import_ChartToolbar = require("../../core/slots/toolbar/ChartToolbar.js");
+var import_Annotations = require("../../histogram/slots/annotations/Annotations.js");
+var import_Marker = require("../../histogram/slots/annotations/Marker.js");
+var import_Tooltip = require("../../histogram/slots/annotations/Tooltip.js");
+var import_Track = require("../../histogram/slots/annotations/Track.js");
 var import_Legend = require("../../histogram/slots/Legend.js");
 var import_Pan = require("../../histogram/slots/Pan.js");
 var import_Select = require("../../histogram/slots/Select.js");
+var import_ThresholdIndicator = require("../../histogram/slots/ThresholdIndicator.js");
 var import_Toolbar = require("../../histogram/slots/Toolbar.js");
 var import_XAxis = require("../../histogram/slots/XAxis.js");
 var import_YAxis = require("../../histogram/slots/YAxis.js");
 var import_Zoom = require("../../histogram/slots/Zoom.js");
+const iterateAnnotationsChildren = (children) => {
+  const tracks = [];
+  let tooltip;
+  import_react.Children.forEach(children, (child) => {
+    if ((0, import_is_slot.isSlot)(child, import_Track.Track)) {
+      const { children: trackChildren, ...trackProps } = child.props;
+      const currentTrack = (0, import_populate_missing_track_props.populateMissingTrackProps)({
+        ...trackProps,
+        markers: []
+      });
+      import_react.Children.forEach(trackChildren, (markerChild) => {
+        if ((0, import_react_is.isElement)(markerChild) && (0, import_is_slot.isSlot)(markerChild, import_Marker.Marker)) {
+          currentTrack.markers.push(
+            (0, import_populate_missing_marker_props.populateMissingMarkerProps)(markerChild.props, trackProps)
+          );
+        }
+      });
+      tracks.push(currentTrack);
+    } else if ((0, import_is_slot.isSlot)(child, import_Tooltip.AnnotationsTooltip)) {
+      const { children: tooltipChildren, hidden } = child.props;
+      tooltip = { template: tooltipChildren, hidden: hidden ?? false };
+    }
+  });
+  return { tracks, tooltip };
+};
 const iterateHistogramSlots = (children) => {
   let disableZoom = false;
   let disablePan = false;
@@ -39,10 +72,12 @@ const iterateHistogramSlots = (children) => {
   let selectActions;
   let intents;
   const colorRules = [];
+  const thresholds = [];
   const yAxis = [];
   let xAxis = {};
   let toolbar = {};
   let deprecatedToolbar = {};
+  let annotations;
   import_react.Children.forEach(children, (child) => {
     if ((0, import_is_slot.isSlot)(child, import_Zoom.Zoom)) {
       disableZoom = child.props.disabled === true;
@@ -60,10 +95,8 @@ const iterateHistogramSlots = (children) => {
       };
     } else if ((0, import_is_slot.isSlot)(child, import_Select.Select)) {
       selectActions = child.props.actions;
-    } else if ((0, import_is_slot.isSlot)(child, import_ColorRule.ColorRule)) {
-      if ((0, import_ColorRule.isValidColorRule)(child.props)) {
-        colorRules.push(child.props);
-      }
+    } else if ((0, import_is_slot.isSlot)(child, import_ColorRule.ColorRule) && (0, import_ColorRule.isValidColorRule)(child.props)) {
+      colorRules.push(child.props);
     } else if ((0, import_is_slot.isSlot)(child, import_Intent.Intent)) {
       intents = intents ? [...intents, child.props] : [child.props];
     } else if ((0, import_is_slot.isSlot)(child, import_Toolbar.Toolbar)) {
@@ -73,6 +106,23 @@ const iterateHistogramSlots = (children) => {
         enabled: true,
         ...child.props
       };
+    } else if ((0, import_is_slot.isSlot)(child, import_ThresholdIndicator.ThresholdIndicator)) {
+      thresholds.push(child.props);
+    } else if ((0, import_is_slot.isSlot)(child, import_Annotations.Annotations)) {
+      const {
+        children: annotationsChildren,
+        showLabels,
+        visibleTracksLimit,
+        annotationsActions
+      } = child.props;
+      const { tracks, tooltip } = iterateAnnotationsChildren(annotationsChildren);
+      annotations = {
+        tracks,
+        tooltip,
+        showLabels,
+        visibleTracksLimit,
+        annotationsActions
+      };
     }
   });
   const interactionSlots = {
@@ -82,6 +132,7 @@ const iterateHistogramSlots = (children) => {
     yAxis,
     xAxis,
     colorRules,
+    thresholds,
     toolbar,
     deprecatedToolbar
   };
@@ -91,5 +142,8 @@ const iterateHistogramSlots = (children) => {
   if (intents) {
     interactionSlots.intents = intents;
   }
+  if (annotations) {
+    interactionSlots.annotations = annotations;
+  }
   return interactionSlots;
 };

package/charts/xy-chart-adoption/histogram/transformer-annotations-to-xy.d.ts

@@ -0,0 +1,20 @@
+import type { AnnotationsTrackConfig } from '../../core/components/annotations/types/annotations-track-props.js';
+import type { XYChartData } from '../../xy-chart/types/xy-chart.js';
+export declare const ANNOTATIONS_KEYS: {
+    readonly trackId: "__annotationsTrackId";
+    readonly trackLabel: "__annotationsTrackLabel";
+    readonly trackColor: "__annotationsTrackColor";
+    readonly trackHidden: "__annotationsTrackHidden";
+    readonly trackSymbol: "__annotationsTrackSymbol";
+    readonly trackIndicators: "__annotationsTrackIndicators";
+    readonly markerStart: "__annotationsMarkerStart";
+    readonly markerEnd: "__annotationsMarkerEnd";
+    readonly markerTitle: "__annotationsMarkerTitle";
+    readonly markerDescription: "__annotationsMarkerDescription";
+    readonly markerColor: "__annotationsMarkerColor";
+    readonly markerHidden: "__annotationsMarkerHidden";
+    readonly markerSymbol: "__annotationsMarkerSymbol";
+    readonly markerIndicators: "__annotationsMarkerIndicators";
+    readonly markerPriority: "__annotationsMarkerPriority";
+};
+export declare const transformHistogramAnnotationsToXY: (tracks: AnnotationsTrackConfig[]) => XYChartData[];

package/charts/xy-chart-adoption/histogram/transformer-annotations-to-xy.js

@@ -0,0 +1,68 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var transformer_annotations_to_xy_exports = {};
+__export(transformer_annotations_to_xy_exports, {
+  ANNOTATIONS_KEYS: () => ANNOTATIONS_KEYS,
+  transformHistogramAnnotationsToXY: () => transformHistogramAnnotationsToXY
+});
+module.exports = __toCommonJS(transformer_annotations_to_xy_exports);
+const ANNOTATIONS_KEYS = {
+  trackId: "__annotationsTrackId",
+  trackLabel: "__annotationsTrackLabel",
+  trackColor: "__annotationsTrackColor",
+  trackHidden: "__annotationsTrackHidden",
+  trackSymbol: "__annotationsTrackSymbol",
+  trackIndicators: "__annotationsTrackIndicators",
+  markerStart: "__annotationsMarkerStart",
+  markerEnd: "__annotationsMarkerEnd",
+  markerTitle: "__annotationsMarkerTitle",
+  markerDescription: "__annotationsMarkerDescription",
+  markerColor: "__annotationsMarkerColor",
+  markerHidden: "__annotationsMarkerHidden",
+  markerSymbol: "__annotationsMarkerSymbol",
+  markerIndicators: "__annotationsMarkerIndicators",
+  markerPriority: "__annotationsMarkerPriority"
+};
+const transformHistogramAnnotationsToXY = (tracks) => {
+  const data = [];
+  tracks.forEach((track, trackIndex) => {
+    const histogramTrack = track;
+    const trackId = `track-${trackIndex}`;
+    track.markers.forEach((marker) => {
+      const histogramMarker = marker;
+      data.push({
+        [ANNOTATIONS_KEYS.trackId]: trackId,
+        [ANNOTATIONS_KEYS.trackLabel]: histogramTrack.label,
+        [ANNOTATIONS_KEYS.trackColor]: histogramTrack.color,
+        [ANNOTATIONS_KEYS.trackHidden]: histogramTrack.hidden,
+        [ANNOTATIONS_KEYS.trackSymbol]: histogramTrack.symbol,
+        [ANNOTATIONS_KEYS.trackIndicators]: histogramTrack.indicatorsDisplay,
+        [ANNOTATIONS_KEYS.markerStart]: histogramMarker.start,
+        [ANNOTATIONS_KEYS.markerEnd]: histogramMarker.end,
+        [ANNOTATIONS_KEYS.markerTitle]: histogramMarker.title,
+        [ANNOTATIONS_KEYS.markerDescription]: histogramMarker.description,
+        [ANNOTATIONS_KEYS.markerColor]: histogramMarker.color,
+        [ANNOTATIONS_KEYS.markerHidden]: histogramMarker.hidden,
+        [ANNOTATIONS_KEYS.markerSymbol]: histogramMarker.symbol,
+        [ANNOTATIONS_KEYS.markerIndicators]: histogramMarker.indicatorsDisplay,
+        [ANNOTATIONS_KEYS.markerPriority]: histogramMarker.priority
+      });
+    });
+  });
+  return data;
+};

package/charts/xy-chart-adoption/histogram/transformer-data-to-xy.d.ts

@@ -13,6 +13,7 @@ interface TransformHistogramDataResult {
 type BarSeriesProps = {
     data: XYChartData[];
     unit: ChartUnit;
+    seriesCount: number;
 };
 export declare function transformHistogramDataToXYChart(data: HistogramSeries[]): TransformHistogramDataResult;
 export {};

package/charts/xy-chart-adoption/histogram/transformer-data-to-xy.js

@@ -23,32 +23,31 @@ module.exports = __toCommonJS(transformer_data_to_xy_exports);
 function transformHistogramDataToXYChart(data) {
   const seriesColors = [];
   const units = /* @__PURE__ */ new Set();
-  const barSeriesProps = [];
+  const unitToData = /* @__PURE__ */ new Map();
+  const unitToSeriesCount = /* @__PURE__ */ new Map();
   data.forEach((series, index) => {
-    const xyData = [];
     const { bins, name, color, unit, ...extraSeriesProps } = series;
     if (color) {
       seriesColors.push({ name, color });
     }
-    bins.forEach((bin) => {
-      const datapoint = {
-        ...extraSeriesProps,
-        x0: bin.from,
-        x1: bin.to,
-        y1: bin.value,
-        name,
-        seriesId: index.toString()
-      };
-      xyData.push(datapoint);
-    });
-    barSeriesProps.push({
-      data: xyData,
-      unit
-    });
+    const binData = bins.map((bin) => ({
+      ...extraSeriesProps,
+      x0: bin.from,
+      x1: bin.to,
+      y1: bin.value,
+      name,
+      seriesId: index.toString()
+    }));
+    unitToData.set(unit, [...unitToData.get(unit) ?? [], ...binData]);
+    unitToSeriesCount.set(unit, (unitToSeriesCount.get(unit) ?? 0) + 1);
     units.add(unit);
   });
   return {
-    barSeriesProps,
+    barSeriesProps: Array.from(unitToData, ([unit, data2]) => ({
+      unit,
+      data: data2,
+      seriesCount: unitToSeriesCount.get(unit) ?? 1
+    })),
     units,
     seriesColors
   };

package/charts/xy-chart-adoption/histogram/transformer-thresholds-to-xy.d.ts

@@ -0,0 +1,4 @@
+import type { ChartUnit } from '../../core/types/chart-unit.js';
+import type { HistogramThresholdsConfig } from '../../histogram/types/histogram-props.js';
+import type { XYChartThresholdIndicatorProps } from '../../xy-chart/types/xy-chart-props.js';
+export declare function mapHistogramThresholdsToXY(thresholds: HistogramThresholdsConfig | undefined, units: ChartUnit[]): XYChartThresholdIndicatorProps[];

package/charts/xy-chart-adoption/histogram/transformer-thresholds-to-xy.js

@@ -0,0 +1,96 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var transformer_thresholds_to_xy_exports = {};
+__export(transformer_thresholds_to_xy_exports, {
+  mapHistogramThresholdsToXY: () => mapHistogramThresholdsToXY
+});
+module.exports = __toCommonJS(transformer_thresholds_to_xy_exports);
+var import_define_axis_id = require("./utils/define-axis-id.js");
+var import_type_guards = require("../../core/types/type-guards.js");
+const X_AXIS_ID = "x-axis";
+function buildPositionToAxisIdMap(units) {
+  if (units.length <= 1) {
+    const axisId = units.length === 1 ? (0, import_define_axis_id.defineAxisId)(units[0]) : "";
+    return { left: axisId, right: axisId };
+  }
+  const map = {};
+  units.forEach((unit, index) => {
+    const position = index % 2 === 0 ? "left" : "right";
+    if (!(position in map)) {
+      map[position] = (0, import_define_axis_id.defineAxisId)(unit);
+    }
+  });
+  return map;
+}
+function mapHistogramThresholdsToXY(thresholds, units) {
+  if (!thresholds) {
+    return [];
+  }
+  const positionToAxisId = buildPositionToAxisIdMap(units);
+  const flatThresholds = [
+    ...thresholds.leftThreshold ?? [],
+    ...thresholds.rightThreshold ?? []
+  ];
+  return flatThresholds.reduce(
+    (result, threshold) => {
+      const position = threshold.position ?? "left";
+      const yAxisId = positionToAxisId[position];
+      if (!yAxisId) {
+        return result;
+      }
+      const { data, color, label, strokeOnly } = threshold;
+      if ((0, import_type_guards.isStatic)(data)) {
+        result.push({
+          data: { y: data.value },
+          color,
+          label,
+          strokeOnly,
+          yAxisId
+        });
+      } else if ((0, import_type_guards.isStaticRange)(data)) {
+        result.push({
+          data: { yMin: data.min, yMax: data.max },
+          color,
+          label,
+          strokeOnly,
+          yAxisId
+        });
+      } else if ((0, import_type_guards.isDynamicNumeric)(data)) {
+        result.push({
+          data: data.map((d) => ({ y: d.value, x: d.point })),
+          color,
+          label,
+          strokeOnly,
+          yAxisId,
+          xAxisId: X_AXIS_ID
+        });
+      } else if ((0, import_type_guards.isDynamicNumericRange)(data)) {
+        result.push({
+          data: data.map((d) => ({ yMin: d.min, yMax: d.max, x: d.point })),
+          color,
+          label,
+          strokeOnly,
+          yAxisId,
+          xAxisId: X_AXIS_ID
+        });
+      }
+      return result;
+    },
+    []
+  );
+}

package/charts/xy-chart-adoption/histogram/types/slots.d.ts

@@ -1,22 +1,36 @@
 import type { IntentProps } from '../../../../core/slots/Intent/Intent.js';
+import type { AnnotationsTooltipConfig } from '../../../core/components/annotations/components/tooltip/types/annotations-tooltip-props.js';
+import type { AnnotationsTrackConfig } from '../../../core/components/annotations/types/annotations-track-props.js';
+import type { AnnotationsActionsHandler } from '../../../core/components/annotations/types/annotations.js';
 import type { ColorRuleProps } from '../../../core/types/color-rule.js';
 import type { LegendProps } from '../../../core/types/legend.js';
+import type { ValueRepresentation } from '../../../core/types/scales.js';
 import type { SelectProps } from '../../../histogram/slots/Select.js';
+import type { HistogramThresholdIndicatorProps } from '../../../histogram/slots/ThresholdIndicator.js';
 import type { HistogramChartToolbarProps, HistogramChartXAxisProps, HistogramChartYAxisProps } from '../../../histogram/types/histogram-props.js';
 import type { HistogramToolbarSlotProps } from '../../../histogram/types/toolbar.js';
 import type { XYChartLogAxisProps, XYChartNumericalAxisProps } from '../../../xy-chart/types/xy-chart-props.js';
 import type { LEFT_POSITION, RIGHT_POSITION } from '../../../xy-chart/types/xy-chart.js';
+export interface HistogramAnnotationsSlots {
+    tracks: AnnotationsTrackConfig[];
+    tooltip: AnnotationsTooltipConfig | undefined;
+    showLabels?: boolean;
+    visibleTracksLimit?: number;
+    annotationsActions?: AnnotationsActionsHandler;
+}
 export interface HistogramSlots {
     disableZoom: boolean;
     disablePan: boolean;
     legend: LegendProps;
     selectActions?: SelectProps['actions'];
     colorRules: ColorRuleProps[];
+    thresholds: HistogramThresholdIndicatorProps[];
     yAxis: HistogramChartYAxisProps[];
     xAxis: HistogramChartXAxisProps;
     toolbar: HistogramToolbarSlotProps;
     deprecatedToolbar: HistogramChartToolbarProps;
     intents?: IntentProps[];
+    annotations?: HistogramAnnotationsSlots;
 }
 export type MappedPositionedAxes = {
     left?: Omit<YAxisProps, 'id'>;
@@ -25,5 +39,6 @@ export type MappedPositionedAxes = {
 export type YAxisPosition = typeof LEFT_POSITION | typeof RIGHT_POSITION;
 export type YAxisProps = Pick<XYChartNumericalAxisProps | XYChartLogAxisProps, 'id' | 'min' | 'max' | 'formatter' | 'unit' | 'type' | 'label'> & {
     position: YAxisPosition;
+    valueRepresentation?: ValueRepresentation;
 };
 export type XAxisProps = Pick<XYChartNumericalAxisProps | XYChartLogAxisProps, 'min' | 'max' | 'unit' | 'type' | 'label'>;

package/charts/xy-chart-adoption/histogram/utils/axis-props-mapping.d.ts

@@ -1,3 +1,4 @@
 import type { ChartUnit } from '../../../core/types/chart-unit.js';
+import type { ValueRepresentation } from '../../../core/types/scales.js';
 import type { MappedPositionedAxes, YAxisProps } from '../types/slots.js';
-export declare const buildYAxisProps: (index: number, unit: ChartUnit, axesConfig: MappedPositionedAxes) => YAxisProps;
+export declare const buildYAxisProps: (index: number, unit: ChartUnit, axesConfig: MappedPositionedAxes, valueRepresentation?: ValueRepresentation) => YAxisProps;

package/charts/xy-chart-adoption/histogram/utils/axis-props-mapping.js

@@ -21,14 +21,15 @@ __export(axis_props_mapping_exports, {
 });
 module.exports = __toCommonJS(axis_props_mapping_exports);
 var import_define_axis_id = require("./define-axis-id.js");
-const buildYAxisProps = (index, unit, axesConfig) => {
-  const position = index % 2 === 0 ? "left" : "right";
+const buildYAxisProps = (index, unit, axesConfig, valueRepresentation) => {
+  const position = valueRepresentation === "relative" || index % 2 === 0 ? "left" : "right";
   const axisConfig = axesConfig[position];
   return {
     ...axisConfig,
     type: axisConfig?.type ?? "numerical",
     position,
     id: (0, import_define_axis_id.defineAxisId)(unit),
-    unit
+    unit,
+    valueRepresentation
   };
 };

package/charts/xy-chart-adoption/histogram/utils/build-histogram-imperative-handle.d.ts

@@ -0,0 +1,14 @@
+import type { RefObject } from 'react';
+import type { HistogramChartConfiguration } from '../../../histogram/types/histogram-props.js';
+import type { HistogramChartRef } from '../../../histogram/types/histogram-ref.js';
+import type { XYChartRef } from '../../../xy-chart/types/xy-chart.js';
+/**
+ * Builds the Histogram-shaped imperative handle for `HistogramToXY`.
+ *
+ * - All programmatic interaction methods are delegated to the inner
+ *   `XYChart` ref.
+ * - `getConfig()` returns a Histogram-shaped serialized payload built from
+ *   the resolved `HistogramChartConfiguration` (see
+ *   `serializeHistogramConfig`).
+ */
+export declare const buildHistogramImperativeHandle: (xyRef: RefObject<XYChartRef | null>, config: HistogramChartConfiguration) => HistogramChartRef;

package/charts/xy-chart-adoption/histogram/utils/build-histogram-imperative-handle.js

@@ -0,0 +1,36 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var build_histogram_imperative_handle_exports = {};
+__export(build_histogram_imperative_handle_exports, {
+  buildHistogramImperativeHandle: () => buildHistogramImperativeHandle
+});
+module.exports = __toCommonJS(build_histogram_imperative_handle_exports);
+var import_serialize_histogram_config = require("./serialize-histogram-config.js");
+const buildHistogramImperativeHandle = (xyRef, config) => ({
+  get element() {
+    return xyRef.current?.element ?? null;
+  },
+  getConfig: () => (0, import_serialize_histogram_config.serializeHistogramConfig)(config),
+  downloadData: () => xyRef.current?.downloadData(),
+  exploreMode: () => xyRef.current?.exploreMode(),
+  zoomMode: () => xyRef.current?.zoomMode(),
+  panMode: () => xyRef.current?.panMode(),
+  zoomIn: () => xyRef.current?.zoomIn(),
+  zoomOut: () => xyRef.current?.zoomOut(),
+  reset: () => xyRef.current?.reset()
+});

package/charts/xy-chart-adoption/histogram/utils/build-y-axes-config.d.ts

@@ -0,0 +1,12 @@
+import type { HistogramChartConfiguration, HistogramChartYAxisProps } from '../../../histogram/types/histogram-props.js';
+import type { MappedPositionedAxes, YAxisProps } from '../types/slots.js';
+/**
+ * Maps a Histogram y-axis (left or right) into the partial XYChart-compatible
+ * y-axis representation used by `buildYAxisProps`.
+ */
+export declare const mapYAxisToInternal: (yAxis: HistogramChartYAxisProps | undefined, position: "left" | "right") => Omit<YAxisProps, "id"> | undefined;
+/**
+ * Builds the `MappedPositionedAxes` shape expected by `buildYAxisProps`
+ * from a fully resolved `HistogramChartConfiguration`.
+ */
+export declare const buildYAxesConfigFromConfig: (config: HistogramChartConfiguration) => MappedPositionedAxes;

package/charts/xy-chart-adoption/histogram/utils/build-y-axes-config.js

@@ -0,0 +1,46 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var build_y_axes_config_exports = {};
+__export(build_y_axes_config_exports, {
+  buildYAxesConfigFromConfig: () => buildYAxesConfigFromConfig,
+  mapYAxisToInternal: () => mapYAxisToInternal
+});
+module.exports = __toCommonJS(build_y_axes_config_exports);
+const mapYAxisToInternal = (yAxis, position) => {
+  if (!yAxis) {
+    return void 0;
+  }
+  const { position: _position, scale, ...rest } = yAxis;
+  return {
+    ...rest,
+    type: scale === "log" ? "log" : "numerical",
+    position
+  };
+};
+const buildYAxesConfigFromConfig = (config) => {
+  const left = mapYAxisToInternal(config.yAxis.left, "left");
+  const right = mapYAxisToInternal(config.yAxis.right, "right");
+  const result = {};
+  if (left) {
+    result.left = left;
+  }
+  if (right) {
+    result.right = right;
+  }
+  return result;
+};

package/charts/xy-chart-adoption/histogram/utils/derive-xychart-props-from-config.d.ts

@@ -0,0 +1,36 @@
+import type { IntentProps } from '../../../../core/slots/Intent/Intent.js';
+import type { ZoomChangeHandler } from '../../../core/types/interactions.js';
+import type { ToolbarPlacement } from '../../../core/types/toolbar.js';
+import type { HistogramChartConfiguration, HistogramChartXAxisConfig } from '../../../histogram/types/histogram-props.js';
+export type DerivedXYChartProps = {
+    /** Resolved x-axis config (defaults applied). */
+    xAxisConfig: HistogramChartXAxisConfig;
+    /** Whether the XYChart x-axis should disable zoom. */
+    disableZoom: boolean;
+    /** Whether the XYChart x-axis should disable pan. */
+    disablePan: boolean;
+    /** Whether the XYChart toolbar should be visible. */
+    toolbarEnabled: boolean;
+    /** Toolbar placement (or undefined if defaults should apply). */
+    toolbarPlacement: ToolbarPlacement | undefined;
+    /** Resolved toolbar intents. */
+    toolbarIntents: IntentProps[] | undefined;
+    /**
+     * Effective onZoomChange handler. Histogram exposes it both at root-prop
+     * level and (after merging) inside `interactions`. Root prop wins.
+     */
+    onZoomChange: ZoomChangeHandler | undefined;
+};
+/**
+ * Picks the `onZoomChange` handler from a resolved Histogram configuration.
+ * `createHistogramConfiguration` stores it under `interactions.onZoomChange`
+ * when it originates from props; root-prop values still win when provided
+ * directly.
+ */
+export declare const pickOnZoomChange: (config: HistogramChartConfiguration, rootOnZoomChange: ZoomChangeHandler | undefined) => ZoomChangeHandler | undefined;
+/**
+ * Derives the props the `HistogramToXY` adapter needs to forward to the
+ * underlying `XYChart` (and its slots) from a resolved
+ * `HistogramChartConfiguration`.
+ */
+export declare const deriveXYChartPropsFromConfig: (config: HistogramChartConfiguration, rootOnZoomChange: ZoomChangeHandler | undefined) => DerivedXYChartProps;

package/charts/xy-chart-adoption/histogram/utils/derive-xychart-props-from-config.js

@@ -0,0 +1,33 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var derive_xychart_props_from_config_exports = {};
+__export(derive_xychart_props_from_config_exports, {
+  deriveXYChartPropsFromConfig: () => deriveXYChartPropsFromConfig,
+  pickOnZoomChange: () => pickOnZoomChange
+});
+module.exports = __toCommonJS(derive_xychart_props_from_config_exports);
+const pickOnZoomChange = (config, rootOnZoomChange) => rootOnZoomChange ?? config.interactions?.onZoomChange;
+const deriveXYChartPropsFromConfig = (config, rootOnZoomChange) => ({
+  xAxisConfig: config.xAxis,
+  disableZoom: config.interactions?.zoom?.enabled === false,
+  disablePan: config.interactions?.pan?.enabled === false,
+  toolbarEnabled: config.toolbar?.enabled !== false,
+  toolbarPlacement: config.toolbar?.placement,
+  toolbarIntents: config.toolbar?.intents,
+  onZoomChange: pickOnZoomChange(config, rootOnZoomChange)
+});

package/charts/xy-chart-adoption/histogram/utils/serialize-histogram-config.d.ts

@@ -0,0 +1,9 @@
+import type { HistogramChartConfiguration } from '../../../histogram/types/histogram-props.js';
+/**
+ * Produces the same Histogram-shaped serialized config payload as the
+ * legacy `HistogramChartImperativeHandler.getConfig()`.
+ *
+ * This is the single source of truth for the export shape consumed by the
+ * `HistogramChartConfig` import API and `HistogramChartRef.getConfig()`.
+ */
+export declare const serializeHistogramConfig: (config: HistogramChartConfiguration) => string;