Context Menu

<div class="kodza-context-menu">
  <div class="kodza-context-menu__area" tabindex="0" aria-label="Right-click area. Press Shift and F10 to open the menu.">
    <p class="kodza-context-menu__title">Right-click anywhere in here.</p>
    <p class="kodza-context-menu__hint">or Shift + F10</p>
  </div>
  <div class="kodza-context-menu__menu" role="menu" aria-label="Actions">
    <button class="kodza-context-menu__item" type="button" role="menuitem">Copy <kbd class="kodza-context-menu__hint">⌘C</kbd></button>
    <button class="kodza-context-menu__item" type="button" role="menuitem">Paste <kbd class="kodza-context-menu__hint">⌘V</kbd></button>
    <button class="kodza-context-menu__item" type="button" role="menuitem">Rename</button>
    <div class="kodza-context-menu__separator" role="separator"></div>
    <button class="kodza-context-menu__item" type="button" role="menuitem" aria-disabled="true">Undo the last three hours</button>
    <button class="kodza-context-menu__item" type="button" role="menuitem">Move to trash <kbd class="kodza-context-menu__hint">⌫</kbd></button>
  </div>
</div>

/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Context Menu
   A right-click menu for an area of the page: it opens from the exact point you clicked,
   stays inside the screen, and works from the keyboard too (Shift + F10 or the menu key).
   A highlight slides from item to item under the pointer or the arrow keys.
   Everything is tuned with the --kz-ctx-* variables. */
.kodza-context-menu {
  --kz-ctx-bg: #ffffff;
  --kz-ctx-fg: #0a0a0a;
  --kz-ctx-muted: rgba(10, 10, 10, 0.58);
  --kz-ctx-border: rgba(10, 10, 10, 0.1);
  --kz-ctx-soft: rgba(10, 10, 10, 0.06);
  --kz-ctx-dots: rgba(10, 10, 10, 0.14);
  --kz-ctx-shadow: 0 18px 40px -16px rgba(10, 10, 10, 0.3);
  --kz-ctx-width: 230px;
  --kz-ctx-duration: 0.22s;
  --kz-ctx-ease: cubic-bezier(0.22, 1, 0.36, 1);

  position: relative;
  width: 100%;
  max-width: 480px;
  color: var(--kz-ctx-fg);
}

/* The area: a dotted canvas */
.kodza-context-menu__area {
  display: grid;
  place-content: center;
  gap: 6px;
  min-height: 240px;
  padding: 28px;
  border-radius: 16px;
  background: var(--kz-ctx-bg) radial-gradient(var(--kz-ctx-dots) 1px, transparent 1.2px) 0 0 / 16px 16px;
  box-shadow: inset 0 0 0 1px var(--kz-ctx-border);
  text-align: center;
  -webkit-user-select: none;
  user-select: none;
  -webkit-touch-callout: none;
}

.kodza-context-menu__area:focus-visible {
  outline: 2px solid var(--kz-ctx-fg);
  outline-offset: 3px;
}

.kodza-context-menu__title {
  margin: 0;
  font-size: 15px;
  font-weight: 500;
}

.kodza-context-menu__hint {
  margin: 0;
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 12px;
  font-weight: 400;
  color: var(--kz-ctx-muted);
}

/* The menu grows from the corner that sits under the pointer */
.kodza-context-menu__menu {
  position: absolute;
  top: 0;
  left: 0;
  z-index: 20;
  display: flex;
  flex-direction: column;
  min-width: var(--kz-ctx-width);
  padding: 6px;
  border-radius: 14px;
  background: var(--kz-ctx-bg);
  box-shadow: 0 0 0 1px var(--kz-ctx-border), var(--kz-ctx-shadow);
  visibility: hidden;
  opacity: 0;
  transform: translate(var(--kz-ctx-x, 0), var(--kz-ctx-y, 0)) scale(0.94);
  transform-origin: var(--kz-ctx-origin, top left);
  transition:
    opacity var(--kz-ctx-duration) ease,
    transform var(--kz-ctx-duration) var(--kz-ctx-ease),
    visibility 0s linear var(--kz-ctx-duration);
}

.kodza-context-menu.is-open .kodza-context-menu__menu {
  visibility: visible;
  opacity: 1;
  transform: translate(var(--kz-ctx-x, 0), var(--kz-ctx-y, 0));
  transition-delay: 0s;
}

