@centreon/ui 24.5.12 → 24.5.13

package/src/Graph/HeatMap/HeatMap.cypress.spec.tsx

@@ -0,0 +1,145 @@
+import { pluck } from 'ramda';
+
+import { Box, Typography } from '@mui/material';
+
+import EllipsisTypography from '../../Typography/EllipsisTypography';
+
+import HeatMap from './HeatMap';
+import heatMapData from './HeatMapData.json';
+import { HeatMapProps } from './model';
+
+const dataIds = pluck('id', heatMapData);
+
+interface Data {
+  counter: number;
+  host: string;
+  service: string;
+}
+
+const TileContent = ({
+  isSmallestSize,
+  data
+}: {
+  data: Data;
+  isSmallestSize: boolean;
+}): JSX.Element | false =>
+  !isSmallestSize && (
+    <Box
+      sx={{
+        alignItems: 'center',
+        color: 'common.black',
+        display: 'flex',
+        flexDirection: 'column',
+        width: '100%'
+      }}
+    >
+      <EllipsisTypography textAlign="center">{data.host}</EllipsisTypography>
+      <EllipsisTypography textAlign="center">{data.service}</EllipsisTypography>
+      <EllipsisTypography textAlign="center">{data.counter}</EllipsisTypography>
+    </Box>
+  );
+
+const initialize = ({
+  width = '100vw',
+  height = '100vh',
+  ...args
+}: Omit<HeatMapProps<Data>, 'tiles' | 'children'> & {
+  height?: string;
+  width?: string;
+}): void => {
+  cy.mount({
+    Component: (
+      <div style={{ height, width }}>
+        <HeatMap tiles={heatMapData} {...args}>
+          {TileContent}
+        </HeatMap>
+      </div>
+    )
+  });
+};
+
+describe('HeatMap', () => {
+  it('displays tiles', () => {
+    initialize({});
+    dataIds.forEach((id) => {
+      cy.findByTestId(id).should('be.visible');
+    });
+  });
+
+  it('does not display the tooltip when the prop is not set and the tile is hovered', () => {
+    initialize({});
+
+    cy.findByTestId(dataIds[0]).trigger('mouseover');
+
+    cy.findByTestId(`tooltip-${dataIds[0]}`).should('not.exist');
+  });
+
+  it('displays the tooltip when the prop is set and the tile is hovered', () => {
+    initialize({
+      tooltipContent: ({ data }) => (
+        <Typography>
+          This is the tooltip for {data.host}-{data.service}-{data.counter}
+        </Typography>
+      )
+    });
+
+    cy.findByTestId(dataIds[0]).trigger('mouseover');
+
+    cy.contains(`This is the tooltip for Server-Service Counter-53`).should(
+      'be.visible'
+    );
+  });
+
+  it('displays the tooltip conditionally when the prop is set and the tile is hovered', () => {
+    initialize({
+      displayTooltipCondition: ({ counter }) => counter > 100,
+      tooltipContent: ({ data }) => (
+        <Typography>
+          This is the tooltip for {data.host}-{data.service}-{data.counter}
+        </Typography>
+      )
+    });
+
+    cy.findByTestId(dataIds[0]).trigger('mouseover');
+
+    cy.contains(`This is the tooltip for Server-Service Counter-53`).should(
+      'not.exist'
+    );
+
+    cy.findByTestId(dataIds[1]).trigger('mouseover');
+
+    cy.contains(`This is the tooltip for Server-Service Counter-779`).should(
+      'be.visible'
+    );
+  });
+
+  it('displays tiles with fixed size', () => {
+    initialize({ height: '200px', tileSizeFixed: true, width: '590px' });
+    dataIds.forEach((id) => {
+      cy.findByTestId(id).should('be.visible');
+    });
+  });
+
+  it('displays tiles as small when the container width is under the breakpoint', () => {
+    initialize({ height: '200px', width: '590px' });
+    dataIds.forEach((id) => {
+      cy.findByTestId(id).should('be.visible');
+    });
+
+    cy.makeSnapshot();
+  });
+
+  it('does not display tiles as small when the contains width is 0', () => {
+    initialize({ height: '200px', width: '0px' });
+    dataIds.forEach((id) => {
+      cy.findByTestId(id).should('not.exist');
+    });
+
+    cy.makeSnapshot();
+  });
+
+  it('displays a single tile', () => {
+    initialize({ tiles: [heatMapData[0]] });
+    cy.findByTestId(dataIds[0]).should('be.visible');
+  });
+});

