@dative-gpi/foundation-shared-domain 1.0.191 → 1.0.193-test-unit-formatter

package/enums/index.ts

@@ -17,6 +17,7 @@ export * from "./messages";
 export * from "./playlists";
 export * from "./roles";
 export * from "./times";
+export * from "./units";
 export * from "./users";
 export * from "./widgetTemplates";
 export * from "./reports";

package/enums/units.ts

@@ -0,0 +1,133 @@
+export enum UnitPrefix {
+    None = "",
+    Nano = "n",
+    Micro = "µ",
+    Milli = "m",
+    Kilo = "k",
+    Mega = "M",
+    Giga = "G",
+    Tera = "T",
+    Peta = "P"
+}
+
+export enum UnitFamily {
+    Energy = "Energy",
+    Power = "Power",
+    Volume = "Volume",
+    GasVolume = "Gas Volume",
+    WaterFlow = "Water Flow",
+    GasFlow = "Gas Flow",
+    Pressure = "Pressure",
+    Temperature = "Temperature",
+    Speed = "Speed",
+    Distance = "Distance",
+    Mass = "Mass",
+    MassFlow = "Mass Flow",
+    Frequency = "Frequency",
+    Voltage = "Voltage",
+    Current = "Current",
+    Resistance = "Resistance",
+    Percentage = "Percentage",
+    Capacity = "Capacity",
+    SnowProduction = "Snow Production",
+    Efficiency = "Efficiency"
+}
+
+export enum EnergyUnit {
+    Wattheure = "Wh",
+    Joule = "J",
+    Calorie = "cal",
+}
+
+export enum PowerUnit {
+    Watt = "W",
+}
+
+export enum VolumeUnit {
+    Liter = "L",
+    CubicMeter = "m3",
+}
+
+export enum GasVolumeUnit {
+    NormalCubicMeter = "Nm3",
+}
+
+export enum WaterFlowUnit {
+    LiterPerSecond = "L/s",
+    CubicMeterPerSecond = "m3/s",
+    LiterPerMinute = "L/min",
+    CubicMeterPerHour = "m3/h",
+}
+
+export enum GasFlowUnit {
+    NormalCubicMeterPerHour = "Nm3/h",
+}
+
+export enum PressureUnit {
+    Pascal = "Pa",
+    Bar = "bar",
+}
+
+export enum TemperatureUnit {
+    Celsius = "°C",
+    Kelvin = "K",
+    Fahrenheit = "°F",
+}
+
+export enum SpeedUnit {
+    MeterPerSecond = "m/s",
+    KilometerPerHour = "km/h",
+    Knot = "kn",
+}
+
+export enum DistanceUnit {
+    Meter = "m",
+}
+
+export enum MassUnit {
+    Gram = "g",
+    Tonne = "t",
+}
+
+export enum MassFlowUnit {
+    GramPerSecond = "g/s",
+    TonnePerSecond = "t/s",
+    KilogramPerHour = "kg/h",
+    TonnePerHour = "t/h",
+}
+
+export enum FrequencyUnit {
+    Hertz = "Hz",
+    RevolutionsPerMinute = "rpm",
+}
+
+export enum VoltageUnit {
+    Volt = "V",
+}
+
+export enum CurrentUnit {
+    Ampere = "A",
+}
+
+export enum ResistanceUnit {
+    Ohm = "Ω",
+}
+
+export enum PercentageUnit {
+    Percent = "%",
+    RelativeHumidity = "%RH",
+}
+
+export enum CapacityUnit {
+    Person = "pers",
+    PersonPerHour = "pers/h",
+}
+
+export enum SnowProductionUnit {
+    CubicMeterSnowPerHour = "m3_neige/h",
+}
+
+export enum EfficiencyUnit {
+    KilowattHourPerCubicMeter = "kWh/m3",
+    KilowattHourPerKilogram = "kWh/kg",
+}

package/models/index.ts

@@ -11,5 +11,6 @@ export * from "./permissions";
 export * from "./terminals";
 export * from "./timeZones";
 export * from "./translations";