.kodza-context-menu__highlight {
  position: absolute;
  top: 0;
  right: 6px;
  left: 6px;
  height: var(--kz-hl-h, 36px);
  border-radius: 8px;
  background: var(--kz-ctx-soft);
  opacity: var(--kz-hl-on, 0);
  transform: translateY(var(--kz-hl-y, 0));
  pointer-events: none;
}

.kodza-context-menu.is-open .kodza-context-menu__highlight {
  transition: transform 0.22s var(--kz-ctx-ease), opacity 0.15s ease;
}

.kodza-context-menu__item {
  position: relative;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 24px;
  height: 36px;
  padding: 0 10px;
  border: 0;
  border-radius: 8px;
  background: none;
  color: inherit;
  font: inherit;
  font-size: 14px;
  font-weight: 500;
  text-align: left;
  white-space: nowrap;
  cursor: pointer;
}

/* The menu itself only holds the focus for the arrow keys: the highlight shows where you are */
.kodza-context-menu__menu:focus {
  outline: none;
}

.kodza-context-menu__item:focus {
  outline: none;
}

.kodza-context-menu__item[aria-disabled="true"] {
  color: var(--kz-ctx-muted);
  cursor: not-allowed;
}

.kodza-context-menu__separator {
  height: 1px;
  margin: 6px -6px;
  background: var(--kz-ctx-border);
}

.kodza-context-menu.is-picking .kodza-context-menu__highlight {
  animation: kodza-context-blink 0.16s steps(2, jump-none) 2;
}

@keyframes kodza-context-blink {
  50% {
    opacity: 0;
  }
}

@media (prefers-reduced-motion: reduce) {
  .kodza-context-menu__menu,
  .kodza-context-menu.is-open .kodza-context-menu__highlight {
    transition-duration: 0.01ms !important;
  }

  .kodza-context-menu.is-picking .kodza-context-menu__highlight {
    animation: none;
  }
}

/* Theming example — on a dark background:
.dark-section .kodza-context-menu {
  --kz-ctx-bg: #161616;
  --kz-ctx-fg: #f2f2f0;
  --kz-ctx-muted: rgba(242, 242, 240, 0.52);
  --kz-ctx-border: rgba(255, 255, 255, 0.12);
  --kz-ctx-soft: rgba(255, 255, 255, 0.08);
  --kz-ctx-dots: rgba(255, 255, 255, 0.14);
  --kz-ctx-shadow: 0 18px 40px -16px rgba(0, 0, 0, 0.8);
}
*/

/* kodza-guard 81058678a305 — generated by Kodza, do not edit.
   Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
   component. :not(#_) is always true and weighs as much as an id, so these lines win over
   theme rules made of classes and tags. Customise the component through its --kz-* variables. */

/* What the browser gives, where the component sets it only in some states: at the lowest weight, so its own rules below put it back */

:where(.kodza-context-menu__area):not(#_) {
  outline: revert;
  outline-offset: revert;
}

