pom

pom (PowerPoint Object Model) is a library for declaratively describing PowerPoint presentations (pptx) in TypeScript. It is designed for use cases where JSON in POM format generated by AI is converted into PowerPoint files.

Requirements

• Node.js 18 or higher (for Node.js environments)
• Modern browser with ES2020+ support (for browser environments)

[!NOTE] pom works in both Node.js and browser environments. Text measurement uses opentype.js with bundled Noto Sans JP fonts, ensuring consistent layout across all environments.

Installation

npm install @hirokisakabe/pom

Quick Start

import { buildPptx, POMNode } from "@hirokisakabe/pom";

const slide: POMNode = {
  type: "vstack",
  w: "100%",
  h: "max",
  padding: 48,
  gap: 24,
  alignItems: "start",
  children: [
    {
      type: "text",
      text: "Presentation Title",
      fontPx: 48,
      bold: true,
    },
    {
      type: "text",
      text: "Subtitle",
      fontPx: 24,
      color: "666666",
    },
  ],
};

const pptx = await buildPptx([slide], { w: 1280, h: 720 });
await pptx.writeFile({ fileName: "presentation.pptx" });

Features

• Type-safe: Strict type definitions with TypeScript
• Declarative: Describe slides with JSON-like objects
• PowerPoint First: Native support for Shape features
• Flexible Layout: Automatic layout with VStack/HStack/Box
• Pixel Units: Intuitive pixel-based sizing (internally converted to inches)
• Master Slide: Automatically insert common headers, footers, and page numbers across all pages
• AI Friendly: Simple structure that makes it easy for LLMs to generate code

Available Nodes

| Node | Description | | ------------ | ---------------------------------------------- | | text | Text with font styling and bullet points | | image | Images from file path, URL, or base64 | | table | Tables with customizable columns and rows | | shape | PowerPoint shapes (roundRect, ellipse, etc.) | | chart | Charts (bar, line, pie, area, doughnut, radar) | | timeline | Timeline/roadmap visualizations | | matrix | 2x2 positioning maps | | tree | Organization charts and decision trees | | flow | Flowcharts with nodes and edges | | processArrow | Chevron-style process diagrams | | box | Container for single child with padding | | vstack | Vertical stack layout | | hstack | Horizontal stack layout |

For detailed node documentation, see Nodes Reference.

Documentation

| Document | Description | | ----------------------------------------------- | --------------------------------------- | | Nodes Reference | Complete reference for all node types | | Master Slide | Headers, footers, and page numbers | | Serverless Environments | Text measurement options for serverless | | LLM Integration | Guide for generating slides with AI/LLM |

License

MIT