API Reference

omniscript-parser

Zero-dependency TypeScript parser for converting OSF text to Abstract Syntax Tree (AST) and back.

Installation

npm install omniscript-parser

Usage

import { parse, serialize } from 'omniscript-parser';

// Parse OSF to AST
const osfCode = `
@meta { title: "My Document"; }
@doc { content: "# Hello World"; }
`;

const ast = parse(osfCode);
console.log(ast);
// Output: { version: "1.0", blocks: [...] }

// Serialize AST back to OSF
const osfOutput = serialize(ast);
console.log(osfOutput);

API

Types

interface OSFDocument {
  version?: string;
  blocks: OSFBlock[];
}

type OSFBlock = 
  | MetaBlock 
  | DocBlock 
  | SlideBlock 
  | SheetBlock 
  | ChartBlock 
  | DiagramBlock 
  | OSFCodeBlock;

interface MetaBlock {
  type: 'meta';
  title?: string;
  author?: string;
  date?: string;
  version?: string;
  theme?: string;
  tags?: string[];
  description?: string;
}

interface ChartBlock {
  type: 'chart';
  chartType: 'bar' | 'line' | 'pie' | 'scatter' | 'area';
  title: string;
  data: ChartDataSeries[];
  options?: ChartOptions;
}

omniscript-converters

Professional document converters for exporting OSF to PDF, DOCX, PPTX, and XLSX.

Installation

npm install omniscript-parser omniscript-converters

Usage - PDF

import { parse } from 'omniscript-parser';
import { PDFConverter } from 'omniscript-converters';

const osfCode = `@meta { title: "My Document"; }`;
const ast = parse(osfCode);

const converter = new PDFConverter();
const result = await converter.convert(ast, { theme: 'Corporate' });

// Write to file
import fs from 'fs';
fs.writeFileSync('output.pdf', result.buffer);

Usage - DOCX

import { DOCXConverter } from 'omniscript-converters';

const converter = new DOCXConverter();
const result = await converter.convert(ast);

fs.writeFileSync('output.docx', result.buffer);

Usage - PPTX

import { PPTXConverter } from 'omniscript-converters';

const converter = new PPTXConverter();
const result = await converter.convert(ast, { theme: 'Modern' });

fs.writeFileSync('output.pptx', result.buffer);

Usage - XLSX

import { XLSXConverter } from 'omniscript-converters';

const converter = new XLSXConverter();
const result = await converter.convert(ast);

fs.writeFileSync('output.xlsx', result.buffer);

Converter Options

interface ConverterOptions {
  theme?: string;           // Theme name (default: 'default')
  pageSize?: 'A4' | 'Letter';
  orientation?: 'portrait' | 'landscape';
  fontSize?: number;
  fontFamily?: string;
}

Themes

Available themes: default, Corporate, Modern,Minimal, Academic, Dark, Light

omniscript-cli

Command-line interface for parsing, validating, and converting OSF files.

Installation

npm install -g omniscript-cli

Commands

osf parse document.osf

osf render doc.osf --format pdf --output output.pdf
osf render doc.osf --format docx --theme Corporate

osf lint document.osf

osf export doc.osf --target md --output README.md

Complete Example

// File: generate-report.ts
import { parse, serialize } from 'omniscript-parser';
import { PDFConverter, DOCXConverter } from 'omniscript-converters';
import fs from 'fs';

async function generateReport() {
  // Create OSF content
  const osfCode = `
@meta {
  title: "Q4 Business Report";
  author: "Finance Team";
  date: "2025-10-15";
  theme: "Corporate";
}

@doc {
  content: "# Executive Summary
  
  Revenue grew **25%** this quarter.
  ";
}

@chart {
  type: "bar";
  title: "Revenue by Quarter";
  data: [
    { label: "Q1"; values: [100]; },
    { label: "Q2"; values: [120]; },
    { label: "Q3"; values: [140]; },
    { label: "Q4"; values: [175]; }
  ];
}
  `;

  // Parse to AST
  const ast = parse(osfCode);
  
  // Generate PDF
  const pdfConverter = new PDFConverter();
  const pdfResult = await pdfConverter.convert(ast);
  fs.writeFileSync('report.pdf', pdfResult.buffer);
  
  // Generate DOCX
  const docxConverter = new DOCXConverter();
  const docxResult = await docxConverter.convert(ast);
  fs.writeFileSync('report.docx', docxResult.buffer);
  
  console.log('✅ Generated report.pdf and report.docx');
}

generateReport();