@torpor/ui 0.2.0 → 0.3.0

package/dist/Popover/index.js

@@ -4,180 +4,18 @@ import Popover_default from "./Popover.torp";
 // src/Popover/PopoverContent.torp
 import PopoverContent_default from "./PopoverContent.torp";
 
-// src/Popover/PopoverContentAnchored.torp
-import PopoverContentAnchored_default from "./PopoverContentAnchored.torp";
-
-// src/Popover/PopoverContentContextual.torp
-import PopoverContentContextual_default from "./PopoverContentContextual.torp";
-
-// src/Popover/PopoverOverlay.torp
-import PopoverOverlay_default from "./PopoverOverlay.torp";
-
 // src/Popover/PopoverTrigger.torp
 import PopoverTrigger_default from "./PopoverTrigger.torp";
 
-// src/Popover/PopoverTriggerContextual.torp
-import PopoverTriggerContextual_default from "./PopoverTriggerContextual.torp";
-
-// src/Popover/PopoverTriggerHover.torp
-import PopoverTriggerHover_default from "./PopoverTriggerHover.torp";
-
 // src/Popover/showPopover.ts
 function showPopover(popover, anchor, props, target) {
   const allProps = Object.assign({}, props, { anchor });
   popover(target || anchor.parentElement || document.body, null, allProps);
 }
-
-// src/Popover/mountClickPopover.ts
-function clickPopover(node, options) {
-  const { popover, props } = options;
-  node.addEventListener("click", handleClick);
-  function handleClick(e) {
-    e.preventDefault();
-    show();
-  }
-  let div;
-  function show() {
-    if (div) {
-      document.body.removeChild(div);
-    }
-    div = document.createElement("div");
-    document.body.appendChild(div);
-    showPopover(popover, node, props, div);
-  }
-  return {
-    destroy() {
-      node.removeEventListener("click", handleClick);
-      if (div) {
-        document.body.removeChild(div);
-      }
-    }
-  };
-}
-
-// src/Popover/mountContextPopover.ts
-function contextPopover(node, options) {
-  const { popover, props } = options;
-  node.addEventListener("contextmenu", handleClick);
-  function handleClick(e) {
-    e.preventDefault();
-    show();
-  }
-  let div;
-  function show() {
-    if (div) {
-      document.body.removeChild(div);
-    }
-    div = document.createElement("div");
-    document.body.appendChild(div);
-    showPopover(popover, node, props, div);
-  }
-  return {
-    destroy() {
-      node.removeEventListener("contextmenu", handleClick);
-      if (div) {
-        document.body.removeChild(div);
-      }
-    }
-  };
-}
-
-// src/mount/hoverTrigger.ts
-function hoverTrigger(node, options) {
-  const { onHover, onExit } = options;
-  const hoverDelay = options.hoverDelay || 1e3;
-  const touchDelay = options.touchDelay || 1e3;
-  let interval;
-  node.addEventListener("mouseenter", handleMouseEnter);
-  node.addEventListener("mouseleave", handleMouseLeave);
-  node.addEventListener("mousemove", handleMouseMove);
-  node.addEventListener("touchstart", handleMouseEnter);
-  node.addEventListener("touchend", handleMouseLeave);
-  function handleMouseEnter(e) {
-    e.preventDefault();
-    if (!interval) {
-      const delay = e.type.startsWith("mouse") ? hoverDelay : touchDelay;
-      interval = setTimeout(() => onHover(node, e), delay);
-    }
-  }
-  function handleMouseLeave(e) {
-    if (interval) {
-      clearTimeout(interval);
-      interval = void 0;
-    }
-    if (onExit) {
-      onExit(node, e);
-    }
-  }
-  function handleMouseMove(e) {
-    if (interval) {
-      clearTimeout(interval);
-      interval = setTimeout(() => onHover(node, e), hoverDelay);
-    }
-  }
-  return () => {
-    node.removeEventListener("mouseenter", handleMouseEnter);
-    node.removeEventListener("mouseleave", handleMouseLeave);
-    node.removeEventListener("mousemove", handleMouseMove);
-    node.removeEventListener("touchstart", handleMouseEnter);
-    node.removeEventListener("touchend", handleMouseLeave);
-  };
-}
-
-// src/Popover/mountHoverPopover.ts
-function hoverPopover(node, options) {
-  const { popover, props, hoverDelay, touchDelay } = options;
-  let div;
-  function onHover(node2, e) {
-    if (div) {
-      document.body.removeChild(div);
-    }
-    div = document.createElement("div");
-    document.body.appendChild(div);
-    const rect = node2.getBoundingClientRect();
-    let position;
-    if (e.type.startsWith("mouse")) {
-      const me = e;
-      position = { x: me.clientX - rect.left, y: me.clientY - rect.top };
-    } else {
-      const te = e;
-      position = {
-        x: te.touches[0].clientX - rect.left,
-        y: te.touches[0].clientY - rect.top
-      };
-    }
-    const allProps = Object.assign({}, props, { anchor: node2, position });
-    showPopover(popover, node2, allProps, div);
-  }
-  function onExit() {
-    if (div) {
-      document.body.removeChild(div);
-      div = void 0;
-    }
-  }
-  return hoverTrigger(node, { onHover, onExit, hoverDelay, touchDelay });
-}
-
-// src/Popover/showPopoverPrompt.ts
-function showPopoverPrompt(popover, props, target) {
-  return new Promise((resolve) => {
-    const allProps = Object.assign({}, props, { callback: resolve });
-    popover(target || document.body, null, allProps);
-  });
-}
 export {
   Popover_default as Popover,
   PopoverContent_default as PopoverContent,
-  PopoverContentAnchored_default as PopoverContentAnchored,
-  PopoverContentContextual_default as PopoverContentContextual,
-  PopoverOverlay_default as PopoverOverlay,
   PopoverTrigger_default as PopoverTrigger,
-  PopoverTriggerContextual_default as PopoverTriggerContextual,
-  PopoverTriggerHover_default as PopoverTriggerHover,
-  clickPopover,
-  contextPopover,
-  hoverPopover,
-  showPopover,
-  showPopoverPrompt
+  showPopover
 };
 //# sourceMappingURL=index.js.map

