Guler.Editor.Premium.Tables 0.2.0-alpha.0

Stylus.Premium.Tables

Stylus editör için tablo araçları premium paketi. ADR-012 implementasyonu.

⚠️ Ticari lisans gereklidir. Trial mode (30 gün) varsayılan.

⚠️ Backend-only Sprint 5 alpha — frontend formula bar / cell type dropdown UI Faz 5'te.

Özellikler (alpha)

Kurulum

builder.Services.AddStylus();
builder.Services.AddStylusPremium(license: builder.Configuration["Stylus:LicenseKey"]);
builder.Services.AddStylusTables(opts =>
{
    opts.MaxRangeCells = 100_000;        // DOS guard default
    opts.MaxParseDepth = 32;             // nested function bombing guard
    opts.EvaluationTimeoutMs = 1000;     // runaway formula guard
});

Formula Evaluator kullanımı

public class ReportController(IStylusTableFormulaEvaluator eval) : ControllerBase
{
    [HttpPost("/api/report/sum")]
    public IActionResult Sum([FromBody] SumRequest req)
    {
        var table = AngleSharpTableData.Parse(req.TableHtml);
        var result = eval.Evaluate(req.Formula, table);
        return result.Success
            ? Ok(new { value = result.Value })
            : BadRequest(new { error = result.ErrorMessage, position = result.ErrorPosition });
    }
}

Serializer kullanımı

public class ExportController(IStylusTableSerializer serializer) : ControllerBase
{
    [HttpPost("/api/export/csv")]
    public IActionResult Csv([FromBody] ExportRequest req)
    {
        var csv = serializer.ToCsv(req.TableHtml, new CsvOptions
        {
            Delimiter = ';',
            Culture = new CultureInfo("tr-TR"),  // Excel TR uyumu
            IncludeHeader = true,
        });
        return File(Encoding.UTF8.GetBytes(csv), "text/csv", "rapor.csv");
    }
}

Aggregator kullanımı

var stats = aggregator.ComputeColumnAggregates(
    tableHtml,
    columnIndices: new[] { 1, 2, 3 },     // 0-tabanlı sütun index'leri
    function: AggregateFunction.Sum);

foreach (var col in stats.Columns)
    Console.WriteLine($"Sütun {col.ColumnIndex}: {col.Value} ({col.SampleCount} hücre)");

Locale uyarısı (önemli)

Hücre değerleri için InvariantCulture format (1234.56) önerilir. tr-TR formatı (1.234,56) tolerant parse edilir. Belirsiz string'ler InvariantCulture lehine yorumlanır:

docs/tr/premium-tables.md'de detaylı belgelendirme var.

DOS Guard'lar

Sınırlamalar (alpha)

• 5 fonksiyon (SUM/AVERAGE/COUNT/MAX/MIN); IF/AND/OR/VLOOKUP Faz 5
• Excel-style cell ref A-Z (26 sütun); çok-harfli (AA, AB...) Faz 5
• 1-tabanlı satır numarası (Excel ile uyum)
• Frontend formula bar UI yok (Sub-faz Faz 5 başında)
• Cell type validation (text/number/date) yok — null dönerse hücre atılır, SampleCount düşer
• XLSX export yok (Faz 5 yan paket: Stylus.Premium.Tables.Xlsx)
• Async API yok (Faz 5 EvaluateAsync additive)

İlgili kaynaklar

• ADR-012: decisions/ADR-012-table-formula-engine.md
• Research: research/dotnet-formula-evaluators.md