rift-ds 1.0.0

package/components/ContextMenu/ContextMenu.js

@@ -0,0 +1,387 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import React, { useState, useRef, useId, useCallback, useEffect, useLayoutEffect } from "react";
+import { MOTION_HOVER_HIDE_DELAY_MS } from "../../tokens/motion.js";
+import "./ContextMenu.css";
+import "../../fonts/material-symbols.css";
+function collectItems(entries) {
+  const result = [];
+  for (const entry of entries) {
+    if (entry.type === "separator") continue;
+    if (entry.type === "group") {
+      result.push(...collectItems(entry.items));
+    } else {
+      result.push(entry);
+    }
+  }
+  return result;
+}
+const SubMenuItem = ({ item, baseClass, itemId, focused, size, onActivate }) => {
+  const [subOpen, setSubOpen] = useState(false);
+  const timeoutRef = useRef(null);
+  const handleMouseEnter = () => {
+    if (timeoutRef.current) clearTimeout(timeoutRef.current);
+    setSubOpen(true);
+  };
+  const handleMouseLeave = () => {
+    timeoutRef.current = setTimeout(() => setSubOpen(false), MOTION_HOVER_HIDE_DELAY_MS);
+  };
+  useEffect(() => {
+    return () => {
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+    };
+  }, []);
+  useEffect(() => {
+    if (focused && item.children && item.children.length > 0) {
+      setSubOpen(true);
+    }
+  }, [focused, item.children]);
+  const classes = [
+    `${baseClass}__item`,
+    focused ? `${baseClass}__item--focused` : "",
+    item.disabled ? `${baseClass}__item--disabled` : "",
+    item.destructive ? `${baseClass}__item--destructive` : "",
+    `${baseClass}__item--has-submenu`
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ jsxs(
+    "li",
+    {
+      id: itemId,
+      className: classes,
+      role: "menuitem",
+      "aria-haspopup": "menu",
+      "aria-expanded": subOpen,
+      "aria-disabled": item.disabled || void 0,
+      onMouseEnter: handleMouseEnter,
+      onMouseLeave: handleMouseLeave,
+      onClick: (e) => {
+        e.stopPropagation();
+        if (!item.disabled) setSubOpen((prev) => !prev);
+      },
+      children: [
+        /* @__PURE__ */ jsxs("span", { className: `${baseClass}__item-label`, children: [
+          item.icon && /* @__PURE__ */ jsx("span", { className: `${baseClass}__item-icon material-symbols-rounded`, "aria-hidden": "true", children: item.icon }),
+          item.label
+        ] }),
+        /* @__PURE__ */ jsx("span", { className: `${baseClass}__submenu-icon material-symbols-rounded`, "aria-hidden": "true", children: "chevron_right" }),
+        subOpen && item.children && /* @__PURE__ */ jsx("ul", { className: `${baseClass}__panel ${baseClass}__submenu`, role: "menu", children: item.children.map((entry, index) => /* @__PURE__ */ jsx(
+          SubEntry,
+          {
+            entry,
+            baseClass,
+            itemId: `${itemId}-sub-${index}`,
+            size,
+            onActivate
+          },
+          index
+        )) })
+      ]
+    }
+  );
+};
+const SubEntry = ({
+  entry,
+  baseClass,
+  itemId,
+  size,
+  onActivate
+}) => {
+  if (entry.type === "separator") {
+    return /* @__PURE__ */ jsx("li", { className: `${baseClass}__separator`, role: "separator" });
+  }
+  if (entry.type === "group") {
+    return /* @__PURE__ */ jsxs("li", { className: `${baseClass}__group`, role: "none", children: [
+      /* @__PURE__ */ jsx("span", { className: `${baseClass}__group-label`, role: "presentation", children: entry.label }),
+      /* @__PURE__ */ jsx("ul", { className: `${baseClass}__group-list`, role: "group", "aria-label": entry.label, children: entry.items.map((subEntry, subIndex) => /* @__PURE__ */ jsx(
+        SubEntry,
+        {
+          entry: subEntry,
+          baseClass,
+          itemId: `${itemId}-sub-${subIndex}`,
+          size,
+          onActivate
+        },
+        subIndex
+      )) })
+    ] });
+  }
+  if (entry.children && entry.children.length > 0) {
+    return /* @__PURE__ */ jsx(
+      SubMenuItem,
+      {
+        item: entry,
+        baseClass,
+        itemId,
+        focused: false,
+        size,
+        onActivate
+      }
+    );
+  }
+  const itemClasses = [
+    `${baseClass}__item`,
+    entry.disabled ? `${baseClass}__item--disabled` : "",
+    entry.destructive ? `${baseClass}__item--destructive` : ""
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ jsxs(
+    "li",
+    {
+      id: itemId,
+      className: itemClasses,
+      role: "menuitem",
+      "aria-disabled": entry.disabled || void 0,
+      onClick: (e) => {
+        e.stopPropagation();
+        if (!entry.disabled) {
+          entry.onClick?.();
+          onActivate();
+        }
+      },
+      children: [
+        /* @__PURE__ */ jsxs("span", { className: `${baseClass}__item-label`, children: [
+          entry.icon && /* @__PURE__ */ jsx("span", { className: `${baseClass}__item-icon material-symbols-rounded`, "aria-hidden": "true", children: entry.icon }),
+          entry.label
+        ] }),
+        entry.shortcut && /* @__PURE__ */ jsx("span", { className: `${baseClass}__shortcut`, children: entry.shortcut })
+      ]
+    }
+  );
+};
+const ContextMenu = React.forwardRef(
+  ({
+    items,
+    size = "default",
+    ariaLabel,
+    className = "",
+    children,
+    onContextMenu,
+    ...rest
+  }, ref) => {
+    const [position, setPosition] = useState(null);
+    const [focusedIndex, setFocusedIndex] = useState(-1);
+    const rootRef = useRef(null);
+    const panelRef = useRef(null);
+    const previousFocusRef = useRef(null);
+    const generatedId = useId();
+    const baseClass = "ds-context-menu";
+    const classes = [baseClass, className].filter(Boolean).join(" ");
+    const isOpen = position !== null;
+    const flatItems = collectItems(items);
+    const setRootRef = (node) => {
+      rootRef.current = node;
+      if (typeof ref === "function") ref(node);
+      else if (ref) ref.current = node;
+    };
+    const handleClose = useCallback(() => {
+      setPosition(null);
+      setFocusedIndex(-1);
+      const previous = previousFocusRef.current;
+      previousFocusRef.current = null;
+      if (previous && document.contains(previous)) {
+        previous.focus();
+      }
+    }, []);
+    const handleContextMenu = (e) => {
+      onContextMenu?.(e);
+      e.preventDefault();
+      let x = e.clientX;
+      let y = e.clientY;
+      if (x === 0 && y === 0 && rootRef.current) {
+        const rect = rootRef.current.getBoundingClientRect();
+        x = rect.left + rect.width / 2;
+        y = rect.top + rect.height / 2;
+      }
+      if (!isOpen) {
+        previousFocusRef.current = document.activeElement;
+      }
+      setPosition({ x, y });
+      setFocusedIndex(-1);
+    };
+    useEffect(() => {
+      if (!isOpen) return;
+      const handler = (e) => {
+        if (panelRef.current && !panelRef.current.contains(e.target)) {
+          handleClose();
+        }
+      };
+      document.addEventListener("mousedown", handler);
+      return () => document.removeEventListener("mousedown", handler);
+    }, [isOpen, handleClose]);
+    useEffect(() => {
+      if (!isOpen) return;
+      const handler = () => handleClose();
+      window.addEventListener("scroll", handler, true);
+      window.addEventListener("resize", handler);
+      return () => {
+        window.removeEventListener("scroll", handler, true);
+        window.removeEventListener("resize", handler);
+      };
+    }, [isOpen, handleClose]);
+    useLayoutEffect(() => {
+      if (!isOpen || !panelRef.current || !position) return;
+      const panel = panelRef.current;
+      const rect = panel.getBoundingClientRect();
+      const margin = 8;
+      let { x, y } = position;
+      if (x + rect.width + margin > window.innerWidth) {
+        x = Math.max(margin, window.innerWidth - rect.width - margin);
+      }
+      if (y + rect.height + margin > window.innerHeight) {
+        y = Math.max(margin, window.innerHeight - rect.height - margin);
+      }
+      if (x !== position.x || y !== position.y) {
+        setPosition({ x, y });
+        return;
+      }
+      panel.focus({ preventScroll: true });
+    }, [isOpen, position]);
+    const handleKeyDown = (e) => {
+      switch (e.key) {
+        case "Enter":
+        case " ": {
+          e.preventDefault();
+          if (focusedIndex >= 0) {
+            const item = flatItems[focusedIndex];
+            if (item && !item.disabled && !item.children) {
+              item.onClick?.();
+              handleClose();
+            }
+          }
+          break;
+        }
+        case "ArrowDown":
+          e.preventDefault();
+          setFocusedIndex((prev) => {
+            let next = prev + 1;
+            while (next < flatItems.length && flatItems[next].disabled) next++;
+            return next < flatItems.length ? next : prev;
+          });
+          break;
+        case "ArrowUp":
+          e.preventDefault();
+          setFocusedIndex((prev) => {
+            let next = prev < 0 ? flatItems.length - 1 : prev - 1;
+            while (next >= 0 && flatItems[next].disabled) next--;
+            return next >= 0 ? next : prev;
+          });
+          break;
+        case "Home":
+          e.preventDefault();
+          setFocusedIndex((prev) => {
+            let next = 0;
+            while (next < flatItems.length && flatItems[next].disabled) next++;
+            return next < flatItems.length ? next : prev;
+          });
+          break;
+        case "End":
+          e.preventDefault();
+          setFocusedIndex((prev) => {
+            let next = flatItems.length - 1;
+            while (next >= 0 && flatItems[next].disabled) next--;
+            return next >= 0 ? next : prev;
+          });
+          break;
+        case "Escape":
+        case "Tab":
+          e.preventDefault();
+          handleClose();
+          break;
+      }
+    };
+    const renderEntry = (entry, index, itemCounter2) => {
+      if (entry.type === "separator") {
+        return /* @__PURE__ */ jsx("li", { className: `${baseClass}__separator`, role: "separator" }, `sep-${index}`);
+      }
+      if (entry.type === "group") {
+        return /* @__PURE__ */ jsxs("li", { className: `${baseClass}__group`, role: "none", children: [
+          /* @__PURE__ */ jsx("span", { className: `${baseClass}__group-label`, role: "presentation", children: entry.label }),
+          /* @__PURE__ */ jsx("ul", { className: `${baseClass}__group-list`, role: "group", "aria-label": entry.label, children: entry.items.map(
+            (subEntry, subIndex) => renderEntry(subEntry, subIndex, itemCounter2)
+          ) })
+        ] }, `group-${index}`);
+      }
+      const myIndex = itemCounter2.count;
+      itemCounter2.count++;
+      const isFocused = myIndex === focusedIndex;
+      if (entry.children && entry.children.length > 0) {
+        return /* @__PURE__ */ jsx(
+          SubMenuItem,
+          {
+            item: entry,
+            baseClass,
+            itemId: `${generatedId}-item-${myIndex}`,
+            focused: isFocused,
+            size,
+            onActivate: handleClose
+          },
+          `submenu-${index}`
+        );
+      }
+      const itemClasses = [
+        `${baseClass}__item`,
+        isFocused ? `${baseClass}__item--focused` : "",
+        entry.disabled ? `${baseClass}__item--disabled` : "",
+        entry.destructive ? `${baseClass}__item--destructive` : ""
+      ].filter(Boolean).join(" ");
+      return /* @__PURE__ */ jsxs(
+        "li",
+        {
+          id: `${generatedId}-item-${myIndex}`,
+          className: itemClasses,
+          role: "menuitem",
+          "aria-disabled": entry.disabled || void 0,
+          onClick: (e) => {
+            e.stopPropagation();
+            if (!entry.disabled) {
+              entry.onClick?.();
+              handleClose();
+            }
+          },
+          children: [
+            /* @__PURE__ */ jsxs("span", { className: `${baseClass}__item-label`, children: [
+              entry.icon && /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: `${baseClass}__item-icon material-symbols-rounded`,
+                  "aria-hidden": "true",
+                  children: entry.icon
+                }
+              ),
+              entry.label
+            ] }),
+            entry.shortcut && /* @__PURE__ */ jsx("span", { className: `${baseClass}__shortcut`, children: entry.shortcut })
+          ]
+        },
+        `item-${index}`
+      );
+    };
+    const panelClasses = [
+      `${baseClass}__panel`,
+      size === "compact" ? `${baseClass}__panel--compact` : ""
+    ].filter(Boolean).join(" ");
+    const itemCounter = { count: 0 };
+    return /* @__PURE__ */ jsxs("div", { ...rest, ref: setRootRef, className: classes, onContextMenu: handleContextMenu, children: [
+      children,
+      isOpen && /* @__PURE__ */ jsx(
+        "ul",
+        {
+          className: panelClasses,
+          role: "menu",
+          "aria-label": ariaLabel,
+          "aria-activedescendant": focusedIndex >= 0 ? `${generatedId}-item-${focusedIndex}` : void 0,
+          tabIndex: -1,
+          ref: (el) => {
+            panelRef.current = el;
+          },
+          style: { left: position.x, top: position.y },
+          onKeyDown: handleKeyDown,
+          children: items.map((entry, index) => renderEntry(entry, index, itemCounter))
+        }
+      )
+    ] });
+  }
+);
+ContextMenu.displayName = "ContextMenu";
+export {
+  ContextMenu
+};

