Context

interface RendererContext {
  // Basic page info
  pageId: string;
  pageProperties: PageProperties;

  // Custom metadata and collected data
  metadata: Record<string, any>;
  variableData: VariableCollector; // all variables and their collected data

  // Current block and all blocks
  block: Block;
  blockTree: Block[];

  // Available transformers
  // yes you can access the transformers and perform certain transformations on the fly
  transformers: {
    blocks: Record<BlockType, BlockTransformer>;
    annotations: Record<string, AnnotationTransformer>;
  };

  // Utility functions
  utils: {
    processRichText: (richText: RichText[], metadata?: any) => Promise<string>;
    processBlock: (block: Block, metadata?: any) => Promise<string>;
  };
}

interface AnnotationContext {
  text: string;                 // The text being formatted
  annotations?: RichTextAnnotation;    // This is from the notion API
  link?: { url: string };      // For linked text
  metadata?: Record<string, any>; // Additional info
}

// Using renderer context in a block transformer
const codeTransformer = {
  transform: async (context: RendererContext) => {
    const { block, utils, metadata } = context;
    const code = await utils.processRichText(block.code.rich_text);
    return `<CodeBlock lang="${block.code.language}">${code}</CodeBlock>`;
  }
};

// Using annotation context
const boldTransformer = {
  transform: async (context: AnnotationContext) => {
    const { text, metadata } = context;
    return metadata?.html ? `<strong>${text}</strong>` : `**${text}**`;
  }
};