@agridea/suibi-module 0.1.0-preview.8 → 0.1.0-preview.82d9ee0

package/dist/types/app/components/inline-table/inline-table.types.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Type definitions for the generic InlineTableComponent.
+ *
+ * Usage pattern (the "uischema" concept):
+ *   1. Define an `InlineTableConfig` object describing your columns and labels.
+ *   2. Pass it to `<app-inline-table [config]="…" [rows]="…">`.
+ *   3. For business-logic side-effects (e.g. auto-populating fields on selection),
+ *      pass an optional `rowTransform` function — the generic component knows nothing
+ *      about domain rules.
+ *
+ * To reuse the table for a different domain, create a new config file and a thin
+ * wrapper component.  Only the config changes; the rendering component stays the same.
+ */
+import type { BaseCodeListEntry } from '../../jsonforms/shared/option-sources/code-lists';
+/** Supported cell widget types. Extend with new literal types as needed.
+ *  'readonly' renders the resolved value as plain text (no input) — for columns
+ *  that are fully derived from other fields and must not be user-editable.
+ *  'checkbox' renders a boolean mat-checkbox bound to a true/false row field.
+ *  'subrows' renders an expandable editor for a nested list of key/percentage
+ *  pairs (e.g. manureDerivation[]) — see `InlineSubrowsConfig`. */
+export type InlineCellType = 'select' | 'number' | 'text' | 'readonly' | 'checkbox' | 'subrows';
+/**
+ * Per-cell validation resolver — returns a translated error message to display
+ * under the cell, or `null` when the cell is valid. Passed as the `cellError`
+ * input of InlineTableComponent for domain tables that bypass JSONForms/AJV
+ * (inline tables are not schema-validated, so business rules like percentage
+ * caps must be surfaced visually through this hook).
+ */
+export type InlineCellErrorResolver = (row: Record<string, unknown>, col: InlineColumnDef) => string | null;
+/**
+ * Configuration for a `type: 'subrows'` column — an expandable editor for a nested
+ * array of `{ key, value }` entries (e.g. manureDerivation: zoologicalAnimal +
+ * percentageAllocation). The collapsed cell shows a joined summary; expanding it
+ * opens a floating panel with one select + number input per entry, an add button,
+ * and a total indicator (green when the sum matches `expectedTotal`).
+ */
+export interface InlineSubrowsConfig {
+    /** Path to the nested array on the row object (e.g. `'manureDerivation'`). */
+    arrayPath: string;
+    /** Field holding the code-list key in each sub-entry (e.g. `'zoologicalAnimal'`). */
+    keyField: string;
+    /** Key into the shared `CODE_LISTS` map for the key select options. */
+    keyCodeListKey: string;
+    /** i18n key for the key sub-column header inside the panel. */
+    keyLabelKey: string;
+    /** Field holding the numeric share in each sub-entry (e.g. `'percentageAllocation'`). */
+    valueField: string;
+    /** i18n key for the value sub-column header inside the panel. */
+    valueLabelKey: string;
+    /** i18n key for the "add sub-entry" button label. */
+    addLabelKey: string;
+    /** i18n key for the expand toggle label (collapsed state). */
+    expandLabelKey: string;
+    /** i18n key for the collapse toggle label (expanded state). */
+    collapseLabelKey: string;
+    /** i18n key for the total indicator label. */
+    totalLabelKey: string;
+    /** Expected sum of the value fields (e.g. 100) — the indicator turns green on exact
+     *  match (no more, no less) and entered values are clamped so the sum never exceeds it. */
+    expectedTotal?: number;
+    /** Min for the value number input (default 0). */
+    valueMin?: number;
+    /** Max for the value number input (default: none). */
+    valueMax?: number;
+}
+/**
+ * Definition for a single column in an inline table.
+ *
+ * Each definition drives both the column header and the cell widget for that column.
+ * This is the per-column equivalent of a JSONForms uischema Control element.
+ */
+export interface InlineColumnDef {
+    /**
+     * Unique key for this column.
+     * - For simple flat fields: also the property path on the row object.
+     * - For nested sub-array columns: used as a stable identifier; actual read/write
+     *   path is determined by `arrayPath` + `arrayKeyField` + `arrayKeyValue`.
+     */
+    key: string;
+    /**
+     * Header label source.
+     * - By default treated as an i18n translation key (e.g. `'fieldSpreading.fields.fertiliser.product'`).
+     * - Set `labelLiteral: true` to use the value verbatim (e.g. `'Ntot (%)'`).
+     */
+    labelKey: string;
+    /**
+     * When `true`, `labelKey` is rendered as a plain string rather than passed through
+     * the translation service.  Use this for labels that are already final (e.g. chemical
+     * formulas such as "P₂O₅ (%)").
+     * Default: `false`.
+     */
+    labelLiteral?: boolean;
+    /** Widget rendered inside the cell. */
+    type: InlineCellType;
+    /**
+     * For `type: 'select'` — key into the shared `CODE_LISTS` map.
+     * The generic component resolves the option list and their localized labels
+     * automatically via the `descriptor.designation_eng / designation_deu` convention.
+     */
+    codeListKey?: string;
+    /**
+     * For `type: 'select'` — how to display an option's label in the dropdown.
+     * - `'label'` (default): use `descriptor.designation_eng/deu` — best for named products.
+     * - `'id'`: use `String(entry.id)` verbatim — best for codes that are already
+     *   human-readable (e.g. unit codes like "kg", "t", "l").
+     */
+    optionDisplay?: 'label' | 'id';
+    /**
+     * For `type: 'select'` — optional per-row narrowing of the code-list options,
+     * e.g. to restrict the product list based on another cell of the same row.
+     * Evaluated for every option of every row, so keep it cheap.
+     */
+    optionsFilter?: (entry: BaseCodeListEntry, row: Record<string, unknown>) => boolean;
+    /**
+     * For `type: 'select'` — resolve an option's label through an i18n key instead of the
+     * master-data descriptor (for literal option lists whose labels live in the locales,
+     * e.g. a row-type selector). Takes precedence over `optionDisplay`.
+     */
+    optionLabelKey?: (entry: BaseCodeListEntry) => string;
+    /**
+     * Optional i18n key for an explanatory tooltip shown via an info icon next to
+     * the column header (e.g. to explain a checkbox whose effect is not obvious).
+     * Omit for columns that need no extra explanation.
+     */
+    tooltipKey?: string;
+    /**
+     * CSS grid column-sizing token, e.g. `'minmax(140px, 2fr)'` or `'84px'`.
+     * These values are joined to build the `grid-template-columns` style on the table.
+     * Defaults to `'1fr'` when omitted.
+     */
+    width?: string;
+    /** Minimum allowed value — sets the `min` attribute (type `'number'` only). */
+    min?: number;
+    /** Maximum allowed value — sets the `max` attribute (type `'number'` only). */
+    max?: number;
+    /**
+     * `step` attribute value (type `'number'` only).
+     * Defaults to `'any'` when omitted, allowing any decimal.
+     */
+    step?: string;
+    /**
+     * Custom cell-value resolver — takes precedence over the default read path.
+     * Use this for `type: 'readonly'` columns whose value is derived from master
+     * data or other cells (e.g. a standard yield looked up from the selected crop)
+     * and therefore does not live on the row object.
+     */
+    valueResolver?: (row: Record<string, unknown>) => unknown;
+    /**
+     * Per-row disabling of the cell widget (e.g. grey out the yield input when the
+     * selected crop does not permit yield input). Evaluated per row, keep it cheap.
+     */
+    disabledForRow?: (row: Record<string, unknown>) => boolean;
+    /**
+     * Sub-array navigation config — for columns whose value lives inside a nested array
+     * on the row object (e.g. `ingredient[].quantity`).
+     *
+     * When all four sub-fields are set, the component:
+     *   - **reads** `row[arrayPath].find(e => e[arrayKeyField] === arrayKeyValue)[arrayValueField]`
+     *   - **writes** back immutably into that same slot
+     *
+     * Example — "Ntot %" column that reads `row.ingredient[{molecularFormula:'Ntot'}].quantity`:
+     * ```
+     * arrayPath:       'ingredient'
+     * arrayKeyField:   'molecularFormula'
+     * arrayKeyValue:   'Ntot'
+     * arrayValueField: 'quantity'
+     * ```
+     */
+    arrayPath?: string;
+    arrayKeyField?: string;
+    arrayKeyValue?: string;
+    arrayValueField?: string;
+    /**
+     * Sub-rows editor config — required when `type: 'subrows'`, ignored otherwise.
+     * Drives the expandable key/percentage pair editor (see `InlineSubrowsConfig`).
+     */
+    subrows?: InlineSubrowsConfig;
+}
+/**
+ * Full configuration for one inline-table instance — the "uischema" equivalent.
+ *
+ * Creating a table for a new domain means defining one `InlineTableConfig` object
+ * (and an optional `rowTransform` for business logic); the generic component handles
+ * all layout, rendering, and data binding.
+ */
+export interface InlineTableConfig {
+    /** Ordered list of column definitions — determines column count and order. */
+    columns: InlineColumnDef[];
+    /** i18n key for the section heading (`<h2>`). */
+    titleKey: string;
+    /**
+     * i18n key for the section description paragraph.
+     * Omit (or set to `undefined`) to hide the description.
+     */
+    descriptionKey?: string;
+    /** i18n key for the "Add entry" dashed-button label. */
+    addLabelKey: string;
+    /** i18n key for the empty-state primary text (shown when `rows` is empty). */
+    emptyLabelKey: string;
+    /**
+     * i18n key for the empty-state hint text (secondary line).
+     * Omit to show only the primary text.
+     */
+    emptyHintKey?: string;
+    /**
+     * Factory function invoked when the user clicks "Add entry".
+     * Should return a fresh row object with sensible defaults (e.g. pre-initialised
+     * sub-arrays such as `ingredient`).
+     * Defaults to `() => ({})` when omitted.
+     */
+    createRow?: () => Record<string, unknown>;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Generic page wrapper for workflow steps that are present in navigation but not implemented yet.
+ */
+export declare class ModulePlaceholderPageComponent {
+    readonly titleKey: import("@angular/core").InputSignal<string>;
+}

package/dist/types/app/components/planning-result/planning-result.component.d.ts

@@ -0,0 +1,46 @@
+import { PlanningBalanceService } from '../../core/planning/planning-balance.service';
+import { MasterDataService } from '../../core/master-data/master-data.service';
+import type { CropRequirementRow, NutrientEntry, ValidationMessage } from '../../core/planning/planning-balance.types';
+export declare class PlanningResultComponent {
+    readonly embedded: import("@angular/core").InputSignal<boolean>;
+    readonly planning: PlanningBalanceService;
+    readonly masterData: MasterDataService;
+    private readonly result;
+    readonly validationMessages: import("@angular/core").Signal<ValidationMessage[]>;
+    /** Fodder net balance (positive = surplus, negative = deficit). */
+    readonly fodderTotal: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").FodderQuantity | null>;
+    readonly animalStockTotals: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").AnimalStock | null>;
+    /** Housing-type segments for the A2 table, pre-built to avoid dynamic key access in template. */
+    readonly animalStockSegments: import("@angular/core").Signal<{
+        label: string;
+        data: import("../../core/planning/planning-balance.types").TotalNutrientSet;
+    }[]>;
+    /** A3 equivalent: manure trading balance per product. */
+    readonly manureTradingBalance: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").FarmManureTrading | null>;
+    /** A4 equivalent: manure storage totals. */
+    readonly storageBalance: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").TotalNutrientSet | null>;
+    /** A5 equivalent: field spreading totals for key nutrients. */
+    readonly fieldSpreadingBalance: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").TotalNutrientSet | null>;
+    readonly requirementPerCultivationCategory: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").NutrientRequirementEntry[]>;
+    readonly totalRequirement: import("@angular/core").Signal<NutrientEntry[]>;
+    /**
+     * Merge area/yield data from fieldCultivation with nutrient requirements so
+     * each row has everything needed to display Section C of the PDF report.
+     */
+    readonly cropRequirementRows: import("@angular/core").Signal<CropRequirementRow[]>;
+    readonly fodderDetail: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").RequiredEffectiveYieldFromFodderCropland | null>;
+    readonly fodderEffectiveYield: import("@angular/core").Signal<import("../../core/planning/planning-balance.types").FodderQuantity | null>;
+    /** Human-readable label for a molecular formula symbol. */
+    formulaLabel(f: string): string;
+    /** Returns the quantity for a given formula from a nutrient entry list, or 0 if absent. */
+    reqValue(requirement: NutrientEntry[], formula: string): number;
+    /**
+     * Sums entries by formula for the given ordered formula list (kg unit only).
+     * Multiple per-product rows with the same formula are aggregated into one.
+     */
+    sumNutrients(entries: NutrientEntry[], formulas: readonly string[]): NutrientEntry[];
+    /** Summary chips for Sections A1–A5 (Ntot / P₂O₅ / K₂O / Mg). */
+    sumStockNutrients(entries: NutrientEntry[]): NutrientEntry[];
+    /** Summary chips for Sections C & D (N avail. / P₂O₅ / K₂O / Mg). */
+    sumKeyNutrients(entries: NutrientEntry[]): NutrientEntry[];
+}

package/dist/types/app/components/planning-result-row/planning-result-row.component.d.ts

@@ -0,0 +1,34 @@
+import { SuisseBilanzMetricsService } from '../suissebilanz-dashboard/suissebilanz-metrics.service';
+import { GaugeStatus } from '../gauge-arc/gauge-arc.component';
+/** Compact row + expandable detail for the latest planning-balance result. */
+export declare class PlanningResultRowComponent {
+    protected readonly STATUS_ICONS: Record<GaugeStatus, string>;
+    private readonly planning;
+    private readonly naebi;
+    private readonly metadataSvc;
+    protected readonly metricsService: SuisseBilanzMetricsService;
+    protected readonly expanded: import("@angular/core").WritableSignal<boolean>;
+    protected readonly isLoading: import("@angular/core").Signal<boolean>;
+    protected readonly hasResult: import("@angular/core").Signal<boolean>;
+    protected readonly title: import("@angular/core").Signal<string>;
+    private readonly result;
+    /** Derived overall status: worst status across all nutrient metrics. */
+    protected readonly overallStatus: import("@angular/core").Signal<GaugeStatus>;
+    /** Compact chips for the 4 nutrient metrics + rendement, with kg values merged in. */
+    protected readonly nutrientChips: import("@angular/core").Signal<{
+        key: string;
+        label: string;
+        pct: number | null;
+        kg: number | null;
+        dt: number | null;
+        status: GaugeStatus;
+    }[]>;
+    /** Areas in ha (converted from m²). */
+    protected readonly areas: import("@angular/core").Signal<{
+        sau: number;
+        sfe: number;
+        to: number;
+    } | null>;
+    protected refresh(): void;
+    protected toggleDetail(): void;
+}

package/dist/types/app/components/planning-trigger/planning-trigger.component.d.ts

@@ -0,0 +1,13 @@
+import { PlanningBalanceService } from '../../core/planning/planning-balance.service';
+/**
+ * Extracted trigger UI for running the planning balance calculation.
+ * Contains: submit button and progress bar.
+ * Delegates actual HTTP call to `PlanningBalanceService`.
+ */
+export declare class PlanningTriggerComponent {
+    readonly planning: PlanningBalanceService;
+    private readonly naebi;
+    /** When true, the submit button is disabled regardless of loading state. */
+    readonly hasErrors: import("@angular/core").InputSignal<boolean>;
+    runPlanning(): void;
+}

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

@@ -0,0 +1,13 @@
+import { ErrorObject } from 'ajv';
+import { PageId } from '../../core/navigation/navigation.service';
+import { PlanningBalanceService } from '../../core/planning/planning-balance.service';
+export declare class ResultsPageComponent {
+    readonly currentPage: import("@angular/core").InputSignal<PageId>;
+    readonly onNavigate: import("@angular/core").InputSignal<(page: PageId) => void>;
+    readonly onErrorSelected: import("@angular/core").InputSignal<(error: ErrorObject) => void>;
+    readonly onSubmitSuccess: import("@angular/core").InputSignal<() => void>;
+    protected readonly planning: PlanningBalanceService;
+    protected readonly selectedTabIndex: import("@angular/core").WritableSignal<number>;
+    constructor();
+    protected onTabChange(index: number): void;
+}

package/dist/types/app/components/suissebilanz-dashboard/suissebilanz-dashboard.component.d.ts

@@ -0,0 +1,32 @@
+import { SafeUrl } from '@angular/platform-browser';
+import { PlanningBalanceService } from '../../core/planning/planning-balance.service';
+import { GaugeStatus } from '../gauge-arc/gauge-arc.component';
+import { SuisseBilanzMetricsService } from './suissebilanz-metrics.service';
+/**
+ * Dashboard card displaying the 5 main SuisseBilanz metrics as semicircular
+ * SVG gauges. Derives all display data from `PlanningBalanceService` via
+ * computed signals — fully zoneless-safe, `OnPush`.
+ *
+ * Shows an empty-state panel when no planning result is available yet.
+ */
+export declare class SuisseBilanzDashboardComponent {
+    readonly embedded: import("@angular/core").InputSignal<boolean>;
+    /** Shows the official PDF download link even when `embedded` (header hidden). */
+    readonly showPdfButton: import("@angular/core").InputSignal<boolean>;
+    protected readonly planning: PlanningBalanceService;
+    private readonly sanitizer;
+    protected readonly metricsService: SuisseBilanzMetricsService;
+    private readonly result;
+    protected readonly metrics: import("@angular/core").Signal<import("../gauge-arc/gauge-arc.component").GaugeMetric[]>;
+    /** Surface areas in ha, derived from the latest planning result. */
+    protected readonly surfaces: import("@angular/core").Signal<{
+        sau: number;
+        sfe: number;
+        to: number;
+    } | null>;
+    protected readonly officialPdfUrl: import("@angular/core").Signal<SafeUrl | null>;
+    private prevBlobUrl;
+    private readonly blobCleanup;
+    /** Maps a `GaugeStatus` to its Material icon name for the status badge. */
+    protected statusIcon(status: GaugeStatus): string;
+}

package/dist/types/app/components/suissebilanz-dashboard/suissebilanz-metrics.service.d.ts

@@ -0,0 +1,21 @@
+import { GaugeMetric } from '../gauge-arc/gauge-arc.component';
+/**
+ * Shared source of truth for all SuisseBilanz metric view-models.
+ *
+ * Both the full dashboard card and the slim minibar consume this service so
+ * the derivation logic lives in exactly one place. Metrics re-compute via
+ * `computed()` when either the planning result or the locale signal changes.
+ */
+export declare class SuisseBilanzMetricsService {
+    private readonly planning;
+    private readonly i18n;
+    /** Wall-clock time of the most recent successful planning result. */
+    readonly lastUpdated: import("@angular/core").WritableSignal<Date | null>;
+    constructor();
+    /**
+     * Five gauge view-models for N avail., P₂O₅, K₂O, Mg and Rendement prairies.
+     * Returns placeholder 'empty' metrics until the first planning result arrives.
+     */
+    readonly metrics: import("@angular/core").Signal<GaugeMetric[]>;
+    private emptyMetric;
+}

package/dist/types/app/components/suissebilanz-minibar/suissebilanz-minibar.component.d.ts

@@ -0,0 +1,19 @@
+import { GaugeMetric, GaugeStatus } from '../gauge-arc/gauge-arc.component';
+import { SuisseBilanzMetricsService } from '../suissebilanz-dashboard/suissebilanz-metrics.service';
+/**
+ * Slim, always-visible metrics card placed above the workflow stepper.
+ *
+ * Shows the same 5 SuisseBilanz metrics as the full dashboard card but in a
+ * compact single-row layout: metric label → bold coloured value → thin
+ * progress bar. Shares all data logic via `SuisseBilanzMetricsService`.
+ */
+export declare class SuisseBilanzMinibarComponent {
+    protected readonly metricsService: SuisseBilanzMetricsService;
+    /** Returns the status colour for a given metric status. */
+    protected statusColor(status: GaugeStatus): string;
+    /**
+     * Maps the metric value to a 0–100 fill percentage for the progress bar,
+     * clamped so bars never overflow the track.
+     */
+    protected fillPct(metric: GaugeMetric): number;
+}

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

@@ -0,0 +1 @@
+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

@@ -0,0 +1,30 @@
+import { JsonSchema, UISchemaElement } from '@jsonforms/core';
+import { SuibiMetadata } from '../../core/metadata/suibi-metadata.types';
+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;
+    private readonly baseUiSchema;
+    readonly suibiAjv: import("ajv").Ajv;
+    readonly renderers: {
+        tester: import("@jsonforms/core").RankedTester;
+        renderer: any;
+    }[];
+    readonly metadata: import("@angular/core").Signal<SuibiMetadata>;
+    readonly localizedSchema: import("@angular/core").Signal<JsonSchema>;
+    readonly localizedUi: import("@angular/core").Signal<UISchemaElement>;
+    readonly jsonFormsData: import("@angular/core").Signal<{}>;
+    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;
+}