@manufosela/event-emitter

@manufosela/event-emitter

Lightweight pub/sub event emitter with namespaced events support

Basics

Basic usage

Subscribe handlers, emit events, and use once listeners.

Code

Wildcards

Namespaces and wildcards

* matches one segment, ** matches multiple segments.

Code

Demo code (CodePen-ready HTML, CSS, JS)
HTML (html)
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link
    href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&display=swap"
    rel="stylesheet"
  />
<main>
    <div class="container">
      <section class="demo-section">
        <div class="panel">
          <span class="badge">Basics</span>
          <h2>Basic usage</h2>
          <p>Subscribe handlers, emit events, and use once listeners.</p>
          <button id="emit-message">Emit message</button>
          <button id="emit-login">Emit user:login</button>
          <button id="emit-logout">Emit user:logout</button>
          <button id="emit-once">Emit init (once)</button>
          <div class="output" id="output-basic"></div>
        </div>
        <div class="panel">
          <h2>Code</h2>
          <div class="code-block" data-code="basic"></div>
        </div>
      </section>

      <section class="demo-section">
        <div class="panel">
          <span class="badge">Wildcards</span>
          <h2>Namespaces and wildcards</h2>
          <p><strong>*</strong> matches one segment, <strong>**</strong> matches multiple segments.</p>
          <button id="emit-login-w">Emit user:login</button>
          <button id="emit-logout-w">Emit user:logout</button>
          <button id="emit-admin-w">Emit user:admin:login</button>
          <button id="emit-system-w">Emit system:ready</button>
          <div class="output" id="output-wildcards"></div>
        </div>
        <div class="panel">
          <h2>Code</h2>
          <div class="code-block" data-code="wildcards"></div>
        </div>
      </section>
    </div>
  </main>

  <template id="snippet-basic">
import { EventEmitter } from "https://esm.sh/@manufosela/event-emitter";

const emitter = new EventEmitter();

emitter.on("message", (payload) => {
  console.log("message", payload.text);
});

emitter.on("user:login", (user) => {
  console.log("user logged in", user.name);
});

emitter.once("init", () => {
  console.log("init only once");
});

emitter.emit("message", { text: "Hello World" });
emitter.emit("user:login", { id: 1, name: "John" });
emitter.emit("init");
  </template>

  <template id="snippet-wildcards">
import { EventEmitter } from "https://esm.sh/@manufosela/event-emitter";

const emitter = new EventEmitter({ wildcard: true });

// * matches a single segment (user:login, user:logout)
emitter.on("user:*", (payload) => {
  console.log("user:*", payload);
});

// ** matches multiple segments (user:admin:login)
emitter.on("user:**", (payload) => {
  console.log("user:**", payload);
});

// ** can match any event
emitter.on("**", (payload) => {
  console.log("any event", payload);
});

emitter.emit("user:login", { id: 1 });
emitter.emit("user:admin:login", { id: 2 });
emitter.emit("system:ready", { ok: true });
  </template>
CSS (css)
:root {
  --bg: #0c0f14;
  --bg-elevated: #141923;
  --bg-panel: #171d28;
  --border: #262f3f;
  --text: #f4f6fb;
  --text-muted: #a7b0c2;
  --text-dim: #7d879b;
  --accent: #ff8a3d;
  --accent-strong: #ff6a00;
  --accent-soft: rgba(255, 138, 61, 0.16);
  --shadow: 0 20px 50px rgba(5, 8, 14, 0.45);
  --radius-lg: 22px;
  --radius-md: 14px;
  --radius-sm: 10px;
  --max-width: 1160px;
}

