@agridea/suibi-module 0.1.0-preview.09bcbd4

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

@@ -0,0 +1,278 @@
+import exampleDetail from '../../../../assets/example-data/example-naebi-data.json';
+type SampleEvent = typeof exampleDetail;
+type SampleData = SampleEvent['payload']['data'];
+export type NaebiData = SampleData;
+/**
+ * Calculation mode determines which validation rules and features are active.
+ */
+export declare enum CalculationMode {
+    SuiBi = "SuiBi",// SuisseBilanz (standard)
+    ExBi = "ExBi"
+}
+export declare class NaebiDataService {
+    private readonly _data;
+    readonly data: import("@angular/core").Signal<{
+        nutrientCycle: {
+            animalStock: {
+                order: string;
+                animalCategoryPRIF: number;
+                selfReportedLivestock: {
+                    averageQuantity: number;
+                };
+                durationCorrectionQuantity: number;
+                durationCorrectionDays: number;
+                utilisation: number;
+                formOfDetention: {
+                    hasGrazing: boolean;
+                    pasture: {
+                        days: number;
+                        hoursPerDay: number;
+                    };
+                    stall: {
+                        stableSystem: string;
+                        stableCapacity: number;
+                        stableVentilationType: number;
+                        stableAirPurification: number;
+                        hasStableDeepLitter: boolean;
+                        hasStableManureBeltDrying: boolean;
+                        stableManureRemovalFrequency: number;
+                        stableWaterSupply: number;
+                        hasStableManureAndSlurryProduction: boolean;
+                        hasStableFeedingStationElevated: boolean;
+                        hasStableFloorSlopedUrineDrainage: boolean;
+                        hasYard: boolean;
+                        yardFeeding: number;
+                        yardFloorType: number;
+                        yardDays: number;
+                        yardHoursPerDay: number;
+                    };
+                };
+                hasImpexDerivedExcretion: boolean;
+                hasLinearCorrectionDerivedExcretion: boolean;
+                feeding: {
+                    fodderConsumption: number;
+                    concentratedFeedstuffConsumption: number;
+                    winterFeeding: {
+                        feedingRoutine: {
+                            typeOfFeedstuffProduct: string;
+                            transactionUnit: string;
+                            quantity: number;
+                        }[];
+                        dailyConcentratedFeedstuff: {
+                            quantity: number;
+                        };
+                    };
+                    summerFeeding: {
+                        feedingRoutine: {
+                            typeOfFeedstuffProduct: string;
+                            transactionUnit: string;
+                            quantity: number;
+                        }[];
+                        dailyConcentratedFeedstuff: {
+                            quantity: number;
+                        };
+                    };
+                };
+            }[];
+            storage: {
+                stableStrawLitter: number;
+                manureSupplyProportionStored: number;
+                slurrySupplyProportionStored: number;
+                createFacilitySpecificManureProduct: boolean;
+                createFacilitySpecificSlurryProduct: boolean;
+                dilutionRatio: number;
+                manurePit: {
+                    descriptor: string;
+                    cover: number;
+                    manureFromAnimalStockStored: {
+                        manureDerivation: string;
+                        proportionStored: number;
+                    }[];
+                }[];
+                slurryTank: {
+                    descriptor: string;
+                    volumeInM3: number;
+                    depthInM: number;
+                    cover: number;
+                    mixingFrequency: number;
+                    manureDerivation: string[];
+                }[];
+            };
+            farmManureTrading: {
+                supply: {
+                    quantity: number;
+                    typeOfManureRecyclingProduct: string;
+                    transactionUnit: string;
+                    manureDerivation: {
+                        zoologicalAnimal: string;
+                        percentageAllocation: number;
+                    }[];
+                    ingredient: {
+                        quantity: number;
+                        molecularFormula: string;
+                        unit: string;
+                    }[];
+                }[];
+                dispense: {
+                    quantity: number;
+                    typeOfManureRecyclingProduct: string;
+                    transactionUnit: string;
+                    manureDerivation: {
+                        zoologicalAnimal: string;
+                        percentageAllocation: number;
+                    }[];
+                    ingredient: {
+                        quantity: number;
+                        molecularFormula: string;
+                        unit: string;
+                    }[];
+                }[];
+            };
+            fieldSpreading: {
+                soilPh: number;
+                slurry: {
+                    quantity: number;
+                    dilutionRatio: number;
+                    otherApplicationTechnologies: {
+                        applicationTechnologyType: number;
+                        proportionOfArea: number;
+                    }[];
+                    applicationDuringWarmDays: number;
+                    proportionAppliedSummerMonths: number;
+                    proportionAppliedOtherMonths: number;
+                    proportionAppliedAfter6PM: number;
+                    dragHoseAreaSize: number;
+                };
+                manure: {
+                    applicationIncorporationTime: number;
+                    proportionAppliedSummerMonths: number;
+                    proportionAppliedOtherMonths: number;
+                };
+                fertiliser: {
+                    descriptor: string;
+                    fertiliserProductCategory: string;
+                    quantity: number;
+                    transactionUnit: string;
+                    ingredient: {
+                        molecularFormula: string;
+                        quantity: number;
+                        unit: string;
+                    }[];
+                }[];
+                recycling: {
+                    typeOfManureRecyclingProduct: string;
+                    quantity: number;
+                    transactionUnit: string;
+                    ingredient: {
+                        molecularFormula: string;
+                        quantity: number;
+                        unit: string;
+                    }[];
+                }[];
+            };
+            lifetimePerformance: {
+                milkProductionReport: number;
+            };
+            fodder: {
+                trading: {
+                    supply: {
+                        typeOfFeedstuffProduct: string;
+                        quantity: number;
+                        transactionUnit: string;
+                        ingredient: {
+                            quantity: number;
+                            molecularFormula: string;
+                            unit: string;
+                        }[];
+                    }[];
+                    dispense: {
+                        typeOfFeedstuffProduct: string;
+                        quantity: number;
+                        transactionUnit: string;
+                        ingredient: never[];
+                    }[];
+                };
+                cropFromNonFodderCropland: {
+                    typeOfFeedstuffProduct: string;
+                    quantity: number;
+                    transactionUnit: string;
+                    ingredient: {
+                        quantity: number;
+                        molecularFormula: string;
+                        unit: string;
+                    }[];
+                }[];
+                proportionStorageLoss: number;
+                totalBalanceErrorMargin: number;
+            };
+            fieldCultivation: {
+                buildingZoneAreaSize: number;
+                outdoorVegetableMainCropAreaSize: number;
+                indoorVegetableMainCropAreaSize: number;
+                feedingOfCropHarvest: {
+                    agronomicCropCategory: string;
+                    effectiveYield: number;
+                }[];
+                dispenseOfCropHarvest: {
+                    agronomicCropCategory: string;
+                    effectiveYield: number;
+                }[];
+                fodderCropland: ({
+                    agronomicCropCategory: string;
+                    isMainCrop: boolean;
+                    areaSize: number;
+                    calculateYieldThroughFodderBalance: boolean;
+                    yieldPerSquareMeasure?: undefined;
+                } | {
+                    agronomicCropCategory: string;
+                    isMainCrop: boolean;
+                    areaSize: number;
+                    yieldPerSquareMeasure: number;
+                    calculateYieldThroughFodderBalance?: undefined;
+                })[];
+                arableLand: {
+                    agronomicCropCategory: string;
+                    isMainCrop: boolean;
+                    areaSize: number;
+                    yieldPerSquareMeasure: number;
+                    hasLongTermYieldDivergence: boolean;
+                }[];
+                special: {
+                    agronomicCropCategory: string;
+                    userSpecificPlantName: string;
+                    isMainCrop: boolean;
+                    areaSize: number;
+                    requirementCorrection: {
+                        quantity: number;
+                        molecularFormula: string;
+                        unit: string;
+                    }[];
+                }[];
+            };
+            generateReport: boolean;
+        };
+        calculationVersion: {
+            version: string;
+        };
+    }>;
+    private readonly _lastEmitted;
+    private readonly _dirty;
+    readonly dirty: import("@angular/core").Signal<boolean>;
+    private readonly _calculationMode;
+    readonly calculationMode: import("@angular/core").Signal<CalculationMode>;
+    /**
+     * Set new data value; accepts plain object (already parsed) matching NaebiData shape.
+     * Silent no-op if value is structurally equal after normalization to avoid unnecessary updates.
+     */
+    setData(value: NaebiData): void;
+    /** Mark current data as saved (clears dirty state and updates snapshot). */
+    markSaved(): void;
+    /**
+     * Set calculation mode (SuiBi or ExBi).
+     * Can affect which validation rules are active or which features are enabled.
+     */
+    setCalculationMode(mode: CalculationMode): void;
+    /** Reset to bundled example */
+    reset(): void;
+}
+export {};

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

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

