@gridsuite/commons-ui 0.208.0 → 0.210.0

package/dist/components/network-modifications/index.js

@@ -18,10 +18,10 @@ import { getActivePowerControlEmptyFormData, getActivePowerControlSchema } from
 import { ActivePowerControlForm } from "./common/activePowerControl/ActivePowerControlForm.js";
 import { getShortCircuitEmptyFormData, getShortCircuitFormData, getShortCircuitFormSchema } from "./common/shortCircuit/shortCircuitForm.utils.js";
 import { ShortCircuitForm } from "./common/shortCircuit/ShortCircuitForm.js";
-import { INSERT, REMOVE, getReactiveCapabilityCurveValidationSchema, getRowEmptyFormData, setCurrentReactiveCapabilityCurveTable, setSelectedReactiveLimits, toReactiveCapabilityCurveChoiceForGeneratorCreation, toReactiveCapabilityCurveChoiceForGeneratorModification } from "./common/reactiveLimits/reactiveCapabilityCurve/reactiveCapability.utils.js";
+import { INSERT, REMOVE, getReactiveCapabilityCurveValidationSchema, getReactiveCapabilityCurveValidationSchemaArray, getRowEmptyFormData, setCurrentReactiveCapabilityCurveTable, setSelectedReactiveLimits, toReactiveCapabilityCurveChoiceForGeneratorCreation, toReactiveCapabilityCurveChoiceForGeneratorModification } from "./common/reactiveLimits/reactiveCapabilityCurve/reactiveCapability.utils.js";
 import { ReactiveCapabilityCurveRowForm } from "./common/reactiveLimits/reactiveCapabilityCurve/ReactiveCapabilityCurveRowForm.js";
 import { ReactiveCapabilityCurveTableForm } from "./common/reactiveLimits/reactiveCapabilityCurve/ReactiveCapabilityCurveTableForm.js";
-import { REACTIVE_LIMIT_TYPES, getReactiveLimitsEmptyFormData, getReactiveLimitsFormData, getReactiveLimitsSchema, getReactiveLimitsValidationSchema } from "./common/reactiveLimits/reactiveLimits.utils.js";
+import { REACTIVE_LIMIT_TYPES, getReactiveLimitsEmptyFormData, getReactiveLimitsEmptyFormDataProps, getReactiveLimitsFormData, getReactiveLimitsFormDataProps, getReactiveLimitsSchema, getReactiveLimitsValidationSchema } from "./common/reactiveLimits/reactiveLimits.utils.js";
 import { ReactiveLimitsForm } from "./common/reactiveLimits/ReactiveLimitsForm.js";
 import { getHvdcLccDeletionSchema } from "./equipmentDeletion/hvdcLccDeletion/hvdcLccDeletion.utils.js";
 import { ShuntCompensatorSelectionForm } from "./equipmentDeletion/hvdcLccDeletion/ShuntCompensatorSelectionForm.js";
