sirena 0.1.0

data/examples/requirement/README.adoc

@@ -0,0 +1,85 @@
+= Requirement Diagram Examples
+
+== Purpose
+
+Requirement diagrams model requirements, their relationships, and associated elements like risks and tests, commonly used in systems engineering.
+
+== When to Use
+
+* Requirements engineering
+* System specification documentation
+* Traceability matrices
+* Risk assessment
+* Verification planning
+
+== Syntax Overview
+
+[source,mermaid]
+----
+requirementDiagram
+    requirement req1 {
+        id: 1
+        text: Requirement text
+        risk: high
+        verifymethod: test
+    }
+    element element1 {
+        type: system
+    }
+    req1 - satisfies -> element1
+----
+
+== Examples
+
+=== 01: Basic Requirements
+
+Demonstrates basic requirement definitions with relationships.
+
+**File**: link:01-basic-requirements.mmd[01-basic-requirements.mmd]
+
+[source,mermaid]
+----
+include::01-basic-requirements.mmd[]
+----
+
+image::01-basic-requirements.svg[]
+
+=== 02: Risk Levels
+
+Showcases requirements with different risk levels and verification methods.
+
+**File**: link:02-risk-levels.mmd[02-risk-levels.mmd]
+
+[source,mermaid]
+----
+include::02-risk-levels.mmd[]
+----
+
+image::02-risk-levels.svg[]
+
+== Features Demonstrated
+
+[%header,cols="1,1"]
+|===
+| Feature | Example
+
+| Requirement definition
+| 01, 02
+
+| Risk levels
+| 02
+
+| Verification methods
+| 01, 02
+
+| Element relationships
+| 01, 02
+
+| Traceability links
+| 01, 02
+|===
+
+== Additional Resources
+
+* link:../../README.adoc[Main Documentation]
+* https://mermaid.js.org/syntax/requirementDiagram.html[Mermaid Requirement Diagram Documentation]

data/examples/sankey/01-simple-flow.mmd

@@ -0,0 +1,7 @@
+sankey-beta
+    Engineering, Development, 100
+    Engineering, Testing, 50
+    Development, Frontend, 60
+    Development, Backend, 40
+    Testing, QA, 35
+    Testing, UAT, 15

data/examples/sankey/01-simple-flow.svg

@@ -0,0 +1,34 @@
+<svg
+ width="546.0"
+ height="410.0"
+ viewBox="0 0 546 410"
+ version="1.2"
+ xmlns="http://www.w3.org/2000/svg"
+>
+<path fill="#4472C4" stroke="none" opacity="0.4" d="M 95 95.0 C 152.5 95.0, 152.5 95.0, 210 95.0 L 210 145.0 C 152.5 145.0, 152.5 145.0, 95 145.0 Z"/>
+<text fill="#000000" x="152.5" y="120.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">100</text>
+<path fill="#ED7D31" stroke="none" opacity="0.4" d="M 95 107.0 C 152.5 107.0, 152.5 177.0, 210 177.0 L 210 203.0 C 152.5 203.0, 152.5 133.0, 95 133.0 Z"/>
+<text fill="#000000" x="152.5" y="155.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">50</text>
+<path fill="#A5A5A5" stroke="none" opacity="0.4" d="M 250 104.5 C 305.0 104.5, 305.0 104.5, 360 104.5 L 360 135.5 C 305.0 135.5, 305.0 135.5, 250 135.5 Z"/>
+<text fill="#000000" x="305.0" y="120.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">60</text>
+<path fill="#FFC000" stroke="none" opacity="0.4" d="M 250 109.5 C 305.0 109.5, 305.0 179.5, 360 179.5 L 360 200.5 C 305.0 200.5, 305.0 130.5, 250 130.5 Z"/>
+<text fill="#000000" x="305.0" y="155.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">40</text>
+<path fill="#5B9BD5" stroke="none" opacity="0.4" d="M 240 180.5 C 300.0 180.5, 300.0 250.5, 360 250.5 L 360 269.5 C 300.0 269.5, 300.0 199.5, 240 199.5 Z"/>
+<text fill="#000000" x="300.0" y="225.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">35</text>
+<path fill="#70AD47" stroke="none" opacity="0.4" d="M 240 185.5 C 300.0 185.5, 300.0 325.5, 360 325.5 L 360 334.5 C 300.0 334.5, 300.0 194.5, 240 194.5 Z"/>
+<text fill="#000000" x="300.0" y="260.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">15</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="60.0" y="100.0" width="35.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="77.0" y="125.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Engineering</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="210.0" y="100.0" width="40.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="230.0" y="125.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Development</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="210.0" y="170.0" width="30.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="225.0" y="195.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Testing</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="360.0" y="100.0" width="26.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="373.0" y="125.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Frontend</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="360.0" y="170.0" width="24.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="372.0" y="195.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Backend</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="360.0" y="240.0" width="24.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="372.0" y="265.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">QA</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="360.0" y="310.0" width="22.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="371.0" y="335.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">UAT</text>
+</svg>

