@magic-spells/tab-group 0.1.0

package/dist/tab-group.cjs.js

@@ -0,0 +1,274 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * @module TabGroup
+ * A fully accessible tab group web component
+ */
+
+/**
+ * @class TabGroup
+ * the parent container that coordinates tabs and panels
+ */
+class TabGroup extends HTMLElement {
+	// static counter to ensure global unique ids for tabs and panels
+	static tabCount = 0;
+	static panelCount = 0;
+
+	constructor() {
+		super();
+		// ensure that the number of <tab-button> and <tab-panel> elements match
+		// note: in some scenarios the child elements might not be available in the constructor,
+		// so adjust as necessary or consider running this check in connectedCallback()
+		this.ensureConsistentTabsAndPanels();
+	}
+
+	/**
+	 * @function ensureConsistentTabsAndPanels
+	 * makes sure there is an equal number of <tab-button> and <tab-panel> elements.
+	 * if there are more panels than tabs, inject extra tab buttons.
+	 * if there are more tabs than panels, inject extra panels.
+	 */
+	ensureConsistentTabsAndPanels() {
+		// get current tabs and panels within the tab group
+		let tabs = this.querySelectorAll("tab-button");
+		let panels = this.querySelectorAll("tab-panel");
+
+		// if there are more panels than tabs
+		if (panels.length > tabs.length) {
+			const difference = panels.length - tabs.length;
+			// try to find a <tab-list> to insert new tabs
+			let tabList = this.querySelector("tab-list");
+			if (!tabList) {
+				// if not present, create one and insert it at the beginning
+				tabList = document.createElement("tab-list");
+				this.insertBefore(tabList, this.firstChild);
+			}
+			// inject extra <tab-button> elements into the tab list
+			for (let i = 0; i < difference; i++) {
+				const newTab = document.createElement("tab-button");
+				newTab.textContent = "default tab";
+				tabList.appendChild(newTab);
+			}
+		}
+		// if there are more tabs than panels
+		else if (tabs.length > panels.length) {
+			const difference = tabs.length - panels.length;
+			// inject extra <tab-panel> elements at the end of the tab group
+			for (let i = 0; i < difference; i++) {
+				const newPanel = document.createElement("tab-panel");
+				newPanel.innerHTML = "<p>default panel content</p>";
+				this.appendChild(newPanel);
+			}
+		}
+	}
+
+	/**
+	 * called when the element is connected to the dom
+	 */
+	connectedCallback() {
+		const _ = this;
+
+		// find the <tab-list> element (should be exactly one)
+		_.tabList = _.querySelector("tab-list");
+		if (!_.tabList) return;
+
+		// find all <tab-button> elements inside the <tab-list>
+		_.tabButtons = Array.from(_.tabList.querySelectorAll("tab-button"));
+
+		// find all <tab-panel> elements inside the <tab-group>
+		_.tabPanels = Array.from(_.querySelectorAll("tab-panel"));
+
+		// initialize each tab-button with roles, ids and aria attributes
+		_.tabButtons.forEach((tab, index) => {
+			const tabIndex = TabGroup.tabCount++;
+
+			// generate a unique id for each tab, e.g. "tab-0", "tab-1", ...
+			const tabId = `tab-${tabIndex}`;
+			tab.id = tabId;
+
+			// generate a corresponding panel id, e.g. "panel-0"
+			const panelId = `panel-${tabIndex}`;
+			tab.setAttribute("role", "tab");
+			tab.setAttribute("aria-controls", panelId);
+
+			// first tab is active by default
+			if (index === 0) {
+				tab.setAttribute("aria-selected", "true");
+				tab.setAttribute("tabindex", "0");
+			} else {
+				tab.setAttribute("aria-selected", "false");
+				tab.setAttribute("tabindex", "-1");
+			}
+		});
+
+		// initialize each tab-panel with roles, ids and aria attributes
+		_.tabPanels.forEach((panel, index) => {
+			const panelIndex = TabGroup.panelCount++;
+			const panelId = `panel-${panelIndex}`;
+			panel.id = panelId;
+
+			panel.setAttribute("role", "tabpanel");
+			panel.setAttribute("aria-labelledby", `tab-${panelIndex}`);
+
+			// hide panels except for the first one
+			panel.hidden = index !== 0;
+		});
+
+		// set up keyboard navigation and click delegation on the <tab-list>
+		_.tabList.setAttribute("role", "tablist");
+		_.tabList.addEventListener("keydown", (e) => _.onKeyDown(e));
+		_.tabList.addEventListener("click", (e) => _.onClick(e));
+	}
+
+	/**
+	 * @function setActiveTab
+	 * activates a tab and updates aria attributes
+	 * @param {number} index - index of the tab to activate
+	 */
+	setActiveTab(index) {
+		const _ = this;
+		const previousIndex = _.tabButtons.findIndex(tab => tab.getAttribute("aria-selected") === "true");
+
+		// update each tab-button
+		_.tabButtons.forEach((tab, i) => {
+			const isActive = i === index;
+			tab.setAttribute("aria-selected", isActive ? "true" : "false");
+			tab.setAttribute("tabindex", isActive ? "0" : "-1");
+			if (isActive) {
+				tab.focus();
+			}
+		});
+
+		// update each tab-panel
+		_.tabPanels.forEach((panel, i) => {
+			panel.hidden = i !== index;
+		});
+
+		// dispatch event only if the tab actually changed
+		if (previousIndex !== index) {
+			const detail = {
+				previousIndex,
+				currentIndex: index,
+				previousTab: _.tabButtons[previousIndex],
+				currentTab: _.tabButtons[index],
+				previousPanel: _.tabPanels[previousIndex],
+				currentPanel: _.tabPanels[index]
+			};
+			_.dispatchEvent(new CustomEvent('tabchange', { detail, bubbles: true }));
+		}
+	}
+
+	/**
+	 * @function onClick
+	 * handles click events on the <tab-list> via event delegation
+	 * @param {MouseEvent} e - the click event
+	 */
+	onClick(e) {
+		const _ = this;
+		// check if the click occurred on or within a <tab-button>
+		const tabButton = e.target.closest("tab-button");
+		if (!tabButton) return;
+
+		// determine the index of the clicked tab-button
+		const index = _.tabButtons.indexOf(tabButton);
+		if (index === -1) return;
+
+		// activate the tab with the corresponding index
+		_.setActiveTab(index);
+	}
+
+	/**
+	 * @function onKeyDown
+	 * handles keyboard navigation for the tabs
+	 * @param {KeyboardEvent} e - the keydown event
+	 */
+	onKeyDown(e) {
+		const _ = this;
+		// only process keys if focus is on a <tab-button>
+		const targetIndex = _.tabButtons.indexOf(e.target);
+		if (targetIndex === -1) return;
+
+		let newIndex = targetIndex;
+		switch (e.key) {
+			case "ArrowLeft":
+			case "ArrowUp":
+				// move to the previous tab (wrap around if necessary)
+				newIndex = targetIndex > 0 ? targetIndex - 1 : _.tabButtons.length - 1;
+				e.preventDefault();
+				break;
+			case "ArrowRight":
+			case "ArrowDown":
+				// move to the next tab (wrap around if necessary)
+				newIndex = (targetIndex + 1) % _.tabButtons.length;
+				e.preventDefault();
+				break;
+			case "Home":
+				// jump to the first tab
+				newIndex = 0;
+				e.preventDefault();
+				break;
+			case "End":
+				// jump to the last tab
+				newIndex = _.tabButtons.length - 1;
+				e.preventDefault();
+				break;
+			default:
+				return; // ignore other keys
+		}
+		_.setActiveTab(newIndex);
+	}
+}
+
+/**
+ * @class TabList
+ * a container for the <tab-button> elements
+ */
+class TabList extends HTMLElement {
+	constructor() {
+		super();
+	}
+
+	connectedCallback() {
+		// additional logic or styling can be added here if desired
+	}
+}
+
+/**
+ * @class TabButton
+ * a single tab button element
+ */
+class TabButton extends HTMLElement {
+	constructor() {
+		super();
+	}
+
+	connectedCallback() {
+		// note: role and other attributes are handled by the parent
+	}
+}
+
+/**
+ * @class TabPanel
+ * a single tab panel element
+ */
+class TabPanel extends HTMLElement {
+	constructor() {
+		super();
+	}
+
+	connectedCallback() {
+		// note: role and other attributes are handled by the parent
+	}
+}
+
+// define the custom elements
+customElements.define("tab-group", TabGroup);
+customElements.define("tab-list", TabList);
+customElements.define("tab-button", TabButton);
+customElements.define("tab-panel", TabPanel);
+
+exports.TabGroup = TabGroup;
+exports.default = TabGroup;
+//# sourceMappingURL=tab-group.cjs.js.map