@@ -37,6 +37,7 @@ import { substationModificationDtoToForm, substationModificationEmptyFormData, s
 import { SwitchesBetweenSections } from "./voltageLevel/creation/tabs/structureTab/switchesBetweenSections/SwitchesBetweenSections.js";
 import "react/jsx-runtime";
 import "@mui/material";
+import "react";
 import "react-hook-form";
 import "react-intl";
 import "../overflowableText/OverflowableText.js";
@@ -44,7 +45,6 @@ import "../../utils/conversionUtils.js";
 import "../../utils/types/equipmentType.js";
 import "@mui/icons-material";
 import "../../utils/yupConfig.js";
-import "react";
 import "localized-countries";
 import "localized-countries/data/fr";
 import "localized-countries/data/en";
@@ -71,6 +71,7 @@ import "../inputs/reactQueryBuilder/CustomReactQueryBuilder.js";
 import "uuid";
 import "../inputs/reactQueryBuilder/PropertyValueEditor.js";
 import "react-querybuilder";
+import { MAX_SECTIONS_COUNT } from "./voltageLevel/creation/voltageLevel.constants.js";
 import { VoltageLevelCreationForm } from "./voltageLevel/creation/VoltageLevelCreationForm.js";
 import { SWITCH_TYPE, buildNewBusbarSections, getCreateSwitchesEmptyFormData, getCreateSwitchesValidationSchema, translateSwitchKinds, voltageLevelCreationDtoToForm, voltageLevelCreationEmptyFormData, voltageLevelCreationFormSchema, voltageLevelCreationFormToDto } from "./voltageLevel/creation/voltageLevelCreation.utils.js";
 import { SwitchKind } from "./voltageLevel/creation/voltageLevelCreation.types.js";
@@ -88,12 +89,22 @@ import { EQUIPMENT_TYPE_ORDER, byFilterDeletionDtoToForm, byFilterDeletionFormSc
 import { ModificationByAssignmentForm } from "./by-filter/assignment/modification-by-assignment-form.js";
 import { emptyModificationByAssignmentFormData, modificationByAssignmentDtoToForm, modificationByAssignmentFormSchema, modificationByAssignmentFormToDto } from "./by-filter/assignment/modificationByAssignment.utils.js";
 import { DataType } from "./by-filter/assignment/assignment/assignment.type.js";
+import { batteryCreationDtoToForm, batteryCreationEmptyFormData, batteryCreationFormSchema, batteryCreationFormToDto } from "./battery/creation/batteryCreation.utils.js";
+import { BatteryCreationForm } from "./battery/creation/BatteryCreationForm.js";
+import { CHARACTERISTICS_CHOICES, SHUNT_COMPENSATOR_TYPES, computeSwitchedOnValue } from "./shunt-compensator/common/shuntCompensator.utils.js";
+import { CharacteristicsForm } from "./shunt-compensator/common/CharacteristicsForm.js";
+import { getCharacteristicsCreateFormDataFromSearchCopy, getCharacteristicsEmptyFormData, getCharacteristicsFormData, getCharacteristicsFormValidationSchema } from "./shunt-compensator/common/characteristicsForm.utils.js";
+import { ShuntCompensatorCreationForm } from "./shunt-compensator/creation/ShuntCompensatorCreationForm.js";
+import { shuntCompensatorCreationDtoToForm, shuntCompensatorCreationEmptyFormData, shuntCompensatorCreationFormSchema, shuntCompensatorCreationFormToDto } from "./shunt-compensator/creation/shuntCompensatorCreation.utils.js";
 export {
   ActivePowerControlForm,
   DataType as AssignmentDataType,
+  BatteryCreationForm,
   BranchActiveReactivePowerMeasurementsForm,
   BranchConnectivityForm,
   ByFilterDeletionForm,
+  CHARACTERISTICS_CHOICES,
+  CharacteristicsForm,
   ConnectivityForm,
   EQUIPMENT_TYPE_ORDER,
   EquipmentDeletionForm,
@@ -105,6 +116,7 @@ export {
   LoadDialogTabs,
   LoadDialogTabsContent,
   LoadForm,
+  MAX_SECTIONS_COUNT,
   ModificationByAssignmentForm,
   PowerMeasurementsForm,
   PowerWithValidityForm,
@@ -115,9 +127,11 @@ export {
   ReactiveCapabilityCurveRowForm,
   ReactiveCapabilityCurveTableForm,
   ReactiveLimitsForm,
+  SHUNT_COMPENSATOR_TYPES,
   SWITCH_TYPE,
   SetPointsForm,
   ShortCircuitForm,
+  ShuntCompensatorCreationForm,
   ShuntCompensatorSelectionForm,
   SubstationCreationForm,
   SubstationModificationForm,
@@ -126,10 +140,15 @@ export {
   VoltageLevelConnectivityForm,
   VoltageLevelCreationForm,
   VoltageLevelModificationForm,
+  batteryCreationDtoToForm,
+  batteryCreationEmptyFormData,
+  batteryCreationFormSchema,
+  batteryCreationFormToDto,
   buildNewBusbarSections,
   byFilterDeletionDtoToForm,
   byFilterDeletionFormSchema,
   byFilterDeletionFormToDto,
+  computeSwitchedOnValue,
   copyEquipmentPropertiesForCreation,
   createConnectivityData,
   createPropertyModification,
@@ -152,6 +171,10 @@ export {
   getBranchActiveReactivePowerEmptyFormDataProperties,
   getBranchActiveReactivePowerValidationSchema,
   getBranchActiveReactivePowerValidationSchemaProperties,
+  getCharacteristicsCreateFormDataFromSearchCopy,
+  getCharacteristicsEmptyFormData,
+  getCharacteristicsFormData,
+  getCharacteristicsFormValidationSchema,
   getCon1andCon2WithPositionValidationSchema,
   getConcatenatedProperties,
   getConnectivityBusBarSectionData,
@@ -186,8 +209,11 @@ export {
   getPropertiesFromModification,
   getPropertyValue,
   getReactiveCapabilityCurveValidationSchema,
+  getReactiveCapabilityCurveValidationSchemaArray,
   getReactiveLimitsEmptyFormData,
+  getReactiveLimitsEmptyFormDataProps,
   getReactiveLimitsFormData,
+  getReactiveLimitsFormDataProps,
   getReactiveLimitsSchema,
   getReactiveLimitsValidationSchema,
   getReactivePowerSetPointSchema,
@@ -215,6 +241,10 @@ export {
   newEquipmentDeletionDto,
   setCurrentReactiveCapabilityCurveTable,
   setSelectedReactiveLimits,
+  shuntCompensatorCreationDtoToForm,
+  shuntCompensatorCreationEmptyFormData,
+  shuntCompensatorCreationFormSchema,
+  shuntCompensatorCreationFormToDto,
   standardTextField,
   substationCreationDtoToForm,
   substationCreationEmptyFormData,

package/dist/components/network-modifications/shunt-compensator/common/CharacteristicsForm.d.ts

@@ -0,0 +1,6 @@
+import { ShuntCompensatorFormInfos } from './shuntCompensator.types';
+export interface CharacteristicsFormProps {
+    previousValues?: ShuntCompensatorFormInfos;
+    isModification?: boolean;
+}
+export declare function CharacteristicsForm({ previousValues, isModification }: Readonly<CharacteristicsFormProps>): import("react/jsx-runtime").JSX.Element;

package/dist/components/network-modifications/shunt-compensator/common/CharacteristicsForm.js

@@ -0,0 +1,199 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Grid, Box } from "@mui/material";
+import { useFormContext, useWatch } from "react-hook-form";
+import { useMemo, useCallback, useEffect } from "react";
+import { useIntl } from "react-intl";
+import { ReactivePowerAdornment, SusceptanceAdornment } from "../../../../utils/constants/adornments.js";
+import { FieldConstants } from "../../../../utils/constants/fieldConstants.js";
+import "../../../../utils/conversionUtils.js";
+import "../../../../utils/types/equipmentType.js";
+import "@mui/icons-material";
+import "../../../../utils/yupConfig.js";
+import "../../../overflowableText/OverflowableText.js";
+import "localized-countries";
+import "localized-countries/data/fr";
+import "localized-countries/data/en";
+import "notistack";
+import "../../../inputs/reactHookForm/provider/CustomFormProvider.js";
+import "yup";
+import "../../../treeViewFinder/TreeViewFinder.js";
+import "../../../inputs/reactHookForm/agGridTable/BottomRightButtons.js";
+import "../../../customAGGrid/customAggrid.js";
+import "ag-grid-community";
+import "react-papaparse";
+import "react-csv-downloader";
+import { RadioInput } from "../../../inputs/reactHookForm/booleans/RadioInput.js";
+import { FloatInput } from "../../../inputs/reactHookForm/numbers/FloatInput.js";
+import { IntegerInput } from "../../../inputs/reactHookForm/numbers/IntegerInput.js";
+import "../../../inputs/reactHookForm/numbers/RangeInput.js";
+import { SelectInput } from "../../../inputs/reactHookForm/selectInputs/SelectInput.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.svg?react";
+import "../../../dialogs/descriptionModificationDialog/DescriptionModificationDialog.js";
+import "../../../inputs/reactHookForm/expandableInput/ExpandableInput.js";
+import "@react-querybuilder/material";
+import "../../../filter/expert/expertFilterConstants.js";
+import "../../../inputs/reactQueryBuilder/CustomReactQueryBuilder.js";
+import "uuid";
+import "../../../inputs/reactQueryBuilder/PropertyValueEditor.js";
+import "react-querybuilder";
+import { SHUNT_COMPENSATOR_TYPES, CHARACTERISTICS_CHOICES } from "./shuntCompensator.utils.js";
+function CharacteristicsForm({ previousValues, isModification = false }) {
+  const intl = useIntl();
+  const { setValue } = useFormContext();
+  const [sectionCount, maximumSectionCount, maxQAtNominalV, maxSusceptance, characteristicsChoice] = useWatch({
+    name: [
+      FieldConstants.SECTION_COUNT,
+      FieldConstants.MAXIMUM_SECTION_COUNT,
+      FieldConstants.MAX_Q_AT_NOMINAL_V,
+      FieldConstants.MAX_SUSCEPTANCE,
+      FieldConstants.CHARACTERISTICS_CHOICE
+    ]
+  });
+  const previousMaxQAtNominalV = useMemo(() => {
+    const prevValue = previousValues?.qAtNominalV && previousValues?.maximumSectionCount ? previousValues.qAtNominalV * previousValues.maximumSectionCount : void 0;
+    return Number.isNaN(prevValue) ? void 0 : prevValue;
+  }, [previousValues]);
+  const previousMaxSusceptance = useMemo(() => {
+    const prevValue = previousValues?.bPerSection && previousValues?.maximumSectionCount ? previousValues.bPerSection * previousValues.maximumSectionCount : void 0;
+    return Number.isNaN(prevValue) ? void 0 : prevValue;
+  }, [previousValues]);
+  const currentSectionCount = useMemo(
+    () => sectionCount ?? previousValues?.sectionCount,
+    [sectionCount, previousValues]
+  );
+  const currentMaximumSectionCount = useMemo(
+    () => maximumSectionCount ?? previousValues?.maximumSectionCount,
+    [maximumSectionCount, previousValues]
+  );
+  const currentMaxQAtNominalV = useMemo(
+    () => maxQAtNominalV ?? previousMaxQAtNominalV,
+    [maxQAtNominalV, previousMaxQAtNominalV]
+  );
+  const currentMaxSusceptance = useMemo(
+    () => maxSusceptance ?? previousMaxSusceptance,
+    [maxSusceptance, previousMaxSusceptance]
+  );
+  const previousShuntCompensatorType = useMemo(
+    () => previousValues?.bPerSection ? intl.formatMessage({
+      id: previousValues.bPerSection > 0 ? SHUNT_COMPENSATOR_TYPES.CAPACITOR.label : SHUNT_COMPENSATOR_TYPES.REACTOR.label
+    }) : "",
+    [previousValues?.bPerSection, intl]
+  );
+  const handleSwitchedOnValue = useCallback(
+    (currentLinkedSwitchedOnValue, switchedOnFieldName) => {
+      if ([currentSectionCount, currentMaximumSectionCount, currentLinkedSwitchedOnValue].every(
+        (v) => v !== null && v !== void 0
+      ) && currentMaximumSectionCount >= currentSectionCount) {
+        setValue(
+          switchedOnFieldName,
+          currentLinkedSwitchedOnValue / currentMaximumSectionCount * currentSectionCount
+        );
+      } else {
+        setValue(switchedOnFieldName, null);
+      }
+    },
+    [currentSectionCount, currentMaximumSectionCount, setValue]
+  );
+  useEffect(() => {
+    if (characteristicsChoice === CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id) {
+      handleSwitchedOnValue(currentMaxQAtNominalV, FieldConstants.SWITCHED_ON_Q_AT_NOMINAL_V);
+    } else if (characteristicsChoice === CHARACTERISTICS_CHOICES.SUSCEPTANCE.id) {
+      handleSwitchedOnValue(currentMaxSusceptance, FieldConstants.SWITCHED_ON_SUSCEPTANCE);
+    }
+  }, [characteristicsChoice, handleSwitchedOnValue, currentMaxQAtNominalV, currentMaxSusceptance]);
+  const maximumSectionCountField = /* @__PURE__ */ jsx(
+    IntegerInput,
+    {
+      name: FieldConstants.MAXIMUM_SECTION_COUNT,
+      label: "maximumSectionCount",
+      previousValue: previousValues?.maximumSectionCount ?? void 0,
+      clearable: isModification
+    }
+  );
+  const sectionCountField = /* @__PURE__ */ jsx(
+    IntegerInput,
+    {
+      name: FieldConstants.SECTION_COUNT,
+      label: "sectionCount",
+      previousValue: previousValues?.sectionCount ?? void 0,
+      clearable: isModification
+    }
+  );
+  const maxQAtNominalVField = /* @__PURE__ */ jsx(
+    FloatInput,
+    {
+      name: FieldConstants.MAX_Q_AT_NOMINAL_V,
+      label: "maxQAtNominalV",
+      adornment: ReactivePowerAdornment,
+      previousValue: previousMaxQAtNominalV,
+      clearable: isModification
+    }
+  );
+  const switchedOnMaxQAtNominalVField = /* @__PURE__ */ jsx(
+    FloatInput,
+    {
+      name: FieldConstants.SWITCHED_ON_Q_AT_NOMINAL_V,
+      label: "SwitchedOnMaxQAtNominalV",
+      adornment: ReactivePowerAdornment,
+      previousValue: previousValues?.qAtNominalV && previousValues?.sectionCount ? previousValues.qAtNominalV * previousValues.sectionCount : void 0,
+      formProps: {
+        disabled: true
+      }
+    }
+  );
+  const shuntCompensatorTypeField = /* @__PURE__ */ jsx(
+    SelectInput,
+    {
+      options: Object.values(SHUNT_COMPENSATOR_TYPES),
+      name: FieldConstants.SHUNT_COMPENSATOR_TYPE,
+      label: "Type",
+      size: "small",
+      previousValue: previousShuntCompensatorType
+    }
+  );
+  const maxSusceptanceField = /* @__PURE__ */ jsx(
+    FloatInput,
+    {
+      name: FieldConstants.MAX_SUSCEPTANCE,
+      label: "maxSusceptance",
+      adornment: SusceptanceAdornment,
+      previousValue: previousMaxSusceptance,
+      clearable: isModification
+    }
+  );
+  const switchedOnSusceptanceField = /* @__PURE__ */ jsx(
+    FloatInput,
+    {
+      name: FieldConstants.SWITCHED_ON_SUSCEPTANCE,
+      label: "SwitchedOnMaxSusceptance",
+      adornment: SusceptanceAdornment,
+      previousValue: previousValues?.bPerSection && previousValues.sectionCount ? previousValues.bPerSection * previousValues.sectionCount : void 0,
+      formProps: {
+        disabled: true
+      }
+    }
+  );
+  const characteristicsChoiceField = /* @__PURE__ */ jsx(RadioInput, { name: FieldConstants.CHARACTERISTICS_CHOICE, options: Object.values(CHARACTERISTICS_CHOICES) });
+  return /* @__PURE__ */ jsxs(Grid, { container: true, spacing: 2, children: [
+    /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: maximumSectionCountField }),
+    /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: sectionCountField }),
+    /* @__PURE__ */ jsx(Grid, { item: true, xs: 12, children: characteristicsChoiceField }),
+    characteristicsChoice === CHARACTERISTICS_CHOICES.SUSCEPTANCE.id && /* @__PURE__ */ jsxs(Grid, { item: true, container: true, spacing: 2, children: [
+      /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: maxSusceptanceField }),
+      /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: switchedOnSusceptanceField })
+    ] }),
+    characteristicsChoice === CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id && /* @__PURE__ */ jsxs(Grid, { item: true, container: true, spacing: 2, children: [
+      /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: shuntCompensatorTypeField }),
+      /* @__PURE__ */ jsx(Box, { sx: { width: "100%" } }),
+      /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: maxQAtNominalVField }),
+      /* @__PURE__ */ jsx(Grid, { item: true, xs: 4, children: switchedOnMaxQAtNominalVField })
+    ] })
+  ] });
+}
+export {
+  CharacteristicsForm
+};

