@akropolys/kiku 1.5.19 → 1.6.0

package/README.md

@@ -6,11 +6,11 @@
 
 ---
 
-## What is `@akropolys/kiku`?
+## The pre-built UI for a smarter search bar.
 
-Ready-made React UI components for the Akropolys intent platform. Drop in a floating chat assistant or AI search bar and your catalog is immediately searchable in natural language — no configuration required.
+`@akropolys/kiku` is the ready-made front end for [`@akropolys/sdk`](https://www.npmjs.com/package/@akropolys/sdk) — a chat button, a search bar, a per-product "ask about this" prompt — so you don't have to design a search experience from scratch. Drop one in and it's already wired up to plain-language search.
 
-For full UI control, use [`@akropolys/sdk`](https://www.npmjs.com/package/@akropolys/sdk) directly.
+Want to build your own UI instead? Use `@akropolys/sdk` directly and skip this package.
 
 ```tsx
 import { AkropolysProvider } from '@akropolys/sdk';
@@ -21,7 +21,6 @@ export default function App() {
   return (
     <AkropolysProvider
       siteId={process.env.NEXT_PUBLIC_AKROPOLYS_SITE_ID}
-      apiUrl={process.env.NEXT_PUBLIC_AKROPOLYS_API_URL}
       apiToken={process.env.NEXT_PUBLIC_AKROPOLYS_API_TOKEN}
     >
       <KikuButton />
@@ -32,18 +31,17 @@ export default function App() {
 
 ## Components
 
-| Component | Description |
+| Component | What it does |
 |---|---|
-| `<KikuButton />` | Floating AI chat assistant |
-| `<KikuChat />` | Inline embedded chat widget |
-| `<SearchBar />` | AI search with dropdown results |
-| `<Sparkle />` | Per-product assistant button |
+| `<KikuButton />` | Floating chat assistant |
+| `<KikuChat />` | Chat widget embedded inline on the page |
+| `<SearchBar />` | Search box with a live results dropdown |
+| `<Sparkle />` | Small "ask about this" button next to a product |
 | `<ComparisonMatrix />` | Side-by-side product comparison |
-| `<CartBadge />` | Cart item count |
-| `<CartDrawer />` | Slide-out cart |
-| `<CheckoutModal />` | Checkout modal |
+| `<VoiceButton />` | Speak a query instead of typing it |
+| `<VisualSearch />` | Search by uploading a photo |
 
-## Installation
+## Install
 
 ```bash
 npm install @akropolys/kiku @akropolys/sdk

package/dist/index.d.mts

@@ -96,23 +96,6 @@ interface SparkleProps {
 }
 declare function Sparkle({ productName, limit, onResult, backdropColor, backdropBlur, className, onNavigate, theme, classNames, product, children, }: SparkleProps): React.JSX.Element;
 
-declare function CartBadge({ className }: {
-    className?: string;
-}): React.JSX.Element | null;
-
-declare function CartDrawer({ trigger, className, theme }: {
-    trigger?: React.ReactNode;
-    className?: string;
-    theme?: 'light' | 'dark' | AkropolysTheme;
-}): React.JSX.Element;
-
-declare function CheckoutModal({ onClose, theme, customStyles, hskThemeAttr }: {
-    onClose: () => void;
-    theme?: string;
-    customStyles?: React.CSSProperties;
-    hskThemeAttr?: string;
-}): React.ReactPortal;
-
 interface ComparisonMatrixProps {
     sources: ChatSource[];
     defaultCurrency?: string;
@@ -163,4 +146,4 @@ interface VisualSearchProps {
  */
 declare function VisualSearch({ onResults, onError, categoryHint, className, disabled, }: VisualSearchProps): React.JSX.Element;
 
-export { CartBadge, CartDrawer, ChatWidget, type ChatWidgetProps, CheckoutModal, ComparisonMatrix, KikuButton, type KikuButtonProps, ChatWidget as KikuChat, type ChatWidgetProps as KikuChatProps, SearchBar, type SearchBarProps, Sparkle, VisualSearch, type VisualSearchProps, VoiceButton, type VoiceButtonProps };
+export { ChatWidget, type ChatWidgetProps, ComparisonMatrix, KikuButton, type KikuButtonProps, ChatWidget as KikuChat, type ChatWidgetProps as KikuChatProps, SearchBar, type SearchBarProps, Sparkle, VisualSearch, type VisualSearchProps, VoiceButton, type VoiceButtonProps };

package/dist/index.d.ts

@@ -96,23 +96,6 @@ interface SparkleProps {
 }
 declare function Sparkle({ productName, limit, onResult, backdropColor, backdropBlur, className, onNavigate, theme, classNames, product, children, }: SparkleProps): React.JSX.Element;
 
-declare function CartBadge({ className }: {
-    className?: string;
-}): React.JSX.Element | null;
-
-declare function CartDrawer({ trigger, className, theme }: {
-    trigger?: React.ReactNode;
-    className?: string;
-    theme?: 'light' | 'dark' | AkropolysTheme;
-}): React.JSX.Element;
-
-declare function CheckoutModal({ onClose, theme, customStyles, hskThemeAttr }: {
-    onClose: () => void;
-    theme?: string;
-    customStyles?: React.CSSProperties;
-    hskThemeAttr?: string;
-}): React.ReactPortal;
-
 interface ComparisonMatrixProps {
     sources: ChatSource[];
     defaultCurrency?: string;
@@ -163,4 +146,4 @@ interface VisualSearchProps {
  */
 declare function VisualSearch({ onResults, onError, categoryHint, className, disabled, }: VisualSearchProps): React.JSX.Element;
 
-export { CartBadge, CartDrawer, ChatWidget, type ChatWidgetProps, CheckoutModal, ComparisonMatrix, KikuButton, type KikuButtonProps, ChatWidget as KikuChat, type ChatWidgetProps as KikuChatProps, SearchBar, type SearchBarProps, Sparkle, VisualSearch, type VisualSearchProps, VoiceButton, type VoiceButtonProps };
+export { ChatWidget, type ChatWidgetProps, ComparisonMatrix, KikuButton, type KikuButtonProps, ChatWidget as KikuChat, type ChatWidgetProps as KikuChatProps, SearchBar, type SearchBarProps, Sparkle, VisualSearch, type VisualSearchProps, VoiceButton, type VoiceButtonProps };