package/dist/Popover/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Popover/showPopover.ts","../../src/Popover/mountClickPopover.ts","../../src/Popover/mountContextPopover.ts","../../src/mount/hoverTrigger.ts","../../src/Popover/mountHoverPopover.ts","../../src/Popover/showPopoverPrompt.ts"],"sourcesContent":["// TODO: Allow passing in a variable -- so that you can show an inline popover\nimport type { Component } from \"@torpor/view\";\n\n/**\n * Shows a popover component in code.\n * @param popover The popover component\n * @param anchor The element to use as an anchor for the popover component\n * @param props The properties for the popover component\n * @param target The target element to show the popover in\n * @returns The value selected by the user\n */\nexport default function showPopover(\n\tpopover: Component,\n\tanchor: HTMLElement,\n\tprops?: Record<PropertyKey, any>,\n\ttarget?: Element,\n): void {\n\t// Add the anchor element to the properties\n\tconst allProps = Object.assign({}, props, { anchor });\n\n\t// Create the popover\n\t// TODO: This needs to clean up after itself, like the mount methods do\n\tpopover(target || anchor.parentElement || document.body, null, allProps);\n}\n","import type { Component } from \"@torpor/view\";\nimport showPopover from \"./showPopover\";\n\ninterface ClickPopoverOptions {\n\tpopover: Component;\n\tprops?: Record<PropertyKey, any>;\n}\n\n/**\n * A mount directive for showing a popover when an element is clicked.\n * @param node The element to show the popover for\n * @param options Options for showing the popover, consisting of the popover component and any props\n */\nexport default function clickPopover(node: HTMLElement, options: ClickPopoverOptions) {\n\tconst { popover, props } = options;\n\n\t// Add a click event handler to the node\n\tnode.addEventListener(\"click\", handleClick);\n\n\tfunction handleClick(e: MouseEvent) {\n\t\te.preventDefault();\n\t\tshow();\n\t}\n\n\tlet div: HTMLDivElement;\n\n\tfunction show() {\n\t\t// Show the popover in a div\n\t\tif (div) {\n\t\t\tdocument.body.removeChild(div);\n\t\t}\n\t\tdiv = document.createElement(\"div\");\n\t\tdocument.body.appendChild(div);\n\n\t\tshowPopover(popover, node, props, div);\n\t}\n\n\treturn {\n\t\tdestroy(): void {\n\t\t\t// Remove the event listener from the node on destroy\n\t\t\tnode.removeEventListener(\"click\", handleClick);\n\n\t\t\t// Remove the div we added\n\t\t\t// TODO: Should we do this in more places?\n\t\t\tif (div) {\n\t\t\t\tdocument.body.removeChild(div);\n\t\t\t}\n\t\t},\n\t};\n}\n","import type { Component } from \"@torpor/view\";\nimport showPopover from \"./showPopover\";\n\ninterface ContextPopoverOptions {\n\tpopover: Component;\n\tprops?: Record<PropertyKey, any>;\n}\n\n/**\n * A mount directive for showing a popover when the user opens an element's context menu.\n * @param node The element to show the popover for\n * @param options Options for showing the popover, consisting of the popover component and any props\n */\nexport default function contextPopover(node: HTMLElement, options: ContextPopoverOptions) {\n\tconst { popover, props } = options;\n\n\t// Add a contextmenu event handler to the node\n\tnode.addEventListener(\"contextmenu\", handleClick);\n\n\tfunction handleClick(e: MouseEvent) {\n\t\te.preventDefault();\n\t\tshow();\n\t}\n\n\tlet div: HTMLDivElement;\n\n\tfunction show() {\n\t\t// Show the popover in a div\n\t\tif (div) {\n\t\t\tdocument.body.removeChild(div);\n\t\t}\n\t\tdiv = document.createElement(\"div\");\n\t\tdocument.body.appendChild(div);\n\n\t\tshowPopover(popover, node, props, div);\n\t}\n\n\treturn {\n\t\tdestroy(): void {\n\t\t\t// Remove the event listener from the node on destroy\n\t\t\tnode.removeEventListener(\"contextmenu\", handleClick);\n\n\t\t\t// Remove the div we added\n\t\t\t// TODO: Should we do this in more places?\n\t\t\tif (div) {\n\t\t\t\tdocument.body.removeChild(div);\n\t\t\t}\n\t\t},\n\t};\n}\n","interface HoverTriggerOptions {\n\tonHover: (node: HTMLElement, e: TouchEvent | MouseEvent) => void;\n\tonExit?: (node: HTMLElement, e: TouchEvent | MouseEvent) => void;\n\thoverDelay?: number;\n\ttouchDelay?: number;\n}\n\nexport default function hoverTrigger(node: HTMLElement, options: HoverTriggerOptions): () => void {\n\tconst { onHover, onExit } = options;\n\tconst hoverDelay = options.hoverDelay || 1000;\n\tconst touchDelay = options.touchDelay || 1000;\n\n\tlet interval: NodeJS.Timeout | undefined;\n\n\t// Add click event handlers to the node\n\tnode.addEventListener(\"mouseenter\", handleMouseEnter);\n\tnode.addEventListener(\"mouseleave\", handleMouseLeave);\n\tnode.addEventListener(\"mousemove\", handleMouseMove);\n\tnode.addEventListener(\"touchstart\", handleMouseEnter);\n\tnode.addEventListener(\"touchend\", handleMouseLeave);\n\n\tfunction handleMouseEnter(e: MouseEvent | TouchEvent) {\n\t\t// Handle the hover after a delay\n\t\te.preventDefault();\n\t\tif (!interval) {\n\t\t\tconst delay = e.type.startsWith(\"mouse\") ? hoverDelay : touchDelay;\n\t\t\tinterval = setTimeout(() => onHover(node, e), delay);\n\t\t}\n\t}\n\n\tfunction handleMouseLeave(e: MouseEvent | TouchEvent) {\n\t\t// Prevent short hovers or touches from firing the event\n\t\tif (interval) {\n\t\t\tclearTimeout(interval);\n\t\t\tinterval = undefined;\n\t\t}\n\n\t\tif (onExit) {\n\t\t\tonExit(node, e);\n\t\t}\n\t}\n\n\tfunction handleMouseMove(e: MouseEvent) {\n\t\t// Reset the interval on mouse move\n\t\tif (interval) {\n\t\t\tclearTimeout(interval);\n\t\t\tinterval = setTimeout(() => onHover(node, e), hoverDelay);\n\t\t}\n\t}\n\n\t// Remove the event listeners from the node on destroy\n\treturn () => {\n\t\tnode.removeEventListener(\"mouseenter\", handleMouseEnter);\n\t\tnode.removeEventListener(\"mouseleave\", handleMouseLeave);\n\t\tnode.removeEventListener(\"mousemove\", handleMouseMove);\n\t\tnode.removeEventListener(\"touchstart\", handleMouseEnter);\n\t\tnode.removeEventListener(\"touchend\", handleMouseLeave);\n\t};\n}\n","import type { Component } from \"@torpor/view\";\nimport hoverTrigger from \"../mount/hoverTrigger\";\nimport showPopover from \"./showPopover\";\n\ninterface HoverPopoverOptions {\n\tpopover: Component;\n\tprops?: Record<PropertyKey, any>;\n\thoverDelay?: number;\n\ttouchDelay?: number;\n}\n\n/**\n * A mount directive for showing a popover when an element is hovered.\n * @param node The element to show the popover for\n * @param options Options for showing the popover, consisting of the popover component, any props and delays for hover and touch\n */\nexport default function hoverPopover(node: HTMLElement, options: HoverPopoverOptions): () => void {\n\tconst { popover, props, hoverDelay, touchDelay } = options;\n\n\tlet div: HTMLDivElement | undefined;\n\n\tfunction onHover(node: HTMLElement, e: MouseEvent | TouchEvent) {\n\t\t// Show the popover in a div\n\t\tif (div) {\n\t\t\tdocument.body.removeChild(div);\n\t\t}\n\t\tdiv = document.createElement(\"div\");\n\t\tdocument.body.appendChild(div);\n\n\t\t// Get the position relative to the element, so we can reposition on scroll\n\t\tconst rect = node.getBoundingClientRect();\n\t\tlet position: { x: number; y: number };\n\t\tif (e.type.startsWith(\"mouse\")) {\n\t\t\tconst me = e as MouseEvent;\n\t\t\tposition = { x: me.clientX - rect.left, y: me.clientY - rect.top };\n\t\t} else {\n\t\t\tconst te = e as TouchEvent;\n\t\t\tposition = {\n\t\t\t\tx: te.touches[0].clientX - rect.left,\n\t\t\t\ty: te.touches[0].clientY - rect.top,\n\t\t\t};\n\t\t}\n\t\tconst allProps = Object.assign({}, props, { anchor: node, position });\n\n\t\tshowPopover(popover, node, allProps, div);\n\t}\n\n\tfunction onExit() {\n\t\t// Remove the div\n\t\tif (div) {\n\t\t\tdocument.body.removeChild(div);\n\t\t\tdiv = undefined;\n\t\t}\n\t}\n\n\treturn hoverTrigger(node, { onHover, onExit, hoverDelay, touchDelay });\n}\n","import type { Component } from \"@torpor/view\";\n\n/**\n * Shows a popover component in code, and asynchronously returns the value selected by the user.\n * @param popover The popover component\n * @param props The properties for the popover component\n * @param target The target element to show the popover in\n * @returns The value selected by the user\n */\nexport default function showPopoverPrompt(\n\tpopover: Component,\n\tprops?: Record<PropertyKey, any>,\n\ttarget?: Element,\n): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\t// Add the promise as the callback\n\t\tconst allProps = Object.assign({}, props, { callback: resolve });\n\n\t\t// Create the popover\n\t\t// TODO: This needs to clean up after itself, like the use methods do\n\t\tpopover(target || document.body, null, allProps);\n\t});\n}\n"],"mappings":"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","names":["node"]}
+{"version":3,"sources":["../../src/Popover/showPopover.ts"],"sourcesContent":["// TODO: Allow passing in a variable -- so that you can show an inline popover\nimport type { Component } from \"@torpor/view\";\n\n/**\n * Shows a popover component in code.\n * @param popover The popover component\n * @param anchor The element to use as an anchor for the popover component\n * @param props The properties for the popover component\n * @param target The target element to show the popover in\n * @returns The value selected by the user\n */\nexport default function showPopover(\n\tpopover: Component,\n\tanchor: HTMLElement,\n\tprops?: Record<PropertyKey, any>,\n\ttarget?: Element,\n): void {\n\t// Add the anchor element to the properties\n\tconst allProps = Object.assign({}, props, { anchor });\n\n\t// Create the popover\n\t// TODO: This needs to clean up after itself, like the mount methods do\n\tpopover(target || anchor.parentElement || document.body, null, allProps);\n}\n"],"mappings":";;;;;;;;;;AAWe,SAAR,YACN,SACA,QACA,OACA,QACO;AAEP,QAAM,WAAW,OAAO,OAAO,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC;AAIpD,UAAQ,UAAU,OAAO,iBAAiB,SAAS,MAAM,MAAM,QAAQ;AACxE;","names":[]}