package/src/Graph/HeatMap/HeatMap.stories.tsx

@@ -0,0 +1,100 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { makeStyles } from 'tss-react/mui';
+
+import { Box, Typography } from '@mui/material';
+
+import heatMapData from './HeatMapData.json';
+
+import { HeatMap } from '.';
+
+interface Data {
+  counter: number;
+  host: string;
+  service: string;
+}
+
+const meta: Meta<typeof HeatMap<Data>> = {
+  component: HeatMap
+};
+
+export default meta;
+type Story = StoryObj<typeof HeatMap<Data>>;
+
+const TooltipContent = ({ data }: { data: Data }): JSX.Element => {
+  return (
+    <Box sx={{ backgroundColor: 'common.white', color: 'common.black' }}>
+      <Box
+        sx={{
+          backgroundColor: 'common.black',
+          color: 'common.white',
+          display: 'flex',
+          justifyContent: 'center',
+          py: 1,
+          width: '100%'
+        }}
+      >
+        <Typography>{data.host}</Typography>
+      </Box>
+      <Box sx={{ px: 1, textAlign: 'center' }}>
+        <Typography>{data.service}</Typography>
+        <Typography>{data.counter}</Typography>
+      </Box>
+    </Box>
+  );
+};
+
+const useStyles = makeStyles()((theme) => ({
+  arrow: {
+    color: theme.palette.common.black
+  }
+}));
+
+const Template = (args): JSX.Element => {
+  const { classes } = useStyles();
+
+  return <HeatMap {...args} arrowClassName={classes.arrow} />;
+};
+
+const TileContent = ({
+  data,
+  backgroundColor
+}: {
+  backgroundColor: string;
+  data: Data;
+}): JSX.Element => (
+  <div
+    style={{
+      alignItems: 'center',
+      backgroundColor,
+      display: 'flex',
+      height: '100%',
+      justifyContent: 'center'
+    }}
+  >
+    {data.counter}
+  </div>
+);
+
+export const normal: Story = {
+  args: {
+    children: TileContent,
+    tiles: heatMapData
+  }
+};
+
+export const withTooltip: Story = {
+  args: {
+    children: TileContent,
+    tiles: heatMapData,
+    tooltipContent: TooltipContent
+  },
+  render: Template
+};
+
+export const tilesWithFixedSize: Story = {
+  args: {
+    children: TileContent,
+    tileSizeFixed: true,
+    tiles: heatMapData
+  }
+};

package/src/Graph/HeatMap/HeatMap.styles.tsx

@@ -0,0 +1,29 @@
+import { makeStyles } from 'tss-react/mui';
+
+export const useHeatMapStyles = makeStyles()((theme) => ({
+  arrow: {
+    transform: 'transled3d(0px, 8px, 0px)'
+  },
+  heatMapTile: {
+    alignItems: 'center',
+    aspectRatio: '1 / 1',
+    borderRadius: theme.shape.borderRadius,
+    display: 'flex',
+    justifyContent: 'center',
+    width: '100%'
+  },
+  heatMapTileContent: {
+    height: `calc(100% - ${theme.spacing(1)})`,
+    width: `calc(100% - ${theme.spacing(1)})`
+  },
+  heatMapTooltip: {
+    backgroundColor: theme.palette.background.paper,
+    color: theme.palette.text.primary,
+    marginLeft: `${theme.spacing(1.25)} !important`,
+    padding: 0,
+    position: 'relative'
+  },
+  heatMapTooltipArrow: {
+    transform: `translate3d(0px, ${theme.spacing(1)}, 0px) !important`
+  }
+}));

package/src/Graph/HeatMap/HeatMap.tsx