:where(.kodza-context-menu__menu):not(#_),
:where(.kodza-context-menu__item):not(#_) {
  outline: revert;
}

/* What the browser gives, on everything the component leaves to it */

.kodza-context-menu:not(#_),
.kodza-context-menu__area:not(#_),
.kodza-context-menu__highlight:not(#_),
.kodza-context-menu__separator:not(#_) {
  box-sizing: revert;
}

.kodza-context-menu__title:not(#_) {
  border: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-context-menu__hint:not(#_) {
  border: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-context-menu__menu:not(#_) {
  box-sizing: revert;
  outline-offset: revert;
}

.kodza-context-menu__item:not(#_) {
  margin: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
  min-height: revert;
}

.kodza-context-menu__title:not(#_):where(:not([hidden])),
.kodza-context-menu__hint:not(#_):where(:not([hidden])) {
  display: revert;
}

.kodza-context-menu__title:not(#_):where([hidden]),
.kodza-context-menu__hint:not(#_):where([hidden]) {
  display: none;
}

/* The component's own rules, one step stronger: real buttons and fields, what it sets on tags themes style (links, lists, headings, images…), and the root width (a theme may narrow it, never widen it) */

.kodza-context-menu:not(#_) {
  width: min(100%, 480px);
}

.kodza-context-menu__area:not(#_) {
  box-shadow: inset 0 0 0 1px var(--kz-ctx-border);
}

.kodza-context-menu__area:focus-visible:not(#_) {
  outline: 2px solid var(--kz-ctx-fg);
  outline-offset: 3px;
}

.kodza-context-menu__title:not(#_) {
  margin: 0;
  font-size: 15px;
  font-weight: 500;
}

.kodza-context-menu__hint:not(#_) {
  margin: 0;
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 12px;
  font-weight: 400;
  color: var(--kz-ctx-muted);
}

.kodza-context-menu__menu:not(#_) {
  box-shadow: 0 0 0 1px var(--kz-ctx-border), var(--kz-ctx-shadow);
}

.kodza-context-menu__item:not(#_) {
  position: relative;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 24px;
  height: 36px;
  padding: 0 10px;
  border: 0;
  border-radius: 8px;
  background: none;
  color: inherit;
  font: inherit;
  font-size: 14px;
  font-weight: 500;
  text-align: left;
  white-space: nowrap;
  cursor: pointer;
}

.kodza-context-menu__menu:focus:not(#_) {
  outline: none;
}

.kodza-context-menu__item:focus:not(#_) {
  outline: none;
}

.kodza-context-menu__item[aria-disabled="true"]:not(#_) {
  color: var(--kz-ctx-muted);
  cursor: not-allowed;
}

// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Context Menu
// Opens the menu where the area was right-clicked (or from its corner with Shift + F10 / the
// menu key), keeps it inside the screen, moves the focus and the highlight from item to item,
// and closes on Escape, Tab, a click outside or a scroll. Picking an item fires
// "kodza:select" with { item, value } on the component.
(() => {
  const SELECTOR = '.kodza-context-menu';
  const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;

  // One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
  function mount(root, signal) {
    const area = root.querySelector('.kodza-context-menu__area');
    const menu = root.querySelector('.kodza-context-menu__menu');
    if (!area || !menu) return;
    const items = [...menu.querySelectorAll('.kodza-context-menu__item')];
    const highlight = document.createElement('span');
    highlight.className = 'kodza-context-menu__highlight';
    highlight.setAttribute('aria-hidden', 'true');
    menu.prepend(highlight);
    items.forEach((item) => (item.tabIndex = -1));
    menu.tabIndex = -1;

    const isOpen = () => root.classList.contains('is-open');

    const light = (item) => {
      if (!item) return menu.style.setProperty('--kz-hl-on', 0);
      menu.style.setProperty('--kz-hl-y', `${item.offsetTop}px`);
      menu.style.setProperty('--kz-hl-h', `${item.offsetHeight}px`);
      menu.style.setProperty('--kz-hl-on', 1);
    };
    const focusItem = (item) => {
      if (!item) return;
      item.focus({ preventScroll: true });
      light(item);
    };

    // In a frame (a live preview on a docs page), the page that scrolls is often the parent one
    // and the wheel may never reach this window: while the menu is open, the parent page's
    // scroll closes it too, when it can be reached (same origin)
    let parentWatch = null;
    const watchParent = () => {
      const host = window.frameElement?.ownerDocument.defaultView;
      if (!host || parentWatch) return;
      parentWatch = new AbortController();
      host.addEventListener('scroll', () => close(), { passive: true, signal: parentWatch.signal });
    };
    signal.addEventListener('abort', () => parentWatch?.abort());

    // Place the menu's corner on the point, flipping it when it would leave the screen; when
    // neither side has room (a phone), it slides back inside, 8px from the edge
    const openAt = (clientX, clientY, fromKeyboard) => {
      const box = root.getBoundingClientRect();
      // Inside a scaled container, screen pixels and the menu's own pixels differ
      const scale = box.width / root.offsetWidth || 1;
      const width = menu.offsetWidth * scale;
      const height = menu.offsetHeight * scale;
      const { clientWidth: screenWidth, clientHeight: screenHeight } = document.documentElement;
      const inside = (start, size, room) => Math.max(8, Math.min(start, room - size - 8));
      const x = inside(clientX + width > screenWidth - 8 ? clientX - width : clientX, width, screenWidth);
      const up = clientY + height > screenHeight - 8 && clientY - height > 8;
      const y = inside(up ? clientY - height : clientY, height, screenHeight);
      root.style.setProperty('--kz-ctx-x', `${(x - box.left) / scale}px`);
      root.style.setProperty('--kz-ctx-y', `${(y - box.top) / scale}px`);
      // It grows from the point, wherever the point lands on it
      root.style.setProperty('--kz-ctx-origin', `${(clientX - x) / scale}px ${(clientY - y) / scale}px`);
      // Reopening elsewhere: jump there without sliding across
      menu.style.transition = 'none';
      void menu.offsetWidth;
      menu.style.transition = '';
      root.classList.remove('is-picking');
      root.classList.add('is-open');
      watchParent();
      light(null);
      if (fromKeyboard) focusItem(items[0]);
      else menu.focus({ preventScroll: true });
    };

    const close = (refocus = false) => {
      parentWatch?.abort();
      parentWatch = null;
      if (!isOpen()) return;
      root.classList.remove('is-open', 'is-picking');
      light(null);
      if (refocus) area.focus({ preventScroll: true });
    };

    const pick = (item) => {
      if (item.getAttribute('aria-disabled') === 'true') return;
      root.dispatchEvent(new CustomEvent('kodza:select', { detail: { item, value: item.textContent.trim() }, bubbles: true }));
      light(item);
      root.classList.add('is-picking');
      setTimeout(() => !signal.aborted && close(true), reduceMotion ? 0 : 320);
    };

    area.addEventListener('contextmenu', (event) => {
      event.preventDefault();
      openAt(event.clientX, event.clientY, false);
    }, { signal });
    area.addEventListener('keydown', (event) => {
      if (event.key === 'ContextMenu' || (event.key === 'F10' && event.shiftKey)) {
        event.preventDefault();
        const box = area.getBoundingClientRect();
        openAt(box.left + 24, box.top + 24, true);
      }
    }, { signal });

    items.forEach((item) => {
      item.addEventListener('click', () => pick(item), { signal });
      item.addEventListener('pointermove', () => document.activeElement !== item && focusItem(item), { signal });
    });
    menu.addEventListener('pointerleave', () => {
      if (menu.contains(document.activeElement)) menu.focus({ preventScroll: true });
      light(null);
    }, { signal });
    menu.addEventListener('contextmenu', (event) => event.preventDefault(), { signal });

    menu.addEventListener('keydown', (event) => {
      const index = items.indexOf(document.activeElement);
      const moves = { ArrowDown: index + 1, ArrowUp: index - 1, Home: 0, End: items.length - 1 };
      if (event.key in moves) {
        event.preventDefault();
        focusItem(items[(moves[event.key] + items.length) % items.length]);
      } else if (event.key === 'Escape') {
        event.preventDefault();
        close(true);
      } else if (event.key === 'Tab') {
        event.preventDefault();
        close(true);
      } else if (event.key.length === 1 && /\S/.test(event.key)) {
        const letter = event.key.toLowerCase();
        const order = [...items.slice(index + 1), ...items.slice(0, index + 1)];
        focusItem(order.find((item) => item.textContent.trim().toLowerCase().startsWith(letter)));
      }
    }, { signal });

    document.addEventListener('pointerdown', (event) => {
      if (isOpen() && !menu.contains(event.target)) close();
    }, { signal });
    addEventListener('scroll', () => close(), { passive: true, signal });
    // A wheel over the page closes it too, even when the page that scrolls is a parent one
    addEventListener('wheel', (event) => isOpen() && !menu.contains(event.target) && close(), { passive: true, signal });
    addEventListener('resize', () => close(), { signal });
    addEventListener('blur', () => close(), { signal });
  }

  // Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
  // event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
  // markup back. For themes and apps that swap content without a page load.
  const instances = new WeakMap();
  const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
  const init = (scope) => find(scope).forEach((root) => {
    if (root.classList.contains('is-ready')) return; // already running, maybe from another copy of this script
    const controller = new AbortController();
    instances.set(root, { controller, html: root.innerHTML, attrs: [...root.attributes].map((a) => [a.name, a.value]) });
    mount(root, controller.signal);
    root.classList.add('is-ready');
  });
  const destroy = (scope) => find(scope).forEach((root) => {
    const instance = instances.get(root);
    if (!instance) return;
    instances.delete(root);
    instance.controller.abort();
    [...root.attributes].forEach((a) => root.removeAttribute(a.name));
    instance.attrs.forEach(([name, value]) => root.setAttribute(name, value));
    root.innerHTML = instance.html;
  });
  document.addEventListener('kodza:init', (event) => init(event.detail?.root));
  document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
  init();
  // Loaded in <head>, the script runs before the markup exists: once more when it is parsed
  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();

'use client';
// Kodza — Context Menu, for React. From https://kodza.dev/components/context-menu/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: context-menu.css and context-menu.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef, type CSSProperties } from 'react';
import './context-menu.css';

export type ContextMenuProps = Omit<ComponentPropsWithoutRef<'div'>, "children" | "vars" | "onSelect"> & {
  /** Settings, as CSS variables on the root */
  vars?: {
    /** default: #ffffff */
    "--kz-ctx-bg"?: string | number;
    /** default: #0a0a0a */
    "--kz-ctx-fg"?: string | number;
    /** default: rgba(10, 10, 10, 0.58) */
    "--kz-ctx-muted"?: string | number;
    /** default: rgba(10, 10, 10, 0.1) */
    "--kz-ctx-border"?: string | number;
    /** default: rgba(10, 10, 10, 0.06) */
    "--kz-ctx-soft"?: string | number;
    /** default: rgba(10, 10, 10, 0.14) */
    "--kz-ctx-dots"?: string | number;
    /** default: 0 18px 40px -16px rgba(10, 10, 10, 0.3) */
    "--kz-ctx-shadow"?: string | number;
    /** default: 230px */
    "--kz-ctx-width"?: string | number;
    /** default: 0.22s */
    "--kz-ctx-duration"?: string | number;
    /** default: cubic-bezier(0.22, 1, 0.36, 1) */
    "--kz-ctx-ease"?: string | number;
  };
  /** "kodza:select", fired by the script (bubbles from the root) */
  onSelect?: (event: CustomEvent) => void;
  className?: string;
};

export function ContextMenu({ vars, onSelect, className, style, ...rest }: ContextMenuProps) {
  const ref = useRef<ComponentRef<'div'>>(null);
  const classes = ["kodza-context-menu", className].filter(Boolean).join(' ');
  // Everything the markup is made of: when it changes, React gets a fresh element (see the top)
  const key = JSON.stringify([classes, vars, style, rest]);

  // Starts the script on this element once React has rendered it, stops it when it goes
  useEffect(() => {
    const root = ref.current;
    let live = true;
    // @ts-ignore: a plain script, no types to find
    import('./context-menu.js').then(() => {
      if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
    });
    return () => {
      live = false;
      document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
    };
  }, [key]);

  useEffect(() => {
    const root = ref.current;
    if (!root || !onSelect) return;
    const listener = (event: Event) => onSelect(event as CustomEvent);
    root.addEventListener("kodza:select", listener);
    return () => root.removeEventListener("kodza:select", listener);
  }, [onSelect, key]);

  return (
    <div key={key} {...rest} className={classes} style={{ ...vars, ...style } as CSSProperties} ref={ref}>
      <div className="kodza-context-menu__area" tabIndex={0} aria-label="Right-click area. Press Shift and F10 to open the menu.">
        <p className="kodza-context-menu__title">Right-click anywhere in here.</p>
        <p className="kodza-context-menu__hint">or Shift + F10</p>
      </div>
      <div className="kodza-context-menu__menu" role="menu" aria-label="Actions">
        <button className="kodza-context-menu__item" type="button" role="menuitem">Copy <kbd className="kodza-context-menu__hint">⌘C</kbd></button>
        {' '}
        <button className="kodza-context-menu__item" type="button" role="menuitem">Paste <kbd className="kodza-context-menu__hint">⌘V</kbd></button>
        {' '}
        <button className="kodza-context-menu__item" type="button" role="menuitem">Rename</button>
        <div className="kodza-context-menu__separator" role="separator" />
        <button className="kodza-context-menu__item" type="button" role="menuitem" aria-disabled="true">Undo the last three hours</button>
        {' '}
        <button className="kodza-context-menu__item" type="button" role="menuitem">Move to trash <kbd className="kodza-context-menu__hint">⌫</kbd></button>
      </div>
    </div>
  );
}