@djangocfg/layouts 2.1.226 → 2.1.228

package/src/snippets/McpChat/types.ts

@@ -1,189 +0,0 @@
-/**
- * Types for @djangocfg/mcp-chat
- */
-
-// Re-export config constants for backwards compatibility
-export { DEFAULT_CHAT_API_ENDPOINT, mcpEndpoints, getMcpEndpoints } from './config';
-
-/**
- * AI Chat message role
- */
-export type AIMessageRole = 'user' | 'assistant' | 'system';
-
-/**
- * AI Chat message
- */
-export interface AIChatMessage {
-  id: string;
-  role: AIMessageRole;
-  content: string;
-  timestamp: Date;
-  /** Related documentation links */
-  sources?: AIChatSource[];
-  /** Is message still being generated */
-  isStreaming?: boolean;
-}
-
-/**
- * AI Documentation source reference
- */
-export interface AIChatSource {
-  title: string;
-  path: string;
-  url?: string;
-  section?: string;
-  score?: number;
-}
-
-/**
- * Chat API response
- */
-export interface ChatApiResponse {
-  success: boolean;
-  results?: Array<{
-    chunk: {
-      id: string;
-      path: string;
-      title: string;
-      section?: string;
-      content: string;
-      url?: string;
-    };
-    score: number;
-  }>;
-  answer?: string;
-  error?: string;
-}
-
-/**
- * Chat display mode
- * - closed: Only FAB button visible
- * - floating: Floating panel (default)
- * - sidebar: Full-height sidebar on the right (desktop only)
- */
-export type ChatDisplayMode = 'closed' | 'floating' | 'sidebar';
-
-/**
- * Chat widget configuration
- */
-export interface ChatWidgetConfig {
-  /** API endpoint for chat (default: /api/chat) */
-  apiEndpoint?: string;
-  /** Widget title */
-  title?: string;
-  /** Placeholder text for input */
-  placeholder?: string;
-  /** Initial greeting message */
-  greeting?: string;
-  /** Position on screen */
-  position?: 'bottom-right' | 'bottom-left';
-  /** Theme variant */
-  variant?: 'default' | 'minimal';
-  /** Auto-detect environment (dev/prod) for API endpoint. If false (default), always uses production */
-  autoDetectEnvironment?: boolean;
-}
-
-// =============================================================================
-// AI Chat Types
-// =============================================================================
-
-/**
- * AI Chat API response
- */
-export interface AIChatApiResponse {
-  success: boolean;
-  content?: string;
-  sources?: Array<{
-    id?: string;
-    title: string;
-    path: string;
-    url?: string;
-    section?: string;
-    score?: number;
-  }>;
-  threadId?: string;
-  usage?: {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-  };
-  error?: string;
-}
-
-/**
- * useAIChat hook options
- */
-export interface UseAIChatOptions {
-  /** API endpoint (default: /api/ai/chat) */
-  apiEndpoint?: string;
-  /** Initial messages */
-  initialMessages?: AIChatMessage[];
-  /** Callback on error */
-  onError?: (error: Error) => void;
-  /** Enable streaming responses (default: true) */
-  enableStreaming?: boolean;
-  /** Thread ID for conversation (generated if not provided) */
-  threadId?: string;
-  /** User ID for conversation (generated if not provided) */
-  userId?: string;
-}
-
-/**
- * useAIChat hook return type
- */
-export interface UseAIChatReturn {
-  messages: AIChatMessage[];
-  isLoading: boolean;
-  error: Error | null;
-  threadId: string;
-  userId: string;
-  sendMessage: (content: string) => Promise<void>;
-  clearMessages: () => void;
-  stopStreaming: () => void;
-}
-
-// =============================================================================
-// MCP Chat Events (Global Chat Trigger)
-// =============================================================================
-
-/**
- * Context type for chat messages triggered from different parts of the app
- */
-export type McpChatContextType =
-  | 'error'      // Error explanation
-  | 'question'   // General question
-  | 'explain'    // Explain something
-  | 'advice'     // Get advice
-  | 'help'       // Help request
-  | 'custom';    // Custom context
-
-/**
- * Event detail for mcp:chat:send custom event
- */
-export interface McpChatEventDetail {
-  /** Message to send to chat */
-  message: string;
-  /** Optional context about the message */
-  context?: {
-    /** Type of context */
-    type?: McpChatContextType;
-    /** Additional data (error object, selected element, etc.) */
-    data?: Record<string, any>;
-    /** Source component/page that triggered the event */
-    source?: string;
-  };
-  /** Auto-send message after opening chat (default: true) */
-  autoSend?: boolean;
-  /** Open chat in specific mode (default: 'floating') */
-  displayMode?: ChatDisplayMode;
-}
-
-/**
- * useMcpChat hook return type
- */
-export interface UseMcpChatReturn {
-  /** Send message to chat from anywhere in the app */
-  sendToChat: (detail: McpChatEventDetail) => void;
-  /** Check if chat is available */
-  isChatAvailable: () => boolean;
-}