package/dist/TabGroup/TabContent.torp

@@ -1,32 +1,41 @@
 import getId from "../utils/getId";
 import { TabGroupContextName, type TabGroupContext } from "./TabGroupTypes";
 
+interface TabContentProps {
+	/** An ID for the root element */
+	id?: string;
+	/** Class name(s) for the root element */
+	class?: string,
+	/** The index of this item */
+	index?: number,
+	/** The value for this item */
+	value?: string,
+}
+
 /**
  * Content for a TabGroup, which can be revealed or hidden by an associated TabTrigger.
- *
- * @prop {string} [id] -- An ID for the TabContent's div container
  */
-export default function TabContent($props: any) {
-	$props.id ||= getId();
+export default function TabContent($props: TabContentProps | undefined) {
+	let defaultId = getId();
 
 	const context = $context[TabGroupContextName] as TabGroupContext;
 	if (!context) {
 		throw new Error("TabContent must be contained within a TabGroup");
 	}
-	let $state = $context[TabGroupContextName].registerItem($props.index, $props.value);
+	let $state = context.registerItem($props?.index, $props?.value);
 
 	// Set the content ID so that it can be used with aria-controls in TabTrigger
-	$state.contentId = $props.id;
+	$state.contentId = $props?.id ?? defaultId;
 
 	@render {
 		<div
-			{$props.id}
-			class={`torp-tab-content ${$props.class ?? ""}`.trim()}
+			id={$props?.id ?? defaultId}
+			class={`torp-tab-content ${$props?.class ?? ""}`.trim()}
 			role="tabpanel"
 			aria-labelledby={$state.headerId}
-			data-orientation={$props.orientation}
-			data-state={$state.dataState}
-			data-disabled={$state.dataDisabled}
+			data-orientation={context.orientation}
+			data-state={$state.active ? "active" : "inactive"}
+			data-disabled={$state.disabled ? "true" : undefined}
 		>
 			@if ($state.active) {
 				<slot />

package/dist/TabGroup/TabGroup.torp

@@ -1,5 +1,22 @@
 import { TabGroupContextName, type TabGroupContext, type ItemState } from "./TabGroupTypes";
 
+interface TabGroupProps {
+	/** An ID for the root element */
+	id?: string;
+	/** Class name(s) for the root element */
+	class?: string,
+	/** The orientation of the tab buttons, which affects keyboard navigation */
+	orientation?: "horizontal" | "vertical",
+	/** How tabs are activated; if automatic they are shown on focus, if manual they must be clicked */
+	activation?: "automatic" | "manual",
+	/** The value of the active TabContent */
+	value?: string,
+	/** If set to true, the user cannot interact with any items in the TabGroup */
+	disabled?: boolean,
+	/** Raised when the active item has changed */
+	onchange?: (value: string | string[]) => void
+}
+
 /**
  * A list of interactive headings coupled with layered sections of content that
  * enable users to reveal a single section of content at a time.
@@ -18,17 +35,24 @@ import { TabGroupContextName, type TabGroupContext, type ItemState } from "./Tab
  * 	<TabContent />
  * </TabGroup>
  * ```
- *
- * @prop {"horizontal" | "vertical"} orientation -- The orientation of the tab buttons, which affects keyboard navigation
- * @prop {"automatic" | "manual"} activation -- How tabs are activated; if automatic they are shown on focus, if manual they must be clicked
- * @prop {string | string[]} value -- The value of the active TabContent
- * @prop {boolean} disabled -- If set to true, the user cannot interact with any items in the TabGroup
- * @prop {(value: string | string[]) => void} [onchange] -- Raised when the active item has changed
  */
-export default function TabGroup($props: any) {
-	$props.orientation ||= "horizontal";
-	$props.activation ||= "automatic";
-	$props.value ||= "";
+export default function TabGroup($props: TabGroupProps | undefined) {
+	let orientation = $props?.orientation ?? "horizontal";
+	let activation = $props?.activation ?? "automatic";
+
+	let $state = $watch({
+		value: ""
+	});
+
+	// Sync props and state
+	$run(() => {
+		$state.value = $props?.value ?? "";
+	});
+	$run(() => {
+		if ($props !== undefined) {
+			$props.value = $state.value;
+		}
+	});
 
 	let itemStates: ItemState[] = [];
 
@@ -43,45 +67,39 @@ export default function TabGroup($props: any) {
 		removeItem,
 		triggerItem,
 		handleHeaderKey,
-		orientation: $props.orientation,
-		activation: $props.activation,
+		orientation,
+		activation,
 	};
 	$context[TabGroupContextName] = context;
 
 	$run(() => {
-		// HACK: This should probably be done with setters?
-		let newValue = $props.value;
-
 		// Ensure the value passed in was a string (in case e.g. the user has set values to ints)
-		newValue = newValue?.toString();
+		$state.value = $state.value.toString();
 		for (let item of itemStates) {
-			item.active = item.value === newValue;
+			item.active = item.value === $state.value;
 		}
-
-		// Set the value
-		$props.value = newValue;
 	});
 
 	$run(() => {
-		itemStates.forEach((s) => s.parentDisabled = $props.disabled);
+		itemStates.forEach((s) => s.parentDisabled = $props?.disabled === true);
 	});
 
 	// Dispatch the change event when the value changes
 	let firstChange = true;
 	$run(() => {
-		const ev = $props.onchange;
-		const value = $props.value;
+		const ev = $props?.onchange;
+		const value = $props?.value;
 		if (firstChange) {
 			firstChange = false;
 		} else if (ev) {
-			ev(value);
+			ev(value!);
 		}
 	});
 
 	// On mount, if no value was set, show the first tab content
 	$mount(() => {
-		if ($props.value === "" && itemStates.length) {
-			$props.value = itemStates[0].value;
+		if ($state.value === "" && itemStates.length) {
+			$state.value = itemStates[0].value;
 		}
 	});
 
@@ -101,7 +119,7 @@ export default function TabGroup($props: any) {
 
 	function registerItem(index: number | undefined, value: string | undefined): ItemState {
 		// If an index wasn't set for the item, set it automatically
-		if (!index) {
+		if (index === undefined) {
 			index = nextItemIndex++;
 		}
 
@@ -118,7 +136,7 @@ export default function TabGroup($props: any) {
 		}
 
 		// If a value wasn't set for the item, set it to the index
-		if (!value) {
+		if (value === undefined) {
 			value = index.toString();
 		}
 
@@ -127,8 +145,8 @@ export default function TabGroup($props: any) {
 			index,
 			value,
 			// TODO: this would be better than using $mount, but it doesn't work with nested tabs
-			// active: value === $props.value || ($props.value === "" && index === 0),
-			active: value === $props.value,
+			// active: value === $props?.value || ($props?.value === "" && index === 0),
+			active: value === $state.value,
 			headerId: "",
 			contentId: "",
 			disabled: false,
@@ -137,8 +155,8 @@ export default function TabGroup($props: any) {
 				return this.active ? "active" : "inactive";
 			},
 			setFocused: () => {},
-			orientation: $props.orientation,
-			activation: $props.activation
+			orientation,
+			activation
 		});
 		itemStates.splice(index, 0, newItemState);
 
@@ -159,7 +177,7 @@ export default function TabGroup($props: any) {
 		for (let item of itemStates) {
 			// The item is active if it has the supplied value
 			if (item.value === toggleValue) {
-				$props.value = item.value;
+				$state.value = item.value;
 				break;
 			}
 		}
@@ -169,7 +187,7 @@ export default function TabGroup($props: any) {
 		switch (e.key) {
 			case "Left":
 			case "ArrowLeft": {
-				if ($props.orientation === "horizontal" && headerIndex > 0) {
+				if (orientation === "horizontal" && headerIndex > 0) {
 					e.preventDefault();
 					itemStates[headerIndex - 1].setFocused();
 				}
@@ -177,7 +195,7 @@ export default function TabGroup($props: any) {
 			}
 			case "Up":
 			case "ArrowUp": {
-				if ($props.orientation === "vertical" && headerIndex > 0) {
+				if (orientation === "vertical" && headerIndex > 0) {
 					e.preventDefault();
 					itemStates[headerIndex - 1].setFocused();
 				}
@@ -185,7 +203,7 @@ export default function TabGroup($props: any) {
 			}
 			case "Right":
 			case "ArrowRight": {
-				if ($props.orientation === "horizontal" && headerIndex < itemStates.length - 1) {
+				if (orientation === "horizontal" && headerIndex < itemStates.length - 1) {
 					e.preventDefault();
 					itemStates[headerIndex + 1].setFocused();
 				}
@@ -193,7 +211,7 @@ export default function TabGroup($props: any) {
 			}
 			case "Down":
 			case "ArrowDown": {
-				if ($props.orientation === "vertical" && headerIndex < itemStates.length - 1) {
+				if (orientation === "vertical" && headerIndex < itemStates.length - 1) {
 					e.preventDefault();
 					itemStates[headerIndex + 1].setFocused();
 				}
@@ -218,9 +236,9 @@ export default function TabGroup($props: any) {
 
 	@render {
 		<div
-			{$props.id}
-			class={`torp-tab-group ${$props.class ?? ""}`.trim()}
-			data-orientation={$props.orientation}
+			{$props?.id}
+			class={`torp-tab-group ${$props?.class ?? ""}`.trim()}
+			data-orientation={$props?.orientation}
 		>
 			<slot />
 		</div>

package/dist/TabGroup/TabGroupTypes.ts

@@ -3,9 +3,13 @@ export const TabItemContextName = "TabItem";
 
 export interface TabGroupContext {
 	/** Called from a header when it is added */
-	registerHeader: (index: number, value: string, setFocused: () => void) => ItemState;
+	registerHeader: (
+		index: number | undefined,
+		value: string | undefined,
+		setFocused: () => void,
+	) => ItemState;
 	/** Called from an item when it is added */
-	registerItem: (index: number, value: string) => ItemState;
+	registerItem: (index: number | undefined, value: string | undefined) => ItemState;
 	/** Called from an item when it is removed */
 	removeItem: (index: number) => void;
 	/** Called from an item when it is triggered */
@@ -17,12 +21,14 @@ export interface TabGroupContext {
 }
 
 export interface TabItemContext {
-	/** Called when an item is triggered */
+	/** Raised when an item is triggered */
 	triggerItem: (value: string) => void;
-	/** Called when a TabHeader receives a keyboard event */
+	/** Raised when a TabHeader receives a keyboard event */
 	handleHeaderKey: (index: number, e: KeyboardEvent) => void;
 	/** The reactive state for an item */
 	state: ItemState;
+	orientation: "horizontal" | "vertical";
+	activation: "automatic" | "manual";
 }
 
 export interface ItemState {
@@ -33,7 +39,6 @@ export interface ItemState {
 	contentId: string;
 	disabled: boolean;
 	parentDisabled: boolean;
-	dataState: "active" | "inactive";
 	/** Called in the TabGroup when a header needs to be focused */
 	setFocused: () => void;
 }

package/dist/TabGroup/TabHeader.torp

@@ -1,5 +1,18 @@
 import { TabGroupContextName, TabItemContextName, type TabGroupContext, type TabItemContext } from "./TabGroupTypes";
 
+interface TabHeaderProps {
+	/** An ID for the root element */
+	id?: string;
+	/** Class name(s) for the root element */
+	class?: string,
+	/** The type of HTML header to use */
+	as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"
+	/** The index of this header's item */
+	index?: number,
+	/** The value for this header's item */
+	value?: string,
+}
+
 /**
  * The header for a tab item, which contains the TabTrigger.
  *
@@ -10,20 +23,22 @@ import { TabGroupContextName, TabItemContextName, type TabGroupContext, type Tab
  * 	<TabTrigger />
  * </TabHeader>
  * ```
- *
- * @prop {"h1" | "h2" | "h3" | "h4" | "h5" | "h6"} as -- The type of HTML header to use
  */
-export default function TabHeader($props: any) {
+export default function TabHeader($props: TabHeaderProps | undefined) {
+	let button: HTMLButtonElement;
+
 	const context = $context[TabGroupContextName] as TabGroupContext;
 	if (!context) {
 		throw new Error("TabHeader must be contained within a TabGroup");
 	}
-	let $state = $context[TabGroupContextName].registerHeader($props.index, $props.value);
+	let $state = context.registerHeader($props?.index, $props?.value);
 
 	const itemContext: TabItemContext = {
 		triggerItem: context.triggerItem,
 		handleHeaderKey: context.handleHeaderKey,
 		state: $state,
+		orientation: context.orientation,
+		activation: context.activation
 	};
 	$context[TabItemContextName] = itemContext;
 
@@ -35,16 +50,17 @@ export default function TabHeader($props: any) {
 	});
 
 	@render {
-		@// TODO: $props.as
+		@// TODO: $props?.as
 		<h4
-			{$props.id}
+			{$props?.id}
 			class={[
 				"torp-tab-header",
-				$props.class,
-				$state.orientation
+				$props?.class,
+				context.orientation
 			]}
-			data-state={$state.dataState}
-			data-disabled={$state.dataDisabled}
+			data-state={$state.active ? "active" : "inactive"}
+			data-disabled={$state.disabled ? "true" : undefined}
+			&ref={button}
 		>
 			<slot />
 		</h4>

package/dist/TabGroup/TabList.torp

@@ -1,4 +1,13 @@
-import { TabGroupContextName, TabItemContextName, type TabGroupContext, type TabItemContext } from "./TabGroupTypes";
+import { TabGroupContextName, type TabGroupContext } from "./TabGroupTypes";
+
+interface TabListProps {
+	/** An ID for the root element */
+	id?: string;
+	/** Class name(s) for the root element */
+	class?: string,
+	/** An ARIA label for describing the tab list to screen readers */
+	ariaLabel?: string,
+}
 
 /**
  * A component that holds the TabHeaders of a TabGroup.
@@ -12,10 +21,8 @@ import { TabGroupContextName, TabItemContextName, type TabGroupContext, type Tab
  * 	</TabHeader>
  * </TabList>
  * ```
- *
- * @prop {string} ariaLabel -- An ARIA label for describing the tab list to screen readers
  */
-export default function TabList($props: any) {
+export default function TabList($props: TabListProps | undefined) {
 	// Get stuff out of the TabGroupContext
 	const context = $context[TabGroupContextName] as TabGroupContext;
 	if (!context) {
@@ -35,10 +42,10 @@ export default function TabList($props: any) {
 
 	@render {
 		<div
-			{$props.id}
-			class={`torp-tab-list ${$props.class ?? ""}`.trim()}
+			{$props?.id}
+			class={`torp-tab-list ${$props?.class ?? ""}`.trim()}
 			role="tablist"
-			aria-label={$props.ariaLabel}
+			aria-label={$props?.ariaLabel}
 			aria-orientation={orientation}
 			data-orientation={orientation}
 			tabindex="0"