data/examples/sankey/02-multi-stage.mmd

@@ -0,0 +1,11 @@
+sankey-beta
+    Oil,Transportation,200
+    Oil,Industry,100
+    Oil,Residential,50
+    NaturalGas,PowerGeneration,120
+    NaturalGas,Industry,50
+    NaturalGas,Residential,30
+    Coal,PowerGeneration,100
+    Coal,Industry,50
+    Renewable,PowerGeneration,80
+    Renewable,Residential,20

data/examples/sankey/02-multi-stage.svg

@@ -0,0 +1,44 @@
+<svg
+ width="405.0"
+ height="410.0"
+ viewBox="0 0 405 410"
+ version="1.2"
+ xmlns="http://www.w3.org/2000/svg"
+>
+<path fill="#4472C4" stroke="none" opacity="0.4" d="M 98 95.0 C 154.0 95.0, 154.0 165.0, 210 165.0 L 210 215.0 C 154.0 215.0, 154.0 145.0, 98 145.0 Z"/>
+<text fill="#000000" x="154.0" y="155.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">200</text>
+<path fill="#ED7D31" stroke="none" opacity="0.4" d="M 98 107.0 C 154.0 107.0, 154.0 247.0, 210 247.0 L 210 273.0 C 154.0 273.0, 154.0 133.0, 98 133.0 Z"/>
+<text fill="#000000" x="154.0" y="190.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">100</text>
+<path fill="#A5A5A5" stroke="none" opacity="0.4" d="M 98 113.0 C 154.0 113.0, 154.0 323.0, 210 323.0 L 210 337.0 C 154.0 337.0, 154.0 127.0, 98 127.0 Z"/>
+<text fill="#000000" x="154.0" y="225.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">50</text>
+<path fill="#FFC000" stroke="none" opacity="0.4" d="M 90 174.5 C 150.0 174.5, 150.0 104.5, 210 104.5 L 210 135.5 C 150.0 135.5, 150.0 205.5, 90 205.5 Z"/>
+<text fill="#000000" x="150.0" y="155.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">120</text>
+<path fill="#5B9BD5" stroke="none" opacity="0.4" d="M 90 183.0 C 150.0 183.0, 150.0 253.0, 210 253.0 L 210 267.0 C 150.0 267.0, 150.0 197.0, 90 197.0 Z"/>
+<text fill="#000000" x="150.0" y="225.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">50</text>
+<path fill="#70AD47" stroke="none" opacity="0.4" d="M 90 185.5 C 150.0 185.5, 150.0 325.5, 210 325.5 L 210 334.5 C 150.0 334.5, 150.0 194.5, 90 194.5 Z"/>
+<text fill="#000000" x="150.0" y="260.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">30</text>
+<path fill="#C00000" stroke="none" opacity="0.4" d="M 88 247.0 C 149.0 247.0, 149.0 107.0, 210 107.0 L 210 133.0 C 149.0 133.0, 149.0 273.0, 88 273.0 Z"/>
+<text fill="#000000" x="149.0" y="190.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">100</text>
+<path fill="#7030A0" stroke="none" opacity="0.4" d="M 88 253.0 C 149.0 253.0, 149.0 253.0, 210 253.0 L 210 267.0 C 149.0 267.0, 149.0 267.0, 88 267.0 Z"/>
+<text fill="#000000" x="149.0" y="260.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">50</text>
+<path fill="#4472C4" stroke="none" opacity="0.4" d="M 85 319.5 C 147.5 319.5, 147.5 109.5, 210 109.5 L 210 130.5 C 147.5 130.5, 147.5 340.5, 85 340.5 Z"/>
+<text fill="#000000" x="147.5" y="225.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">80</text>
+<path fill="#ED7D31" stroke="none" opacity="0.4" d="M 85 326.5 C 147.5 326.5, 147.5 326.5, 210 326.5 L 210 333.5 C 147.5 333.5, 147.5 333.5, 85 333.5 Z"/>
+<text fill="#000000" x="147.5" y="330.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">20</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="60.0" y="100.0" width="38.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="79.0" y="125.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Oil</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="210.0" y="170.0" width="30.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="225.0" y="195.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Transportation</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="210.0" y="240.0" width="30.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="225.0" y="265.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Industry</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="210.0" y="310.0" width="25.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="222.0" y="335.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Residential</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="60.0" y="170.0" width="30.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="75.0" y="195.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">NaturalGas</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="210.0" y="100.0" width="35.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="227.0" y="125.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">PowerGeneration</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="60.0" y="240.0" width="28.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="74.0" y="265.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Coal</text>
+<rect fill="#ffffff" stroke="#000000" stroke-width="2" x="60.0" y="310.0" width="25.0" height="40.0" rx="3.0" ry="3.0"/>
+<text fill="#FFFFFF" x="72.0" y="335.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0" font-weight="bold">Renewable</text>
+</svg>

