@torpor/ui 0.0.17 → 0.1.1

package/dist/Popover/PopoverContent.torp

@@ -0,0 +1,78 @@
+import { addDocumentEvent, removeDocumentEvent } from "../utils/documentEvents";
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+
+/**
+ * The content that is displayed for a Popover when it is open, such as a Dialog
+ * in the middle of the screen or a div that slides in from the side.
+ */
+export default function PopoverContent($props: any) {
+	let div: HTMLDivElement;
+
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverContent must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	let closeOnClick = false;
+
+	let first = true;
+	$run(() => {
+		let visible = $state.visible;
+
+		if (first) {
+			first = false;
+			return;
+		}
+
+		if (visible) {
+			// HACK: Because this Popover could be shown with a click, we need to wait for another mousedown
+			// before we close on click. Otherwise the click immediately bubbles to the document
+			closeOnClick = false;
+			addDocumentEvent("mousedown", handleDocumentMouseDown);
+			addDocumentEvent("click", handleDocumentClick);
+			// Wait for the content div to be shown, set its position, and listen for window resize to re-position
+			//await tick();
+			if (context.focusFirstElement) {
+				context.focusFirstElement();
+			}
+		} else {
+			removeDocumentEvent("mousedown", handleDocumentMouseDown);
+			removeDocumentEvent("click", handleDocumentClick);
+			// Focus the anchor element per WAI guidelines
+			if (context.anchorElement?.focus) {
+				context.anchorElement.focus();
+			}
+		}
+	});
+
+	function handleDocumentMouseDown() {
+		closeOnClick = true;
+	}
+
+	function handleDocumentClick(e: MouseEvent) {
+		if (
+			closeOnClick &&
+			div &&
+			!div.contains(e.target as HTMLElement) &&
+			(!context.anchorElement || !context.anchorElement.contains(e.target as HTMLElement))
+		) {
+			context.handleClickOutside!(e);
+		}
+	}
+
+	@render {
+		<div style="display: contents">
+			@if ($state.visible) {
+				<div
+					id={$props.id}
+					class={`torp-popover-content ${$props.class ?? ""}`.trim()}
+					&ref={div}
+				>
+					<:slot />
+				</div>
+			}
+		</div>
+	}
+}

package/dist/Popover/PopoverContentAnchored.torp

@@ -0,0 +1,107 @@
+import { addDocumentEvent, removeDocumentEvent } from "../utils/documentEvents";
+import getScrollParent from "../utils/getScrollParent";
+import setPopoverPosition from "../utils/setPopoverPosition";
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+
+/**
+ * The content that is displayed for a Popover when it is open, displayed
+ * alongside an element.
+ *
+ * @prop {"top" | "right" | "bottom" | "left"} site -- Where the popover will be
+ * shown, relative to the popover button
+ * @prop {"start" | "center" | "end"} alignment -- How the popover will be
+ * aligned, relative to the popover button
+ */
+export default function PopoverContentAnchored($props: any) {
+	$props.side ??= "bottom";
+	$props.alignment ??= "center";
+
+	let div: HTMLDivElement;
+
+	let closeOnClick = false;
+
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverContentAnchored must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	let first = true;
+	$run(() => {
+		let visible = $state.visible;
+
+		if (first) {
+			first = false;
+			return;
+		}
+
+		if (visible) {
+			// HACK: Because this Popover could be shown with a click, we need to wait for another mousedown
+			// before we close on click. Otherwise the click immediately bubbles to the document
+			closeOnClick = false;
+			addDocumentEvent("mousedown", handleDocumentMouseDown);
+			addDocumentEvent("click", handleDocumentClick);
+			// Wait for the content div to be shown, set its position, and listen for window resize to re-position
+			//await tick();
+			setPosition();
+			if (context.focusFirstElement) {
+				context.focusFirstElement();
+			}
+			const scrollParent = getScrollParent(context.anchorElement)
+			scrollParent.addEventListener("resize", setPosition);
+			scrollParent.addEventListener("scroll", setPosition);
+		} else {
+			removeDocumentEvent("mousedown", handleDocumentMouseDown);
+			removeDocumentEvent("click", handleDocumentClick);
+			// Stop listening for window resize and focus the anchor element per WAI guidelines
+			const scrollParent = getScrollParent(context.anchorElement)
+			scrollParent.removeEventListener("resize", setPosition);
+			scrollParent.removeEventListener("scroll", setPosition);
+			if (context.anchorElement?.focus) {
+				context.anchorElement.focus();
+			}
+		}
+	});
+
+	function handleDocumentMouseDown() {
+		closeOnClick = true;
+	}
+
+	function handleDocumentClick(e: MouseEvent) {
+		if (
+			closeOnClick &&
+			div &&
+			!div.contains(e.target as HTMLElement) &&
+			(!context.anchorElement || !context.anchorElement.contains(e.target as HTMLElement))
+		) {
+			e.preventDefault();
+			context.handleClickOutside!(e);
+		}
+	}
+
+	function setPosition() {
+		if (!context.anchorElement) {
+			throw new Error("PopoverContentAnchored must have an anchor element");
+		}
+
+		if (div) {
+			setPopoverPosition(context.anchorElement, div, $props.side, $props.alignment);
+		}
+	}
+
+	@render {
+		<div style="display: contents">
+			@if ($state.visible) {
+				<div
+					id={$props.id}
+					class={`torp-popover-content-anchored ${$props.class ?? ""}`.trim()}
+					&ref={div}
+					:onmount={(el) => setPopoverPosition(context.anchorElement, el, $props.side, $props.alignment)}
+				>
+					<:slot />
+				</div>
+			}
+		</div>
+	}
+}

