@manufosela/event-bus-webcomponent
DOM CustomEvent bus for web components with source/target envelopes.
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 grid">
<section class="card control-card">
<h2>Send events</h2>
<div class="control-row">
<span class="pill">Sender</span>
<select id="senderSelect">
<option value="card-a">Component A</option>
<option value="card-b">Component B</option>
<option value="card-c">Component C</option>
<option value="card-d">Component D</option>
</select>
<label>
<input type="checkbox" id="excludeSelf" checked /> Broadcast: exclude sender
</label>
</div>
<div class="control-row">
<label>
Event name
<input type="text" id="eventNameInput" value="ping" />
</label>
<label style="flex: 1 1 320px;">
Payload (JSON)
<input type="text" id="payloadInput" value='{"note":"Hello"}' />
</label>
</div>
<div class="control-row">
<button data-target="card-a">Send to A</button>
<button data-target="card-b">Send to B</button>
<button data-target="card-c">Send to C</button>
<button data-target="card-d">Send to D</button>
<button class="secondary" data-group="bcd">Send to B+C+D</button>
<button class="secondary" data-group="all">Broadcast ALL</button>
</div>
<div class="code-block">import { WebComponentEventBus, ALL, ALL_TYPES } from '@manufosela/event-bus-webcomponent';
const bus = new WebComponentEventBus();
bus.on({ id: 'card-b', type: 'demo-card' }, (envelope) => {
console.log(envelope.name, envelope.detail);
});
bus.emit({
name: 'ping',
detail: { ok: true },
source: { id: 'card-a', type: 'demo-card' },
target: { id: ALL, type: ALL_TYPES, excludeSource: true }
});</div>
</section>
<section class="card">
<h3>Component A (card-a)</h3>
<div class="log" id="logA"></div>
</section>
<section class="card">
<h3>Component B (card-b)</h3>
<div class="log" id="logB"></div>
</section>
<section class="card">
<h3>Component C (card-c)</h3>
<div class="log" id="logC"></div>
</section>
<section class="card">
<h3>Component D (card-d)</h3>
<div class="log" id="logD"></div>
</section>
</div>
</main> 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;
}
h1 { margin: 0; font-size: clamp(28px, 4vw, 44px);
color: var(--accent);
}
p { margin: 8px 0 0; color: var(--text-muted); }
main { padding: 24px; }
.grid {
display: grid;
gap: 16px;
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
}
.card {
background: var(--bg-elevated);
border: 1px solid var(--border);
border-radius: 16px;
padding: 18px;
display: grid;
gap: 10px;
}
.control-card {
grid-column: 1 / -1;
display: grid;
gap: 16px;
}
.control-row {
display: flex;
flex-wrap: wrap;
gap: 10px;
align-items: center;
}
.pill {
padding: 6px 10px;
border-radius: 999px;
border: 1px solid var(--border);
color: var(--text-muted);
font-size: 0.8rem;
}
label {
font-size: 0.85rem;
color: var(--text-muted);
}
select, input[type="checkbox"] {
accent-color: var(--accent);
}
select {
background: var(--bg-panel);
color: var(--text);
border: 1px solid var(--border);
padding: 6px 10px;
border-radius: 8px;
}
button {
padding: 8px 14px;
border-radius: 999px;
border: none;
background: linear-gradient(120deg, var(--accent), #ff6a00);
color: #111;
cursor: pointer;
font-weight: 600;
}
button.secondary {
background: transparent;
color: var(--text);
border: 1px solid var(--border);
}
.log {
background: var(--bg-panel);
border: 1px solid var(--border);
border-radius: 12px;
padding: 12px;
font-size: 0.85rem;
height: 160px;
overflow-y: auto;
}
.code-block {
background: var(--bg-panel);
border: 1px solid var(--border);
border-radius: 12px;
padding: 12px;
font-size: 0.85rem;
color: #d6d9e6;
white-space: pre-wrap;
}
footer {
text-align: center;
padding: 2rem 0 3rem;
color: var(--text-muted);
}
footer a { color: var(--accent); text-decoration: none; }
: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 { WebComponentEventBus, ALL, ALL_TYPES } from "https://esm.sh/@manufosela/event-bus-webcomponent";
const bus = new WebComponentEventBus();
const components = {
'card-a': { id: 'card-a', type: 'demo-card' },
'card-b': { id: 'card-b', type: 'demo-card' },
'card-c': { id: 'card-c', type: 'demo-card' },
'card-d': { id: 'card-d', type: 'demo-card' },
};
const logs = {
'card-a': document.getElementById('logA'),
'card-b': document.getElementById('logB'),
'card-c': document.getElementById('logC'),
'card-d': document.getElementById('logD'),
};
const log = (container, message) => {
const entry = document.createElement('div');
entry.textContent = message;
container.prepend(entry);
};
Object.values(components).forEach((component) => {
bus.on(component, (envelope) => {
log(logs[component.id], `Received ${envelope.name} from ${envelope.source.id}`);
});
});
const senderSelect = document.getElementById('senderSelect');
const excludeSelf = document.getElementById('excludeSelf');
const eventNameInput = document.getElementById('eventNameInput');
const payloadInput = document.getElementById('payloadInput');
const readPayload = () => {
const raw = payloadInput.value.trim();
if (!raw) {
return {};
}
try {
return JSON.parse(raw);
} catch (error) {
return { raw };
}
};
const emitTo = (targetId) => {
const sender = components[senderSelect.value];
const target = components[targetId];
bus.emit({
name: eventNameInput.value.trim() || 'direct',
detail: { to: targetId, ...readPayload() },
source: sender,
target,
});
};
const emitGroup = (targets) => {
const sender = components[senderSelect.value];
targets.forEach((id) => {
bus.emit({
name: eventNameInput.value.trim() || 'group',
detail: { to: id, ...readPayload() },
source: sender,
target: components[id],
});
});
};
const emitAll = () => {
const sender = components[senderSelect.value];
bus.emit({
name: eventNameInput.value.trim() || 'broadcast',
detail: { note: 'Hello all', ...readPayload() },
source: sender,
target: {
id: ALL,
type: ALL_TYPES,
excludeSource: excludeSelf.checked,
},
});
};
document.querySelectorAll('button[data-target]').forEach((button) => {
button.addEventListener('click', () => emitTo(button.dataset.target));
});
document.querySelectorAll('button[data-group]').forEach((button) => {
button.addEventListener('click', () => {
if (button.dataset.group === 'bcd') {
emitGroup(['card-b', 'card-c', 'card-d']);
}
if (button.dataset.group === 'all') {
emitAll();
}
});
});
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);