data/examples/sankey/README.adoc

@@ -0,0 +1,74 @@
+= Sankey Diagram Examples
+
+== Purpose
+
+Sankey diagrams visualize flow quantities between nodes, showing how values split and combine through a system.
+
+== When to Use
+
+* Energy flow visualization
+* Resource allocation tracking
+* Material flow analysis
+* Budget distribution
+* Process flow quantification
+
+== Syntax Overview
+
+[source,mermaid]
+----
+sankey-beta
+    Source,Target,100
+    Source,Another,50
+----
+
+== Examples
+
+=== 01: Simple Flow
+
+Demonstrates basic sankey diagram with flow relationships.
+
+**File**: link:01-simple-flow.mmd[01-simple-flow.mmd]
+
+[source,mermaid]
+----
+include::01-simple-flow.mmd[]
+----
+
+image::01-simple-flow.svg[]
+
+=== 02: Multi-Stage
+
+Showcases complex multi-stage flow diagram.
+
+**File**: link:02-multi-stage.mmd[02-multi-stage.mmd]
+
+[source,mermaid]
+----
+include::02-multi-stage.mmd[]
+----
+
+image::02-multi-stage.svg[]
+
+== Features Demonstrated
+
+[%header,cols="1,1"]
+|===
+| Feature | Example
+
+| Basic flows
+| 01, 02
+
+| Flow quantities
+| 01, 02
+
+| Multi-stage flows
+| 02
+
+| Node relationships
+| 01, 02
+|===
+
+== Additional Resources
+
+* link:../../README.adoc[Main Documentation]
+* https://mermaid.js.org/syntax/sankey.html[Mermaid Sankey Documentation]

data/examples/sequence/01-basic-sequence.mmd

@@ -0,0 +1,27 @@
+sequenceDiagram
+    participant User
+    participant WebApp
+    participant API
+    participant Database
+    participant Cache
+
+    User->>+WebApp: Request Product Page
+    WebApp->>+Cache: Check Cache
+    Cache-->>-WebApp: Cache Miss
+
+    WebApp->>+API: GET /api/product/123
+    API->>+Database: SELECT * FROM products WHERE id=123
+    Database-->>-API: Product Data
+    API-->>-WebApp: JSON Response
+
+    WebApp->>+Cache: Store in Cache
+    Cache-->>-WebApp: Cached
+
+    WebApp-->>-User: Render Product Page
+
+    Note over User,Cache: Subsequent request will hit cache
+
+    User->>+WebApp: Refresh Page
+    WebApp->>+Cache: Check Cache
+    Cache-->>-WebApp: Cache Hit
+    WebApp-->>-User: Render Product Page (Fast)

data/examples/sequence/01-basic-sequence.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="400" height="200" viewBox="0 0 400 200" version="1.2" xmlns="http://www.w3.org/2000/svg">
+  <rect x="50" y="50" width="300" height="100" fill="#f0f0f0" stroke="#000000" stroke-width="2"/>
+  <text x="200" y="100" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" fill="#000000">Sequence Diagram (parser needs fixes)</text>
+</svg>

data/examples/sequence/02-activations.mmd

@@ -0,0 +1,17 @@
+sequenceDiagram
+    participant Client
+    participant Server
+    participant Database
+    participant Cache
+    
+    Client->>+Server: Request data
+    Server->>+Database: Query data
+    Database-->>-Server: Return results
+    Server->>+Cache: Store in cache
+    Cache-->>-Server: Cached
+    Server-->>-Client: Response
+    
+    Client->>+Server: Request same data
+    Server->>+Cache: Check cache
+    Cache-->>-Server: Cache hit
+    Server-->>-Client: Fast response

