@netlify/spark-ui 1.0.2 → 1.0.3-alpha.1

package/packages/components/preact/AskNetlify/AskNetlify.tsx

@@ -0,0 +1,123 @@
+import { useState, useRef, useEffect } from 'preact/hooks';
+import { marked } from 'marked';
+import { KapaProvider, useChat } from '@kapaai/react-sdk';
+
+import './AskNetlify.css';
+
+function AskNetlify(props) {
+  return (
+    <KapaProvider
+      integrationId="3c0789a6-c6a8-4fbc-b0cc-235f9e4a6351"
+      callbacks={{
+        askAI: {
+          onQuerySubmit: data => console.log('Question asked:', data.question),
+        },
+      }}
+    >
+      <ChatInterface {...props} />
+    </KapaProvider>
+  );
+}
+
+function ChatInterface({ setModalState }) {
+  const [message, setMessage] = useState('');
+  const { conversation, submitQuery, isGeneratingAnswer, isPreparingAnswer, stopGeneration } =
+    useChat();
+
+  const chatRef = useRef(null);
+
+  const handleSubmit = e => {
+    e.preventDefault();
+    if (message.trim()) {
+      submitQuery(message);
+      setMessage('');
+    }
+  };
+
+  useEffect(() => {
+    const el = chatRef.current as HTMLElement | null;
+    if (el) el.scrollTop = el.scrollHeight;
+  }, [conversation]);
+
+  return (
+    <div className="chat-container">
+      <button
+        class="button button-back"
+        data-button-variant="outline"
+        onClick={() => setModalState({ current: 'search' })}
+        aria-label={'Return to search'}
+      >
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512">
+          <path d="M9.4 233.4c-12.5 12.5-12.5 32.8 0 45.3l192 192c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3L77.3 256 246.6 86.6c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0l-192 192z" />
+        </svg>
+        Search
+      </button>
+      <div ref={chatRef} className="conversation n-search-window">
+        {conversation.map((qa, index) => (
+          <div key={qa.id || `qa-${index}`} className="message">
+            <div className="message-right">
+              <div className="message-bubble user-message">
+                <p>{qa.question}</p>
+              </div>
+            </div>
+
+            <div className="message-left">
+              {qa.answer ? (
+                <div className="message-bubble bot-message">
+                  <div
+                    className="message-answer prose flow"
+                    dangerouslySetInnerHTML={{
+                      __html: marked.parse(qa.answer),
+                    }}
+                  />
+                </div>
+              ) : (
+                <span class="pulsing"></span>
+              )}
+            </div>
+          </div>
+        ))}
+      </div>
+
+      <form onSubmit={handleSubmit} className="form-wrapper n-search-input-wrapper">
+        <input
+          type="text"
+          className="form-input n-search-input"
+          value={message}
+          onChange={e => setMessage(e.target.value)}
+          placeholder="Ask a question..."
+          disabled={isGeneratingAnswer}
+        />
+        {/* <button type="submit" className="form-submit" disabled={isGeneratingAnswer}>
+          Send
+        </button> */}
+
+        {isGeneratingAnswer ? (
+          <button
+            type="button"
+            className="form-submit"
+            onClick={stopGeneration}
+            aria-label="Stop generation"
+          >
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor">
+              <rect x="0" y="0" width="16" height="16" />
+            </svg>
+          </button>
+        ) : (
+          <button
+            type="submit"
+            className="form-submit"
+            disabled={!message.trim() || isPreparingAnswer}
+            aria-label="Send message"
+          >
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512" fill="currentColor">
+              <path d="M438.6 278.6c12.5-12.5 12.5-32.8 0-45.3l-160-160c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3L338.8 224 32 224c-17.7 0-32 14.3-32 32s14.3 32 32 32l306.7 0L233.4 393.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0l160-160z" />
+            </svg>
+          </button>
+        )}
+      </form>
+    </div>
+  );
+}
+
+export default AskNetlify;

package/packages/components/preact/Orb/Orb.css

