@gridsuite/commons-ui 0.141.0 → 0.143.0

package/dist/services/appsMetadata.d.ts

@@ -1,4 +1,4 @@
-import { Metadata, StudyMetadata } from '../utils';
+import { BaseVoltage, Metadata, StudyMetadata } from '../utils';
 export type UrlString = `${string}://${string}` | `/${string}` | `./${string}`;
 export type Url = UrlString | URL;
 export type Env = {
@@ -10,6 +10,7 @@ export declare function fetchEnv(): Promise<Env>;
 export declare function fetchAppsMetadata(): Promise<Metadata[]>;
 export declare function isStudyMetadata(metadata: Metadata): metadata is StudyMetadata;
 export declare function fetchStudyMetadata(): Promise<StudyMetadata>;
+export declare function fetchBaseVoltages(): Promise<BaseVoltage[]>;
 export declare function fetchFavoriteAndDefaultCountries(): Promise<{
     favoriteCountries: string[];
     defaultCountry?: string;

package/dist/services/appsMetadata.js

@@ -12,13 +12,19 @@ function isStudyMetadata(metadata) {
 }
 async function fetchStudyMetadata() {
   console.info(`Fetching study metadata...`);
-  const studyMetadata = (await fetchAppsMetadata()).filter(isStudyMetadata);
+  const studyMetadata = (await fetchAppsMetadata()).find(isStudyMetadata);
   if (!studyMetadata) {
     throw new Error("Study entry could not be found in metadata");
   } else {
-    return studyMetadata[0];
+    return studyMetadata;
   }
 }
+async function fetchBaseVoltages() {
+  console.info(`Fetching apps' base voltages...`);
+  const env = await fetchEnv();
+  const res = await fetch(`${env.appsMetadataServerUrl}/apps-metadata-base-voltages.json`);
+  return res.json();
+}
 async function fetchFavoriteAndDefaultCountries() {
   const { favoriteCountries = [], defaultCountry } = await fetchStudyMetadata();
   return {
@@ -32,6 +38,7 @@ const fetchDefaultCountry = async () => {
 };
 export {
   fetchAppsMetadata,
+  fetchBaseVoltages,
   fetchDefaultCountry,
   fetchEnv,
   fetchFavoriteAndDefaultCountries,

package/dist/services/index.d.ts

@@ -16,3 +16,4 @@ export * from './study-config';
 export * from './userAdmin';
 export * from './utils';
 export * from './voltage-init';
+export * from './short-circuit-analysis';

package/dist/services/index.js

@@ -1,15 +1,16 @@
-import { fetchAppsMetadata, fetchDefaultCountry, fetchEnv, fetchFavoriteAndDefaultCountries, fetchStudyMetadata, isStudyMetadata } from "./appsMetadata.js";
+import { fetchAppsMetadata, fetchBaseVoltages, fetchDefaultCountry, fetchEnv, fetchFavoriteAndDefaultCountries, fetchStudyMetadata, isStudyMetadata } from "./appsMetadata.js";
 import { fetchConfigParameter, fetchConfigParameters, getAppName, updateConfigParameter } from "./config.js";
 import { PermissionType, elementAlreadyExists, fetchDirectoryContent, fetchDirectoryElementPath, fetchRootFolders, hasElementPermission } from "./directory.js";
 import { createFilter, createParameter, fetchElementsInfos, saveFilter, updateParameter } from "./explore.js";
 import { PREFIX_STUDY_QUERIES, fetchLoadFlowParameters, getDefaultLoadFlowProvider, getLoadFlowDefaultLimitReductions, getLoadFlowProviders, getLoadFlowSpecificParametersDescription, getLoadFlowUrl, setLoadFlowParameters } from "./loadflow.js";
 import { getPccMinStudyParameters, updatePccMinParameters } from "./pcc-min.js";
 import { fetchDefaultSecurityAnalysisProvider, fetchSecurityAnalysisParameters, fetchSecurityAnalysisProviders, getSecurityAnalysisDefaultLimitReductions, getSecurityAnalysisParameters, getStudyUrl, safeEncodeURIComponent, setSecurityAnalysisParameters, updateSecurityAnalysisParameters, updateSecurityAnalysisProvider } from "./security-analysis.js";
-import { exportFilter, getAvailableComponentLibraries, getStudyNetworkVisualizationsParameters, getStudyShortCircuitParameters, invalidateStudyShortCircuitStatus, setStudyNetworkVisualizationParameters, setStudyShortCircuitParameters, updateVoltageInitParameters } from "./study.js";
+import { exportFilter, getAvailableComponentLibraries, getStudyNetworkVisualizationsParameters, getStudyShortCircuitParameters, setStudyNetworkVisualizationParameters, updateVoltageInitParameters } from "./study.js";
 import { getNetworkVisualizationsParameters } from "./study-config.js";
 import { fetchCurrentAnnouncement, fetchUserDetails } from "./userAdmin.js";
 import { NetworkTimeoutError, backendFetch, backendFetchFile, backendFetchJson, backendFetchText, getRequestParamFromList } from "./utils.js";
 import { getVoltageInitParameters, getVoltageInitUrl } from "./voltage-init.js";
+import { fetchShortCircuitParameters, getShortCircuitSpecificParametersDescription, updateShortCircuitParameters } from "./short-circuit-analysis.js";
 export {
   NetworkTimeoutError,
   PREFIX_STUDY_QUERIES,
@@ -23,6 +24,7 @@ export {
   elementAlreadyExists,
   exportFilter,
   fetchAppsMetadata,
+  fetchBaseVoltages,
   fetchConfigParameter,
   fetchConfigParameters,
   fetchCurrentAnnouncement,
@@ -37,6 +39,7 @@ export {
   fetchRootFolders,
   fetchSecurityAnalysisParameters,
   fetchSecurityAnalysisProviders,
+  fetchShortCircuitParameters,
   fetchStudyMetadata,
   fetchUserDetails,
   getAppName,
@@ -51,24 +54,24 @@ export {
   getRequestParamFromList,
   getSecurityAnalysisDefaultLimitReductions,
   getSecurityAnalysisParameters,
+  getShortCircuitSpecificParametersDescription,
   getStudyNetworkVisualizationsParameters,
   getStudyShortCircuitParameters,
   getStudyUrl,
   getVoltageInitParameters,
   getVoltageInitUrl,
   hasElementPermission,
-  invalidateStudyShortCircuitStatus,
   isStudyMetadata,
   safeEncodeURIComponent,
   saveFilter,
   setLoadFlowParameters,
   setSecurityAnalysisParameters,
   setStudyNetworkVisualizationParameters,
-  setStudyShortCircuitParameters,
   updateConfigParameter,
   updateParameter,
   updatePccMinParameters,
   updateSecurityAnalysisParameters,
   updateSecurityAnalysisProvider,
+  updateShortCircuitParameters,
   updateVoltageInitParameters
 };

package/dist/services/short-circuit-analysis.d.ts

@@ -1,2 +1,5 @@
+import { UUID } from 'node:crypto';
 import { ShortCircuitParametersInfos } from '../components/parameters/short-circuit/short-circuit-parameters.type';
+export declare function getShortCircuitSpecificParametersDescription(): Promise<any>;
 export declare function fetchShortCircuitParameters(parameterUuid: string): Promise<ShortCircuitParametersInfos>;
+export declare function updateShortCircuitParameters(parameterUuid: UUID, newParams: any): Promise<Response>;

package/dist/services/short-circuit-analysis.js

@@ -1,13 +1,34 @@
-import { backendFetchJson } from "./utils.js";
+import { backendFetchJson, backendFetch } from "./utils.js";
 const PREFIX_SHORT_CIRCUIT_SERVER_QUERIES = `${"api/gateway"}/shortcircuit`;
 function getShortCircuitUrl() {
-  return `${PREFIX_SHORT_CIRCUIT_SERVER_QUERIES}/v1`;
+  return `${PREFIX_SHORT_CIRCUIT_SERVER_QUERIES}/v1/`;
+}
+function getShortCircuitSpecificParametersDescription() {
+  console.info("get short circuit specific parameters description");
+  const getShortCircuitSpecificParametersUrl = `${getShortCircuitUrl()}parameters/specific-parameters`;
+  console.debug(getShortCircuitSpecificParametersUrl);
+  return backendFetchJson(getShortCircuitSpecificParametersUrl);
 }
 function fetchShortCircuitParameters(parameterUuid) {
   console.info("get short circuit analysis parameters");
-  const url = `${getShortCircuitUrl()}/parameters/${encodeURIComponent(parameterUuid)}`;
+  const url = `${getShortCircuitUrl()}parameters/${encodeURIComponent(parameterUuid)}`;
   return backendFetchJson(url);
 }
+function updateShortCircuitParameters(parameterUuid, newParams) {
+  console.info("set short circuit parameters");
+  const setShortCircuitParametersUrl = `${getShortCircuitUrl()}parameters/${parameterUuid}`;
+  console.debug(setShortCircuitParametersUrl);
+  return backendFetch(setShortCircuitParametersUrl, {
+    method: "PUT",
+    headers: {
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    },
+    body: newParams ? JSON.stringify(newParams) : null
+  });
+}
 export {
-  fetchShortCircuitParameters
+  fetchShortCircuitParameters,
+  getShortCircuitSpecificParametersDescription,
+  updateShortCircuitParameters
 };

package/dist/services/study.d.ts

@@ -1,12 +1,10 @@
 import { UUID } from 'node:crypto';
 import { NetworkVisualizationParameters } from '../components/parameters/network-visualizations/network-visualizations.types';
-import { ShortCircuitParameters, ShortCircuitParametersInfos } from '../components/parameters/short-circuit/short-circuit-parameters.type';
+import { ShortCircuitParametersInfos } from '../components/parameters/short-circuit/short-circuit-parameters.type';
 import { VoltageInitStudyParameters } from '../components/parameters/voltage-init/voltage-init.type';
 export declare function exportFilter(studyUuid: UUID, filterUuid?: UUID, token?: string): Promise<any>;
 export declare function getAvailableComponentLibraries(): Promise<string[]>;
 export declare function getStudyNetworkVisualizationsParameters(studyUuid: UUID): Promise<NetworkVisualizationParameters>;
 export declare function setStudyNetworkVisualizationParameters(studyUuid: UUID, newParams: Record<string, any>): Promise<Response>;
 export declare function getStudyShortCircuitParameters(studyUuid: UUID): Promise<ShortCircuitParametersInfos>;
-export declare function setStudyShortCircuitParameters(studyUuid: UUID, newParams: ShortCircuitParameters): Promise<Response>;
-export declare function invalidateStudyShortCircuitStatus(studyUuid: UUID): Promise<Response>;
 export declare function updateVoltageInitParameters(studyUuid: UUID | null, newParams: VoltageInitStudyParameters): Promise<Response>;

package/dist/services/study.js

@@ -34,23 +34,6 @@ function getStudyShortCircuitParameters(studyUuid) {
   console.info("get study short-circuit parameters");
   return backendFetchJson(`${PREFIX_STUDY_QUERIES}/v1/studies/${studyUuid}/short-circuit-analysis/parameters`);
 }
-function setStudyShortCircuitParameters(studyUuid, newParams) {
-  console.info("set study short-circuit parameters", newParams);
-  return backendFetch(`${PREFIX_STUDY_QUERIES}/v1/studies/${studyUuid}/short-circuit-analysis/parameters`, {
-    method: "POST",
-    headers: {
-      Accept: "application/json",
-      "Content-Type": "application/json"
-    },
-    body: newParams ? JSON.stringify(newParams) : null
-  });
-}
-function invalidateStudyShortCircuitStatus(studyUuid) {
-  console.info("invalidate study short circuit status");
-  return backendFetch(`${PREFIX_STUDY_QUERIES}/v1/studies/${studyUuid}/short-circuit/invalidate-status`, {
-    method: "PUT"
-  });
-}
 function updateVoltageInitParameters(studyUuid, newParams) {
   console.info("set study voltage init parameters");
   const url = `${PREFIX_STUDY_QUERIES}/v1/studies/${studyUuid}/voltage-init/parameters`;
@@ -69,8 +52,6 @@ export {
   getAvailableComponentLibraries,
   getStudyNetworkVisualizationsParameters,
   getStudyShortCircuitParameters,
-  invalidateStudyShortCircuitStatus,
   setStudyNetworkVisualizationParameters,
-  setStudyShortCircuitParameters,
   updateVoltageInitParameters
 };

package/dist/translations/en/parameters.d.ts

@@ -112,6 +112,9 @@ export declare const parametersEn: {
     ShortCircuitPredefinedParameters: string;
     ShortCircuitCharacteristics: string;
     ShortCircuitVoltageProfileMode: string;
+    ShortCircuitStartedGeneratorsMode: string;
+    ShortCircuitStartedLabel: string;
+    ShortCircuitAllLabel: string;
     shortCircuitLoads: string;
     shortCircuitHvdc: string;
     shortCircuitShuntCompensators: string;

package/dist/translations/en/parameters.js

@@ -106,6 +106,9 @@ const parametersEn = {
   ShortCircuitPredefinedParameters: "Preset parameters",
   ShortCircuitCharacteristics: "Features considered",
   ShortCircuitVoltageProfileMode: "Initial voltage profile",
+  ShortCircuitStartedGeneratorsMode: "Generators started",
+  ShortCircuitStartedLabel: "Started",
+  ShortCircuitAllLabel: "All",
   shortCircuitLoads: "Loads",
   shortCircuitHvdc: "HVDC (VSC)",
   shortCircuitShuntCompensators: "Shunt compensators",

package/dist/translations/fr/parameters.d.ts

@@ -112,6 +112,9 @@ export declare const parametersFr: {
     ShortCircuitPredefinedParameters: string;
     ShortCircuitCharacteristics: string;
     ShortCircuitVoltageProfileMode: string;
+    ShortCircuitStartedGeneratorsMode: string;
+    ShortCircuitStartedLabel: string;
+    ShortCircuitAllLabel: string;
     shortCircuitLoads: string;
     shortCircuitHvdc: string;
     shortCircuitShuntCompensators: string;

package/dist/translations/fr/parameters.js

@@ -106,6 +106,9 @@ const parametersFr = {
   ShortCircuitPredefinedParameters: "Paramètres prédéfinis",
   ShortCircuitCharacteristics: "Caractéristiques prises en compte",
   ShortCircuitVoltageProfileMode: "Plan de tension initial",
+  ShortCircuitStartedGeneratorsMode: "Démarrage des groupes",
+  ShortCircuitStartedLabel: "Démarrés",
+  ShortCircuitAllLabel: "Tous",
   shortCircuitLoads: "Charges",
   shortCircuitHvdc: "HVDC (VSC)",
   shortCircuitShuntCompensators: "MCS",

package/dist/utils/types/loadflow.type.d.ts

@@ -1,5 +1,6 @@
 import { UUID } from 'node:crypto';
 import { ILimitReductionsByVoltageLevel } from '../../components/parameters/common/limitreductions/columns-definitions';
+import { SpecificParametersPerProvider } from '../types/parameters.type';
 export interface LoadFlowParametersInfos {
     uuid?: UUID;
     provider: string;
@@ -8,4 +9,3 @@ export interface LoadFlowParametersInfos {
     specificParametersPerProvider: SpecificParametersPerProvider;
     limitReductions: ILimitReductionsByVoltageLevel[];
 }
-export type SpecificParametersPerProvider = Record<string, Record<string, string>>;

package/dist/utils/types/metadata.d.ts

@@ -23,4 +23,18 @@ export type StudyMetadata = Metadata & {
     favoriteCountries?: string[];
     substationPropertiesGlobalFilters?: Map<string, string[]>;
 };
+type ThemeColors = Record<string, string>;
+type SldAndNadColors = {
+    darkThemeColors: ThemeColors;
+    lightThemeColors: ThemeColors;
+};
+export type BaseVoltageConfig = {
+    name: string;
+    minValue: number;
+    maxValue: number;
+};
+export type BaseVoltage = BaseVoltageConfig & {
+    networkMapColor: string;
+    sldAndNadColors: SldAndNadColors;
+};
 export {};

package/dist/utils/types/parameters.type.d.ts

@@ -5,6 +5,7 @@ import { DynamicSecurityAnalysisParametersFetchReturn } from './dynamic-security
 import { ILimitReductionsByVoltageLevel, ISAParameters } from '../../components/parameters/common/limitreductions/columns-definitions';
 import { DynamicSimulationParametersFetchReturn } from './dynamic-simulation.type';
 import { SensitivityAnalysisParametersInfos } from './sensitivity-analysis.type';
+import { ShortCircuitParametersInfos } from '../../components/parameters/short-circuit/short-circuit-parameters.type';
 export declare enum ParameterType {
     BOOLEAN = "BOOLEAN",
     STRING = "STRING",
@@ -23,8 +24,10 @@ export type SpecificParameterInfos = {
     description?: string;
     label?: string;
 };
-export type SpecificParametersInfos = Record<string, SpecificParameterInfos>;
-export type ParametersInfos<T extends ComputingType> = T extends ComputingType.SENSITIVITY_ANALYSIS ? SensitivityAnalysisParametersInfos : T extends ComputingType.SECURITY_ANALYSIS ? ISAParameters : T extends ComputingType.LOAD_FLOW ? LoadFlowParametersInfos : T extends ComputingType.DYNAMIC_SIMULATION ? DynamicSimulationParametersFetchReturn : T extends ComputingType.DYNAMIC_SECURITY_ANALYSIS ? DynamicSecurityAnalysisParametersFetchReturn : Record<string, any>;
+export type SpecificParametersDescription = Record<string, SpecificParameterInfos[]>;
+export type SpecificParametersValues = Record<string, any>;
+export type SpecificParametersPerProvider = Record<string, SpecificParametersValues>;
+export type ParametersInfos<T extends ComputingType> = T extends ComputingType.SENSITIVITY_ANALYSIS ? SensitivityAnalysisParametersInfos : T extends ComputingType.SECURITY_ANALYSIS ? ISAParameters : T extends ComputingType.LOAD_FLOW ? LoadFlowParametersInfos : T extends ComputingType.DYNAMIC_SIMULATION ? DynamicSimulationParametersFetchReturn : T extends ComputingType.DYNAMIC_SECURITY_ANALYSIS ? DynamicSecurityAnalysisParametersFetchReturn : T extends ComputingType.SHORT_CIRCUIT ? ShortCircuitParametersInfos : Record<string, any>;
 export type UseParametersBackendReturnProps<T extends ComputingType> = [
     Record<string, string>,
     string | undefined,
@@ -35,6 +38,6 @@ export type UseParametersBackendReturnProps<T extends ComputingType> = [
     (studyUuid: UUID) => void,
     (newParams: ParametersInfos<T>) => void,
     () => Promise<void> | undefined,
-    Record<string, any> | null,
+    SpecificParametersDescription | null,
     ILimitReductionsByVoltageLevel[]
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gridsuite/commons-ui",
-    "version": "0.141.0",
+    "version": "0.143.0",
     "description": "common react components for gridsuite applications",
     "author": "gridsuite team",
     "homepage": "https://github.com/gridsuite",
@@ -69,8 +69,8 @@
         "ag-grid-community": "^33.0.3",
         "ag-grid-react": "^33.0.4",
         "notistack": "^3.0.2",
-        "react": "^18.3.1",
-        "react-dom": "^18.3.1",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0",
         "react-hook-form": "^7.54.2",
         "react-intl": "^7.1.6",
         "react-papaparse": "^4.4.0",
@@ -104,8 +104,8 @@
         "@types/localized-countries": "^2.0.3",
         "@types/node": "^22.18.1",
         "@types/prop-types": "^15.7.15",
-        "@types/react": "^18.3.24",
-        "@types/react-dom": "^18.3.7",
+        "@types/react": "^19.2.2",
+        "@types/react-dom": "^19.2.1",
         "@types/react-resizable": "^3.0.8",
         "@vitejs/plugin-react": "^5.0.4",
         "ag-grid-community": "^33.1.0",
@@ -130,8 +130,8 @@
         "notistack": "^3.0.2",
         "prettier": "^3.6.2",
         "prettier-plugin-properties": "^0.3.0",
-        "react": "^18.3.1",
-        "react-dom": "^18.3.1",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0",
         "react-hook-form": "^7.62.0",
         "react-intl": "^7.1.11",
         "react-papaparse": "^4.4.0",
@@ -141,7 +141,7 @@
         "typescript": "~5.9.3",
         "typescript-eslint": "^8.46.2",
         "vite": "^7.1.12",
-        "vite-plugin-checker": "^0.8.0",
+        "vite-plugin-checker": "^0.11.0",
         "vite-plugin-dts": "^4.5.4",
         "vite-plugin-lib-inject-css": "^2.2.2",
         "vite-plugin-svgr": "^4.5.0",