rift-ds 1.0.0

package/components/Accordion/Accordion.css

@@ -0,0 +1,119 @@
+/* ============================================
+   ACCORDION COMPONENT
+   Collapsible content sections
+   ============================================ */
+
+.ds-accordion {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  border: var(--border-025) solid var(--color-bg-container-border);
+  border-radius: var(--radius-200);
+  overflow: hidden;
+}
+
+/* ============================================
+   ITEM
+   ============================================ */
+
+.ds-accordion__item {
+  border-bottom: var(--border-025) solid var(--color-bg-container-border);
+}
+
+.ds-accordion__item:last-child {
+  border-bottom: none;
+}
+
+/* ============================================
+   TRIGGER
+   ============================================ */
+
+.ds-accordion__trigger {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  gap: var(--gap-200);
+  padding: var(--padding-400) var(--padding-500);
+  background: none;
+  border: none;
+  cursor: pointer;
+  text-align: left;
+  transition: background-color var(--motion-duration-fast) var(--motion-ease-standard);
+}
+
+.ds-accordion__trigger:hover {
+  background-color: var(--color-action-passive-bg-hover);
+}
+
+.ds-accordion__trigger:focus-visible {
+  outline: 2px solid var(--color-action-primary-bg);
+  outline-offset: -2px;
+  border-radius: var(--radius-200);
+}
+
+/* ============================================
+   TITLE
+   ============================================ */
+
+.ds-accordion__title {
+  font-family: var(--font-paragraph-emphasis-family);
+  font-size: var(--font-paragraph-emphasis-size);
+  font-weight: var(--font-paragraph-emphasis-weight);
+  line-height: var(--font-paragraph-emphasis-line-height);
+  letter-spacing: var(--font-paragraph-emphasis-letter-spacing);
+  color: var(--color-text-primary);
+}
+
+/* ============================================
+   ICON
+   ============================================ */
+
+.ds-accordion__icon {
+  flex-shrink: 0;
+  --icon-size: var(--icon-size-500);
+  color: var(--color-icon-primary);
+  transition: transform var(--motion-duration-slow) var(--motion-ease-standard);
+}
+
+.ds-accordion__item--open .ds-accordion__icon {
+  transform: rotate(180deg);
+}
+
+/* ============================================
+   PANEL
+   ============================================ */
+
+.ds-accordion__panel {
+  display: grid;
+  grid-template-rows: 0fr;
+  transition: grid-template-rows var(--motion-duration-slow) var(--motion-ease-standard);
+}
+
+.ds-accordion__item--open .ds-accordion__panel {
+  grid-template-rows: 1fr;
+}
+
+/* ============================================
+   CONTENT
+   ============================================ */
+
+.ds-accordion__content {
+  overflow: hidden;
+  padding: 0 var(--padding-500);
+  transition: padding var(--motion-duration-slow) var(--motion-ease-standard);
+}
+
+.ds-accordion__item--open .ds-accordion__content {
+  padding: 0 var(--padding-500) var(--padding-400);
+}
+
+.ds-accordion__content p {
+  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);
+  margin: 0;
+}

package/components/Accordion/Accordion.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+export interface AccordionItem {
+    /** Unique identifier */
+    id: string;
+    /** Header text */
+    title: string;
+    /** Body content */
+    content: React.ReactNode;
+}
+export interface AccordionProps {
+    /** List of accordion items */
+    items: AccordionItem[];
+    /** Allow multiple items open at once */
+    multiple?: boolean;
+    /** IDs of initially expanded items */
+    defaultExpanded?: string[];
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Accordion organises content into collapsible sections.
+ * Supports single or multiple open panels.
+ */
+export declare const Accordion: ({ items, multiple, defaultExpanded, className, }: AccordionProps) => React.JSX.Element;

package/components/Accordion/Accordion.js

@@ -0,0 +1,76 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState, useCallback } from "react";
+import "./Accordion.css";
+import "../../fonts/material-symbols.css";
+const Accordion = ({
+  items,
+  multiple = false,
+  defaultExpanded = [],
+  className = ""
+}) => {
+  const [expanded, setExpanded] = useState(new Set(defaultExpanded));
+  const baseClass = "ds-accordion";
+  const classes = [baseClass, className].filter(Boolean).join(" ");
+  const toggle = useCallback(
+    (id) => {
+      setExpanded((prev) => {
+        const next = new Set(prev);
+        if (next.has(id)) {
+          next.delete(id);
+        } else {
+          if (!multiple) next.clear();
+          next.add(id);
+        }
+        return next;
+      });
+    },
+    [multiple]
+  );
+  return /* @__PURE__ */ jsx("div", { className: classes, children: items.map((item) => {
+    const isOpen = expanded.has(item.id);
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: `${baseClass}__item${isOpen ? ` ${baseClass}__item--open` : ""}`,
+        children: [
+          /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              className: `${baseClass}__trigger`,
+              "aria-expanded": isOpen,
+              "aria-controls": `${baseClass}-panel-${item.id}`,
+              id: `${baseClass}-header-${item.id}`,
+              onClick: () => toggle(item.id),
+              children: [
+                /* @__PURE__ */ jsx("span", { className: `${baseClass}__title`, children: item.title }),
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    className: `${baseClass}__icon material-symbols-rounded`,
+                    "aria-hidden": "true",
+                    children: "expand_more"
+                  }
+                )
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              id: `${baseClass}-panel-${item.id}`,
+              "aria-labelledby": `${baseClass}-header-${item.id}`,
+              className: `${baseClass}__panel`,
+              children: /* @__PURE__ */ jsx("div", { className: `${baseClass}__content`, children: item.content })
+            }
+          )
+        ]
+      },
+      item.id
+    );
+  }) });
+};
+export {
+  Accordion
+};