package/dist/components/network-modifications/shunt-compensator/common/characteristicsForm.utils.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 declare const getCharacteristicsFormValidationSchema: (isModification: boolean) => {
+    maxQAtNominalV: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, null, "d">;
+    maxSusceptance: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, null, "d">;
+    maximumSectionCount: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, null, "d">;
+    sectionCount: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, null, "d">;
+    switchedOnQAtNominalV: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, undefined, "">;
+    switchedOnSusceptance: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, undefined, "">;
+    characteristicsChoice: import('yup').StringSchema<string, import('yup').AnyObject, undefined, "">;
+    shuntCompensatorType: import('yup').StringSchema<string | null | undefined, import('yup').AnyObject, null, "d">;
+} | {
+    maxQAtNominalV: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, null, "d">;
+    maxSusceptance: import('yup').NumberSchema<number | null | undefined, import('yup').AnyObject, null, "d">;
+    maximumSectionCount: import('yup').NumberSchema<number, import('yup').AnyObject, undefined, "">;
+    sectionCount: import('yup').NumberSchema<number, import('yup').AnyObject, undefined, "">;
+    switchedOnQAtNominalV: import('yup').NumberSchema<import('yup').Maybe<number | undefined>, import('yup').AnyObject, undefined, "">;
+    switchedOnSusceptance: import('yup').NumberSchema<import('yup').Maybe<number | undefined>, import('yup').AnyObject, undefined, "">;
+    characteristicsChoice: import('yup').StringSchema<string, import('yup').AnyObject, undefined, "">;
+    shuntCompensatorType: import('yup').StringSchema<string | null | undefined, import('yup').AnyObject, null, "d">;
+};
+export declare const getCharacteristicsEmptyFormData: () => {
+    maximumSectionCount: null;
+    sectionCount: null;
+    characteristicsChoice: "Q_AT_NOMINAL_V";
+    maxSusceptance: null;
+    shuntCompensatorType: null;
+    maxQAtNominalV: null;
+    switchedOnQAtNominalV: null;
+    switchedOnSusceptance: null;
+};
+export declare const getCharacteristicsFormData: ({ maxSusceptance, maxQAtNominalV, shuntCompensatorType, sectionCount, maximumSectionCount, }: {
+    maxSusceptance: number | null;
+    maxQAtNominalV: number | null;
+    shuntCompensatorType?: string | null;
+    sectionCount?: number | null;
+    maximumSectionCount?: number | null;
+}) => {
+    characteristicsChoice: "Q_AT_NOMINAL_V" | "SUSCEPTANCE";
+    maxSusceptance: number | null;
+    shuntCompensatorType: string | null;
+    maxQAtNominalV: number | null;
+    sectionCount: number | null;
+    maximumSectionCount: number | null;
+    switchedOnQAtNominalV: number | null;
+    switchedOnSusceptance: number | null;
+};
+export declare const getCharacteristicsCreateFormDataFromSearchCopy: ({ bPerSection, qAtNominalV, sectionCount, maximumSectionCount, }: {
+    bPerSection: number | null;
+    qAtNominalV: number | null;
+    sectionCount: number | null;
+    maximumSectionCount: number | null;
+}) => {
+    characteristicsChoice: "Q_AT_NOMINAL_V";
+    maxSusceptance: number | null;
+    shuntCompensatorType: "CAPACITOR" | "REACTOR";
+    maxQAtNominalV: number | null;
+    sectionCount: number | null;
+    maximumSectionCount: number | null;
+};

