From d944ed83e6aa29533abd9500fd41e53a6a9d4ed2 Mon Sep 17 00:00:00 2001
From: steffen <steffen@skui.io>
Date: Sat, 24 Jan 2026 19:43:32 +0000
Subject: [PATCH] Document emoji usage per theme

---
 .context.json       |   3 +-
 contest-styles.json |  14 +++++
 libary.md           | 125 ++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 141 insertions(+), 1 deletion(-)

diff --git a/.context.json b/.context.json
index c1f1f09..0371b16 100644
--- a/.context.json
+++ b/.context.json
@@ -504,6 +504,7 @@
     "README uses images/bash-pallete.png.",
     "Git capsule prefers __git_ps1 and falls back to git symbolic-ref/short hash when git-prompt is unavailable or returns empty.",
     "Hawolex git capsule enables when PS1_GIT resolves to a truthy value (1/yes/true/on).",
-    "Custom pack adds bold styles (radar, synthwave, noir, topo, glitch, arcticfire, acidlime)."
+    "Custom pack adds bold styles (radar, synthwave, noir, topo, glitch, arcticfire, acidlime).",
+    "Library includes emoji usage blocks per theme (sets, fixed times, time slots, rotation)."
   ]
 }
diff --git a/contest-styles.json b/contest-styles.json
index b5932d3..3c2d3bc 100644
--- a/contest-styles.json
+++ b/contest-styles.json
@@ -33,6 +33,20 @@
     "emoji_padding": 2,
     "note": "Two spaces after the emoji before the cursor"
   },