package/src/snippets/PWAInstall/@docs/README.md

@@ -1,92 +0,0 @@
-# PWAInstall Documentation
-
-Comprehensive documentation for the PWAInstall snippet.
-
-## Overview
-
-PWAInstall handles **Progressive Web App installation** on user devices (Add to Home Screen functionality).
-
-**Responsibility**: Device installation only (not push notifications)
-
-## Documentation Structure
-
-### `/research/`
-Research and best practices:
-- **[ios-android-install-flows.md](./research/ios-android-install-flows.md)** - iOS vs Android PWA installation patterns, limitations, and best practices (2024-2025)
-
-### `/architecture/`
-Architecture and design:
-- Coming soon: Architecture decisions, component design, state management
-
-### `/legacy/`
-Historical documentation:
-- Old architecture analysis (before snippet split)
-- Refactoring history
-
-## Quick Navigation
-
-### For Users
-Start here if you want to use PWAInstall:
-- [Main README](../README.md) - Quick start and API reference
-- [Migration Guide](../../MIGRATION.md) - Migrating from old PWA snippet
-
-### For Contributors
-Start here if you want to understand or modify PWAInstall:
-- [iOS/Android Install Flows](./research/ios-android-install-flows.md) - Platform-specific behavior
-- [Architecture](./architecture/) - How it's built
-
-### For Researchers
-Start here if you want to understand PWA installation patterns:
-- [Research](./research/) - Industry research and best practices
-
-## Key Concepts
-
-### Platform Asymmetry
-
-| Aspect | Android Chrome | iOS Safari |
-|--------|----------------|------------|
-| Install API | `beforeinstallprompt` | ❌ No API |
-| User effort | 1 tap | 3-4 taps |
-| Detection | Event-based | Heuristic |
-| Guidance | Optional | **Required** |
-
-**PWAInstall handles this asymmetry transparently.**
-
-### Components
-
-```
-A2HSHint (Unified hint)
-├── Android → Native install prompt
-└── iOS → Visual guide (IOSGuide)
-    ├── Mobile → IOSGuideDrawer
-    └── Desktop → IOSGuideModal
-```
-
-### State Management
-
-```
-useInstall() hook
-├── Platform detection (isIOS, isAndroid, isSafari)
-├── Installation state (isInstalled, canPrompt)
-└── Install action (install())
-```
-
-## Related Documentation
-
-- **[PushNotifications Docs](../../PushNotifications/@docs/)** - Web push notifications (separate concern)
-- **[Refactoring Summary](../../REFACTORING_SUMMARY.md)** - Why snippets were split
-- **[Migration Guide](../../MIGRATION.md)** - How to migrate from old PWA snippet
-
-## Contributing
-
-When adding documentation:
-1. **Research** → `/research/` - Industry patterns, browser behavior
-2. **Architecture** → `/architecture/` - Design decisions, component structure
-3. **Historical** → `/legacy/` - Old docs (keep for reference)
-
-## Questions?
-
-- Implementation questions → See [Main README](../README.md)
-- Architecture questions → See [/architecture/](./architecture/)
-- Platform behavior → See [/research/](./research/)
-- Migration questions → See [Migration Guide](../../MIGRATION.md)