@@ -0,0 +1,94 @@
+@property --angle {
+  syntax: '<angle>';
+  inherits: false;
+  initial-value: 0deg;
+}
+
+:root {
+  --bg: oklch(12.9% 0.042 264.695);
+  --c1: oklch(44.4% 0.177 26.899);
+  --c2: oklch(85.2% 0.199 91.936);
+  --c3: oklch(58.8% 0.158 241.966);
+}
+
+.orb {
+  display: grid;
+  grid-template-areas: 'stack';
+  inline-size: min(80vmin, 100%);
+  aspect-ratio: 1;
+  overflow: hidden;
+  border-radius: 50%;
+
+  &::before,
+  &::after {
+    content: '';
+    display: block;
+    grid-area: stack;
+    width: 100%;
+    height: 100%;
+    border-radius: 50%;
+    transform: translateZ(0);
+  }
+
+  &::before {
+    background:
+      conic-gradient(
+        from calc(var(--angle) * 2) at 25% 70%,
+        var(--c3),
+        transparent 20% 80%,
+        var(--c3)
+      ),
+      conic-gradient(
+        from calc(var(--angle) * 2) at 45% 75%,
+        var(--c2),
+        transparent 30% 60%,
+        var(--c2)
+      ),
+      conic-gradient(
+        from calc(var(--angle) * -3) at 80% 20%,
+        var(--c1),
+        transparent 40% 60%,
+        var(--c1)
+      ),
+      conic-gradient(
+        from calc(var(--angle) * 2) at 15% 5%,
+        var(--c2),
+        transparent 10% 90%,
+        var(--c2)
+      ),
+      conic-gradient(
+        from calc(var(--angle) * 1) at 20% 80%,
+        var(--c1),
+        transparent 10% 90%,
+        var(--c1)
+      ),
+      conic-gradient(
+        from calc(var(--angle) * -2) at 85% 10%,
+        var(--c3),
+        transparent 20% 80%,
+        var(--c3)
+      );
+    box-shadow: inset var(--bg) 0 0 5vmin 1vmin;
+    filter: blur(3vmin) contrast(5);
+    animation: rotate 20s linear infinite;
+  }
+
+  &::after {
+    --dot: 1.5px;
+    background-image: radial-gradient(
+      circle at center,
+      var(--bg) var(--dot),
+      transparent var(--dot)
+    );
+    background-size: calc(var(--dot) * 2) calc(var(--dot) * 2);
+    mask-image: radial-gradient(black 25%, transparent 75%);
+    backdrop-filter: blur(8vmin) contrast(10);
+    mix-blend-mode: overlay;
+  }
+}
+
+@keyframes rotate {
+  to {
+    --angle: 360deg;
+  }
+}

package/packages/components/preact/Orb/Orb.tsx

@@ -0,0 +1,7 @@
+import './Orb.css';
+
+const Orb = () => {
+  return <div class="orb"></div>;
+};
+
+export default Orb;

package/packages/components/preact/SearchModal/components/SearchInput.tsx