package/components/ContributionGraph/ContributionGraph.css

@@ -0,0 +1,169 @@
+/* ============================================
+   CONTRIBUTION GRAPH COMPONENT
+   GitHub-style activity heatmap — one cell per
+   day, coloured by the contribution colour ramp
+   ============================================ */
+
+/* Card chrome, header, and padding come from the shared chart styles
+   (Chart.css); this file owns the grid, legend, and cell ramp. */
+
+.ds-contribution-graph {
+  --ds-contribution-cell: 12px;
+  --ds-contribution-gap: 3px;
+
+  min-width: 0;
+}
+
+.ds-contribution-graph__content {
+  display: flex;
+  flex-direction: column;
+  gap: var(--gap-200);
+  min-width: 0;
+}
+
+/* Grid + month labels scroll together on narrow screens */
+.ds-contribution-graph__scroll {
+  display: flex;
+  flex-direction: column;
+  gap: var(--gap-050);
+  overflow-x: auto;
+  padding-bottom: var(--padding-050);
+}
+
+/* ============================================
+   MONTH LABELS
+   ============================================ */
+
+.ds-contribution-graph__months {
+  display: grid;
+  column-gap: var(--ds-contribution-gap);
+  width: 100%;
+}
+
+.ds-contribution-graph__month-label {
+  grid-row: 1;
+  font-family: var(--font-paragraph-sm-family);
+  font-size: var(--font-paragraph-sm-size);
+  font-weight: var(--font-paragraph-sm-weight);
+  line-height: var(--font-paragraph-sm-line-height);
+  color: var(--color-text-tertiary);
+  white-space: nowrap;
+}
+
+/* ============================================
+   GRID
+   ============================================ */
+
+.ds-contribution-graph__grid {
+  display: grid;
+  gap: var(--ds-contribution-gap);
+  width: 100%;
+}
+
+.ds-contribution-graph__week {
+  display: flex;
+  flex-direction: column;
+  gap: var(--ds-contribution-gap);
+}
+
+.ds-contribution-graph__cell {
+  width: var(--ds-contribution-cell);
+  height: var(--ds-contribution-cell);
+  border-radius: var(--radius-050);
+  flex-shrink: 0;
+}
+
+/* Cells inside the grid stretch with their column; the fixed size above
+   only applies to the legend swatches */
+.ds-contribution-graph__week .ds-contribution-graph__cell {
+  width: 100%;
+  height: auto;
+  aspect-ratio: 1 / 1;
+  /* The year sweeps in left to right on mount: each column's delay steps by
+     a fraction of the entrance duration (--ds-contribution-week, set inline
+     per column). Token-composed, so reduced motion collapses the sweep. */
+  animation: ds-contribution-fade var(--motion-duration-slow) var(--motion-ease-standard)
+    backwards;
+  animation-delay: calc(
+    var(--ds-contribution-week, 0) * var(--motion-duration-slower) / 40
+  );
+}
+
+@keyframes ds-contribution-fade {
+  from {
+    opacity: 0;
+  }
+}
+
+/* Hover lifts the day under the pointer, so the title tooltip has a visible
+   anchor. */
+.ds-contribution-graph__week .ds-contribution-graph__cell:not(.ds-contribution-graph__cell--empty):hover {
+  outline: var(--border-025) solid var(--color-text-tertiary);
+  outline-offset: calc(-1 * var(--border-025));
+}
+
+.ds-contribution-graph__cell--empty {
+  background-color: transparent;
+}
+
+.ds-contribution-graph__cell--level-0 {
+  background-color: var(--color-chart-contribution-0);
+}
+
+.ds-contribution-graph__cell--level-1 {
+  background-color: var(--color-chart-contribution-1);
+}
+
+.ds-contribution-graph__cell--level-2 {
+  background-color: var(--color-chart-contribution-2);
+}
+
+.ds-contribution-graph__cell--level-3 {
+  background-color: var(--color-chart-contribution-3);
+}
+
+.ds-contribution-graph__cell--level-4 {
+  background-color: var(--color-chart-contribution-4);
+}
+
+/* ============================================
+   FOOTER — caption + legend
+   ============================================ */
+
+.ds-contribution-graph__footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--gap-400);
+  flex-wrap: wrap;
+}
+
+.ds-contribution-graph__caption {
+  font-family: var(--font-paragraph-sm-family);
+  font-size: var(--font-paragraph-sm-size);
+  font-weight: var(--font-paragraph-sm-weight);
+  line-height: var(--font-paragraph-sm-line-height);
+  color: var(--color-text-secondary);
+}
+
+.ds-contribution-graph__legend {
+  display: flex;
+  align-items: center;
+  gap: var(--ds-contribution-gap);
+}
+
+.ds-contribution-graph__legend-label {
+  font-family: var(--font-paragraph-sm-family);
+  font-size: var(--font-paragraph-sm-size);
+  font-weight: var(--font-paragraph-sm-weight);
+  line-height: var(--font-paragraph-sm-line-height);
+  color: var(--color-text-tertiary);
+}
+
+.ds-contribution-graph__legend-label:first-child {
+  margin-right: var(--gap-050);
+}
+
+.ds-contribution-graph__legend-label:last-child {
+  margin-left: var(--gap-050);
+}