package/dist/tab-group.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-group.cjs.js","sources":["../src/tab-group.js"],"sourcesContent":["import './index.scss';\n\n/**\n * @module TabGroup\n * A fully accessible tab group web component\n */\n\n/**\n * @class TabGroup\n * the parent container that coordinates tabs and panels\n */\nexport default class TabGroup extends HTMLElement {\n\t// static counter to ensure global unique ids for tabs and panels\n\tstatic tabCount = 0;\n\tstatic panelCount = 0;\n\n\tconstructor() {\n\t\tsuper();\n\t\t// ensure that the number of <tab-button> and <tab-panel> elements match\n\t\t// note: in some scenarios the child elements might not be available in the constructor,\n\t\t// so adjust as necessary or consider running this check in connectedCallback()\n\t\tthis.ensureConsistentTabsAndPanels();\n\t}\n\n\t/**\n\t * @function ensureConsistentTabsAndPanels\n\t * makes sure there is an equal number of <tab-button> and <tab-panel> elements.\n\t * if there are more panels than tabs, inject extra tab buttons.\n\t * if there are more tabs than panels, inject extra panels.\n\t */\n\tensureConsistentTabsAndPanels() {\n\t\t// get current tabs and panels within the tab group\n\t\tlet tabs = this.querySelectorAll(\"tab-button\");\n\t\tlet panels = this.querySelectorAll(\"tab-panel\");\n\n\t\t// if there are more panels than tabs\n\t\tif (panels.length > tabs.length) {\n\t\t\tconst difference = panels.length - tabs.length;\n\t\t\t// try to find a <tab-list> to insert new tabs\n\t\t\tlet tabList = this.querySelector(\"tab-list\");\n\t\t\tif (!tabList) {\n\t\t\t\t// if not present, create one and insert it at the beginning\n\t\t\t\ttabList = document.createElement(\"tab-list\");\n\t\t\t\tthis.insertBefore(tabList, this.firstChild);\n\t\t\t}\n\t\t\t// inject extra <tab-button> elements into the tab list\n\t\t\tfor (let i = 0; i < difference; i++) {\n\t\t\t\tconst newTab = document.createElement(\"tab-button\");\n\t\t\t\tnewTab.textContent = \"default tab\";\n\t\t\t\ttabList.appendChild(newTab);\n\t\t\t}\n\t\t}\n\t\t// if there are more tabs than panels\n\t\telse if (tabs.length > panels.length) {\n\t\t\tconst difference = tabs.length - panels.length;\n\t\t\t// inject extra <tab-panel> elements at the end of the tab group\n\t\t\tfor (let i = 0; i < difference; i++) {\n\t\t\t\tconst newPanel = document.createElement(\"tab-panel\");\n\t\t\t\tnewPanel.innerHTML = \"<p>default panel content</p>\";\n\t\t\t\tthis.appendChild(newPanel);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * called when the element is connected to the dom\n\t */\n\tconnectedCallback() {\n\t\tconst _ = this;\n\n\t\t// find the <tab-list> element (should be exactly one)\n\t\t_.tabList = _.querySelector(\"tab-list\");\n\t\tif (!_.tabList) return;\n\n\t\t// find all <tab-button> elements inside the <tab-list>\n\t\t_.tabButtons = Array.from(_.tabList.querySelectorAll(\"tab-button\"));\n\n\t\t// find all <tab-panel> elements inside the <tab-group>\n\t\t_.tabPanels = Array.from(_.querySelectorAll(\"tab-panel\"));\n\n\t\t// initialize each tab-button with roles, ids and aria attributes\n\t\t_.tabButtons.forEach((tab, index) => {\n\t\t\tconst tabIndex = TabGroup.tabCount++;\n\n\t\t\t// generate a unique id for each tab, e.g. \"tab-0\", \"tab-1\", ...\n\t\t\tconst tabId = `tab-${tabIndex}`;\n\t\t\ttab.id = tabId;\n\n\t\t\t// generate a corresponding panel id, e.g. \"panel-0\"\n\t\t\tconst panelId = `panel-${tabIndex}`;\n\t\t\ttab.setAttribute(\"role\", \"tab\");\n\t\t\ttab.setAttribute(\"aria-controls\", panelId);\n\n\t\t\t// first tab is active by default\n\t\t\tif (index === 0) {\n\t\t\t\ttab.setAttribute(\"aria-selected\", \"true\");\n\t\t\t\ttab.setAttribute(\"tabindex\", \"0\");\n\t\t\t} else {\n\t\t\t\ttab.setAttribute(\"aria-selected\", \"false\");\n\t\t\t\ttab.setAttribute(\"tabindex\", \"-1\");\n\t\t\t}\n\t\t});\n\n\t\t// initialize each tab-panel with roles, ids and aria attributes\n\t\t_.tabPanels.forEach((panel, index) => {\n\t\t\tconst panelIndex = TabGroup.panelCount++;\n\t\t\tconst panelId = `panel-${panelIndex}`;\n\t\t\tpanel.id = panelId;\n\n\t\t\tpanel.setAttribute(\"role\", \"tabpanel\");\n\t\t\tpanel.setAttribute(\"aria-labelledby\", `tab-${panelIndex}`);\n\n\t\t\t// hide panels except for the first one\n\t\t\tpanel.hidden = index !== 0;\n\t\t});\n\n\t\t// set up keyboard navigation and click delegation on the <tab-list>\n\t\t_.tabList.setAttribute(\"role\", \"tablist\");\n\t\t_.tabList.addEventListener(\"keydown\", (e) => _.onKeyDown(e));\n\t\t_.tabList.addEventListener(\"click\", (e) => _.onClick(e));\n\t}\n\n\t/**\n\t * @function setActiveTab\n\t * activates a tab and updates aria attributes\n\t * @param {number} index - index of the tab to activate\n\t */\n\tsetActiveTab(index) {\n\t\tconst _ = this;\n\t\tconst previousIndex = _.tabButtons.findIndex(tab => tab.getAttribute(\"aria-selected\") === \"true\");\n\n\t\t// update each tab-button\n\t\t_.tabButtons.forEach((tab, i) => {\n\t\t\tconst isActive = i === index;\n\t\t\ttab.setAttribute(\"aria-selected\", isActive ? \"true\" : \"false\");\n\t\t\ttab.setAttribute(\"tabindex\", isActive ? \"0\" : \"-1\");\n\t\t\tif (isActive) {\n\t\t\t\ttab.focus();\n\t\t\t}\n\t\t});\n\n\t\t// update each tab-panel\n\t\t_.tabPanels.forEach((panel, i) => {\n\t\t\tpanel.hidden = i !== index;\n\t\t});\n\n\t\t// dispatch event only if the tab actually changed\n\t\tif (previousIndex !== index) {\n\t\t\tconst detail = {\n\t\t\t\tpreviousIndex,\n\t\t\t\tcurrentIndex: index,\n\t\t\t\tpreviousTab: _.tabButtons[previousIndex],\n\t\t\t\tcurrentTab: _.tabButtons[index],\n\t\t\t\tpreviousPanel: _.tabPanels[previousIndex],\n\t\t\t\tcurrentPanel: _.tabPanels[index]\n\t\t\t};\n\t\t\t_.dispatchEvent(new CustomEvent('tabchange', { detail, bubbles: true }));\n\t\t}\n\t}\n\n\t/**\n\t * @function onClick\n\t * handles click events on the <tab-list> via event delegation\n\t * @param {MouseEvent} e - the click event\n\t */\n\tonClick(e) {\n\t\tconst _ = this;\n\t\t// check if the click occurred on or within a <tab-button>\n\t\tconst tabButton = e.target.closest(\"tab-button\");\n\t\tif (!tabButton) return;\n\n\t\t// determine the index of the clicked tab-button\n\t\tconst index = _.tabButtons.indexOf(tabButton);\n\t\tif (index === -1) return;\n\n\t\t// activate the tab with the corresponding index\n\t\t_.setActiveTab(index);\n\t}\n\n\t/**\n\t * @function onKeyDown\n\t * handles keyboard navigation for the tabs\n\t * @param {KeyboardEvent} e - the keydown event\n\t */\n\tonKeyDown(e) {\n\t\tconst _ = this;\n\t\t// only process keys if focus is on a <tab-button>\n\t\tconst targetIndex = _.tabButtons.indexOf(e.target);\n\t\tif (targetIndex === -1) return;\n\n\t\tlet newIndex = targetIndex;\n\t\tswitch (e.key) {\n\t\t\tcase \"ArrowLeft\":\n\t\t\tcase \"ArrowUp\":\n\t\t\t\t// move to the previous tab (wrap around if necessary)\n\t\t\t\tnewIndex = targetIndex > 0 ? targetIndex - 1 : _.tabButtons.length - 1;\n\t\t\t\te.preventDefault();\n\t\t\t\tbreak;\n\t\t\tcase \"ArrowRight\":\n\t\t\tcase \"ArrowDown\":\n\t\t\t\t// move to the next tab (wrap around if necessary)\n\t\t\t\tnewIndex = (targetIndex + 1) % _.tabButtons.length;\n\t\t\t\te.preventDefault();\n\t\t\t\tbreak;\n\t\t\tcase \"Home\":\n\t\t\t\t// jump to the first tab\n\t\t\t\tnewIndex = 0;\n\t\t\t\te.preventDefault();\n\t\t\t\tbreak;\n\t\t\tcase \"End\":\n\t\t\t\t// jump to the last tab\n\t\t\t\tnewIndex = _.tabButtons.length - 1;\n\t\t\t\te.preventDefault();\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\treturn; // ignore other keys\n\t\t}\n\t\t_.setActiveTab(newIndex);\n\t}\n}\n\n/**\n * @class TabList\n * a container for the <tab-button> elements\n */\nclass TabList extends HTMLElement {\n\tconstructor() {\n\t\tsuper();\n\t\tconst _ = this;\n\t}\n\n\tconnectedCallback() {\n\t\tconst _ = this;\n\t\t// additional logic or styling can be added here if desired\n\t}\n}\n\n/**\n * @class TabButton\n * a single tab button element\n */\nclass TabButton extends HTMLElement {\n\tconstructor() {\n\t\tsuper();\n\t\tconst _ = this;\n\t}\n\n\tconnectedCallback() {\n\t\tconst _ = this;\n\t\t// note: role and other attributes are handled by the parent\n\t}\n}\n\n/**\n * @class TabPanel\n * a single tab panel element\n */\nclass TabPanel extends HTMLElement {\n\tconstructor() {\n\t\tsuper();\n\t\tconst _ = this;\n\t}\n\n\tconnectedCallback() {\n\t\tconst _ = this;\n\t\t// note: role and other attributes are handled by the parent\n\t}\n}\n\n// define the custom elements\ncustomElements.define(\"tab-group\", TabGroup);\ncustomElements.define(\"tab-list\", TabList);\ncustomElements.define(\"tab-button\", TabButton);\ncustomElements.define(\"tab-panel\", TabPanel);\n\n// export the main component\nexport { TabGroup };\n"],"names":[],"mappings":"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"}

package/dist/tab-group.css

@@ -0,0 +1,95 @@
+tab-group {
+  display: block;
+  width: 100%;
+  font-family: var(--font-family);
+  font-size: var(--font-size-base);
+  line-height: var(--line-height);
+  color: var(--color-text);
+}
+
+tab-list {
+  display: flex;
+  border-bottom: var(--tab-list-border-bottom, 1px solid var(--color-border));
+  margin-bottom: var(--spacing-md);
+  overflow-x: auto;
+  overflow-y: hidden;
+  padding: var(--tab-list-padding, 0.5rem 0.25rem 0);
+  gap: var(--tab-list-gap, 0.25rem);
+  justify-content: var(--tab-list-justify, flex-start);
+  background-color: var(--tab-list-background, transparent);
+  background-image: var(--tab-list-background-image, none);
+  border-radius: var(--tab-list-radius, 0);
+}
+
+tab-button {
+  display: block;
+  padding: var(--spacing-sm) var(--spacing-md);
+  margin: var(--spacing-xs);
+  border: 1px solid transparent;
+  border-bottom: none;
+  background-color: var(--color-background);
+  color: var(--color-text);
+  cursor: pointer;
+  border-radius: var(--tab-button-radius, var(--border-radius) var(--border-radius) 0 0);
+  white-space: nowrap;
+  user-select: none;
+  transition: all var(--transition-duration);
+  margin-bottom: -1px;
+  position: relative;
+  font-size: var(--font-size-base);
+  font-weight: var(--tab-button-font-weight, normal);
+  text-align: center;
+  min-width: 100px;
+}
+tab-button:hover {
+  background-color: var(--color-hover);
+}
+tab-button:focus {
+  outline: none;
+  box-shadow: var(--tab-button-focus-shadow, 0 0 0 2px var(--color-primary));
+}
+tab-button[aria-selected=true] {
+  background-color: var(--tab-active-background, var(--color-background));
+  border-color: var(--color-border);
+  border-bottom: 1px solid var(--color-background);
+  font-weight: var(--tab-active-font-weight, 600);
+  color: var(--tab-active-color, var(--color-primary));
+  box-shadow: var(--tab-active-shadow, none);
+  transform: var(--tab-active-transform, none);
+}
+tab-button[aria-selected=true]::after {
+  content: "";
+  position: absolute;
+  bottom: 0;
+  left: var(--tab-indicator-left, 0);
+  right: var(--tab-indicator-right, 0);
+  height: var(--tab-indicator-height, 2px);
+  background-color: var(--tab-indicator-color, var(--color-primary));
+  border-radius: var(--tab-indicator-radius, 0);
+}
+
+tab-panel {
+  display: block;
+  padding: var(--panel-padding, var(--spacing-md));
+  background-color: var(--panel-background, var(--color-background));
+  border-radius: var(--panel-radius, 0 0 var(--border-radius) var(--border-radius));
+  border: var(--panel-border, none);
+  border-top: var(--panel-border-top, none);
+  box-shadow: var(--panel-shadow, none);
+  transition: var(--panel-transition, all 0.3s ease);
+  margin: var(--panel-margin, 0);
+  min-height: var(--panel-min-height, 150px);
+}
+tab-panel[hidden] {
+  display: none;
+}
+
+@media (max-width: 768px) {
+  tab-list {
+    flex-wrap: wrap;
+  }
+  tab-button {
+    flex: 1 0 auto;
+    text-align: center;
+  }
+}

package/dist/tab-group.esm.js

@@ -0,0 +1,269 @@
+/**
+ * @module TabGroup
+ * A fully accessible tab group web component
+ */
+
+/**
+ * @class TabGroup
+ * the parent container that coordinates tabs and panels
+ */
+class TabGroup extends HTMLElement {
+	// static counter to ensure global unique ids for tabs and panels
+	static tabCount = 0;
+	static panelCount = 0;
+
+	constructor() {
+		super();
+		// ensure that the number of <tab-button> and <tab-panel> elements match
+		// note: in some scenarios the child elements might not be available in the constructor,
+		// so adjust as necessary or consider running this check in connectedCallback()
+		this.ensureConsistentTabsAndPanels();
+	}
+
+	/**
+	 * @function ensureConsistentTabsAndPanels
+	 * makes sure there is an equal number of <tab-button> and <tab-panel> elements.
+	 * if there are more panels than tabs, inject extra tab buttons.
+	 * if there are more tabs than panels, inject extra panels.
+	 */
+	ensureConsistentTabsAndPanels() {
+		// get current tabs and panels within the tab group
+		let tabs = this.querySelectorAll("tab-button");
+		let panels = this.querySelectorAll("tab-panel");
+
+		// if there are more panels than tabs
+		if (panels.length > tabs.length) {
+			const difference = panels.length - tabs.length;
+			// try to find a <tab-list> to insert new tabs
+			let tabList = this.querySelector("tab-list");
+			if (!tabList) {
+				// if not present, create one and insert it at the beginning
+				tabList = document.createElement("tab-list");
+				this.insertBefore(tabList, this.firstChild);
+			}
+			// inject extra <tab-button> elements into the tab list
+			for (let i = 0; i < difference; i++) {
+				const newTab = document.createElement("tab-button");
+				newTab.textContent = "default tab";
+				tabList.appendChild(newTab);
+			}
+		}
+		// if there are more tabs than panels
+		else if (tabs.length > panels.length) {
+			const difference = tabs.length - panels.length;
+			// inject extra <tab-panel> elements at the end of the tab group
+			for (let i = 0; i < difference; i++) {
+				const newPanel = document.createElement("tab-panel");
+				newPanel.innerHTML = "<p>default panel content</p>";
+				this.appendChild(newPanel);
+			}
+		}
+	}
+
+	/**
+	 * called when the element is connected to the dom
+	 */
+	connectedCallback() {
+		const _ = this;
+
+		// find the <tab-list> element (should be exactly one)
+		_.tabList = _.querySelector("tab-list");
+		if (!_.tabList) return;
+
+		// find all <tab-button> elements inside the <tab-list>
+		_.tabButtons = Array.from(_.tabList.querySelectorAll("tab-button"));
+
+		// find all <tab-panel> elements inside the <tab-group>
+		_.tabPanels = Array.from(_.querySelectorAll("tab-panel"));
+
+		// initialize each tab-button with roles, ids and aria attributes
+		_.tabButtons.forEach((tab, index) => {
+			const tabIndex = TabGroup.tabCount++;
+
+			// generate a unique id for each tab, e.g. "tab-0", "tab-1", ...
+			const tabId = `tab-${tabIndex}`;
+			tab.id = tabId;
+
+			// generate a corresponding panel id, e.g. "panel-0"
+			const panelId = `panel-${tabIndex}`;
+			tab.setAttribute("role", "tab");
+			tab.setAttribute("aria-controls", panelId);
+
+			// first tab is active by default
+			if (index === 0) {
+				tab.setAttribute("aria-selected", "true");
+				tab.setAttribute("tabindex", "0");
+			} else {
+				tab.setAttribute("aria-selected", "false");
+				tab.setAttribute("tabindex", "-1");
+			}
+		});
+
+		// initialize each tab-panel with roles, ids and aria attributes
+		_.tabPanels.forEach((panel, index) => {
+			const panelIndex = TabGroup.panelCount++;
+			const panelId = `panel-${panelIndex}`;
+			panel.id = panelId;
+
+			panel.setAttribute("role", "tabpanel");
+			panel.setAttribute("aria-labelledby", `tab-${panelIndex}`);
+
+			// hide panels except for the first one
+			panel.hidden = index !== 0;
+		});
+
+		// set up keyboard navigation and click delegation on the <tab-list>
+		_.tabList.setAttribute("role", "tablist");
+		_.tabList.addEventListener("keydown", (e) => _.onKeyDown(e));
+		_.tabList.addEventListener("click", (e) => _.onClick(e));
+	}
+
+	/**
+	 * @function setActiveTab
+	 * activates a tab and updates aria attributes
+	 * @param {number} index - index of the tab to activate
+	 */
+	setActiveTab(index) {
+		const _ = this;
+		const previousIndex = _.tabButtons.findIndex(tab => tab.getAttribute("aria-selected") === "true");
+
+		// update each tab-button
+		_.tabButtons.forEach((tab, i) => {
+			const isActive = i === index;
+			tab.setAttribute("aria-selected", isActive ? "true" : "false");
+			tab.setAttribute("tabindex", isActive ? "0" : "-1");
+			if (isActive) {
+				tab.focus();
+			}
+		});
+
+		// update each tab-panel
+		_.tabPanels.forEach((panel, i) => {
+			panel.hidden = i !== index;
+		});
+
+		// dispatch event only if the tab actually changed
+		if (previousIndex !== index) {
+			const detail = {
+				previousIndex,
+				currentIndex: index,
+				previousTab: _.tabButtons[previousIndex],
+				currentTab: _.tabButtons[index],
+				previousPanel: _.tabPanels[previousIndex],
+				currentPanel: _.tabPanels[index]
+			};
+			_.dispatchEvent(new CustomEvent('tabchange', { detail, bubbles: true }));
+		}
+	}
+
+	/**
+	 * @function onClick
+	 * handles click events on the <tab-list> via event delegation
+	 * @param {MouseEvent} e - the click event
+	 */
+	onClick(e) {
+		const _ = this;
+		// check if the click occurred on or within a <tab-button>
+		const tabButton = e.target.closest("tab-button");
+		if (!tabButton) return;
+
+		// determine the index of the clicked tab-button
+		const index = _.tabButtons.indexOf(tabButton);
+		if (index === -1) return;
+
+		// activate the tab with the corresponding index
+		_.setActiveTab(index);
+	}
+
+	/**
+	 * @function onKeyDown
+	 * handles keyboard navigation for the tabs
+	 * @param {KeyboardEvent} e - the keydown event
+	 */
+	onKeyDown(e) {
+		const _ = this;
+		// only process keys if focus is on a <tab-button>
+		const targetIndex = _.tabButtons.indexOf(e.target);
+		if (targetIndex === -1) return;
+
+		let newIndex = targetIndex;
+		switch (e.key) {
+			case "ArrowLeft":
+			case "ArrowUp":
+				// move to the previous tab (wrap around if necessary)
+				newIndex = targetIndex > 0 ? targetIndex - 1 : _.tabButtons.length - 1;
+				e.preventDefault();
+				break;
+			case "ArrowRight":
+			case "ArrowDown":
+				// move to the next tab (wrap around if necessary)
+				newIndex = (targetIndex + 1) % _.tabButtons.length;
+				e.preventDefault();
+				break;
+			case "Home":
+				// jump to the first tab
+				newIndex = 0;
+				e.preventDefault();
+				break;
+			case "End":
+				// jump to the last tab
+				newIndex = _.tabButtons.length - 1;
+				e.preventDefault();
+				break;
+			default:
+				return; // ignore other keys
+		}
+		_.setActiveTab(newIndex);
+	}
+}
+
+/**
+ * @class TabList
+ * a container for the <tab-button> elements
+ */
+class TabList extends HTMLElement {
+	constructor() {
+		super();
+	}
+
+	connectedCallback() {
+		// additional logic or styling can be added here if desired
+	}
+}
+
+/**
+ * @class TabButton
+ * a single tab button element
+ */
+class TabButton extends HTMLElement {
+	constructor() {
+		super();
+	}
+
+	connectedCallback() {
+		// note: role and other attributes are handled by the parent
+	}
+}
+
+/**
+ * @class TabPanel
+ * a single tab panel element
+ */
+class TabPanel extends HTMLElement {
+	constructor() {
+		super();
+	}
+
+	connectedCallback() {
+		// note: role and other attributes are handled by the parent
+	}
+}
+
+// define the custom elements
+customElements.define("tab-group", TabGroup);
+customElements.define("tab-list", TabList);
+customElements.define("tab-button", TabButton);
+customElements.define("tab-panel", TabPanel);
+
+export { TabGroup, TabGroup as default };
+//# sourceMappingURL=tab-group.esm.js.map