package/dist/Popover/PopoverContentContextual.torp

@@ -0,0 +1,99 @@
+
+import { addDocumentEvent, removeDocumentEvent } from "../utils/documentEvents";
+import getScrollParent from "../utils/getScrollParent";
+import setContextPosition from "../utils/setContextPosition";
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+
+/**
+ * The content that is displayed for a Popover when it is open, displayed at the
+ * position that the user right-clicked.
+ */
+export default function PopoverContentContextual($props: any) {	
+	let div: HTMLDivElement;
+
+	let closeOnClick = false;
+
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverContentContextual must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	let first = true;
+	$run(() => {
+		let visible = $state.visible;
+
+		if (first) {
+			first = false;
+			return;
+		}
+
+		if (visible) {
+			// HACK: Because this Contextual could be shown with a click, we need to wait for another mousedown
+			// before we close on click. Otherwise the click immediately bubbles to the document
+			closeOnClick = false;
+			addDocumentEvent("mousedown", handleDocumentMouseDown);
+			addDocumentEvent("click", handleDocumentClick);
+			// Wait for the content div to be shown, set its position, and listen for window resize to re-position
+			//await tick();
+			setPosition();
+			if (context.focusFirstElement) {
+				context.focusFirstElement();
+			}
+			const scrollParent = getScrollParent(context.anchorElement)
+			scrollParent.addEventListener("resize", setPosition);
+			scrollParent.addEventListener("scroll", setPosition);
+		} else {
+			removeDocumentEvent("mousedown", handleDocumentMouseDown);
+			removeDocumentEvent("click", handleDocumentClick);
+			// Stop listening for window resize and focus the anchor element per WAI guidelines
+			const scrollParent = getScrollParent(context.anchorElement)
+			scrollParent.removeEventListener("resize", setPosition);
+			scrollParent.removeEventListener("scroll", setPosition);
+			if (context.anchorElement?.focus) {
+				context.anchorElement.focus();
+			}
+		}
+	});
+
+	function handleDocumentMouseDown() {
+		closeOnClick = true;
+	}
+
+	function handleDocumentClick(e: MouseEvent) {
+		if (
+			closeOnClick &&
+			div &&
+			!div.contains(e.target as HTMLElement) &&
+			(!context.anchorElement || !context.anchorElement.contains(e.target as HTMLElement))
+		) {
+			context.handleClickOutside!(e);
+		}
+	}
+
+	function setPosition() {
+		if (!context.anchorElement) {
+			throw new Error("ContextualContent must have an anchor element");
+		}
+
+		if (div && $state.position) {
+			setContextPosition(context.anchorElement, div, $state.position);
+		}
+	}
+
+	@render {
+		<div style="display: contents">
+			@if ($state.visible) {
+				<div
+					id={$props.id}
+					class={`torp-popover-content-contextual ${$props.class ?? ""}`.trim()}
+					&ref={div}
+					:onmount={(el) => setContextPosition(context.anchorElement, el, $state.position)}
+				>
+					<:slot />
+				</div>
+			}
+		</div>
+	}
+}

package/dist/Popover/PopoverOverlay.torp

@@ -0,0 +1,32 @@
+import { disableScroll } from "../mount/disableScroll";
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+
+/**
+ * The background overlay for a Popover. Adding an overlay automatically sets the Popover to modal.
+ */
+export default function PopoverOverlay($props: any) {
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverOverlay must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	// Any Popover with an overlay is modal
+	context.modal = true;
+
+	@render {
+		<div style="display: contents">
+			@if ($state.visible) {
+				<div
+					id={$props.id}
+					class={`torp-popover-overlay ${$props.class ?? ""}`.trim()}
+					tabindex="-1"
+					:onmount={(el) => disableScroll(el)}
+				>
+					<:slot />
+				</div>
+			}
+		</div>
+	}
+}

package/dist/Popover/PopoverTrigger.torp

@@ -0,0 +1,29 @@
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+
+/**
+ * The button that causes a Popover to appear or disappear.
+ */
+export default function PopoverTrigger($props: any) {
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverTrigger must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	function handleClick() {
+		$state.visible = !$state.visible;
+	}
+
+	@render {
+		<button
+			type="button"
+			id={$props.id}
+			class={`torp-popover-trigger ${$props.class ?? ""}`.trim()}
+			onclick={handleClick}
+			&ref={context.anchorElement}
+		>
+			<:slot />
+		</button>
+	}
+}

package/dist/Popover/PopoverTriggerContextual.torp

