Echelon Foundry / Paged documents

Folio

A standards-first print component system for professional HTML documents. Folio expresses document and pagination intent with semantic HTML, passive light-DOM elements, and print CSS while the browser or selected renderer remains responsible for physical pagination.

Registered components27
Rendered examples81
Core runtime dependencies0
Capability modelP0 → P3
Operating principles

The renderer still owns pages.

Folio makes page intent easier to declare without quietly becoming another browser layout engine.

01

Semantic source first

Headings, tables, figures, lists, and links stay native HTML. Custom elements are reserved for reusable print/layout intent.

02

CSS owns layout intent

Page rules, breaks, columns, side rails, and print presentation remain standards-based and visible in the cascade.

03

Capabilities stay explicit

Chromium-only margin boxes, deterministic export, and enhanced publishing features are never advertised as universal browser behavior.

Implemented component catalog

Only shipped primitives get pages.

Every registered Folio element has a dedicated page with three print-ready examples and its current evidence posture.

Document structure

Document

Top-level print intent wrapper for a complete semantic document. It does not synthesize pages or own document data.

P0 portable · implemented
Document structure

Title Page

A document cover/title region that requests a page break after itself using native fragmentation.

P0 portable · implemented
Document structure

Section

Block-level section wrapper with explicit optional page-break intent before or after the section.

P0 portable · implemented
Document structure

Back Page

Terminal document region for contact information, closing content, legal notes, or branded back matter.

P0 portable · implemented
Running content

Header

A semantic three-region document header that stays in normal flow portably and can express running-page intent without faking pagination. Slots name physical positions: left, center and right keep their edges even when a region is omitted or the document is right-to-left.

P0 in-flow · P1/P2 running capability · implemented / capability-bound
Running content

Footer

A semantic document footer with three regions and explicit running-page intent while preserving a visible P0 fallback. Slots name physical positions: left, center and right keep their edges even when a region is omitted or the document is right-to-left.

P0 in-flow · P1/P2 running capability · implemented / capability-bound
Running content

Page Number

An explicit page-counter intent marker that never estimates pagination from DOM height and keeps authored fallback text available.

P1/P2 counter · P0 authored fallback · implemented / capability-bound
Flow layout

Columns

Native CSS multicolumn flow for report, editorial, and digest layouts that participate in browser fragmentation.

P0 portable · experiment-backed
Flow layout

Sidebar

In-flow main/rail composition using CSS Grid as the current side-panel candidate.

P0 candidate · provisional
Page artwork

Artwork Layer

An out-of-flow artwork or watermark layer that sits behind semantic foreground content without depending on unsupported page-box backgrounds.

P0 element layer · experiment-backed
Fragmentation

Page Break

Explicit native page-break intent without measuring the DOM or manufacturing synthetic pages.

P0 portable · implemented
Fragmentation

Keep Together

Requests that a bounded content block avoid internal fragmentation using native break-inside behavior.

P0 portable · implemented / best-effort
Report composition

Metric

A compact domain-neutral label/value/detail block for scores, counts, deltas, coverage, financial values, or other report metrics without calculating their meaning.

P0 portable · implemented / report-fixture evidence
Report composition

Integrity

A compact report-quality block for completeness, coverage, confidence, comparability, suppression, warnings, and limitations supplied by the consuming application.

P0 portable · implemented / report-fixture evidence
Report composition

Finding

A structured evidence-oriented finding block that keeps observation, implication, possible action, and evidence-needed content distinct without inventing domain conclusions.

P0 portable · implemented / report-fixture evidence
Content emphasis

Callout

A bounded emphasis block for decisions, warnings, evidence, and summaries using print-safe flow and keep-together intent.

P0 portable · implemented / cross-browser evidence
Media

Figure

A print-aware wrapper around native figure semantics that requests caption cohesion without replacing figure, image, SVG, or figcaption HTML.

P0 portable · implemented / cross-browser evidence
Structured data

Table

A responsive screen container and print contract for native semantic tables, including repeated-header intent, row break avoidance, wrapping, and numeric alignment.

P0 portable · named-page behavior renderer-sensitive · experiment-backed
Technical content

Code

A print-safe wrapper for native pre/code content with controlled monospace typography and wrapping that prevents long lines from clipping the page.

P0 portable · implemented / cross-browser evidence
Navigation

Table of Contents

A semantic contents wrapper for native navigation and lists, with authored page-number presentation in P0 and explicit separation from automatic target-page counters.

P0 authored pages · P3 automatic target counters · implemented / capability-bound
Annotations

Note

An in-flow annotation primitive for notes, caveats, references, and explanatory material without pretending to provide automatic footnote placement.

P0 in-flow note · P3 footnote/sidenote enhancement · implemented / cross-browser evidence
Security

Security Evidence Record

Tutela assessment record preserving posture, scope, unknowns and evidence.

P0 portable · implemented
Security

Security Posture

Prints Tutela PASS, CONDITIONAL, BLOCKED or INDETERMINATE state.

P0 portable · implemented
Security

Security Invariant

Prints an invariant and its evidenced state.

P0 portable · implemented
Security

Security Evidence

Prints an evidence reference and provenance.

P0 portable · implemented
Security

Unknown Security Effect

Makes unresolved security knowledge explicit in print.

P0 portable · implemented
Security

Security Exception

Prints approved exception scope, controls and expiry.