package/dist/components/network-modifications/shunt-compensator/common/characteristicsForm.utils.js

@@ -0,0 +1,90 @@
+import { string, number, ref } from "yup";
+import { FieldConstants } from "../../../../utils/constants/fieldConstants.js";
+import { YUP_REQUIRED, YUP_NOT_TYPE_NUMBER } from "../../../../utils/constants/translationKeys.js";
+import "../../../../utils/conversionUtils.js";
+import "../../../../utils/types/equipmentType.js";
+import "react/jsx-runtime";
+import "@mui/icons-material";
+import "../../../../utils/yupConfig.js";
+import { CHARACTERISTICS_CHOICES, SHUNT_COMPENSATOR_TYPES, computeSwitchedOnValue } from "./shuntCompensator.utils.js";
+const getCharacteristicsCreateFormValidationSchema = () => ({
+  [FieldConstants.MAX_Q_AT_NOMINAL_V]: number().typeError(YUP_NOT_TYPE_NUMBER).nullable().default(null).when([FieldConstants.CHARACTERISTICS_CHOICE], {
+    is: (characteristicsChoice) => characteristicsChoice === CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id,
+    then: (schema) => schema.min(0, "ShuntCompensatorErrorQAtNominalVoltageLessThanZero").required(YUP_REQUIRED)
+  }),
+  [FieldConstants.MAX_SUSCEPTANCE]: number().typeError(YUP_NOT_TYPE_NUMBER).nullable().default(null).when([FieldConstants.CHARACTERISTICS_CHOICE], {
+    is: (characteristicsChoice) => characteristicsChoice === CHARACTERISTICS_CHOICES.SUSCEPTANCE.id,
+    then: (schema) => schema.required(YUP_REQUIRED)
+  }),
+  [FieldConstants.MAXIMUM_SECTION_COUNT]: number().typeError(YUP_NOT_TYPE_NUMBER).required(YUP_REQUIRED).min(1, "MaximumSectionCountMustBeGreaterOrEqualToOne"),
+  [FieldConstants.SECTION_COUNT]: number().typeError(YUP_NOT_TYPE_NUMBER).required(YUP_REQUIRED).min(0, "SectionCountMustBeBetweenZeroAndMaximumSectionCount").max(ref(FieldConstants.MAXIMUM_SECTION_COUNT), "SectionCountMustBeBetweenZeroAndMaximumSectionCount"),
+  [FieldConstants.SWITCHED_ON_Q_AT_NOMINAL_V]: number().typeError(YUP_NOT_TYPE_NUMBER).notRequired(),
+  [FieldConstants.SWITCHED_ON_SUSCEPTANCE]: number().typeError(YUP_NOT_TYPE_NUMBER).notRequired()
+});
+const getCharacteristicsModificationFormValidationSchema = () => ({
+  [FieldConstants.MAX_Q_AT_NOMINAL_V]: number().typeError(YUP_NOT_TYPE_NUMBER).min(0, "ShuntCompensatorErrorQAtNominalVoltageLessThanZero").nullable().default(null),
+  [FieldConstants.MAX_SUSCEPTANCE]: number().typeError(YUP_NOT_TYPE_NUMBER).nullable().default(null),
+  [FieldConstants.MAXIMUM_SECTION_COUNT]: number().typeError(YUP_NOT_TYPE_NUMBER).min(1, "MaximumSectionCountMustBeGreaterOrEqualToOne").nullable().default(null),
+  [FieldConstants.SECTION_COUNT]: number().typeError(YUP_NOT_TYPE_NUMBER).min(0, "SectionCountMustBeBetweenZeroAndMaximumSectionCount").nullable().default(null),
+  [FieldConstants.SWITCHED_ON_Q_AT_NOMINAL_V]: number().typeError(YUP_NOT_TYPE_NUMBER).nullable(),
+  [FieldConstants.SWITCHED_ON_SUSCEPTANCE]: number().typeError(YUP_NOT_TYPE_NUMBER).nullable()
+});
+const getCharacteristicsFormValidationSchema = (isModification) => {
+  const baseSchema = {
+    [FieldConstants.CHARACTERISTICS_CHOICE]: string().required(YUP_REQUIRED),
+    [FieldConstants.SHUNT_COMPENSATOR_TYPE]: string().nullable().default(null).when([FieldConstants.CHARACTERISTICS_CHOICE], {
+      is: (choice) => choice === CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id && !isModification,
+      then: (schema) => schema.oneOf([SHUNT_COMPENSATOR_TYPES.CAPACITOR.id, SHUNT_COMPENSATOR_TYPES.REACTOR.id]).required(YUP_REQUIRED)
+    })
+  };
+  const additionalSchema = isModification ? getCharacteristicsModificationFormValidationSchema() : getCharacteristicsCreateFormValidationSchema();
+  return {
+    ...baseSchema,
+    ...additionalSchema
+  };
+};
+const getCharacteristicsEmptyFormData = () => ({
+  [FieldConstants.MAXIMUM_SECTION_COUNT]: null,
+  [FieldConstants.SECTION_COUNT]: null,
+  [FieldConstants.CHARACTERISTICS_CHOICE]: CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id,
+  [FieldConstants.MAX_SUSCEPTANCE]: null,
+  [FieldConstants.SHUNT_COMPENSATOR_TYPE]: null,
+  [FieldConstants.MAX_Q_AT_NOMINAL_V]: null,
+  [FieldConstants.SWITCHED_ON_Q_AT_NOMINAL_V]: null,
+  [FieldConstants.SWITCHED_ON_SUSCEPTANCE]: null
+});
+const getCharacteristicsFormData = ({
+  maxSusceptance,
+  maxQAtNominalV,
+  shuntCompensatorType,
+  sectionCount,
+  maximumSectionCount
+}) => ({
+  [FieldConstants.CHARACTERISTICS_CHOICE]: maxSusceptance == null ? CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id : CHARACTERISTICS_CHOICES.SUSCEPTANCE.id,
+  [FieldConstants.MAX_SUSCEPTANCE]: maxSusceptance,
+  [FieldConstants.SHUNT_COMPENSATOR_TYPE]: shuntCompensatorType ?? null,
+  [FieldConstants.MAX_Q_AT_NOMINAL_V]: maxQAtNominalV,
+  [FieldConstants.SECTION_COUNT]: sectionCount ?? null,
+  [FieldConstants.MAXIMUM_SECTION_COUNT]: maximumSectionCount ?? null,
+  [FieldConstants.SWITCHED_ON_Q_AT_NOMINAL_V]: maxQAtNominalV != null && sectionCount != null && maximumSectionCount != null ? computeSwitchedOnValue(sectionCount, maximumSectionCount, maxQAtNominalV) : null,
+  [FieldConstants.SWITCHED_ON_SUSCEPTANCE]: maxSusceptance != null && sectionCount != null && maximumSectionCount != null ? computeSwitchedOnValue(sectionCount, maximumSectionCount, maxSusceptance) : null
+});
+const getCharacteristicsCreateFormDataFromSearchCopy = ({
+  bPerSection,
+  qAtNominalV,
+  sectionCount,
+  maximumSectionCount
+}) => ({
+  [FieldConstants.CHARACTERISTICS_CHOICE]: CHARACTERISTICS_CHOICES.Q_AT_NOMINAL_V.id,
+  [FieldConstants.MAX_SUSCEPTANCE]: bPerSection && maximumSectionCount && bPerSection * maximumSectionCount,
+  [FieldConstants.SHUNT_COMPENSATOR_TYPE]: bPerSection && bPerSection > 0 ? SHUNT_COMPENSATOR_TYPES.CAPACITOR.id : SHUNT_COMPENSATOR_TYPES.REACTOR.id,
+  [FieldConstants.MAX_Q_AT_NOMINAL_V]: qAtNominalV && maximumSectionCount && qAtNominalV * maximumSectionCount,
+  [FieldConstants.SECTION_COUNT]: sectionCount,
+  [FieldConstants.MAXIMUM_SECTION_COUNT]: maximumSectionCount
+});
+export {
+  getCharacteristicsCreateFormDataFromSearchCopy,
+  getCharacteristicsEmptyFormData,
+  getCharacteristicsFormData,
+  getCharacteristicsFormValidationSchema
+};

