Skip to content

Releases: deckflow/deckrender

v0.3.1

Choose a tag to compare

@iguangfei iguangfei released this 02 Sep 06:04

DeckRender now depends only on @deckflow/[email protected] for PPTX conversion. Platform selection and native runtime layout are delegated to that package through its public getBinaryPath API. Release checks now verify the wrapper contract and native/cloud-only npm and pnpm installs.

v0.3.0 — Community engine and browser SDK

Choose a tag to compare

@iguangfei iguangfei released this 31 Aug 13:54

Highlights

  • Add Community/local PPTX, PDF, and HTML rendering alongside the existing cloud engine.
  • Add a cloud-only browser SDK with DOM-only declarations and no Node polyfills.
  • Use upstream @deckflow/office2html platform packages pinned to 0.1.0. Install only the matching OS/CPU binary; no runtime auto-installation.
  • Support lazy-slide conversion output, bounded parallel capture, and offline local asset handling.
  • Remove repository-owned platform binaries and their duplicate publishing workflow.

Installation

npm install -g @deckflow/[email protected]

Cloud-only installations can add --omit=optional. The default engine remains cloud; select --engine local for local rendering and install Chrome or Chromium.

Validation

380 local tests, nine package-installation scenarios, and CI on Node 18, 20, and 22 passed. Published npm artifacts include provenance.

Full changelog

v0.1.0 — first release

Choose a tag to compare

@iguangfei iguangfei released this 07 Aug 11:20

First release of DeckRender — a pure render engine. A document goes in, pixels come out: images, a PDF, or a video.

npx -y @deckflow/deckrender@latest deck.pptx

What converts to what

Input → image → pdf → video
.pptx .ppt
.pdf 🕓
.key 🕓
.docx .doc
.xlsx 🕓 🕓
.pages .numbers
.html and URLs
.md

🕓 is planned but not built; those report not_implemented naming what blocks them, so "not yet" is distinguishable from "never".

Every cell above was confirmed end to end against the live backend, not inferred from type definitions — several conversions that looked plausible turned out not to work.

Highlights

  • Works with no setup. Rendering runs in guest mode; log in only for higher quotas or a private workspace.
  • One login for every DeckFlow CLI. Credentials live in ~/.deckflow/credentials, resolved through a five-level chain that deckrender config list reports the source of.
  • Agent-friendly. --json gives a stable result envelope, stdout stays clean, and exit codes are 0/1/2/3.
  • No silent surprises. An option the backend cannot honour fails with an explanation rather than being quietly dropped, because rendering something other than what was asked for is worse than an error.
  • Library and CLI in one package. import { render } from '@deckflow/deckrender'.

Worth knowing

  • Pages and Numbers render the preview embedded in the document — the first page only. Everything else renders in full.
  • HTML to PDF and video is laid out as slides rather than by a browser; the result carries a caveat in --json.
  • --fps, --duration and --transition are not accepted yet.

Links