radiant-docs 0.1.40 → 0.1.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radiant-docs",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "CLI tool for previewing Radiant documentation locally",
   "type": "module",
   "bin": {

package/template/package.json

@@ -6,10 +6,10 @@
     "dev": "astro dev",
     "start": "tsx runner.ts",
     "prebuild": "rm -rf public/pagefind",
-    "build": "astro build && node scripts/generate-og-metadata.mjs && node scripts/generate-og-images.mjs && node scripts/stamp-og-image-versions.mjs && node scripts/stamp-image-versions.mjs && pagefind --site dist && node scripts/stamp-pagefind-runtime-version.mjs && node scripts/generate-proxy-allowed-origins.mjs && node scripts/generate-robots-txt.mjs",
+    "build": "astro build && node scripts/remove-assistant-for-non-pro.mjs && node scripts/generate-og-metadata.mjs && node scripts/generate-og-images.mjs && node scripts/stamp-og-image-versions.mjs && node scripts/stamp-image-versions.mjs && pagefind --site dist && node scripts/stamp-pagefind-runtime-version.mjs && node scripts/generate-proxy-allowed-origins.mjs && node scripts/generate-robots-txt.mjs",
     "preview": "astro preview",
     "astro": "astro",
-    "search:index": "astro build && node scripts/generate-og-metadata.mjs && node scripts/generate-og-images.mjs && node scripts/stamp-og-image-versions.mjs && node scripts/stamp-image-versions.mjs && pagefind --site dist && node scripts/stamp-pagefind-runtime-version.mjs && node scripts/generate-proxy-allowed-origins.mjs && node scripts/generate-robots-txt.mjs && cp -r dist/pagefind public/"
+    "search:index": "astro build && node scripts/remove-assistant-for-non-pro.mjs && node scripts/generate-og-metadata.mjs && node scripts/generate-og-images.mjs && node scripts/stamp-og-image-versions.mjs && node scripts/stamp-image-versions.mjs && pagefind --site dist && node scripts/stamp-pagefind-runtime-version.mjs && node scripts/generate-proxy-allowed-origins.mjs && node scripts/generate-robots-txt.mjs && cp -r dist/pagefind public/"
   },
   "dependencies": {
     "@alpinejs/collapse": "^3.15.2",

package/template/public/favicon.svg

@@ -1,9 +1,17 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 128 128">
-    <path d="M50.4 78.5a75.1 75.1 0 0 0-28.5 6.9l24.2-65.7c.7-2 1.9-3.2 3.4-3.2h29c1.5 0 2.7 1.2 3.4 3.2l24.2 65.7s-11.6-7-28.5-7L67 45.5c-.4-1.7-1.6-2.8-2.9-2.8-1.3 0-2.5 1.1-2.9 2.7L50.4 78.5Zm-1.1 28.2Zm-4.2-20.2c-2 6.6-.6 15.8 4.2 20.2a17.5 17.5 0 0 1 .2-.7 5.5 5.5 0 0 1 5.7-4.5c2.8.1 4.3 1.5 4.7 4.7.2 1.1.2 2.3.2 3.5v.4c0 2.7.7 5.2 2.2 7.4a13 13 0 0 0 5.7 4.9v-.3l-.2-.3c-1.8-5.6-.5-9.5 4.4-12.8l1.5-1a73 73 0 0 0 3.2-2.2 16 16 0 0 0 6.8-11.4c.3-2 .1-4-.6-6l-.8.6-1.6 1a37 37 0 0 1-22.4 2.7c-5-.7-9.7-2-13.2-6.2Z" />
-    <style>
-        path { fill: #000; }
-        @media (prefers-color-scheme: dark) {
-            path { fill: #FFF; }
-        }
-    </style>
+<svg
+  fill="none"
+  height="48"
+  viewBox="0 0 32 48"
+  width="48"
+  xmlns="http://www.w3.org/2000/svg"
+>
+  <path
+    d="m18.6667 30.6667c7.3638 0 13.3333-5.9696 13.3333-13.3334 0-7.36376-5.9695-13.3333-13.3333-13.3333h-18.6667v26.6667z"
+    fill="#ff692e"
+  />
+  <path d="m0 4 32 40h-21.3333l-10.6667-13.3333z" fill="#2e90fa" />
+  <path
+    d="m21.1488 30.436c-.8042.1515-1.6339.2307-2.4821.2307h-18.6667v-26.6667z"
+    fill="#53b1fd"
+  />
 </svg>

package/template/scripts/remove-assistant-for-non-pro.mjs

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const FRAMEWORK_DIR = path.resolve(__dirname, "..");
+const ASSISTANT_DIST_DIR = path.join(FRAMEWORK_DIR, "dist", "-", "assistant");
+
+function getOrgTier() {
+  const parsedTier = Number.parseInt((process.env.ORG_TIER ?? "1").trim(), 10);
+  return Number.isFinite(parsedTier) && parsedTier > 0 ? parsedTier : 1;
+}
+
+const orgTier = getOrgTier();
+
+if (orgTier >= 3) {
+  console.log("Assistant embed retained for Pro tier build.");
+  process.exit(0);
+}
+
+if (!fs.existsSync(ASSISTANT_DIST_DIR)) {
+  console.log("Assistant embed cleanup skipped: assistant output not found.");
+  process.exit(0);
+}
+
+fs.rmSync(ASSISTANT_DIST_DIR, { recursive: true, force: true });
+console.log("Assistant embed removed for non-Pro tier build.");

package/template/src/components/Header.astro

@@ -18,7 +18,7 @@ const config = await getConfig();
   class:list={[
     "fixed z-30 top-1 inset-x-1 shadow-[0px_-20px_0px_20px_var(--background-dark)] h-16 border-x border-t border-border rounded-t-2xl overflow-hidden border-b bg-background border-b-border-light",
     config.navbar?.blur &&
-      "sm:bg-background/80 sm:backdrop-blur-[18px] sm:backdrop-saturate-50 sm:border-b-neutral-100/85 sm:dark:border-neutral-800/85 sm:bg-clip-padding",
+      "sm:bg-background/85 sm:backdrop-blur-[18px] sm:backdrop-saturate-50 sm:border-b-neutral-100/85 sm:dark:border-neutral-800/85 sm:bg-clip-padding",
   ]}
   data-pagefind-ignore
   data-vaul-scale-chrome
@@ -60,7 +60,7 @@ const config = await getConfig();
               <button
                 type="button"
                 class="hidden md:inline-flex items-center gap-2 h-8 rounded-lg [corner-shape:superellipse(1.2)] bg-linear-to-b from-[var(--color-theme-top)] to-[var(--color-theme-bottom)] px-3 text-[13px] font-[350] text-[var(--color-theme-foreground)] shadow-sm hover:opacity-95 cursor-pointer"
-                onclick="window.dispatchEvent(new CustomEvent('ask-ai:open'));"
+                onclick="window.__assistantOpenRequested = true; window.dispatchEvent(new CustomEvent('ask-ai:open'));"
               >
                 <img
                   src={sparkleIcon}

package/template/src/components/chat/AssistantDocsWidget.astro

@@ -0,0 +1,16 @@
+---
+import AssistantDocsWidget from "./AssistantDocsWidget";
+import { getAssistantPanelRuntimeConfig } from "../../lib/assistant-panel-config";
+import { getConfig } from "../../lib/validation";
+
+const config = await getConfig();
+const assistantConfig = getAssistantPanelRuntimeConfig(config);
+---
+
+<div data-pagefind-ignore>
+  <AssistantDocsWidget
+    client:only="preact"
+    transition:persist="assistant-docs-widget"
+    {...assistantConfig}
+  />
+</div>

package/template/src/components/chat/AssistantDocsWidget.tsx

@@ -0,0 +1,402 @@
+import type { JSX } from "preact";
+import { useEffect, useState } from "preact/hooks";
+import AssistantEmbedPanel, { AssistantPanelIcon } from "./AssistantEmbedPanel";
+import {
+  DEFAULT_ASSISTANT_CHROME_CONFIG,
+  type AssistantChromeConfig,
+} from "../../lib/assistant-chrome-defaults";
+
+type AssistantDocsWidgetProps = {
+  apiPath: string;
+  docsTitle: string;
+  isChatAvailable: boolean;
+  canSendChatRequest: boolean;
+  launcherThemeColor?: string;
+  launcherThemeColors?: {
+    light: string;
+    dark: string;
+  };
+  launcherIconColor?: string;
+  launcherIconColors?: {
+    light: string;
+    dark: string;
+  };
+  launcherIconImageSrc?: string;
+  emptyStateHeading?: string;
+  emptyStateQuestions?: string[];
+  devProxyToken?: string;
+  chrome?: AssistantChromeConfig;
+};
+
+type AssistantOpenRequestWindow = Window & {
+  __assistantOpenRequested?: boolean;
+};
+
+export default function AssistantDocsWidget({
+  apiPath,
+  docsTitle,
+  isChatAvailable,
+  canSendChatRequest,
+  launcherThemeColor,
+  launcherThemeColors,
+  launcherIconColor,
+  launcherIconColors,
+  launcherIconImageSrc,
+  emptyStateHeading,
+  emptyStateQuestions,
+  devProxyToken,
+  chrome,
+}: AssistantDocsWidgetProps) {
+  const [isOpen, setIsOpen] = useState(false);
+  const [openSignal, setOpenSignal] = useState(0);
+  const chromeConfig = chrome ?? DEFAULT_ASSISTANT_CHROME_CONFIG;
+  const numericZIndex =
+    Number.parseInt(chromeConfig.zIndex, 10) ||
+    Number.parseInt(DEFAULT_ASSISTANT_CHROME_CONFIG.zIndex, 10);
+  const launcherThemeColorLight =
+    launcherThemeColors?.light ?? launcherThemeColor ?? "#171717";
+  const launcherThemeColorDark =
+    launcherThemeColors?.dark ?? launcherThemeColor ?? "#171717";
+  const launcherIconColorLight =
+    launcherIconColors?.light ?? launcherIconColor ?? "#ffffff";
+  const launcherIconColorDark =
+    launcherIconColors?.dark ?? launcherIconColor ?? "#ffffff";
+  const rootStyle = {
+    "--assistant-docs-theme-light": launcherThemeColorLight,
+    "--assistant-docs-theme-dark": launcherThemeColorDark,
+    "--assistant-docs-icon-color-light": launcherIconColorLight,
+    "--assistant-docs-icon-color-dark": launcherIconColorDark,
+    "--assistant-docs-z-index": String(numericZIndex),
+    "--assistant-docs-launcher-z-index": String(numericZIndex + 1),
+    "--assistant-docs-mobile-panel-z-index": String(numericZIndex + 2),
+    "--assistant-docs-offset-x": chromeConfig.offsetX,
+    "--assistant-docs-offset-y": chromeConfig.offsetY,
+    "--assistant-docs-mobile-offset-x": chromeConfig.mobileOffsetX,
+    "--assistant-docs-mobile-offset-y": chromeConfig.mobileOffsetY,
+    "--assistant-docs-launcher-size": chromeConfig.launcherSize,
+    "--assistant-docs-launcher-icon-size": chromeConfig.launcherIconSize,
+    "--assistant-docs-launcher-shadow": chromeConfig.launcherShadow,
+    "--assistant-docs-panel-width": chromeConfig.panelWidth,
+    "--assistant-docs-panel-height": chromeConfig.panelHeight,
+    "--assistant-docs-panel-gap": chromeConfig.panelGap,
+    "--assistant-docs-panel-radius": chromeConfig.panelRadius,
+    "--assistant-docs-panel-border": chromeConfig.panelBorder,
+    "--assistant-docs-panel-background": chromeConfig.panelBackground,
+    "--assistant-docs-panel-dark-border": chromeConfig.panelDarkBorder,
+    "--assistant-docs-panel-dark-background": chromeConfig.panelDarkBackground,
+    "--assistant-docs-panel-backdrop-blur": chromeConfig.panelBackdropBlur,
+    "--assistant-docs-panel-shadow": chromeConfig.panelShadow,
+    "--assistant-docs-panel-dark-shadow": chromeConfig.panelDarkShadow,
+    "--assistant-docs-panel-open-scale": chromeConfig.panelOpenScale,
+    "--assistant-docs-panel-open-duration": chromeConfig.panelOpenDuration,
+    "--assistant-docs-panel-open-timing": chromeConfig.panelOpenTiming,
+    "--assistant-docs-panel-close-duration": chromeConfig.panelCloseDuration,
+    "--assistant-docs-panel-close-timing": chromeConfig.panelCloseTiming,
+  } as JSX.CSSProperties;
+
+  const openPanel = () => {
+    setIsOpen((wasOpen) => {
+      if (!wasOpen) {
+        setOpenSignal((previous) => previous + 1);
+      }
+      return true;
+    });
+  };
+
+  const closePanel = () => {
+    setIsOpen(false);
+  };
+
+  useEffect(() => {
+    const handleOpen = () => {
+      (window as AssistantOpenRequestWindow).__assistantOpenRequested = false;
+      openPanel();
+    };
+
+    window.addEventListener("ask-ai:open", handleOpen);
+    if ((window as AssistantOpenRequestWindow).__assistantOpenRequested) {
+      handleOpen();
+    }
+
+    return () => {
+      window.removeEventListener("ask-ai:open", handleOpen);
+    };
+  }, []);
+
+  return (
+    <div
+      data-pagefind-ignore
+      className="assistant-docs-widget"
+      data-side={chromeConfig.side}
+      style={rootStyle}
+    >
+      <div
+        className="assistant-docs-panel-shell"
+        data-state={isOpen ? "open" : "closed"}
+      >
+        <AssistantEmbedPanel
+          apiPath={apiPath}
+          docsTitle={docsTitle}
+          isChatAvailable={isChatAvailable}
+          canSendChatRequest={canSendChatRequest}
+          launcherThemeColor={launcherThemeColor}
+          launcherThemeColors={launcherThemeColors}
+          launcherIconColor={launcherIconColor}
+          launcherIconColors={launcherIconColors}
+          launcherIconImageSrc={launcherIconImageSrc}
+          emptyStateHeading={emptyStateHeading}
+          emptyStateQuestions={emptyStateQuestions}
+          devProxyToken={devProxyToken}
+          panelSurface="inline"
+          linkTarget="current"
+          allowApiPathQueryOverride={false}
+          openSignal={openSignal}
+          onRequestClose={closePanel}
+        />
+      </div>
+
+      <button
+        type="button"
+        className="assistant-docs-launcher"
+        data-open={String(isOpen)}
+        onClick={() => {
+          if (isOpen) {
+            closePanel();
+            return;
+          }
+          openPanel();
+        }}
+        aria-label={isOpen ? "Close chat" : "Open chat"}
+        title={isOpen ? "Close chat" : "Open chat"}
+      >
+        <AssistantPanelIcon
+          color={launcherIconColor}
+          imageSrc={launcherIconImageSrc}
+          className="assistant-docs-launcher-icon assistant-docs-launcher-mark"
+        />
+        <svg
+          className="assistant-docs-launcher-icon assistant-docs-launcher-chevron"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="currentColor"
+          strokeWidth="2.4"
+          strokeLinecap="round"
+          strokeLinejoin="round"
+          aria-hidden="true"
+        >
+          <path d="m6 9 6 6 6-6" />
+        </svg>
+      </button>
+
+      <style>{`
+        @keyframes assistant-docs-launcher-enter {
+          0% {
+            opacity: 0;
+            transform: translateY(3px) scale(.96);
+          }
+          46% {
+            opacity: 1;
+            transform: translateY(0) scale(1.012);
+          }
+          72% {
+            opacity: 1;
+            transform: translateY(0) scale(.998);
+          }
+          100% {
+            opacity: 1;
+            transform: translateY(0) scale(1);
+          }
+        }
+
+        .assistant-docs-launcher {
+          --assistant-docs-theme: var(--assistant-docs-theme-light);
+          --assistant-docs-icon-color: var(--assistant-docs-icon-color-light);
+          position: fixed;
+          bottom: var(--assistant-docs-offset-y);
+          z-index: var(--assistant-docs-launcher-z-index);
+          display: inline-flex;
+          width: var(--assistant-docs-launcher-size);
+          height: var(--assistant-docs-launcher-size);
+          align-items: center;
+          justify-content: center;
+          padding: 0;
+          border: 0;
+          border-radius: 999px;
+          color: var(--assistant-docs-icon-color);
+          background: linear-gradient(
+            to bottom,
+            color-mix(in oklab, var(--assistant-docs-theme) 88%, white),
+            color-mix(in oklab, var(--assistant-docs-theme) 90%, black)
+          );
+          box-shadow: var(--assistant-docs-launcher-shadow);
+          cursor: pointer;
+          animation: assistant-docs-launcher-enter 460ms linear backwards;
+          transition: transform 180ms ease, opacity 160ms ease;
+          transform-origin: center center;
+        }
+
+        html.dark .assistant-docs-launcher,
+        html[data-theme="dark"] .assistant-docs-launcher {
+          --assistant-docs-theme: var(--assistant-docs-theme-dark);
+          --assistant-docs-icon-color: var(--assistant-docs-icon-color-dark);
+        }
+
+        .assistant-docs-widget[data-side="right"] .assistant-docs-launcher {
+          right: var(--assistant-docs-offset-x);
+        }
+
+        .assistant-docs-widget[data-side="left"] .assistant-docs-launcher {
+          left: var(--assistant-docs-offset-x);
+        }
+
+        .assistant-docs-launcher:hover {
+          opacity: .96;
+          transform: translateY(-1px) scale(1.03);
+        }
+
+        .assistant-docs-launcher:active {
+          transform: translateY(0) scale(.96);
+        }
+
+        .assistant-docs-launcher-icon {
+          position: absolute;
+          width: var(--assistant-docs-launcher-icon-size);
+          height: var(--assistant-docs-launcher-icon-size);
+          pointer-events: none;
+          transform-origin: center;
+          transition: opacity 150ms ease,
+            transform 180ms cubic-bezier(.2, .8, .2, 1);
+        }
+
+        .assistant-docs-launcher-icon img,
+        .assistant-docs-launcher-icon svg {
+          display: block;
+          width: 100%;
+          height: 100%;
+          object-fit: contain;
+        }
+
+        .assistant-docs-launcher-mark {
+          opacity: 1;
+          transform: scale(1);
+        }
+
+        .assistant-docs-launcher-chevron {
+          opacity: 0;
+          transform: scale(.55);
+        }
+
+        .assistant-docs-launcher[data-open="true"] .assistant-docs-launcher-mark {
+          opacity: 0;
+          transform: scale(.55);
+        }
+
+        .assistant-docs-launcher[data-open="true"] .assistant-docs-launcher-chevron {
+          opacity: 1;
+          transform: scale(1);
+        }
+
+        .assistant-docs-panel-shell {
+          position: fixed;
+          bottom: calc(
+            var(--assistant-docs-offset-y) +
+            var(--assistant-docs-launcher-size) +
+            var(--assistant-docs-panel-gap)
+          );
+          z-index: var(--assistant-docs-z-index);
+          box-sizing: border-box;
+          width: min(var(--assistant-docs-panel-width), calc(100vw - 32px));
+          height: min(var(--assistant-docs-panel-height), calc(100dvh - 32px));
+          overflow: hidden;
+          border: var(--assistant-docs-panel-border);
+          border-radius: var(--assistant-docs-panel-radius);
+          background: var(--assistant-docs-panel-background);
+          box-shadow: var(--assistant-docs-panel-shadow);
+          -webkit-backdrop-filter: blur(var(--assistant-docs-panel-backdrop-blur));
+          backdrop-filter: blur(var(--assistant-docs-panel-backdrop-blur));
+          opacity: 1;
+          pointer-events: auto;
+          transform: scale(1);
+          transform-origin: bottom right;
+          transition-property: transform, opacity, display;
+          transition-duration: var(--assistant-docs-panel-open-duration);
+          transition-timing-function: var(--assistant-docs-panel-open-timing);
+          transition-behavior: allow-discrete;
+        }
+
+        .dark .assistant-docs-panel-shell {
+          border: var(--assistant-docs-panel-dark-border);
+          background: var(--assistant-docs-panel-dark-background);
+          box-shadow: var(--assistant-docs-panel-dark-shadow);
+        }
+
+        .assistant-docs-widget[data-side="right"] .assistant-docs-panel-shell {
+          right: var(--assistant-docs-offset-x);
+          transform-origin: bottom right;
+        }
+
+        .assistant-docs-widget[data-side="left"] .assistant-docs-panel-shell {
+          left: var(--assistant-docs-offset-x);
+          transform-origin: bottom left;
+        }
+
+        @starting-style {
+          .assistant-docs-panel-shell[data-state="open"] {
+            opacity: 0;
+            transform: scale(var(--assistant-docs-panel-open-scale));
+          }
+        }
+
+        .assistant-docs-panel-shell[data-state="closed"] {
+          display: none;
+          opacity: 0;
+          pointer-events: none;
+          transform: scale(var(--assistant-docs-panel-open-scale));
+          transition-property: transform, opacity, display;
+          transition-duration: var(--assistant-docs-panel-close-duration);
+          transition-timing-function: var(--assistant-docs-panel-close-timing);
+          transition-behavior: allow-discrete;
+        }
+
+        @media (max-width: ${chromeConfig.mobileBreakpoint}) {
+          .assistant-docs-panel-shell {
+            inset: 0 !important;
+            z-index: var(--assistant-docs-mobile-panel-z-index) !important;
+            width: 100vw !important;
+            height: 100dvh !important;
+            border: 0 !important;
+            border-radius: 0 !important;
+          }
+
+          .assistant-docs-panel-shell > div {
+            border-radius: 0;
+          }
+
+          .assistant-docs-launcher {
+            bottom: var(--assistant-docs-mobile-offset-y) !important;
+          }
+
+          .assistant-docs-widget[data-side="right"] .assistant-docs-launcher {
+            right: var(--assistant-docs-mobile-offset-x) !important;
+          }
+
+          .assistant-docs-widget[data-side="left"] .assistant-docs-launcher {
+            left: var(--assistant-docs-mobile-offset-x) !important;
+          }
+        }
+
+        @media (prefers-reduced-motion: reduce) {
+          .assistant-docs-launcher {
+            animation: none !important;
+          }
+
+          .assistant-docs-launcher,
+          .assistant-docs-launcher-icon,
+          .assistant-docs-panel-shell {
+            transition: none !important;
+          }
+        }
+      `}</style>
+    </div>
+  );
+}