Modrich.Sdk.Web 0.1.0

Modrich.Sdk.Web

Meta-package for .Web (Razor Class Library) module projects in the Modrich modular foundation for .NET 10. Contains no types — it exists to bundle the Tier 1 references a UI module needs without dragging EF Core into the transitive closure.

What it pulls in

• Modrich.Abstractions — IModule, IAppModule, layout slots (LayoutSections, IModuleLayoutWidget).
• Gatekeep.Authorization.Abstractions — IPermissionCatalog, PermissionConstants, etc.
• Modrich.Web — host-side web helpers, including CookieForwardingHandler (namespace Modrich.Web.Authorization).
• Modrich.Navigation.Abstractions — IMainMenuProvider, IModuleMenuProvider, JsonModuleMenuProvider, NavItem, MenuItem.

Compare to Modrich.Sdk.Api: that one pulls in API-side abstractions for backend modules. This one is for the .Web (RCL) project that owns Razor components, menus, and UI-side DI.

Install

dotnet add package Modrich.Sdk.Web

In your module's RCL csproj:

<Project Sdk="Microsoft.NET.Sdk.Razor">
  <ItemGroup>
    <PackageReference Include="Modrich.Sdk.Web" />
  </ItemGroup>
</Project>

Usage — the App module

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Routing;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Modrich.Layout;
using Modrich.Modules;
using Modrich.Navigation;

[assembly: ModuleAssembly]

namespace Acme.Orders.Web;

public sealed class OrdersAppModule : IAppModule
{
    public string Name => "Orders";

    public void RegisterAppDependencies(IServiceCollection services, IConfiguration configuration, string? apiBaseUrl = null)
    {
        services.AddSingleton<IMainMenuProvider, OrdersMainMenuProvider>();

        services.AddSingleton<IModuleMenuProvider>(_ =>
            JsonModuleMenuProvider.FromEmbeddedResource(
                routePrefix:  "orders",
                resourceType: typeof(Resources.Strings),
                assembly:     typeof(OrdersAppModule).Assembly,
                resourceName: "Acme.Orders.Web.menu.json"));

        services.AddSingleton<IModuleLayoutWidget>(new ModuleLayoutWidget(typeof(Components.OrdersFooterBadge)));
    }

    public void ConfigureAppPipeline(WebApplication app) { /* optional */ }

    public void MapAppEndpoints(IEndpointRouteBuilder endpoints) { /* optional */ }
}

Usage — slotting UI into the host shell

A layout widget targets a named region:

@* Components/OrdersFooterBadge.razor *@
<SectionContent SectionName="@LayoutSections.Footer">
    <span>Orders module v@(Version)</span>
</SectionContent>

Available slots:

• LayoutSections.TopLeft
• LayoutSections.TopRight
• LayoutSections.SidebarTop
• LayoutSections.SidebarBottom
• LayoutSections.Footer

Related packages

• Modrich.Sdk.Api — meta-package for API/backend modules.
• Modrich.Navigation.Abstractions — menu types this package re-exposes.
• Modrich.Modularity — host-side; not for modules.

Versioning

Pinned to the same major as the underlying Tier 1 packages.

License

MIT.