OPF

Search docs

Loading documentation…
    OpenPresentation/opf
    Browse docs
    On this page

    Upgrade a deck or host to OPF 0.34

    Update a 0.33 deck, validate the renamed fields and compare the preview with the PowerPoint handoff.

    Update a deck

    Work on a copy of the deck, with the CLI and runtime packages on the same 0.34 release. Validate before and after each group of edits.

    Check the source
    npx opf validate deck.opf.json --format text
    • Replace a text run’s lang with language. The Markdown span attribute remains lang.
    • Use start and end for promoted slide regions, header and footer zones, and logical alignment. For example, top:left becomes top:start. Keep physical coordinates such as image focus, chart legend position and cell borders.
    • For a shape anchored to a block, use widthPx and heightPx for pixel dimensions. width and height are fractions of the target. Check warnings on formerly small pixel values.
    • Correct unknown keys reported on design, metadata and text-run objects. Use extensions for custom data. An inline color scheme can set its palette’s name.

    The full migration table covers every renamed field and the host registration changes.

    Compare the output

    Set a chart target explicitly with chart.referenceLines. For a series storing fractions, use 0.92 for 92%. The checker reports opf/chart-reference-unsupported-type if the chart type cannot draw that target. Inspect point-anchored overlays, area chart gaps, radar fills and reference labels near bars.

    Preview single-message slides. A short statement, quote or figure can grow, with a lone figure up to 252 reference pixels. Eligible one-line display text uses −1.5% tracking. Two lines use a 1.0 em pitch when the tighter pitch allows a larger fit. Check duration timelines, image callouts and inverted pyramids. Org chart, hierarchy and Venn layouts export editable shapes.

    A slide’s language controls direction, script fonts and numbering defaults. For example, ar-SA-u-nu-latn requests Latin digits in generated numbers. Inspect supported Graphviz DOT and PlantUML diagrams alongside Mermaid diagrams. SmartArt import recovers text and hierarchy when available. OPF’s own SmartArt designs accept up to twelve entries. For Office checks, follow Inspect the PowerPoint handoff. Keynote can draw some features differently, and UI-only views were outside the qualification checks.

    Update a host

    Hosts registering their own icon catalog now call galleryIconSets(). Browser hosts copy the icon files and pass fetchIcons so they load only the icons a deck uses. A Worker has no files to read: it passes an absolute URL and its assets binding to fetchIcons, or bundles a whole set. See Icons. A host that supplies text measurement can keep its existing callback; composeSlide reuses matching measurements within a call.

    In an MCP Apps client, use open_editor to open an editable deck. The viewer provides read_deck, select_slide and edit_deck. Read the deck back to check an edit. The desktop bundle is attached to the release. See Connect to the MCP server.