@echothink-ui/search 0.1.0

package/src/index.test.tsx

@@ -0,0 +1,254 @@
+import { fireEvent, render, screen } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import {
+  AppCommandSearch,
+  ProjectCommandPalette,
+  RecentItems,
+  ResourceSearch,
+  SearchFacetPanel,
+  SearchResultsPanel,
+  SemanticSearchResult
+} from "./index";
+
+const commands = [
+  {
+    id: "open-approvals",
+    label: "Open approval queue",
+    description: "Review resource actions waiting on legal.",
+    domain: "Workflow",
+    kind: "app-domain" as const,
+    shortcut: "G A"
+  },
+  {
+    id: "draft-follow-up",
+    label: "Draft follow-up",
+    description: "Create a message from the selected resource.",
+    domain: "Inbox",
+    kind: "action" as const
+  }
+];
+
+const paletteCommands = [
+  {
+    id: "open-approvals",
+    label: "Open approval queue",
+    group: "Navigation",
+    hint: "Review resource actions waiting on legal.",
+    onSelect: () => undefined
+  }
+];
+
+describe("@echothink-ui/search", () => {
+  it("renders command search affordances and scoped command results", () => {
+    render(
+      <AppCommandSearch value="approval" scopeLabel="Workspace domains" commands={commands} />
+    );
+
+    expect(screen.getByDisplayValue("approval")).toBeTruthy();
+    expect(screen.getByText("⌘K")).toBeTruthy();
+    expect(screen.getByText("Workspace domains")).toBeTruthy();
+    expect(screen.getByText("Open approval queue")).toBeTruthy();
+    expect(screen.getByText("Workflow")).toBeTruthy();
+    expect(screen.getByRole("button", { name: "Run" })).toBeTruthy();
+  });
+
+  it("selects the active command on submit", () => {
+    const onSelect = vi.fn();
+    const { container } = render(
+      <AppCommandSearch value="approval" commands={commands} onSelect={onSelect} />
+    );
+
+    fireEvent.submit(container.querySelector("form")!);
+
+    expect(onSelect).toHaveBeenCalledWith("open-approvals");
+  });
+
+  it("labels the project scoped command palette with its project context", () => {
+    render(
+      <ProjectCommandPalette
+        open
+        onClose={vi.fn()}
+        projectRef="marketing"
+        commands={paletteCommands}
+      />
+    );
+
+    expect(screen.getByRole("dialog", { name: "Project command palette" })).toBeTruthy();
+    expect(screen.getByText("Project marketing")).toBeTruthy();
+    expect(screen.getByText("Open approval queue")).toBeTruthy();
+  });
+
+  it("renders grouped search results with metadata and row selection", () => {
+    const onSelect = vi.fn();
+    const { rerender } = render(
+      <SearchResultsPanel
+        query="brief"
+        groups={[
+          {
+            id: "tasks",
+            label: "Tasks",
+            results: [
+              {
+                id: "t1",
+                label: "Approve Q3 brief",
+                description: "Campaign task waiting on final signoff",
+                owner: "Jane",
+                status: "Due today"
+              },
+              {
+                id: "t2",
+                label: "Draft pricing copy",
+                description: "Matched by launch brief"
+              }
+            ]
+          },
+          {
+            id: "docs",
+            label: "Documents",
+            results: [
+              {
+                id: "d1",
+                label: "Brief.md",
+                version: 12,
+                updatedAt: "2h ago"
+              }
+            ]
+          }
+        ]}
+        onSelect={onSelect}
+      />
+    );
+
+    expect(screen.getByText("3 results")).toBeTruthy();
+    expect(screen.getByText("\"brief\"")).toBeTruthy();
+    expect(screen.getByText("Tasks")).toBeTruthy();
+    expect(screen.getByText("Campaign task waiting on final signoff")).toBeTruthy();
+    expect(screen.getByText("Owner: Jane")).toBeTruthy();
+    expect(screen.getByText("Due today")).toBeTruthy();
+    expect(screen.getByText("v12")).toBeTruthy();
+
+    fireEvent.click(screen.getByRole("button", { name: /approve q3 brief/i }));
+
+    expect(onSelect).toHaveBeenCalledWith("t1");
+
+    rerender(
+      <SearchResultsPanel query="missing" groups={[]} emptyLabel="Nothing found" />
+    );
+
+    expect(screen.getByText("Nothing found")).toBeTruthy();
+    expect(screen.getByText("Try another keyword or remove a filter.")).toBeTruthy();
+  });
+
+  it("renders recent items with row-level actions and an empty state", () => {
+    const onSelect = vi.fn();
+    const { rerender } = render(
+      <RecentItems
+        items={[
+          {
+            id: "brief",
+            label: "Brief.md",
+            kind: "document",
+            description: "Updated project kickoff notes",
+            visitedAt: "10:42"
+          }
+        ]}
+        onSelect={onSelect}
+      />
+    );
+
+    fireEvent.click(screen.getByRole("button", { name: /open brief\.md/i }));
+
+    expect(onSelect).toHaveBeenCalledWith("brief");
+    expect(screen.getByText("Document")).toBeTruthy();
+    expect(screen.getByText("Updated project kickoff notes")).toBeTruthy();
+    expect(screen.getByText("10:42")).toBeTruthy();
+
+    rerender(<RecentItems items={[]} />);
+
+    expect(screen.getByText("No recent items")).toBeTruthy();
+  });
+
+  it("renders resource search with resource-specific suggestion semantics", () => {
+    const { container } = render(
+      <ResourceSearch
+        open
+        resourceScope="project:marketing"
+        suggestions={[
+          {
+            id: "brief",
+            label: "Launch brief",
+            kind: "Document",
+            meta: "Synced 12 min ago"
+          }
+        ]}
+      />
+    );
+
+    expect(container.firstElementChild?.getAttribute("data-eth-component")).toBe(
+      "ResourceSearch"
+    );
+    expect(container.firstElementChild?.getAttribute("data-resource-scope")).toBe(
+      "project:marketing"
+    );
+    expect(screen.getByRole("listbox", { name: "Resource suggestions" })).toBeTruthy();
+    expect(screen.getByText("Resource matches")).toBeTruthy();
+    expect(screen.getByText("Launch brief")).toBeTruthy();
+  });
+
+  it("renders selected search facets with a clear action", () => {
+    const onChange = vi.fn();
+
+    render(
+      <SearchFacetPanel
+        facets={[
+          {
+            id: "kind",
+            label: "Kind",
+            options: [
+              { value: "task", label: "Task", count: 12 },
+              { value: "doc", label: "Document", count: 4 }
+            ]
+          },
+          {
+            id: "status",
+            label: "Status",
+            options: [{ value: "open", label: "Open", count: 10 }]
+          }
+        ]}
+        selected={{ kind: ["task"], status: ["open"] }}
+        onChange={onChange}
+      />
+    );
+
+    expect(screen.getByRole("complementary", { name: "Search filters" })).toBeTruthy();
+    expect(screen.getByText("2 selected")).toBeTruthy();
+    expect(screen.getByText("Task")).toBeTruthy();
+    expect(screen.getByText("12")).toBeTruthy();
+
+    fireEvent.click(screen.getByRole("button", { name: "Clear" }));
+
+    expect(onChange).toHaveBeenCalledWith({ kind: [], status: [] });
+  });
+
+  it("renders semantic search snippets with highlighted evidence", () => {
+    const { container } = render(
+      <SemanticSearchResult
+        result={{
+          id: "policy",
+          snippet: "Approval policy requires legal review for external sends.",
+          highlights: [[0, 17]],
+          evidence: [
+            { id: "policy-v3", label: "policy-v3.md", href: "#" },
+            { id: "incident-review", label: "Q2 incident review" }
+          ]
+        }}
+      />
+    );
+
+    expect(container.querySelector("mark")?.textContent).toBe("Approval policy");
+    expect(screen.getByText("Approval policy")).toBeTruthy();
+    expect(screen.getByText("Evidence")).toBeTruthy();
+    expect(screen.getByRole("link", { name: "policy-v3.md" })).toBeTruthy();
+    expect(screen.getByText("Q2 incident review")).toBeTruthy();
+  });
+});

