@agridea/suibi-module 0.1.0-preview.6 → 0.1.0-preview.68e6607

package/dist/types/app/components/validation-page/validation-page.component.d.ts

@@ -0,0 +1,18 @@
+import { ErrorObject } from 'ajv';
+import { PlanningBalanceService } from '../../core/planning/planning-balance.service';
+/**
+ * Final submission step: review validation status and submit the planning balance.
+ */
+export declare class ValidationPageComponent {
+    readonly showHeader: import("@angular/core").InputSignal<boolean>;
+    /** Navigation callback for validation error clicks — provided by App to keep routing logic centralised. */
+    readonly onErrorSelected: import("@angular/core").InputSignal<(error: ErrorObject) => void>;
+    /** Navigation callback triggered after a fresh successful planning submission. */
+    readonly onSubmitSuccess: import("@angular/core").InputSignal<() => void>;
+    protected readonly planning: PlanningBalanceService;
+    private readonly globalValidation;
+    private lastHandledSuccessRequestId;
+    constructor();
+    protected readonly validationErrors: import("@angular/core").Signal<import("../../../public-api").EnrichedValidationError[]>;
+    protected readonly errorCount: import("@angular/core").Signal<number>;
+}

package/dist/types/app/components/welcome-page/metadata.types.d.ts

@@ -1 +1 @@
-export { DEFAULT_SUIBI_METADATA, type SubmissionStatus, type SuibiVersion, type SuibiMetadata } from '../../core/metadata/suibi-metadata.types';
+export { DEFAULT_SUIBI_METADATA, DEFAULT_COMPUTATION_MODULES, type ComputationModules, type SubmissionStatus, type SuibiVersion, type SuibiMetadata } from '../../core/metadata/suibi-metadata.types';

package/dist/types/app/components/welcome-page/welcome-page.component.d.ts

@@ -1,9 +1,9 @@
-import { OnInit } from '@angular/core';
 import { JsonSchema, UISchemaElement } from '@jsonforms/core';
 import { SuibiMetadata } from '../../core/metadata/suibi-metadata.types';
-export declare class WelcomePageComponent implements OnInit {
+export declare class WelcomePageComponent {
     private readonly i18n;
     private readonly metadataSvc;
+    private readonly naebi;
     startEvent: import("@angular/core").OutputEmitterRef<void>;
     metadataChange: import("@angular/core").OutputEmitterRef<SuibiMetadata>;
     private readonly baseSchema;
@@ -17,11 +17,13 @@ export declare class WelcomePageComponent implements OnInit {
     readonly localizedSchema: import("@angular/core").Signal<JsonSchema>;
     readonly localizedUi: import("@angular/core").Signal<UISchemaElement>;
     readonly jsonFormsData: import("@angular/core").Signal<{}>;
-    ngOnInit(): void;
+    constructor();
     start(): void;
+    loadExampleData(): void;
     onMetadataChange(newValue: unknown): void;
     private normalizeJsonFormsPayload;
     private toMetadata;
+    private extractModules;
     private isSuibiVersion;
     private isSubmissionStatus;
     private isSameMetadata;

package/dist/types/app/components/workflow-stepper/workflow-stepper.component.d.ts

@@ -0,0 +1,49 @@
+import { PageId } from '../../core/navigation/navigation.service';
+/**
+ * WorkflowStepperComponent
+ * Horizontal navigation stepper for the main data-entry workflow.
+ *
+ * Design contract:
+ * - Uses mat-stepper as a header-only nav bar (step content is empty; content
+ *   area is hidden via CSS so the stepper acts as a pure navigation indicator).
+ * - [selectedIndex] is driven by the currentPage input — no internal routing state.
+ * - Navigation is delegated back to App via the onNavigate callback, preserving
+ *   the custom-element page-attribute reflection.
+ * - Error indicators: any page with at least one enriched validation error shows
+ *   the error ring on its step circle. Requires STEPPER_GLOBAL_OPTIONS { showError: true }.
+ * - Non-workflow pages (e.g. data_preview): mat-stepper rejects out-of-bounds selectedIndex,
+ *   so we clamp to 0; the no-active-step CSS class neutralises the visual active indicator,
+ *   and onStepperClick delegates clicks for all headers (bypassing the stepper's
+ *   "no-change" guard that suppresses selectedIndexChange for the currently selected step).
+ *
+ * Extension points:
+ * - Completed state: replace the hardcoded `false` on [completed] with a per-page
+ *   computed once domain completion rules are defined (e.g. all required fields valid).
+ * - New pages: add an entry to WORKFLOW_STEPS and extend PageId.
+ */
+export declare class WorkflowStepperComponent {
+    protected readonly steps: readonly {
+        readonly pageId: PageId;
+        readonly labelKey: string;
+    }[];
+    /**
+     * Current page from the parent. Controls which step circle is highlighted.
+     * Non-workflow pages (e.g. data_preview) use index 0 as a valid CDK fallback;
+     * the no-active-step CSS class removes the visual active indicator for those pages.
+     */
+    readonly currentPage: import("@angular/core").InputSignal<PageId>;
+    /**
+     * Navigation callback provided by App.
+     * Using a callback (instead of an output EventEmitter) matches the existing
+     * header-bar pattern and ensures the custom-element page-attribute is reflected.
+     */
+    readonly onNavigate: import("@angular/core").InputSignal<(page: PageId) => void>;
+    private readonly validationSvc;
+    private readonly workflowPage;
+    protected readonly pagesWithErrors: import("@angular/core").Signal<Set<PageId>>;
+    protected readonly isOnWorkflowPage: import("@angular/core").Signal<boolean>;
+    protected readonly clampedStepIndex: import("@angular/core").Signal<number>;
+    protected onSelectedIndexChange(index: number): void;
+    protected onStepperClick(event: MouseEvent): void;
+    private navigateTo;
+}

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,21 @@ 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>;
     /** 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 +78,18 @@ 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;
+    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,38 @@
+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;
+    /** 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[];