@chrryai/chrry 1.1.89 → 1.1.95

package/README.md

@@ -1,18 +1,29 @@
 # 🍒 Chrry
 
-**A modern, cross-platform UI library for React, React Native, and Next.js**
+**Production-ready React component library for building AI applications**
 
-Built by the team behind [Vex](https://askvex.com) - the AI assistant that helps you get things done.
+[![npm](https://img.shields.io/npm/v/@chrryai/chrry)](https://www.npmjs.com/package/@chrryai/chrry)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-## ✨ Features
+> Extracted from [Vex](https://askvex.com) - A production AI platform with 6,813+ commits in 2025
 
-- 🎨 **Beautiful Components** - Modern, accessible UI components
-- 📱 **Cross-Platform** - Works on Web, iOS, Android, and Browser Extensions
-- 🎯 **TypeScript First** - Full type safety out of the box
+---
+
+## ✨ What is Chrry?
+
+Chrry is a comprehensive React component library built for AI applications. It includes everything you need to build ChatGPT-like interfaces, multi-tenant app stores, and real-time collaboration features.
+
+**Key Features:**
+
+- 🎨 **50+ Components** - Chat, modals, forms, layouts, and more
+- 🤖 **AI-First** - Built specifically for AI chat interfaces
+- 📱 **Cross-Platform** - Web, iOS, Android, Browser Extensions
+- 🎯 **TypeScript** - Full type safety throughout
 - 🌙 **Dark Mode** - Built-in theme support
-- 🌍 **i18n Ready** - Multi-language support included
-- ⚡ **Performance** - Optimized for speed and bundle size
-- 🎭 **Customizable** - Easy to theme and extend
+- 🌍 **i18n** - 10+ languages included
+- ⚡ **Performance** - Optimized for production
+- 🎭 **Customizable** - SCSS modules for easy theming
 
 ## 🌶️ Pepper Router
 
@@ -35,22 +46,70 @@ npm install @chrryai/pepper
 
 ```bash
 npm install @chrryai/chrry
+# or
+pnpm add @chrryai/chrry
+# or
+yarn add @chrryai/chrry
 ```
 
 **Note:** Chrry is published as TypeScript source. Your bundler (Next.js, Vite, etc.) will compile it.
 
+---
+
 ## 🚀 Quick Start
 
+### Basic Usage
+
 ```tsx
-import { Button, Modal, Chat } from "@chrryai/chrry"
-import { Star, Heart } from "@chrryai/chrry/icons"
+import { Chat, Button, Modal } from "@chrryai/chrry"
+import { Star } from "@chrryai/chrry/icons"
 
 function App() {
   return (
-    <div>
+    <>
+      <Chat />
       <Button>Click me</Button>
       <Star size={24} />
-    </div>
+    </>
+  )
+}
+```
+
+### With ChrryAI Layout (Full Next.js Integration)
+
+```tsx
+import ChrryAI from "@chrryai/chrry/ChrryAI"
+import { cookies, headers } from "next/headers"
+
+export default async function RootLayout({ children }) {
+  const headersList = await headers()
+  const cookieStore = await cookies()
+
+  return (
+    <ChrryAI
+      apiKey={process.env.API_KEY}
+      locale="en"
+      headersList={headersList}
+      cookieStore={cookieStore}
+    >
+      {children}
+    </ChrryAI>
+  )
+}
+```
+
+### With Standalone Chrry Provider
+
+For non-Next.js apps or custom setups:
+
+```tsx
+import Chrry from "@chrryai/chrry/Chrry"
+
+export default function App({ children, session }) {
+  return (
+    <Chrry session={session} viewPortWidth="100vw" viewPortHeight="100vh">
+      {children}
+    </Chrry>
   )
 }
 ```
@@ -61,14 +120,56 @@ Visit [chrry.dev](https://chrry.dev) for full documentation, examples, and guide
 
 ## 🛠️ Components
 
-Chrry includes 50+ production-ready components:
+### AI & Chat
+
+- **Chat** - Full-featured AI chat interface
+- **Message** - Individual message component with streaming
+- **Messages** - Message list with virtualization
+- **Thread** - Complete thread view
+- **Threads** - Thread list with search/filter
+- **Agent** - AI agent selector
+- **TypingIndicator** - Animated typing indicator
+
+### Layout
 
-- **Layout**: Sidebar, Menu, Modal, Skeleton
-- **Forms**: Input, Select, Checkbox, Search
-- **Data Display**: Message, Thread, Calendar, Weather
-- **Feedback**: Loading, Toast, EmptyState
-- **Navigation**: Breadcrumbs, Tabs, Pagination
-- **And many more...**
+- **ChrryAI** - Complete app layout with session management
+- **Sidebar** - Collapsible navigation sidebar
+- **Menu** - Dropdown menu component
+- **Modal** - Accessible modal dialogs
+- **Skeleton** - Loading skeletons
+
+### Forms & Input
+
+- **Button** - Customizable button component
+- **Input** - Text input with validation
+- **Select** - Dropdown select
+- **Checkbox** - Checkbox with label
+- **Search** - Search input with autocomplete
+- **FileUpload** - Drag & drop file upload
+
+### Data Display
+
+- **Calendar** - Full calendar with events
+- **Weather** - Weather widget
+- **CharacterProfiles** - AI personality profiles
+- **Store** - App store interface
+- **App** - Individual app card
+
+### Feedback
+
+- **Loading** - Loading spinners
+- **Toast** - Toast notifications
+- **EmptyStateTips** - Empty state with tips
+- **ConfirmButton** - Confirmation dialogs
+
+### Utilities
+
+- **Image** - Optimized image component
+- **MarkdownContent** - Markdown renderer
+- **ColorScheme** - Theme switcher
+- **LanguageSwitcher** - i18n language selector
+
+**And 20+ more components!**
 
 ## 🎨 Theming
 
@@ -92,17 +193,76 @@ import { locale } from "@chrryai/chrry/locales"
 // Supports: en, es, fr, de, ja, ko, nl, pt, tr, zh
 ```
 
+## 🏗️ Architecture
+
+Chrry is built with:
+
+- **Next.js 15** - App Router with RSC
+- **TypeScript 5** - Full type safety
+- **SCSS Modules** - Scoped styling
+- **Drizzle ORM** - Type-safe database queries
+- **WebSockets** - Real-time features
+- **next-intl** - Internationalization
+
+## 🌍 Supported Languages
+
+- English (en)
+- Spanish (es)
+- French (fr)
+- German (de)
+- Japanese (ja)
+- Korean (ko)
+- Dutch (nl)
+- Portuguese (pt)
+- Turkish (tr)
+- Chinese (zh)
+
 ## 🤝 Contributing
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+We welcome contributions! Chrry is extracted from [Vex](https://github.com/ibsukru/vex), a production AI platform.
+
+### Development
+
+```bash
+# Clone the monorepo
+git clone https://github.com/ibsukru/vex.git
+cd vex
+
+# Install dependencies
+pnpm install
+
+# Start development
+pnpm dev
+```
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
 
 ## 🔗 Links
 
-- [Website](https://chrry.dev)
-- [Documentation](https://chrry.dev/docs)
-- [GitHub](https://github.com/AskVex/chrry)
-- [npm](https://www.npmjs.com/package/@chrryai/chrry)
+- **Website:** [chrry.dev](https://chrry.dev)
+- **Documentation:** [chrry.dev/docs](https://chrry.dev/docs)
+- **GitHub:** [@chrryai/chrry](https://github.com/chrryai/chrry)
+- **npm:** [@chrryai/chrry](https://www.npmjs.com/package/@chrryai/chrry)
+- **Chrry:** [chrry.ai](https://chrry.ai)
+- **Vex:** [vex.chrry.ai](https://vex.chrry.ai)
+
+---
+
+## 💎 Why Chrry?
+
+**Most AI component libraries are basic.** Chrry is different:
+
+✅ **Production-Ready** - Extracted from a real AI platform
+✅ **Complete** - 50+ components, not just a chat box
+✅ **Multi-Tenant** - Build app stores, not just apps
+✅ **Real-Time** - WebSocket collaboration built-in
+✅ **i18n** - 10 languages out of the box
+✅ **TypeScript** - Full type safety throughout
+
+**This is a $10M+ component library, open-sourced for free.** 🎁
 
 ---
 
-**Built with ❤️ by the Vex team**
+**Built with ❤️ by [@ibsukru](https://github.com/ibsukru)**

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import z$1, { z } from 'zod';
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
+import { Metadata } from 'next';
 
 declare function useLocalStorage<T>(key: string, initialValue: T | (() => T)): readonly [T, (value: T | ((t: T) => T)) => Promise<void>];
 
@@ -132,6 +133,9 @@ type sessionUser = user;
 type sessionGuest = guest;
 type session = {
     env?: "development" | "production" | "staging";
+    TEST_GUEST_FINGERPRINTS?: string[];
+    TEST_MEMBER_FINGERPRINTS?: string[];
+    TEST_MEMBER_EMAILS?: string[];
     fingerprint?: string;
     token?: string;
     aiAgents?: aiAgent[];
@@ -827,8 +831,8 @@ declare const appSchema: z.ZodObject<{
         Peach: "Peach";
         Vault: "Vault";
         Bloom: "Bloom";
-        Vex: "Vex";
         Chrry: "Chrry";
+        Vex: "Vex";
     }>, z.ZodString]>>>;
     onlyAgent: z.ZodOptional<z.ZodBoolean>;
     themeColor: z.ZodOptional<z.ZodString>;
@@ -842,6 +846,31 @@ declare const appSchema: z.ZodObject<{
 }, z.core.$strip>;
 type appFormData = z.infer<typeof appSchema>;
 
+declare const getImageSrc: ({ app, icon, logo, store, PROD_FRONTEND_URL, src, slug, size, BASE_URL, width, height, canEditApp, image, }: {
+    slug?: "atlas" | "peach" | "vault" | "bloom";
+    className?: string;
+    size?: number;
+    title?: string;
+    showLoading?: boolean;
+    dataTestId?: string;
+    src?: string;
+    logo?: "lifeOS" | "isMagenta" | "isVivid" | "vex" | "chrry";
+    icon?: "spaceInvader" | "pacman" | "heart" | "plus" | "hamster" | "frog" | "calendar" | "deepSeek" | "perplexity" | "claude" | "chatGPT" | "gemini" | "flux" | "chrry" | "raspberry" | "strawberry";
+    app?: appWithStore;
+    width?: number | string;
+    height?: number | string;
+    onLoad?: () => void;
+    store?: store;
+    PROD_FRONTEND_URL?: string;
+    BASE_URL?: string;
+    canEditApp?: boolean;
+    image?: string;
+}) => {
+    src: string;
+    width: number;
+    height: number;
+    size: number;
+};
 declare const getThreads: ({ pageSize, token, search, sort, threadId, userName, collaborationStatus, myPendingCollaborations, onError, slug, appId, API_URL, }: {
     pageSize?: number;
     token: string;
@@ -1024,11 +1053,12 @@ declare function reorderApps({ token, apps, autoInstall, API_URL, }: {
     autoInstall?: boolean;
     API_URL?: string;
 }): Promise<any>;
-declare const getSession: ({ deviceId, fingerprint, gift, isStandalone, token, API_URL, VERSION, app, appSlug, agentName, chrryUrl, }: {
+declare const getSession: ({ deviceId, fingerprint, gift, isStandalone, appId, token, API_URL, VERSION, app, appSlug, agentName, chrryUrl, routeType, userAgent, screenWidth, screenHeight, }: {
+    appId?: string;
     deviceId: string | undefined;
     fingerprint?: string;
     gift?: string;
-    isStandalone: boolean;
+    isStandalone?: boolean;
     token: string;
     API_URL?: string;
     VERSION?: string;
@@ -1036,6 +1066,10 @@ declare const getSession: ({ deviceId, fingerprint, gift, isStandalone, token, A
     appSlug?: string;
     agentName?: string;
     chrryUrl?: string;
+    routeType?: string;
+    userAgent?: string;
+    screenWidth?: number;
+    screenHeight?: number;
 }) => Promise<session | {
     error?: string;
     status?: number;
@@ -1199,6 +1233,25 @@ declare const getHourlyLimit: ({ member, guest, app, }: {
     }) | null;
 }) => 30 | 100 | 5000 | 500 | 200 | 10;
 
+/**
+ * Generate dynamic metadata for an app page
+ *
+ * @example
+ * ```typescript
+ * export async function generateMetadata({ params }) {
+ *   const app = await getApp({ slug: params.slug })
+ *   const store = await getStore({ slug: params.id })
+ *   return generateAppMetadata({ app, store, locale: params.locale })
+ * }
+ * ```
+ */
+declare function generateAppMetadata({ app, store, locale, currentDomain, }: {
+    app: appWithStore;
+    store: storeWithApps;
+    locale?: string;
+    currentDomain: string;
+}): Metadata;
+
 type BrowserAPIType = typeof chrome | typeof browser;
 
 declare const checkIsExtension: () => boolean;
@@ -1225,12 +1278,9 @@ declare const PROMPT_LIMITS: {
     WARNING_THRESHOLD: number;
     THREAD_TITLE: number;
 };
-declare const TEST_GUEST_FINGERPRINTS: string[];
-declare const TEST_MEMBER_FINGERPRINTS: string[];
 declare const expenseCategory: readonly ["food", "transport", "entertainment", "shopping", "bills", "health", "education", "travel", "other"];
 type expenseCategoryType = (typeof expenseCategory)[number];
 declare const budgetCategory: readonly ["food", "transport", "entertainment", "shopping", "bills", "health", "education", "travel", "other"];
-declare const TEST_MEMBER_EMAILS: string[];
 declare const isCI: string | undefined;
 declare const isE2E: boolean;
 declare const extensionSuggestions: {
@@ -1254,32 +1304,66 @@ declare const pageSizes: {
 declare const getBrowserAPI: () => BrowserAPIType | null;
 declare const BrowserInstance: BrowserAPIType | null;
 declare function capitalizeFirstLetter(val: string): string;
+declare const getMetadata: ({ title, description, keywords, robots, locale, alternates, }?: {
+    manifest?: string;
+    title?: string;
+    description?: string;
+    keywords?: string[];
+    locale?: string;
+    robots?: {
+        index: boolean;
+        follow: boolean;
+    };
+    alternates?: {
+        canonical?: string;
+        languages?: Record<string, string>;
+    };
+}) => {
+    openGraph: {
+        title: string;
+        description: string;
+        url: string;
+        siteName: string;
+        images: {
+            url: string;
+            width: number;
+            height: number;
+        }[];
+        locale: string;
+        type: string;
+    };
+    twitter: {
+        title: string;
+        description: string;
+        card: string;
+        site: string;
+        creator: string;
+        images: {
+            url: string;
+            width: number;
+            height: number;
+        }[];
+    };
+    robots: {
+        index: boolean;
+        follow: boolean;
+    } | undefined;
+    keywords?: string | undefined;
+    metadataBase: URL;
+    alternates: {
+        canonical?: string;
+        languages?: Record<string, string>;
+    };
+    title: string;
+    icons: string[];
+    description: string;
+};
 declare const removeParam: (key: string) => void;
-declare function trackPlausibleEvent({ name, url, domain, browser, device, os, props, isPWA, }: {
-    name: string;
-    url?: string;
-    domain?: string;
-    browser?: string;
-    device?: string;
-    os?: string;
-    isPWA?: boolean;
-    props?: Record<string, any>;
-}): void;
-declare const trackEvent: ({ name, url, domain, props, device, os, browser, isPWA, }: {
-    name: string;
-    url?: string;
-    domain?: string;
-    props?: Record<string, any>;
-    device?: string;
-    os?: string;
-    browser?: string;
-    isPWA?: boolean;
-}) => void;
 declare const isFirefox: boolean;
 declare function getFlag({ code }: {
     code?: string;
 }): string;
-declare const VERSION = "1.1.89";
+declare const VERSION = "1.1.95";
 type instructionBase = {
     id: string;
     title: string;
@@ -1416,4 +1500,4 @@ interface HistoryRouterProviderProps {
  */
 declare function HistoryRouterProvider({ children, }: HistoryRouterProviderProps): React.JSX.Element;
 
-export { ADDITIONAL_CREDITS, API_URL, type ApiActions, BrowserInstance, CHRRY_URL, CREDITS_PRICE, type CalendarEventFormData, Chrry, FREE_DAYS, FRONTEND_URL, HistoryRouterProvider, MAX_FILE_SIZES, MAX_TOOL_CALLS_PER_MESSAGE, OWNER_CREDITS, PDF_LIMITS, PLUS_PRICE, PROD_FRONTEND_URL, PROMPT_LIMITS, PRO_PRICE, Sidebar, Store, TEST_GUEST_FINGERPRINTS, TEST_MEMBER_EMAILS, TEST_MEMBER_FINGERPRINTS, VERSION, WS_URL, addParam, apiFetch, budgetCategory, capitalizeFirstLetter, checkIsExtension, checkThreadSummaryLimit, createApp, createCalendarEvent, deleteApp, deleteCalendarEvent, deleteMemories, deleteMessage, deleteSubscription, exampleInstructions, expenseCategory, type expenseCategoryType, exportToGoogleCalendar, extensionSuggestions, getActions, getBrowserAPI, getBrowserIdentity, getCalendarEvents, getDailyImageLimit, getExampleInstructions, getExtensionUrl, getFlag, getGuest, getHourlyLimit, getInstructionConfig, getLastMessage, getRedirectURL, getSession, getThread, getThreads, getUser, getUsers, getWeatherCacheTime, type instructionBase, isCI, isCollaborator, isDeepEqual, isDevelopment, isE2E, isFirefox, isOwner, isValidUsername, pageSizes, removeParam, removeUser, reorderApps, storage, syncGoogleCalendar, trackEvent, trackPlausibleEvent, updateApp, updateCalendarEvent, updateCollaboration, updateGuest, updateMessage, updateThread, updateUser, uploadUserImage, useCountdown, useDeviceInfo, useHasHydrated, useLocalStorage, usePWAInstall };
+export { ADDITIONAL_CREDITS, API_URL, type ApiActions, BrowserInstance, CHRRY_URL, CREDITS_PRICE, type CalendarEventFormData, Chrry, FREE_DAYS, FRONTEND_URL, HistoryRouterProvider, MAX_FILE_SIZES, MAX_TOOL_CALLS_PER_MESSAGE, OWNER_CREDITS, PDF_LIMITS, PLUS_PRICE, PROD_FRONTEND_URL, PROMPT_LIMITS, PRO_PRICE, Sidebar, Store, VERSION, WS_URL, addParam, apiFetch, budgetCategory, capitalizeFirstLetter, checkIsExtension, checkThreadSummaryLimit, createApp, createCalendarEvent, deleteApp, deleteCalendarEvent, deleteMemories, deleteMessage, deleteSubscription, exampleInstructions, expenseCategory, type expenseCategoryType, exportToGoogleCalendar, extensionSuggestions, generateAppMetadata, getActions, getBrowserAPI, getBrowserIdentity, getCalendarEvents, getDailyImageLimit, getExampleInstructions, getExtensionUrl, getFlag, getGuest, getHourlyLimit, getImageSrc, getInstructionConfig, getLastMessage, getMetadata, getRedirectURL, getSession, getThread, getThreads, getUser, getUsers, getWeatherCacheTime, type instructionBase, isCI, isCollaborator, isDeepEqual, isDevelopment, isE2E, isFirefox, isOwner, isValidUsername, pageSizes, removeParam, removeUser, reorderApps, storage, syncGoogleCalendar, updateApp, updateCalendarEvent, updateCollaboration, updateGuest, updateMessage, updateThread, updateUser, uploadUserImage, useCountdown, useDeviceInfo, useHasHydrated, useLocalStorage, usePWAInstall };