@@ -0,0 +1,12 @@
+import { ParentSize } from '../..';
+
+import ResponsiveHeatMap from './ResponsiveHeatMap';
+import { HeatMapProps } from './model';
+
+const HeatMap = <TData,>(props: HeatMapProps<TData>): JSX.Element => (
+  <ParentSize>
+    {({ width }) => <ResponsiveHeatMap<TData> {...props} width={width} />}
+  </ParentSize>
+);
+
+export default HeatMap;

package/src/Graph/HeatMap/HeatMapData.json

@@ -0,0 +1,137 @@
+[
+  {
+    "id": "Orbaxter",
+    "backgroundColor": "#88B922",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 53
+    }
+  },
+  {
+    "id": "Interfind",
+    "backgroundColor": "#88B922",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 779
+    }
+  },
+  {
+    "id": "Ecratic",
+    "backgroundColor": "#E3E3E3",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 504
+    }
+  },
+  {
+    "id": "Earthwax",
+    "backgroundColor": "#88B922",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 374
+    }
+  },
+  {
+    "id": "Cytrak",
+    "backgroundColor": "#FF6666",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 957
+    }
+  },
+  {
+    "id": "Exiand",
+    "backgroundColor": "#1EBEB3",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 281
+    }
+  },
+  {
+    "id": "Ginkogene",
+    "backgroundColor": "#FF6666",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 472
+    }
+  },
+  {
+    "id": "Quailcom",
+    "backgroundColor": "#88B922",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 770
+    }
+  },
+  {
+    "id": "Cormoran",
+    "backgroundColor": "#FF6666",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 908
+    }
+  },
+  {
+    "id": "Emergent",
+    "backgroundColor": "#1EBEB3",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 969
+    }
+  },
+  {
+    "id": "Limozen",
+    "backgroundColor": "#E3E3E3",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 33
+    }
+  },
+  {
+    "id": "Gogol",
+    "backgroundColor": "#1EBEB3",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 870
+    }
+  },
+  {
+    "id": "Luxuria",
+    "backgroundColor": "#FD9B27",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 270
+    }
+  },
+  {
+    "id": "Fossiel",
+    "backgroundColor": "#1EBEB3",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 955
+    }
+  },
+  {
+    "id": "Hawkster",
+    "backgroundColor": "#88B922",
+    "data": {
+      "host": "Server",
+      "service": "Service Counter",
+      "counter": 28
+    }
+  }
+]

package/src/Graph/HeatMap/ResponsiveHeatMap.tsx

@@ -0,0 +1,104 @@
+import { useMemo } from 'react';
+
+import { scaleLinear } from '@visx/scale';
+import { T, equals, gt, lt } from 'ramda';
+
+import { Box } from '@mui/material';
+
+import { Tooltip } from '../../components';
+
+import { HeatMapProps } from './model';
+import { useHeatMapStyles } from './HeatMap.styles';
+
+const gap = 8;
+const maxTileSize = 120;
+const smallestTileSize = 44;
+
+const ResponsiveHeatMap = <TData,>({
+  width,
+  children,
+  tiles,
+  arrowClassName,
+  tooltipContent,
+  tileSizeFixed,
+  displayTooltipCondition = T
+}: HeatMapProps<TData> & { width: number }): JSX.Element | null => {
+  const { classes, cx } = useHeatMapStyles();
+
+  const tileSize = useMemo(() => {
+    const scaleWidth = scaleLinear({
+      clamp: true,
+      domain: [680, 1056],
+      range: [76, maxTileSize]
+    });
+    const tileWidth = scaleWidth(width);
+
+    const tilesLength = tiles.length;
+
+    const maxTotalTilesWidth =
+      tilesLength * maxTileSize + (tilesLength - 1) * gap;
+    const theoricalTotalTilesWidth =
+      tilesLength * tileWidth + (tilesLength - 1) * gap;
+
+    if (lt(width, 680) && gt(maxTotalTilesWidth, width) && !tileSizeFixed) {
+      return smallestTileSize;
+    }
+
+    if (lt(theoricalTotalTilesWidth, width)) {
+      return maxTileSize;
+    }
+
+    return tileSizeFixed ? maxTileSize : tileWidth;
+  }, [width, tiles]);
+
+  const isSmallestSize = equals(tileSize, smallestTileSize);
+
+  if (equals(width, 0)) {
+    return null;
+  }
+
+  return (
+    <Box
+      sx={{
+        display: 'grid',
+        gap: 1,
+        gridTemplateColumns: `repeat(auto-fit, ${tileSize}px)`
+      }}
+    >
+      {tiles.map(({ backgroundColor, id, data }) => (
+        <Box
+          className={classes.heatMapTile}
+          data-testid={id}
+          key={id}
+          sx={{ backgroundColor }}
+        >
+          <Tooltip
+            hasCaret
+            classes={{
+              arrow: cx(classes.heatMapTooltipArrow, arrowClassName),
+              tooltip: classes.heatMapTooltip
+            }}
+            data-testid={`tooltip-${data?.id}`}
+            followCursor={false}
+            label={
+              displayTooltipCondition?.(data) &&
+              tooltipContent?.({
+                backgroundColor,
+                data,
+                id,
+                isSmallestSize
+              })
+            }
+            position="right-start"
+          >
+            <div className={classes.heatMapTileContent}>
+              {children({ backgroundColor, data, id, isSmallestSize })}
+            </div>
+          </Tooltip>
+        </Box>
+      ))}
+    </Box>
+  );
+};
+
+export default ResponsiveHeatMap;

