rayo-editor 0.0.1

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useEditorDiff } from './useEditorDiff';
+export { useContentProcessing } from './useContentProcessing';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/useContentProcessing.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Hook for processing and transforming editor content
+ *
+ * Manages content state with processing status tracking and error handling.
+ * Useful for integrating with AI content transformation services or
+ * implementing custom content processing pipelines.
+ *
+ * @param initialContent - Initial content state (default: empty string)
+ * @returns Object with content state and processing utilities
+ *
+ * @returns {Object} Content processing state containing:
+ *   - content: string - Current processed content
+ *   - setContent: (content: string) => void - Directly set content
+ *   - isProcessing: boolean - Whether processing is in progress
+ *   - error: Error | null - Last processing error (if any)
+ *   - processContent: (content: string) => void - Process and update content
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   content,
+ *   isProcessing,
+ *   error,
+ *   processContent
+ * } = useContentProcessing('Initial content');
+ *
+ * const handleAIEnhance = async () => {
+ *   const enhanced = await fetch('/api/enhance', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ content })
+ *   }).then(r => r.json());
+ *
+ *   processContent(enhanced.content);
+ * };
+ *
+ * return (
+ *   <>
+ *     {error && <div className="error">{error.message}</div>}
+ *     <button onClick={handleAIEnhance} disabled={isProcessing}>
+ *       {isProcessing ? 'Processing...' : 'Enhance'}
+ *     </button>
+ *   </>
+ * );
+ * ```
+ *
+ * @example
+ * With RayoEditor:
+ * ```tsx
+ * const { content, isProcessing, processContent } = useContentProcessing('');
+ *
+ * return (
+ *   <RayoEditor
+ *     content={content}
+ *     title=""
+ *     onChange={processContent}
+ *     isLoading={isProcessing}
+ *     editorRef={editorRef}
+ *   />
+ * );
+ * ```
+ *
+ * @example
+ * Error handling:
+ * ```tsx
+ * const { content, isProcessing, error, processContent } = useContentProcessing();
+ *
+ * const safeProcess = useCallback((newContent: string) => {
+ *   try {
+ *     processContent(newContent);
+ *   } catch (err) {
+ *     console.error('Processing failed:', err);
+ *   }
+ * }, [processContent]);
+ * ```
+ */
+export declare const useContentProcessing: (initialContent?: string) => {
+    content: string;
+    setContent: import('react').Dispatch<import('react').SetStateAction<string>>;
+    isProcessing: boolean;
+    error: Error | null;
+    processContent: (newContent: string) => void;
+};
+//# sourceMappingURL=useContentProcessing.d.ts.map

package/dist/hooks/useContentProcessing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContentProcessing.d.ts","sourceRoot":"","sources":["../../src/hooks/useContentProcessing.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,eAAO,MAAM,oBAAoB,GAAI,iBAAgB,MAAW;;;;;iCAKd,MAAM;CAmBvD,CAAC"}

package/dist/hooks/useEditorDiff.d.ts

@@ -0,0 +1,65 @@
+import { DiffPair } from '../types/diff.types';
+/**
+ * Hook for managing diff detection and overlay state
+ *
+ * Tracks detected diff pairs, active/hover indices, and overlay positioning.
+ * Automatically throttles diff updates to prevent excessive processing.
+ *
+ * @param editorRef - Reference to the editor instance
+ * @param options - Optional configuration
+ * @param options.focusMode - Enable focus mode UI (default: false)
+ * @returns Object with diff state and control functions
+ *
+ * @returns {Object} Diff state object containing:
+ *   - diffPairs: DiffPair[] - Array of detected diff pairs
+ *   - setDiffPairs: (pairs: DiffPair[]) => void - Update diff pairs
+ *   - activePairIndex: number - Currently active pair index (-1 if none)
+ *   - setActivePairIndex: (index: number) => void - Set active pair
+ *   - hoverPairIndex: number - Currently hovered pair index
+ *   - setHoverPairIndex: (index: number) => void - Set hovered pair
+ *   - overlayHoleRect: Rect | null - Rectangle for overlay positioning
+ *   - setOverlayHoleRect: (rect: Rect | null) => void - Set overlay position
+ *   - updateDiffRanges: () => void - Trigger diff detection update
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   diffPairs,
+ *   activePairIndex,
+ *   hoverPairIndex,
+ *   updateDiffRanges
+ * } = useEditorDiff(editorRef, { focusMode: false });
+ *
+ * // Update when needed
+ * useEffect(() => {
+ *   updateDiffRanges();
+ * }, [content]);
+ * ```
+ *
+ * @example
+ * Interactive diff UI:
+ * ```tsx
+ * const {
+ *   diffPairs,
+ *   setActivePairIndex,
+ *   setHoverPairIndex
+ * } = useEditorDiff(editorRef);
+ *
+ * // Use diffPairs to render interactive UI elements
+ * // with hover and click handlers
+ * ```
+ */
+export declare const useEditorDiff: (_editorRef: any, _options?: {
+    focusMode?: boolean;
+}) => {
+    diffPairs: DiffPair[];
+    setDiffPairs: import('react').Dispatch<import('react').SetStateAction<DiffPair[]>>;
+    activePairIndex: number;
+    setActivePairIndex: import('react').Dispatch<import('react').SetStateAction<number>>;
+    hoverPairIndex: number;
+    setHoverPairIndex: import('react').Dispatch<import('react').SetStateAction<number>>;
+    overlayHoleRect: any;
+    setOverlayHoleRect: import('react').Dispatch<any>;
+    updateDiffRanges: () => void;
+};
+//# sourceMappingURL=useEditorDiff.d.ts.map

