@keak/sdk 1.0.1

package/README.md

@@ -0,0 +1,131 @@
+# Keak SDK
+
+Production-ready A/B testing and experimentation SDK for React applications with visual editing, source mapping, and real-time variant testing.
+
+## Quick Start
+
+### 1. Install the SDK
+
+```bash
+npm install keak-sdk
+```
+
+All dependencies are bundled with the SDK - no additional packages required.
+
+### 2. Auto-Setup
+
+The CLI setup runs automatically after installation. If it doesn't run, trigger it manually:
+
+```bash
+npx keak-setup
+```
+
+The installer will:
+- Detect your React framework (Next.js, CRA, Vite, etc.)
+- Find your main entry file (`src/index.tsx`, `app/layout.tsx`, etc.)
+- Add the `KeakProvider` wrapper automatically
+- Create a backup of your original file
+- Automatically configure source mapping (enables precise element-to-code mapping)
+
+### 3. Next.js 15 Setup
+
+If you're using Next.js 15, you'll need additional configuration to enable source mapping. See the [Next.js 15 Setup Guide](./NEXTJS_15_SETUP.md) for detailed instructions.
+
+## Basic Usage
+
+### Setup KeakProvider
+
+The auto-setup will add `KeakProvider` to your app. If you need to configure it manually:
+
+```tsx
+import { KeakProvider } from 'keak-sdk';
+
+function App() {
+  return (
+    <KeakProvider config={{ apiKey: 'your-api-key' }}>
+      {/* Your app components */}
+    </KeakProvider>
+  );
+}
+```
+
+### Create Experiments
+
+Wrap your content with `Experiment` and `Variant` components:
+
+```tsx
+import { Experiment, Variant } from 'keak-sdk';
+
+export default function HeroHome() {
+  return (
+    <section>
+      <h1>Create stunning web experiences</h1>
+      
+      <Experiment name="hero-description">
+        <Variant name="control">
+          <p>Our landing page template works on all devices, so you only have to set it up once, and get beautiful results forever.</p>
+        </Variant>
+        <Variant name="treatment">
+          <p>Tired of generic templates and endless tweaks? Our expertly crafted landing page solution guarantees pixel-perfect performance and stunning conversions on every device.</p>
+        </Variant>
+      </Experiment>
+    </section>
+  );
+}
+```
+
+### Using the Hook
+
+You can also use the `useExperiment` hook for programmatic access:
+
+```tsx
+import { useExperiment } from 'keak-sdk';
+
+function MyComponent() {
+  const { variant, track, isInExperiment } = useExperiment('my-experiment');
+  
+  return (
+    <div>
+      {variant === 'treatment' && <NewFeature />}
+      <button onClick={() => track('button_clicked')}>
+        Click me
+      </button>
+    </div>
+  );
+}
+```
+
+## Project Structure
+
+```
+keak-sdk/
+├── src/
+│   ├── index.tsx          # Main SDK entry point
+│   ├── toolbar/           # Floating toolbar components
+│   └── scripts/           # Build and utility scripts
+├── dist/                  # Built output (generated)
+├── package.json           # Package configuration
+└── tsconfig.json          # TypeScript configuration
+```
+
+## Available Scripts
+
+- `npm run build` - Build the SDK for production
+- `npm run dev` - Build the SDK in watch mode for development
+- `npm run prepublishOnly` - Build before publishing
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Module not found errors**: Ensure the SDK is properly installed and the auto-setup has completed
+2. **TypeScript errors**: Ensure your project has compatible TypeScript and React versions (React >=16.8.0)
+3. **KeakProvider not found**: Run `npx keak-setup` to ensure the provider is properly added to your entry file
+
+### Next.js 15 Issues
+
+If you're using Next.js 15 and experiencing source mapping issues, refer to the [Next.js 15 Setup Guide](./NEXTJS_15_SETUP.md) for detailed troubleshooting steps.
+
+## License
+
+MIT

package/dist/Conversion.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface ConversionProps {
+    children: React.ReactNode;
+    type?: 'button' | 'link' | 'form' | 'cta' | 'purchase' | 'signup' | 'download' | 'contact' | 'demo' | 'custom';
+    category?: string;
+    label?: string;
+    value?: number;
+    metadata?: Record<string, any>;
+    disabled?: boolean;
+}
+export declare const Conversion: React.FC<ConversionProps>;
+export {};
+//# sourceMappingURL=Conversion.d.ts.map

package/dist/Conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conversion.d.ts","sourceRoot":"","sources":["../src/Conversion.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAGjD,UAAU,eAAe;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA0JhD,CAAC"}

