Metadata supplier interfaces

These lightweight interfaces let you provide page metadata (title, subtitle, browser title, banners, badges) dynamically at runtime instead of hardcoding them with annotations.

---

BannerSupplier

Provides page banners dynamically. Banners appear below the page header and above the first form section, rendered as highlighted message cards.

BannerSupplier takes precedence over @Banner-annotated methods when both are present.

public interface BannerSupplier {
    List<PageBanner> banners();
}

Usage

@UI("/dashboard")
public class DashboardPage implements BannerSupplier {

    @Override
    public List<PageBanner> banners() {
        List<PageBanner> result = new ArrayList<>();
        if (maintenanceScheduled) {
            result.add(new PageBanner(BannerTheme.WARNING,
                "Scheduled maintenance",
                "The system will be unavailable Sunday 02:00–04:00 UTC."));
        }
        if (degradedMode) {
            result.add(new PageBanner(BannerTheme.DANGER,
                "Degraded mode",
                "Some features may not respond.",
                true,  // closeable
                0));   // no auto-dismiss
        }
        return result;
    }
}

PageBanner convenience constructor: new PageBanner(BannerTheme, String title, String description) — closeable defaults to false and timeoutSeconds to 0.

---

BadgeSupplier

Provides page-header status chips dynamically. Badges appear in the page header strip alongside the title — useful for status flags that depend on data loaded at render time.

BadgeSupplier takes precedence over @BadgeInHeader-annotated fields when both are present.

public interface BadgeSupplier {
    List<Badge> badges();
}

Usage

@UI("/booking/:id")
public class BookingDetailPage implements BadgeSupplier {

    String status;

    @Override
    public List<Badge> badges() {
        return switch (status) {
            case "CONFIRMED" -> List.of(Badge.builder()
                .text("Confirmed").color(BadgeColor.success.name())
                .pill(true).build());
            case "CANCELLED" -> List.of(Badge.builder()
                .text("Cancelled").color(BadgeColor.error.name())
                .pill(true).build());
            default -> List.of();
        };
    }
}

Badge is a fluent builder record — see the Badge component reference for all options.

---

TitleSupplier

Provides the page title dynamically.

public interface TitleSupplier {
    String title();
}

Usage

@Route("/customers/{id}")
public class CustomerDetailPage implements ComponentTreeSupplier, TitleSupplier {

    private final CustomerRepository repo;

    @Override
    public Component component(HttpRequest httpRequest) {
        var id = httpRequest.lastPathItem();
        return Form.builder().title(title()).build();
    }

    @Override
    public String title() {
        return "Customer detail";
    }
}

---

SubtitleSupplier

Provides the page subtitle dynamically.

public interface SubtitleSupplier {
    String subtitle();
}

Usage

@Route("/report")
public class ReportPage implements ComponentTreeSupplier, SubtitleSupplier {

    @Override
    public Component component(HttpRequest httpRequest) {
        return Form.builder().title("Report").subtitle(subtitle()).build();
    }

    @Override
    public String subtitle() {
        return "Generated on " + LocalDate.now();
    }
}

---

ValidationSupplier

Provides cross-field validations programmatically — an alternative to the @Validation annotation for dynamic validation logic.

public interface ValidationSupplier {
    List<Validation> validations();
}

Usage

public class BookingForm implements ValidationSupplier {
    LocalDate startDate;
    LocalDate endDate;

    @Override
    public List<Validation> validations() {
        return List.of(
            new Validation("startDate > endDate", "endDate", "End date must be after start date")
        );
    }
}

---

RuleSupplier

Provides conditional UI rules programmatically — an alternative to the @Rule annotation.

public interface RuleSupplier {
    List<Rule> rules();
}

Usage

public class AccountForm implements RuleSupplier {
    String accountType;
    String vatNumber;

    @Override
    public List<Rule> rules() {
        return List.of(
            Rule.builder()
                .filter("accountType == 'BUSINESS'")
                .action(RuleAction.set)
                .fieldName("vatNumber")
                .fieldAttribute(RuleFieldAttribute.visible)
                .value("true")
                .build()
        );
    }
}

---

DataSupplier

Provides arbitrary data to the component on each render cycle.

public interface DataSupplier {
    Object data(HttpRequest httpRequest);
}

Usage

@Route("/summary")
public class SummaryPage implements ComponentTreeSupplier, DataSupplier {

    @Override
    public Component component(HttpRequest httpRequest) {
        return Form.builder().title("Summary").build();
    }

    @Override
    public Object data(HttpRequest httpRequest) {
        return Map.of("totalRevenue", revenueService.getTotal());
    }
}

---

CommandSupplier

Provides a list of UICommand objects that the client executes after rendering.

public interface CommandSupplier {
    List<UICommand> commands(HttpRequest httpRequest);
}

Usage

@Route("/setup")
public class SetupPage implements ComponentTreeSupplier, CommandSupplier {

    @Override
    public Component component(HttpRequest httpRequest) {
        return new Text("Setting up...");
    }

    @Override
    public List<UICommand> commands(HttpRequest httpRequest) {
        return List.of(new UICommand("navigate", "/dashboard"));
    }
}

---

PostHydrationHandler

Called by Mateu after it re-hydrates the component state from the client. Use it to perform side effects or load data after the state has been populated.

public interface PostHydrationHandler {
    void onHydrated(HttpRequest httpRequest);
}

Usage

public class OrderForm implements PostHydrationHandler {
    String orderId;
    String status;

    @Override
    public void onHydrated(HttpRequest httpRequest) {
        // called after orderId/status have been populated from the client state
        auditService.log("Order form loaded: " + orderId);
    }
}