@robr0/design-system 0.7.0 → 0.9.0

package/components/TimePicker/TimePicker.js

@@ -0,0 +1,246 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import React, { useState, useRef, useId, useMemo, useCallback, useEffect } from "react";
+import { Field } from "../Field/Field.js";
+import "./TimePicker.css";
+import "../../fonts/material-symbols.css";
+function parseMinutes(time) {
+  const [h, m] = time.split(":").map(Number);
+  return h * 60 + m;
+}
+function toTimeValue(minutes) {
+  const h = Math.floor(minutes / 60);
+  const m = minutes % 60;
+  return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}`;
+}
+function formatTime(time, hourFormat) {
+  if (hourFormat === "24") return time;
+  const [h, m] = time.split(":").map(Number);
+  const suffix = h < 12 ? "AM" : "PM";
+  const hour12 = h % 12 === 0 ? 12 : h % 12;
+  return `${hour12}:${String(m).padStart(2, "0")} ${suffix}`;
+}
+const TimePicker = React.forwardRef(
+  ({
+    label,
+    placeholder = "Select time",
+    value,
+    defaultValue,
+    minTime = "00:00",
+    maxTime = "23:30",
+    stepMinutes = 30,
+    hourFormat = "12",
+    size = "default",
+    disabled = false,
+    required = false,
+    error = false,
+    helperText,
+    onValueChange,
+    className = "",
+    id,
+    ...rest
+  }, ref) => {
+    const [isOpen, setIsOpen] = useState(false);
+    const [focusedIndex, setFocusedIndex] = useState(-1);
+    const [internalValue, setInternalValue] = useState(defaultValue);
+    const rootRef = useRef(null);
+    const triggerRef = useRef(null);
+    const listRef = useRef(null);
+    const isControlled = value !== void 0;
+    const selectedValue = isControlled ? value : internalValue;
+    const setTriggerRef = (node) => {
+      triggerRef.current = node;
+      if (typeof ref === "function") ref(node);
+      else if (ref) ref.current = node;
+    };
+    const generatedId = useId();
+    const inputId = id || generatedId;
+    const baseClass = "ds-timepicker";
+    const classes = [
+      baseClass,
+      size === "compact" ? `${baseClass}--compact` : "",
+      isOpen ? `${baseClass}--open` : "",
+      error ? `${baseClass}--error` : "",
+      disabled ? `${baseClass}--disabled` : "",
+      className
+    ].filter(Boolean).join(" ");
+    const timeOptions = useMemo(() => {
+      const step = Math.max(1, Math.floor(stepMinutes));
+      const start = parseMinutes(minTime);
+      const end = parseMinutes(maxTime);
+      const opts = [];
+      for (let mins = start; mins <= end; mins += step) {
+        const v = toTimeValue(mins);
+        opts.push({ value: v, label: formatTime(v, hourFormat) });
+      }
+      return opts;
+    }, [minTime, maxTime, stepMinutes, hourFormat]);
+    const selectedIndex = timeOptions.findIndex((opt) => opt.value === selectedValue);
+    const selectedOption = selectedIndex >= 0 ? timeOptions[selectedIndex] : void 0;
+    const openMenu = () => {
+      setIsOpen(true);
+      setFocusedIndex(selectedIndex >= 0 ? selectedIndex : timeOptions.length > 0 ? 0 : -1);
+    };
+    const closeMenu = () => {
+      setIsOpen(false);
+      setFocusedIndex(-1);
+    };
+    const handleToggle = () => {
+      if (disabled) return;
+      if (isOpen) closeMenu();
+      else openMenu();
+    };
+    const handleSelect = (optionValue) => {
+      if (!isControlled) setInternalValue(optionValue);
+      onValueChange?.(optionValue);
+      closeMenu();
+    };
+    const handleClickOutside = useCallback((e) => {
+      if (rootRef.current && !rootRef.current.contains(e.target)) {
+        setIsOpen(false);
+      }
+    }, []);
+    useEffect(() => {
+      document.addEventListener("mousedown", handleClickOutside);
+      return () => document.removeEventListener("mousedown", handleClickOutside);
+    }, [handleClickOutside]);
+    const handleKeyDown = (e) => {
+      if (disabled) return;
+      switch (e.key) {
+        case "Enter":
+        case " ":
+          e.preventDefault();
+          if (isOpen && focusedIndex >= 0 && timeOptions[focusedIndex]) {
+            handleSelect(timeOptions[focusedIndex].value);
+          } else {
+            handleToggle();
+          }
+          break;
+        case "ArrowDown":
+          e.preventDefault();
+          if (!isOpen) {
+            openMenu();
+          } else {
+            setFocusedIndex((prev) => Math.min(prev + 1, timeOptions.length - 1));
+          }
+          break;
+        case "ArrowUp":
+          e.preventDefault();
+          if (!isOpen) {
+            openMenu();
+          } else {
+            setFocusedIndex((prev) => Math.max(prev - 1, 0));
+          }
+          break;
+        case "Home":
+          if (isOpen) {
+            e.preventDefault();
+            setFocusedIndex(0);
+          }
+          break;
+        case "End":
+          if (isOpen) {
+            e.preventDefault();
+            setFocusedIndex(timeOptions.length - 1);
+          }
+          break;
+        case "Escape":
+          closeMenu();
+          break;
+        case "Tab":
+          closeMenu();
+          break;
+      }
+    };
+    useEffect(() => {
+      if (isOpen && focusedIndex >= 0 && listRef.current) {
+        const focusedEl = listRef.current.children[focusedIndex];
+        focusedEl?.scrollIntoView({ block: "nearest" });
+      }
+    }, [focusedIndex, isOpen]);
+    return /* @__PURE__ */ jsxs(
+      Field,
+      {
+        ref: rootRef,
+        className: classes,
+        label,
+        helperText,
+        error,
+        required,
+        disabled,
+        size,
+        id: inputId,
+        children: [
+          /* @__PURE__ */ jsxs(
+            "button",
+            {
+              ...rest,
+              type: "button",
+              id: inputId,
+              ref: setTriggerRef,
+              className: `${baseClass}__trigger`,
+              "aria-expanded": isOpen,
+              "aria-haspopup": "listbox",
+              "aria-controls": `${inputId}-listbox`,
+              "aria-describedby": helperText ? `${inputId}-helper` : rest["aria-describedby"],
+              "aria-invalid": error || void 0,
+              disabled,
+              onClick: handleToggle,
+              onKeyDown: handleKeyDown,
+              children: [
+                /* @__PURE__ */ jsx("span", { className: `${baseClass}__icon material-symbols-rounded`, "aria-hidden": "true", children: "schedule" }),
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    className: `${baseClass}__value ${!selectedOption ? `${baseClass}__value--placeholder` : ""}`,
+                    children: selectedOption ? selectedOption.label : placeholder
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: `${baseClass}__chevron material-symbols-rounded`, "aria-hidden": "true", children: "expand_more" })
+              ]
+            }
+          ),
+          isOpen && /* @__PURE__ */ jsx(
+            "ul",
+            {
+              className: `${baseClass}__menu`,
+              role: "listbox",
+              id: `${inputId}-listbox`,
+              ref: listRef,
+              "aria-labelledby": label ? `${inputId}-label` : void 0,
+              children: timeOptions.map((option, index) => /* @__PURE__ */ jsxs(
+                "li",
+                {
+                  className: [
+                    `${baseClass}__option`,
+                    option.value === selectedValue ? `${baseClass}__option--selected` : "",
+                    index === focusedIndex ? `${baseClass}__option--focused` : ""
+                  ].filter(Boolean).join(" "),
+                  role: "option",
+                  "aria-selected": option.value === selectedValue,
+                  onClick: () => handleSelect(option.value),
+                  children: [
+                    option.label,
+                    option.value === selectedValue && /* @__PURE__ */ jsx(
+                      "span",
+                      {
+                        className: `${baseClass}__check material-symbols-rounded`,
+                        "aria-hidden": "true",
+                        children: "check"
+                      }
+                    )
+                  ]
+                },
+                option.value
+              ))
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+TimePicker.displayName = "TimePicker";
+export {
+  TimePicker
+};

package/components/Timeline/Timeline.css

@@ -286,6 +286,23 @@
   color: var(--color-status-positive-text);
 }
 
+.ds-timeline__role-subtitle {
+  margin: 0;
+  font-family: var(--font-paragraph-family);
+  font-size: var(--font-paragraph-size);
+  font-weight: var(--font-paragraph-weight);
+  line-height: var(--font-paragraph-line-height);
+  letter-spacing: var(--font-paragraph-letter-spacing);
+  color: var(--color-text-secondary);
+}
+
+/* The title and its subtitle read as one header block, so whatever follows
+   needs a wider break than the role's own 8px rhythm to separate from it. */
+.ds-timeline__role-subtitle + .ds-timeline__role-description,
+.ds-timeline__role-subtitle + .ds-timeline__role-bullets {
+  margin-top: var(--gap-sm);
+}
+
 .ds-timeline__role-description {
   margin: 0;
   font-family: var(--font-paragraph-family);

package/components/Timeline/Timeline.d.ts

@@ -13,6 +13,8 @@ export interface TimelineItem {
 export interface TimelineRole {
     /** Role or position title */
     title: string;
+    /** Secondary line under the title, e.g. the team, org, or product the role sat in */
+    subtitle?: React.ReactNode;
     /** Start of the date range, e.g. "May 2024" (omit for entries with no dates) */
     start?: string;
     /** End of the date range, e.g. "Jan 2026" (ignored when `present` is set) */

package/components/Timeline/Timeline.js

@@ -23,6 +23,7 @@ const CompanyTimeline = ({ items, className = "" }) => {
           /* @__PURE__ */ jsx("h3", { className: `${BASE_CLASS}__role-title`, children: role.title }),
           renderRoleDates(role)
         ] }),
+        role.subtitle && /* @__PURE__ */ jsx("p", { className: `${BASE_CLASS}__role-subtitle`, children: role.subtitle }),
         role.description && /* @__PURE__ */ jsx("p", { className: `${BASE_CLASS}__role-description`, children: role.description }),
         role.bullets && role.bullets.length > 0 && /* @__PURE__ */ jsx("ul", { className: `${BASE_CLASS}__role-bullets`, children: role.bullets.map((bullet, bulletIndex) => /* @__PURE__ */ jsx("li", { children: bullet }, bulletIndex)) })
       ] }, `${role.title}-${roleIndex}`)) })

package/components/Toast/Toast.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx } from "react/jsx-runtime";
 import { useState, useSyncExternalStore, useCallback, useContext, createContext, useRef, useEffect } from "react";
 import ReactDOM from "react-dom";

package/components/ToggleGroup/ToggleGroup.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsx } from "react/jsx-runtime";
 import React from "react";
 import "./ToggleGroup.css";

package/components/ToggleSwitch/ToggleSwitch.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx } from "react/jsx-runtime";
 import React from "react";
 import "./ToggleSwitch.css";

package/components/ToolCall/ToolCall.css

@@ -7,20 +7,19 @@
    The container stays neutral — colour lives in
    the indicator and the status word, so a long
    run of calls reads as a list rather than a
-   wall of tinted cards. The two states a person
-   has to act on, pending and error, also take a
-   coloured border.
+   wall of tinted cards. The border is the
+   standard container hairline in every status;
+   the status word and icon carry the state.
    ============================================ */
 
 .ds-tool-call {
   --ds-tool-call-color: var(--color-text-secondary);
-  --ds-tool-call-border: var(--color-bg-container-border);
 
   display: flex;
   flex-direction: column;
   width: 100%;
   background-color: var(--color-bg-container-primary);
-  border: var(--border-xs) solid var(--ds-tool-call-border);
+  border: var(--border-xs) solid var(--color-bg-container-border);
   border-radius: var(--radius-md);
   overflow: hidden;
 }
@@ -34,7 +33,7 @@
   align-items: center;
   gap: var(--gap-sm);
   width: 100%;
-  padding: var(--padding-xs) var(--padding-sm-md);
+  padding: var(--padding-sm) var(--padding-md);
   background: none;
   border: none;
   text-align: left;
@@ -144,7 +143,6 @@
 
 .ds-tool-call--pending {
   --ds-tool-call-color: var(--color-status-warning-text);
-  --ds-tool-call-border: var(--color-status-warning-border);
 }
 
 .ds-tool-call--running {
@@ -157,7 +155,6 @@
 
 .ds-tool-call--error {
   --ds-tool-call-color: var(--color-status-error-text);
-  --ds-tool-call-border: var(--color-status-error-border);
 }
 
 /* ============================================
@@ -184,7 +181,7 @@
 }
 
 .ds-tool-call--open .ds-tool-call__content {
-  padding: var(--padding-sm-md);
+  padding: var(--padding-md);
   border-top: var(--border-xs) solid var(--color-divider);
 }
 
@@ -207,7 +204,6 @@
   align-items: center;
   justify-content: flex-end;
   gap: var(--gap-sm);
-  padding: var(--padding-sm) var(--padding-sm-md);
+  padding: var(--padding-sm-md) var(--padding-md);
   border-top: var(--border-xs) solid var(--color-divider);
-  background-color: var(--color-bg-container-secondary);
 }

package/components/ToolCall/ToolCall.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx, Fragment } from "react/jsx-runtime";
 import React, { useId, useState, useCallback } from "react";
 import { Spinner } from "../Spinner/Spinner.js";

package/components/Tooltip/Tooltip.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx } from "react/jsx-runtime";
 import { useState, useRef, useId, isValidElement, cloneElement } from "react";
 import "./Tooltip.css";

package/components/TreeView/TreeView.css

@@ -0,0 +1,119 @@
+/* ============================================
+   TREEVIEW COMPONENT
+   Collapsible hierarchy for files, folders,
+   and nested structures
+   ============================================ */
+
+/* Base */
+
+.ds-treeview {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+/* ============================================
+   ITEM — the focusable treeitem (roving tabindex)
+   ============================================ */
+
+.ds-treeview__item {
+  outline: none;
+}
+
+/* The focus ring draws on the item's own row, never on the subtree */
+.ds-treeview__item:focus-visible > .ds-treeview__row {
+  outline: 2px solid var(--color-action-primary-bg);
+  outline-offset: -2px;
+}
+
+/* ============================================
+   ROW — one line of the tree
+   Indentation steps per depth via a custom
+   property the component sets inline.
+   ============================================ */
+
+.ds-treeview__row {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-xs);
+  padding: var(--padding-xxs) var(--padding-sm);
+  padding-left: calc(var(--padding-sm) + var(--ds-treeview-depth, 0) * var(--gap-md));
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition: background-color var(--motion-duration-fast) var(--motion-ease-standard);
+}
+
+/* States */
+
+.ds-treeview__row:hover {
+  background-color: var(--color-action-passive-bg-hover);
+}
+
+.ds-treeview__row--selected {
+  background-color: var(--color-action-passive-bg-active);
+}
+
+.ds-treeview__row--selected .ds-treeview__label {
+  font-weight: var(--font-paragraph-sm-em-weight);
+}
+
+/* ============================================
+   CHEVRON — rotates a quarter turn on expand
+   ============================================ */
+
+.ds-treeview__chevron {
+  flex-shrink: 0;
+  --icon-size: var(--icon-size-sm);
+  color: var(--color-icon-primary);
+  transition: transform var(--motion-duration-fast) var(--motion-ease-standard);
+}
+
+.ds-treeview__item[aria-expanded='true'] > .ds-treeview__row .ds-treeview__chevron {
+  transform: rotate(90deg);
+}
+
+/* Leaves keep the chevron column so labels align across depths */
+.ds-treeview__chevron--spacer {
+  display: inline-block;
+  width: var(--icon-size-sm);
+  height: var(--icon-size-sm);
+}
+
+/* ============================================
+   ICON
+   ============================================ */
+
+.ds-treeview__icon {
+  flex-shrink: 0;
+  --icon-size: var(--icon-size-sm);
+  color: var(--color-icon-primary);
+}
+
+/* ============================================
+   LABEL
+   ============================================ */
+
+.ds-treeview__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);
+  letter-spacing: var(--font-paragraph-sm-letter-spacing);
+  color: var(--color-text-primary);
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+
+/* ============================================
+   GROUP — nested children
+   ============================================ */
+
+.ds-treeview__group {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}

package/components/TreeView/TreeView.d.ts

@@ -0,0 +1,45 @@
+import { default as React } from 'react';
+export interface TreeViewNode {
+    /** Unique identifier for the node */
+    id: string;
+    /** Text shown on the row */
+    label: string;
+    /** Material Symbol name; defaults to `folder` for branches and `draft` for leaves */
+    icon?: string;
+    /** Child nodes; a non-empty list makes the node an expandable branch */
+    children?: TreeViewNode[];
+}
+/** Props owned by TreeView itself — everything else falls through to the root <ul>. */
+type TreeViewOwnProps = {
+    /** Tree data to render */
+    nodes: TreeViewNode[];
+    /** IDs of initially expanded branches (uncontrolled) */
+    defaultExpandedIds?: string[];
+    /** Expanded branch IDs (controlled) — pair with `onExpandedChange` */
+    expandedIds?: string[];
+    /** Called with the full list of expanded branch IDs whenever a branch toggles */
+    onExpandedChange?: (ids: string[]) => void;
+    /** Selected node ID (controlled) — pair with `onSelect` */
+    selectedId?: string;
+    /** ID of the initially selected node (uncontrolled) */
+    defaultSelectedId?: string;
+    /**
+     * Called with the node's ID when a row is selected via click, Enter, or
+     * Space. Intentionally shadows the native `select` event handler, which
+     * has no meaning on a tree widget.
+     */
+    onSelect?: (id: string) => void;
+    /** Additional CSS classes */
+    className?: string;
+};
+export interface TreeViewProps extends TreeViewOwnProps, Omit<React.ComponentPropsWithoutRef<'ul'>, keyof TreeViewOwnProps> {
+}
+/**
+ * TreeView renders a collapsible hierarchy — files, folders, and other
+ * nested structures — as a WAI-ARIA tree. Branches expand and collapse,
+ * one node can be selected, and a roving tabindex gives the whole tree a
+ * single tab stop with full arrow-key navigation. Expansion and selection
+ * each work controlled or uncontrolled.
+ */
+export declare const TreeView: React.ForwardRefExoticComponent<TreeViewProps & React.RefAttributes<HTMLUListElement>>;
+export {};