notionary 0.3.1__py3-none-any.whl → 0.4.1__py3-none-any.whl

notionary/page/content/renderer/renderers/todo.py

@@ -1,21 +1,25 @@
 from typing import override
 
 from notionary.blocks.enums import BlockType
-from notionary.blocks.rich_text.rich_text_markdown_converter import RichTextToMarkdownConverter
+from notionary.blocks.rich_text.rich_text_markdown_converter import (
+    RichTextToMarkdownConverter,
+)
 from notionary.blocks.schemas import Block
 from notionary.page.content.renderer.context import MarkdownRenderingContext
 from notionary.page.content.renderer.renderers.base import BlockRenderer
-from notionary.page.content.syntax import SyntaxRegistry
+from notionary.page.content.syntax.definition import SyntaxDefinitionRegistry
 
 
 class TodoRenderer(BlockRenderer):
     def __init__(
         self,
-        syntax_registry: SyntaxRegistry | None = None,
+        syntax_registry: SyntaxDefinitionRegistry | None = None,
         rich_text_markdown_converter: RichTextToMarkdownConverter | None = None,
     ) -> None:
         super().__init__(syntax_registry=syntax_registry)
-        self._rich_text_markdown_converter = rich_text_markdown_converter or RichTextToMarkdownConverter()
+        self._rich_text_markdown_converter = (
+            rich_text_markdown_converter or RichTextToMarkdownConverter()
+        )
 
     @override
     def _can_handle(self, block: Block) -> bool:
@@ -29,7 +33,11 @@ class TodoRenderer(BlockRenderer):
             context.markdown_result = ""
             return
 
-        syntax = self._syntax_registry.get_todo_done_syntax() if is_checked else self._syntax_registry.get_todo_syntax()
+        syntax = (
+            self._syntax_registry.get_todo_done_syntax()
+            if is_checked
+            else self._syntax_registry.get_todo_syntax()
+        )
 
         todo_markdown = f"{syntax.start_delimiter} {content}"
 
@@ -51,6 +59,8 @@ class TodoRenderer(BlockRenderer):
 
         content = ""
         if block.to_do.rich_text:
-            content = await self._rich_text_markdown_converter.to_markdown(block.to_do.rich_text)
+            content = await self._rich_text_markdown_converter.to_markdown(
+                block.to_do.rich_text
+            )
 
         return is_checked, content

notionary/page/content/renderer/renderers/toggle.py

@@ -1,21 +1,25 @@
 from typing import override
 
 from notionary.blocks.enums import BlockType
-from notionary.blocks.rich_text.rich_text_markdown_converter import RichTextToMarkdownConverter
+from notionary.blocks.rich_text.rich_text_markdown_converter import (
+    RichTextToMarkdownConverter,
+)
 from notionary.blocks.schemas import Block
 from notionary.page.content.renderer.context import MarkdownRenderingContext
 from notionary.page.content.renderer.renderers.base import BlockRenderer
-from notionary.page.content.syntax import SyntaxRegistry
+from notionary.page.content.syntax.definition import SyntaxDefinitionRegistry
 
 
 class ToggleRenderer(BlockRenderer):
     def __init__(
         self,
-        syntax_registry: SyntaxRegistry | None = None,
+        syntax_registry: SyntaxDefinitionRegistry | None = None,
         rich_text_markdown_converter: RichTextToMarkdownConverter | None = None,
     ) -> None:
         super().__init__(syntax_registry=syntax_registry)
-        self._rich_text_markdown_converter = rich_text_markdown_converter or RichTextToMarkdownConverter()
+        self._rich_text_markdown_converter = (
+            rich_text_markdown_converter or RichTextToMarkdownConverter()
+        )
 
     @override
     def _can_handle(self, block: Block) -> bool:

notionary/page/content/renderer/renderers/video.py

@@ -1,31 +1,28 @@
 from typing import override
 