@@ -0,0 +1,37 @@
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+
+/**
+ * The element that causes a Popover to appear or disappear when right-clicked.
+ */
+export default function PopoverTriggerContextual($props: any) {
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverTriggerContextual must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	function handleContextual(e: MouseEvent & { currentTarget: EventTarget & HTMLDivElement }) {
+		e.preventDefault();
+		if ($state.position) {
+			// Get the position relative to the element, so we can reposition on scroll
+			const rect = e.currentTarget.getBoundingClientRect();
+			const x = e.clientX - rect.left;
+			const y = e.clientY - rect.top;
+			$state.position = { x, y };
+			//$state.position = { x: window.scrollX + e.clientX, y: window.scrollY + e.clientY };
+		}
+		$state.visible = !$state.visible;
+	}
+
+	@render {
+		<div
+			id={$props.id}
+			class={`torp-popover-trigger-contextual ${$props.class ?? ""}`.trim()}
+			oncontextmenu={handleContextual}
+			&ref={context.anchorElement}
+		>
+			<:slot />
+		</div>
+	}
+}

package/dist/Popover/PopoverTriggerHover.torp

@@ -0,0 +1,38 @@
+
+import { PopoverContextName, type PopoverContext } from "./PopoverTypes";
+import hoverTrigger from "../mount/hoverTrigger";
+
+/**
+ * The div that causes a Popover to appear or disappear when hovered.
+ */
+export default function PopoverTriggerHover($props: any) {
+	// Get stuff out of the PopoverContext
+	const context = $context[PopoverContextName] as PopoverContext;
+	if (!context) {
+		throw new Error("PopoverTriggerHover must be contained within a Popover");
+	}
+	let $state = context.state;
+
+	function handleHover(node, e) {
+		if ($state.position) {
+			// Get the position relative to the element, so we can reposition on scroll
+			const rect = node.getBoundingClientRect();
+			const x = e.clientX - rect.left;
+			const y = e.clientY - rect.top;
+			$state.position = { x, y };
+			//$state.position = { x: window.scrollX + e.clientX, y: window.scrollY + e.clientY };
+		}
+		$state.visible = !$state.visible
+	}
+
+	@render {
+		<div
+			id={$props.id}
+			class={`torp-popover-trigger-hover ${$props.class ?? ""}`.trim()}
+			:onmount={(el) => hoverTrigger(el, { onHover: handleHover, onExit: handleHover })}
+			&ref={context.anchorElement}
+		>
+			<:slot />
+		</div>
+	}
+}

package/dist/Popover/PopoverTypes.ts

@@ -0,0 +1,30 @@
+export const PopoverContextName = "Popover";
+
+/** The shared context for popover components (Contextual, Prompt and Popover) */
+export interface PopoverContext {
+	handleButton: (type: "confirm" | "cancel" | undefined, value?: any) => void;
+	// HACK: We need to be able to let children (i.e. Dialogs) override the click outside functionality
+	// There may be a more elegant way to accomplish this too
+	handleClickOutside?: (e: MouseEvent) => void;
+	state: PopoverState;
+	modal: boolean;
+	anchorElement?: HTMLElement;
+	// HACK: focusFirstElement is necessary because if we focus the first element e.g. in a Dialog's
+	// onMount, it will scroll the page to the focused element and mess up our careful positioning
+	// We need to be able to manually set the order to
+	// 1. set visible (so we have an element with content)
+	// 2. set position (so the element is in the right place)
+	// 3. set focus (for accessibility)
+	// There may be a more elegant way to accomplish this!
+	focusFirstElement?: () => void;
+}
+
+export interface PopoverState {
+	visible: boolean;
+	position: Point;
+}
+
+export interface Point {
+	x: number;
+	y: number;
+}

package/dist/Popover/index.cjs

@@ -0,0 +1,222 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Popover/index.ts
+var Popover_exports = {};
+__export(Popover_exports, {
+  Popover: () => Popover_default,
+  PopoverContent: () => PopoverContent_default,
+  PopoverContentAnchored: () => PopoverContentAnchored_default,
+  PopoverContentContextual: () => PopoverContentContextual_default,
+  PopoverOverlay: () => PopoverOverlay_default,
+  PopoverTrigger: () => PopoverTrigger_default,
+  PopoverTriggerContextual: () => PopoverTriggerContextual_default,
+  PopoverTriggerHover: () => PopoverTriggerHover_default,
+  clickPopover: () => clickPopover,
+  contextPopover: () => contextPopover,
+  hoverPopover: () => hoverPopover,
+  showPopover: () => showPopover,
+  showPopoverPrompt: () => showPopoverPrompt
+});
+module.exports = __toCommonJS(Popover_exports);
+
+// src/Popover/Popover.torp
+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);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Popover,
+  PopoverContent,
+  PopoverContentAnchored,
+  PopoverContentContextual,
+  PopoverOverlay,
+  PopoverTrigger,
+  PopoverTriggerContextual,
+  PopoverTriggerHover,
+  clickPopover,
+  contextPopover,
+  hoverPopover,
+  showPopover,
+  showPopoverPrompt
+});
+//# sourceMappingURL=index.cjs.map