@pptkit/core

@pptkit/core

Authoring model and Canonical Presentation IR for PPTKit.

Capabilities

• method-managed presentations, slides, elements, assets, and slide layouts
• rich text paragraphs and runs
• native text-bearing shapes and document-level text style presets
• theme colors and fonts
• text, image, shape, connector, group, and table elements
• placeholders, speaker notes, hidden slides, sections, tags, and custom data
• structured validation and fully materialized IR v1 normalization

Example

import { createPresentation, normalizePresentation } from "@pptkit/core";

const presentation = createPresentation({
  metadata: { title: "Quarterly Update", author: "Example Team" },
  theme: { colors: { accent1: "2457D6" } },
  textStylePresets: {
    title: { frame: { margin: 0, verticalAlign: "middle" }, paragraph: { align: "center" }, run: { fontSize: 32, bold: true } },
  },
});

const slide = presentation.addSlide();
slide.addElement({
  type: "text",
  content: [{
    runs: [
      { text: "Quarterly ", style: { fontSize: 32 } },
      { text: "Update", style: { fontSize: 32, bold: true, color: { theme: "accent1" } } },
    ],
  }],
  box: { x: 48, y: 48, width: 500, height: 60 },
});

const normalized = normalizePresentation(presentation);
console.log(normalized.irVersion); // 1

slide.addElement({
  type: "shape",
  shape: "roundRect",
  box: { x: 48, y: 120, width: 500, height: 80 },
  text: { content: "Editable card", textStylePreset: "title" },
});

Collections are exposed as readonly snapshots. Use document and slide methods to add, insert, move, remove, or duplicate content.

See the Core API reference and authoring architecture.