+export * from "./units";
 export * from "./userLegalInformations";
 export * from "./users";

package/models/units/index.ts

@@ -0,0 +1,3 @@
+export * from "./unitDetails";
+export * from "./unitFamilies";
+export * from "./unitsRegistry";

package/models/units/unitDetails.ts

@@ -0,0 +1,18 @@
+import type { UnitFamily } from "@dative-gpi/foundation-shared-domain/enums";
+
+export interface UnitDefinition {
+  symbol: string;
+  family: UnitFamily;
+  toPivot: number;
+  usesSIPrefixes: boolean;
+  specialConversions?: Array<{
+    toUnit: string;
+    threshold: number;
+  }>;
+}
+
+export interface UnitFamilyDefinition {
+  name: string;
+  pivotUnit: string;
+  customConverter?: (value: number, fromUnit: string, toUnit: string) => number;
+}

package/models/units/unitFamilies.ts

@@ -0,0 +1,131 @@
+import { UnitFamily, TemperatureUnit, EnergyUnit, PowerUnit, VolumeUnit, GasVolumeUnit, WaterFlowUnit, GasFlowUnit, PressureUnit, SpeedUnit, DistanceUnit, MassUnit, MassFlowUnit, FrequencyUnit, VoltageUnit, CurrentUnit, ResistanceUnit, PercentageUnit, CapacityUnit, SnowProductionUnit, EfficiencyUnit } from "@dative-gpi/foundation-shared-domain/enums";
+import type { UnitFamilyDefinition } from "./unitDetails";
+
+export const unitFamilies: Record<UnitFamily, UnitFamilyDefinition> = {
+  [UnitFamily.Energy]: {
+    name: UnitFamily.Energy,
+    pivotUnit: EnergyUnit.Joule,
+  },
+  
+  [UnitFamily.Temperature]: {
+    name: UnitFamily.Temperature,
+    pivotUnit: TemperatureUnit.Celsius,
+    customConverter: (value: number, fromUnit: string, toUnit: string) => {
+      // Celsius <-> Kelvin
+      if (fromUnit === TemperatureUnit.Celsius && toUnit === TemperatureUnit.Kelvin) {
+        return value + 273.15;
+      }
+      if (fromUnit === TemperatureUnit.Kelvin && toUnit === TemperatureUnit.Celsius) {
+        return value - 273.15;
+      }
+      
+      // Celsius <-> Fahrenheit
+      if (fromUnit === TemperatureUnit.Celsius && toUnit === TemperatureUnit.Fahrenheit) {
+        return (value * 9/5) + 32;
+      }
+      if (fromUnit === TemperatureUnit.Fahrenheit && toUnit === TemperatureUnit.Celsius) {
+        return (value - 32) * 5/9;
+      }
+      
+      // Kelvin <-> Fahrenheit
+      if (fromUnit === TemperatureUnit.Kelvin && toUnit === TemperatureUnit.Fahrenheit) {
+        return (value - 273.15) * 9/5 + 32;
+      }
+      if (fromUnit === TemperatureUnit.Fahrenheit && toUnit === TemperatureUnit.Kelvin) {
+        return (value - 32) * 5/9 + 273.15;
+      }
+      
+      return value;
+    }
+  },
+  
+  [UnitFamily.Power]: { 
+    name: UnitFamily.Power, 
+    pivotUnit: PowerUnit.Watt 
+  },
+  
+  [UnitFamily.Volume]: { 
+    name: UnitFamily.Volume, 
+    pivotUnit: VolumeUnit.Liter
+  },
+  
+  [UnitFamily.GasVolume]: { 
+    name: UnitFamily.GasVolume, 
+    pivotUnit: GasVolumeUnit.NormalCubicMeter 
+  },
+  
+  [UnitFamily.WaterFlow]: { 
+    name: UnitFamily.WaterFlow, 
+    pivotUnit: WaterFlowUnit.LiterPerSecond
+  },
+  
+  [UnitFamily.GasFlow]: { 
+    name: UnitFamily.GasFlow, 
+    pivotUnit: GasFlowUnit.NormalCubicMeterPerHour
+  },
+  
+  [UnitFamily.Pressure]: { 
+    name: UnitFamily.Pressure, 
+    pivotUnit: PressureUnit.Pascal
+  },
+  
+  [UnitFamily.Speed]: { 
+    name: UnitFamily.Speed, 
+    pivotUnit: SpeedUnit.MeterPerSecond
+  },
+  
+  [UnitFamily.Distance]: { 
+    name: UnitFamily.Distance, 
+    pivotUnit: DistanceUnit.Meter
+  },
+  
+  [UnitFamily.Mass]: { 
+    name: UnitFamily.Mass, 
+    pivotUnit: MassUnit.Gram
+  },
+  
+  [UnitFamily.MassFlow]: { 
+    name: UnitFamily.MassFlow, 
+    pivotUnit: MassFlowUnit.GramPerSecond
+  },
+  
+  [UnitFamily.Frequency]: { 
+    name: UnitFamily.Frequency, 
+    pivotUnit: FrequencyUnit.Hertz
+  },
+  
+  [UnitFamily.Voltage]: { 
+    name: UnitFamily.Voltage, 
+    pivotUnit: VoltageUnit.Volt
+  },
+  
+  [UnitFamily.Current]: { 
+    name: UnitFamily.Current, 
+    pivotUnit: CurrentUnit.Ampere
+  },
+  
+  [UnitFamily.Resistance]: { 
+    name: UnitFamily.Resistance, 
+    pivotUnit: ResistanceUnit.Ohm
+  },
+  
+  [UnitFamily.Percentage]: { 
+    name: UnitFamily.Percentage, 
+    pivotUnit: PercentageUnit.Percent
+  },
+  
+  [UnitFamily.Capacity]: { 
+    name: UnitFamily.Capacity, 
+    pivotUnit: CapacityUnit.Person
+  },
+  
+  [UnitFamily.SnowProduction]: { 
+    name: UnitFamily.SnowProduction, 
+    pivotUnit: SnowProductionUnit.CubicMeterSnowPerHour
+  },
+  
+  [UnitFamily.Efficiency]: { 
+    name: UnitFamily.Efficiency, 
+    pivotUnit: EfficiencyUnit.KilowattHourPerCubicMeter
+  },
+};