data/examples/sequence/02-activations.svg

@@ -0,0 +1,78 @@
+<svg
+ width="680.0"
+ height="820.0"
+ viewBox="0 0 680 820"
+ version="1.2"
+ xmlns="http://www.w3.org/2000/svg"
+>
+<line stroke="#000000" stroke-width="1" x1="80.0" y1="60.0" x2="80.0" y2="760.0" stroke-dasharray="5,5"/>
+<line stroke="#000000" stroke-width="1" x1="220.0" y1="60.0" x2="220.0" y2="760.0" stroke-dasharray="5,5"/>
+<line stroke="#000000" stroke-width="1" x1="360.0" y1="60.0" x2="360.0" y2="760.0" stroke-dasharray="5,5"/>
+<line stroke="#000000" stroke-width="1" x1="500.0" y1="60.0" x2="500.0" y2="760.0" stroke-dasharray="5,5"/>
+<g id="message-0">
+  <line stroke="#000000" stroke-width="2" x1="80.0" y1="120.0" x2="212.0" y2="120.0"/>
+  <polygon fill="#000000" stroke="#000000" points="220,120 212,116 212,124"/>
+  <text fill="#000000" x="150.0" y="110.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Request data</text>
+</g>
+<g id="message-1">
+  <line stroke="#000000" stroke-width="2" x1="220.0" y1="180.0" x2="352.0" y2="180.0"/>
+  <polygon fill="#000000" stroke="#000000" points="360,180 352,176 352,184"/>
+  <text fill="#000000" x="290.0" y="170.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Query data</text>
+</g>
+<g id="message-2">
+  <line stroke="#000000" stroke-width="2" x1="360.0" y1="240.0" x2="212.0" y2="240.0" stroke-dasharray="5,5"/>
+  <polygon fill="#000000" stroke="#000000" points="220,240 228,236 228,244"/>
+  <text fill="#000000" x="290.0" y="230.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Return results</text>
+</g>
+<g id="message-3">
+  <line stroke="#000000" stroke-width="2" x1="220.0" y1="300.0" x2="492.0" y2="300.0"/>
+  <polygon fill="#000000" stroke="#000000" points="500,300 492,296 492,304"/>
+  <text fill="#000000" x="360.0" y="290.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Store in cache</text>
+</g>
+<g id="message-4">
+  <line stroke="#000000" stroke-width="2" x1="500.0" y1="360.0" x2="212.0" y2="360.0" stroke-dasharray="5,5"/>
+  <polygon fill="#000000" stroke="#000000" points="220,360 228,356 228,364"/>
+  <text fill="#000000" x="360.0" y="350.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Cached</text>
+</g>
+<g id="message-5">
+  <line stroke="#000000" stroke-width="2" x1="220.0" y1="420.0" x2="72.0" y2="420.0" stroke-dasharray="5,5"/>
+  <polygon fill="#000000" stroke="#000000" points="80,420 88,416 88,424"/>
+  <text fill="#000000" x="150.0" y="410.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Response</text>
+</g>
+<g id="message-6">
+  <line stroke="#000000" stroke-width="2" x1="80.0" y1="480.0" x2="212.0" y2="480.0"/>
+  <polygon fill="#000000" stroke="#000000" points="220,480 212,476 212,484"/>
+  <text fill="#000000" x="150.0" y="470.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Request same data</text>
+</g>
+<g id="message-7">
+  <line stroke="#000000" stroke-width="2" x1="220.0" y1="540.0" x2="492.0" y2="540.0"/>
+  <polygon fill="#000000" stroke="#000000" points="500,540 492,536 492,544"/>
+  <text fill="#000000" x="360.0" y="530.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Check cache</text>
+</g>
+<g id="message-8">
+  <line stroke="#000000" stroke-width="2" x1="500.0" y1="600.0" x2="212.0" y2="600.0" stroke-dasharray="5,5"/>
+  <polygon fill="#000000" stroke="#000000" points="220,600 228,596 228,604"/>
+  <text fill="#000000" x="360.0" y="590.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Cache hit</text>
+</g>
+<g id="message-9">
+  <line stroke="#000000" stroke-width="2" x1="220.0" y1="660.0" x2="72.0" y2="660.0" stroke-dasharray="5,5"/>
+  <polygon fill="#000000" stroke="#000000" points="80,660 88,656 88,664"/>
+  <text fill="#000000" x="150.0" y="650.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Fast response</text>
+</g>
+<g id="participant-Client">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="20.0" y="20.0" width="120.0" height="40.0" rx="5.0" ry="5.0"/>
+  <text fill="#000000" x="80.0" y="40.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Client</text>
+</g>
+<g id="participant-Server">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="160.0" y="20.0" width="120.0" height="40.0" rx="5.0" ry="5.0"/>
+  <text fill="#000000" x="220.0" y="40.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Server</text>
+</g>
+<g id="participant-Database">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="300.0" y="20.0" width="120.0" height="40.0" rx="5.0" ry="5.0"/>
+  <text fill="#000000" x="360.0" y="40.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Database</text>
+</g>
+<g id="participant-Cache">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="440.0" y="20.0" width="120.0" height="40.0" rx="5.0" ry="5.0"/>
+  <text fill="#000000" x="500.0" y="40.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Cache</text>
+</g>
+</svg>

