Guler.Editor.AspNetCore 0.2.0-alpha.0

Stylus.AspNetCore

ASP.NET Core (.NET 8+) için Stylus editör + dosya yöneticisi paketi.

Stylus.Core üstüne inşa edilmiştir. Razor TagHelper, Minimal API endpoint'leri, IHttpContextAccessor tabanlı authorization, RCL Static Web Assets ile JS/CSS asset servisi.

Hızlı başlangıç

dotnet add package Stylus.AspNetCore

// Program.cs
using Stylus.AspNetCore.Extensions;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRazorPages();
builder.Services.AddStylus(opts =>
{
    opts.RootDirectory = "stylus-uploads"; // wwwroot altına relative
    opts.AllowedExtensions = new[] { ".jpg", ".png", ".pdf" };
});

var app = builder.Build();
app.UseStaticFiles();
app.UseAuthentication();
app.UseAuthorization();
app.MapRazorPages();
app.MapStylusFileManager(); // /_stylus/files altında 7 endpoint
app.Run();

@* Pages/Index.cshtml *@
@addTagHelper *, Stylus.AspNetCore

<form method="post">
    <stylus-editor id="editor" name="Article" value="@Model.Article.Html" />
    <button type="submit">Kaydet</button>
</form>

// Pages/Index.cshtml.cs
using Stylus.Core.Sanitization;

public class IndexModel : PageModel
{
    private readonly IStylusSanitizer _sanitizer;
    public IndexModel(IStylusSanitizer sanitizer) => _sanitizer = sanitizer;

    [BindProperty] public ArticleModel Article { get; set; } = new();

    public IActionResult OnPost()
    {
        Article.Html = _sanitizer.Sanitize(Article.Html); // XSS savunma
        // ... DB'ye yaz
        return RedirectToPage();
    }
}

public class ArticleModel
{
    public string Html { get; set; } = "";
    public string Json { get; set; } = "";
}

TagHelper attribute'ları

<stylus-editor> etiketine destekli:

Feature seti

• Editör: bold/italic/underline/strike/H1-H3/paragraph/bullet-list/ordered-list/blockquote/link/image/embed/source-view
• Slash menu (Notion-style /)
• Türkçe arayüz (i18n: TR + EN, override edilebilir)
• Custom prompt/confirm modallar (focus trap + Esc/Enter + a11y)
• Drag-drop image upload (file manager backend ile)
• Server-side thumbnail (/thumb endpoint, SkiaSharp downscale)
• Paste-from-Word HTML cleanup
• Backend XSS sanitize (IStylusSanitizer + Stylus schema whitelist)

Authorization + tenant isolation

Default IStylusAuthorizationContext HttpContext.User.NameIdentifier claim'inden tenant scope üretir (u-{userId} prefix). Tüm storage operasyonları otomatik bu scope'a kapatılır — multi-tenant SaaS hazır.

builder.Services.AddStylus(
    fm => fm.RootDirectory = "uploads",
    auth =>
    {
        auth.TenantClaimType = "tenant_id"; // custom claim
        auth.TenantPrefix = "tenant-";
    });

Tüketici kendi IStylusAuthorizationContext impl'ini register edebilir (role-based, klasör pattern, owner check vs).

Bağımlılıklar

• Stylus.Core (≥ 0.1.0-alpha.0)
• SkiaSharp.NativeAssets.Linux (Linux container deploy için)

Lisans

MIT — Stylus open core taahhüdü.

Faz 2 alpha durumu

Bu paket Faz 2 alpha sürümündedir. Bir gerçek müşteri projesinde 2 hafta sorunsuz production deployment Faz 3'e geçiş kriteri.