@hachej/boring-core 0.1.52 → 0.1.54

package/dist/app/front/chatFirst/chatFirstPublicShell.css

@@ -267,3 +267,24 @@
   font-weight: 600;
   color: color-mix(in oklch, var(--foreground) 88%, transparent);
 }
+
+/* Optional marketing/nav links rendered beside the brand in the public top bar
+   (ChatFirstPublicShellOptions.navLinks). The authed workspace is unaffected. */
+.public-topbar-nav {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  margin-left: 0.75rem;
+}
+
+.public-topbar-nav a {
+  font-size: 0.8125rem;
+  font-weight: 500;
+  text-decoration: none;
+  color: color-mix(in oklch, var(--foreground) 65%, transparent);
+  transition: color 0.15s ease;
+}
+
+.public-topbar-nav a:hover {
+  color: var(--foreground);
+}

package/dist/app/front/index.d.ts

@@ -33,6 +33,15 @@ interface ChatFirstPublicShellOptions {
      * otherwise the fixed-position arrows overlay the open panel. Defaults to on.
      */
     showTeachingArrows?: boolean;
+    /**
+     * Marketing/navigation links rendered in the public (no-auth) top bar next to
+     * the brand — e.g. About, Pricing, Docs. The authenticated workspace top bar
+     * is unaffected. Use plain hrefs (router or full-page routes both work).
+     */
+    navLinks?: Array<{
+        label: string;
+        href: string;
+    }>;
 }
 
 type ChatEntryMode = 'auth-first' | 'chat-first';
@@ -57,7 +66,7 @@ interface CoreWorkspaceAgentFrontProps<TSession extends WorkspaceAgentSession =
 /** Default top-bar right content. Exported so apps can compose extra widgets
  * (e.g. a credit balance badge) alongside the user menu. */
 declare function DefaultTopBarRight(): react_jsx_runtime.JSX.Element;
-declare function CoreWorkspaceAgentFront<TSession extends WorkspaceAgentSession = WorkspaceAgentSession>({ authPages, cspNonce, children, workspaceRoute, workspaceIdParam, workspaceHref, loadingFallback, bootPreloadPaths, topBarLeft, topBarRight, appTitle, bridgeEndpoint, hotReload, chatEntryMode, chatFirstPublicShell, chatFirstPublicWorkspaceProps, publicPaths, ...workspaceProps }: CoreWorkspaceAgentFrontProps<TSession>): react_jsx_runtime.JSX.Element;
+declare function CoreWorkspaceAgentFront<TSession extends WorkspaceAgentSession = WorkspaceAgentSession>({ authPages, cspNonce, children, workspaceRoute, workspaceIdParam, workspaceHref, loadingFallback, bootPreloadPaths, topBarLeft, topBarRight, appTitle, bridgeEndpoint, fullPageBasePath, hotReload, chatEntryMode, chatFirstPublicShell, chatFirstPublicWorkspaceProps, publicPaths, ...workspaceProps }: CoreWorkspaceAgentFrontProps<TSession>): react_jsx_runtime.JSX.Element;
 
 interface CreditBalanceBadgeProps {
     /** Base URL for the credits API (default: same origin). */

package/dist/app/front/index.js

@@ -9,7 +9,7 @@ import {
   useSignIn,
   useSignUp,
   useWorkspaceRouteStatus
-} from "../../chunk-2ZTKRLVG.js";
+} from "../../chunk-Q53N4QUK.js";
 import "../../chunk-HYNKZSTF.js";
 import {
   isRuntimeEmailVerificationEnabled
@@ -20,8 +20,13 @@ import "../../chunk-MLKGABMK.js";
 // src/app/front/CoreWorkspaceAgentFront.tsx
 import { useEffect as useEffect3, useMemo, useState as useState3 } from "react";
 import { Navigate, Route, useLocation as useLocation2, useParams } from "react-router-dom";
+import { WorkspaceProvider } from "@hachej/boring-workspace";
+import { ErrorState } from "@hachej/boring-ui-kit";
 import {
-  WorkspaceAgentFront as WorkspaceAgentFront2
+  parseFullPagePanelLocation,
+  WorkspaceAgentFront as WorkspaceAgentFront2,
+  WorkspaceBootGate,
+  WorkspaceFullPagePanel
 } from "@hachej/boring-workspace/app/front";
 
 // src/app/front/chatFirst/ChatFirstAuthenticatedShell.tsx
@@ -420,7 +425,8 @@ function ChatFirstPublicShell({
                 children: (appTitle?.[0] ?? "B").toUpperCase()
               }
             ),
-            /* @__PURE__ */ jsx4("span", { className: "truncate text-[13px] font-medium leading-none tracking-tight text-foreground", children: appTitle })
+            /* @__PURE__ */ jsx4("span", { className: "truncate text-[13px] font-medium leading-none tracking-tight text-foreground", children: appTitle }),
+            publicShell?.navLinks?.length ? /* @__PURE__ */ jsx4("nav", { className: "public-topbar-nav", "aria-label": "Site", children: publicShell.navLinks.map((link) => /* @__PURE__ */ jsx4("a", { href: link.href, children: link.label }, link.href)) }) : null
           ] }),
           className: workspaceProps.className,
           surfaceButtonBottomOffset: 456,