package/components/ContributionGraph/ContributionGraph.d.ts

@@ -0,0 +1,34 @@
+export interface ContributionDay {
+    /** ISO date string, e.g. "2026-07-08" */
+    date: string;
+    /** Number of contributions on this day */
+    count: number;
+    /** Intensity level 0 (none) to 4 (most) — drives the cell colour */
+    level: 0 | 1 | 2 | 3 | 4;
+}
+export interface ContributionGraphProps {
+    /** One entry per day, ordered oldest to newest */
+    days: ContributionDay[];
+    /** Chart title, in the shared chart header. */
+    title?: string;
+    /** Description text below the title. */
+    subtitle?: string;
+    /** Strip the card chrome (border, padding, fill) when the chart sits inside another panel that supplies the surface */
+    bare?: boolean;
+    /** Summary line shown under the grid, e.g. "496 contributions in the last year" */
+    caption?: string;
+    /** Show month labels above the grid */
+    showMonthLabels?: boolean;
+    /** Show the Less → More legend under the grid */
+    showLegend?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * ContributionGraph renders a GitHub-style contribution heatmap:
+ * one cell per day, arranged in weekday rows and week columns,
+ * coloured by activity level via the --color-chart-contribution-* ramp.
+ * It wears the chart family's card chrome (title, subtitle, padding) and
+ * takes `bare` to drop it inside a panel that supplies the surface.
+ */
+export declare const ContributionGraph: ({ days, title, subtitle, bare, caption, showMonthLabels, showLegend, className, }: ContributionGraphProps) => import("react").JSX.Element;