@agridea/suibi-module 0.1.0-preview.7 → 0.1.0-preview.87cac2d

package/dist/types/app/core/data/naebi-data.service.d.ts

@@ -29,10 +29,8 @@ export declare class NaebiDataService {
                         hoursPerDay: number;
                     };
                     stall: {
-                        stableSystem: number;
-                        stableCapacity: number;
+                        stableSystem: string;
                         stableVentilationType: number;
-                        stableAirPurification: number;
                         hasStableDeepLitter: boolean;
                         hasStableManureBeltDrying: boolean;
                         stableManureRemovalFrequency: number;
@@ -41,10 +39,6 @@ export declare class NaebiDataService {
                         hasStableFeedingStationElevated: boolean;
                         hasStableFloorSlopedUrineDrainage: boolean;
                         hasYard: boolean;
-                        yardFeeding: number;
-                        yardFloorType: number;
-                        yardDays: number;
-                        yardHoursPerDay: number;
                     };
                 };
                 hasImpexDerivedExcretion: boolean;
@@ -52,6 +46,7 @@ export declare class NaebiDataService {
                 feeding: {
                     fodderConsumption: number;
                     concentratedFeedstuffConsumption: number;
+                    concentratedFeedStuffConsumption: number;
                     winterFeeding: {
                         feedingRoutine: {
                             typeOfFeedstuffProduct: string;
@@ -76,19 +71,14 @@ export declare class NaebiDataService {
             }[];
             storage: {
                 stableStrawLitter: number;
-                manureSupplyProportionStored: number;
                 slurrySupplyProportionStored: number;
                 createFacilitySpecificManureProduct: boolean;
                 createFacilitySpecificSlurryProduct: boolean;
+                slurryTankQuantity: number;
                 dilutionRatio: number;
-                manurePit: {
-                    cover: number;
-                    manureFromAnimalStockStored: {
-                        manureDerivation: string;
-                        proportionStored: number;
-                    }[];
-                }[];
+                manurePit: never[];
                 slurryTank: {
+                    descriptor: string;
                     volumeInM3: number;
                     depthInM: number;
                     cover: number;
@@ -97,16 +87,7 @@ export declare class NaebiDataService {
                 }[];
             };
             farmManureTrading: {
-                supply: {
-                    quantity: number;
-                    typeOfManureRecyclingProduct: string;
-                    transactionUnit: string;
-                    ingredient: {
-                        quantity: number;
-                        molecularFormula: string;
-                        unit: string;
-                    }[];
-                }[];
+                supply: never[];
                 dispense: {
                     quantity: number;
                     typeOfManureRecyclingProduct: string;
@@ -115,6 +96,11 @@ export declare class NaebiDataService {
                         zoologicalAnimal: string;
                         percentageAllocation: number;
                     }[];
+                    ingredient: {
+                        quantity: number;
+                        molecularFormula: string;
+                        unit: string;
+                    }[];
                 }[];
             };
             fieldSpreading: {
@@ -138,6 +124,7 @@ export declare class NaebiDataService {
                     proportionAppliedOtherMonths: number;
                 };
                 fertiliser: {
+                    descriptor: string;
                     fertiliserProductCategory: string;
                     quantity: number;
                     transactionUnit: string;
@@ -159,8 +146,6 @@ export declare class NaebiDataService {
                 }[];
             };
             lifetimePerformance: {
-                dailyGain: number;
-                liveWeight: number;
                 milkProductionReport: number;
             };
             fodder: {
@@ -175,6 +160,12 @@ export declare class NaebiDataService {
                             unit: string;
                         }[];
                     }[];
+                    dispense: {
+                        typeOfFeedstuffProduct: string;
+                        quantity: number;
+                        transactionUnit: string;
+                        ingredient: never[];
+                    }[];
                 };
                 cropFromNonFodderCropland: {
                     typeOfFeedstuffProduct: string;
@@ -190,6 +181,17 @@ export declare class NaebiDataService {
                 totalBalanceErrorMargin: number;
             };
             fieldCultivation: {
+                buildingZoneAreaSize: number;
+                outdoorVegetableMainCropAreaSize: number;
+                indoorVegetableMainCropAreaSize: number;
+                feedingOfCropHarvest: {
+                    agronomicCropCategory: string;
+                    effectiveYield: number;
+                }[];
+                dispenseOfCropHarvest: {
+                    agronomicCropCategory: string;
+                    effectiveYield: number;
+                }[];
                 fodderCropland: ({
                     agronomicCropCategory: string;
                     isMainCrop: boolean;
@@ -208,17 +210,25 @@ export declare class NaebiDataService {
                     isMainCrop: boolean;
                     areaSize: number;
                     yieldPerSquareMeasure: number;
+                    hasLongTermYieldDivergence: boolean;
                 }[];
                 special: {
                     agronomicCropCategory: string;
                     userSpecificPlantName: string;
                     isMainCrop: boolean;
                     areaSize: number;
-                    yieldPerSquareMeasure: number;
+                    requirementCorrection: {
+                        quantity: number;
+                        molecularFormula: string;
+                        unit: string;
+                    }[];
                 }[];
             };
             generateReport: boolean;
         };
+        calculationVersion: {
+            version: string;
+        };
     }>;
     private readonly _lastEmitted;
     private readonly _dirty;

package/dist/types/app/core/error/global-error-handler.d.ts

@@ -1,6 +1,5 @@
-import { ErrorHandler, Injector } from '@angular/core';
+import { ErrorHandler } from '@angular/core';
 export declare class GlobalErrorHandler implements ErrorHandler {
-    private injector;
-    constructor(injector: Injector);
+    private readonly injector;
     handleError(error: any): void;
 }

package/dist/types/app/core/i18n/i18n.service.d.ts

@@ -1,5 +1,5 @@
 import { PipeTransform, Signal } from '@angular/core';
-export type Locale = 'en' | 'de';
+export type Locale = 'en' | 'de' | 'fr' | 'it';
 export type JsonFormsTranslator = (key: string, defaultMessage: string | undefined, context: unknown) => string;
 export declare class I18nService {
     private readonly _locale;
@@ -8,13 +8,15 @@ export declare class I18nService {
     readonly jsonFormsI18n: Signal<{
         locale: Locale;
         translate: JsonFormsTranslator;
+        translateError: (error: unknown, translate: JsonFormsTranslator) => string;
     }>;
     setLocale(locale: Locale): void;
+    /** Returns true if the given string is a supported locale key. */
+    isValidLocale(value: string): value is Locale;
     t(key: string, defaultMessage?: string): string;
 }
 export declare class TranslatePipe implements PipeTransform {
-    private readonly i18n;
     private readonly cache;
-    constructor(i18n: I18nService);
+    private readonly i18n;
     transform(key: string, defaultMessage?: string): Signal<string>;
 }

package/dist/types/app/core/i18n/locales/fr.d.ts

@@ -0,0 +1,2 @@
+export declare const frTranslations: Record<string, string>;
+export type FrTranslationKeys = keyof typeof frTranslations;

package/dist/types/app/core/i18n/locales/it.d.ts

@@ -0,0 +1,2 @@
+export declare const itTranslations: Record<string, string>;
+export type ItTranslationKeys = keyof typeof itTranslations;

package/dist/types/app/core/master-data/master-data.service.d.ts

@@ -1,7 +1,9 @@
 import { Locale } from '../i18n/i18n.service';
-type MasterDataKeyField = 'id' | 'code';
+/** The property name of the primary key in a master-data catalog entry. */
+type MasterDataKeyField = string;
 interface MasterDataCatalog {
     entries: any[];
+    /** Property name to use as the lookup key; 'id' entries are coerced to Number. */
     key: MasterDataKeyField;
 }
 declare const MASTER_DATA: Record<string, MasterDataCatalog>;
@@ -21,5 +23,10 @@ export declare class MasterDataService {
     resolveUtilisation(id: number | string | null | undefined, locale?: Locale): string;
     resolveManureProduct(code: string | null | undefined, locale?: Locale): string;
     resolveZoologicalAnimal(code: string | null | undefined, locale?: Locale): string;
+    resolveCultivationCategory(code: string | null | undefined, locale?: Locale): string;
+    resolveAgronomicCropCategory(code: string | null | undefined, locale?: Locale): string;
+    resolveFeedstuffProduct(code: string | null | undefined, locale?: Locale): string;
+    resolveCover(id: number | string | null | undefined, locale?: Locale): string;
+    resolveMixingFrequency(id: number | string | null | undefined, locale?: Locale): string;
 }
 export {};

package/dist/types/app/core/metadata/suibi-metadata.types.d.ts

@@ -1,8 +1,18 @@
-export type SuibiVersion = '1.19' | '1.20';
+export type SuibiVersion = 'v2.0';
 export type SubmissionStatus = 'draft' | 'submitted' | 'final';
+/** Which computation modules are active for this dossier. */
+export interface ComputationModules {
+    suisseBilanz: boolean;
+    gmf: boolean;
+    nh3: boolean;
+    impex: boolean;
+    linear: boolean;
+}
+export declare const DEFAULT_COMPUTATION_MODULES: ComputationModules;
 export interface SuibiMetadata {
     title: string;
     suibiVersion: SuibiVersion;
     status: SubmissionStatus;
+    modules: ComputationModules;
 }
 export declare const DEFAULT_SUIBI_METADATA: SuibiMetadata;

package/dist/types/app/core/navigation/navigation.service.d.ts

@@ -1,8 +1,13 @@
-export type PageId = 'welcome' | 'animal_stock' | 'data_preview' | 'storage' | 'field_spreading' | 'farm_manure_trading';
+export type PageId = 'welcome' | 'animal_stock' | 'data_preview' | 'storage' | 'field_spreading' | 'farm_manure_trading' | 'fodder' | 'field_cultivation' | 'validation' | 'results';
 export type AnimalStockCategory = 'base' | 'formOfDetention' | 'feeding';
 export type FarmManureTradingMode = 'supply' | 'dispense';
 export type FarmManureTradingCategory = 'general' | 'derivation' | 'ingredients';
+export type FodderMode = 'supply' | 'dispense' | 'non_fodder_cropland';
+export type FodderCategory = 'general' | 'ingredients';
 export type FieldSpreadingCategory = 'general' | 'fertiliser' | 'recycling';
+export type FieldCultivationTab = 'general' | 'fodderCropland' | 'arableLand' | 'special';
+export type StorageTab = 'manure' | 'slurry';
+export type StorageEntryType = 'manure_pit' | 'slurry_tank';
 /**
  * NavigationService
  * Global reactive store for application routing and deep-link state.
@@ -38,6 +43,26 @@ export declare class NavigationService {
         mode: FarmManureTradingMode;
         index: number;
     } | null>;
+    /** Selected fodder detail context (mode + index) */
+    readonly selectedFodderDetail: import("@angular/core").WritableSignal<{
+        mode: FodderMode;
+        index: number;
+    } | null>;
+    /** Selected field cultivation detail context (tab + index) */
+    readonly selectedFieldCultivationDetail: import("@angular/core").WritableSignal<{
+        tab: Exclude<FieldCultivationTab, "general">;
+        index: number;
+    } | null>;
+    /** Selected storage detail context (type + index) */
+    readonly selectedStorageDetail: import("@angular/core").WritableSignal<{
+        type: StorageEntryType;
+        index: number;
+    } | null>;
+    /** Selected field spreading row context (category/tab + row index) — used by validation deep-links */
+    readonly selectedFieldSpreadingDetail: import("@angular/core").WritableSignal<{
+        category: FieldSpreadingCategory;
+        index: number;
+    } | null>;
     /** True if currently viewing animal stock detail (not list) */
     readonly isAnimalStockDetailView: import("@angular/core").Signal<boolean>;
     /** True if currently on animal stock page (list or detail) */
@@ -58,10 +83,20 @@ export declare class NavigationService {
     navigateToAnimalStockDetail(index: number, category?: AnimalStockCategory): void;
     navigateToFarmManureTradingDetail(mode: FarmManureTradingMode, index: number, category?: FarmManureTradingCategory): void;
     navigateToFarmManureTradingList(): void;
+    navigateToFodderDetail(mode: FodderMode, index: number, category?: FodderCategory): void;
+    navigateToFodderList(): void;
     navigateToFieldSpreading(category?: FieldSpreadingCategory): void;
+    /** Deep-link to a specific row of a field spreading tab (e.g. from a validation error). */
+    navigateToFieldSpreadingDetail(category: FieldSpreadingCategory, index: number): void;
+    navigateToFieldCultivationDetail(tab: Exclude<FieldCultivationTab, 'general'>, index: number): void;
+    navigateToFieldCultivationList(tab?: FieldCultivationTab): void;
+    navigateToStorageDetail(type: StorageEntryType, index: number): void;
+    navigateToStorageList(tab?: StorageTab): void;
     /**
      * Set active category/tab for current page (without changing page/entry).
      * Generic method supporting any page's categorization navigation.
+     * No-op when page and category are already the same values to prevent
+     * unnecessary signal emissions that re-trigger the tab index computed.
      */
     setCategory(page: PageId, category: string): void;
     /**

package/dist/types/app/core/planning/planning-balance.service.d.ts

@@ -0,0 +1,46 @@
+import { NaebiData } from '../data/naebi-data.service';
+import type { PlanningBalanceResponse } from './planning-balance.types';
+export type { PlanningBalanceResponse } from './planning-balance.types';
+/** Which backend to target for planning requests. */
+export type PlanningEndpoint = 'ebilanz' | 'blw';
+/**
+ * Sends NAEBI data to a planning endpoint and exposes the result as a
+ * signal-based resource. Call `runPlanning(data, endpoint)` to trigger a request.
+ *
+ * The ID counter ensures each call re-fetches even if the payload hasn't changed.
+ */
+export declare class PlanningBalanceService {
+    private readonly http;
+    private readonly metadataSvc;
+    private readonly _value;
+    private readonly _error;
+    private readonly _isLoading;
+    private readonly _selectedEndpoint;
+    private readonly _lastStartedRequestId;
+    private readonly _lastCompletedRequestId;
+    private readonly _lastSuccessfulRequestId;
+    private _nextId;
+    private activeRequestId;
+    private activeRequestSub;
+    readonly planningResource: {
+        value: import("@angular/core").Signal<PlanningBalanceResponse | undefined>;
+        error: import("@angular/core").Signal<unknown>;
+        isLoading: import("@angular/core").Signal<boolean>;
+        hasValue: import("@angular/core").Signal<boolean>;
+        lastStartedRequestId: import("@angular/core").Signal<number>;
+        lastCompletedRequestId: import("@angular/core").Signal<number>;
+        lastSuccessfulRequestId: import("@angular/core").Signal<number>;
+    };
+    readonly selectedEndpoint: import("@angular/core").Signal<PlanningEndpoint>;
+    setSelectedEndpoint(endpoint: PlanningEndpoint): void;
+    /**
+     * Builds the exact payload posted to the planning API: calculationVersion stamped from
+     * the current metadata, `nutrientCycle.generateReport` forced to true (the PDF report
+     * must always be requested on submission), empty ingredient/routine slots stripped,
+     * null optional fields and host-only fields removed, custom display units converted
+     * to base units.
+     */
+    buildApiPayload(data: NaebiData): NaebiData;
+    /** Fire a new planning-balance request with the current NAEBI data payload. */
+    runPlanning(data: NaebiData, endpoint?: PlanningEndpoint): void;
+}

package/dist/types/app/core/planning/planning-balance.types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * TypeScript interfaces for the planning-balance API response.
+ * These match the eBilanz / BLW response shape observed in the example data.
+ */
+/** A single nutrient quantity entry (kg or % unit). */
+export interface NutrientEntry {
+    molecularFormula: string;
+    quantity: number;
+    quantityCorrected?: number;
+    unit: string;
+    productFamilyType?: string;
+    typeOfManureRecyclingProduct?: string;
+    fertiliserProductCategory?: string;
+}
+export interface CalculationVersion {
+    version: string;
+    validFrom: string;
+    validTo: string;
+}
+export interface AreaAndYieldPerAgronomicCropCategory {
+    agronomicCropCategory: string;
+    areaSize: number;
+    effectiveYield: number;
+    isMainCrop: boolean;
+    isNutrientPoorFodder: boolean;
+    yieldPerSquareMeasure?: number;
+}
+export interface AreaPerCultivationType {
+    areaSize: number;
+    isMainCrop: boolean;
+}
+export interface AreaAndYieldPerCultivationCategory {
+    cultivationCategory: string;
+    areaAndYieldPerAgronomicCropCategory: AreaAndYieldPerAgronomicCropCategory[];
+    areaPerCultivationType: AreaPerCultivationType[];
+}
+export interface AreaPerSubCategory {
+    cultivationSubCategory: string;
+    areaSize: number;
+    isMainCrop: boolean;
+}
+export interface FieldCultivation {
+    areaAndYieldPerCultivationCategory: AreaAndYieldPerCultivationCategory[];
+    areaPerSubCategory: AreaPerSubCategory[];
+    fertilizableAreaSize: number;
+    slurrySpreadingAreaSize: number;
+    totalAgriculturalLandAreaSize: number;
+}
+export interface FodderQuantity {
+    quantity: number;
+    unit: string;
+    proportionNutrientPoorFodder?: number;
+}
+export interface FodderProduct {
+    typeOfFeedstuffProduct: string;
+    quantity: number;
+    unit: string;
+    isNutrientPoorFodder: boolean;
+}
+export interface ConsumptionAnimalStock {
+    animalCategoryPRIF: number;
+    averageQuantity: number;
+    order: string;
+    quantity: number;
+    unit: string;
+}
+export interface RequiredEffectiveYieldFromFodderCropland {
+    consumptionAnimalStock: ConsumptionAnimalStock[];
+    cropFromNonFodderCroplandPerProduct: FodderProduct[];
+    dispensePerProduct: FodderProduct[];
+    supplyPerProduct: FodderProduct[];
+    totalBalance: FodderQuantity;
+    totalConsumptionAnimalStock: FodderQuantity;
+    totalCropFromNonFodderCropland: FodderQuantity;
+    totalDispense: FodderQuantity;
+    totalSupply: FodderQuantity;
+}
+export interface FodderBalance {
+    requiredEffectiveYieldFromFodderCropland: RequiredEffectiveYieldFromFodderCropland;
+    totalBalance: FodderQuantity;
+    totalEffectiveYieldFromFodderCropland: FodderQuantity;
+    totalNutrientPoorFodder: FodderQuantity;
+}
+export interface EmissionAndAccumulationEntry {
+    animalCategoryPRIF: number;
+    order: string;
+    accumulation: NutrientEntry[];
+    emission: NutrientEntry[];
+    manureExcretion?: unknown[];
+}
+export interface AccumulationEntireExcretion {
+    animalCategoryPRIF: number;
+    order: string;
+    durationSumTotalCorrectedNutrientBalance: number;
+    accumulation: NutrientEntry[];
+}
+export interface TotalNutrientSet {
+    accumulation: NutrientEntry[];
+    emission?: NutrientEntry[];
+}
+export interface AnimalStock {
+    accumulationEntireExcretion: AccumulationEntireExcretion[];
+    emissionAndAccumulationPasture: EmissionAndAccumulationEntry[];
+    emissionAndAccumulationStall: EmissionAndAccumulationEntry[];
+    emissionAndAccumulationYard: EmissionAndAccumulationEntry[];
+    totalAccumulationEntireExcretion: TotalNutrientSet;
+    totalEmissionAndAccumulationAnimalStock: TotalNutrientSet;
+    totalEmissionAndAccumulationPasture: TotalNutrientSet;
+    totalEmissionAndAccumulationStall: TotalNutrientSet;
+    totalEmissionAndAccumulationYard: TotalNutrientSet;
+}
+export interface ManureTradingProduct {
+    typeOfManureRecyclingProduct: string;
+    quantity: number;
+    unit: string;
+    ingredient: NutrientEntry[];
+}
+export interface FarmManureTrading {
+    balancePerProduct: ManureTradingProduct[];
+    dispensePerProduct: ManureTradingProduct[];
+    supplyPerProduct: ManureTradingProduct[];
+    totalBalance: {
+        ingredient: NutrientEntry[];
+    };
+}
+export interface NutrientRequirementEntry {
+    agronomicCropCategory?: string;
+    cultivationCategory?: string;
+    isMainCrop?: boolean;
+    requirement: NutrientEntry[];
+}
+export interface FieldCultivationNutrients {
+    nutrientTransferUnfertilizedCultivation: NutrientEntry[];
+    requirementPerAgronomicCropCategory: NutrientRequirementEntry[];
+    requirementPerCultivationCategory: NutrientRequirementEntry[];
+    totalRequirement: NutrientEntry[];
+}
+export interface FieldSpreading {
+    emissionAndAccumulationFieldSpreading: TotalNutrientSet;
+    totalEmissionAndAccumulationFieldSpreading: TotalNutrientSet;
+}
+export interface StorageBalance {
+    emissionAndAccumulationManureStorage: TotalNutrientSet;
+    totalEmissionAndAccumulationManureStorage: TotalNutrientSet;
+}
+export interface NutrientBalance {
+    animalStock: AnimalStock;
+    farmManureTrading: FarmManureTrading;
+    fieldCultivation: FieldCultivationNutrients;
+    fieldSpreading: FieldSpreading;
+    storage: StorageBalance;
+    /** Final per-nutrient balance figures: kg lines + % lines interleaved. */
+    totalBalance: NutrientEntry[];
+    /** Farm-wide gas emissions (NH3, NO, N2O, N2). */
+    totalEmissionFarm: NutrientEntry[];
+    nutrientBalanceTMP?: unknown[];
+}
+export interface NutrientCycle {
+    creationDateTime: string;
+    facilitySpecificProducts: {
+        manureRecyclingProduct: unknown[];
+    };
+    fieldCultivation: FieldCultivation;
+    fodderBalance: FodderBalance;
+    nutrientBalance: NutrientBalance;
+    version: string;
+    /** Base64-encoded PDF report, if returned by the endpoint. */
+    report?: string;
+}
+export interface ValidationMessageDetail {
+    designation_deu: string;
+    designation_eng: string;
+    designation_fra: string;
+    designation_ita: string;
+}
+export interface ValidationMessage {
+    field: string;
+    type: string;
+    detail: ValidationMessageDetail;
+}
+/** Full response from the planning-balance endpoint. */
+export interface PlanningBalanceResponse {
+    calculationVersion: CalculationVersion;
+    nutrientCycle: NutrientCycle;
+    validationMessage: ValidationMessage[];
+}
+/** Merged kg + % row for the final balance table (Section D). */
+export interface BalanceRow {
+    molecularFormula: string;
+    quantity: number;
+    quantityCorrected: number;
+    quantityPct: number | null;
+    quantityCorrectedPct: number | null;
+    unit: 'kg';
+}
+/** Crop requirement row enriched with area and yield for display (Section C). */
+export interface CropRequirementRow {
+    cropCode: string;
+    cultivationCategory: string;
+    isMainCrop: boolean;
+    areaHa: number;
+    effectiveYield: number;
+    /** kg/ha yield per square measure field (m² basis), converted to dt/ha for display. */
+    yieldDtHa: number | null;
+    requirement: NutrientEntry[];
+}

package/dist/types/app/core/planning/planning-balance.utils.d.ts

@@ -0,0 +1,10 @@
+import type { BalanceRow, NutrientEntry } from './planning-balance.types';
+/**
+ * Merges the interleaved kg / % rows from `totalBalance` into one `BalanceRow`
+ * per nutrient formula, preserving the canonical KEY_NUTRIENTS display order.
+ *
+ * The planning-balance API returns two `NutrientEntry` objects per formula
+ * (one with `unit === 'kg'`, one with `unit === '%'`). This function coalesces
+ * them so callers work with a single, normalised row.
+ */
+export declare function mergeBalanceRows(totalBalance: NutrientEntry[]): BalanceRow[];

package/dist/types/app/core/utils/custom-unit.util.d.ts

@@ -0,0 +1,39 @@
+export interface CustomUnit {
+    /** Unit code stored on the row (e.g. 'ha', 't', 'dt'). */
+    code: string;
+    /** API base unit this custom unit converts to (e.g. 'm2', 'kg'). */
+    baseUnit: string;
+    /** Multiplier from the custom unit to its base unit (1 ha = 10'000 m2 → 10000). */
+    factor: number;
+    descriptor?: Record<string, unknown>;
+}
+export declare const CUSTOM_UNITS: readonly CustomUnit[];
+/** True when the unit code is a custom display unit (not an API base unit). */
+export declare function isCustomUnit(unit: unknown): boolean;
+/** Base unit a quantity can be converted to: the custom unit's `baseUnit`, or the unit
+ *  itself when it already is a base (or unknown) unit. */
+export declare function baseUnitOf(unit: string | null | undefined): string | null | undefined;
+/** Custom units convertible to the given base unit (e.g. 'kg' → [t, dt]). */
+export declare function customUnitsForBaseUnit(baseUnit: string): CustomUnit[];
+/**
+ * Builds a filter (compatible with the inline table's `optionsFilter`) keeping only the
+ * units compatible with the given context base unit(s) — i.e. each base unit plus its
+ * custom units. Pass a nullable base (e.g. derived from a product's matterState): `null`
+ * keeps the full list (nothing derived yet); pass an array of bases (e.g. ['kg', 'm3'])
+ * to pre-filter to their union before the exact base is known.
+ *
+ * Works on any entry shape exposing `id` (and `baseUnit` for custom units).
+ */
+export declare function unitOptionsForBaseUnit<T extends {
+    id: string | number;
+}>(contextBaseUnit: string | readonly string[] | null | undefined): (entry: T) => boolean;
+/** Converts a quantity expressed in a custom unit to its base unit; pass-through for
+ *  base/unknown units and null quantities. */
+export declare function convertToBaseUnit(quantity: number | null | undefined, unit: string | null | undefined): {
+    quantity: number | null | undefined;
+    unit: string | null | undefined;
+};
+/** Converts a quantity between two units sharing the same base unit (kg ↔ t ↔ dt,
+ *  m2 ↔ ha). Returns the quantity unchanged when either unit is missing or the units
+ *  are incompatible (different base units). */
+export declare function convertQuantityBetween(quantity: number | null | undefined, fromUnit: string | null | undefined, toUnit: string | null | undefined): number | null | undefined;

package/dist/types/app/core/utils/object.util.d.ts

@@ -22,3 +22,25 @@ export declare function deepEqual(a: unknown, b: unknown): boolean;
  * @returns A deep copy of the value
  */
 export declare function deepClone<T>(value: T): T;
+export declare function stripIncompleteIngredients<T>(value: T): T;
+/**
+ * Sanitizes the planning payload: the calculation API (OpenAPI, no `nullable: true`
+ * anywhere) accepts an optional field as *absent* but rejects it when present with a
+ * null value ("must be string/number"). The working data model normalizes optional
+ * fields to null, so strip them at the submission boundary — mirroring what
+ * `stripIncompleteIngredients` does for ingredient slots.
+ *
+ * - inside `fieldCultivation` entry collections (fodderCropland, arableLand, special,
+ *   feedingOfCropHarvest, dispenseOfCropHarvest): any null property is dropped
+ *   (fieldName, userSpecificPlantName, yieldPerSquareMeasure, effectiveYield, …)
+ * - `nutrientCycle.fodder.trading.<collection>[].quantity`: null → dropped
+ * - `nutrientCycle.animalStock[].feeding.(winter|summer)Feeding`: never-filled routine
+ *   slots (`{}` rows pre-created by the inline tables) and null fields are dropped;
+ *   a season — and `feeding` itself — is removed when nothing filled-in remains
+ * - `nutrientCycle.fieldSpreading`: null fields dropped (`soilPh`, `slurry.*`,
+ *   `manure.*`); `slurry`/`manure` removed when nothing filled-in remains
+ */
+export declare function sanitizePlanningPayload(data: NaebiDataLike): NaebiDataLike;
+/** Structural type so object.util stays free of a NaebiData import (circular-safe). */
+type NaebiDataLike = Record<string, unknown>;
+export {};

package/dist/types/app/core/validation/ajv-custom.d.ts

@@ -9,6 +9,7 @@ import Ajv from 'ajv';
  *
  * Custom keywords:
  * - `permittedStableSystem`: Validates stable system against animal category constraints
+ * - `proportionSum`: Validates the sum of one numeric field across array items
  *
  * @param options - Additional AJV options to merge with defaults
  */

package/dist/types/app/core/validation/capabilities.d.ts

@@ -5,14 +5,20 @@
  * All master data is embedded statically at compile time - no runtime HTTP calls.
  */
 /**
- * Derives permitted stable systems (husbandry type IDs) for a given animal category.
+ * Derives permitted stable systems (stableSystem enum strings) for a given animal category.
  *
  * @param animalCategoryPRIF - The PRIF animal category ID
- * @returns Array of permitted husbandry type IDs (stable systems)
+ * @returns Array of permitted stableSystem enum strings (e.g. 'HUS_TETHER')
  */
-export declare function derivePermittedStableSystems(animalCategoryPRIF: number | null | undefined): number[];
+export declare function derivePermittedStableSystems(animalCategoryPRIF: number | null | undefined): string[];
 /**
  * Pre-computed map for performance (memoized at module load).
- * Maps animalCategoryPRIF -> array of permitted stableSystem values.
+ * Maps animalCategoryPRIF -> array of permitted stableSystem enum strings.
  */
-export declare const PERMITTED_STABLE_SYSTEMS: Record<number, number[]>;
+export declare const PERMITTED_STABLE_SYSTEMS: Record<number, string[]>;
+/**
+ * Pre-computed map of non-zero per-category minimum yields (yieldPerSquareMeasure).
+ * Only 8 of the 314 crop categories declare a minimum > 0 (e.g. cereals, peas);
+ * all others fall back to the schema-level `minimum: 0`.
+ */
+export declare const CROP_MINIMUM_YIELD_PER_SQUARE_MEASURE: Record<string, number>;