P0 portable · implemented
Recipes and document families

Layout contracts without new tags.

.ef-identity

Identity Header

A dominant identity region (name, optional tagline) beside a compact contact region that stacks. data-contact="inline" wraps contacts in a row beneath the identity.

P0 portable · fixture-backed
.ef-row

Aligned Metadata Row

Primary regions grow and wrap on the start side while one [data-row-end] region (dates, years, amounts) stays on a single line at the end of the first row. No fixed coordinates.

P0 portable · fixture-backed
.ef-entry

Entry

A repeated logical entry whose first child (usually an .ef-row header) keeps with the content that follows it. data-keep requests keeping a short entry whole.

P0 portable · fixture-backed
.ef-lead-list

Lead List

A compact native list whose items may open with an emphasized lead phrase followed by regular-weight detail. Items request not to split across pages.

P0 portable · fixture-backed
.ef-inline-list

Inline Collection

A native list rendered inline with a configurable separator after each item but the last. Wraps naturally with the surrounding text.

P0 portable · fixture-backed
.ef-labeled

Labeled Collection

A label and its value laid out inline with a hanging continuation, typically a description list holding an inline collection.

P0 portable · fixture-backed
.ef-category-grid

Category Grid

Groups of a heading plus a compact list in auto-filled columns. Any number of groups and items; each group asks to stay whole across pages.

P0 portable · fixture-backed
.ef-dense

Dense Rhythm

Compact block spacing and heading keep-with-next intent for dense professional documents, applied once on the document root.

P0 portable · fixture-backed
.ef-longform

Long-form Reading Rhythm

Document-root rhythm for dense long-form reading: justified, hyphenated paragraphs with first-line indents, heading keep-with-next, widow/orphan control, and optional lead-line small caps or drop caps.

P0 portable · fixture-backed
.ef-article

Article Unit

A self-contained article or chapter inside a document or issue. data-start="page" begins it on a new page; data-start="recto" records right-hand-page intent. Article-local heading sizes are tokens.

P0 portable · recto P3 · fixture-backed
.ef-article-header

Article Front Matter

Opening front matter on a native header: [data-kicker] article type, h1 title, [data-subtitle], contributors, affiliations, and metadata. Spans all columns when placed inside multicolumn flow and keeps with what follows.

P0 portable · fixture-backed
.ef-authors

Contributor List

Native list of contributors that flows inline with a configurable separator. Affiliation and correspondence markers are links to affiliation IDs, so the mapping does not depend on visual order; [data-orcid] links stay unbroken.

P0 portable · fixture-backed
.ef-affiliations

Affiliation List

Compact list of affiliations with authored markers and a hanging indent, so long institution names wrap under their text. Items carry IDs that contributor markers link to.

P0 portable · fixture-backed
.ef-meta-list

Metadata List

Generic label/value metadata on a native dl with div groups: DOI, dates, licence, citation, ISSN, publisher, version. Two aligned tracks by default; data-layout="inline" runs groups together. Long identifiers wrap.

P0 portable · fixture-backed
.ef-abstract

Abstract

Ruled abstract block with a small-caps label. data-variant="structured" runs each part's h3 into its first paragraph (Background. …) while keeping real headings in the outline.

P0 portable · fixture-backed
.ef-caption

Caption

Caption for figures, tables, listings, or a table's trailing notes: an emphasized [data-label] (Figure 2., Table 1.), caption text, and block [data-note] and [data-source] lines.

P0 portable · fixture-backed
.ef-equation

Display Equation

Display equation on a native figure: consumer-supplied MathML, SVG, or HTML centered in a three-track grid with the authored number (figcaption) at the end. data-align="start" left-aligns multi-line equations. Kept together; stable id for cross-references.

P0 portable (MathML Core where supported) · fixture-backed
.ef-column-span

Column Span

Full-width material inside multicolumn flow: a figure, table, callout, or heading that spans every column, with column text continuing before and after it in source order.

P0 portable (column-span: all) · fixture-backed
.ef-reference-list

Reference List

Bibliography layout on a native list: hanging indent for author-year styles, or data-style="numeric" with authored [data-marker] labels in a hanging gutter. Long DOIs and URLs wrap anywhere; entries request keep-together.

P0 portable · fixture-backed
.ef-endnotes

Endnotes

Authored in-flow notes on a native ordered list, with optional [data-backlink] links back to the reference point. Serves endnotes and note-style (notes-bibliography) citations.

P0 portable · footnotes P3 · fixture-backed
.ef-declarations

Declaration Group

Back-matter statements as sections with run-in h3 labels in compact type: acknowledgements, funding, competing interests, contributions, data and code availability, ethics, supplementary material. Each statement requests keep-together.

P0 portable · fixture-backed
Renderer profiles

Portable does not mean identical.

Read the capability model
P0

Portable browser

Common document-flow and fragmentation primitives.

P1

Chromium margin boxes

Static running content and Page X of Y where validated.

P2

Deterministic Chromium

Controlled PDF generation and renderer diagnostics.

P3

Enhanced paged media

Optional advanced publishing-engine capabilities.

Evidence boundary

Implemented is not the same as universally guaranteed.

The original core primitive set is now registered, documented, and tested. Renderer-sensitive behavior such as repeated page-margin content, physical page counters, automatic TOC target pages, footnotes, sidenotes, bleed, and marks remains gated by the P1–P3 capability model.