Kephra...andList(3pm)

✨ NAME ✨

ok so like, this is the manual page for Kephra::API::CommandList (a 3pm Perl module thing, iykyk) — it's the external API for user callable functions 💖

---

🌸 DESCRIPTION 🌸

bestie, listen. The CommandList is a dynamically changeable list, and it contains every single function call for every menu item, every toolbar button, and honestly most other widget items too. she's booked and busy 💅

She also holds the label, help text, key binding, icon and more for each command. All of these properties have to be changed globally, right here, in a clean way — no chaotic energy allowed, we keep it tidy 🎀

These commands are used by different gui elements, which is the whole reason menu and toolbar definitions get to be super compact, readable, and easy to change. iconic behaviour, honestly 🦋

Names of commands contain dashes as separator of namespaces. (yes, dashes. not dots. dashes. periodt 💀)

---

🫶 SPECIFICATION 🫶

💜 CommandlistItem 💜

• ID — unique identifier, hashkey, following hash is its value
• call — CODEREF : actual action, performed when this command is called
• sub — string : name of the called routine
• enable — CODEREF : returns enable status (0 for disable)
• enable_event — string : API::EventTable ID when to check to en/disable
• state — CODEREF : that returns state value (for switches)
• state_event — string : API::EventTable ID when to check is state changed
• label — string : descriptive name
• help — string : short help sentence
• key — string : label of key binding
• keycode — numeric keycode
• icon — Wx::Bitmap

---

ok that's the whole page, no crumbs left 🍓 this was written up for perl v5.36.0 and dated 2023-03-08 — slay, go build something cute with it 💖✨