+  "emoji_rules": {
+    "fixed_times": [
+      "11:00-11:29 => 🥪",
+      "16:00-16:59 => 🍲"
+    ],
+    "time_slots": {
+      "sunrise": "05:00-08:59",
+      "coffee": "09:00-10:59",
+      "work": "11:30-15:59",
+      "evening": "17:00-22:59",
+      "night": "23:00-04:59"
+    },
+    "rotation": "Daily rotation by day-of-year with season offsets."
+  },
   "holiday_pack": {
     "layout_options": [
       "day-time-user",
diff --git a/libary.md b/libary.md
index 5df2f34..301d4ca 100644
--- a/libary.md
+++ b/libary.md
@@ -13,6 +13,11 @@ Winter:
 
 ![Winter](./images/themes/season-winter.png)
 
+Emoji:
+- Set: sunrise 🏔️ 🌨️ ❄️ 🌌; work 🎿 ⛷️ 🏂 🧊; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=59  Z2_BG=61  Z3_BG=63  Z4_BG=38  Z5_BG=37
 Z1_FG=255 Z2_FG=255
@@ -24,6 +29,11 @@ Spring:
 
 ![Spring](./images/themes/season-spring.png)
 
+Emoji:
+- Set: sunrise 🌷 🌱 🐣 🌤; work 🌿 🪴 🐝 🌼; coffee ☕; evening 🌤; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=68  Z2_BG=70  Z3_BG=72  Z4_BG=121 Z5_BG=120
 Z1_FG=255 Z2_FG=22
@@ -35,6 +45,11 @@ Summer:
 
 ![Summer](./images/themes/season-summer.png)
 
+Emoji:
+- Set: sunrise 🌞 🏖️ 🌅 🌤; work 🏄 🏖️ 🚤 🌴; coffee 🧃; evening 🌇; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=141 Z2_BG=142 Z3_BG=143 Z4_BG=214 Z5_BG=208
 Z1_FG=255 Z2_FG=0
@@ -46,6 +61,11 @@ Autumn:
 
 ![Autumn](./images/themes/season-autumn.png)
 
+Emoji:
+- Set: sunrise 🍁 🍂 🌫️ 🌦️; work 🍂 🍄 🎃 🪵; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=93  Z2_BG=95  Z3_BG=97  Z4_BG=166 Z5_BG=136
 Z1_FG=255 Z2_FG=255
@@ -63,6 +83,11 @@ Aurora (contest palette):
 
 ![Aurora (contest)](./images/themes/aurora.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=24 Z2_BG=31
 Z1_FG=255 Z2_FG=255
@@ -74,6 +99,11 @@ Neon:
 
 ![Neon](./images/themes/neon.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=201 Z1_FG=255
 Z2_BG=45  Z2_FG=16
@@ -85,6 +115,11 @@ Forge:
 
 ![Forge](./images/themes/forge.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=94  Z1_FG=230
 Z2_BG=166 Z2_FG=231
@@ -96,6 +131,11 @@ Circuit:
 
 ![Circuit](./images/themes/circuit.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=46
 FG_DIM=22
@@ -106,6 +146,11 @@ Mono:
 
 ![Mono](./images/themes/mono.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=250
 FG_DIM=240
@@ -115,6 +160,11 @@ Git:
 
 ![Git](./images/themes/git.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=61 Z1_FG=255
 Z2_BG=37 Z2_FG=255
@@ -126,6 +176,11 @@ Hawolex:
 
 ![Hawolex](./images/themes/hawolex.png)
 
+Emoji:
+- Set: sunrise 💻 🚗 🔊 🎮; work 🎧 🕹️ 📟 🧩; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=54 Z1_FG=255
 Z2_BG=31 Z2_FG=255
@@ -137,6 +192,11 @@ HawolexV2 (gradient):
 
 ![HawolexV2](./images/themes/hawolexv2.png)
 
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=54 Z2_BG=55 Z3_BG=56 Z4_BG=31 Z5_BG=30
 Z_FG=255
@@ -154,6 +214,11 @@ Christmas:
 
 ![Christmas](./images/themes/christmas.png)
 
+Emoji:
+- Set: sunrise 🎄 🎅 ❄️ ⛄; work 🎁 🧤 🧣 🦌; coffee ☕; evening 🌟; night 🕯️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=52 Z2_BG=28
 Z1_FG=255 Z2_FG=255
@@ -165,6 +230,11 @@ Easter:
 
 ![Easter](./images/themes/easter.png)
 
+Emoji:
+- Set: sunrise 🐣 🥚 🌷 🌤; work 🐰 🌼 🧺 🍫; coffee ☕; evening 🌅; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=186 Z2_BG=150
 Z1_FG=16  Z2_FG=16
@@ -176,6 +246,11 @@ Halloween:
 
 ![Halloween](./images/themes/halloween.png)
 
+Emoji:
+- Set: sunrise 🎃 🦇 🌕 🕸️; work 👻 💀 🕯️ 🧪; coffee ☕; evening 🌆; night 🕷️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=53 Z2_BG=166
 Z1_FG=255 Z2_FG=16
@@ -187,6 +262,11 @@ Valentine:
 
 ![Valentine](./images/themes/valentine.png)
 
+Emoji:
+- Set: sunrise 💖 🌹 💘 💕; work 💌 🍫 🕊️ 💗; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=198 Z2_BG=205
 Z1_FG=255 Z2_FG=255
@@ -198,6 +278,11 @@ Thanksgiving:
 
 ![Thanksgiving](./images/themes/thanksgiving.png)
 
+Emoji:
+- Set: sunrise 🦃 🍁 🥧 🍂; work 🍽️ 🌾 🧺 🥖; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=94  Z2_BG=136
 Z1_FG=230 Z2_FG=231
@@ -209,6 +294,11 @@ NewYear:
 
 ![NewYear](./images/themes/newyear.png)
 
+Emoji:
+- Set: sunrise 🎆 🥂 🎇 ✨; work 🗓️ ⏳ 🚀 ✨; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=17 Z2_BG=20
 Z1_FG=255 Z2_FG=255
@@ -225,6 +315,11 @@ Radar:
 
 ![Radar](./images/themes/radar.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FRAME=22
 FG_MAIN=46
@@ -236,6 +331,11 @@ Synthwave:
 
 ![Synthwave](./images/themes/synthwave.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=198 Z1_FG=255
 Z2_BG=45  Z2_FG=16
@@ -247,6 +347,11 @@ Noir:
 
 ![Noir](./images/themes/noir.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=250
 FG_DIM=242
@@ -258,6 +363,11 @@ Topo:
 
 ![Topo](./images/themes/topo.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 PATH_FG_LIST=109,110,111,110
 FRAME=24
@@ -267,6 +377,11 @@ Glitch:
 
 ![Glitch](./images/themes/glitch.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=118
 FG_DIM=60
@@ -277,6 +392,11 @@ ArcticFire:
 
 ![ArcticFire](./images/themes/arcticfire.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=24 Z1_FG=255
 Z2_BG=31 Z2_FG=255
@@ -288,6 +408,11 @@ AcidLime:
 
 ![AcidLime](./images/themes/acidlime.png)
 
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=46
 FG_DIM=40