package/components/AgentPlan/AgentPlan.css

@@ -0,0 +1,251 @@
+/* ============================================
+   AGENT PLAN COMPONENT
+   A collapsible checklist of an agent's task:
+   a progress header and one row per step.
+
+   The container stays neutral, like ToolCall —
+   colour lives in each step's indicator, so a
+   long plan reads as a list rather than a wall
+   of tinted rows. A thin connector ties the
+   indicators into one path through the task.
+   ============================================ */
+
+.ds-agent-plan {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  background-color: var(--color-bg-container-primary);
+  border: var(--border-025) solid var(--color-bg-container-border);
+  /* The chat furniture's shared 24px shell — see ToolCall. */
+  border-radius: var(--radius-600);
+  overflow: hidden;
+}
+
+/* ============================================
+   HEADER
+   ============================================ */
+
+.ds-agent-plan__header {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-200);
+  width: 100%;
+  /* 20px sides — the card family's shared content inset. */
+  padding: var(--padding-200) var(--padding-500);
+  background: none;
+  border: none;
+  text-align: left;
+  cursor: pointer;
+  transition: background-color var(--motion-duration-fast) var(--motion-ease-standard);
+}
+
+.ds-agent-plan__header:hover {
+  background-color: var(--color-bg-container-secondary);
+}
+
+.ds-agent-plan__header:focus-visible {
+  outline: 2px solid var(--color-action-primary-bg);
+  outline-offset: -2px;
+}
+
+.ds-agent-plan__title {
+  flex: 1 1 auto;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--color-text-primary);
+  font-family: var(--font-paragraph-sm-emphasis-family);
+  font-size: var(--font-paragraph-sm-emphasis-size);
+  font-weight: var(--font-paragraph-sm-emphasis-weight);
+  line-height: var(--font-paragraph-sm-emphasis-line-height);
+  letter-spacing: var(--font-paragraph-sm-emphasis-letter-spacing);
+}
+
+.ds-agent-plan__count {
+  flex: none;
+  color: var(--color-text-tertiary);
+  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);
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+}
+
+.ds-agent-plan__chevron {
+  --icon-size: var(--icon-size-500);
+
+  flex: none;
+  color: var(--color-icon-secondary);
+  transition: transform var(--motion-duration-slow) var(--motion-ease-standard);
+}
+
+.ds-agent-plan--open .ds-agent-plan__chevron {
+  transform: rotate(180deg);
+}
+
+/* ============================================
+   PANEL
+   Same grid-rows collapse as ToolCall, so the
+   list opens and closes without measuring.
+   ============================================ */
+
+.ds-agent-plan__panel {
+  display: grid;
+  grid-template-rows: 0fr;
+  visibility: hidden;
+  transition:
+    grid-template-rows var(--motion-duration-slow) var(--motion-ease-standard),
+    visibility var(--motion-duration-slow) var(--motion-ease-standard);
+}
+
+.ds-agent-plan--open .ds-agent-plan__panel {
+  grid-template-rows: 1fr;
+  visibility: visible;
+}
+
+.ds-agent-plan__content {
+  overflow: hidden;
+  min-height: 0;
+}
+
+.ds-agent-plan--open .ds-agent-plan__content {
+  border-top: var(--border-025) solid var(--color-divider);
+}
+
+/* ============================================
+   STEPS
+   ============================================ */
+
+.ds-agent-plan__steps {
+  display: flex;
+  flex-direction: column;
+  margin: 0;
+  padding: var(--padding-300) var(--padding-500);
+  list-style: none;
+}
+
+.ds-agent-plan__step {
+  position: relative;
+  display: flex;
+  align-items: flex-start;
+  gap: var(--gap-200);
+  padding: var(--padding-100) 0;
+}
+
+/* Connector — a thin line linking each indicator to the next */
+.ds-agent-plan__step:not(:last-child)::before {
+  content: '';
+  position: absolute;
+  top: calc(var(--padding-100) + var(--icon-size-500));
+  bottom: calc(-1 * var(--padding-100));
+  left: calc(var(--icon-size-500) / 2);
+  width: var(--border-025);
+  background-color: var(--color-divider);
+}
+
+.ds-agent-plan__indicator {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  /* Fixed box: the active step's spinner (16px) is smaller than the step
+     icons (20px), so without this the column narrows and the spinner drifts
+     off the connector's centre line. */
+  width: var(--icon-size-500);
+  height: var(--icon-size-500);
+  color: var(--color-icon-secondary);
+}
+
+.ds-agent-plan__indicator .material-symbols-rounded {
+  --icon-size: var(--icon-size-500);
+}
+
+.ds-agent-plan__step-body {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  /* Align the first text line with the indicator's optical centre */
+  padding-top: calc((var(--icon-size-500) - var(--font-paragraph-sm-line-height)) / 2);
+}
+
+.ds-agent-plan__label {
+  color: var(--color-text-primary);
+  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);
+}
+
+.ds-agent-plan__detail {
+  color: var(--color-text-tertiary);
+  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);
+}
+
+/* ============================================
+   STEP STATES
+   ============================================ */
+
+.ds-agent-plan__step--pending .ds-agent-plan__indicator {
+  color: var(--color-status-neutral-icon);
+}
+
+.ds-agent-plan__step--completed .ds-agent-plan__indicator {
+  color: var(--color-status-positive-icon);
+}
+
+.ds-agent-plan__step--completed .ds-agent-plan__label {
+  color: var(--color-text-tertiary);
+}
+
+.ds-agent-plan__step--active .ds-agent-plan__indicator {
+  color: var(--color-status-info-icon);
+}
+
+.ds-agent-plan__step--active .ds-agent-plan__label {
+  font-family: var(--font-paragraph-sm-emphasis-family);
+  font-weight: var(--font-paragraph-sm-emphasis-weight);
+  letter-spacing: var(--font-paragraph-sm-emphasis-letter-spacing);
+}
+
+.ds-agent-plan__step--failed .ds-agent-plan__indicator {
+  color: var(--color-status-error-icon);
+}
+
+.ds-agent-plan__step--failed .ds-agent-plan__label {
+  color: var(--color-status-error-text);
+}
+
+/* ============================================
+   SCREEN READER TEXT
+   Status is colour + glyph for sighted users;
+   this span announces it.
+   ============================================ */
+
+.ds-agent-plan__sr {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+/* 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-agent-plan .material-symbols-rounded {
+  color: inherit;
+}

package/components/AgentPlan/AgentPlan.d.ts

@@ -0,0 +1,41 @@
+import { default as React } from 'react';
+export type AgentPlanStepStatus = 'pending' | 'active' | 'completed' | 'failed';
+export interface AgentPlanStep {
+    /** What this step does, in one line. */
+    label: string;
+    /** Where the step has got to. Defaults to `pending`. */
+    status?: AgentPlanStepStatus;
+    /** Optional supporting line under the label, e.g. the file it touched. */
+    detail?: string;
+}
+/** Props owned by AgentPlan itself — everything else falls through to the root element. */
+type AgentPlanOwnProps = {
+    /** The plan, in order. Step status drives each row's indicator and colour. */
+    steps: AgentPlanStep[];
+    /**
+     * Header text. Left unset, it is computed from the steps —
+     * "3 steps left", or "All steps complete" once everything is done.
+     */
+    title?: string;
+    /** Open state for controlled use. Pair with `onOpenChange`. */
+    open?: boolean;
+    /** Open state for uncontrolled use. */
+    defaultOpen?: boolean;
+    /** Fires whenever the step list opens or closes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Additional CSS classes */
+    className?: string;
+};
+export interface AgentPlanProps extends AgentPlanOwnProps, Omit<React.ComponentPropsWithoutRef<'div'>, keyof AgentPlanOwnProps> {
+}
+/**
+ * AgentPlan shows the steps an agent intends to take and where it has got to:
+ * a collapsible checklist with one row per step, a live progress readout in
+ * the header, and completed work ticked off as the run advances.
+ *
+ * It complements the other agent primitives — AgentStatus says what is
+ * happening right now, ToolCall records one action, AgentPlan holds the
+ * whole task.
+ */
+export declare const AgentPlan: React.ForwardRefExoticComponent<AgentPlanProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/components/AgentPlan/AgentPlan.js