package/dist/hooks/useEditorDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditorDiff.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditorDiff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,GAAG,EAAE,WAAW;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;CAwChF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,213 @@
+/**
+ * @fileoverview rayo-editor - A professional-grade rich text editor for React
+ *
+ * This module provides a complete rich text editing solution with:
+ * - Full HTML editing with TipTap
+ * - Diff highlighting and review UI
+ * - Image and table support
+ * - TypeScript definitions
+ * - Comprehensive utilities
+ *
+ * @example
+ * ```tsx
+ * import { RayoEditor } from 'rayo-editor';
+ * import 'rayo-editor/styles';
+ *
+ * <RayoEditor
+ *   content={content}
+ *   title={title}
+ *   onChange={setContent}
+ *   onTitleChange={setTitle}
+ *   isLoading={false}
+ *   editorRef={editorRef}
+ * />
+ * ```
+ */
+/**
+ * Main Rayo Editor component - a drop-in rich blog editor
+ * Features diff highlighting, review UI, and full content control
+ */
+export { RayoEditor } from './components';
+/**
+ * Legacy BlogEditor component - alias for RayoEditor
+ * Maintained for backward compatibility
+ * @deprecated Use RayoEditor instead
+ */
+export { BlogEditor } from './components';
+/**
+ * Standalone title input component
+ * Supports read-only mode and custom change callbacks
+ */
+export { TitleTextarea } from './components';
+/**
+ * Visual overlay for displaying diff highlights
+ * Shows green additions and red deletions with interactive hover/click
+ */
+export { DiffOverlay } from './components';
+/**
+ * Accept/reject buttons for review operations
+ * Positioned absolutely with configurable placement
+ */
+export { ReviewButtons } from './components';
+/**
+ * Image loading state indicator with Rive animation
+ */
+export { ImageGenerationLoader } from './components';
+/**
+ * Hook for managing diff detection and overlay state
+ * Tracks diff pairs, active indices, and hover states
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   diffPairs,
+ *   activePairIndex,
+ *   updateDiffRanges
+ * } = useEditorDiff(editorRef, { focusMode: false });
+ * ```
+ */
+export { useEditorDiff } from './hooks';
+/**
+ * Hook for processing and transforming editor content
+ * Handles content state, processing flags, and error management
+ *
+ * @example
+ * ```tsx
+ * const { content, isProcessing, error, processContent } = useContentProcessing();
+ * ```
+ */
+export { useContentProcessing } from './hooks';
+/**
+ * Detect diff markers in HTML content
+ * Returns markers for insertions, deletions, and highlights
+ *
+ * @example
+ * ```tsx
+ * const { hasDiffs, markers } = detectDiffMarkers(content);
+ * ```
+ */
+export { detectDiffMarkers } from './utils';
+/**
+ * Normalize diff text for consistent comparison
+ * Strips HTML tags and normalizes whitespace
+ */
+export { normalizeDiffText } from './utils';
+/**
+ * Extract diff ranges from content
+ * Returns arrays of {from, to} positions for changes
+ */
+export { extractDiffRanges } from './utils';
+/**
+ * Merge consecutive or overlapping ranges
+ * Optimizes ranges for rendering and processing
+ */
+export { mergeConsecutiveRanges } from './utils';
+/**
+ * Extract plain text from HTML content
+ * Removes all tags and returns readable text
+ */
+export { extractTextContent } from './utils';
+/**
+ * Optimize ranges for rendering performance
+ * Removes overlaps and sorts by position
+ */
+export { optimizeRanges } from './utils';
+/**
+ * Group consecutive images in content
+ * Returns array of image operations with positions
+ */
+export { groupConsecutiveImages } from './utils';
+/**
+ * Match image replacements in diff pairs
+ * Identifies old→new image mappings
+ */
+export { matchImageReplacements } from './utils';
+/**
+ * Calculate proximity score between text segments
+ * Returns 0-1 similarity score
+ */
+export { calculateProximity } from './utils';
+/**
+ * Find the best matching text pair from candidates
+ * Uses proximity matching for robust matching
+ */
+export { findOwnerTextPair } from './utils';
+/**
+ * Group consecutive items by similarity
+ * Returns grouped arrays of related items
+ */
+export { groupConsecutiveItems } from './utils';
+/**
+ * Custom error class for diff processing failures
+ * Extends Error with original error chain
+ */
+export { DiffProcessingError } from './utils';
+/**
+ * Safely execute a function with error handling
+ * Returns result or null if error occurs
+ *
+ * @example
+ * ```tsx
+ * const result = safeExecute(() => riskyOperation());
+ * ```
+ */
+export { safeExecute } from './utils';
+/**
+ * Props for the RayoEditor component
+ * Includes all configuration, state, and callback options
+ */
+export type { RayoEditorProps } from './types/editor.types';
+/**
+ * Reference object for BlogSimpleEditor instance
+ * Provides access to underlying TipTap editor
+ */
+export type { BlogSimpleEditorRef } from './types/editor.types';
+/**
+ * Props for the TitleTextarea component
+ */
+export type { TitleTextareaProps } from './types/editor.types';
+/**
+ * Props for the DiffOverlay component
+ */
+export type { DiffOverlayProps } from './types/editor.types';
+/**
+ * Props for the ReviewButtons component
+ */
+export type { ReviewButtonsProps } from './types/editor.types';
+/**
+ * Represents a text range with start and end positions
+ */
+export type { DiffRange } from './types/diff.types';
+/**
+ * Represents a pair of diff ranges (old and new content)
+ */
+export type { DiffPair } from './types/diff.types';
+/**
+ * Rectangle coordinates for positioning overlays
+ */
+export type { DiffRect } from './types/diff.types';
+/**
+ * Marker indicating a diff location in content
+ */
+export type { DiffMarker } from './types/diff.types';
+/**
+ * Result object from diff marker detection
+ */
+export type { DiffMarkerResult } from './types/diff.types';
+/**
+ * Operation representing an image change
+ */
+export type { ImageOperation } from './types/diff.types';
+/**
+ * Operation representing a table change
+ */
+export type { TableOperation } from './types/diff.types';
+/**
+ * Operation representing a code block change
+ */
+export type { CodeBlockOperation } from './types/diff.types';
+/**
+ * Highlight information for rendering
+ */
+export type { HighlightInfo } from './types/diff.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;GAQG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;GAGG;AACH,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;GAGG;AACH,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;GAEG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;GAEG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}