# Rendro v0.1.0 - Table of Contents

Pure-Elixir, Phoenix-first PDF/document generation with deterministic layout and pagination

## Pages

- [Rendro](readme.md)

- Guides
  - [Rendro Integrations](integrations.md)
  - [Branding](branding.md)

- Policies
  - [API Stability and Support Boundaries](api_stability.md)

## Modules

- [Rendro](Rendro.md): Pure-Elixir, Phoenix-first PDF/document generation with deterministic layout and pagination.

- [Rendro.Adapters.Oban.RenderWorker](Rendro.Adapters.Oban.RenderWorker.md): Oban worker pattern for background PDF rendering.

- [Rendro.Adapters.Phoenix](Rendro.Adapters.Phoenix.md): Phoenix integration for Rendro.
- [Rendro.AssetRegistry](Rendro.AssetRegistry.md): State container for registered assets and their metadata.

- [Rendro.Audit](Rendro.Audit.md): Behavior for audit logging of Rendro render lifecycle events.
- [Rendro.Block](Rendro.Block.md): Content container with position and size.

- [Rendro.Branded](Rendro.Branded.md): Path helpers for Rendro's shipped branded demo assets.
- [Rendro.Component](Rendro.Component.md): Component-based layout pattern for reusable PDF UI parts.

- [Rendro.Document](Rendro.Document.md): Top-level document: pages, content (flow), metadata, and rendering options.
- [Rendro.Error](Rendro.Error.md): Structured diagnostics for render failures.
- [Rendro.FontRegistry](Rendro.FontRegistry.md): Pure data registry for document-owned logical font registrations.
- [Rendro.I18n.Analyzer](Rendro.I18n.Analyzer.md): Provides I18n script analysis capabilities to detect unsupported script boundaries,
such as Right-To-Left (RTL) scripts and Complex Shaping scripts.

- [Rendro.Image](Rendro.Image.md): AST representation of a registered image asset to be rendered.

- [Rendro.ImageParser](Rendro.ImageParser.md): Pure functional parser for extracting intrinsic bounds and mime types from image binaries.

- [Rendro.Inspector](Rendro.Inspector.md): Deterministic layout inspector for ASCII snapshot testing.
Provides string serialization of document structure and diagnostics.

- [Rendro.Metadata](Rendro.Metadata.md): Document metadata: title, author, creator, dates, and custom fields.

- [Rendro.PDF.Font](Rendro.PDF.Font.md): PDF font definitions and glyph width metrics.
- [Rendro.PDF.Object](Rendro.PDF.Object.md): PDF value type serialization per PDF 1.4 spec.
- [Rendro.PDF.Writer](Rendro.PDF.Writer.md): Serializes a `Rendro.Document` into a valid PDF 1.4 binary.
- [Rendro.Page](Rendro.Page.md): A page with blocks, dimensions, and margins.

- [Rendro.PageTemplate](Rendro.PageTemplate.md): Explicit flow-page layout template with page geometry and named regions.

- [Rendro.Pipeline](Rendro.Pipeline.md): Orchestrates the render pipeline: build -> compose -> measure -> paginate -> render -> validate.
- [Rendro.Pipeline.Build](Rendro.Pipeline.Build.md): Validates and normalizes a Document struct for the render pipeline.

- [Rendro.Pipeline.Compose](Rendro.Pipeline.Compose.md): Assembles the logical document tree.
- [Rendro.Pipeline.Measure](Rendro.Pipeline.Measure.md): Calculates dimensions for blocks that don't have explicit sizes.
- [Rendro.Pipeline.Paginate](Rendro.Pipeline.Paginate.md): Assigns content to pages respecting page boundaries, then stacks y-coordinates.
- [Rendro.Pipeline.Render](Rendro.Pipeline.Render.md): Converts a paginated document into PDF binary via the Writer.

- [Rendro.Pipeline.Validate](Rendro.Pipeline.Validate.md): Trailing post-render checks for the Rendro pipeline.
- [Rendro.Recipes](Rendro.Recipes.md): Canonical PDF recipes for standard document types.
- [Rendro.Recipes.BrandedInvoice](Rendro.Recipes.BrandedInvoice.md): Branded canonical invoice recipe using the Tiered Composition pattern.
- [Rendro.Recipes.Invoice](Rendro.Recipes.Invoice.md): Canonical invoice recipe using the Tiered Composition pattern.
- [Rendro.Region](Rendro.Region.md): Bounded layout region with named role and anchoring metadata.

- [Rendro.Section](Rendro.Section.md): Reusable flow section that targets a named template region.

- [Rendro.Table](Rendro.Table.md): Table primitive for structured data.

- [Rendro.Telemetry](Rendro.Telemetry.md): Telemetry event definitions and helpers for the Rendro render pipeline.
- [Rendro.Text](Rendro.Text.md): Text content with logical font, size, and color attributes.

- Exceptions
  - [Rendro.AssetRegistry.InvalidAssetError](Rendro.AssetRegistry.InvalidAssetError.md)
  - [Rendro.FontRegistry.EmbeddedFontFamilyError](Rendro.FontRegistry.EmbeddedFontFamilyError.md)

## Mix Tasks

- [mix docs.contract](Mix.Tasks.Docs.Contract.md): Runs the canonical docs-contract verification command.

- [mix release.preflight](Mix.Tasks.Release.Preflight.md): Runs preflight checks before release.

- [mix rendro.visual_uat](Mix.Tasks.Rendro.VisualUat.md): Renders the branded invoice fixture, rasterises page 1 to PNG via `pdftoppm`,
asks the Claude API to grade three visual criteria (logo present, header
uses the embedded branded font, layout looks intentional), and writes the
verdict back into the phase's UAT file.
- [mix verify](Mix.Tasks.Verify.md): Runs full verification suite with deterministic and advisory lanes.