@gridsuite/commons-ui 0.269.0 → 0.271.0

package/dist/features/network-modifications/twoWindingsTransformer/tapChanger/phaseTapChanger/PhaseTapChangerPaneSteps.js

@@ -0,0 +1,201 @@
+import { jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { useIntl } from "react-intl";
+import { FieldConstants } from "../../../../../utils/constants/fieldConstants.js";
+import "../../../../../utils/conversionUtils.js";
+import "../../../../../utils/types/equipmentType.js";
+import "@mui/icons-material";
+import { parseIntData } from "../../../../../utils/ts-utils.js";
+import { TapChangerSteps } from "../TapChangerSteps.js";
+import "@mui/material";
+import "../../../../../components/ui/overflowableText/OverflowableText.js";
+import "react-hook-form";
+import "localized-countries";
+import "localized-countries/data/fr";
+import "localized-countries/data/en";
+import "notistack";
+import "../../../../../components/ui/reactHookForm/provider/CustomFormProvider.js";
+import "yup";
+import "../../../../../components/ui/treeViewFinder/TreeViewFinder.js";
+import "../../../../../components/ui/reactHookForm/numbers/RangeInput.js";
+import "@material-symbols/svg-400/outlined/left_panel_open.svg?react";
+import "@material-symbols/svg-400/outlined/arrows_output.svg?react";
+import "@material-symbols/svg-400/outlined/arrows_input.svg?react";
+import "@material-symbols/svg-400/outlined/left_panel_close.svg?react";
+import "@material-symbols/svg-400/outlined/add_notes-fill.svg?react";
+import "../../../../../components/ui/dialogs/descriptionModificationDialog/DescriptionModificationDialog.js";
+import "../../../../../components/ui/reactHookForm/expandableInput/ExpandableInput.js";
+import "../../../../../components/ui/reactHookForm/directory-item-input/directory-item-utils.js";
+import "@hello-pangea/dnd";
+import "../../../../../components/ui/dialogs/elementSaveDialog/ElementSaveDialog.js";
+import "../../../../../components/ui/snackbarProvider/SnackbarProvider.js";
+import "mui-nested-menu";
+import "react-resizable-panels";
+import "react-papaparse";
+import "react-dom";
+import { DndColumnType } from "../../../../../components/composite/dnd-table/dnd-table.type.js";
+import "autosuggest-highlight/match";
+import "autosuggest-highlight/parse";
+import "clsx";
+import "../../../../../components/composite/filter/FilterCreationDialog.js";
+import "../../../../../components/composite/filter/HeaderFilterForm.js";
+import "../../../../../components/composite/filter/explicitNaming/ExplicitNamingFilterForm.js";
+import "../../../../../components/composite/filter/expert/ExpertFilterForm.js";
+import "../../../../../components/composite/filter/expert/ExpertFilterEditionDialog.js";
+import "../../../../../components/composite/filter/expert/expertFilterConstants.js";
+import "react-querybuilder";
+import "uuid";
+import "../../../../../components/composite/filter/explicitNaming/ExplicitNamingFilterEditionDialog.js";
+import "../../../../../components/composite/filter/utils/filterFormUtils.js";
+import "@react-querybuilder/material";
+import "../../../../../components/composite/reactQueryBuilder/CustomReactQueryBuilder.js";
+import "../../../../../components/composite/reactQueryBuilder/PropertyValueEditor.js";
+import "../../../../../components/composite/agGridTable/BottomTableButtons.js";
+import "../../../../../components/composite/agGridTable/CustomAgGridTable.js";
+import "ag-grid-community";
+import "../../../../../components/composite/customAGGrid/customAggrid.js";
+import "../../../../../components/composite/customAGGrid/context/custom-aggrid-context.js";
+import "mathjs";
+import "../../../../../components/composite/report/report-viewer/log-table/log-table.js";
+import "react-window";
+import "../../../../../components/composite/report/report-treeview/treeview-item.js";
+import "../../../../../components/composite/report/report-viewer/context/report-viewer-context.js";
+function PhaseTapChangerPaneSteps({
+  disabled,
+  previousValues,
+  editData,
+  isModification = false
+}) {
+  const intl = useIntl();
+  const COLUMNS_DEFINITIONS = useMemo(() => {
+    return [
+      {
+        label: "Tap",
+        dataKey: FieldConstants.STEPS_TAP,
+        type: DndColumnType.TEXT
+      },
+      {
+        label: "DeltaResistance",
+        dataKey: FieldConstants.STEPS_RESISTANCE,
+        initialValue: 0,
+        editable: true,
+        type: DndColumnType.NUMERIC,
+        clearable: false
+      },
+      {
+        label: "DeltaReactance",
+        dataKey: FieldConstants.STEPS_REACTANCE,
+        initialValue: 0,
+        editable: true,
+        type: DndColumnType.NUMERIC,
+        clearable: false
+      },
+      {
+        label: "DeltaConductance",
+        dataKey: FieldConstants.STEPS_CONDUCTANCE,
+        initialValue: 0,
+        editable: true,
+        type: DndColumnType.NUMERIC,
+        clearable: false
+      },
+      {
+        label: "DeltaSusceptance",
+        dataKey: FieldConstants.STEPS_SUSCEPTANCE,
+        initialValue: 0,
+        editable: true,
+        type: DndColumnType.NUMERIC,
+        clearable: false
+      },
+      {
+        label: "Ratio",
+        dataKey: FieldConstants.STEPS_RATIO,
+        initialValue: 1,
+        editable: true,
+        type: DndColumnType.NUMERIC,
+        clearable: false
+      },
+      {
+        label: "Alpha",
+        dataKey: FieldConstants.STEPS_ALPHA,
+        initialValue: 0,
+        editable: true,
+        type: DndColumnType.NUMERIC,
+        clearable: false
+      }
+    ].map((column) => ({
+      ...column,
+      label: intl.formatMessage({ id: column.label }).toLowerCase().replace(/^\w/, (c) => c.toUpperCase())
+    }));
+  }, [intl]);
+  const csvColumns = useMemo(() => {
+    return [
+      intl.formatMessage({ id: "ImportFileResistance" }),
+      intl.formatMessage({ id: "ImportFileReactance" }),
+      intl.formatMessage({ id: "ImportFileConductance" }),
+      intl.formatMessage({ id: "ImportFileSusceptance" }),
+      intl.formatMessage({ id: "Ratio" }),
+      intl.formatMessage({ id: "ImportFileAlpha" })
+    ];
+  }, [intl]);
+  const handleImportRow = (val) => {
+    return {
+      [FieldConstants.STEPS_RESISTANCE]: parseIntData(
+        val[intl.formatMessage({
+          id: "ImportFileResistance"
+        })],
+        0
+      ),
+      [FieldConstants.STEPS_REACTANCE]: parseIntData(
+        val[intl.formatMessage({
+          id: "ImportFileReactance"
+        })],
+        0
+      ),
+      [FieldConstants.STEPS_CONDUCTANCE]: parseIntData(
+        val[intl.formatMessage({
+          id: "ImportFileConductance"
+        })],
+        0
+      ),
+      [FieldConstants.STEPS_SUSCEPTANCE]: parseIntData(
+        val[intl.formatMessage({
+          id: "ImportFileSusceptance"
+        })],
+        0
+      ),
+      [FieldConstants.STEPS_RATIO]: Number.isNaN(Number.parseFloat(val[intl.formatMessage({ id: "Ratio" })])) ? 1 : Number.parseFloat(val[intl.formatMessage({ id: "Ratio" })]),
+      [FieldConstants.STEPS_ALPHA]: Number.isNaN(
+        Number.parseFloat(
+          val[intl.formatMessage({
+            id: "ImportFileAlpha"
+          })]
+        )
+      ) ? 1 : Number.parseFloat(
+        val[intl.formatMessage({
+          id: "ImportFileAlpha"
+        })]
+      )
+    };
+  };
+  return /* @__PURE__ */ jsx(
+    TapChangerSteps,
+    {
+      tapChanger: FieldConstants.PHASE_TAP_CHANGER,
+      createTapRuleColumn: FieldConstants.STEPS_ALPHA,
+      columnsDefinition: COLUMNS_DEFINITIONS,
+      csvColumns,
+      createRuleMessageId: "CreateDephasingRule",
+      createRuleAllowNegativeValues: true,
+      importRuleMessageId: "ImportDephasingRule",
+      resetButtonMessageId: "ResetRegulationRule",
+      handleImportRow,
+      disabled,
+      previousValues,
+      editData: editData?.phaseTapChanger?.steps,
+      isModification
+    }
+  );
+}
+export {
+  PhaseTapChangerPaneSteps
+};

package/dist/features/network-modifications/twoWindingsTransformer/tapChanger/phaseTapChanger/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026, RTE (http://www.rte-france.com)
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+export * from './phaseTapChanger.utils';
+export * from './PhaseTapChangerPaneSteps';
+export * from './PhaseTapChangerPane';

package/dist/features/network-modifications/twoWindingsTransformer/tapChanger/phaseTapChanger/index.js

@@ -0,0 +1,15 @@
+import { getComputedPhaseRegulationType, getComputedPhaseRegulationTypeId, getComputedPhaseTapChangerRegulationMode, getComputedPreviousPhaseRegulationType, getPhaseTapChangerEmptyFormData, getPhaseTapChangerFormData, getPhaseTapChangerValidationSchemaProps, getPhaseTapRegulationSideId } from "./phaseTapChanger.utils.js";
+import { PhaseTapChangerPaneSteps } from "./PhaseTapChangerPaneSteps.js";
+import { PhaseTapChangerPane } from "./PhaseTapChangerPane.js";
+export {
+  PhaseTapChangerPane,
+  PhaseTapChangerPaneSteps,
+  getComputedPhaseRegulationType,
+  getComputedPhaseRegulationTypeId,
+  getComputedPhaseTapChangerRegulationMode,
+  getComputedPreviousPhaseRegulationType,
+  getPhaseTapChangerEmptyFormData,
+  getPhaseTapChangerFormData,
+  getPhaseTapChangerValidationSchemaProps,
+  getPhaseTapRegulationSideId
+};

package/dist/features/network-modifications/twoWindingsTransformer/tapChanger/phaseTapChanger/phaseTapChanger.utils.d.ts

@@ -0,0 +1,114 @@
+import { InferType } from 'yup';
+import { TapChangerMapInfos, TapChangerStep, TwoWindingsTransformerMapInfos } from '../../common/twoWindingsTransformer.types';
+import { REGULATION_TYPES } from '../../../common';
+import { DeepNullable, FieldConstants, PHASE_REGULATION_MODES } from '../../../../../utils';
+export declare const getPhaseTapChangerValidationSchemaProps: (isModification?: boolean) => import('yup').ObjectSchema<{
+    voltageLevel: {
+        id?: string | undefined;
+        name?: string | undefined;
+        nominalVoltage?: string | undefined;
+        substationId?: string | undefined;
+        topologyKind?: string | null | undefined;
+    } | null;
+    equipment: {
+        id?: string | undefined;
+        name?: string | null | undefined;
+        type?: string | undefined;
+    } | null;
+    enabled: NonNullable<boolean | undefined>;
+    regulationMode: string | null | undefined;
+    regulationType: string | null | undefined;
+    regulationSide: string | null | undefined;
+    currentLimiterRegulatingValue: number | null | undefined;
+    flowSetPointRegulatingValue: number | null | undefined;
+    targetDeadband: number | null | undefined;
+    lowTapPosition: number | null | undefined;
+    highTapPosition: number | null | undefined;
+    tapPosition: number | null | undefined;
+    steps: {
+        b?: number | undefined;
+        g?: number | undefined;
+        r?: number | undefined;
+        x?: number | undefined;
+        rho?: number | undefined;
+        alpha?: number | undefined;
+        index: number;
+    }[] | undefined;
+}, import('yup').AnyObject, {
+    voltageLevel: {
+        id: undefined;
+        name: undefined;
+        substationId: undefined;
+        nominalVoltage: undefined;
+        topologyKind: undefined;
+    };
+    equipment: {
+        id: undefined;
+        name: undefined;
+        type: undefined;
+    };
+    enabled: undefined;
+    regulationMode: undefined;
+    regulationType: undefined;
+    regulationSide: undefined;
+    currentLimiterRegulatingValue: undefined;
+    flowSetPointRegulatingValue: undefined;
+    targetDeadband: undefined;
+    lowTapPosition: undefined;
+    highTapPosition: undefined;
+    tapPosition: undefined;
+    steps: "";
+}, "">;
+export type PhaseTapChangerFormSchema = InferType<ReturnType<typeof getPhaseTapChangerValidationSchemaProps>>;
+export declare const getPhaseTapChangerEmptyFormData: (isModification?: boolean) => DeepNullable<PhaseTapChangerFormSchema>;
+interface PhaseTapChangerFormDataInput {
+    [FieldConstants.ENABLED]?: boolean;
+    [FieldConstants.REGULATION_MODE]?: string | null;
+    [FieldConstants.REGULATION_TYPE]?: string | null;
+    [FieldConstants.REGULATION_SIDE]?: string | null;
+    [FieldConstants.CURRENT_LIMITER_REGULATING_VALUE]?: number | null;
+    flowSetpointRegulatingValue?: number | null;
+    [FieldConstants.TARGET_DEADBAND]?: number | null;
+    [FieldConstants.LOW_TAP_POSITION]?: number | null;
+    [FieldConstants.HIGH_TAP_POSITION]?: number | null;
+    [FieldConstants.TAP_POSITION]?: number | null;
+    [FieldConstants.STEPS]?: TapChangerStep[];
+    [FieldConstants.VOLTAGE_LEVEL_ID]?: string;
+    [FieldConstants.EQUIPMENT_ID]?: string;
+    [FieldConstants.EQUIPMENT_TYPE]?: string;
+}
+export declare const getPhaseTapChangerFormData: ({ enabled, regulationMode, regulationType, regulationSide, currentLimiterRegulatingValue, flowSetpointRegulatingValue, targetDeadband, lowTapPosition, highTapPosition, tapPosition, steps, voltageLevelId, equipmentID, equipmentType, }: PhaseTapChangerFormDataInput, id?: typeof FieldConstants.PHASE_TAP_CHANGER) => {
+    phaseTapChanger: {
+        voltageLevel: {
+            id: string;
+            name: string;
+            substationId: string;
+            nominalVoltage: string;
+            topologyKind: string;
+        } | null;
+        equipment: {
+            id: string;
+            name: string | null;
+            type: string;
+        } | null;
+        enabled: boolean;
+        regulationMode: string | null;
+        regulationType: string | null;
+        regulationSide: string | null;
+        currentLimiterRegulatingValue: number | null;
+        flowSetPointRegulatingValue: number | null;
+        targetDeadband: number | null;
+        lowTapPosition: number | null;
+        highTapPosition: number | null;
+        tapPosition: number | null;
+        steps: TapChangerStep[];
+    };
+};
+type PhaseRegulationMode = (typeof PHASE_REGULATION_MODES)[keyof typeof PHASE_REGULATION_MODES] | undefined;
+export declare const getComputedPhaseTapChangerRegulationMode: (phaseTapChangerFormValues?: TapChangerMapInfos) => PhaseRegulationMode;
+export declare const getPhaseTapRegulationSideId: (twt?: TwoWindingsTransformerMapInfos) => string | null;
+type RegulationType = (typeof REGULATION_TYPES)[keyof typeof REGULATION_TYPES] | null;
+export declare const getComputedPhaseRegulationType: (twt?: TwoWindingsTransformerMapInfos) => RegulationType;
+export declare const getComputedPhaseRegulationTypeId: (twt?: TwoWindingsTransformerMapInfos) => string | null;
+export declare const getComputedPreviousPhaseRegulationType: (previousValues?: TwoWindingsTransformerMapInfos) => string | null;
+export {};

package/dist/features/network-modifications/twoWindingsTransformer/tapChanger/phaseTapChanger/phaseTapChanger.utils.js

@@ -0,0 +1,242 @@
+import { object, array, number, ref, string, bool } from "yup";
+import "react/jsx-runtime";
+import "react";
+import "react-hook-form";
+import "../../../common/properties/propertyUtils.js";
+import "@mui/material";
+import { FieldConstants } from "../../../../../utils/constants/fieldConstants.js";
+import { TARGET_DEADBAND_MUST_BE_GREATER_OR_EQUAL_TO_ZERO } from "../../../../../utils/constants/translationKeys.js";
+import "../../../../../utils/conversionUtils.js";
+import { PHASE_REGULATION_MODES, REGULATION_SIDES } from "../../../../../utils/types/equipmentType.js";
+import { areNumbersOrdered, areArrayElementsUnique } from "../../../../../utils/functions.js";
+import "@mui/icons-material";
+import "react-intl";
+import "../../../../../components/ui/overflowableText/OverflowableText.js";
+import "localized-countries";
+import "localized-countries/data/fr";
+import "localized-countries/data/en";
+import "notistack";
+import "../../../../../components/ui/reactHookForm/provider/CustomFormProvider.js";
+import "../../../../../components/ui/treeViewFinder/TreeViewFinder.js";
+import "../../../../../components/ui/reactHookForm/numbers/RangeInput.js";
+import "@material-symbols/svg-400/outlined/left_panel_open.svg?react";
+import "@material-symbols/svg-400/outlined/arrows_output.svg?react";
+import "@material-symbols/svg-400/outlined/arrows_input.svg?react";
+import "@material-symbols/svg-400/outlined/left_panel_close.svg?react";
+import "@material-symbols/svg-400/outlined/add_notes-fill.svg?react";
+import "../../../../../components/ui/dialogs/descriptionModificationDialog/DescriptionModificationDialog.js";
+import "../../../../../components/ui/reactHookForm/expandableInput/ExpandableInput.js";
+import "../../../../../components/ui/reactHookForm/directory-item-input/directory-item-utils.js";
+import "@hello-pangea/dnd";
+import "../../../../../components/ui/dialogs/elementSaveDialog/ElementSaveDialog.js";
+import "../../../../../components/ui/snackbarProvider/SnackbarProvider.js";
+import "mui-nested-menu";
+import "react-resizable-panels";
+import "react-papaparse";
+import "react-dom";
+import "autosuggest-highlight/match";
+import "autosuggest-highlight/parse";
+import "clsx";
+import "../../../../../components/composite/filter/FilterCreationDialog.js";
+import "../../../../../components/composite/filter/HeaderFilterForm.js";
+import "../../../../../components/composite/filter/explicitNaming/ExplicitNamingFilterForm.js";
+import "../../../../../components/composite/filter/expert/ExpertFilterForm.js";
+import "../../../../../components/composite/filter/expert/ExpertFilterEditionDialog.js";
+import "../../../../../components/composite/filter/expert/expertFilterConstants.js";
+import "react-querybuilder";
+import "uuid";
+import "../../../../../components/composite/filter/explicitNaming/ExplicitNamingFilterEditionDialog.js";
+import "../../../../../components/composite/filter/utils/filterFormUtils.js";
+import "@react-querybuilder/material";
+import "../../../../../components/composite/reactQueryBuilder/CustomReactQueryBuilder.js";
+import "../../../../../components/composite/reactQueryBuilder/PropertyValueEditor.js";
+import "../../../../../components/composite/agGridTable/BottomTableButtons.js";
+import "../../../../../components/composite/agGridTable/CustomAgGridTable.js";
+import "ag-grid-community";
+import "../../../../../components/composite/customAGGrid/customAggrid.js";
+import "../../../../../components/composite/customAGGrid/context/custom-aggrid-context.js";
+import "mathjs";
+import "../../../../../components/composite/report/report-viewer/log-table/log-table.js";
+import "react-window";
+import "../../../../../components/composite/report/report-treeview/treeview-item.js";
+import "../../../../../components/composite/report/report-viewer/context/report-viewer-context.js";
+import "../../../common/regulatingTerminal/RegulatingTerminalForm.js";
+import { getRegulatingTerminalEmptyFormData, getRegulatingTerminalFormData } from "../../../common/regulatingTerminal/regulatingTerminal.utils.js";
+import { REGULATION_TYPES } from "../../../common/voltageRegulation/voltageRegulation.utils.js";
+import "@mui/material/colors";
+import "@mui/x-charts";
+import "../../../common/currentLimits/limitsPane.utils.js";
+const getRegulatingTerminalPhaseTapChangerValidationSchema = () => ({
+  [FieldConstants.VOLTAGE_LEVEL]: object().nullable().shape({
+    [FieldConstants.ID]: string(),
+    [FieldConstants.NAME]: string(),
+    [FieldConstants.SUBSTATION_ID]: string(),
+    [FieldConstants.NOMINAL_VOLTAGE]: string(),
+    [FieldConstants.TOPOLOGY_KIND]: string().nullable()
+  }).when([FieldConstants.ENABLED, FieldConstants.REGULATION_TYPE], {
+    is: (enabled, regulationType) => enabled && regulationType === REGULATION_TYPES.DISTANT.id,
+    then: (schema) => schema.required()
+  }),
+  [FieldConstants.EQUIPMENT]: object().nullable().shape({
+    [FieldConstants.ID]: string(),
+    [FieldConstants.NAME]: string().nullable(),
+    [FieldConstants.TYPE]: string()
+  }).when([FieldConstants.ENABLED, FieldConstants.REGULATION_TYPE], {
+    is: (enabled, regulationType) => enabled && regulationType === REGULATION_TYPES.DISTANT.id,
+    then: (schema) => schema.required()
+  })
+});
+const getPhaseTapChangerValidationSchemaProps = (isModification = false) => object().shape({
+  [FieldConstants.ENABLED]: bool().required(),
+  [FieldConstants.REGULATION_MODE]: string().nullable().when([FieldConstants.ENABLED], {
+    is: true,
+    then: (schema) => schema.required()
+  }),
+  [FieldConstants.REGULATION_TYPE]: string().nullable().when([FieldConstants.ENABLED, FieldConstants.REGULATION_MODE], {
+    is: (enabled, regulationMode) => enabled && regulationMode !== PHASE_REGULATION_MODES.OFF.id,
+    then: (schema) => schema.required()
+  }),
+  [FieldConstants.REGULATION_SIDE]: string().nullable().when([FieldConstants.ENABLED, FieldConstants.REGULATION_TYPE], {
+    is: (enabled, regulationType) => enabled && regulationType === REGULATION_TYPES.LOCAL.id,
+    then: (schema) => schema.required()
+  }),
+  [FieldConstants.CURRENT_LIMITER_REGULATING_VALUE]: number().nullable().when([FieldConstants.ENABLED, FieldConstants.REGULATION_MODE], {
+    is: (enabled, regulationMode) => enabled && regulationMode === PHASE_REGULATION_MODES.CURRENT_LIMITER.id,
+    then: (schema) => schema.positive("CurrentLimiterMustBeGreaterThanZero").required()
+  }),
+  [FieldConstants.FLOW_SET_POINT_REGULATING_VALUE]: number().nullable().when([FieldConstants.ENABLED, FieldConstants.REGULATION_MODE], {
+    is: (enabled, regulationMode) => enabled && regulationMode === PHASE_REGULATION_MODES.ACTIVE_POWER_CONTROL.id,
+    then: (schema) => schema.required()
+  }),
+  [FieldConstants.TARGET_DEADBAND]: number().nullable().min(0, TARGET_DEADBAND_MUST_BE_GREATER_OR_EQUAL_TO_ZERO),
+  [FieldConstants.LOW_TAP_POSITION]: number().nullable().when(FieldConstants.ENABLED, {
+    is: (enabled) => enabled && !isModification,
+    then: (schema) => schema.required()
+  }),
+  [FieldConstants.HIGH_TAP_POSITION]: number().nullable(),
+  [FieldConstants.TAP_POSITION]: number().nullable().when(FieldConstants.ENABLED, {
+    is: (enabled) => enabled && !isModification,
+    then: (schema) => schema.required().min(ref(FieldConstants.LOW_TAP_POSITION), "TapPositionMustBeBetweenLowAndHighTapPositionValue").max(
+      ref(FieldConstants.HIGH_TAP_POSITION),
+      "TapPositionMustBeBetweenLowAndHighTapPositionValue"
+    )
+  }),
+  [FieldConstants.STEPS]: array().of(
+    object().shape({
+      [FieldConstants.STEPS_TAP]: number().required(),
+      [FieldConstants.STEPS_RESISTANCE]: number(),
+      [FieldConstants.STEPS_REACTANCE]: number(),
+      [FieldConstants.STEPS_CONDUCTANCE]: number(),
+      [FieldConstants.STEPS_SUSCEPTANCE]: number(),
+      [FieldConstants.STEPS_RATIO]: number(),
+      [FieldConstants.STEPS_ALPHA]: number()
+    })
+  ).when(FieldConstants.ENABLED, {
+    is: (enabled) => enabled && !isModification,
+    then: (schema) => schema.min(1, "GeneratePhaseTapRowsError")
+  }).test("distinctOrderedAlpha", "PhaseShiftValuesError", (stepsArray) => {
+    const alphaArray = (stepsArray ?? []).map((step) => step[FieldConstants.STEPS_ALPHA]);
+    return areNumbersOrdered(alphaArray) && areArrayElementsUnique(alphaArray);
+  }),
+  ...getRegulatingTerminalPhaseTapChangerValidationSchema()
+});
+const getPhaseTapChangerEmptyFormData = (isModification = false) => {
+  return {
+    [FieldConstants.ENABLED]: false,
+    [FieldConstants.REGULATION_MODE]: null,
+    [FieldConstants.REGULATION_TYPE]: null,
+    [FieldConstants.REGULATION_SIDE]: isModification ? null : REGULATION_SIDES.SIDE1.id,
+    [FieldConstants.CURRENT_LIMITER_REGULATING_VALUE]: null,
+    [FieldConstants.FLOW_SET_POINT_REGULATING_VALUE]: null,
+    [FieldConstants.TARGET_DEADBAND]: null,
+    [FieldConstants.LOW_TAP_POSITION]: null,
+    [FieldConstants.HIGH_TAP_POSITION]: null,
+    [FieldConstants.TAP_POSITION]: null,
+    [FieldConstants.STEPS]: [],
+    ...getRegulatingTerminalEmptyFormData()
+  };
+};
+const getPhaseTapChangerFormData = ({
+  enabled = false,
+  regulationMode = null,
+  regulationType = null,
+  regulationSide = REGULATION_SIDES.SIDE1.id,
+  currentLimiterRegulatingValue = null,
+  flowSetpointRegulatingValue = null,
+  targetDeadband = null,
+  lowTapPosition = null,
+  highTapPosition = null,
+  tapPosition = null,
+  steps = [],
+  voltageLevelId,
+  equipmentID,
+  equipmentType
+}, id = FieldConstants.PHASE_TAP_CHANGER) => ({
+  [id]: {
+    [FieldConstants.ENABLED]: enabled,
+    [FieldConstants.REGULATION_MODE]: regulationMode,
+    [FieldConstants.REGULATION_TYPE]: regulationType,
+    [FieldConstants.REGULATION_SIDE]: regulationSide,
+    [FieldConstants.CURRENT_LIMITER_REGULATING_VALUE]: currentLimiterRegulatingValue,
+    [FieldConstants.FLOW_SET_POINT_REGULATING_VALUE]: flowSetpointRegulatingValue,
+    [FieldConstants.TARGET_DEADBAND]: targetDeadband,
+    [FieldConstants.LOW_TAP_POSITION]: lowTapPosition,
+    [FieldConstants.HIGH_TAP_POSITION]: highTapPosition,
+    [FieldConstants.TAP_POSITION]: tapPosition,
+    [FieldConstants.STEPS]: steps,
+    ...getRegulatingTerminalFormData({
+      [FieldConstants.EQUIPMENT_ID]: equipmentID,
+      [FieldConstants.EQUIPMENT_TYPE]: equipmentType,
+      [FieldConstants.VOLTAGE_LEVEL_ID]: voltageLevelId
+    })
+  }
+});
+const getComputedPhaseTapChangerRegulationMode = (phaseTapChangerFormValues) => {
+  if (phaseTapChangerFormValues?.[FieldConstants.REGULATION_MODE] === PHASE_REGULATION_MODES.OFF.id || phaseTapChangerFormValues?.[FieldConstants.REGULATING] === false) {
+    return PHASE_REGULATION_MODES.OFF;
+  }
+  if (phaseTapChangerFormValues?.[FieldConstants.REGULATION_MODE] === PHASE_REGULATION_MODES.CURRENT_LIMITER.id && phaseTapChangerFormValues?.[FieldConstants.REGULATING] === true) {
+    return PHASE_REGULATION_MODES.CURRENT_LIMITER;
+  }
+  if (phaseTapChangerFormValues?.[FieldConstants.REGULATION_MODE] === PHASE_REGULATION_MODES.ACTIVE_POWER_CONTROL.id && phaseTapChangerFormValues?.[FieldConstants.REGULATING] === true) {
+    return PHASE_REGULATION_MODES.ACTIVE_POWER_CONTROL;
+  }
+  return void 0;
+};
+const getPhaseTapRegulationSideId = (twt) => {
+  const phaseTapChangerValues = twt?.phaseTapChanger;
+  if (!phaseTapChangerValues || !twt) {
+    return null;
+  }
+  if (phaseTapChangerValues?.regulatingTerminalConnectableId === twt?.id) {
+    return phaseTapChangerValues?.regulatingTerminalVlId === twt?.voltageLevelId1 ? REGULATION_SIDES.SIDE1.id : REGULATION_SIDES.SIDE2.id;
+  }
+  return null;
+};
+const getComputedPhaseRegulationType = (twt) => {
+  if (!twt?.[FieldConstants.PHASE_TAP_CHANGER]?.regulatingTerminalConnectableId) {
+    return null;
+  }
+  if (twt?.[FieldConstants.PHASE_TAP_CHANGER]?.regulatingTerminalConnectableId !== twt?.id) {
+    return REGULATION_TYPES.DISTANT;
+  }
+  return REGULATION_TYPES.LOCAL;
+};
+const getComputedPhaseRegulationTypeId = (twt) => {
+  const regulationType = getComputedPhaseRegulationType(twt);
+  return regulationType?.id ?? null;
+};
+const getComputedPreviousPhaseRegulationType = (previousValues) => {
+  const previousRegulationType = getComputedPhaseRegulationType(previousValues);
+  return previousRegulationType?.id ?? null;
+};
+export {
+  getComputedPhaseRegulationType,
+  getComputedPhaseRegulationTypeId,
+  getComputedPhaseTapChangerRegulationMode,
+  getComputedPreviousPhaseRegulationType,
+  getPhaseTapChangerEmptyFormData,
+  getPhaseTapChangerFormData,
+  getPhaseTapChangerValidationSchemaProps,
+  getPhaseTapRegulationSideId
+};

package/dist/features/network-modifications/twoWindingsTransformer/tapChanger/ratioTapChanger/RatioTapChangerPane.d.ts

@@ -0,0 +1,2 @@
+import { TapChangerPaneProps } from '../../common/twoWindingsTransformer.types';
+export declare function RatioTapChangerPane({ id, voltageLevelOptions, previousValues, editData, fetchVoltageLevelEquipments, isModification, }: Readonly<TapChangerPaneProps>): import("react").JSX.Element;