package/dist/components/network-modifications/shunt-compensator/common/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 './shuntCompensator.types';
+export * from './shuntCompensator.utils';
+export * from './CharacteristicsForm';
+export * from './characteristicsForm.utils';

package/dist/components/network-modifications/shunt-compensator/common/index.js

@@ -0,0 +1,13 @@
+import { CHARACTERISTICS_CHOICES, SHUNT_COMPENSATOR_TYPES, computeSwitchedOnValue } from "./shuntCompensator.utils.js";
+import { CharacteristicsForm } from "./CharacteristicsForm.js";
+import { getCharacteristicsCreateFormDataFromSearchCopy, getCharacteristicsEmptyFormData, getCharacteristicsFormData, getCharacteristicsFormValidationSchema } from "./characteristicsForm.utils.js";
+export {
+  CHARACTERISTICS_CHOICES,
+  CharacteristicsForm,
+  SHUNT_COMPENSATOR_TYPES,
+  computeSwitchedOnValue,
+  getCharacteristicsCreateFormDataFromSearchCopy,
+  getCharacteristicsEmptyFormData,
+  getCharacteristicsFormData,
+  getCharacteristicsFormValidationSchema
+};

package/dist/components/network-modifications/shunt-compensator/common/shuntCompensator.types.d.ts