* { box-sizing: border-box; }

    header {
      padding: 32px 24px 16px;
      border-bottom: 1px solid var(--border);
    }

    .container {
      max-width: 1100px;
      margin: 0 auto;
    }

    .top-links {
      display: flex;
      gap: 10px;
      flex-wrap: wrap;
      margin-bottom: 12px;
    }

    .top-links a {
      border: 1px solid var(--border);
      border-radius: 999px;
      padding: 6px 12px;
      color: var(--text-muted);
      font-size: 0.85rem;
      text-decoration: none;
      transition: border-color 0.2s ease, color 0.2s ease;
    }

    .top-links a:hover {
      color: var(--text);
      border-color: var(--accent);
    }

    h1 {
      margin: 0;
      font-size: clamp(28px, 4vw, 44px);
      color: var(--accent);
    }

    p {
      color: var(--text-muted);
      margin: 8px 0 0;
    }

    main {
      padding: 24px;
    }

    .demo-section {
      display: grid;
      gap: 16px;
      grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
      align-items: start;
      margin-bottom: 20px;
    }

    .panel {
      background: var(--bg-elevated);
      border: 1px solid var(--border);
      border-radius: 16px;
      padding: 18px;
    }

    .panel h2 {
      margin: 0 0 8px;
    }

    .badge {
      display: inline-flex;
      padding: 4px 10px;
      border-radius: 999px;
      border: 1px solid var(--border);
      color: var(--text-muted);
      font-size: 0.75rem;
      margin-bottom: 8px;
    }

    button {
      padding: 8px 14px;
      border-radius: 999px;
      border: none;
      background: linear-gradient(120deg, var(--accent), #ff6a00);
      color: #111;
      cursor: pointer;
      font-weight: 600;
      margin: 4px 6px 4px 0;
    }

    .output {
      margin-top: 12px;
      background: #0b0f1a;
      border: 1px solid var(--border);
      border-radius: 12px;
      padding: 12px;
      font-size: 0.85rem;
      max-height: 240px;
      overflow-y: auto;
    }

    .log-entry { border-bottom: 1px solid #1f2537; padding: 4px 0; }
    .log-entry:last-child { border-bottom: none; }

    .code-block {
      background: #0b0f1a;
      border: 1px solid var(--border);
      border-radius: 12px;
      padding: 12px;
      font-size: 0.85rem;
      color: #d6d9e6;
      white-space: pre-wrap;
    }
  


:root {
  --bg: #0f1117;
  --bg-2: #151a26;
  --bg-spot-1: #1a2136;
  --bg-spot-2: #1d1b34;
  --card: #1c2233;
  --text: #f3f6ff;
  --muted: #b8c0d9;
  --line: #2b3247;
  --accent: #ffb000;
  --accent-2: #00d0ff;
  --surface: #0b0f1a;
  --code-bg: #0b0f1a;
  --code-text: #d6d9e6;
}

:root.light {
  --bg: #f5f5f7;
  --bg-2: #ffffff;
  --bg-spot-1: #f8e9d0;
  --bg-spot-2: #e8eef8;
  --card: #ffffff;
  --text: #1d1d1f;
  --muted: #6b7280;
  --line: #e5e7eb;
  --accent: #ffb000;
  --accent-2: #00a7d6;
  --surface: #f3f4f6;
  --code-bg: #111827;
  --code-text: #f9fafb;
}

:root.dark {
  --bg: #0f1117;
  --bg-2: #151a26;
  --bg-spot-1: #1a2136;
  --bg-spot-2: #1d1b34;
  --card: #1c2233;
  --text: #f3f6ff;
  --muted: #b8c0d9;
  --line: #2b3247;
  --accent: #ffb000;
  --accent-2: #00d0ff;
  --surface: #0b0f1a;
  --code-bg: #0b0f1a;
  --code-text: #d6d9e6;
}

h1 {
  color: var(--accent) !important;
}

.top-links a,
.topbar a {
  color: var(--muted) !important;
  border-color: var(--line) !important;
}

.top-links a:hover,
.topbar a:hover {
  color: var(--text) !important;
}

.card,
.section,
.demo-section,
.panel {
  background: var(--card) !important;
  border-color: var(--line) !important;
  color: var(--text) !important;
}

.code-block,
pre,
code,
.output,
.current-url,
.event-log,
.result-card,
.log {
  background: var(--code-bg) !important;
  color: var(--code-text) !important;
  border-color: var(--line) !important;
}

input,
select,
textarea {
  background: var(--surface) !important;
  color: var(--text) !important;
  border-color: var(--line) !important;
}

button {
  background: linear-gradient(120deg, var(--accent), #ff6a00) !important;
  color: #111 !important;
}

footer {
  color: var(--muted) !important;
}

footer a {
  color: var(--text) !important;
}
JS (js)
import { EventEmitter } from "https://esm.sh/@manufosela/event-emitter";

    const emitterBasic = new EventEmitter({ wildcard: true });
    const emitterWild = new EventEmitter({ wildcard: true });

    const outputBasic = document.getElementById("output-basic");
    const outputWild = document.getElementById("output-wildcards");

    const log = (container, message) => {
      const entry = document.createElement("div");
      entry.className = "log-entry";
      entry.textContent = message;
      container.prepend(entry);
    };

    emitterBasic.on("message", (data) => log(outputBasic, `message: ${JSON.stringify(data)}`));
    emitterBasic.on("user:login", (user) => log(outputBasic, `user:login: ${user.name}`));
    emitterBasic.on("user:logout", (user) => log(outputBasic, `user:logout: ${user.name}`));
    emitterBasic.once("init", () => log(outputBasic, "init received (once)"));

    document.getElementById("emit-message").addEventListener("click", () => {
      emitterBasic.emit("message", { text: "Hello World!", timestamp: Date.now() });
    });
    document.getElementById("emit-login").addEventListener("click", () => {
      emitterBasic.emit("user:login", { id: 1, name: "John Doe" });
    });
    document.getElementById("emit-logout").addEventListener("click", () => {
      emitterBasic.emit("user:logout", { id: 1, name: "John Doe" });
    });
    document.getElementById("emit-once").addEventListener("click", () => {
      emitterBasic.emit("init");
      log(outputBasic, "init emitted");
    });

    emitterWild.on("user:*", () => log(outputWild, "Matched user:*"));
    emitterWild.on("user:**", () => log(outputWild, "Matched user:**"));
    emitterWild.on("**", () => log(outputWild, "Matched ** (any event)"));

    document.getElementById("emit-login-w").addEventListener("click", () => {
      emitterWild.emit("user:login", { id: 1 });
    });
    document.getElementById("emit-logout-w").addEventListener("click", () => {
      emitterWild.emit("user:logout", { id: 1 });
    });
    document.getElementById("emit-admin-w").addEventListener("click", () => {
      emitterWild.emit("user:admin:login", { id: 2 });
    });
    document.getElementById("emit-system-w").addEventListener("click", () => {
      emitterWild.emit("system:ready", { ok: true });
    });

    const snippets = {
      basic: document.getElementById("snippet-basic"),
      wildcards: document.getElementById("snippet-wildcards"),
    };

    document.querySelectorAll("[data-code]").forEach((block) => {
      const key = block.dataset.code;
      if (snippets[key]) {
        block.textContent = snippets[key].innerHTML.trim();
      }
    });
  

class DemoThemeToggle extends HTMLElement {
  constructor() {
    super();
    this.attachShadow({ mode: 'open' });
    this.handleClick = this.handleClick.bind(this);
  }

  connectedCallback() {
    const saved = localStorage.getItem('utils-demo-theme');
    document.documentElement.classList.remove('dark');
    document.documentElement.classList.toggle('light', saved === 'light');

    this.render();
  }

  render() {
    const isLight = document.documentElement.classList.contains('light');
    this.shadowRoot.innerHTML = `
      <style>
        :host {
          display: inline-flex;
        }
        .toggle {
          display: inline-flex;
          align-items: center;
          border: 1px solid var(--line);
          border-radius: 999px;
          overflow: hidden;
          background: var(--surface);
        }
        button {
          border: none;
          background: transparent;
          color: var(--muted);
          padding: 6px 12px;
          font-size: 0.8rem;
          cursor: pointer;
          font-family: "Space Grotesk", "Trebuchet MS", Arial, sans-serif;
        }
        button.active {
          background: linear-gradient(120deg, var(--accent), #ff6a00);
          color: #111;
          font-weight: 600;
        }
      </style>
      <div class="toggle" role="group" aria-label="Theme toggle">
        <button class="${isLight ? 'active' : ''}" data-theme="light">Light</button>
        <button class="${isLight ? '' : 'active'}" data-theme="dark">Dark</button>
      </div>
    `;

    this.shadowRoot.querySelectorAll('button').forEach((btn) => {
      btn.addEventListener('click', this.handleClick);
    });
  }

  handleClick(event) {
    const theme = event.currentTarget.dataset.theme;
    const isLight = theme === 'light';
    document.documentElement.classList.toggle('light', isLight);
    document.documentElement.classList.remove('dark');
    localStorage.setItem('utils-demo-theme', isLight ? 'light' : 'dark');
    this.render();
  }
}

customElements.define('demo-theme-toggle', DemoThemeToggle);