@netlify/spark-ui 1.4.5 → 1.5.0-alpha.1

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-color-text: var(--color-text, currentColor);
+  --n-search-padding-inline: var(--space-s);
+  --n-search-color-text: var(--color-text-1, currentColor);
   --n-search-color-text-secondary: var(--color-text-weak, currentColor);
   --n-search-color-bg: var(--search-bg-color);
-  --n-search-color-bg-2: var(--color-bg-2);
+  --n-search-color-bg-2: var(--color-bg-3);
   --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(--search-highlight-color);
+  --n-search-input-height: 50px;
+  --n-search-footer-height: 40px;
+  --n-search-container-height: 400px;
 }
 
 .n-search-modal {
@@ -21,13 +24,33 @@
   border-radius: var(--n-search-border-radius);
   width: min(var(--n-search-max-w), 100%);
   margin: auto;
+  background: var(--n-search-color-bg);
+}
+
+.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 +66,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);
@@ -60,7 +85,19 @@
   border: none;
   outline: none;
   font-size: 1rem;
-  color: var(--color-text);
+  color: var(--color-text-1);
+}
+
+.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 {
@@ -69,7 +106,7 @@
 
 .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 +129,7 @@
 
 /* Search Results */
 .n-search-window {
-  height: 400px;
+  height: var(--n-search-container-height);
   overflow-x: hidden;
   overflow-y: auto;
   overscroll-behavior: contain;
@@ -100,6 +137,12 @@
   background: var(--n-search-color-bg);
 }
 
+.n-results-list,
+ul[role='list'] {
+  list-style: none;
+  padding: 0;
+}
+
 .n-results-list-item {
   border-bottom: 1px solid var(--color-bg-3);
 }
@@ -109,11 +152,15 @@
 
 /* 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 {
@@ -128,7 +175,8 @@
 .n-search-modal {
   transition:
     display 0.2s allow-discrete,
-    overlay 0.2s allow-discrete;
+    overlay 0.2s allow-discrete,
+    width 0.15s ease-in-out;
   animation: closeSearch 0.2s forwards;
 }
 
@@ -136,28 +184,43 @@
   animation: openSearch 0.2s forwards;
 }
 
+.n-search-modal[data-state='search'] > * {
+  opacity: 0;
+  animation: appearContainer 120ms ease-in-out forwards;
+  animation-delay: 140ms;
+}
+
+@keyframes appearContainer {
+  0% {
+    opacity: 0;
+  }
+  100% {
+    opacity: 1;
+  }
+}
+
 @keyframes openSearch {
   from {
     opacity: 0;
-    transform: translateY(20px) scale(0.9);
+    transform: scale(0.9);
   }
   to {
     opacity: 1;
-    transform: translateY(0px) scale(1);
+    transform: scale(1);
   }
 }
 
 @keyframes closeSearch {
   from {
     opacity: 1;
-    transform: translateY(0px) scale(1);
+    transform: scale(1);
   }
   50% {
     opacity: 0.3;
   }
   to {
     opacity: 0;
-    transform: translateY(20px) scale(0.9);
+    transform: scale(0.9);
   }
 }
 

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

@@ -1,9 +1,11 @@
 import type { FunctionComponent } from 'preact';
-import type { SearchLinkProps, SearchResultsProps, SearchWindowProps } from '../types/search.types';
+import type { SearchResultsProps, SearchWindowProps } from '../types/search.types';
 import { useMemo } from 'preact/hooks';
 import SearchHeading from './SearchHeading/SearchHeading';
 import SearchLink from './SearchLink/SearchLink';
 
+import { handleThemeChange, ThemeMap, Theme } from '@utils/theme';
+
 /* --- 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,40 @@ 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
+          <>
+            <SearchLink
+              as="button"
+              icon="netlify"
+              label="Ask Netlify AI"
+              onClick={() => {
+                setModalState({ current: 'ask' });
+              }}
+            />
+
+            {DefaultWindow}
+
+            <SearchLink
+              as="button"
+              icon="netlify"
+              label="Toggle theme"
+              onClick={() => {
+                const theme = document.documentElement.getAttribute('data-theme') as Theme;
+                theme && handleThemeChange(ThemeMap[theme]);
+              }}
+            />
+          </>
         ) : 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

@@ -2,14 +2,17 @@ import type { ComponentChildren } from 'preact';
 import type { IconName } from '../../Icon';
 
 export interface SearchLinkProps {
+  as?: any;
   icon: IconName;
   label: string;
   resource?: 'blog' | 'changelog' | 'docs' | 'guide';
-  url: string;
+  url?: string;
   excerpt?: string;
+  onClick?: () => void;
 }
 
 export interface SearchWindowProps {
+  setModalState: (e: { current: string }) => void;
   searchLoading: boolean;
   searchTerm?: string;
   results?: SearchLinkProps[];
@@ -33,4 +36,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';

package/packages/styles/tokens.css

@@ -4,6 +4,9 @@
 
 :root {
   --active-switcher-tab-bg-color: color(srgb 0.047058823529411764 0.16470588235294117 0.16470588235294117 / 0.047058823529411764);
+  --badge-bg-color: var(--neutral-100);
+  --badge-border-color: var(--neutral-300);
+  --badge-text-color: var(--neutral-500);
   --blue-000: color(srgb 0.9294117647058824 0.9568627450980393 1);
   --blue-100: color(srgb 0.803921568627451 0.8862745098039215 1);
   --blue-200: color(srgb 0.7098039215686275 0.8235294117647058 0.984313725490196);
@@ -153,8 +156,12 @@
   --red-700: color(srgb 0.6862745098039216 0.1450980392156863 0.21176470588235294);
   --red-800: color(srgb 0.5019607843137255 0.0392156862745098 0.12549019607843137);
   --red-900: color(srgb 0.23921568627450981 0.10980392156862745 0.10588235294117647);
+  --search-answer-message-color: var(--neutral-200);
+  --search-back-btn-bg-color: var(--neutral-100);
   --search-bg-color: var(--neutral-000);
   --search-highlight-color: var(--teal-000);
+  --search-loading-color: var(--blue-700);
+  --search-user-message-color: var(--blue-100);
   --shadow-deep: 0 16px 24px 0 color(srgb 0 0 0 / 0.07), 0 6px 30px 0 color(srgb 0 0 0 / 0.06), 0 8px 10px 0 color(srgb 0 0 0 / 0.1);
   --shadow-heavy: -10px 10px 80px 0 color(srgb 0 0 0 / 0.1);
   --shadow-hover: 0 4px 12px 0 color(srgb 0 0 0 / 0.25);
@@ -186,6 +193,9 @@
 @media (prefers-color-scheme: dark) {
   :root {
     --active-switcher-tab-bg-color: color(srgb 0.047058823529411764 0.16470588235294117 0.16470588235294117);
+    --badge-bg-color: var(--neutral-700);
+    --badge-border-color: var(--neutral-600);
+    --badge-text-color: var(--neutral-100);
     --button-outline-bg-color: color(srgb 0 0 0 / 0);
     --button-outline-bg-color-hover: color(srgb 0.6509803921568628 1 0.9921568627450981 / 0.09803921568627451);
     --button-outline-stroke-color: var(--teal-200);
@@ -242,8 +252,12 @@
     --neutral-700: color(srgb 0.11764705882352941 0.1411764705882353 0.17254901960784313);
     --neutral-800: color(srgb 0.07058823529411765 0.09411764705882353 0.12156862745098039);
     --neutral-900: color(srgb 0.023529411764705882 0.043137254901960784 0.06274509803921569);
+    --search-answer-message-color: var(--neutral-600);
+    --search-back-btn-bg-color: var(--neutral-500);
     --search-bg-color: var(--neutral-700);
     --search-highlight-color: var(--teal-800);
+    --search-loading-color: var(--teal-200);
+    --search-user-message-color: var(--teal-800);
     --switcher-tab-bg-color: color(srgb 0.047058823529411764 0.16470588235294117 0.16470588235294117 / 0.2);
     --title-text-color: color(srgb 0.8352941176470589 1 0.996078431372549 / 0.7490196078431373);
   }
@@ -251,6 +265,9 @@
 
 [data-theme="dark"] {
   --active-switcher-tab-bg-color: color(srgb 0.047058823529411764 0.16470588235294117 0.16470588235294117);
+  --badge-bg-color: var(--neutral-700);
+  --badge-border-color: var(--neutral-600);
+  --badge-text-color: var(--neutral-100);
   --button-outline-bg-color: color(srgb 0 0 0 / 0);
   --button-outline-bg-color-hover: color(srgb 0.6509803921568628 1 0.9921568627450981 / 0.09803921568627451);
   --button-outline-stroke-color: var(--teal-200);
@@ -307,14 +324,21 @@
   --neutral-700: color(srgb 0.11764705882352941 0.1411764705882353 0.17254901960784313);
   --neutral-800: color(srgb 0.07058823529411765 0.09411764705882353 0.12156862745098039);
   --neutral-900: color(srgb 0.023529411764705882 0.043137254901960784 0.06274509803921569);
+  --search-answer-message-color: var(--neutral-600);
+  --search-back-btn-bg-color: var(--neutral-500);
   --search-bg-color: var(--neutral-700);
   --search-highlight-color: var(--teal-800);
+  --search-loading-color: var(--teal-200);
+  --search-user-message-color: var(--teal-800);
   --switcher-tab-bg-color: color(srgb 0.047058823529411764 0.16470588235294117 0.16470588235294117 / 0.2);
   --title-text-color: color(srgb 0.8352941176470589 1 0.996078431372549 / 0.7490196078431373);
 }
 
 [data-theme="light"] {
   --active-switcher-tab-bg-color: color(srgb 0.047058823529411764 0.16470588235294117 0.16470588235294117 / 0.047058823529411764);
+  --badge-bg-color: var(--neutral-100);
+  --badge-border-color: var(--neutral-300);
+  --badge-text-color: var(--neutral-500);
   --button-outline-bg-color: color(srgb 0 0 0 / 0);
   --button-outline-bg-color-hover: color(srgb 0.19607843137254902 0.9019607843137255 0.8862745098039215 / 0.2);
   --button-outline-stroke-color: var(--neutral-800);
@@ -371,8 +395,12 @@
   --neutral-600: color(srgb 0.32941176470588235 0.35294117647058826 0.3803921568627451);
   --neutral-700: color(srgb 0.20784313725490197 0.22745098039215686 0.24313725490196078);
   --neutral-800: color(srgb 0.09411764705882353 0.10196078431372549 0.10980392156862745);
+  --search-answer-message-color: var(--neutral-200);
+  --search-back-btn-bg-color: var(--neutral-100);
   --search-bg-color: var(--neutral-000);
   --search-highlight-color: var(--teal-000);
+  --search-loading-color: var(--blue-700);
+  --search-user-message-color: var(--blue-100);
   --switcher-tab-bg-color: color(srgb 1 1 1 / 0.047058823529411764);
   --title-text-color: color(srgb 0.32941176470588235 0.35294117647058826 0.3803921568627451 / 0.7490196078431373);
 }

package/packages/utils/theme.ts

@@ -0,0 +1,12 @@
+export type Theme = 'light' | 'dark';
+
+export const ThemeMap: Record<Theme, Theme> = {
+  light: 'dark',
+  dark: 'light',
+};
+
+export const handleThemeChange = (value: Theme) => {
+  const element = document.documentElement;
+  element.setAttribute('data-theme', value);
+  localStorage.setItem('theme', value);
+};