data/examples/sequence/README.adoc

@@ -0,0 +1,86 @@
+= Sequence Diagram Examples
+
+== Purpose
+
+Sequence diagrams visualize interactions between objects or components over time, showing the order of messages exchanged in a particular scenario. They are essential for documenting API workflows, system interactions, and communication protocols.
+
+== When to Use
+
+* API request/response flows and service interactions
+* Authentication and authorization sequences
+* Asynchronous message exchanges and event processing
+* Transaction workflows and state changes
+* System integration scenarios and data flows
+
+== Syntax Overview
+
+[source,mermaid]
+----
+sequenceDiagram
+    participant Alice
+    participant Bob
+    
+    Alice->>Bob: Hello Bob
+    Bob-->>Alice: Hi Alice
+    
+    Note over Alice,Bob: Conversation
+----
+
+**Participants**: Define entities using `participant Name`
+
+**Message Types**:
+- `->>` - Solid arrow
+- `-->>` - Dotted arrow (response)
+- `->>+` - Activate lifeline
+- `-->>-` - Deactivate lifeline
+
+**Additional Elements**:
+- `Note over A,B: Text` - Add notes
+- `loop` - Repeating sequences
+- `alt`/`else` - Conditional flows
+- `par` - Parallel execution
+
+== Examples
+
+=== 01: Basic Sequence
+
+Demonstrates a complete request/response flow with caching, showing participant interactions and activation/deactivation of lifelines.
+
+**File**: link:01-basic-sequence.mmd[01-basic-sequence.mmd]
+
+[source,mermaid]
+----
+include::01-basic-sequence.mmd[]
+----
+
+image::01-basic-sequence.svg[]
+
+== Features Demonstrated
+
+[%header,cols="1,1"]
+|===
+| Feature | Example
+
+| Participant declaration
+| 01
+
+| Solid arrows (requests)
+| 01
+
+| Dotted arrows (responses)
+| 01
+
+| Activation/deactivation
+| 01
+
+| Notes
+| 01
+
+| Multi-step workflows
+| 01
+|===
+
+== Additional Resources
+
+* link:../../README.adoc[Main Documentation]
+* https://mermaid.js.org/syntax/sequenceDiagram.html[Mermaid Sequence Diagram Documentation]

data/examples/state_diagram/01-simple-states.mmd

@@ -0,0 +1,29 @@
+stateDiagram-v2
+    [*] --> Idle
+
+    Idle --> Connecting : connect()
+    Connecting --> Connected : success
+    Connecting --> Error : failure
+
+    state Connected {
+        [*] --> Authenticated
+        Authenticated --> Active
+
+        state Active {
+            [*] --> Reading
+            Reading --> Writing : write_request
+            Writing --> Reading : write_complete
+            Reading --> Processing : process_data
+            Processing --> Reading : complete
+        }
+
+        Active --> Suspended : suspend()
+        Suspended --> Active : resume()
+    }
+
+    Connected --> Disconnecting : disconnect()
+    Error --> Idle : reset()
+    Disconnecting --> Idle : complete
+    Suspended --> Disconnecting : timeout
+
+    Idle --> [*] : shutdown()

