@robr0/design-system 0.7.0 → 0.9.0

package/README.md

@@ -18,7 +18,7 @@ The **live site** is the portfolio built on the design system. **Storybook** is
 | Part | Description |
 |---|---|
 | **Portfolio website** (`/website`) | Next.js app with case studies, work history, writing, and about pages, all built exclusively with the design system components below. **[Live site →](https://robertritacca.com/)** |
-| **Design system** (`/src`) | <!-- component-count -->79<!-- /component-count --> React components, a three-tier token architecture, dark mode, a WebGL2 ambient background that themes itself from your tokens, and a full documentation site. Built to production standards. **[Storybook →](https://design-system-iota-one.vercel.app/?path=/docs/robr0-ds--docs)** |
+| **Design system** (`/src`) | <!-- component-count -->101<!-- /component-count --> React components, a three-tier token architecture, dark mode, a WebGL2 ambient background that themes itself from your tokens, and a full documentation site. Built to production standards. **[Storybook →](https://design-system-iota-one.vercel.app/?path=/docs/robr0-ds--docs)** |
 | **AI layer** (`ai` components in `/src`, chat in `/website`, `/evals`) | A site-wide chat that answers questions about the work: built from the library's own `ai` components, grounded in a corpus generated from the site's published content, and scored by a golden-set eval. |
 
 ---
@@ -28,7 +28,7 @@ The **live site** is the portfolio built on the design system. **Storybook** is
 ### Components
 
 <!-- component-list:start -->
-Accordion · Agent status · AI button · Alert · Alert dialog · App layout · App sidebar · Avatar · Badge · Breadcrumb · Button · Button group · Card · Carousel · Chart · Chat header · Chat marker · Chat message · Chat thread · Checkbox · Chip · Circular button · Code block · Colour picker · Combobox · Command palette · Composer · Contact card · Context menu · Contribution graph · Date input · Date picker · Dialog · Divider · Document chip · Drawer · Dropdown · Dropdown menu · Empty state · Entity card · Field · Figure · File input · Input · Instructions · Interrupt card · Kbd · Link list · Message actions · Message card · Navigation · Nav list · Pagination · Popover · Progress bar · Prompt suggestions · Prose · Quote · Radio button · Reasoning · Section title · Segmented control · Selection card · Shader field · Skeleton · Slider · Source chip · Spinner · Stat · Swatch · Table · Tabs · Textarea · Timeline · Toast · Toggle group · Toggle switch · Tool call · Tooltip
+Accordion · Agent plan · Agent status · AI button · Alert · Alert dialog · Anchor nav · App layout · App sidebar · Area chart · Avatar · Badge · Bar chart · Breadcrumb · Button · Button group · Card · Carousel · Chat header · Chat marker · Chat message · Chat thread · Checkbox · Chip · Circular button · Code block · Code diff · Colour picker · Combobox · Command palette · Composer · Contact card · Context menu · Contribution graph · Data table · Date input · Date picker · Dialog · Divider · Document chip · Drawer · Dropdown · Dropdown menu · Empty state · Entity card · Event calendar · Field · Figure · File input · Input · Instructions · Interrupt card · Kbd · Line chart · Link list · Message actions · Message card · Model picker · Nav · Nav list · Notification centre · Number input · Pagination · Pie chart · Pin input · Popover · Progress bar · Prompt suggestions · Prose · Quote · Radar chart · Radial chart · Radio button · Reasoning · Scatter chart · Section title · Segmented control · Selection card · Shader field · Skeleton · Slider · Source chip · Sparkline · Spinner · Stacked bar chart · Stat · Stepper · Swatch · Table · Tabs · Tag input · Textarea · Time picker · Timeline · Toast · Toggle group · Toggle switch · Tool call · Tooltip · Tree view · Treemap
 <!-- component-list:end -->
 
 ### Ambient background
@@ -46,7 +46,7 @@ const [status, setStatus] = useState<ShaderFieldStatus>('pending');
 </div>
 ```
 
-Seven parameters describe the look, and a composition is a table of token names with positions and drift periods, so a negative weight cuts a shadow through the field instead of adding light to it.
+Eight parameters describe the look, and a composition is a table of token names with positions and drift periods, so a negative weight cuts a shadow through the field instead of adding light to it.
 
 It asks two things of you, both deliberate. It fills a positioned ancestor you provide, because where a background sits is a layout decision rather than a rendering one. And it never decides what to paint instead of itself: it reports `pending`, `active` or `unavailable`, and one fallback covers every way it can fail (no WebGL2, a blocked or lost GPU context, a renderer that stalls before its first frame, or `enabled={false}` as a kill switch). `pending` is the state worth handling. Paint neither layer while the context comes up, or the swap a frame later reads as two backgrounds loading in sequence.
 
@@ -71,7 +71,7 @@ import '@robr0/design-system/tokens/tokens.css';
 import { Button, Card, Badge } from '@robr0/design-system';
 ```
 
-Deep imports work too (`@robr0/design-system/components/Button/Button`). Chart components live behind a separate entry so the optional `recharts` peer dependency is only needed if you use them:
+Deep imports work too (`@robr0/design-system/components/Button/Button`). The Recharts-backed charts live behind a separate entry so the optional `recharts` peer dependency is only needed if you use them; Sparkline and ContributionGraph are dependency-free and export from the main barrel:
 
 ```tsx
 import { BarChart, LineChart } from '@robr0/design-system/charts';

package/components/Accordion/Accordion.js

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

package/components/AgentPlan/AgentPlan.css

@@ -0,0 +1,231 @@
+/* ============================================
+   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-xs) solid var(--color-bg-container-border);
+  border-radius: var(--radius-md);
+  overflow: hidden;
+}
+
+/* ============================================
+   HEADER
+   ============================================ */
+
+.ds-agent-plan__header {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-sm);
+  width: 100%;
+  padding: var(--padding-sm) var(--padding-md);
+  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-em-family);
+  font-size: var(--font-paragraph-sm-em-size);
+  font-weight: var(--font-paragraph-sm-em-weight);
+  line-height: var(--font-paragraph-sm-em-line-height);
+  letter-spacing: var(--font-paragraph-sm-em-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-sm);
+
+  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-xs) solid var(--color-divider);
+}
+
+/* ============================================
+   STEPS
+   ============================================ */
+
+.ds-agent-plan__steps {
+  display: flex;
+  flex-direction: column;
+  margin: 0;
+  padding: var(--padding-sm-md) var(--padding-md);
+  list-style: none;
+}
+
+.ds-agent-plan__step {
+  position: relative;
+  display: flex;
+  align-items: flex-start;
+  gap: var(--gap-sm);
+  padding: var(--padding-xxs) 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-xxs) + var(--icon-size-sm));
+  bottom: calc(-1 * var(--padding-xxs));
+  left: calc(var(--icon-size-sm) / 2);
+  width: var(--border-xs);
+  background-color: var(--color-divider);
+}
+
+.ds-agent-plan__indicator {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  color: var(--color-icon-secondary);
+}
+
+.ds-agent-plan__indicator .material-symbols-rounded {
+  --icon-size: var(--icon-size-sm);
+}
+
+.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-sm) - 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--completed .ds-agent-plan__indicator {
+  color: var(--color-status-positive-text);
+}
+
+.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-text);
+}
+
+.ds-agent-plan__step--active .ds-agent-plan__label {
+  font-family: var(--font-paragraph-sm-em-family);
+  font-weight: var(--font-paragraph-sm-em-weight);
+  letter-spacing: var(--font-paragraph-sm-em-letter-spacing);
+}
+
+.ds-agent-plan__step--failed .ds-agent-plan__indicator {
+  color: var(--color-status-error-text);
+}
+
+.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;
+}

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
+};

package/components/AgentStatus/AgentStatus.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx, Fragment } from "react/jsx-runtime";
 import React, { useState, useRef, useEffect } from "react";
 import "./AgentStatus.css";

package/components/AiButton/AiButton.js

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

package/components/AlertDialog/AlertDialog.js

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

package/components/AnchorNav/AnchorNav.css

@@ -0,0 +1,63 @@
+/* ============================================
+   ANCHOR NAV
+   "On this page" list of anchor links with a
+   position indicator riding the left rail.
+   ============================================ */
+.ds-anchor-nav {
+  font-family: var(--font-family-primary);
+}
+
+.ds-anchor-nav__header {
+  display: flex;
+  align-items: center;
+  gap: var(--gap-xs);
+  margin: 0 0 var(--gap-sm);
+  font-size: var(--font-paragraph-em-size);
+  font-weight: var(--font-paragraph-em-weight);
+  line-height: var(--font-paragraph-em-line-height);
+  color: var(--color-text-primary);
+}
+
+.ds-anchor-nav__icon {
+  --icon-size: var(--icon-size-sm);
+  color: var(--color-icon-primary);
+}
+
+.ds-anchor-nav__list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  border-left: var(--border-xs) solid var(--color-divider);
+}
+
+.ds-anchor-nav__link {
+  display: block;
+  padding: var(--padding-xs) 0 var(--padding-xs) var(--padding-md);
+  /* Sits over the list rail; turns into the indicator when active */
+  margin-left: calc(var(--border-xs) * -1);
+  border-left: var(--border-md) solid transparent;
+  font-size: var(--font-paragraph-size);
+  font-weight: var(--font-paragraph-weight);
+  line-height: var(--font-paragraph-line-height);
+  color: var(--color-text-tertiary);
+  text-decoration: none;
+  transition:
+    color var(--motion-duration-fast) var(--motion-ease-standard),
+    border-color var(--motion-duration-fast) var(--motion-ease-standard);
+}
+
+.ds-anchor-nav__link:hover {
+  color: var(--color-text-primary);
+}
+
+.ds-anchor-nav__link:focus-visible {
+  outline: 2px solid var(--color-action-primary-bg);
+  outline-offset: -2px;
+  border-radius: var(--radius-xxs);
+}
+
+.ds-anchor-nav__link--active {
+  color: var(--color-text-primary);
+  font-weight: var(--font-paragraph-em-weight);
+  border-left-color: var(--color-text-primary);
+}

package/components/AnchorNav/AnchorNav.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+export interface AnchorNavItem {
+    /** The id of the element the item jumps to (rendered as `href="#id"`) */
+    id: string;
+    /** Link text */
+    label: string;
+}
+type AnchorNavOwnProps = {
+    /** The on-page sections to list, in document order */
+    items: AnchorNavItem[];
+    /** Header text above the list; pass an empty string to render no header */
+    title?: string;
+    /** Material Symbols icon name beside the header; pass an empty string for none */
+    icon?: string;
+    /** Controlled active item id — set it to drive the highlight yourself and skip scroll tracking */
+    activeId?: string;
+    /** Fires when the tracked (or clicked) active item changes */
+    onActiveChange?: (id: string) => void;
+    /** Distance in px from the viewport top at which a section counts as current, e.g. a sticky header's height */
+    offset?: number;
+};
+export interface AnchorNavProps extends AnchorNavOwnProps, Omit<React.ComponentPropsWithoutRef<'nav'>, keyof AnchorNavOwnProps> {
+}
+/**
+ * An "On this page" list of anchor links that tracks the reader's position.
+ *
+ * Uncontrolled by default: a scroll listener marks the last section whose top
+ * has passed `offset` as current. Pass `activeId` to control the highlight
+ * instead (no listener is attached). The active link carries
+ * `aria-current="location"`.
+ */
+export declare const AnchorNav: React.ForwardRefExoticComponent<AnchorNavProps & React.RefAttributes<HTMLElement>>;
+export {};

package/components/AnchorNav/AnchorNav.js

@@ -0,0 +1,82 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import React, { useRef, useImperativeHandle, useState, useCallback, useEffect } from "react";
+import "./AnchorNav.css";
+const AnchorNav = React.forwardRef(
+  ({
+    items,
+    title = "On this page",
+    icon = "toc",
+    activeId,
+    onActiveChange,
+    offset = 96,
+    className,
+    ...rest
+  }, ref) => {
+    const navRef = useRef(null);
+    useImperativeHandle(ref, () => navRef.current);
+    const isControlled = activeId !== void 0;
+    const [trackedId, setTrackedId] = useState(void 0);
+    const currentId = isControlled ? activeId : trackedId;
+    const onActiveChangeRef = useRef(onActiveChange);
+    onActiveChangeRef.current = onActiveChange;
+    const setActive = useCallback(
+      (id) => {
+        setTrackedId((prev) => {
+          if (id !== void 0 && id !== prev) onActiveChangeRef.current?.(id);
+          return id;
+        });
+      },
+      []
+    );
+    useEffect(() => {
+      if (isControlled || items.length === 0) return;
+      let frame = 0;
+      const measure = () => {
+        frame = 0;
+        let current = items[0]?.id;
+        for (const item of items) {
+          const el = document.getElementById(item.id);
+          if (!el) continue;
+          if (el.getBoundingClientRect().top <= offset + 1) current = item.id;
+        }
+        setActive(current);
+      };
+      const schedule = () => {
+        if (frame === 0) frame = window.requestAnimationFrame(measure);
+      };
+      measure();
+      window.addEventListener("scroll", schedule, { passive: true });
+      window.addEventListener("resize", schedule);
+      return () => {
+        window.removeEventListener("scroll", schedule);
+        window.removeEventListener("resize", schedule);
+        if (frame !== 0) window.cancelAnimationFrame(frame);
+      };
+    }, [isControlled, items, offset, setActive]);
+    const classes = ["ds-anchor-nav", className].filter(Boolean).join(" ");
+    return /* @__PURE__ */ jsxs("nav", { ref: navRef, "aria-label": title || "On this page", className: classes, ...rest, children: [
+      title && /* @__PURE__ */ jsxs("p", { className: "ds-anchor-nav__header", children: [
+        icon && /* @__PURE__ */ jsx("span", { className: "material-symbols-rounded ds-anchor-nav__icon", "aria-hidden": "true", children: icon }),
+        title
+      ] }),
+      /* @__PURE__ */ jsx("ul", { className: "ds-anchor-nav__list", children: items.map((item) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: `#${item.id}`,
+          className: item.id === currentId ? "ds-anchor-nav__link ds-anchor-nav__link--active" : "ds-anchor-nav__link",
+          "aria-current": item.id === currentId ? "location" : void 0,
+          onClick: () => {
+            if (!isControlled) setActive(item.id);
+            else onActiveChangeRef.current?.(item.id);
+          },
+          children: item.label
+        }
+      ) }, item.id)) })
+    ] });
+  }
+);
+AnchorNav.displayName = "AnchorNav";
+export {
+  AnchorNav
+};

package/components/AppLayout/AppLayout.js

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

package/components/AppSidebar/AppSidebar.js

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

package/components/Avatar/Avatar.js

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

package/components/Button/Button.js

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

package/components/Card/Card.js

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

package/components/Carousel/Carousel.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx, Fragment } from "react/jsx-runtime";
 import React, { useState, useRef, useCallback, useEffect } from "react";
 import "./Carousel.css";

package/components/ChatThread/ChatThread.js

@@ -1,3 +1,4 @@
+"use client";
 import { jsxs, jsx } from "react/jsx-runtime";
 import React, { useRef, useEffect, useState, useLayoutEffect } from "react";
 import "./ChatThread.css";

package/components/Checkbox/Checkbox.js

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

package/components/CodeBlock/CodeBlock.js

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