@firstlovecenter/ai-chat 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to `@firstlovecenter/ai-chat` are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.1] — 2026-05-09
+
+Lets a host mount multiple chat surfaces side-by-side without yanking users between shells.
+
+### Added
+
+- **`AiChatProps.basePath`** (`string`, optional, default `'/chat'`) — URL prefix the chat surface is mounted at. Sidebar `<Link>` entries resolve to `${basePath}/${sessionId}`, `+ New chat` pushes `${basePath}?new`, and the open-session router push uses the same prefix. Both `AiChat` and `VercelChat` honour it.
+
+### Migration notes
+
+- Pure addition — `basePath` defaults to `/chat`, so existing `/chat`-mounted surfaces work unchanged.
+- Hosts that want a second surface (e.g. an admin AI page at `/admin/ai`) need to (a) pass `basePath="/admin/ai"`, (b) add a matching dynamic segment (`/admin/ai/[id]`) so reload/bookmark URLs resolve, and (c) wire a redirect-to-most-recent at the basePath that respects `?new`.
+- **Tailwind v4 hosts**: the package ships no CSS, so its component classes need to be in your Tailwind content scan. Add `@source "../node_modules/@firstlovecenter/ai-chat";` to your `globals.css` (path relative to the CSS file). Without this, the in-chat sidebar's `absolute`/`translate-x-*`/`bg-sidebar` classes are stripped from the production bundle and the sidebar renders as a static flex column instead of an overlay.
+
 ## [0.9.0] — 2026-05-09
 
 Chat session and message identifiers are now short URL-safe UIDs (12 chars) instead of auto-incrementing BIGINTs. URLs like `/chat/V1StGXR8_Z5j` don't leak per-user chat counts and are unguessable, which matters as soon as a session URL is ever shared.

package/dist/ui/index.cjs

@@ -678,7 +678,8 @@ function AiChat({
   userFirstName,
   scopeLabel,
   initialProvider,
-  initialSessionId = null
+  initialSessionId = null,
+  basePath = "/chat"
 }) {
   const router = navigation.useRouter();
   const [sessions, setSessions] = React.useState([]);
@@ -768,16 +769,16 @@ function AiChat({
   }, []);
   const syncUrl = React.useCallback(
     (id) => {
-      router.push(id == null ? "/chat" : `/chat/${id}`);
+      router.push(id == null ? basePath : `${basePath}/${id}`);
     },
-    [router]
+    [router, basePath]
   );
   const newChat = React.useCallback(() => {
     setActiveSessionId(null);
     setAnswers([]);
     setQuestion("");
-    router.push("/chat?new");
-  }, [router]);
+    router.push(`${basePath}?new`);
+  }, [router, basePath]);
   const changeProvider = React.useCallback(
     async (next) => {
       if (next === provider || providerSaving) return;
@@ -1030,7 +1031,7 @@ function AiChat({
               /* @__PURE__ */ jsxRuntime.jsx(
                 Link__default.default,
                 {
-                  href: `/chat/${s.id}`,
+                  href: `${basePath}/${s.id}`,
                   onClick: () => setSidebarOpen(false),
                   className: cn(
                     "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm",
@@ -1513,7 +1514,8 @@ function VercelChat({
   userFirstName,
   scopeLabel,
   initialProvider,
-  initialSessionId = null
+  initialSessionId = null,
+  basePath = "/chat"
 }) {
   const router = navigation.useRouter();
   const [sessions, setSessions] = React.useState([]);
@@ -1744,9 +1746,9 @@ function VercelChat({
   }, [answers.length]);
   const syncUrl = React.useCallback(
     (id) => {
-      router.push(id == null ? "/chat" : `/chat/${id}`);
+      router.push(id == null ? basePath : `${basePath}/${id}`);
     },
-    [router]
+    [router, basePath]
   );
   const newChat = React.useCallback(() => {
     setActiveSessionId(null);
@@ -1756,8 +1758,8 @@ function VercelChat({
     setHydratedErrors({});
     setStartedAt({});
     setInput("");
-    router.push("/chat?new");
-  }, [setMessages, setInput, router]);
+    router.push(`${basePath}?new`);
+  }, [setMessages, setInput, router, basePath]);
   const changeProvider = React.useCallback(
     async (next) => {
       if (next === provider || providerSaving) return;
@@ -1987,7 +1989,7 @@ function VercelChat({
               /* @__PURE__ */ jsxRuntime.jsx(
                 Link__default.default,
                 {
-                  href: `/chat/${s.id}`,
+                  href: `${basePath}/${s.id}`,
                   onClick: () => setSidebarOpen(false),
                   className: cn(
                     "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm",