@vllnt/ui 0.2.1-canary.e1bc2b3 → 0.2.1-canary.e62eaf0

package/CHANGELOG.md

@@ -4,6 +4,42 @@ All notable changes to `@vllnt/ui` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+> Target version: **`0.3.0`** — canary only; not yet published. See [ROADMAP.md](../../ROADMAP.md) for shipping criteria.
+
+### Added
+
+- **Hooks + utility primitives** — `CopyButton` (+ `useCopyToClipboard` hook), `Banner` + `BannerAction`, `Kbd`, `EmptyState`, `DocumentSiblingNav`.
+- **Pricing + identity cards** — `PricingTable` + `PricingPlan`, `HistoricalFigureCard`, `CivilizationCard` (+ `CivilizationComparison`).
+- **Newsletter** — `NewsletterSignup` (state-machine driven submit flow).
+- **AI compound families** — `ModelComparison` (+ `Column`, `Meta`, `Vote`), `PromptTemplates`, `AgentActivity`, `AISidebar`, `AIArtifact`.
+- **Era / financial** — `EraComparison`, `TransactionList`.
+- **Forms** — `Form`, `MultiSelect`, `SegmentedControl`, `TagsInput`, `AutoReload`.
+- **Educational** — `KnowledgeCheck` (inline question runner).
+- **Charts + timelines** — `GanttChart`, `ParallelTimeline`, `Timeline` + `TimelineItem`, `HistoricTimeline`, `InteractiveTimeline`, `ChronologicalTimeline`, `TreeView`.
+- **Document + reading** — `PrimarySourceViewer` compound family.
+- **Maps + geography** — `Map2D`, `ChoroplethMap`, `RouteMap`, `HeatMapOverlay`, `GeographyQuizMap`, `MapTimeline`, `StoryMap`, `Globe3D`.
+- **Canvas foundation** — `CanvasShell`, `CanvasView`, `InfinitePlane`, `ViewportBookmarks`, `WorldBreadcrumbs`, `TopBar`, `LeftRail`, `RightDock`, `ZoomHud`, `MiniMapPanel`, `WorkspaceSwitcher`.
+- **Canvas selection + manipulation** — `SelectionHalo`, `SnapGuides`, `FloatingToolbar`, `MultiSelectLasso`, `FollowMode`, `HandoffBeacon`.
+- **Canvas spatial objects** — `ObjectCard`, `ObjectHandle`, `AnchorPort`, `ConnectorEdge`, `EdgeLabel`, `GroupHull`.
+- **Canvas collaboration primitives** — `LiveCursor`, `CommentPin`, `PresenceSyncIndicator`, `PresenceStack`, `SelectionPresence`, `ThreadBubble`.
+- **Inspector + dock panels** — `PropertySection`, `ObjectInspector`, `RelationshipInspector`, `RuntimeOverviewPanel`, `RoutingAssignmentPanel`, `PolicyDeliveryPanel`.
+- **Runtime overlays** — `AlertPulse`, `ThresholdRing`, `StickyMetric`, `HeatOverlay`, `StateBadgeOverlay`, `MetricCluster`, `JarvisDock`, `ContextLens`.
+- **Time navigation** — `TimelineScrubber`, `PlaybackGhost`, `BottomActivityStrip`, `RunTimeline`.
+- Total component count: **225** (up from 140).
+
+- **A11y heading-level override** — every title-bearing component (`ProfileSection`, `FAQ`, `Slideshow`, `WorldClockBar`, `TableOfContentsPanel`, `TableOfContents`, `KeyboardShortcutsHelp`, `Watchlist`, `OrderBook`, `HorizontalScrollRow`, `MarketTreemap`, `ActivityHeatmap`, `Glossary`, `StatusBoard`, `CodePlayground`, `Comparison`, `Quiz`, `Exercise`, `ShareSection`, `CompletionDialog`, `Checklist`, `LearningObjectives`, `CandlestickChart`, `StepByStep`) accepts an `as` prop (`"h1"`–`"h6"`); multi-title components (`ContentIntro`, `TutorialComplete`) expose `titleAs` + `tocLabelAs` / `sectionLabelAs`. Defaults preserve existing heading tags. `HeadingTag` is re-exported from `@vllnt/ui`.
+
+### Changed
+
+- Registry installs use a **hybrid CLI strategy** — leaf component source is inlined, sibling registry items resolve via `@vllnt/ui` to keep installs minimal and dedupe shared primitives.
+
+### Notes
+
+- `ROADMAP.md` added at repo root tracking 50 open issues across 8 phases gating the `0.3.0` cut.
+- `0.3.0` requires the codebase-health gate (`react-doctor` CI + 0 errors), the agent-first surface (`/llms.txt`, `/mcp`, sitemap, JSON-LD), and the rebuilt landing page before shipping.
+
 ## [0.2.1] - 2026-04-21
 
 ### Fixed