package/models/units/unitsRegistry.ts

@@ -0,0 +1,351 @@
+import { UnitFamily, EnergyUnit, PowerUnit, VolumeUnit, GasVolumeUnit, WaterFlowUnit, GasFlowUnit, PressureUnit, TemperatureUnit, SpeedUnit, DistanceUnit, MassUnit, MassFlowUnit, FrequencyUnit, VoltageUnit, CurrentUnit, ResistanceUnit, PercentageUnit, CapacityUnit, SnowProductionUnit, EfficiencyUnit,
+} from "@dative-gpi/foundation-shared-domain/enums";
+import type { UnitDefinition } from "./unitDetails";
+
+export const unitRegistry: Record<string, UnitDefinition> = {
+  // =========================
+  // ÉNERGIE (pivot: J)
+  // =========================
+  [EnergyUnit.Joule]: {
+    symbol: EnergyUnit.Joule,
+    family: UnitFamily.Energy,
+    toPivot: 1, 
+    usesSIPrefixes: true, // kJ, MJ, ...
+  },
+
+  [EnergyUnit.Wattheure]: {
+    symbol: EnergyUnit.Wattheure,
+    family: UnitFamily.Energy,
+    toPivot: 3600, // 1 Wh = 3600 J
+    usesSIPrefixes: true, // kWh, MWh, ...
+  },
+
+  [EnergyUnit.Calorie]: {
+    symbol: EnergyUnit.Calorie,
+    family: UnitFamily.Energy,
+    toPivot: 4.184, // 1 cal(th) = 4.184 J
+    usesSIPrefixes: true, // kcal, ...
+  },
+
+  // =========================
+  // PUISSANCE (pivot: W)
+  // =========================
+  [PowerUnit.Watt]: {
+    symbol: PowerUnit.Watt,
+    family: UnitFamily.Power,
+    toPivot: 1,
+    usesSIPrefixes: true, // kW, MW...
+  },
+
+  // =========================
+  // VOLUME (pivot: L)
+  // =========================
+  [VolumeUnit.Liter]: {
+    symbol: VolumeUnit.Liter,
+    family: UnitFamily.Volume,
+    toPivot: 1,
+    usesSIPrefixes: true,
+    specialConversions: [
+      { toUnit: VolumeUnit.CubicMeter, threshold: 1000 },
+    ],
+  },
+
+  [VolumeUnit.CubicMeter]: {
+    symbol: VolumeUnit.CubicMeter,
+    family: UnitFamily.Volume,
+    toPivot: 1000,
+    usesSIPrefixes: false,
+    // NOTE: si tu veux "0.001 m³ -> 1 L", ça nécessite une règle "< 1"
+    // (non supportée par specialConversions aujourd’hui) ou un traitement dans selectBestUnit.
+  },
+
+  // =========================
+  // VOLUME GAZ (pivot: Nm³)
+  // =========================
+  [GasVolumeUnit.NormalCubicMeter]: {
+    symbol: GasVolumeUnit.NormalCubicMeter,
+    family: UnitFamily.GasVolume,
+    toPivot: 1,
+    usesSIPrefixes: true,
+  },
+
+  // =========================
+  // DÉBIT D’EAU (pivot: L/s)
+  // =========================
+  [WaterFlowUnit.LiterPerSecond]: {
+    symbol: WaterFlowUnit.LiterPerSecond,
+    family: UnitFamily.WaterFlow,
+    toPivot: 1,
+    usesSIPrefixes: true,
+    specialConversions: [
+      { toUnit: WaterFlowUnit.CubicMeterPerHour, threshold: 100 },
+    ],
+  },
+
+  [WaterFlowUnit.LiterPerMinute]: {
+    symbol: WaterFlowUnit.LiterPerMinute,
+    family: UnitFamily.WaterFlow,
+    toPivot: 1 / 60, // 1 L/min = 1/60 L/s
+    usesSIPrefixes: false,
+    specialConversions: [
+      // >= 60 L/min -> 1 L/s (puis éventuellement m³/h)
+      { toUnit: WaterFlowUnit.LiterPerSecond, threshold: 60 },
+    ],
+  },
+
+  [WaterFlowUnit.CubicMeterPerHour]: {
+    symbol: WaterFlowUnit.CubicMeterPerHour,
+    family: UnitFamily.WaterFlow,
+    toPivot: 1000 / 3600, // 1 m³/h = 1000 L / 3600 s
+    usesSIPrefixes: false,
+  },
+
+  [WaterFlowUnit.CubicMeterPerSecond]: {
+    symbol: WaterFlowUnit.CubicMeterPerSecond,
+    family: UnitFamily.WaterFlow,
+    toPivot: 1000, // 1 m³/s = 1000 L/s
+    usesSIPrefixes: false,
+  },
+
+  // =========================
+  // DÉBIT GAZ (pivot: Nm³/h)
+  // =========================
+  [GasFlowUnit.NormalCubicMeterPerHour]: {
+    symbol: GasFlowUnit.NormalCubicMeterPerHour,
+    family: UnitFamily.GasFlow,
+    toPivot: 1, 
+    usesSIPrefixes: true,
+  },
+
+  // =========================
+  // PRESSION (pivot: Pa)
+  // =========================
+  [PressureUnit.Pascal]: {
+    symbol: PressureUnit.Pascal,
+    family: UnitFamily.Pressure,
+    toPivot: 1, 
+    usesSIPrefixes: true, // kPa, MPa...
+    specialConversions: [
+      // Affichage métier fréquent: 100000 Pa = 1 bar
+      { toUnit: PressureUnit.Bar, threshold: 100_000 },
+    ],
+  },
+
+  [PressureUnit.Bar]: {
+    symbol: PressureUnit.Bar,
+    family: UnitFamily.Pressure,
+    toPivot: 100_000, // 1 bar = 100000 Pa
+    usesSIPrefixes: true,
+  },
+
+  // =========================
+  // TEMPÉRATURE (custom converter dans unitFamilies)
+  // =========================
+  [TemperatureUnit.Celsius]: {
+    symbol: TemperatureUnit.Celsius,
+    family: UnitFamily.Temperature,
+    toPivot: 1, // ignoré car customConverter
+    usesSIPrefixes: false,
+  },
+  [TemperatureUnit.Kelvin]: {
+    symbol: TemperatureUnit.Kelvin,
+    family: UnitFamily.Temperature,
+    toPivot: 1, // ignoré
+    usesSIPrefixes: false,
+  },
+  [TemperatureUnit.Fahrenheit]: {
+    symbol: TemperatureUnit.Fahrenheit,
+    family: UnitFamily.Temperature,
+    toPivot: 1, // ignoré
+    usesSIPrefixes: false,
+  },
+
+  // =========================
+  // VITESSE (pivot: m/s)
+  // =========================
+  [SpeedUnit.MeterPerSecond]: {
+    symbol: SpeedUnit.MeterPerSecond,
+    family: UnitFamily.Speed,
+    toPivot: 1, 
+    usesSIPrefixes: false,
+    specialConversions: [
+      // UX: toujours afficher en km/h
+      { toUnit: SpeedUnit.KilometerPerHour, threshold: 0 },
+    ],
+  },
+
+  [SpeedUnit.KilometerPerHour]: {
+    symbol: SpeedUnit.KilometerPerHour,
+    family: UnitFamily.Speed,
+    toPivot: 1 / 3.6, // 1 km/h = 0.277... m/s
+    usesSIPrefixes: false,
+  },
+
+  [SpeedUnit.Knot]: {
+    symbol: SpeedUnit.Knot,
+    family: UnitFamily.Speed,
+    toPivot: 0.514444, // 1 kt = 0.514444 m/s
+    usesSIPrefixes: false,
+  },
+
+  // =========================
+  // DISTANCE (pivot: m)
+  // =========================
+  [DistanceUnit.Meter]: {
+    symbol: DistanceUnit.Meter,
+    family: UnitFamily.Distance,
+    toPivot: 1, 
+    usesSIPrefixes: true, // mm, km (pas de cm/dm car pas dans SI_PREFIXES)
+  },
+
+  // =========================
+  // MASSE (pivot: g)
+  // =========================
+  [MassUnit.Gram]: {
+    symbol: MassUnit.Gram,
+    family: UnitFamily.Mass,
+    toPivot: 1, 
+    usesSIPrefixes: true,
+    specialConversions: [
+      // 1 000 000 g = 1 t (affichage plus "métier" que Mg)
+      { toUnit: MassUnit.Tonne, threshold: 1_000_000 },
+    ],
+  },
+
+  [MassUnit.Tonne]: {
+    symbol: MassUnit.Tonne,
+    family: UnitFamily.Mass,
+    toPivot: 1_000_000, // 1 t = 1 000 000 g
+    usesSIPrefixes: false,
+  },
+
+  // =========================
+  // DÉBIT MASSIQUE (pivot: g/s)
+  // =========================
+  [MassFlowUnit.GramPerSecond]: {
+    symbol: MassFlowUnit.GramPerSecond,
+    family: UnitFamily.MassFlow,
+    toPivot: 1, 
+    usesSIPrefixes: true,
+    specialConversions: [
+      // 100 000 g/s = 100 kg/s -> bascule t/h (souvent plus lisible)
+      { toUnit: MassFlowUnit.TonnePerHour, threshold: 100_000 },
+    ],
+  },
+
+  [MassFlowUnit.KilogramPerHour]: {
+    symbol: MassFlowUnit.KilogramPerHour,
+    family: UnitFamily.MassFlow,
+    toPivot: 1000 / 3600, // 1 kg/h = 1000 g / 3600 s
+    usesSIPrefixes: false,
+  },
+
+  [MassFlowUnit.TonnePerHour]: {
+    symbol: MassFlowUnit.TonnePerHour,
+    family: UnitFamily.MassFlow,
+    toPivot: 1_000_000 / 3600, // 1 t/h = 1e6 g / 3600 s
+    usesSIPrefixes: false,
+  },
+
+  [MassFlowUnit.TonnePerSecond]: {
+    symbol: MassFlowUnit.TonnePerSecond,
+    family: UnitFamily.MassFlow,
+    toPivot: 1_000_000, // 1 t/s = 1e6 g/s
+    usesSIPrefixes: false,
+  },
+
+  // =========================
+  // FRÉQUENCE (pivot: Hz)
+  // =========================
+  [FrequencyUnit.Hertz]: {
+    symbol: FrequencyUnit.Hertz,
+    family: UnitFamily.Frequency,
+    toPivot: 1, 
+    usesSIPrefixes: true,
+  },
+
+  [FrequencyUnit.RevolutionsPerMinute]: {
+    symbol: FrequencyUnit.RevolutionsPerMinute,
+    family: UnitFamily.Frequency,
+    toPivot: 1 / 60, // 1 rpm = 1/60 Hz
+    usesSIPrefixes: false,
+  },
+
+  // =========================
+  // ÉLECTRICITÉ
+  // =========================
+  [VoltageUnit.Volt]: {
+    symbol: VoltageUnit.Volt,
+    family: UnitFamily.Voltage,
+    toPivot: 1,
+    usesSIPrefixes: true,
+  },
+
+  [CurrentUnit.Ampere]: {
+    symbol: CurrentUnit.Ampere,
+    family: UnitFamily.Current,
+    toPivot: 1,
+    usesSIPrefixes: true,
+  },
+
+  [ResistanceUnit.Ohm]: {
+    symbol: ResistanceUnit.Ohm,
+    family: UnitFamily.Resistance,
+    toPivot: 1,
+    usesSIPrefixes: true,
+  },
+
+  // =========================
+  // UNITÉS À RISQUE DE "FAUSSE CONVERSION"
+  // =========================
+  // Ces familles contiennent des unités qui ne sont pas dimensionnellement convertibles entre elles,
+  // mais le moteur les traitera comme convertibles si on utilise targetUnit entre elles.
+  [PercentageUnit.Percent]: {
+    symbol: PercentageUnit.Percent,
+    family: UnitFamily.Percentage,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+
+  [PercentageUnit.RelativeHumidity]: {
+    symbol: PercentageUnit.RelativeHumidity,
+    family: UnitFamily.Percentage,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+
+  [CapacityUnit.Person]: {
+    symbol: CapacityUnit.Person,
+    family: UnitFamily.Capacity,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+
+  [CapacityUnit.PersonPerHour]: {
+    symbol: CapacityUnit.PersonPerHour,
+    family: UnitFamily.Capacity,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+
+  [SnowProductionUnit.CubicMeterSnowPerHour]: {
+    symbol: SnowProductionUnit.CubicMeterSnowPerHour,
+    family: UnitFamily.SnowProduction,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+
+  [EfficiencyUnit.KilowattHourPerCubicMeter]: {
+    symbol: EfficiencyUnit.KilowattHourPerCubicMeter,
+    family: UnitFamily.Efficiency,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+
+  [EfficiencyUnit.KilowattHourPerKilogram]: {
+    symbol: EfficiencyUnit.KilowattHourPerKilogram,
+    family: UnitFamily.Efficiency,
+    toPivot: 1,
+    usesSIPrefixes: false,
+  },
+};

package/package.json

@@ -4,7 +4,7 @@
     "url": "https://github.com/Dative-GPI/foundation-shared-ui.git"
   },
   "sideEffects": false,
-  "version": "1.0.191",
+  "version": "1.0.193-test-unit-formatter",
   "description": "",
   "publishConfig": {
     "access": "public"
@@ -15,5 +15,5 @@
   "peerDependencies": {
     "date-fns": "^3.6.0"
   },
-  "gitHead": "0d267a72e208daaa7a5b9760e03b84410d2a7eb8"
+  "gitHead": "fc948d90c3e19270003dc7f695459ae96bf1539c"
 }