From 17d0e16e3bc308d4b54c292a3d699c2afb18627a Mon Sep 17 00:00:00 2001
From: taj_ny <m@rcin.dev>
Date: Sun, 15 Mar 2026 13:21:39 +0100
Subject: [PATCH] readme: add text expansion

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 99e8ef15..95792a31 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,22 @@ Supported environments: Plasma 6, Hyprland, GNOME, other Wayland compositors (av
           - on: begin
             command: kill -9 $window_under_pointer_pid
 
+      # text expansion (compositor plugins only)
+      - type: shortcut
+        shortcut: [ leftctrl, space ]
+
+        conditions:
+          - can_replace_text: &text_substitution_rules
+              - regex: :calc{(.*)}
+                replace:
+                  command: printf "$(qalc -t "$match_1")"
+
+              - regex: :email
+                replace: example@example.com
+
+        actions:
+          - replace_text: *text_substitution_rules
+
   mouse:
     gestures:
       # right + draw circle clockwise -> open dolphin