@@ -0,0 +1,20 @@
+import { ConnectablePositionFormInfos } from '../../common/connectivity/connectivity.type';
+import { MeasurementInfo } from '../../common/measurements/measurement.type';
+export interface ShuntCompensatorFormInfos {
+    id: string;
+    name: string;
+    voltageLevelId: string;
+    terminalConnected: boolean | null;
+    busOrBusbarSectionId?: string;
+    connectablePosition: ConnectablePositionFormInfos;
+    q?: number;
+    targetV?: number;
+    targetDeadband?: number;
+    sectionCount: number;
+    bPerSection?: number;
+    qAtNominalV?: number;
+    maximumSectionCount: number;
+    isLinear?: boolean;
+    measurementQ: MeasurementInfo | undefined;
+    properties: Record<string, string> | undefined;
+}

package/dist/components/network-modifications/shunt-compensator/common/shuntCompensator.types.js

@@ -0,0 +1 @@
+

package/dist/components/network-modifications/shunt-compensator/common/shuntCompensator.utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 declare const SHUNT_COMPENSATOR_TYPES: {
+    readonly REACTOR: {
+        readonly id: "REACTOR";
+        readonly label: "Reactor";
+    };
+    readonly CAPACITOR: {
+        readonly id: "CAPACITOR";
+        readonly label: "Capacitor";
+    };
+};
+export declare const CHARACTERISTICS_CHOICES: {
+    readonly Q_AT_NOMINAL_V: {
+        readonly id: "Q_AT_NOMINAL_V";
+        readonly label: "QatNominalVLabel";
+    };
+    readonly SUSCEPTANCE: {
+        readonly id: "SUSCEPTANCE";
+        readonly label: "SusceptanceLabel";
+    };
+};
+export declare const computeSwitchedOnValue: (sectionCount: number, maximumSectionCount: number, linkedSwitchedOnValue: number) => number;

