@stigmer/react 0.4.8 → 0.5.1

package/dependency-graph/DependencyTreeNode.js

@@ -0,0 +1,99 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { cn } from "@stigmer/theme";
+const KIND_LABELS = {
+    agent: "Agent",
+    "mcp-server": "MCP",
+    skill: "Skill",
+    "sub-agent": "Sub-Agent",
+};
+/**
+ * Renders a single node in the dependency tree: icon, kind badge,
+ * label, metadata, and (for expandable nodes) an expand/collapse
+ * chevron with nested children.
+ *
+ * Leaf nodes (MCP servers, skills) with a `ref` are clickable —
+ * firing `onNodeClick` for consumer-wired navigation.
+ *
+ * Sub-agent nodes are collapsible containers, and the root agent
+ * node always renders its children expanded. Both recurse using
+ * the same component, keeping the ARIA tree structure correct
+ * (`<li role="treeitem">` wrapping a nested `<ul role="group">`).
+ */
+export function DependencyTreeNode({ node, depth, onNodeClick, defaultExpanded, }) {
+    const hasChildren = node.children.length > 0;
+    const isRoot = node.kind === "agent";
+    const isCollapsible = node.kind === "sub-agent" && hasChildren;
+    const isAlwaysExpanded = isRoot && hasChildren;
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const isNavigable = node.ref != null && onNodeClick != null;
+    const showChildren = isAlwaysExpanded || (isCollapsible && expanded);
+    const handleClick = useCallback(() => {
+        if (isCollapsible) {
+            setExpanded((v) => !v);
+        }
+        else if (isNavigable) {
+            onNodeClick(node);
+        }
+    }, [isCollapsible, isNavigable, onNodeClick, node]);
+    const handleKeyDown = useCallback((e) => {
+        if (!isCollapsible)
+            return;
+        if (e.key === "ArrowRight" && !expanded) {
+            e.preventDefault();
+            setExpanded(true);
+        }
+        else if (e.key === "ArrowLeft" && expanded) {
+            e.preventDefault();
+            setExpanded(false);
+        }
+    }, [isCollapsible, expanded]);
+    const content = (_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [isCollapsible && (_jsx(ChevronIcon, { className: cn("size-3.5 shrink-0 text-muted-foreground transition-transform", expanded && "rotate-90") })), _jsx(NodeIcon, { kind: node.kind, className: "size-4 shrink-0 text-muted-foreground" }), !isRoot && (_jsx("span", { className: cn("shrink-0 rounded px-1.5 py-px text-[10px] font-medium leading-tight", kindBadgeClasses(node.kind)), children: KIND_LABELS[node.kind] })), _jsx("span", { className: "min-w-0 truncate text-sm font-medium text-foreground", children: node.qualifiedLabel ?? node.label }), node.metadata &&
+                Object.entries(node.metadata).map(([key, value]) => (_jsx("span", { className: "shrink-0 text-xs text-muted-foreground", children: value }, key)))] }));
+    const isInteractive = isCollapsible || isNavigable;
+    const isChild = depth > 0;
+    return (_jsxs("li", { role: "treeitem", "aria-expanded": isCollapsible ? expanded : isAlwaysExpanded ? true : undefined, className: cn("list-none", isChild && "relative before:absolute before:left-[-12px] before:top-[14px] before:h-px before:w-3 before:bg-border before:content-['']"), children: [isInteractive ? (_jsx("button", { type: "button", onClick: handleClick, onKeyDown: handleKeyDown, tabIndex: -1, className: cn("flex w-full items-center rounded-md px-2 py-1.5 text-left transition-colors", "hover:bg-accent-hover", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring"), children: content })) : (_jsx("div", { className: "flex items-center px-2 py-1.5", children: content })), node.description && !isRoot && (_jsx("p", { className: cn("px-2 pb-1 text-xs text-muted-foreground", isCollapsible ? "ml-[calc(0.5rem+14px+0.5rem)]" : "ml-2"), children: node.description })), showChildren && (_jsx("ul", { role: "group", className: "relative ml-[11px] border-l border-border pl-3", children: node.children.map((child) => (_jsx(DependencyTreeNode, { node: child, depth: depth + 1, onNodeClick: onNodeClick, defaultExpanded: defaultExpanded }, child.id))) }))] }));
+}
+// ---------------------------------------------------------------------------
+// Kind badge styling — uses --stgm-* tokens, no hardcoded colors
+// ---------------------------------------------------------------------------
+function kindBadgeClasses(kind) {
+    switch (kind) {
+        case "mcp-server":
+            return "bg-[var(--stgm-status-running-subtle)] text-[var(--stgm-status-running)]";
+        case "skill":
+            return "bg-[var(--stgm-status-pending-subtle)] text-[var(--stgm-status-pending)]";
+        case "sub-agent":
+            return "bg-[var(--stgm-status-ready-subtle)] text-[var(--stgm-status-ready)]";
+        case "agent":
+            return "bg-muted text-muted-foreground";
+    }
+}
+// ---------------------------------------------------------------------------
+// Icons — inline SVGs, consistent with AgentDetailView pattern
+// ---------------------------------------------------------------------------
+function NodeIcon({ kind, className, }) {
+    switch (kind) {
+        case "agent":
+        case "sub-agent":
+            return _jsx(AgentIcon, { className: className });
+        case "mcp-server":
+            return _jsx(McpServerIcon, { className: className });
+        case "skill":
+            return _jsx(SkillIcon, { className: className });
+    }
+}
+function AgentIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "3", y: "5", width: "10", height: "8", rx: "1.5" }), _jsx("path", { d: "M6 9h.01M10 9h.01", strokeWidth: "2" }), _jsx("path", { d: "M8 2v3" })] }));
+}
+function McpServerIcon({ className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "2", y: "2", width: "12", height: "5", rx: "1" }), _jsx("rect", { x: "2", y: "9", width: "12", height: "5", rx: "1" }), _jsx("circle", { cx: "5", cy: "4.5", r: "0.75", fill: "currentColor", stroke: "none" }), _jsx("circle", { cx: "5", cy: "11.5", r: "0.75", fill: "currentColor", stroke: "none" })] }));
+}
+function SkillIcon({ className }) {
+    return (_jsx("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M9 1.5 4 9h4l-1 5.5L12 7H8l1-5.5Z" }) }));
+}
+function ChevronIcon({ className }) {
+    return (_jsx("svg", { className: className, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m6 3 5 5-5 5" }) }));
+}
+//# sourceMappingURL=DependencyTreeNode.js.map

package/dependency-graph/DependencyTreeNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyTreeNode.js","sourceRoot":"","sources":["../../src/dependency-graph/DependencyTreeNode.tsx"],"names":[],"mappings":"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"}

package/dependency-graph/index.d.ts

@@ -0,0 +1,4 @@
+export type { NodeKind, DependencyNode, DependencyTree, DependencyGraphProps, UseDependencyGraphOptions, UseDependencyGraphReturn, } from "./types";
+export { useDependencyGraph } from "./useDependencyGraph";
+export { DependencyGraph } from "./DependencyGraph";
+//# sourceMappingURL=index.d.ts.map

package/dependency-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dependency-graph/index.js

@@ -0,0 +1,5 @@
+// Hooks
+export { useDependencyGraph } from "./useDependencyGraph";
+// Components
+export { DependencyGraph } from "./DependencyGraph";
+//# sourceMappingURL=index.js.map

package/dependency-graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dependency-graph/index.ts"],"names":[],"mappings":"AAUA,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dependency-graph/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Resource kind in a dependency tree.
+ *
+ * - `"agent"` — the root agent (always the tree root)
+ * - `"mcp-server"` — an MCP server referenced via `mcpServerUsages` or `mcpAccess`
+ * - `"skill"` — a skill referenced via `skillRefs`
+ * - `"sub-agent"` — an inline sub-agent definition with its own dependencies
+ */
+export type NodeKind = "agent" | "mcp-server" | "skill" | "sub-agent";
+/**
+ * A single node in the agent dependency tree.
+ *
+ * The tree is recursive: sub-agent nodes contain their own children
+ * (MCP servers and skills they access). Edges are implicit in the
+ * parent-child relationship — no separate edge type is needed.
+ *
+ * Nodes are navigable when `ref` is defined (MCP servers, skills).
+ * Sub-agent nodes have no `ref` because they are inline definitions
+ * within the agent spec, not standalone resources.
+ */
+export interface DependencyNode {
+    /**
+     * Deterministic identifier. Format: `{kind}:{slug}` for referenced
+     * resources, `sub-agent:{name}` for sub-agents, or `agent:{slug}`
+     * for the root.
+     */
+    readonly id: string;
+    /** What kind of resource this node represents. */
+    readonly kind: NodeKind;
+    /** Primary display label (slug for resources, name for sub-agents). */
+    readonly label: string;
+    /**
+     * Qualified label shown when the resource belongs to a different org
+     * than the agent (e.g., `"other-org/shared-server"`). Undefined when
+     * the resource is in the same org as the parent agent.
+     */
+    readonly qualifiedLabel?: string;
+    /** Short description (sub-agent description, if available). */
+    readonly description?: string;
+    /**
+     * Key-value metadata displayed as secondary info.
+     * Examples: `{ tools: "3 tools" }`, `{ model: "gpt-4" }`.
+     */
+    readonly metadata?: Readonly<Record<string, string>>;
+    /** Child nodes. Empty array for leaf nodes (MCP servers, skills). */
+    readonly children: readonly DependencyNode[];
+    /**
+     * Navigation reference for clickable nodes. Defined for MCP servers
+     * and skills (standalone resources). Undefined for sub-agents (inline
+     * definitions) and the root agent.
+     */
+    readonly ref?: {
+        readonly org: string;
+        readonly slug: string;
+    };
+}
+/**
+ * Complete dependency tree for an agent, rooted at the agent itself.
+ */
+export interface DependencyTree {
+    /** The agent node with all dependencies as descendants. */
+    readonly root: DependencyNode;
+    /** Total number of nodes in the tree (including root). */
+    readonly nodeCount: number;
+}
+/** Props for {@link DependencyGraph}. */
+export interface DependencyGraphProps {
+    /** The dependency tree to render. */
+    readonly tree: DependencyTree;
+    /**
+     * Called when a navigable node is clicked. The `node.ref` field
+     * contains the `org` and `slug` for routing. Only fired for nodes
+     * where `ref` is defined (MCP servers, skills).
+     */
+    readonly onNodeClick?: (node: DependencyNode) => void;
+    /**
+     * Whether sub-agent subtrees start expanded.
+     * @default true
+     */
+    readonly defaultExpanded?: boolean;
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+/** Options for {@link useDependencyGraph}. */
+export interface UseDependencyGraphOptions {
+    /** Display name of the agent (used as the root node label). */
+    readonly agentName: string;
+    /** Organization slug of the agent (used for cross-org label detection). */
+    readonly agentOrg: string;
+    /**
+     * The agent's spec containing dependency references.
+     * Pass `undefined` while the agent is loading — the hook returns
+     * `null` for `tree` and `true` for `isEmpty`.
+     */
+    readonly spec: {
+        readonly mcpServerUsages: readonly {
+            readonly mcpServerRef?: {
+                readonly org: string;
+                readonly slug: string;
+            };
+            readonly enabledTools: readonly string[];
+            readonly toolApprovalOverrides: readonly unknown[];
+        }[];
+        readonly skillRefs: readonly {
+            readonly org: string;
+            readonly slug: string;
+        }[];
+        readonly subAgents: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly mcpAccess: readonly {
+                readonly mcpServer: string;
+                readonly enabledTools: readonly string[];
+            }[];
+            readonly skillRefs: readonly {
+                readonly org: string;
+                readonly slug: string;
+            }[];
+            readonly modelOverride: string;
+        }[];
+    } | undefined;
+}
+/** Return value of {@link useDependencyGraph}. */
+export interface UseDependencyGraphReturn {
+    /** The computed tree, or `null` when spec is undefined. */
+    readonly tree: DependencyTree | null;
+    /** `true` when the agent has zero dependencies (or spec is undefined). */
+    readonly isEmpty: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dependency-graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/types.ts"],"names":[],"mappings":"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"}

package/dependency-graph/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dependency-graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dependency-graph/types.ts"],"names":[],"mappings":""}

package/dependency-graph/useDependencyGraph.d.ts

@@ -0,0 +1,27 @@
+import type { UseDependencyGraphOptions, UseDependencyGraphReturn } from "./types";
+/**
+ * Pure transformation hook that converts an `AgentSpec` into a
+ * {@link DependencyTree} for rendering.
+ *
+ * No data fetching, no side effects — the tree is computed entirely
+ * from the spec fields already available via {@link useAgent}. The
+ * result is memoized and only recomputes when the spec reference
+ * changes.
+ *
+ * Returns `null` for `tree` when `spec` is `undefined` (loading state).
+ *
+ * @example
+ * ```tsx
+ * const { tree, isEmpty } = useDependencyGraph({
+ *   agentName: agent.metadata.name,
+ *   agentOrg: agent.metadata.org,
+ *   spec: agent.spec,
+ * });
+ *
+ * if (!isEmpty && tree) {
+ *   return <DependencyGraph tree={tree} onNodeClick={handleClick} />;
+ * }
+ * ```
+ */
+export declare function useDependencyGraph({ agentName, agentOrg, spec, }: UseDependencyGraphOptions): UseDependencyGraphReturn;
+//# sourceMappingURL=useDependencyGraph.d.ts.map

package/dependency-graph/useDependencyGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDependencyGraph.d.ts","sourceRoot":"","sources":["../../src/dependency-graph/useDependencyGraph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,EACT,QAAQ,EACR,IAAI,GACL,EAAE,yBAAyB,GAAG,wBAAwB,CAuHtD"}

package/dependency-graph/useDependencyGraph.js

@@ -0,0 +1,129 @@
+"use client";
+import { useMemo } from "react";
+/**
+ * Pure transformation hook that converts an `AgentSpec` into a
+ * {@link DependencyTree} for rendering.
+ *
+ * No data fetching, no side effects — the tree is computed entirely
+ * from the spec fields already available via {@link useAgent}. The
+ * result is memoized and only recomputes when the spec reference
+ * changes.
+ *
+ * Returns `null` for `tree` when `spec` is `undefined` (loading state).
+ *
+ * @example
+ * ```tsx
+ * const { tree, isEmpty } = useDependencyGraph({
+ *   agentName: agent.metadata.name,
+ *   agentOrg: agent.metadata.org,
+ *   spec: agent.spec,
+ * });
+ *
+ * if (!isEmpty && tree) {
+ *   return <DependencyGraph tree={tree} onNodeClick={handleClick} />;
+ * }
+ * ```
+ */
+export function useDependencyGraph({ agentName, agentOrg, spec, }) {
+    return useMemo(() => {
+        if (!spec)
+            return { tree: null, isEmpty: true };
+        const { mcpServerUsages, skillRefs, subAgents } = spec;
+        const hasDeps = mcpServerUsages.length > 0 ||
+            skillRefs.length > 0 ||
+            subAgents.length > 0;
+        if (!hasDeps)
+            return { tree: null, isEmpty: true };
+        let nodeCount = 1; // root
+        const mcpNodes = mcpServerUsages
+            .filter((u) => u.mcpServerRef)
+            .map((usage) => {
+            nodeCount++;
+            const ref = usage.mcpServerRef;
+            const toolCount = usage.enabledTools.length;
+            return {
+                id: `mcp-server:${ref.slug}`,
+                kind: "mcp-server",
+                label: ref.slug,
+                qualifiedLabel: ref.org && ref.org !== agentOrg
+                    ? `${ref.org}/${ref.slug}`
+                    : undefined,
+                metadata: {
+                    tools: toolCount > 0
+                        ? `${toolCount} ${toolCount === 1 ? "tool" : "tools"}`
+                        : "all tools",
+                },
+                children: [],
+                ref: { org: ref.org || agentOrg, slug: ref.slug },
+            };
+        });
+        const skillNodes = skillRefs.map((ref) => {
+            nodeCount++;
+            return {
+                id: `skill:${ref.slug}`,
+                kind: "skill",
+                label: ref.slug,
+                qualifiedLabel: ref.org && ref.org !== agentOrg
+                    ? `${ref.org}/${ref.slug}`
+                    : undefined,
+                children: [],
+                ref: { org: ref.org || agentOrg, slug: ref.slug },
+            };
+        });
+        const subAgentNodes = subAgents.map((sa) => {
+            nodeCount++;
+            const saMcpNodes = sa.mcpAccess.map((access) => {
+                nodeCount++;
+                const toolCount = access.enabledTools.length;
+                return {
+                    id: `sub-agent:${sa.name}:mcp-server:${access.mcpServer}`,
+                    kind: "mcp-server",
+                    label: access.mcpServer,
+                    metadata: {
+                        tools: toolCount > 0
+                            ? `${toolCount} ${toolCount === 1 ? "tool" : "tools"}`
+                            : "all tools",
+                    },
+                    children: [],
+                    ref: { org: agentOrg, slug: access.mcpServer },
+                };
+            });
+            const saSkillNodes = sa.skillRefs.map((ref) => {
+                nodeCount++;
+                return {
+                    id: `sub-agent:${sa.name}:skill:${ref.slug}`,
+                    kind: "skill",
+                    label: ref.slug,
+                    qualifiedLabel: ref.org && ref.org !== agentOrg
+                        ? `${ref.org}/${ref.slug}`
+                        : undefined,
+                    children: [],
+                    ref: { org: ref.org || agentOrg, slug: ref.slug },
+                };
+            });
+            const metadata = {};
+            if (sa.modelOverride) {
+                metadata.model = sa.modelOverride;
+            }
+            return {
+                id: `sub-agent:${sa.name}`,
+                kind: "sub-agent",
+                label: sa.name,
+                description: sa.description || undefined,
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+                children: [...saMcpNodes, ...saSkillNodes],
+            };
+        });
+        const root = {
+            id: `agent:${agentName}`,
+            kind: "agent",
+            label: agentName,
+            children: [...mcpNodes, ...skillNodes, ...subAgentNodes],
+        };
+        return {
+            tree: { root, nodeCount },
+            isEmpty: false,
+        };
+    }, [agentName, agentOrg, spec]);
+}
+//# sourceMappingURL=useDependencyGraph.js.map

package/dependency-graph/useDependencyGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDependencyGraph.js","sourceRoot":"","sources":["../../src/dependency-graph/useDependencyGraph.ts"],"names":[],"mappings":"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"}

package/empty-state/EmptyState.d.ts

@@ -0,0 +1,29 @@
+import type { EmptyStateProps } from "./types";
+/**
+ * A semantic, accessible empty state component supporting four distinct
+ * variants: first-use, zero-results, permission, and error.
+ *
+ * Each variant provides appropriate default icons, copy, and ARIA roles.
+ * All defaults can be overridden via props. The `icon` prop accepts any
+ * ReactNode for full visual customization.
+ *
+ * @example
+ * ```tsx
+ * <EmptyState
+ *   variant="first-use"
+ *   resourceLabel="agents"
+ *   action={{ label: "Create agent", onClick: handleCreate }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <EmptyState
+ *   variant="error"
+ *   errorMessage="Network request failed"
+ *   action={{ label: "Retry", onClick: handleRetry }}
+ * />
+ * ```
+ */
+export declare function EmptyState({ variant, resourceLabel, icon, title, description, errorMessage, action, children, className, }: EmptyStateProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=EmptyState.d.ts.map

package/empty-state/EmptyState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../src/empty-state/EmptyState.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,aAAa,EACb,IAAI,EACJ,KAAK,EACL,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,SAAS,GACV,EAAE,eAAe,2CA+CjB"}

package/empty-state/EmptyState.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { useEmptyState } from "./useEmptyState";
+/**
+ * A semantic, accessible empty state component supporting four distinct
+ * variants: first-use, zero-results, permission, and error.
+ *
+ * Each variant provides appropriate default icons, copy, and ARIA roles.
+ * All defaults can be overridden via props. The `icon` prop accepts any
+ * ReactNode for full visual customization.
+ *
+ * @example
+ * ```tsx
+ * <EmptyState
+ *   variant="first-use"
+ *   resourceLabel="agents"
+ *   action={{ label: "Create agent", onClick: handleCreate }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <EmptyState
+ *   variant="error"
+ *   errorMessage="Network request failed"
+ *   action={{ label: "Retry", onClick: handleRetry }}
+ * />
+ * ```
+ */
+export function EmptyState({ variant, resourceLabel, icon, title, description, errorMessage, action, children, className, }) {
+    const resolved = useEmptyState({
+        variant,
+        resourceLabel,
+        title,
+        description,
+        errorMessage,
+    });
+    return (_jsxs("div", { role: resolved.role, className: cn("flex flex-col items-center gap-3 py-12 text-center", className), children: [_jsx("div", { className: "text-muted-foreground-faint", children: icon ?? resolved.defaultIcon }), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: resolved.title }), _jsx("p", { className: "max-w-sm text-xs text-muted-foreground-subtle", children: resolved.description })] }), children
+                ? _jsx("div", { className: "mt-1", children: children })
+                : action && (_jsx("button", { type: "button", onClick: action.onClick, className: cn("mt-1 inline-flex items-center rounded-md px-3 py-1.5 text-xs font-medium", variant === "error"
+                        ? "border border-input bg-background text-foreground hover:bg-accent hover:text-accent-foreground"
+                        : "bg-primary text-primary-foreground hover:bg-primary-hover", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"), children: action.label }))] }));
+}
+//# sourceMappingURL=EmptyState.js.map

package/empty-state/EmptyState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyState.js","sourceRoot":"","sources":["../../src/empty-state/EmptyState.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,aAAa,EACb,IAAI,EACJ,KAAK,EACL,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,SAAS,GACO;IAChB,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC7B,OAAO;QACP,aAAa;QACb,KAAK;QACL,WAAW;QACX,YAAY;KACb,CAAC,CAAC;IAEH,OAAO,CACL,eACE,IAAI,EAAE,QAAQ,CAAC,IAAI,EACnB,SAAS,EAAE,EAAE,CACX,oDAAoD,EACpD,SAAS,CACV,aAED,cAAK,SAAS,EAAC,6BAA6B,YACzC,IAAI,IAAI,QAAQ,CAAC,WAAW,GACzB,EACN,eAAK,SAAS,EAAC,qBAAqB,aAClC,YAAG,SAAS,EAAC,2CAA2C,YACrD,QAAQ,CAAC,KAAK,GACb,EACJ,YAAG,SAAS,EAAC,+CAA+C,YACzD,QAAQ,CAAC,WAAW,GACnB,IACA,EACL,QAAQ;gBACP,CAAC,CAAC,cAAK,SAAS,EAAC,MAAM,YAAE,QAAQ,GAAO;gBACxC,CAAC,CAAC,MAAM,IAAI,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,MAAM,CAAC,OAAO,EACvB,SAAS,EAAE,EAAE,CACX,0EAA0E,EAC1E,OAAO,KAAK,OAAO;wBACjB,CAAC,CAAC,gGAAgG;wBAClG,CAAC,CAAC,2DAA2D,EAC/D,yEAAyE,CAC1E,YAEA,MAAM,CAAC,KAAK,GACN,CACV,IACC,CACP,CAAC;AACJ,CAAC"}

package/empty-state/index.d.ts

@@ -0,0 +1,4 @@
+export { EmptyState } from "./EmptyState";
+export { useEmptyState } from "./useEmptyState";
+export type { EmptyStateVariant, EmptyStateAction, EmptyStateProps, UseEmptyStateOptions, UseEmptyStateReturn, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/empty-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/empty-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/empty-state/index.js

@@ -0,0 +1,3 @@
+export { EmptyState } from "./EmptyState";
+export { useEmptyState } from "./useEmptyState";
+//# sourceMappingURL=index.js.map

package/empty-state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/empty-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/empty-state/types.d.ts

@@ -0,0 +1,73 @@
+import type { ReactNode } from "react";
+/**
+ * Semantic variant for an empty state, each representing a distinct
+ * reason why no content is visible.
+ */
+export type EmptyStateVariant = "first-use" | "zero-results" | "permission" | "error";
+/** Action rendered as a button within the empty state. */
+export interface EmptyStateAction {
+    /** Button label. */
+    readonly label: string;
+    /** Click handler. */
+    readonly onClick: () => void;
+}
+/** Options for the {@link useEmptyState} behavior hook. */
+export interface UseEmptyStateOptions {
+    /** The semantic reason no content is shown. */
+    readonly variant: EmptyStateVariant;
+    /**
+     * Human-readable label for the resource type (e.g. "agents", "skills").
+     * Used to generate contextual default copy.
+     */
+    readonly resourceLabel?: string;
+    /** Custom title override. When provided, replaces the generated default. */
+    readonly title?: string;
+    /** Custom description override. When provided, replaces the generated default. */
+    readonly description?: string;
+    /** Error message to display — relevant for the "error" variant. */
+    readonly errorMessage?: string;
+}
+/** Return value of the {@link useEmptyState} behavior hook. */
+export interface UseEmptyStateReturn {
+    /** Resolved title text. */
+    readonly title: string;
+    /** Resolved description text. */
+    readonly description: string;
+    /** Suggested default icon for the variant (as a ReactNode). */
+    readonly defaultIcon: ReactNode;
+    /** The ARIA role appropriate for this variant. */
+    readonly role: "status" | "alert";
+}
+/** Props for the styled {@link EmptyState} component. */
+export interface EmptyStateProps {
+    /**
+     * The semantic reason no content is shown.
+     * Determines default icon, copy, and ARIA role.
+     */
+    readonly variant: EmptyStateVariant;
+    /**
+     * Human-readable label for the resource type (e.g. "agents", "skills").
+     * Used to generate contextual default copy.
+     */
+    readonly resourceLabel?: string;
+    /** Custom icon to display. Defaults to a variant-appropriate Lucide icon. */
+    readonly icon?: ReactNode;
+    /** Custom title override. */
+    readonly title?: string;
+    /** Custom description override. */
+    readonly description?: string;
+    /** Error message — only used when variant is "error". */
+    readonly errorMessage?: string;
+    /** Primary action button. */
+    readonly action?: EmptyStateAction;
+    /**
+     * Custom action slot content. When provided, renders in the action
+     * area (centered, below the description) instead of the `action` button.
+     * Use this when you need full control over the CTA element — e.g. a
+     * `<Link>` for client-side routing or a button with an icon.
+     */
+    readonly children?: ReactNode;
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/empty-state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/empty-state/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,cAAc,GACd,YAAY,GACZ,OAAO,CAAC;AAEZ,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnC;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/empty-state/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/empty-state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/empty-state/types.ts"],"names":[],"mappings":""}