package/dist/types/app/core/events/suibi-data-emitter.service.d.ts

@@ -0,0 +1,13 @@
+import { SuibiDataEventDetail, SuibiDataEventMetadata } from './suibi-data-event';
+/**
+ * Centralizes construction + dispatch of the `suibi-data-emitted` payload so multiple UI entry points can reuse it.
+ */
+export declare class SuibiDataEmitterService {
+    private readonly i18n;
+    private readonly validation;
+    private readonly metadataSvc;
+    private readonly naebi;
+    buildMetadata(): SuibiDataEventMetadata;
+    buildDetail(): SuibiDataEventDetail;
+    emitFrom(target: HTMLElement): void;
+}

package/dist/types/app/core/events/suibi-data-event.d.ts

@@ -0,0 +1,26 @@
+import { Locale } from '../i18n/i18n.service';
+import { NaebiData } from '../data/naebi-data.service';
+import { SuibiMetadata } from '../metadata/suibi-metadata.types';
+/**
+ * Increment when the payload contract changes in a backwards-incompatible way.
+ */
+export declare const SUIBI_DATA_EVENT_VERSION = "suibi-data.v1";
+/** Detail object emitted with the `suibi-data` CustomEvent. */
+export interface SuibiDataEventDetail {
+    version: typeof SUIBI_DATA_EVENT_VERSION;
+    payload: SuibiDataEventPayload;
+}
+/** Top-level payload structure delivered to host applications. */
+export interface SuibiDataEventPayload {
+    metadata: SuibiDataEventMetadata;
+    data: NaebiData;
+}
+/**
+ * Metadata describing the dataset at the moment of emission so hosts can audit and reason about it.
+ */
+export type SuibiDataEventMetadata = SuibiMetadata & {
+    emittedAt: string;
+    locale: Locale;
+    isValid: boolean;
+    errorCount: number;
+};

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