package/src/index.tsx

@@ -0,0 +1,55 @@
+import "./styles.css";
+
+export type {
+  AgentSearchSuggestionProps,
+  AppCommandItem,
+  AppCommandKind,
+  AppCommandSearchProps,
+  AppDomainSearchProps,
+  CommandItem,
+  EntitySearchInputProps,
+  EntitySuggestion,
+  GlobalCommandPaletteProps,
+  ProjectCommandPaletteProps,
+  RecentItem,
+  RecentItemsProps,
+  ResourceSearchProps,
+  SavedSearch,
+  SavedSearchesProps,
+  SearchFacet,
+  SearchFacetOption,
+  SearchFacetPanelProps,
+  SearchResultGroup,
+  SearchResultItem,
+  SearchResultMetadata,
+  SearchResultsPanelProps,
+  SemanticSearchResultProps
+} from "./components/types";
+export { AgentSearchSuggestion } from "./components/AgentSearchSuggestion";
+export { AppCommandSearch } from "./components/AppCommandSearch";
+export { AppDomainSearch } from "./components/AppDomainSearch";
+export { EntitySearchInput } from "./components/EntitySearchInput";
+export { GlobalCommandPalette } from "./components/GlobalCommandPalette";
+export { ProjectCommandPalette } from "./components/ProjectCommandPalette";
+export { RecentItems } from "./components/RecentItems";
+export { ResourceSearch } from "./components/ResourceSearch";
+export { SavedSearches } from "./components/SavedSearches";
+export { SearchFacetPanel } from "./components/SearchFacetPanel";
+export { SearchResultsPanel } from "./components/SearchResultsPanel";
+export { SemanticSearchResult } from "./components/SemanticSearchResult";
+
+export const SearchComponentNames = [
+  "GlobalCommandPalette",
+  "ProjectCommandPalette",
+  "AppCommandSearch",
+  "SearchResultsPanel",
+  "SearchFacetPanel",
+  "SavedSearches",
+  "RecentItems",
+  "EntitySearchInput",
+  "AppDomainSearch",
+  "ResourceSearch",
+  "SemanticSearchResult",
+  "AgentSearchSuggestion"
+] as const;
+export type SearchComponentName = (typeof SearchComponentNames)[number];