@robr0/design-system 0.9.0 → 0.11.0

package/components/DropdownMenu/DropdownMenu.js

@@ -1,6 +1,7 @@
 "use client";
 import { jsxs, jsx } from "react/jsx-runtime";
-import React, { useState, useRef, useCallback, useEffect } from "react";
+import React, { useState, useRef, useId, useCallback, useEffect } from "react";
+import { MOTION_HOVER_HIDE_DELAY_MS } from "../../tokens/motion.js";
 import "./DropdownMenu.css";
 import "../../fonts/material-symbols.css";
 function collectItems(entries) {
@@ -15,7 +16,7 @@ function collectItems(entries) {
   }
   return result;
 }
-const SubMenuItem = ({ item, baseClass, focused, size, onActivate }) => {
+const SubMenuItem = ({ item, baseClass, itemId, focused, size, onActivate }) => {
   const [subOpen, setSubOpen] = useState(false);
   const timeoutRef = useRef(null);
   const handleMouseEnter = () => {
@@ -23,7 +24,7 @@ const SubMenuItem = ({ item, baseClass, focused, size, onActivate }) => {
     setSubOpen(true);
   };
   const handleMouseLeave = () => {
-    timeoutRef.current = setTimeout(() => setSubOpen(false), 150);
+    timeoutRef.current = setTimeout(() => setSubOpen(false), MOTION_HOVER_HIDE_DELAY_MS);
   };
   useEffect(() => {
     return () => {
@@ -45,6 +46,7 @@ const SubMenuItem = ({ item, baseClass, focused, size, onActivate }) => {
   return /* @__PURE__ */ jsxs(
     "li",
     {
+      id: itemId,
       className: classes,
       role: "menuitem",
       "aria-haspopup": "menu",
@@ -67,6 +69,7 @@ const SubMenuItem = ({ item, baseClass, focused, size, onActivate }) => {
           {
             entries: item.children,
             baseClass,
+            itemIdBase: `${itemId}-sub`,
             size,
             isSubmenu: true,
             onItemActivate: onActivate
@@ -79,6 +82,7 @@ const SubMenuItem = ({ item, baseClass, focused, size, onActivate }) => {
 const MenuPanel = ({
   entries,
   baseClass,
+  itemIdBase,
   size,
   isSubmenu = false,
   onItemActivate
@@ -88,14 +92,15 @@ const MenuPanel = ({
     isSubmenu ? `${baseClass}__submenu` : "",
     size === "compact" ? `${baseClass}__panel--compact` : ""
   ].filter(Boolean).join(" ");
-  const renderEntry = (entry, index) => {
+  const renderEntry = (entry, index, idBase) => {
+    const entryId = `${idBase}-${index}`;
     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: "group", "aria-label": entry.label, children: [
         /* @__PURE__ */ jsx("span", { className: `${baseClass}__group-label`, children: entry.label }),
-        /* @__PURE__ */ jsx("ul", { className: `${baseClass}__group-list`, role: "group", children: entry.items.map((subEntry, subIndex) => renderEntry(subEntry, subIndex)) })
+        /* @__PURE__ */ jsx("ul", { className: `${baseClass}__group-list`, role: "group", children: entry.items.map((subEntry, subIndex) => renderEntry(subEntry, subIndex, entryId)) })
       ] }, `group-${index}`);
     }
     if (entry.children && entry.children.length > 0) {
@@ -104,6 +109,7 @@ const MenuPanel = ({
         {
           item: entry,
           baseClass,
+          itemId: entryId,
           focused: false,
           size,
           onActivate: onItemActivate
@@ -119,6 +125,7 @@ const MenuPanel = ({
     return /* @__PURE__ */ jsxs(
       "li",
       {
+        id: entryId,
         className: itemClasses,
         role: "menuitem",
         "aria-disabled": entry.disabled || void 0,
@@ -140,7 +147,7 @@ const MenuPanel = ({
       `item-${index}`
     );
   };
-  return /* @__PURE__ */ jsx("ul", { className: panelClasses, role: "menu", children: entries.map((entry, index) => renderEntry(entry, index)) });
+  return /* @__PURE__ */ jsx("ul", { className: panelClasses, role: "menu", children: entries.map((entry, index) => renderEntry(entry, index, itemIdBase)) });
 };
 const DropdownMenu = ({
   trigger,
@@ -153,9 +160,12 @@ const DropdownMenu = ({
   const [focusedIndex, setFocusedIndex] = useState(-1);
   const rootRef = useRef(null);
   const panelRef = useRef(null);
+  const generatedId = useId();
   const baseClass = "ds-dropdown-menu";
   const classes = [baseClass, className].filter(Boolean).join(" ");
   const flatItems = collectItems(items);
+  const menuId = `${generatedId}-menu`;
+  const activeDescendantId = isOpen && focusedIndex >= 0 ? `${generatedId}-item-${focusedIndex}` : void 0;
   const handleToggle = () => {
     setIsOpen((prev) => {
       if (!prev) setFocusedIndex(-1);
@@ -214,6 +224,26 @@ const DropdownMenu = ({
           });
         }
         break;
+      case "Home":
+        if (isOpen) {
+          e.preventDefault();
+          setFocusedIndex((prev) => {
+            let next = 0;
+            while (next < flatItems.length && flatItems[next].disabled) next++;
+            return next < flatItems.length ? next : prev;
+          });
+        }
+        break;
+      case "End":
+        if (isOpen) {
+          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":
         handleClose();
@@ -248,6 +278,7 @@ const DropdownMenu = ({
         {
           item: entry,
           baseClass,
+          itemId: `${generatedId}-item-${myIndex}`,
           focused: isFocused,
           size,
           onActivate: handleClose
@@ -264,6 +295,7 @@ const DropdownMenu = ({
     return /* @__PURE__ */ jsxs(
       "li",
       {
+        id: `${generatedId}-item-${myIndex}`,
         className: itemClasses,
         role: "menuitem",
         "aria-disabled": entry.disabled || void 0,
@@ -295,6 +327,8 @@ const DropdownMenu = ({
     /* @__PURE__ */ jsx("div", { className: `${baseClass}__trigger`, children: React.isValidElement(trigger) ? React.cloneElement(trigger, {
       "aria-haspopup": "menu",
       "aria-expanded": isOpen,
+      "aria-controls": isOpen ? menuId : void 0,
+      "aria-activedescendant": activeDescendantId,
       onClick: handleToggle,
       onKeyDown: handleKeyDown
     }) : /* @__PURE__ */ jsx(
@@ -303,6 +337,8 @@ const DropdownMenu = ({
         type: "button",
         "aria-haspopup": "menu",
         "aria-expanded": isOpen,
+        "aria-controls": isOpen ? menuId : void 0,
+        "aria-activedescendant": activeDescendantId,
         onClick: handleToggle,
         onKeyDown: handleKeyDown,
         children: trigger
@@ -311,6 +347,7 @@ const DropdownMenu = ({
     isOpen && /* @__PURE__ */ jsx(
       "ul",
       {
+        id: menuId,
         className: panelClasses,
         role: "menu",
         ref: (el) => {

package/components/EmptyState/EmptyState.css

@@ -113,3 +113,12 @@
   line-height: var(--font-paragraph-em-line-height);
   letter-spacing: var(--font-paragraph-em-letter-spacing);
 }
+
+/* Icons take the colour of the text around them. Explicit, not just
+   inherited by default: a consumer stylesheet that sets a colour on
+   .material-symbols-rounded itself (a common global default) would
+   otherwise override inheritance and detach the icon from the state
+   colours this component sets on its parents. */
+.ds-empty-state .material-symbols-rounded {
+  color: inherit;
+}

package/components/FileInput/FileInput.css

@@ -270,3 +270,12 @@
 .ds-file-input--compact .ds-file-input__file {
   padding: var(--padding-xs) var(--padding-sm); /* 6px 8px */
 }
+
+/* Icons take the colour of the text around them. Explicit, not just
+   inherited by default: a consumer stylesheet that sets a colour on
+   .material-symbols-rounded itself (a common global default) would
+   otherwise override inheritance and detach the icon from the state
+   colours this component sets on its parents. */
+.ds-file-input .material-symbols-rounded {
+  color: inherit;
+}

package/components/Globe/Globe.css

@@ -0,0 +1,155 @@
+/* ============================================
+   GLOBE COMPONENT
+   An orthographic globe: graticule, markers and
+   great-circle arcs. Every colour is a token; the
+   stroke widths are SVG geometry in viewBox units,
+   like Sparkline's, and scale with the drawing.
+   ============================================ */
+
+/* Base */
+
+.ds-globe {
+  position: relative;
+  display: block;
+  width: 100%;
+  aspect-ratio: 1;
+  color: var(--color-text-primary);
+  border-radius: var(--radius-md);
+  outline: none;
+  touch-action: none;
+  user-select: none;
+  -webkit-user-select: none;
+}
+
+.ds-globe:focus-visible {
+  outline: var(--border-md) solid var(--color-action-primary-bg);
+  outline-offset: var(--padding-xxs);
+}
+
+.ds-globe--interactive {
+  cursor: grab;
+}
+
+.ds-globe--dragging {
+  cursor: grabbing;
+}
+
+.ds-globe__svg {
+  display: block;
+  width: 100%;
+  height: 100%;
+  overflow: visible;
+}
+
+/* Sphere */
+
+.ds-globe__limb {
+  fill: none;
+  stroke: var(--color-text-tertiary);
+  stroke-width: 1;
+  opacity: 0.6;
+}
+
+.ds-globe__graticule {
+  fill: none;
+  stroke: var(--color-divider);
+  stroke-width: 1;
+}
+
+.ds-globe__graticule-back {
+  fill: none;
+  stroke: var(--color-divider);
+  stroke-width: 1;
+  stroke-dasharray: 2 4;
+  opacity: 0.5;
+}
+
+/* Arcs — the default gradient runs along the cobalt-to-violet end of the
+   chart series; a per-arc `color` replaces it with a flat stroke. */
+
+.ds-globe__arc-stop-start {
+  stop-color: var(--color-chart-series-7);
+}
+
+.ds-globe__arc-stop-end {
+  stop-color: var(--color-chart-series-5);
+}
+
+.ds-globe__arc {
+  fill: none;
+  stroke-width: 1.5;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+}
+
+.ds-globe__arc-back {
+  fill: none;
+  stroke-width: 1;
+  stroke-linecap: round;
+  opacity: 0.15;
+}
+
+/* Markers */
+
+.ds-globe__point {
+  color: var(--color-text-secondary);
+  transition: color var(--motion-duration-fast) var(--motion-ease-standard);
+}
+
+.ds-globe__point--back {
+  opacity: 0.3;
+}
+
+.ds-globe__point--active,
+.ds-globe__point:hover {
+  color: var(--color-text-primary);
+}
+
+.ds-globe__hit {
+  fill: transparent;
+  stroke: none;
+  pointer-events: all;
+}
+
+.ds-globe--interactive .ds-globe__point {
+  cursor: pointer;
+}
+
+.ds-globe__glyph {
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 1.5;
+  stroke-linecap: round;
+  transform-box: fill-box;
+  transform-origin: center;
+  transition: transform var(--motion-duration-fast) var(--motion-ease-emphasized);
+}
+
+.ds-globe__point--active .ds-globe__glyph {
+  transform: scale(1.4);
+}
+
+.ds-globe__label {
+  font-family: var(--font-family-code);
+  font-size: var(--font-caption-size);
+  fill: var(--color-text-tertiary);
+  pointer-events: none;
+}
+
+.ds-globe__point--active .ds-globe__label {
+  fill: var(--color-text-primary);
+}
+
+/* Callout overlay — positioned at the marker, opening away from the centre. */
+
+.ds-globe__callout {
+  position: absolute;
+  pointer-events: none;
+  padding: 0 var(--padding-md);
+  transform: translate(0, -100%);
+  white-space: nowrap;
+}
+
+.ds-globe__callout[data-side='left'] {
+  transform: translate(-100%, -100%);
+}

package/components/Globe/Globe.d.ts

@@ -0,0 +1,96 @@
+import { default as React } from 'react';
+/** A place on the globe. */
+export interface GlobePoint {
+    /** Stable identifier, referenced by arcs and by `activePointId`. */
+    id: string;
+    /** Latitude in degrees, north positive. */
+    lat: number;
+    /** Longitude in degrees, east positive. */
+    lng: number;
+    /** Short label drawn beside the marker when `showLabels` is on. */
+    label?: string;
+    /**
+     * Marker glyph. `point` is a cross (something that moves or listens),
+     * `anchor` is a square (something fixed). The glyph is the only difference.
+     */
+    kind?: 'point' | 'anchor';
+}
+/** A great-circle arc between two points. */
+export interface GlobeArc {
+    /** `id` of the point the arc leaves. */
+    from: string;
+    /** `id` of the point the arc reaches. */
+    to: string;
+    /**
+     * Stroke colour, any CSS colour (`var(--color-chart-series-3)` works).
+     * Omit for the default cobalt-to-violet gradient along the arc.
+     */
+    color?: string;
+    /** How far the arc lifts off the surface at its midpoint, as a fraction of the radius. */
+    altitude?: number;
+}
+/** Where the globe is looking: `[longitude, latitude]` of the centre, in degrees. */
+export type GlobeRotation = [number, number];
+/** Props owned by Globe itself — everything else falls through to the root `<div>`. */
+type GlobeOwnProps = {
+    /** The places to mark. */
+    points?: GlobePoint[];
+    /** The arcs to draw between them. An arc whose endpoint is not in `points` is skipped. */
+    arcs?: GlobeArc[];
+    /**
+     * Controlled view: `[longitude, latitude]` of the centre, in degrees.
+     * Pair with `onRotationChange`. Omit to let the globe own its rotation.
+     */
+    rotation?: GlobeRotation;
+    /** Initial view when uncontrolled. */
+    defaultRotation?: GlobeRotation;
+    /** Fires whenever the view changes — drag, keys, or the auto-rotation. */
+    onRotationChange?: (rotation: GlobeRotation) => void;
+    /**
+     * Spin slowly on its own, in degrees per second. Pauses while the pointer
+     * is over the globe or it has focus, and never runs under
+     * `prefers-reduced-motion`. `0` switches it off.
+     */
+    autoRotate?: number;
+    /** Drag to rotate, and rotate with the arrow keys (or W, A, S, D) when focused. */
+    interactive?: boolean;
+    /** Degrees between graticule lines. `0` removes the graticule. */
+    graticuleStep?: number;
+    /** Draw each point's `label` beside its marker. */
+    showLabels?: boolean;
+    /** The point to single out: its marker enlarges and its callout renders. */
+    activePointId?: string;
+    /** Fires as the pointer enters a marker, and with `null` as it leaves. */
+    onPointHover?: (point: GlobePoint | null) => void;
+    /** Fires when a marker is clicked. */
+    onPointClick?: (point: GlobePoint) => void;
+    /**
+     * Renders the annotation for the active (or hovered) point. It is placed
+     * beside the marker in an HTML overlay, so any markup works; MapCallout is
+     * the intended filling. The overlay carries `data-side="left"|"right"` for
+     * which side of the marker it sits on.
+     */
+    renderCallout?: (point: GlobePoint) => React.ReactNode;
+    /**
+     * Accessible name for the globe, e.g. "Listening points across the
+     * network". The point and arc counts are appended for screen readers.
+     */
+    label?: string;
+    /** Additional CSS classes */
+    className?: string;
+};
+export interface GlobeProps extends GlobeOwnProps, Omit<React.ComponentPropsWithoutRef<'div'>, keyof GlobeOwnProps | 'children'> {
+}
+/**
+ * Globe — an orthographic globe drawn in SVG, for showing where things are
+ * and what connects them: a graticule, markers at lat/lng, and great-circle
+ * arcs between them. No map library, no tile server, no land data; the
+ * graticule alone gives the sphere its shape, which is the point — this is
+ * for the geometry of a network, not for navigation.
+ *
+ * Colour comes from the tokens: the graticule in the divider colour, markers
+ * in the text colours, arcs along the cobalt-to-violet chart series. Rotate
+ * it by dragging, with the arrow keys when focused, or let it turn on its own.
+ */
+export declare const Globe: React.ForwardRefExoticComponent<GlobeProps & React.RefAttributes<HTMLDivElement>>;
+export {};