@agent-native/toolkit 0.9.0 → 0.10.0

package/README.md

@@ -25,7 +25,10 @@ and docs. Dispatch is a separate product rather than a Toolkit module.
 
 ```tsx
 import { ToolkitProvider } from "@agent-native/toolkit/provider";
-import { ChatHistoryList } from "@agent-native/toolkit/chat-history";
+import {
+  ChatHistoryList,
+  ChatHistoryRail,
+} from "@agent-native/toolkit/chat-history";
 import { PresenceBar } from "@agent-native/toolkit/collab-ui";
 import { ContextMeterView } from "@agent-native/toolkit/context-ui";
 import {
@@ -47,8 +50,14 @@ import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
 
 Import `@agent-native/toolkit/styles.css` after Tailwind to include Toolkit's
 source scanning. If an app renders `SharedRichEditor`, also import
-`@agent-native/toolkit/editor.css`. If an app renders `ChatHistoryList`, also
-import `@agent-native/toolkit/chat-history.css`.
+`@agent-native/toolkit/editor.css`. If an app renders `ChatHistoryList` or
+`ChatHistoryRail`, also import `@agent-native/toolkit/chat-history.css`.
+
+Use `ChatHistoryRail` for app sidebars. It shows five recent chats by default,
+progressively discloses up to fifteen, and keeps the app-provided New chat
+action in a footer row with the ellipsis disclosure on its right. The app
+continues to own thread persistence, sorting, routing, and mutations through
+Core.
 
 Inside template apps, prefer local adapters such as `@/components/ui/button` so
 apps can replace their primitives without changing every callsite.

package/agent-native.eject.json

@@ -62,6 +62,7 @@
         "class-variance-authority",
         "clsx",
         "cmdk",
+        "culori",
         "date-fns",
         "embla-carousel-react",
         "highlight.js",
@@ -130,8 +131,20 @@
         }
       ],
       "dependencies": [
+        "@radix-ui/react-avatar",
+        "@radix-ui/react-checkbox",
+        "@radix-ui/react-dialog",
+        "@radix-ui/react-dropdown-menu",
+        "@radix-ui/react-popover",
+        "@radix-ui/react-select",
+        "@radix-ui/react-slot",
+        "@radix-ui/react-switch",
+        "@radix-ui/react-tabs",
+        "@radix-ui/react-tooltip",
         "@tabler/icons-react",
+        "class-variance-authority",
         "clsx",
+        "culori",
         "react",
         "recharts",
         "tailwind-merge"
@@ -169,6 +182,23 @@
       ],
       "verification": ["pnpm typecheck"]
     },
+    {
+      "id": "toolkit/conformance",
+      "label": "Design system conformance kit",
+      "catalog": "toolkit-ui",
+      "catalogItems": ["conformance"],
+      "entrypoints": ["./conformance", "./conformance/*"],
+      "strategy": "source-copy",
+      "sourceEntries": [
+        "src/conformance/index.ts",
+        "src/conformance/runner.tsx",
+        "src/conformance/types.ts",
+        "src/conformance/version.ts"
+      ],
+      "targetRoot": "app/components/agent-native/toolkit",
+      "dependencies": ["react", "react-dom"],
+      "verification": ["pnpm typecheck"]
+    },
     {
       "id": "toolkit/context-ui",
       "label": "Context inspection UI",
@@ -207,6 +237,44 @@
       ],
       "verification": ["pnpm typecheck"]
     },
+    {
+      "id": "toolkit/design-system",
+      "label": "Design system bridge",
+      "catalog": "toolkit-ui",
+      "catalogItems": ["design-system"],
+      "entrypoints": ["./design-system", "./design-system/*"],
+      "strategy": "source-copy",
+      "sourceEntries": [
+        "src/design-system/components.tsx",
+        "src/design-system/context.tsx",
+        "src/design-system/default-adapter.tsx",
+        "src/design-system/definition.ts",
+        "src/design-system/error-boundary.tsx",
+        "src/design-system/index.ts",
+        "src/design-system/theme.ts",
+        "src/design-system/types.ts"
+      ],
+      "targetRoot": "app/components/agent-native/toolkit",
+      "dependencies": [
+        "@radix-ui/react-avatar",
+        "@radix-ui/react-checkbox",
+        "@radix-ui/react-dialog",
+        "@radix-ui/react-dropdown-menu",
+        "@radix-ui/react-popover",
+        "@radix-ui/react-select",
+        "@radix-ui/react-slot",
+        "@radix-ui/react-switch",
+        "@radix-ui/react-tabs",
+        "@radix-ui/react-tooltip",
+        "@tabler/icons-react",
+        "class-variance-authority",
+        "clsx",
+        "culori",
+        "react",
+        "tailwind-merge"
+      ],
+      "verification": ["pnpm typecheck"]
+    },
     {
       "id": "toolkit/dashboard",
       "label": "Dashboard kit",
@@ -222,6 +290,7 @@
         "@tabler/icons-react",
         "class-variance-authority",
         "clsx",
+        "culori",
         "react",
         "recharts",
         "tailwind-merge"
@@ -329,6 +398,7 @@
         "@radix-ui/react-slot",
         "class-variance-authority",
         "clsx",
+        "culori",
         "react",
         "tailwind-merge"
       ],
@@ -387,6 +457,7 @@
         "class-variance-authority",
         "clsx",
         "cmdk",
+        "culori",
         "date-fns",
         "embla-carousel-react",
         "input-otp",

package/dist/chat-history/ChatHistoryRail.d.ts

@@ -0,0 +1,33 @@
+import type { ReactNode } from "react";
+import { type ChatHistoryItem, type ChatHistoryListProps } from "./ChatHistoryList.js";
+import { type ChatHistoryRailController } from "./useChatHistoryRailController.js";
+export interface ChatHistoryRailLabels {
+    newChat: string;
+    showMore: string;
+    showLess: string;
+}
+export interface ChatHistoryRailProps extends Omit<ChatHistoryListProps, "footer" | "items" | "sections" | "variant"> {
+    items: ChatHistoryItem[];
+    onNewChat: () => void;
+    railLabels: ChatHistoryRailLabels;
+    previewCount?: number;
+    expandedCount?: number;
+    /**
+     * Product-level presentation slot for design systems that want to replace
+     * the rail wholesale. State and actions still come from the same controller
+     * as the default view.
+     */
+    renderRail?: (context: ChatHistoryRailRenderContext) => ReactNode;
+}
+export interface ChatHistoryRailRenderContext {
+    controller: ChatHistoryRailController<ChatHistoryItem>;
+    listProps: Omit<ChatHistoryListProps, "footer" | "items" | "sections" | "variant">;
+}
+export type DefaultChatHistoryRailViewProps = ChatHistoryRailRenderContext;
+export declare function DefaultChatHistoryRailView({ controller, listProps, }: ChatHistoryRailRenderContext): import("react").JSX.Element;
+/**
+ * Compact recent-chat rail for app sidebars. Hosts own thread persistence,
+ * sorting, routing, and mutations; the rail only owns progressive disclosure.
+ */
+export declare function ChatHistoryRail({ items, onNewChat, railLabels, previewCount, expandedCount, renderRail, className, emptyLabel, ...listProps }: ChatHistoryRailProps): import("react").JSX.Element;
+//# sourceMappingURL=ChatHistoryRail.d.ts.map

package/dist/chat-history/ChatHistoryRail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryRail.d.ts","sourceRoot":"","sources":["../../src/chat-history/ChatHistoryRail.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,oBAAoB,EACpB,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAC5C;IACC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,SAAS,CAAC;CACnE;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,yBAAyB,CAAC,eAAe,CAAC,CAAC;IACvD,SAAS,EAAE,IAAI,CACb,oBAAoB,EACpB,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAC5C,CAAC;CACH;AAED,MAAM,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AAE3E,wBAAgB,0BAA0B,CAAC,EACzC,UAAU,EACV,SAAS,GACV,EAAE,4BAA4B,+BAmD9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAgB,EAChB,aAAkB,EAClB,UAAU,EACV,SAAS,EACT,UAAU,EACV,GAAG,SAAS,EACb,EAAE,oBAAoB,+BAqBtB"}

package/dist/chat-history/ChatHistoryRail.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconDots, IconPlus } from "@tabler/icons-react";
+import { ActionButton, IconButton } from "../design-system/components.js";
+import { DesignSystemErrorBoundary } from "../design-system/error-boundary.js";
+import { ChatHistoryList, } from "./ChatHistoryList.js";
+import { useChatHistoryRailController, } from "./useChatHistoryRailController.js";
+export function DefaultChatHistoryRailView({ controller, listProps, }) {
+    const { canExpand, disclosureLabel, expanded, newChatLabel, onNewChat, toggleExpanded, visibleItems, } = controller;
+    const { className, emptyLabel, ...rest } = listProps;
+    const footer = (_jsxs("div", { className: "an-chat-history-rail__footer", children: [_jsx(ActionButton, { type: "button", className: "an-chat-history-rail__new-chat", emphasis: "ghost", size: "compact", leadingIcon: _jsx(IconPlus, { size: 13, strokeWidth: 1.8, "aria-hidden": "true" }), onPress: onNewChat, children: _jsx("span", { children: newChatLabel }) }), canExpand && (_jsx(IconButton, { type: "button", className: "an-chat-history-rail__disclosure", size: "compact", icon: _jsx(IconDots, { size: 14, strokeWidth: 1.8, "aria-hidden": "true" }), onPress: toggleExpanded, "aria-expanded": expanded, label: disclosureLabel, title: disclosureLabel }))] }));
+    return (_jsx(ChatHistoryList, { ...rest, items: visibleItems, footer: footer, emptyLabel: emptyLabel ?? null, variant: "rail", className: ["an-chat-history-rail", className].filter(Boolean).join(" ") }));
+}
+/**
+ * Compact recent-chat rail for app sidebars. Hosts own thread persistence,
+ * sorting, routing, and mutations; the rail only owns progressive disclosure.
+ */
+export function ChatHistoryRail({ items, onNewChat, railLabels, previewCount = 5, expandedCount = 15, renderRail, className, emptyLabel, ...listProps }) {
+    const controller = useChatHistoryRailController({
+        items,
+        onNewChat,
+        labels: railLabels,
+        previewCount,
+        expandedCount,
+    });
+    const context = {
+        controller,
+        listProps: { ...listProps, className, emptyLabel },
+    };
+    const fallback = _jsx(DefaultChatHistoryRailView, { ...context });
+    return renderRail ? (_jsx(DesignSystemErrorBoundary, { component: "ChatHistoryRail", fallback: fallback, children: _jsx(ChatHistoryRailCustomView, { renderRail: renderRail, context: context }) })) : (fallback);
+}
+function ChatHistoryRailCustomView({ renderRail, context, }) {
+    return renderRail(context);
+}
+//# sourceMappingURL=ChatHistoryRail.js.map

package/dist/chat-history/ChatHistoryRail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryRail.js","sourceRoot":"","sources":["../../src/chat-history/ChatHistoryRail.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC;AAmC3C,MAAM,UAAU,0BAA0B,CAAC,EACzC,UAAU,EACV,SAAS,GACoB;IAC7B,MAAM,EACJ,SAAS,EACT,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,cAAc,EACd,YAAY,GACb,GAAG,UAAU,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IAErD,MAAM,MAAM,GAAG,CACb,eAAK,SAAS,EAAC,8BAA8B,aAC3C,KAAC,YAAY,IACX,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,gCAAgC,EAC1C,QAAQ,EAAC,OAAO,EAChB,IAAI,EAAC,SAAS,EACd,WAAW,EACT,KAAC,QAAQ,IAAC,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,iBAAc,MAAM,GAAG,EAE7D,OAAO,EAAE,SAAS,YAElB,yBAAO,YAAY,GAAQ,GACd,EACd,SAAS,IAAI,CACZ,KAAC,UAAU,IACT,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,kCAAkC,EAC5C,IAAI,EAAC,SAAS,EACd,IAAI,EAAE,KAAC,QAAQ,IAAC,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,iBAAc,MAAM,GAAG,EACjE,OAAO,EAAE,cAAc,mBACR,QAAQ,EACvB,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,eAAe,GACtB,CACH,IACG,CACP,CAAC;IAEF,OAAO,CACL,KAAC,eAAe,OACV,IAAI,EACR,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,IAAI,IAAI,EAC9B,OAAO,EAAC,MAAM,EACd,SAAS,EAAE,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GACxE,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,GAAG,CAAC,EAChB,aAAa,GAAG,EAAE,EAClB,UAAU,EACV,SAAS,EACT,UAAU,EACV,GAAG,SAAS,EACS;IACrB,MAAM,UAAU,GAAG,4BAA4B,CAAC;QAC9C,KAAK;QACL,SAAS;QACT,MAAM,EAAE,UAAU;QAClB,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;IACH,MAAM,OAAO,GAAiC;QAC5C,UAAU;QACV,SAAS,EAAE,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE;KACnD,CAAC;IACF,MAAM,QAAQ,GAAG,KAAC,0BAA0B,OAAK,OAAO,GAAI,CAAC;IAE7D,OAAO,UAAU,CAAC,CAAC,CAAC,CAClB,KAAC,yBAAyB,IAAC,SAAS,EAAC,iBAAiB,EAAC,QAAQ,EAAE,QAAQ,YACvE,KAAC,yBAAyB,IAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAI,GAC7C,CAC7B,CAAC,CAAC,CAAC,CACF,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,EACjC,UAAU,EACV,OAAO,GAIR;IACC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/dist/chat-history/ChatHistoryRail.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChatHistoryRail.spec.d.ts.map

package/dist/chat-history/ChatHistoryRail.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryRail.spec.d.ts","sourceRoot":"","sources":["../../src/chat-history/ChatHistoryRail.spec.tsx"],"names":[],"mappings":""}

package/dist/chat-history/ChatHistoryRail.spec.js

@@ -0,0 +1,157 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ActionButton } from "../design-system/components.js";
+import { defineDesignSystem } from "../design-system/definition.js";
+import { ToolkitProvider } from "../provider.js";
+import { ChatHistoryRail } from "./ChatHistoryRail.js";
+const railLabels = {
+    newChat: "New chat",
+    showMore: "Show more chats",
+    showLess: "Show fewer chats",
+};
+function makeItems(count) {
+    return Array.from({ length: count }, (_, index) => ({
+        id: `thread-${index + 1}`,
+        title: `Chat ${index + 1}`,
+    }));
+}
+describe("ChatHistoryRail", () => {
+    let container;
+    let root;
+    beforeEach(() => {
+        vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
+        container = document.createElement("div");
+        document.body.appendChild(container);
+        root = createRoot(container);
+    });
+    afterEach(() => {
+        act(() => root.unmount());
+        container.remove();
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    it("shows five recent chats before progressively disclosing up to fifteen", () => {
+        act(() => {
+            root.render(_jsx(ChatHistoryRail, { items: makeItems(20), onSelect: () => { }, onNewChat: () => { }, railLabels: railLabels }));
+        });
+        expect(container.querySelectorAll(".an-chat-history-row")).toHaveLength(5);
+        const disclosure = container.querySelector(".an-chat-history-rail__disclosure");
+        expect(disclosure?.getAttribute("aria-label")).toBe("Show more chats");
+        act(() => disclosure?.click());
+        expect(container.querySelectorAll(".an-chat-history-row")).toHaveLength(15);
+        expect(disclosure?.getAttribute("aria-label")).toBe("Show fewer chats");
+        act(() => disclosure?.click());
+        expect(container.querySelectorAll(".an-chat-history-row")).toHaveLength(5);
+    });
+    it("keeps the disclosure to the right of new chat and calls its handler", () => {
+        const onNewChat = vi.fn();
+        act(() => {
+            root.render(_jsx(ChatHistoryRail, { items: makeItems(6), onSelect: () => { }, onNewChat: onNewChat, railLabels: railLabels }));
+        });
+        const disclosure = container.querySelector(".an-chat-history-rail__disclosure");
+        const newChat = container.querySelector(".an-chat-history-rail__new-chat");
+        expect(newChat?.textContent).toBe("New chat");
+        expect(newChat?.nextElementSibling).toBe(disclosure);
+        expect(newChat?.parentElement?.lastElementChild).toBe(disclosure);
+        act(() => newChat?.click());
+        expect(onNewChat).toHaveBeenCalledOnce();
+    });
+    it("lets new chat fill the footer when there are no more chats", () => {
+        act(() => {
+            root.render(_jsx(ChatHistoryRail, { items: makeItems(3), onSelect: () => { }, onNewChat: () => { }, railLabels: railLabels }));
+        });
+        expect(container.querySelector(".an-chat-history-rail__disclosure")).toBeNull();
+        expect(container.querySelector(".an-chat-history-rail__new-chat")).not.toBeNull();
+    });
+    it("preserves list actions for progressively disclosed rows", () => {
+        const onSelect = vi.fn();
+        act(() => {
+            root.render(_jsx(ChatHistoryRail, { items: makeItems(6), onSelect: onSelect, onNewChat: () => { }, railLabels: railLabels }));
+        });
+        act(() => {
+            container
+                .querySelector(".an-chat-history-rail__disclosure")
+                ?.click();
+        });
+        const rows = container.querySelectorAll(".an-chat-history-row__button");
+        act(() => rows[5]?.click());
+        expect(onSelect).toHaveBeenCalledWith("thread-6");
+    });
+    it("lets a design system replace the whole view without replacing its controller", () => {
+        const onNewChat = vi.fn();
+        const CustomActionButton = vi.fn(({ children, onPress }) => (_jsx("button", { "data-acme-action": true, type: "button", onClick: (event) => onPress?.(event), children: children })));
+        const designSystem = defineDesignSystem({
+            name: "Acme",
+            components: { ActionButton: CustomActionButton },
+        });
+        act(() => {
+            root.render(_jsx(ToolkitProvider, { designSystem: designSystem, children: _jsx(ChatHistoryRail, { items: makeItems(20), onSelect: () => { }, onNewChat: onNewChat, railLabels: railLabels, renderRail: ({ controller }) => (_jsxs("section", { "data-acme-rail": true, children: [_jsx("output", { children: controller.visibleItems.length }), _jsx(ActionButton, { onPress: controller.onNewChat, children: controller.newChatLabel }), _jsx(ActionButton, { onPress: controller.toggleExpanded, children: controller.disclosureLabel })] })) }) }));
+        });
+        const actions = container.querySelectorAll("[data-acme-action]");
+        expect(container.querySelector("[data-acme-rail]")).not.toBeNull();
+        expect(container.querySelector("output")?.textContent).toBe("5");
+        expect(actions[1]?.textContent).toBe("Show more chats");
+        act(() => actions[1]?.click());
+        expect(container.querySelector("output")?.textContent).toBe("15");
+        expect(actions[1]?.textContent).toBe("Show fewer chats");
+        act(() => actions[0]?.click());
+        expect(onNewChat).toHaveBeenCalledOnce();
+        expect(CustomActionButton).toHaveBeenCalled();
+    });
+    it("routes the default footer through the semantic action bridge", () => {
+        const onNewChat = vi.fn();
+        const CustomActionButton = vi.fn(({ children, onPress }) => (_jsx("button", { "data-semantic-action": true, type: "button", onClick: (event) => onPress?.(event), children: children })));
+        const CustomIconButton = vi.fn(({ icon, label, onPress }) => (_jsx("button", { "data-semantic-icon": true, type: "button", "aria-label": label, onClick: (event) => onPress?.(event), children: icon })));
+        const designSystem = defineDesignSystem({
+            name: "Acme",
+            components: {
+                ActionButton: CustomActionButton,
+                IconButton: CustomIconButton,
+            },
+        });
+        act(() => {
+            root.render(_jsx(ToolkitProvider, { designSystem: designSystem, children: _jsx(ChatHistoryRail, { items: makeItems(6), onSelect: () => { }, onNewChat: onNewChat, railLabels: railLabels }) }));
+        });
+        const newChat = container.querySelector("[data-semantic-action]");
+        const disclosure = container.querySelector("[data-semantic-icon]");
+        expect(newChat).not.toBeNull();
+        expect(disclosure?.getAttribute("aria-label")).toBe("Show more chats");
+        expect(CustomActionButton.mock.calls[0]?.[0]).toMatchObject({
+            emphasis: "ghost",
+            size: "compact",
+            leadingIcon: expect.anything(),
+        });
+        expect(CustomIconButton.mock.calls[0]?.[0]).toMatchObject({
+            size: "compact",
+            "aria-expanded": false,
+            label: "Show more chats",
+        });
+        act(() => newChat?.click());
+        expect(onNewChat).toHaveBeenCalledOnce();
+    });
+    it("keeps native button semantics and focus in the default view", () => {
+        const onNewChat = vi.fn();
+        act(() => {
+            root.render(_jsx(ChatHistoryRail, { items: makeItems(6), onSelect: () => { }, onNewChat: onNewChat, railLabels: railLabels }));
+        });
+        const newChat = container.querySelector(".an-chat-history-rail__new-chat");
+        newChat?.focus();
+        act(() => newChat?.click());
+        expect(newChat?.type).toBe("button");
+        expect(document.activeElement).toBe(newChat);
+        expect(onNewChat).toHaveBeenCalledOnce();
+    });
+    it("falls back to the default rail when a product renderer fails", () => {
+        vi.spyOn(console, "error").mockImplementation(() => { });
+        act(() => {
+            root.render(_jsx(ChatHistoryRail, { items: makeItems(6), onSelect: () => { }, onNewChat: () => { }, railLabels: railLabels, renderRail: () => {
+                    throw new Error("broken company rail");
+                } }));
+        });
+        expect(container.querySelector(".an-chat-history-rail__new-chat")).not.toBeNull();
+    });
+});
+//# sourceMappingURL=ChatHistoryRail.spec.js.map

package/dist/chat-history/ChatHistoryRail.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryRail.spec.js","sourceRoot":"","sources":["../../src/chat-history/ChatHistoryRail.spec.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAEhC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAc,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,iBAAiB;IAC3B,QAAQ,EAAE,kBAAkB;CAC7B,CAAC;AAEF,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,EAAE,EAAE,UAAU,KAAK,GAAG,CAAC,EAAE;QACzB,KAAK,EAAE,QAAQ,KAAK,GAAG,CAAC,EAAE;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,SAAyB,CAAC;IAC9B,IAAI,IAAU,CAAC;IAEf,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,UAAU,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAChD,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1B,SAAS,CAAC,MAAM,EAAE,CAAC;QACnB,EAAE,CAAC,eAAe,EAAE,CAAC;QACrB,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,EACpB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EACnB,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,CACxC,mCAAmC,CACpC,CAAC;QACF,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEvE,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAExE,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,CACxC,mCAAmC,CACpC,CAAC;QACF,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CACrC,iCAAiC,CAClC,CAAC;QACF,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAElE,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EACnB,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,CACJ,SAAS,CAAC,aAAa,CAAC,mCAAmC,CAAC,CAC7D,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,CACJ,SAAS,CAAC,aAAa,CAAC,iCAAiC,CAAC,CAC3D,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EACnB,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,EAAE;YACP,SAAS;iBACN,aAAa,CAAoB,mCAAmC,CAAC;gBACtE,EAAE,KAAK,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,CACrC,8BAA8B,CAC/B,CAAC;QACF,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,kBAAkB,GAAG,EAAE,CAAC,EAAE,CAC9B,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAsC,EAAE,EAAE,CAAC,CAC7D,2CAEE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,YAEnC,QAAQ,GACF,CACV,CACF,CAAC;QACF,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,EAAE,YAAY,EAAE,kBAAkB,EAAE;SACjD,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IAAC,YAAY,EAAE,YAAY,YACzC,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,EACpB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAC9B,sDACE,2BAAS,UAAU,CAAC,YAAY,CAAC,MAAM,GAAU,EACjD,KAAC,YAAY,IAAC,OAAO,EAAE,UAAU,CAAC,SAAS,YACxC,UAAU,CAAC,YAAY,GACX,EACf,KAAC,YAAY,IAAC,OAAO,EAAE,UAAU,CAAC,cAAc,YAC7C,UAAU,CAAC,eAAe,GACd,IACP,CACX,GACD,GACc,CACnB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GACX,SAAS,CAAC,gBAAgB,CAAoB,oBAAoB,CAAC,CAAC;QACtE,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACnE,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAExD,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAEzD,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACzC,MAAM,CAAC,kBAAkB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,kBAAkB,GAAG,EAAE,CAAC,EAAE,CAC9B,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAsC,EAAE,EAAE,CAAC,CAC7D,+CAEE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,YAEnC,QAAQ,GACF,CACV,CACF,CAAC;QACF,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,CAC5B,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAoC,EAAE,EAAE,CAAC,CAC9D,6CAEE,IAAI,EAAC,QAAQ,gBACD,KAAK,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,YAEnC,IAAI,GACE,CACV,CACF,CAAC;QACF,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE;gBACV,YAAY,EAAE,kBAAkB;gBAChC,UAAU,EAAE,gBAAgB;aAC7B;SACF,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IAAC,YAAY,EAAE,YAAY,YACzC,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,GACtB,GACc,CACnB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CACrC,wBAAwB,CACzB,CAAC;QACF,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,CACxC,sBAAsB,CACvB,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvE,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC1D,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACxD,IAAI,EAAE,SAAS;YACf,eAAe,EAAE,KAAK;YACtB,KAAK,EAAE,iBAAiB;SACzB,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CACrC,iCAAiC,CAClC,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,CAAC;QACjB,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAE5B,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxD,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,eAAe,IACd,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAClB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EACnB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,GAAG,EAAE;oBACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACzC,CAAC,GACD,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,CACJ,SAAS,CAAC,aAAa,CAAC,iCAAiC,CAAC,CAC3D,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/chat-history/index.d.ts

@@ -1,2 +1,4 @@
 export { ChatHistoryList, type ChatHistoryItem, type ChatHistoryListLabels, type ChatHistoryListProps, type ChatHistorySection, } from "./ChatHistoryList.js";
+export { ChatHistoryRail, DefaultChatHistoryRailView, type DefaultChatHistoryRailViewProps, type ChatHistoryRailLabels, type ChatHistoryRailProps, type ChatHistoryRailRenderContext, } from "./ChatHistoryRail.js";
+export { type ChatHistoryRailController, type ChatHistoryRailControllerLabels, type UseChatHistoryRailControllerOptions, useChatHistoryRailController, } from "./useChatHistoryRailController.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/chat-history/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-history/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-history/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,KAAK,+BAA+B,EACpC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EACpC,KAAK,mCAAmC,EACxC,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC"}

package/dist/chat-history/index.js

@@ -1,2 +1,4 @@
 export { ChatHistoryList, } from "./ChatHistoryList.js";
+export { ChatHistoryRail, DefaultChatHistoryRailView, } from "./ChatHistoryRail.js";
+export { useChatHistoryRailController, } from "./useChatHistoryRailController.js";
 //# sourceMappingURL=index.js.map

package/dist/chat-history/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat-history/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAKhB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat-history/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAKhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,0BAA0B,GAK3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC"}

package/dist/chat-history/useChatHistoryRailController.d.ts

@@ -0,0 +1,26 @@
+export interface ChatHistoryRailControllerLabels {
+    newChat: string;
+    showMore: string;
+    showLess: string;
+}
+export interface UseChatHistoryRailControllerOptions<Item> {
+    items: readonly Item[];
+    onNewChat: () => void;
+    labels: ChatHistoryRailControllerLabels;
+    previewCount?: number;
+    expandedCount?: number;
+}
+export interface ChatHistoryRailController<Item> {
+    expanded: boolean;
+    collapsedLimit: number;
+    expandedLimit: number;
+    visibleItems: Item[];
+    canExpand: boolean;
+    newChatLabel: string;
+    disclosureLabel: string;
+    onNewChat: () => void;
+    toggleExpanded: () => void;
+    resetExpanded: () => void;
+}
+export declare function useChatHistoryRailController<Item>({ items, onNewChat, labels, previewCount, expandedCount, }: UseChatHistoryRailControllerOptions<Item>): ChatHistoryRailController<Item>;
+//# sourceMappingURL=useChatHistoryRailController.d.ts.map

package/dist/chat-history/useChatHistoryRailController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatHistoryRailController.d.ts","sourceRoot":"","sources":["../../src/chat-history/useChatHistoryRailController.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mCAAmC,CAAC,IAAI;IACvD,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,EAAE,+BAA+B,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB,CAAC,IAAI;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAOD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,EACjD,KAAK,EACL,SAAS,EACT,MAAM,EACN,YAAY,EACZ,aAAa,GACd,EAAE,mCAAmC,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAmC7E"}

package/dist/chat-history/useChatHistoryRailController.js

@@ -0,0 +1,36 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+function normalizeLimit(value, fallback) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.floor(value));
+}
+export function useChatHistoryRailController({ items, onNewChat, labels, previewCount, expandedCount, }) {
+    const [expandedState, setExpandedState] = useState(false);
+    const collapsedLimit = normalizeLimit(previewCount, 5);
+    const expandedLimit = Math.max(collapsedLimit, normalizeLimit(expandedCount, 15));
+    const canExpand = items.length > collapsedLimit;
+    const expanded = canExpand && expandedState;
+    const visibleItems = useMemo(() => items.slice(0, expanded ? expandedLimit : collapsedLimit), [collapsedLimit, expanded, expandedLimit, items]);
+    useEffect(() => {
+        if (!canExpand)
+            setExpandedState(false);
+    }, [canExpand]);
+    const toggleExpanded = useCallback(() => {
+        if (canExpand)
+            setExpandedState((current) => !current);
+    }, [canExpand]);
+    const resetExpanded = useCallback(() => setExpandedState(false), []);
+    return {
+        expanded,
+        collapsedLimit,
+        expandedLimit,
+        visibleItems,
+        canExpand,
+        newChatLabel: labels.newChat,
+        disclosureLabel: expanded ? labels.showLess : labels.showMore,
+        onNewChat,
+        toggleExpanded,
+        resetExpanded,
+    };
+}
+//# sourceMappingURL=useChatHistoryRailController.js.map

package/dist/chat-history/useChatHistoryRailController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatHistoryRailController.js","sourceRoot":"","sources":["../../src/chat-history/useChatHistoryRailController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA6BlE,SAAS,cAAc,CAAC,KAAyB,EAAE,QAAgB;IACjE,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAO,EACjD,KAAK,EACL,SAAS,EACT,MAAM,EACN,YAAY,EACZ,aAAa,GAC6B;IAC1C,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,cAAc,EACd,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC,CAClC,CAAC;IACF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,IAAI,aAAa,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,EAC/D,CAAC,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CACjD,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,IAAI,SAAS;YAAE,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAChB,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAErE,OAAO;QACL,QAAQ;QACR,cAAc;QACd,aAAa;QACb,YAAY;QACZ,SAAS;QACT,YAAY,EAAE,MAAM,CAAC,OAAO;QAC5B,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ;QAC7D,SAAS;QACT,cAAc;QACd,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/chat-history/useChatHistoryRailController.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useChatHistoryRailController.spec.d.ts.map

package/dist/chat-history/useChatHistoryRailController.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatHistoryRailController.spec.d.ts","sourceRoot":"","sources":["../../src/chat-history/useChatHistoryRailController.spec.tsx"],"names":[],"mappings":""}

package/dist/chat-history/useChatHistoryRailController.spec.js

@@ -0,0 +1,101 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useChatHistoryRailController, } from "./useChatHistoryRailController.js";
+const labels = {
+    newChat: "New chat",
+    showMore: "Show more chats",
+    showLess: "Show fewer chats",
+};
+function makeItems(count) {
+    return Array.from({ length: count }, (_, index) => ({
+        id: `thread-${index + 1}`,
+    }));
+}
+describe("useChatHistoryRailController", () => {
+    let container;
+    let root;
+    let controller;
+    function Harness(props) {
+        controller = useChatHistoryRailController(props);
+        return null;
+    }
+    function render(options) {
+        const props = {
+            items: makeItems(20),
+            labels,
+            onNewChat: () => { },
+            ...options,
+        };
+        act(() => root.render(_jsx(Harness, { ...props })));
+    }
+    beforeEach(() => {
+        vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
+        container = document.createElement("div");
+        document.body.appendChild(container);
+        root = createRoot(container);
+    });
+    afterEach(() => {
+        act(() => root.unmount());
+        container.remove();
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    it("progressively discloses the default five and fifteen item limits", () => {
+        const items = makeItems(20);
+        render({ items });
+        expect(controller.expanded).toBe(false);
+        expect(controller.collapsedLimit).toBe(5);
+        expect(controller.expandedLimit).toBe(15);
+        expect(controller.visibleItems).toEqual(items.slice(0, 5));
+        expect(controller.canExpand).toBe(true);
+        expect(controller.disclosureLabel).toBe("Show more chats");
+        act(() => controller.toggleExpanded());
+        expect(controller.expanded).toBe(true);
+        expect(controller.visibleItems).toEqual(items.slice(0, 15));
+        expect(controller.disclosureLabel).toBe("Show fewer chats");
+    });
+    it("clamps finite limits while preserving legacy disclosure behavior", () => {
+        render({ previewCount: -2.5, expandedCount: 1.9 });
+        expect(controller.collapsedLimit).toBe(1);
+        expect(controller.expandedLimit).toBe(1);
+        expect(controller.visibleItems).toHaveLength(1);
+        expect(controller.canExpand).toBe(true);
+        act(() => controller.toggleExpanded());
+        expect(controller.expanded).toBe(true);
+    });
+    it("uses defaults for non-finite limits and never puts expanded below preview", () => {
+        render({
+            previewCount: Number.NaN,
+            expandedCount: Number.POSITIVE_INFINITY,
+        });
+        expect(controller.collapsedLimit).toBe(5);
+        expect(controller.expandedLimit).toBe(15);
+        render({ previewCount: 8, expandedCount: 3 });
+        expect(controller.collapsedLimit).toBe(8);
+        expect(controller.expandedLimit).toBe(8);
+    });
+    it("resets disclosure explicitly and when the collection becomes too short", () => {
+        render({});
+        act(() => controller.toggleExpanded());
+        expect(controller.expanded).toBe(true);
+        act(() => controller.resetExpanded());
+        expect(controller.expanded).toBe(false);
+        act(() => controller.toggleExpanded());
+        expect(controller.expanded).toBe(true);
+        render({ items: makeItems(3) });
+        expect(controller.expanded).toBe(false);
+        expect(controller.canExpand).toBe(false);
+        expect(controller.visibleItems).toHaveLength(3);
+    });
+    it("exposes view labels and the host new-chat action without UI assumptions", () => {
+        const onNewChat = vi.fn();
+        render({ onNewChat });
+        expect(controller.newChatLabel).toBe("New chat");
+        act(() => controller.onNewChat());
+        expect(onNewChat).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=useChatHistoryRailController.spec.js.map

package/dist/chat-history/useChatHistoryRailController.spec.js.map

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