package/dist/components/accordion/accordion.js

@@ -104,7 +104,7 @@ function AccordionTrigger({
           "span",
           {
             className: cn(
-              "h-4 w-4 flex-shrink-0 transition-transform duration-200",
+              "size-4 flex-shrink-0 transition-transform duration-200",
               isOpen && "rotate-180"
             ),
             children: icon
@@ -113,7 +113,7 @@ function AccordionTrigger({
           "svg",
           {
             className: cn(
-              "h-4 w-4 flex-shrink-0 transition-transform duration-200",
+              "size-4 flex-shrink-0 transition-transform duration-200",
               isOpen && "rotate-180"
             ),
             fill: "none",

package/dist/components/activity-heatmap/activity-heatmap.js

@@ -72,19 +72,21 @@ function getGridData(data, endDate, weeks) {
     });
   });
 }
+const MONTH_LABEL_FORMATTER = new Intl.DateTimeFormat("en-US", {
+  month: "short",
+  timeZone: "UTC"
+});
+const TOOLTIP_DATE_FORMATTER = new Intl.DateTimeFormat("en-US", {
+  day: "numeric",
+  month: "short",
+  timeZone: "UTC",
+  year: "numeric"
+});
 function formatMonthLabel(date) {
-  return new Intl.DateTimeFormat("en-US", {
-    month: "short",
-    timeZone: "UTC"
-  }).format(date);
+  return MONTH_LABEL_FORMATTER.format(date);
 }
 function formatTooltip(date, count) {
-  const formattedDate = new Intl.DateTimeFormat("en-US", {
-    day: "numeric",
-    month: "short",
-    timeZone: "UTC",
-    year: "numeric"
-  }).format(date);
+  const formattedDate = TOOLTIP_DATE_FORMATTER.format(date);
   return `${count} activity ${count === 1 ? "event" : "events"} on ${formattedDate}`;
 }
 function HeatmapGrid({
@@ -127,15 +129,15 @@ function HeatmapGrid({
     ),
     /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-2 text-xs text-muted-foreground", children: [
       /* @__PURE__ */ jsx("span", { children: "Less" }),
-      LEVEL_CLASS_NAMES.map((className, index) => /* @__PURE__ */ jsx(
+      LEVEL_CLASS_NAMES.map((className) => /* @__PURE__ */ jsx(
         "span",
         {
           className: cn(
-            "h-3 w-3 rounded-[3px] border border-border/40",
+            "size-3 rounded-[3px] border border-border/40",
             className
           )
         },
-        `legend-${index}`
+        `legend-${className}`
       )),
       /* @__PURE__ */ jsx("span", { children: "More" })
     ] })
@@ -143,6 +145,7 @@ function HeatmapGrid({
 }
 const ActivityHeatmap = React.forwardRef(
   ({
+    as: Heading = "h2",
     className,
     data,
     description,
@@ -155,7 +158,7 @@ const ActivityHeatmap = React.forwardRef(
     const gridData = getGridData(data, normalizedEndDate, weeks);
     return /* @__PURE__ */ jsxs("div", { className: cn("space-y-4", className), ref, ...props, children: [
       /* @__PURE__ */ jsxs("div", { className: "space-y-1", children: [
-        /* @__PURE__ */ jsx("h2", { className: "text-lg font-semibold tracking-tight", children: title }),
+        /* @__PURE__ */ jsx(Heading, { className: "text-lg font-semibold tracking-tight", children: title }),
         description ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: description }) : null
       ] }),
       /* @__PURE__ */ jsx("div", { className: "overflow-x-auto rounded-lg border bg-card p-4 shadow-sm", children: /* @__PURE__ */ jsx(HeatmapGrid, { gridData, weeks }) })

package/dist/components/activity-log/activity-log.js

@@ -82,7 +82,7 @@ function PaginationControls({
         size: "sm",
         variant: "outline",
         children: [
-          /* @__PURE__ */ jsx(ChevronLeft, { className: "h-4 w-4" }),
+          /* @__PURE__ */ jsx(ChevronLeft, { className: "size-4" }),
           "Previous"
         ]
       }
@@ -111,7 +111,7 @@ function PaginationControls({
         variant: "outline",
         children: [
           "Next",
-          /* @__PURE__ */ jsx(ChevronRight, { className: "h-4 w-4" })
+          /* @__PURE__ */ jsx(ChevronRight, { className: "size-4" })
         ]
       }
     )
@@ -132,18 +132,18 @@ function ActivityRow({ item }) {
       {
         "aria-hidden": "true",
         className: cn(
-          "absolute left-4 top-3 h-3 w-3 rounded-full ring-4 ring-background",
+          "absolute left-4 top-3 size-3 rounded-full ring-4 ring-background",
           palette.markerClassName
         )
       }
     ),
     /* @__PURE__ */ jsx("div", { className: "rounded-lg border bg-background/70 p-4", children: /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-start gap-3", children: [
-        /* @__PURE__ */ jsx(Avatar, { className: "h-9 w-9 border bg-muted", children: /* @__PURE__ */ jsx(AvatarFallback, { children: getInitials(item.actor) }) }),
+        /* @__PURE__ */ jsx(Avatar, { className: "size-9 border bg-muted", children: /* @__PURE__ */ jsx(AvatarFallback, { children: getInitials(item.actor) }) }),
         /* @__PURE__ */ jsxs("div", { className: "min-w-0 space-y-1", children: [
           /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
             /* @__PURE__ */ jsx("span", { className: "font-medium text-foreground", children: item.actor }),
-            /* @__PURE__ */ jsx(ArrowRight, { className: "h-3.5 w-3.5 text-muted-foreground" }),
+            /* @__PURE__ */ jsx(ArrowRight, { className: "size-3.5 text-muted-foreground" }),
             /* @__PURE__ */ jsx("span", { className: "text-sm text-muted-foreground", children: item.action }),
             item.target ? /* @__PURE__ */ jsx("span", { className: "truncate text-sm font-medium text-foreground", children: item.target }) : null
           ] }),

package/dist/components/agent-activity/agent-activity.js

@@ -0,0 +1,311 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import {
+  createContext,
+  forwardRef,
+  useCallback,
+  useContext,
+  useId,
+  useMemo,
+  useState
+} from "react";
+import {
+  AlertTriangle,
+  CheckCircle2,
+  ChevronDown,
+  Circle,
+  Loader2,
+  MinusCircle
+} from "lucide-react";
+import { cn } from "../../lib/utils";
+const STATUS_CLASSES = {
+  completed: {
+    iconClass: "text-emerald-600 dark:text-emerald-400",
+    ringClass: "ring-emerald-500/30",
+    rowClass: "border-border bg-background"
+  },
+  error: {
+    iconClass: "text-destructive",
+    ringClass: "ring-destructive/40",
+    rowClass: "border-destructive/40 bg-destructive/5"
+  },
+  pending: {
+    iconClass: "text-muted-foreground",
+    ringClass: "ring-border",
+    rowClass: "border-border bg-muted/20 text-muted-foreground"
+  },
+  running: {
+    iconClass: "text-primary",
+    ringClass: "ring-primary/30",
+    rowClass: "border-primary/30 bg-primary/5"
+  },
+  skipped: {
+    iconClass: "text-muted-foreground/60",
+    ringClass: "ring-border",
+    rowClass: "border-border bg-background text-muted-foreground/80"
+  }
+};
+const DEFAULT_STATUS_ICON = {
+  completed: /* @__PURE__ */ jsx(CheckCircle2, { "aria-hidden": "true", className: "size-4" }),
+  error: /* @__PURE__ */ jsx(AlertTriangle, { "aria-hidden": "true", className: "size-4" }),
+  pending: /* @__PURE__ */ jsx(Circle, { "aria-hidden": "true", className: "size-4" }),
+  running: /* @__PURE__ */ jsx(Loader2, { "aria-hidden": "true", className: "size-4 animate-spin" }),
+  skipped: /* @__PURE__ */ jsx(MinusCircle, { "aria-hidden": "true", className: "size-4" })
+};
+const StepContext = createContext({ status: "pending" });
+const DEFAULT_LABELS = {
+  activity: "Activity",
+  collapse: "Hide details",
+  elapsed: "Elapsed",
+  expand: "Show details"
+};
+const ACTIVITY_LIVE_REGION_ROLE = {
+  completed: "status",
+  error: "status",
+  idle: "status",
+  running: "log"
+};
+const AgentActivity = forwardRef(
+  (props, ref) => {
+    const {
+      children,
+      className,
+      elapsed,
+      labels,
+      status = "idle",
+      ...rest
+    } = props;
+    const resolvedLabels = { ...DEFAULT_LABELS, ...labels };
+    return /* @__PURE__ */ jsxs(
+      "section",
+      {
+        "aria-live": status === "running" ? "polite" : "off",
+        className: cn(
+          "flex flex-col gap-3 rounded-2xl border bg-background p-4",
+          className
+        ),
+        "data-status": status,
+        ref,
+        role: ACTIVITY_LIVE_REGION_ROLE[status],
+        ...rest,
+        children: [
+          /* @__PURE__ */ jsxs("header", { className: "flex items-center justify-between gap-3", children: [
+            /* @__PURE__ */ jsx("h3", { className: "text-sm font-semibold tracking-tight text-foreground", children: resolvedLabels.activity }),
+            elapsed ? /* @__PURE__ */ jsx(
+              "span",
+              {
+                "aria-label": resolvedLabels.elapsed,
+                className: "text-xs font-mono text-muted-foreground",
+                children: elapsed
+              }
+            ) : null
+          ] }),
+          /* @__PURE__ */ jsx("ol", { className: "flex flex-col gap-2", children })
+        ]
+      }
+    );
+  }
+);
+AgentActivity.displayName = "AgentActivity";
+function getDisplayName(value) {
+  if (value !== null && (typeof value === "object" || typeof value === "function") && "displayName" in value && typeof value.displayName === "string") {
+    return value.displayName;
+  }
+  return void 0;
+}
+function isAgentStepDetailElement(child) {
+  if (child === null || typeof child !== "object") return false;
+  if (!("type" in child)) return false;
+  return getDisplayName(child.type) === "AgentStepDetail";
+}
+function splitChildren(children) {
+  const items = Array.isArray(children) ? children : [children];
+  return items.reduce(
+    (split, child) => {
+      if (isAgentStepDetailElement(child)) {
+        split.body.push(child);
+      } else {
+        split.header.push(child);
+      }
+      return split;
+    },
+    { body: [], header: [] }
+  );
+}
+function StepRow({
+  detailsId,
+  hasDetails,
+  header,
+  icon,
+  iconClass,
+  labels,
+  onToggle,
+  open
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-3 px-3 py-2", children: [
+    /* @__PURE__ */ jsx(
+      "span",
+      {
+        "aria-hidden": "true",
+        className: cn(
+          "mt-0.5 inline-flex size-5 shrink-0 items-center justify-center",
+          iconClass
+        ),
+        children: icon
+      }
+    ),
+    /* @__PURE__ */ jsx("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: header }),
+    hasDetails ? /* @__PURE__ */ jsx(
+      "button",
+      {
+        "aria-controls": detailsId,
+        "aria-expanded": open,
+        "aria-label": open ? labels.collapse : labels.expand,
+        className: "ml-auto inline-flex size-6 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-foreground/10 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+        onClick: onToggle,
+        type: "button",
+        children: /* @__PURE__ */ jsx(
+          ChevronDown,
+          {
+            "aria-hidden": "true",
+            className: cn(
+              "size-4 transition-transform",
+              open ? "rotate-180" : "rotate-0"
+            )
+          }
+        )
+      }
+    ) : null
+  ] });
+}
+const AgentStep = forwardRef(
+  (props, ref) => {
+    const {
+      children,
+      className,
+      defaultOpen = true,
+      icon,
+      status,
+      ...rest
+    } = props;
+    const split = useMemo(() => splitChildren(children), [children]);
+    const palette = STATUS_CLASSES[status];
+    const hasDetails = split.body.length > 0;
+    const [open, setOpen] = useState(defaultOpen);
+    const detailsId = useId();
+    const handleToggle = useCallback(() => {
+      setOpen((value) => !value);
+    }, []);
+    const contextValue = useMemo(
+      () => ({ status }),
+      [status]
+    );
+    const resolvedIcon = icon ?? DEFAULT_STATUS_ICON[status];
+    return /* @__PURE__ */ jsx(
+      "li",
+      {
+        className: cn(
+          "rounded-xl border ring-1",
+          palette.rowClass,
+          palette.ringClass,
+          className
+        ),
+        "data-status": status,
+        ref,
+        ...rest,
+        children: /* @__PURE__ */ jsxs(StepContext.Provider, { value: contextValue, children: [
+          /* @__PURE__ */ jsx(
+            StepRow,
+            {
+              detailsId,
+              hasDetails,
+              header: split.header,
+              icon: resolvedIcon,
+              iconClass: palette.iconClass,
+              labels: DEFAULT_LABELS,
+              onToggle: handleToggle,
+              open
+            }
+          ),
+          hasDetails && open ? /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: "border-t border-border/60 px-3 py-2 text-xs",
+              id: detailsId,
+              children: /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-2 pl-8", children: split.body })
+            }
+          ) : null
+        ] })
+      }
+    );
+  }
+);
+AgentStep.displayName = "AgentStep";
+const AgentStepTitle = forwardRef(({ className, ...rest }, ref) => /* @__PURE__ */ jsx(
+  "p",
+  {
+    className: cn(
+      "text-sm font-medium leading-tight text-foreground",
+      className
+    ),
+    ref,
+    ...rest
+  }
+));
+AgentStepTitle.displayName = "AgentStepTitle";
+const AgentStepDuration = forwardRef(({ className, ...rest }, ref) => /* @__PURE__ */ jsx(
+  "span",
+  {
+    className: cn("font-mono text-xs text-muted-foreground", className),
+    ref,
+    ...rest
+  }
+));
+AgentStepDuration.displayName = "AgentStepDuration";
+const AgentStepProgress = forwardRef(({ className, label = "Step progress", value, ...rest }, ref) => {
+  const clamped = Math.max(0, Math.min(100, value));
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      "aria-label": label,
+      "aria-valuemax": 100,
+      "aria-valuemin": 0,
+      "aria-valuenow": clamped,
+      className: cn("h-1.5 w-full rounded-full bg-muted", className),
+      ref,
+      role: "progressbar",
+      ...rest,
+      children: /* @__PURE__ */ jsx(
+        "span",
+        {
+          className: "block h-full rounded-full bg-primary transition-[width]",
+          style: { width: `${clamped.toString()}%` }
+        }
+      )
+    }
+  );
+});
+AgentStepProgress.displayName = "AgentStepProgress";
+const AgentStepDetail = forwardRef(
+  ({ className, ...rest }, ref) => /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn("text-xs text-muted-foreground", className),
+      ref,
+      ...rest
+    }
+  )
+);
+AgentStepDetail.displayName = "AgentStepDetail";
+function useAgentStepStatus() {
+  return useContext(StepContext).status;
+}
+export {
+  AgentActivity,
+  AgentStep,
+  AgentStepDetail,
+  AgentStepDuration,
+  AgentStepProgress,
+  AgentStepTitle,
+  useAgentStepStatus
+};

package/dist/components/agent-activity/index.js

@@ -0,0 +1,18 @@
+import {
+  AgentActivity,
+  AgentStep,
+  AgentStepDetail,
+  AgentStepDuration,
+  AgentStepProgress,
+  AgentStepTitle,
+  useAgentStepStatus
+} from "./agent-activity";
+export {
+  AgentActivity,
+  AgentStep,
+  AgentStepDetail,
+  AgentStepDuration,
+  AgentStepProgress,
+  AgentStepTitle,
+  useAgentStepStatus
+};