@@ -0,0 +1,100 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import React, { useId, useState, useCallback } from "react";
+import { Spinner } from "../Spinner/Spinner.js";
+import "./AgentPlan.css";
+import "../../fonts/material-symbols.css";
+const STEP_ICONS = {
+  pending: "circle",
+  completed: "check_circle",
+  failed: "error"
+};
+const STEP_STATUS_TEXT = {
+  pending: "Not started",
+  active: "In progress",
+  completed: "Completed",
+  failed: "Failed"
+};
+const AgentPlan = React.forwardRef(
+  ({
+    steps,
+    title,
+    open,
+    defaultOpen = true,
+    onOpenChange,
+    className = "",
+    ...rest
+  }, ref) => {
+    const baseClass = "ds-agent-plan";
+    const id = useId();
+    const panelId = `${id}-panel`;
+    const triggerId = `${id}-trigger`;
+    const isControlled = open !== void 0;
+    const [uncontrolledOpen, setUncontrolledOpen] = useState(defaultOpen);
+    const isOpen = isControlled ? open : uncontrolledOpen;
+    const toggle = useCallback(() => {
+      const next = !isOpen;
+      if (!isControlled) setUncontrolledOpen(next);
+      onOpenChange?.(next);
+    }, [isOpen, isControlled, onOpenChange]);
+    const total = steps.length;
+    const completed = steps.filter((step) => step.status === "completed").length;
+    const remaining = total - completed;
+    const resolvedTitle = title ?? (total > 0 && remaining === 0 ? "All steps complete" : `${remaining} step${remaining === 1 ? "" : "s"} left`);
+    const classes = [baseClass, isOpen ? `${baseClass}--open` : "", className].filter(Boolean).join(" ");
+    return /* @__PURE__ */ jsxs("div", { ...rest, ref, className: classes, children: [
+      /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          id: triggerId,
+          className: `${baseClass}__header`,
+          "aria-expanded": isOpen,
+          "aria-controls": panelId,
+          onClick: toggle,
+          children: [
+            /* @__PURE__ */ jsx("span", { className: `${baseClass}__title`, children: resolvedTitle }),
+            total > 0 && /* @__PURE__ */ jsxs("span", { className: `${baseClass}__count`, children: [
+              completed,
+              "/",
+              total
+            ] }),
+            /* @__PURE__ */ jsx("span", { className: `${baseClass}__chevron material-symbols-rounded`, "aria-hidden": "true", children: "expand_more" })
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: `${baseClass}__panel`,
+          id: panelId,
+          role: "region",
+          "aria-labelledby": triggerId,
+          children: /* @__PURE__ */ jsx("div", { className: `${baseClass}__content`, children: /* @__PURE__ */ jsx("ol", { className: `${baseClass}__steps`, children: steps.map((step, index) => {
+            const status = step.status ?? "pending";
+            return /* @__PURE__ */ jsxs(
+              "li",
+              {
+                className: `${baseClass}__step ${baseClass}__step--${status}`,
+                "aria-current": status === "active" ? "step" : void 0,
+                children: [
+                  /* @__PURE__ */ jsx("span", { className: `${baseClass}__indicator`, "aria-hidden": "true", children: status === "active" ? /* @__PURE__ */ jsx(Spinner, { size: "sm", variant: "inherit" }) : /* @__PURE__ */ jsx("span", { className: "material-symbols-rounded", children: STEP_ICONS[status] }) }),
+                  /* @__PURE__ */ jsxs("span", { className: `${baseClass}__step-body`, children: [
+                    /* @__PURE__ */ jsx("span", { className: `${baseClass}__label`, children: step.label }),
+                    step.detail && /* @__PURE__ */ jsx("span", { className: `${baseClass}__detail`, children: step.detail })
+                  ] }),
+                  /* @__PURE__ */ jsx("span", { className: `${baseClass}__sr`, children: STEP_STATUS_TEXT[status] })
+                ]
+              },
+              index
+            );
+          }) }) })
+        }
+      )
+    ] });
+  }
+);
+AgentPlan.displayName = "AgentPlan";
+export {
+  AgentPlan
+};