@@ -6,20 +6,22 @@ interface Props {
   setSearchTerm: (term: string) => void;
   placeholder?: string;
   initialValue?: string;
+  isGeneratingAnswer?: boolean;
+  isPreparingAnswer?: boolean;
 }
 
 const SearchInput = (props: Props) => {
   const [value, setValue] = useState<string>('');
 
-    const { reset, run } = useTimeout((query: string) => {
-      props.setSearchTerm(query);
-    }, 300);
-    
-    const handleInput = (e: InputEvent) => {
+  const { reset, run } = useTimeout((query: string) => {
+    props.setSearchTerm(query);
+  }, 300);
+
+  const handleInput = (e: InputEvent) => {
     const target = e.target as HTMLInputElement;
     setValue(target.value);
-    reset()
-    run(target.value)
+    reset();
+    run(target.value);
   };
 
   useEffect(() => {

package/packages/components/preact/SearchModal/components/SearchLink/SearchLink.css

@@ -1,6 +1,7 @@
 .n-search-link {
   --n-search-icon-size: 1em;
-  all: unset;
+  /* all: unset; */
+  box-sizing: border-box;
   display: flex;
   justify-content: space-between;
   flex-wrap: wrap;
@@ -11,6 +12,10 @@
   font-weight: var(--font-weight-regular);
   text-decoration: none;
   cursor: pointer;
+  width: 100%;
+  border: none;
+  text-align: left;
+  outline: none;
 }
 
 .n-search-link-body {

package/packages/components/preact/SearchModal/components/SearchModal/SearchModal.css

@@ -4,15 +4,18 @@
 
 /* Root Variables */
 .n-search-modal {
-  --n-search-padding-inline: 0.5em;
+  --n-search-padding-inline: var(--space-s);
   --n-search-color-text: var(--color-text, currentColor);
   --n-search-color-text-secondary: var(--color-text-weak, currentColor);
   --n-search-color-bg: var(--color-bg);
   --n-search-color-bg-2: var(--color-bg-2);
   --n-search-color-border: var(--color-bg-3);
-  --n-search-border-radius: 8px;
+  --n-search-border-radius: 1.3rem;
   --n-search-max-w: 600px;
   --n-search-text-highlight: var(--color-text-accent);
+  --n-search-input-height: 50px;
+  --n-search-footer-height: 40px;
+  --n-search-container-height: 400px;
 }
 
 .n-search-modal {
@@ -23,11 +26,30 @@
   margin: auto;
 }
 
+.n-search-modal::after {
+  content: '';
+  display: block;
+  width: 100%;
+  height: 100%;
+  background: blue;
+  position: absolute;
+  z-index: 0;
+  inset: 0;
+  transform-origin: center;
+  transform: scale(0);
+  border-radius: var(--radius-m);
+  transition: transform 300ms ease-in-out;
+}
+
+.n-search-modal-ask {
+  --n-search-max-w: 800px;
+}
+
 .n-search-container {
   --mark-bg: var(--n-search-text-highlight);
   display: grid;
   width: min(var(--n-search-max-w), 100%);
-  min-height: 470px;
+  /* min-height: 530px; */
   background-color: var(--n-search-color-bg);
   border-radius: var(--n-search-border-radius);
   overflow: hidden;
@@ -43,13 +65,15 @@
 }
 
 .n-search-input-wrapper {
-  all: unset;
+  /* all: unset; */
+  position: relative;
   display: flex;
   width: 100%;
-  border-bottom: 1px solid var(--n-search-color-border);
+  height: var(--n-search-input-height);
 }
 
 .n-search-input {
+  position: relative;
   display: inline-flex;
   box-sizing: border-box;
   background: var(--n-search-color-bg);
@@ -63,13 +87,25 @@
   color: var(--color-text);
 }
 
+.n-search-input-wrapper::after,
+.n-search-footer::after {
+  content: '';
+  display: block;
+  width: 200%;
+  height: 1px;
+  background: var(--n-search-color-border);
+  position: absolute;
+  bottom: 0;
+  left: 0;
+}
+
 .n-search-input::placeholder {
   color: var(--n-search-color-text);
 }
 
 .n-search-label {
   display: flex;
-  padding-inline: var(--n-search-padding-inline);
+  padding-inline-start: var(--n-search-padding-inline);
   align-items: center;
 }
 
@@ -92,7 +128,7 @@
 
 /* Search Results */
 .n-search-window {
-  height: 400px;
+  height: var(--n-search-container-height);
   overflow-x: hidden;
   overflow-y: auto;
   overscroll-behavior: contain;
@@ -115,11 +151,15 @@ ul[role='list'] {
 
 /* Footer */
 .n-search-footer {
-  border-top: 1px solid var(--n-search-color-border);
-  padding: var(--space-2xs) var(--space-s);
-  background: var(--color-bg-2);
+  position: relative;
   display: flex;
   gap: var(--space-m);
+  padding: var(--space-2xs) var(--space-s);
+  height: var(--n-search-footer-height);
+}
+
+.n-search-footer::after {
+  top: 0;
 }
 
 .n-search-footer-tip {
@@ -134,7 +174,8 @@ ul[role='list'] {
 .n-search-modal {
   transition:
     display 0.2s allow-discrete,
-    overlay 0.2s allow-discrete;
+    overlay 0.2s allow-discrete,
+    width 0.3s ease-in-out;
   animation: closeSearch 0.2s forwards;
 }
 
@@ -142,6 +183,21 @@ ul[role='list'] {
   animation: openSearch 0.2s forwards;
 }
 
+.n-search-modal[data-state='search'] > * {
+  opacity: 0;
+  animation: appearContainer 300ms ease-in-out forwards;
+  animation-delay: 300ms;
+}
+
+@keyframes appearContainer {
+  0% {
+    opacity: 0;
+  }
+  100% {
+    opacity: 1;
+  }
+}
+
 @keyframes openSearch {
   from {
     opacity: 0;

package/packages/components/preact/SearchModal/components/SearchModal/SearchModal.tsx

@@ -14,21 +14,26 @@ import {
   useSearchToggles,
   useSearchLogger,
 } from '../../hooks';
+import { useTimeout } from '@utils/useTimeout';
+
+import AskNetlify from '../../../../preact/AskNetlify/AskNetlify';
 
 import './SearchModal.css';
 
 interface Props {
   children: ComponentChildren;
   className?: string;
-  debug?: boolean
+  debug?: boolean;
 }
 
-function SearchModal(props: Props = {className: '', children: null, debug: false }) {
+function SearchModal(props: Props = { className: '', children: null, debug: false }) {
   const [isPagefindLoaded, setIsPagefindLoaded] = useState(false);
+  const [modalState, setModalState] = useState({ current: 'search' });
+  const [askNetlifyQuery, setAskNetlifyQuery] = useState('');
 
   // Poll for the existence of window.pagefind.
   useEffect(() => {
-    let intervalId:number;
+    let intervalId: number;
 
     const checkForPagefind = () => {
       if (window.pagefind) {
@@ -45,19 +50,18 @@ function SearchModal(props: Props = {className: '', children: null, debug: false
     return () => clearInterval(intervalId);
   }, []);
 
-
   const { children, className, debug, ...rest } = props;
   const { state, actions } = useSearch();
-  const [searchOpen, setSearchOpen] = useState(false);
 
+  const [searchOpen, setSearchOpen] = useState(false);
   const openSearch = () => setSearchOpen(true);
   const closeSearch = () => setSearchOpen(false);
 
   const modalRef = useRef<HTMLDialogElement>(null);
   const containerRef = useClickOutside<HTMLDivElement>(closeSearch);
 
-  useSearchLogger(state, debug)
-  useSearchToggles(isPagefindLoaded,  openSearch);
+  useSearchLogger(state, debug);
+  useSearchToggles(isPagefindLoaded, openSearch);
   useSearchParams(isPagefindLoaded, actions.setSearchTerm, openSearch);
   useSearchHotkeys(isPagefindLoaded, searchOpen, openSearch, closeSearch);
   useKeyboardNav(isPagefindLoaded, modalRef, searchOpen, closeSearch);
@@ -67,31 +71,64 @@ function SearchModal(props: Props = {className: '', children: null, debug: false
     searchOpen ? modalRef.current.showModal() : modalRef.current.close();
   }, [searchOpen]);
 
+  useEffect(() => {
+    const input = modalRef.current?.querySelector('input');
+
+    if (input) input.focus();
+
+    if (modalState.current === 'ask') {
+      setTimeout(() => {
+        modalRef.current.classList.add('n-search-modal-ask');
+      }, 150);
+    } else if (modalState.current === 'search') {
+      setTimeout(() => {
+        modalRef.current.classList.remove('n-search-modal-ask');
+      }, 150);
+    }
+  }, [modalState.current]);
+
   return (
-    <Modal ref={modalRef} className={`n-search-modal ${className ? className : ''}`} {...rest}>
+    <Modal
+      ref={modalRef}
+      className={`n-search-modal ${className ? className : ''}`}
+      data-state={modalState.current}
+      {...rest}
+    >
       <div ref={containerRef} className="n-search-container">
-          <SearchInput setSearchTerm={actions.setSearchTerm} initialValue={state.searchTerm} />
-
-        <SearchWindow
-          searchLoading={state.isLoading}
-          searchTerm={state.searchTerm}
-          results={state.results}
-        >
-          {children}
-        </SearchWindow>
-
-        <div className="n-search-footer">
-          <p className="n-search-footer-tip">
-            <KeyboardKey keyNames={['Esc']} />
-            to close
-          </p>
-          <p className="n-search-footer-tip">
-            <KeyboardKey keyNames={['Tab']} />
-            <span>or</span>
-            <KeyboardKey keyNames={['↑', '↓']} />
-            to navigate
-          </p>
-        </div>
+        {modalState.current === 'ask' && (
+          <AskNetlify query={askNetlifyQuery} setModalState={setModalState} />
+        )}
+        {modalState.current === 'search' && (
+          <>
+            <SearchInput
+              setSearchTerm={actions.setSearchTerm}
+              setAskNetlifyQuery={setAskNetlifyQuery}
+              initialValue={state.searchTerm}
+            />
+
+            <SearchWindow
+              setModalState={setModalState}
+              searchLoading={state.isLoading}
+              searchTerm={state.searchTerm}
+              results={state.results}
+            >
+              {children}
+            </SearchWindow>
+
+            <div className="n-search-footer">
+              <p className="n-search-footer-tip">
+                <KeyboardKey keyNames={['Esc']} />
+                to closed
+              </p>
+              <p className="n-search-footer-tip">
+                <KeyboardKey keyNames={['Tab']} />
+                <span>or</span>
+                <KeyboardKey keyNames={['↑', '↓']} />
+                to navigate
+              </p>
+            </div>
+          </>
+        )}
       </div>
     </Modal>
   );

package/packages/components/preact/SearchModal/components/SearchWindow.tsx

@@ -4,6 +4,8 @@ import { useMemo } from 'preact/hooks';
 import SearchHeading from './SearchHeading/SearchHeading';
 import SearchLink from './SearchLink/SearchLink';
 
+import Icon from '@components/preact/Icon';
+
 /* --- Search Results Window (for active searches) --- */
 const SearchResults: FunctionComponent<SearchResultsProps> = ({
   searchLoading,
@@ -20,9 +22,9 @@ const SearchResults: FunctionComponent<SearchResultsProps> = ({
 
   if (!results || results.length === 0) {
     return (
-        <SearchHeading>
-          0 results for <span className="n-search-term">{searchTerm}</span>
-        </SearchHeading>
+      <SearchHeading>
+        0 results for <span className="n-search-term">{searchTerm}</span>
+      </SearchHeading>
     );
   }
 
@@ -43,29 +45,38 @@ const SearchResults: FunctionComponent<SearchResultsProps> = ({
 
 /* --- Main Search Results Component --- */
 export default function SearchWindow({
+  setModalState,
   searchLoading,
   searchTerm,
   results,
   children: DefaultWindow,
 }: SearchWindowProps) {
-  const askNetlify: SearchLinkProps = {
-    icon: 'sparkles',
-    label: 'Ask Netlify AI',
-    url: 'https://docs.netlify.com/ask-netlify/',
-  };
-
   return (
     <div className="n-search-window">
       <div className="search-links">
-        <SearchLink {...askNetlify} />
         {searchTerm && searchTerm.length > 1 ? (
-          <SearchResults
-            searchLoading={searchLoading}
-            searchTerm={searchTerm}
-            results={results}
-          />
+          <SearchResults searchLoading={searchLoading} searchTerm={searchTerm} results={results} />
         ) : DefaultWindow ? (
-          DefaultWindow
+          <>
+            <button
+              class="btn-ask-netlify n-search-link"
+              onClick={() => {
+                setModalState({ current: 'ask' });
+              }}
+            >
+              <span className="n-search-link-icon">
+                <Icon name={'netlify'} />
+              </span>
+              <div className="n-search-link-body">
+                <p className="n-search-link-title">Ask Netlify AI</p>
+              </div>
+              <div className="n-search-link-icon">
+                <Icon name="caretRight" />
+              </div>
+            </button>
+
+            {DefaultWindow}
+          </>
         ) : null}
       </div>
     </div>

package/packages/components/preact/SearchModal/hooks/useKeyboardNav.ts

@@ -21,7 +21,7 @@ export function useKeyboardNav(
   onClose: () => void
 ) {
   useEffect(() => {
-    if (!isPagefindLoaded) return 
+    if (!isPagefindLoaded) return;
     const handleKeydown = (e: KeyboardEvent) => {
       if (!isOpen) return;
 
@@ -35,7 +35,7 @@ export function useKeyboardNav(
         const container = containerRef.current;
         if (!container) return;
 
-        const links = Array.from(container.querySelectorAll('a'));
+        const links = Array.from(container.querySelectorAll('.n-search-link'));
         const currentIndex = links.findIndex(link => link === document.activeElement);
         const nextIndex =
           e.key === 'ArrowDown'

package/packages/components/preact/SearchModal/types/search.types.tsx

@@ -10,6 +10,7 @@ export interface SearchLinkProps {
 }
 
 export interface SearchWindowProps {
+  setModalState: (e: { current: string }) => void;
   searchLoading: boolean;
   searchTerm?: string;
   results?: SearchLinkProps[];
@@ -33,4 +34,4 @@ export interface SearchGTMObjectProps {
   resultUrl?: string;
   query?: string;
   debug_mode?: boolean;
-}
+}

package/packages/components/preact/index.ts

@@ -4,6 +4,7 @@ export { default as Icon } from './Icon';
 export { default as SearchLink } from './SearchModal/components/SearchLink/SearchLink';
 export { default as SearchHeading } from './SearchModal/components/SearchHeading/SearchHeading';
 export { default as SearchToggle } from './SearchModal/components/SearchToggle/SearchToggle';
+export { default as AskNetlify } from "./AskNetlify/AskNetlify"
 export { SearchModal } from './SearchModal';
 
 export { type IconName } from './Icon';