package/src/Graph/HeatMap/index.ts

@@ -0,0 +1 @@
+export { default as HeatMap } from './HeatMap';

package/src/Graph/HeatMap/model.ts

@@ -0,0 +1,33 @@
+import { ReactElement } from 'react';
+
+interface Tile<TData> {
+  backgroundColor: string;
+  data: TData;
+  id: string;
+}
+
+interface ChildrenProps<TData> {
+  backgroundColor: string;
+  data: TData;
+  id: string;
+  isSmallestSize: boolean;
+}
+
+export interface HeatMapProps<TData> {
+  arrowClassName?: string;
+  children: ({
+    backgroundColor,
+    id,
+    data,
+    isSmallestSize
+  }: ChildrenProps<TData>) => ReactElement | boolean | null;
+  displayTooltipCondition?: (data: TData) => boolean;
+  tileSizeFixed?: boolean;
+  tiles: Array<Tile<TData>>;
+  tooltipContent?: ({
+    backgroundColor,
+    id,
+    data,
+    isSmallestSize
+  }: ChildrenProps<TData>) => ReactElement | boolean | null;
+}

package/src/Graph/Legend/Legend.tsx

@@ -0,0 +1,21 @@
+import { LegendOrdinal } from '@visx/legend';
+import { scaleOrdinal } from '@visx/scale';
+
+import { LegendProps } from './models';
+
+const Legend = ({ scale, direction = 'column' }: LegendProps): JSX.Element => {
+  const legendScale = scaleOrdinal({
+    domain: scale.domain,
+    range: scale.range
+  });
+
+  return (
+    <LegendOrdinal
+      direction={direction}
+      labelMargin="0 16px 0 0"
+      scale={legendScale}
+    />
+  );
+};
+
+export default Legend;

package/src/Graph/Legend/index.ts

@@ -0,0 +1 @@
+export { default as Legend } from './Legend';

package/src/Graph/Legend/models.ts

@@ -0,0 +1,11 @@
+export type LegendDirection = 'row' | 'column';
+
+export interface LegendScale {
+  domain: Array<number | string>;
+  range: Array<string>;
+}
+
+export interface LegendProps {
+  direction?: LegendDirection;
+  scale: LegendScale;
+}

package/src/Graph/LineChart/BasicComponents/Axes/UnitLabel.tsx

@@ -0,0 +1,20 @@
+import { commonTickLabelProps } from '../../common';
+
+interface UnitLabelProps {
+  unit: string;
+  x: number;
+  y?: number;
+}
+
+const UnitLabel = ({ x, y = 16, unit }: UnitLabelProps): JSX.Element => (
+  <text
+    fontFamily={commonTickLabelProps.fontFamily}
+    fontSize={commonTickLabelProps.fontSize}
+    x={x}
+    y={-y}
+  >
+    {unit}
+  </text>
+);
+
+export default UnitLabel;