package/dist/KeakToolbarShadow.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+export interface KeakToolbarShadowProps {
+    /** Initial position of the toolbar */
+    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    /** Theme variant */
+    theme?: "light" | "dark" | "auto" | "high-contrast" | "cluely";
+    /** API key for Keak services */
+    apiKey?: string;
+    /** Custom z-index for the toolbar */
+    zIndex?: number;
+    /** Callback when toolbar is mounted */
+    onMount?: (shadowRoot: ShadowRoot) => void;
+    /** Callback when toolbar is unmounted */
+    onUnmount?: () => void;
+    /** Custom CSS variables to override theme */
+    customTheme?: Record<string, string>;
+}
+export declare function KeakToolbarShadow({ position, theme, apiKey, zIndex, // max practical z-index
+onMount, onUnmount, customTheme }: KeakToolbarShadowProps): React.ReactPortal | null;
+export { KeakToolbarShadow as KeakToolbar };
+//# sourceMappingURL=KeakToolbarShadow.d.ts.map

package/dist/KeakToolbarShadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeakToolbarShadow.d.ts","sourceRoot":"","sources":["../src/KeakToolbarShadow.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;IACpE,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,QAAQ,CAAA;IAC9D,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAA;IAC1C,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAyB,EACzB,KAAc,EACd,MAAM,EACN,MAAmB,EAAE,wBAAwB;AAC7C,OAAO,EACP,SAAS,EACT,WAAW,EACZ,EAAE,sBAAsB,4BAmKxB;AAGD,OAAO,EAAE,iBAAiB,IAAI,WAAW,EAAE,CAAA"}

package/dist/components/ui/card.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+declare const Card: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent };
+//# sourceMappingURL=card.d.ts.map

package/dist/components/ui/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/components/ui/card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,QAAA,MAAM,IAAI,6GAYR,CAAC;AAGH,QAAA,MAAM,UAAU,6GASd,CAAC;AAGH,QAAA,MAAM,SAAS,uHAYb,CAAC;AAGH,QAAA,MAAM,eAAe,yHASnB,CAAC;AAGH,QAAA,MAAM,WAAW,6GAKf,CAAC;AAGH,QAAA,MAAM,UAAU,6GASd,CAAC;AAGH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/ui/html-preview.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface HTMLPreviewProps {
+    html: string;
+    className?: string;
+    title?: string;
+}
+export declare const HTMLPreview: React.FC<HTMLPreviewProps>;
+export {};
+//# sourceMappingURL=html-preview.d.ts.map

package/dist/components/ui/html-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-preview.d.ts","sourceRoot":"","sources":["../../../src/components/ui/html-preview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAGjD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA2GlD,CAAC"}

package/dist/components/ui/simple-tabs.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+interface TabsProps {
+    defaultValue: string;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare const Tabs: React.FC<TabsProps>;
+interface TabsListProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare const TabsList: React.FC<TabsListProps>;
+interface TabsTriggerProps {
+    value: string;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare const TabsTrigger: React.FC<TabsTriggerProps>;
+interface TabsContentProps {
+    value: string;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare const TabsContent: React.FC<TabsContentProps>;
+export {};
+//# sourceMappingURL=simple-tabs.d.ts.map

package/dist/components/ui/simple-tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-tabs.d.ts","sourceRoot":"","sources":["../../../src/components/ui/simple-tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8C,MAAM,OAAO,CAAC;AAUnE,UAAU,SAAS;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAUpC,CAAC;AAEF,UAAU,aAAa;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAM5C,CAAC;AAEF,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAqBlD,CAAC;AAEF,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAalD,CAAC"}

package/dist/components/ui/spinner.d.ts

@@ -0,0 +1,6 @@
+import { type LucideProps } from 'lucide-react';
+export type SpinnerProps = LucideProps & {
+    variant?: 'default' | 'circle' | 'pinwheel' | 'circle-filled' | 'ellipsis' | 'ring';
+};
+export declare const Spinner: ({ variant, ...props }: SpinnerProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/components/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/components/ui/spinner.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AA+ItB,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,OAAO,CAAC,EACJ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,eAAe,GACf,UAAU,GACV,MAAM,CAAC;CACZ,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,uBAAuB,YAAY,4CAe1D,CAAC"}

package/dist/components/ui/tabs.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+declare const Tabs: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const TabsList: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const TabsTrigger: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    value: string;
+    active?: boolean;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const TabsContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
+    value: string;
+    active?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+export { Tabs, TabsList, TabsTrigger, TabsContent };
+//# sourceMappingURL=tabs.d.ts.map

package/dist/components/ui/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../src/components/ui/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,QAAA,MAAM,IAAI,6GASR,CAAC;AAGH,QAAA,MAAM,QAAQ,6GAYZ,CAAC;AAGH,QAAA,MAAM,WAAW;WAGN,MAAM;aACJ,OAAO;2CAclB,CAAC;AAGH,QAAA,MAAM,WAAW;WAGN,MAAM;aACJ,OAAO;wCAYlB,CAAC;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/ui/textarea.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+}
+declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
+export { Textarea };
+//# sourceMappingURL=textarea.d.ts.map

package/dist/components/ui/textarea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../../src/components/ui/textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,aACf,SAAQ,KAAK,CAAC,sBAAsB,CAAC,mBAAmB,CAAC;CAAG;AAE9D,QAAA,MAAM,QAAQ,2FAab,CAAC;AAGF,OAAO,EAAE,QAAQ,EAAE,CAAC"}