Pretext.Uno 0.1.0-preview.1

Pretext

Universal text preparation and line layout for any SkiaSharp-based UI, with grapheme-aware wrapping, locale-aware segmentation, bidi support, and streaming line walking.

PretextSharp is a .NET/C# port of the original pretext project by Cheng Lou.

Documentation site: wieslawsoltes.github.io/PretextSharp

Key documentation:

• Getting Started Overview
• Quickstart: Prepare and Layout
• Choosing an API
• Prepared Text Lifecycle
• Public Types and Operations
• Pretext.Uno Helpers

NuGet Packages

Package Name	NuGet	Downloads	Description
Pretext			Universal text preparation and line layout engine for any SkiaSharp-based UI.
Pretext.Uno			Uno-specific controls and obstacle-aware layout helpers built on top of Pretext.

Features

• Prepare text once and reuse the result across repeated layout passes with Prepare and PrepareWithSegments.
• Compute fast aggregate metrics with Layout, or materialize full line data with LayoutWithLines.
• Stream line geometry incrementally with LayoutNextLine and WalkLineRanges for custom layout engines.
• Handle ordinary spaces, preserved spaces, tabs, hard breaks, non-breaking spaces, zero-width breaks, and soft hyphens.
• Support multilingual text with locale-aware segmentation on desktop targets and bidi-aware segment levels.
• Depend only on SkiaSharp in the core library so the package can be used outside Uno as well.
• Ship with a published Pretext.Uno companion library for reusable Uno host controls and obstacle-aware flow helpers.
• Ship with deterministic parity tests and a Uno sample app that demonstrates bubbles, masonry, editorial, and justification layouts.

Core API

API Selection

Quick Start

Install from NuGet:

dotnet add package Pretext

Then prepare and lay out text:

using Pretext;

const string text = "Hello soft\u00ADwrapped world";
const string font = "16px Inter";
const double lineHeight = 20;

var prepared = PretextLayout.PrepareWithSegments(text, font);
var metrics = PretextLayout.Layout(prepared, maxWidth: 160, lineHeight);
var lines = PretextLayout.LayoutWithLines(prepared, maxWidth: 160, lineHeight);

Console.WriteLine(metrics.LineCount);
Console.WriteLine(metrics.Height);

foreach (var line in lines.Lines)
{
    Console.WriteLine($"{line.Text} ({line.Width})");
}

The core package exposes the Pretext namespace and is not tied to Uno. Use it anywhere you use SkiaSharp.

The font argument is a CSS-like subset such as 16px Inter, italic 16px Georgia, or 700 18px "IBM Plex Sans". Line height is supplied separately to layout calls.

Use WhiteSpaceMode.PreWrap when your layout needs preserved spaces, tabs, or hard breaks:

var prepared = PretextLayout.PrepareWithSegments(
    "foo\tbar\nbaz",
    "16px Inter",
    new PrepareOptions(WhiteSpaceMode.PreWrap));

Uno Companion

Install the Uno companion package when you want the reusable Uno-specific helpers on top of the core engine:

dotnet add package Pretext.Uno

It brings the Pretext core package transitively and exposes:

• Pretext.PretextLayout
• Pretext.Uno.Controls.StretchScrollHost
• Pretext.Uno.Controls.UiRenderScheduler
• Pretext.Uno.Layout.PreparedTextMetrics
• Pretext.Uno.Layout.ColumnFlowLayout
• Pretext.Uno.Layout.ObstacleLayoutHelper

Sample App

The sample app lives in samples/PretextSamples and demonstrates the library in visually different layouts. It uses Uno Platform, exercises the core Pretext APIs together with the Pretext.Uno companion helpers, and keeps only sample-specific UI/theme code in the sample tree.

• Overview
• Accordion
• Bubbles
• Masonry
• Rich Text
• Dynamic Layout
• Editorial Engine
• Justification Comparison
• Variable ASCII

Run it with:

dotnet run --project samples/PretextSamples/PretextSamples.csproj -f net10.0-desktop

Building

Prerequisites

• .NET 10 SDK
• Uno.Sdk 6.5.x for the sample app only

Build, test, and pack

dotnet build PretextSamples.slnx
dotnet test tests/Pretext.Uno.Tests/Pretext.Uno.Tests.csproj
dotnet pack src/Pretext/Pretext.csproj -c Release
dotnet pack src/Pretext.Uno/Pretext.Uno.csproj -c Release

Docs and CI

The repository includes:

• ci.yml for multi-platform build, test, docs validation, and preview package generation
• docs.yml for GitHub Pages deployment
• release.yml for tag-driven packing, optional NuGet publication, and GitHub release creation
• a Lunet docs site in site/

The docs cover:

• installation and namespace/package selection
• font strings, measurement, and prepared-text lifecycle
• whitespace and break behavior, locale-aware segmentation, and bidi
• practical Uno and generic SkiaSharp integration patterns
• full reference coverage for the public core API and Pretext.Uno helpers

Project Structure

src/
  Pretext/
  Pretext.Uno/
tests/
  Pretext.Uno.Tests/
samples/
  PretextSamples/
site/

Attribution

The core Pretext implementation in this repository is ported from the original pretext project by Cheng Lou. This repository adapts that work to .NET, SkiaSharp, packaging, tests, samples, and companion Uno helpers.

License

MIT. See LICENSE.