@@ -0,0 +1,20 @@
+import { PipeTransform, Signal } from '@angular/core';
+export type Locale = 'en' | 'de';
+export type JsonFormsTranslator = (key: string, defaultMessage: string | undefined, context: unknown) => string;
+export declare class I18nService {
+    private readonly _locale;
+    locale: Signal<Locale>;
+    private readonly translator;
+    readonly jsonFormsI18n: Signal<{
+        locale: Locale;
+        translate: JsonFormsTranslator;
+    }>;
+    setLocale(locale: Locale): void;
+    t(key: string, defaultMessage?: string): string;
+}
+export declare class TranslatePipe implements PipeTransform {
+    private readonly i18n;
+    private readonly cache;
+    constructor(i18n: I18nService);
+    transform(key: string, defaultMessage?: string): Signal<string>;
+}

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

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

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

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

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

@@ -0,0 +1,32 @@
+import { Locale } from '../i18n/i18n.service';
+/** 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>;
+export type MasterDataKind = keyof typeof MASTER_DATA;
+export declare class MasterDataService {
+    private readonly i18n;
+    private readonly locale;
+    private readonly indices;
+    /** Public lookup of raw master-data entry (typed as any for now). */
+    entry<T = any>(kind: MasterDataKind, id: number | string | null | undefined): T | undefined;
+    /**
+     * Returns the localized designation for a master-data entry by kind and id.
+     * Falls back to 'deu' if not found in the current locale.
+     */
+    designation(kind: MasterDataKind, id: number | string | null | undefined, locale?: Locale): string;
+    resolveAnimalCategory(id: number | string | null | undefined, locale?: Locale): string;
+    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.service.d.ts

@@ -0,0 +1,6 @@
+import { SuibiMetadata } from './suibi-metadata.types';
+export declare class SuibiMetadataService {
+    private readonly metadataSignal;
+    readonly metadata: import("@angular/core").Signal<SuibiMetadata>;
+    setMetadata(next: SuibiMetadata): void;
+}

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

@@ -0,0 +1,8 @@
+export type SuibiVersion = '1.19' | '1.20';
+export type SubmissionStatus = 'draft' | 'submitted' | 'final';
+export interface SuibiMetadata {
+    title: string;
+    suibiVersion: SuibiVersion;
+    status: SubmissionStatus;
+}
+export declare const DEFAULT_SUIBI_METADATA: SuibiMetadata;

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

@@ -0,0 +1,100 @@
+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.
+ * Follows Pinia/Vuex pattern: signals = state, computed = getters, methods = actions.
+ *
+ * Responsibilities:
+ * - Track current page and page-specific context (e.g., selected entity index, active tab)
+ * - Provide navigation actions that update state atomically
+ * - Used by validation system to deep-link users to fields requiring correction
+ *
+ * Pattern for adding new pages:
+ * 1. Add page ID to PageId type
+ * 2. Add page-specific state signals (e.g., selectedStorageIndex)
+ * 3. Add navigation actions (e.g., navigateToStorageDetail)
+ * 4. Update reset logic in resetPageContext()
+ */
+export declare class NavigationService {
+    /** Current active page */
+    readonly currentPage: import("@angular/core").WritableSignal<PageId>;
+    /** Selected animal stock entry index (null = list view) */
+    readonly selectedAnimalStockIndex: import("@angular/core").WritableSignal<number | null>;
+    /**
+     * Generic category (tab) selection: stores current page + selected category key.
+     * Used by categorization renderer for programmatic tab control.
+     * Format: { page: PageId, category: string }
+     */
+    readonly selectedCategory: import("@angular/core").WritableSignal<{
+        page: PageId;
+        category: string;
+    }>;
+    /** Selected farm manure trading detail context (mode + index) */
+    readonly selectedFarmManureTrading: import("@angular/core").WritableSignal<{
+        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) */
+    readonly isAnimalStockPage: import("@angular/core").Signal<boolean>;
+    /**
+     * Navigate to a top-level page. Resets page-specific context.
+     * Use this for simple page switches (e.g., nav menu clicks).
+     */
+    navigateToPage(page: PageId): void;
+    /**
+     * Navigate to animal stock list view (no entry selected).
+     */
+    navigateToAnimalStockList(): void;
+    /**
+     * Navigate to animal stock detail view (specific entry + optional tab).
+     * Used by validation error navigation and internal routing.
+     */
+    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;
+    /**
+     * Reset page-specific context when navigating away.
+     * Prevents stale state (e.g., old selected index) from affecting new page.
+     */
+    private resetPageContext;
+}

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

@@ -0,0 +1,37 @@
+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 _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;
+}