About this documentation

The Ranger gallery holds the application stack: graphics, office formats, editors and other large programs written in Ranger. This site documents the Office side of that stack.

The applications do not share one document model. Word pagination, Excel formulas and PowerPoint master inheritance each keep their own model. They share the machinery underneath: fonts, measurement, history, geometry, colour, and EVG — the layout engine and the display list that every application paints through.

What this site holds

Part	Content	Source
Guides	EVG, PowerPoint, charts, Word, Excel and diagrams	Written by hand
API reference	Every published method of a facade, with the comment that sits above it	Generated from the Ranger sources

Two APIs exist today:

• PowerPoint — @ranger/pptx: open a .pptx, change it, write it back, draw it to PNG or PDF, and put a Vega chart on a slide as shapes.
• Charts — Vela’s VlChart: build a Vega-Lite chart by calling methods. There is no npm package yet. The live page on the EVG showcase loads the compiled Ranger classes.

Word, Excel and diagrams have editors and demos. They do not yet have a published facade in gallery/*/api/. The guides name the demos and the source.

How the reference is made

The API pages are not written by hand. A tool reads the Ranger facades, copies the comments, and writes the pages. A method that is not in the source cannot appear on a page. A method marked ; @internal stays out of the pages.

Related pages

• The language documentation describes Ranger itself (MIT).
• The playground compiles Ranger in the browser.
• The PowerPoint editor opens a deck with no server.
• The PowerPoint API playground writes a deck on the left and opens the bytes on the right. The PowerPoint guide and the PowerPoint API run that JavaScript in the page and load the resulting deck into the slide viewer.
• The Chart API runs VlChart calls in the page and draws the SVG this runtime produced.
• The EVG showcase renders the layout engine’s own pages.
• The Vela page pastes a Vega specification and draws it.
• The repository holds the sources.