@@ -503,6 +509,7 @@ import { Fragment as Fragment3, jsx as jsx5, jsxs as jsxs4 } from "react/jsx-run
 installVitePreloadRecovery();
 var DEFAULT_WORKSPACE_ROUTE = "/workspace/:id";
 var DEFAULT_WORKSPACE_ID_PARAM = "id";
+var DEFAULT_FULL_PAGE_BASE_PATH = "/full-page";
 function DefaultTopBarRight() {
   return /* @__PURE__ */ jsx5(UserMenu, {});
 }
@@ -689,6 +696,10 @@ function WorkspaceRoute({
     () => ({ ...resolvedWorkspaceProps.authHeaders, "x-boring-workspace-id": workspaceId }),
     [workspaceId, resolvedWorkspaceProps.authHeaders]
   );
+  const scopedFullPageBasePath = useMemo(
+    () => resolvedWorkspaceProps.fullPageBasePath ? withWorkspaceIdSearch(resolvedWorkspaceProps.fullPageBasePath, workspaceId) : void 0,
+    [resolvedWorkspaceProps.fullPageBasePath, workspaceId]
+  );
   if (!workspaceId) return /* @__PURE__ */ jsx5(Fragment3, { children: resolvedLoadingFallback });
   if (!session.data?.user && chatEntryMode === "chat-first") {
     return /* @__PURE__ */ jsx5(
@@ -736,6 +747,7 @@ function WorkspaceRoute({
       workspaceLabel: resolvedWorkspaceProps.workspaceLabel ?? currentWorkspace.name,
       requestHeaders,
       authHeaders,
+      fullPageBasePath: scopedFullPageBasePath,
       chatParams,
       bootPreloadPaths,
       frontPluginHotReload: false,
@@ -745,6 +757,110 @@ function WorkspaceRoute({
     workspaceId
   );
 }
+function fullPageRoutePath(basePath) {
+  const path = basePath.split(/[?#]/, 1)[0]?.trim();
+  return path || DEFAULT_FULL_PAGE_BASE_PATH;
+}
+function workspaceIdFromFullPageSearch(search) {
+  const workspaceId = new URLSearchParams(search).get("workspaceId")?.trim();
+  return workspaceId || null;
+}
+function withWorkspaceIdSearch(basePath, workspaceId) {
+  const [pathWithSearch, hash = ""] = basePath.split("#", 2);
+  const [path, rawSearch = ""] = pathWithSearch.split("?", 2);
+  const search = new URLSearchParams(rawSearch);
+  search.set("workspaceId", workspaceId);
+  return `${path}?${search.toString()}${hash ? `#${hash}` : ""}`;
+}
+function scopedWorkspaceHeaders(workspaceId, headers) {
+  return { ...headers ?? {}, "x-boring-workspace-id": workspaceId };
+}
+function FullPageRouteErrorPage({ code, title, description }) {
+  return /* @__PURE__ */ jsx5(
+    "div",
+    {
+      className: "flex min-h-screen items-center justify-center bg-background p-6 text-foreground",
+      "data-testid": "full-page-error-state",
+      "data-full-page-error-code": code,
+      children: /* @__PURE__ */ jsx5(ErrorState, { className: "w-full max-w-lg", title, description })
+    }
+  );
+}
+function CoreFullPagePanelRoute({
+  fullPageBasePath,
+  loadingFallback,
+  bootPreloadPaths,
+  workspaceProps,
+  appTitle
+}) {
+  const location = useLocation2();
+  const parsed = useMemo(() => parseFullPagePanelLocation(location.search), [location.search]);
+  const currentWorkspace = useCurrentWorkspace();
+  const workspaceId = workspaceIdFromFullPageSearch(location.search) ?? currentWorkspace?.id ?? "";
+  const scopedFullPageBasePath = workspaceId ? withWorkspaceIdSearch(fullPageBasePath, workspaceId) : fullPageBasePath;
+  const requestHeaders = workspaceId ? scopedWorkspaceHeaders(workspaceId, workspaceProps.requestHeaders) : workspaceProps.requestHeaders;
+  const authHeaders = workspaceId ? scopedWorkspaceHeaders(workspaceId, { ...workspaceProps.requestHeaders ?? {}, ...workspaceProps.authHeaders ?? {} }) : { ...workspaceProps.requestHeaders ?? {}, ...workspaceProps.authHeaders ?? {} };
+  if (parsed.error || !parsed.componentId) {
+    return /* @__PURE__ */ jsx5(
+      FullPageRouteErrorPage,
+      {
+        code: parsed.error?.code ?? "FULL_PAGE_PANEL_MISSING_COMPONENT",
+        title: "Invalid full-page panel route",
+        description: parsed.error?.message ?? "Missing full-page panel component id."
+      }
+    );
+  }
+  if (!workspaceId) {
+    return /* @__PURE__ */ jsx5(Fragment3, { children: loadingFallback ?? /* @__PURE__ */ jsx5(
+      FullPageRouteErrorPage,
+      {
+        code: "FULL_PAGE_PANEL_MISSING_WORKSPACE",
+        title: "Workspace unavailable",
+        description: "The full-page panel route needs a workspace id. Open it from a workspace or include workspaceId in the URL."
+      }
+    ) });
+  }
+  return /* @__PURE__ */ jsx5(
+    WorkspaceProvider,
+    {
+      chatPanel: workspaceProps.chatPanel,
+      plugins: workspaceProps.plugins,
+      excludeDefaults: workspaceProps.excludeDefaults,
+      panels: workspaceProps.panels,
+      commands: workspaceProps.commands,
+      catalogs: workspaceProps.catalogs,
+      capabilities: workspaceProps.capabilities,
+      apiBaseUrl: workspaceProps.apiBaseUrl,
+      authHeaders,
+      apiTimeout: workspaceProps.apiTimeout,
+      defaultTheme: workspaceProps.defaultTheme,
+      onThemeChange: workspaceProps.onThemeChange,
+      workspaceId,
+      workspaceLabel: currentWorkspace?.id === workspaceId ? currentWorkspace.name : workspaceProps.workspaceLabel,
+      appTitle,
+      storageKey: workspaceProps.providerStorageKey ?? `boring-ui-v2:layout:${workspaceId}`,
+      persistenceEnabled: workspaceProps.persistenceEnabled,
+      manageDocumentTitle: false,
+      bridgeEndpoint: null,
+      onAuthError: workspaceProps.onAuthError,
+      onOpenFile: workspaceProps.onOpenFile,
+      debug: workspaceProps.debug,
+      frontPluginHotReload: false,
+      fullPageBasePath: scopedFullPageBasePath,
+      children: /* @__PURE__ */ jsx5(
+        WorkspaceBootGate,
+        {
+          workspaceId,
+          requestHeaders,
+          apiBaseUrl: workspaceProps.apiBaseUrl,
+          preloadPaths: bootPreloadPaths,
+          provisionWorkspace: workspaceProps.provisionWorkspace,
+          children: /* @__PURE__ */ jsx5(WorkspaceFullPagePanel, { componentId: parsed.componentId, params: parsed.params })
+        }
+      )
+    }
+  );
+}
 function chatFirstPublicPaths(workspaceRoute) {
   return Array.from(/* @__PURE__ */ new Set(["/", workspaceRoute, "/workspace/:id", "/w/:id"]));
 }
@@ -761,6 +877,7 @@ function CoreWorkspaceAgentFront({
   topBarRight = /* @__PURE__ */ jsx5(DefaultTopBarRight, {}),
   appTitle,
   bridgeEndpoint = "/api/v1/ui",
+  fullPageBasePath = DEFAULT_FULL_PAGE_BASE_PATH,
   hotReload = false,
   chatEntryMode = "auth-first",
   chatFirstPublicShell,
@@ -775,7 +892,8 @@ function CoreWorkspaceAgentFront({
   }
   const routedWorkspaceProps = {
     ...workspaceProps,
-    bridgeEndpoint
+    bridgeEndpoint,
+    fullPageBasePath
   };
   return /* @__PURE__ */ jsxs4(
     CoreFront,
@@ -828,6 +946,22 @@ function CoreWorkspaceAgentFront({
             )
           }
         ),
+        /* @__PURE__ */ jsx5(
+          Route,
+          {
+            path: fullPageRoutePath(fullPageBasePath),
+            element: /* @__PURE__ */ jsx5(
+              CoreFullPagePanelRoute,
+              {
+                fullPageBasePath,
+                loadingFallback,
+                bootPreloadPaths,
+                workspaceProps: routedWorkspaceProps,
+                appTitle
+              }
+            )
+          }
+        ),
         children
       ]
     }

package/dist/{chunk-2ZTKRLVG.js → chunk-Q53N4QUK.js}

@@ -1463,15 +1463,25 @@ function SettingsTopBar() {
       className: "relative flex h-[52px] items-center justify-between gap-3 border-b border-border/40 bg-background px-4",
       "aria-label": "App top bar",
       children: /* @__PURE__ */ jsxs6("div", { className: "flex min-w-0 flex-1 items-center gap-2.5", children: [
-        /* @__PURE__ */ jsx13(
-          "div",
+        /* @__PURE__ */ jsxs6(
+          "a",
           {
-            "aria-hidden": "true",
-            className: "flex h-7 w-7 shrink-0 items-center justify-center rounded-md bg-foreground text-[12px] font-semibold text-background",
-            children: appInitial
+            href: "/",
+            "aria-label": `${appTitle} home`,
+            className: "flex min-w-0 items-center gap-2.5 rounded-md outline-none transition-opacity hover:opacity-80 focus-visible:ring-2 focus-visible:ring-ring",
+            children: [
+              /* @__PURE__ */ jsx13(
+                "div",
+                {
+                  "aria-hidden": "true",
+                  className: "flex h-7 w-7 shrink-0 items-center justify-center rounded-md bg-foreground text-[12px] font-semibold text-background",
+                  children: appInitial
+                }
+              ),
+              /* @__PURE__ */ jsx13("span", { className: "truncate text-[13px] font-medium tracking-tight text-foreground", children: appTitle })
+            ]
           }
         ),
-        /* @__PURE__ */ jsx13("span", { className: "truncate text-[13px] font-medium tracking-tight text-foreground", children: appTitle }),
         /* @__PURE__ */ jsx13("span", { "aria-hidden": "true", className: "text-muted-foreground/30", children: "/" }),
         /* @__PURE__ */ jsx13("span", { className: "truncate text-[13px] text-muted-foreground", children: "Account settings" })
       ] })

package/dist/front/index.js

@@ -58,7 +58,7 @@ import {
   useWorkspaceMembers,
   useWorkspaceRole,
   useWorkspaceRouteStatus
-} from "../chunk-2ZTKRLVG.js";
+} from "../chunk-Q53N4QUK.js";
 import {
   TopBarSlotProvider,
   useTopBarSlot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-core",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "type": "module",
   "license": "MIT",
   "description": "Foundation package for boring-ui-v2 apps: DB, auth, config, HTTP app factory, and frontend app shell.",
@@ -79,9 +79,9 @@
     "react-router-dom": "^7.14.2",
     "smol-toml": "^1.6.1",
     "zod": "^3.25.76",
-    "@hachej/boring-agent": "0.1.52",
-    "@hachej/boring-workspace": "0.1.52",
-    "@hachej/boring-ui-kit": "0.1.52"
+    "@hachej/boring-ui-kit": "0.1.54",
+    "@hachej/boring-workspace": "0.1.54",
+    "@hachej/boring-agent": "0.1.54"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",