-from notionary.blocks.schemas import Block, BlockType
-from notionary.page.content.renderer.renderers.captioned_block import CaptionedBlockRenderer
-
-
-class VideoRenderer(CaptionedBlockRenderer):
+from notionary.blocks.schemas import (
+    Block,
+    BlockType,
+    ExternalFileWithCaption,
+    NotionHostedFileWithCaption,
+)
+from notionary.page.content.renderer.renderers.file_like_block import (
+    FileLikeBlockRenderer,
+)
+from notionary.page.content.syntax.definition import EnclosedSyntaxDefinition
+
+
+class VideoRenderer(FileLikeBlockRenderer):
     @override
     def _can_handle(self, block: Block) -> bool:
         return block.type == BlockType.VIDEO
 
     @override
-    async def _render_main_content(self, block: Block) -> str:
-        url = self._extract_video_url(block)
-
-        if not url:
-            return ""
-
-        syntax = self._syntax_registry.get_video_syntax()
-        return f"{syntax.start_delimiter}{url}{syntax.end_delimiter}"
+    def _get_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._syntax_registry.get_video_syntax()
 
-    def _extract_video_url(self, block: Block) -> str:
-        if not block.video:
-            return ""
-
-        if block.video.external:
-            return block.video.external.url or ""
-        elif block.video.file:
-            return block.video.file.url or ""
-
-        return ""
+    @override
+    def _get_file_data(
+        self, block: Block
+    ) -> ExternalFileWithCaption | NotionHostedFileWithCaption | None:
+        return block.video

notionary/page/content/renderer/service.py

@@ -1,6 +1,8 @@
 from notionary.blocks.schemas import Block
 from notionary.page.content.renderer.context import MarkdownRenderingContext
-from notionary.page.content.renderer.post_processing.service import MarkdownRenderingPostProcessor
+from notionary.page.content.renderer.post_processing.service import (
+    MarkdownRenderingPostProcessor,
+)
 from notionary.page.content.renderer.renderers import BlockRenderer
 from notionary.utils.mixins.logging import LoggingMixin
 
@@ -22,7 +24,9 @@ class NotionToMarkdownConverter(LoggingMixin):
         current_block_index = 0
 
         while current_block_index < len(blocks):
-            context = self._create_rendering_context(blocks, current_block_index, indent_level)
+            context = self._create_rendering_context(
+                blocks, current_block_index, indent_level
+            )
             await self._renderer_chain.handle(context)
 
             if context.markdown_result:
@@ -45,6 +49,8 @@ class NotionToMarkdownConverter(LoggingMixin):
             convert_children_callback=self.convert,
         )
 
-    def _join_rendered_blocks(self, rendered_parts: list[str], indent_level: int) -> str:
+    def _join_rendered_blocks(
+        self, rendered_parts: list[str], indent_level: int
+    ) -> str:
         separator = "\n\n" if indent_level == 0 else "\n"
         return separator.join(rendered_parts)

notionary/page/content/service.py

@@ -30,13 +30,17 @@ class PageContentService(LoggingMixin):
 
     @time_execution_async()
     async def clear(self) -> None:
-        children_response = await self._block_client.get_block_children(block_id=self._page_id)
+        children_response = await self._block_client.get_block_children(
+            block_id=self._page_id
+        )
 
         if not children_response or not children_response.results:
             self.logger.debug("No blocks to delete for page: %s", self._page_id)
             return
 
-        await asyncio.gather(*[self._delete_single_block(block) for block in children_response.results])
+        await asyncio.gather(
+            *[self._delete_single_block(block) for block in children_response.results]
+        )
 
     @async_retry(max_retries=10, initial_delay=0.2, backoff_factor=1.5)
     async def _delete_single_block(self, block: Block) -> None:
@@ -44,16 +48,22 @@ class PageContentService(LoggingMixin):
         await self._block_client.delete_block(block.id)
 
     @time_execution_async()
-    async def append_markdown(self, content: str | Callable[[MarkdownBuilder], MarkdownBuilder]) -> None:
+    async def append_markdown(
+        self, content: str | Callable[[MarkdownBuilder], MarkdownBuilder]
+    ) -> None:
         markdown = self._extract_markdown(content)
         if not markdown:
-            self.logger.debug("No markdown content to append for page: %s", self._page_id)
+            self.logger.debug(
+                "No markdown content to append for page: %s", self._page_id
+            )
             return
 
         blocks = await self._markdown_converter.convert(markdown)
         await self._append_blocks(blocks)
 
-    def _extract_markdown(self, content: str | Callable[[MarkdownBuilder], MarkdownBuilder]) -> str:
+    def _extract_markdown(
+        self, content: str | Callable[[MarkdownBuilder], MarkdownBuilder]
+    ) -> str:
         if isinstance(content, str):
             return content
 
@@ -62,7 +72,11 @@ class PageContentService(LoggingMixin):
             content(builder)
             return builder.build()
 
-        raise ValueError("content must be either a string or a callable that takes a MarkdownBuilder")
+        raise ValueError(
+            "content must be either a string or a callable that takes a MarkdownBuilder"
+        )
 
     async def _append_blocks(self, blocks: list[Block]) -> None:
-        await self._block_client.append_block_children(block_id=self._page_id, children=blocks)
+        await self._block_client.append_block_children(
+            block_id=self._page_id, children=blocks
+        )

notionary/page/content/syntax/definition/__init__.py

@@ -0,0 +1,11 @@
+from .grammar import MarkdownGrammar
+from .models import EnclosedSyntaxDefinition, SimpleSyntaxDefinition, SyntaxDefinition
+from .registry import SyntaxDefinitionRegistry
+
+__all__ = [
+    "EnclosedSyntaxDefinition",
+    "MarkdownGrammar",
+    "SimpleSyntaxDefinition",
+    "SyntaxDefinition",
+    "SyntaxDefinitionRegistry",
+]

notionary/page/content/syntax/definition/models.py

@@ -0,0 +1,57 @@
+import re
+from dataclasses import dataclass
+from enum import StrEnum
+
+
+class SyntaxDefinitionRegistryKey(StrEnum):
+    AUDIO = "audio"
+    BOOKMARK = "bookmark"
+    IMAGE = "image"
+    VIDEO = "video"
+    FILE = "file"
+    PDF = "pdf"
+
+    BULLETED_LIST = "bulleted_list"
+    NUMBERED_LIST = "numbered_list"
+    TO_DO = "todo"
+    TO_DO_DONE = "todo_done"
+
+    TOGGLE = "toggle"
+    TOGGLEABLE_HEADING = "toggleable_heading"
+    CALLOUT = "callout"
+    QUOTE = "quote"
+    CODE = "code"
+
+    COLUMN_LIST = "column_list"
+    COLUMN = "column"
+
+    HEADING = "heading"
+
+    DIVIDER = "divider"
+    BREADCRUMB = "breadcrumb"
+    TABLE_OF_CONTENTS = "table_of_contents"
+    EQUATION = "equation"
+    EMBED = "embed"
+    TABLE = "table"
+    TABLE_ROW = "table_row"
+
+    CAPTION = "caption"
+    SPACE = "space"
+    PARAGRAPH = "paragraph"
+
+
+@dataclass(frozen=True)
+class SimpleSyntaxDefinition:
+    start_delimiter: str
+    regex_pattern: re.Pattern
+
+
+@dataclass(frozen=True)
+class EnclosedSyntaxDefinition:
+    start_delimiter: str
+    end_delimiter: str
+    regex_pattern: re.Pattern
+    end_regex_pattern: re.Pattern
+
+
+type SyntaxDefinition = SimpleSyntaxDefinition | EnclosedSyntaxDefinition

notionary/page/content/syntax/definition/registry.py