data/examples/state_diagram/01-simple-states.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="400" height="200" viewBox="0 0 400 200" version="1.2" xmlns="http://www.w3.org/2000/svg">
+  <rect x="50" y="50" width="300" height="100" fill="#f0f0f0" stroke="#000000" stroke-width="2"/>
+  <text x="200" y="100" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" fill="#000000">State Diagram (parser needs fixes)</text>
+</svg>

data/examples/state_diagram/02-composite.mmd

@@ -0,0 +1,19 @@
+stateDiagram-v2
+    [*] --> Application
+    
+    state Application {
+        [*] --> Idle
+        Idle --> Processing : Start
+        
+        state Processing {
+            [*] --> Validating
+            Validating --> Executing : Valid
+            Validating --> Failed : Invalid
+            Executing --> Success
+            Executing --> Failed
+        }
+        
+        Processing --> Idle : Complete
+    }
+    
+    Application --> [*]

data/examples/state_diagram/02-composite.svg

@@ -0,0 +1,81 @@
+<svg
+ width="753.0"
+ height="600.0"
+ viewBox="0 0 753.0 600"
+ version="1.2"
+ xmlns="http://www.w3.org/2000/svg"
+>
+<g id="transition-start_1_to_Application">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 65 65 L 358.5 75" marker-end="url(#arrowhead)"/>
+</g>
+<g id="transition-start_1_to_Idle">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 65 65 L 600 75" marker-end="url(#arrowhead)"/>
+</g>
+<g id="transition-Idle_to_Processing">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 600 75 L 105.0 275" marker-end="url(#arrowhead)"/>
+  <text fill="#000000" x="352.5" y="167.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Start</text>
+</g>
+<g id="transition-start_1_to_Validating">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 65 65 L 355.0 275" marker-end="url(#arrowhead)"/>
+</g>
+<g id="transition-Validating_to_Executing">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 355.0 275 L 601.5 275" marker-end="url(#arrowhead)"/>
+  <text fill="#000000" x="478.25" y="267.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Valid</text>
+</g>
+<g id="transition-Validating_to_Failed">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 355.0 275 L 100 475" marker-end="url(#arrowhead)"/>
+  <text fill="#000000" x="227.5" y="367.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Invalid</text>
+</g>
+<g id="transition-Executing_to_Success">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 601.5 275 L 350 475" marker-end="url(#arrowhead)"/>
+</g>
+<g id="transition-Executing_to_Failed">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 601.5 275 L 100 475" marker-end="url(#arrowhead)"/>
+</g>
+<g id="transition-Processing_to_Idle">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 105.0 275 L 600 75" marker-end="url(#arrowhead)"/>
+  <text fill="#000000" x="352.5" y="167.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="12">Complete</text>
+</g>
+<g id="transition-Application_to_end_2">
+  <path fill="none" stroke="#000000" stroke-width="2" d="M 358.5 75 L 565 465" marker-end="url(#arrowhead)"/>
+</g>
+<g id="state-start_1">
+  <circle fill="#000000" stroke="none" cx="65.0" cy="65.0" r="15.0"/>
+  <text fill="#000000" x="65.0" y="65.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">[*]</text>
+</g>
+<g id="state-Application">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="300.0" y="50.0" width="117.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="358.5" y="75.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Application</text>
+</g>
+<g id="state-Idle">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="550.0" y="50.0" width="100.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="600.0" y="75.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Idle</text>
+</g>
+<g id="state-Processing">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="50.0" y="250.0" width="110.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="105.0" y="275.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Processing</text>
+</g>
+<g id="state-Validating">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="300.0" y="250.0" width="110.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="355.0" y="275.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Validating</text>
+</g>
+<g id="state-Executing">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="550.0" y="250.0" width="103.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="601.5" y="275.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Executing</text>
+</g>
+<g id="state-Failed">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="50.0" y="450.0" width="100.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="100.0" y="475.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Failed</text>
+</g>
+<g id="state-Success">
+  <rect fill="#ffffff" stroke="#000000" stroke-width="2" x="300.0" y="450.0" width="100.0" height="50.0" rx="10.0" ry="10.0"/>
+  <text fill="#000000" x="350.0" y="475.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">Success</text>
+</g>
+<g id="state-end_2">
+  <g>
+  <circle fill="none" stroke="#000000" stroke-width="2" cx="565.0" cy="465.0" r="15.0"/>
+  <circle fill="#000000" stroke="none" cx="565.0" cy="465.0" r="10.0"/>
+</g>
+  <text fill="#000000" x="565.0" y="465.0" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" dominant-baseline="middle">[*]</text>
+</g>
+</svg>