package/dist/components/network-modifications/shunt-compensator/common/shuntCompensator.utils.js

@@ -0,0 +1,16 @@
+const SHUNT_COMPENSATOR_TYPES = {
+  REACTOR: { id: "REACTOR", label: "Reactor" },
+  CAPACITOR: { id: "CAPACITOR", label: "Capacitor" }
+};
+const CHARACTERISTICS_CHOICES = {
+  Q_AT_NOMINAL_V: { id: "Q_AT_NOMINAL_V", label: "QatNominalVLabel" },
+  SUSCEPTANCE: { id: "SUSCEPTANCE", label: "SusceptanceLabel" }
+};
+const computeSwitchedOnValue = (sectionCount, maximumSectionCount, linkedSwitchedOnValue) => {
+  return linkedSwitchedOnValue / maximumSectionCount * sectionCount;
+};
+export {
+  CHARACTERISTICS_CHOICES,
+  SHUNT_COMPENSATOR_TYPES,
+  computeSwitchedOnValue
+};

package/dist/components/network-modifications/shunt-compensator/creation/ShuntCompensatorCreationForm.d.ts

@@ -0,0 +1,3 @@
+import { ConnectivityNetworkProps } from '../../common/connectivity/connectivity.type';
+export type ShuntCompensatorCreationFormProps = ConnectivityNetworkProps;
+export declare function ShuntCompensatorCreationForm({ voltageLevelOptions, fetchBusesOrBusbarSections, PositionDiagramPane, }: Readonly<ShuntCompensatorCreationFormProps>): import("react/jsx-runtime").JSX.Element;