@@ -0,0 +1,371 @@
+import re
+
+from notionary.page.content.syntax.definition.grammar import MarkdownGrammar
+from notionary.page.content.syntax.definition.models import (
+    EnclosedSyntaxDefinition,
+    SimpleSyntaxDefinition,
+    SyntaxDefinition,
+    SyntaxDefinitionRegistryKey,
+)
+
+
+class SyntaxDefinitionRegistry:
+    def __init__(
+        self, markdown_markdown_grammar: MarkdownGrammar | None = None
+    ) -> None:
+        self._markdown_grammar = markdown_markdown_grammar or MarkdownGrammar()
+        self._definitions: dict[SyntaxDefinitionRegistryKey, SyntaxDefinition] = {}
+        self._register_defaults()
+
+    def get_breadcrumb_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.BREADCRUMB]
+
+    def get_bulleted_list_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.BULLETED_LIST]
+
+    def get_divider_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.DIVIDER]
+
+    def get_numbered_list_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.NUMBERED_LIST]
+
+    def get_quote_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.QUOTE]
+
+    def get_table_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TABLE]
+
+    def get_table_row_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TABLE_ROW]
+
+    def get_table_of_contents_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TABLE_OF_CONTENTS]
+
+    def get_todo_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TO_DO]
+
+    def get_todo_done_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TO_DO_DONE]
+
+    def get_caption_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.CAPTION]
+
+    def get_space_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.SPACE]
+
+    def get_heading_syntax(self) -> SimpleSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.HEADING]
+
+    def get_audio_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.AUDIO]
+
+    def get_bookmark_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.BOOKMARK]
+
+    def get_embed_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.EMBED]
+
+    def get_file_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.FILE]
+
+    def get_image_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.IMAGE]
+
+    def get_pdf_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.PDF]
+
+    def get_video_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.VIDEO]
+
+    def get_callout_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.CALLOUT]
+
+    def get_code_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.CODE]
+
+    def get_column_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.COLUMN]
+
+    def get_column_list_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.COLUMN_LIST]
+
+    def get_equation_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.EQUATION]
+
+    def get_toggle_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TOGGLE]
+
+    def get_toggleable_heading_syntax(self) -> EnclosedSyntaxDefinition:
+        return self._definitions[SyntaxDefinitionRegistryKey.TOGGLEABLE_HEADING]
+
+    def _create_media_syntax(
+        self, media_type: str, url_pattern: str | None = None
+    ) -> EnclosedSyntaxDefinition:
+        url_pattern = url_pattern or "[^)]+"
+        return EnclosedSyntaxDefinition(
+            start_delimiter=f"[{media_type}](",
+            end_delimiter=")",
+            regex_pattern=re.compile(
+                rf"(?<!\!)\[{re.escape(media_type)}\]\(({url_pattern})\)"
+            ),
+            end_regex_pattern=re.compile(r"\)"),
+        )
+
+    def _create_url_media_syntax(self, media_type: str) -> EnclosedSyntaxDefinition:
+        return EnclosedSyntaxDefinition(
+            start_delimiter=f"[{media_type}](",
+            end_delimiter=")",
+            regex_pattern=re.compile(
+                rf"(?<!\!)\[{re.escape(media_type)}\]\((https?://[^\s)]+)\)"
+            ),
+            end_regex_pattern=re.compile(r"\)"),
+        )
+
+    def _register_defaults(self) -> None:
+        # Media elements (enclosed)
+        self._register_audio_syntax()
+        self._register_video_syntax()
+        self._register_image_syntax()
+        self._register_file_syntax()
+        self._register_pdf_syntax()
+        self._register_bookmark_syntax()
+        self._register_embed_syntax()
+
+        # Lists (simple)
+        self._register_bulleted_list_syntax()
+        self._register_numbered_list_syntax()
+        self._register_todo_syntax()
+        self._register_todo_done_syntax()
+
+        # Block containers (enclosed)
+        self._register_toggle_syntax()
+        self._register_toggleable_heading_syntax()
+        self._register_callout_syntax()
+        self._register_code_syntax()
+        self._register_column_list_syntax()
+        self._register_column_syntax()
+        self._register_equation_syntax()
+
+        # Text blocks (simple)
+        self._register_quote_syntax()
+        self._register_heading_syntax()
+        self._register_divider_syntax()
+        self._register_breadcrumb_syntax()
+        self._register_table_of_contents_syntax()
+        self._register_table_syntax()
+        self._register_table_row_syntax()
+        self._register_caption_syntax()
+        self._register_space_syntax()
+
+    # Registration methods - SimpleSyntaxDefinition
+    def _register_breadcrumb_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="[breadcrumb]",
+            regex_pattern=re.compile(r"^\[breadcrumb\]\s*$", re.IGNORECASE),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.BREADCRUMB] = definition
+
+    def _register_bulleted_list_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="- ",
+            regex_pattern=re.compile(r"^(\s*)-\s+(?!\[[ xX]\])(.+)$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.BULLETED_LIST] = definition
+
+    def _register_divider_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="---",
+            regex_pattern=re.compile(r"^\s*-{3,}\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.DIVIDER] = definition
+
+    def _register_numbered_list_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="1. ",
+            regex_pattern=re.compile(r"^(\s*)(\d+)\.\s+(.+)$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.NUMBERED_LIST] = definition
+
+    def _register_quote_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="> ",
+            regex_pattern=re.compile(r"^>(?!>)\s*(.+)$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.QUOTE] = definition
+
+    def _register_table_syntax(self) -> None:
+        delimiter = self._markdown_grammar.table_delimiter
+        definition = SimpleSyntaxDefinition(
+            start_delimiter=delimiter,
+            regex_pattern=re.compile(
+                rf"^\s*{re.escape(delimiter)}(.+){re.escape(delimiter)}\s*$"
+            ),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TABLE] = definition
+
+    def _register_table_row_syntax(self) -> None:
+        delimiter = self._markdown_grammar.table_delimiter
+        definition = SimpleSyntaxDefinition(
+            start_delimiter=delimiter,
+            regex_pattern=re.compile(
+                rf"^\s*{re.escape(delimiter)}([\s\-:|]+){re.escape(delimiter)}\s*$"
+            ),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TABLE_ROW] = definition
+
+    def _register_table_of_contents_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="[toc]",
+            regex_pattern=re.compile(r"^\[toc\]$", re.IGNORECASE),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TABLE_OF_CONTENTS] = definition
+
+    def _register_todo_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="- [ ]",
+            regex_pattern=re.compile(r"^\s*-\s+\[ \]\s+(.+)$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TO_DO] = definition
+
+    def _register_todo_done_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="- [x]",
+            regex_pattern=re.compile(r"^\s*-\s+\[x\]\s+(.+)$", re.IGNORECASE),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TO_DO_DONE] = definition
+
+    def _register_caption_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="[caption]",
+            regex_pattern=re.compile(r"^\[caption\]\s+(\S.*)$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.CAPTION] = definition
+
+    def _register_space_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="[space]",
+            regex_pattern=re.compile(r"^\[space\]\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.SPACE] = definition
+
+    def _register_heading_syntax(self) -> None:
+        definition = SimpleSyntaxDefinition(
+            start_delimiter="#",
+            regex_pattern=re.compile(r"^(#{1,3})[ \t]+(.+)$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.HEADING] = definition
+
+    # Registration methods - EnclosedSyntaxDefinition
+    def _register_audio_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.AUDIO] = (
+            self._create_media_syntax("audio")
+        )
+
+    def _register_video_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.VIDEO] = (
+            self._create_media_syntax("video")
+        )
+
+    def _register_image_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.IMAGE] = (
+            self._create_media_syntax("image")
+        )
+
+    def _register_file_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.FILE] = self._create_media_syntax(
+            "file"
+        )
+
+    def _register_pdf_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.PDF] = self._create_media_syntax(
+            "pdf"
+        )
+
+    def _register_bookmark_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.BOOKMARK] = (
+            self._create_url_media_syntax("bookmark")
+        )
+
+    def _register_embed_syntax(self) -> None:
+        self._definitions[SyntaxDefinitionRegistryKey.EMBED] = (
+            self._create_url_media_syntax("embed")
+        )
+
+    def _register_callout_syntax(self) -> None:
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter="[callout]",
+            end_delimiter=")",
+            regex_pattern=re.compile(
+                r'\[callout\](?:\(([^")]+?)(?:\s+"([^"]+)")?\)|(?:\s+([^"\n]+?)(?:\s+"([^"]+)")?)(?:\n|$))'
+            ),
+            end_regex_pattern=re.compile(r"\)"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.CALLOUT] = definition
+
+    def _register_code_syntax(self) -> None:
+        code_delimiter = "```"
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter=code_delimiter,
+            end_delimiter=code_delimiter,
+            regex_pattern=re.compile("^" + re.escape(code_delimiter) + r"(\w*)\s*$"),
+            end_regex_pattern=re.compile("^" + re.escape(code_delimiter) + r"\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.CODE] = definition
+
+    def _register_column_syntax(self) -> None:
+        delimiter = self._markdown_grammar.column_delimiter
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter=f"{delimiter} column",
+            end_delimiter=delimiter,
+            regex_pattern=re.compile(
+                rf"^{re.escape(delimiter)}\s*column(?:\s+(0?\.\d+|1(?:\.0?)?))??\s*$",
+                re.IGNORECASE | re.MULTILINE,
+            ),
+            end_regex_pattern=re.compile(rf"^{re.escape(delimiter)}\s*$", re.MULTILINE),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.COLUMN] = definition
+
+    def _register_column_list_syntax(self) -> None:
+        delimiter = self._markdown_grammar.column_delimiter
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter=f"{delimiter} columns",
+            end_delimiter=delimiter,
+            regex_pattern=re.compile(
+                rf"^{re.escape(delimiter)}\s*columns?\s*$", re.IGNORECASE
+            ),
+            end_regex_pattern=re.compile(rf"^{re.escape(delimiter)}\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.COLUMN_LIST] = definition
+
+    def _register_equation_syntax(self) -> None:
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter="$$",
+            end_delimiter="$$",
+            regex_pattern=re.compile(r"^\$\$\s*$"),
+            end_regex_pattern=re.compile(r"^\$\$\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.EQUATION] = definition
+
+    def _register_toggle_syntax(self) -> None:
+        delimiter = self._markdown_grammar.toggle_delimiter
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter=delimiter,
+            end_delimiter=delimiter,
+            regex_pattern=re.compile(rf"^{re.escape(delimiter)}\s+(.+)$"),
+            end_regex_pattern=re.compile(rf"^{re.escape(delimiter)}\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TOGGLE] = definition
+
+    def _register_toggleable_heading_syntax(self) -> None:
+        delimiter = self._markdown_grammar.toggle_delimiter
+        escaped_delimiter = re.escape(delimiter)
+        definition = EnclosedSyntaxDefinition(
+            start_delimiter=f"{delimiter} #",
+            end_delimiter=delimiter,
+            regex_pattern=re.compile(
+                rf"^{escaped_delimiter}\s*(?P<level>#{{1,3}})(?!#)\s*(.+)$",
+                re.IGNORECASE,
+            ),
+            end_regex_pattern=re.compile(rf"^{escaped_delimiter}\s*$"),
+        )
+        self._definitions[SyntaxDefinitionRegistryKey.TOGGLEABLE_HEADING] = definition

notionary/page/content/syntax/prompts/__init__.py

@@ -0,0 +1,4 @@
+from .models import SyntaxPromptData
+from .registry import SyntaxPromptRegistry
+
+__all__ = ["SyntaxPromptData", "SyntaxPromptRegistry"]

notionary/page/content/syntax/prompts/models.py

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class SyntaxPromptData:
+    element: str
+    description: str
+    is_multi_line: bool
+    few_shot_examples: list[str]
+    usage_notes: str
+    supports_inline_rich_text: bool