@refactico/pages 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { default as default_2 } from 'react';
+import { JSX } from 'react/jsx-runtime';
 import { RefObject } from 'react';
 
 /**
@@ -11,6 +12,23 @@ export declare const ALIGNMENT_CLASSES: {
     readonly justify: "text-justify";
 };
 
+export declare interface BlockDiff {
+    type: DiffType;
+    oldBlock?: EditorBlock;
+    newBlock?: EditorBlock;
+    changes?: PropertyChange[];
+}
+
+/**
+ * Renders an EditorBlock in read-only mode for diff visualization
+ */
+export declare function BlockRenderer({ block, theme }: BlockRendererProps): JSX.Element | null;
+
+declare interface BlockRendererProps {
+    block: EditorBlock;
+    theme: Theme;
+}
+
 export declare type BlockType = 'text' | 'heading' | 'image' | 'code' | 'table' | 'divider' | 'quote' | 'list' | 'callout';
 
 export declare const CALLOUT_ICONS: {
@@ -134,6 +152,11 @@ export declare interface CodeBlock {
     filename?: string;
 }
 
+/**
+ * Compare two EditorData objects and return diff result
+ */
+export declare function compareEditorData(oldData: EditorData, newData: EditorData): DiffResult;
+
 export declare const createCalloutBlock: (variant?: "info" | "warning" | "success" | "error" | "tip") => EditorBlock;
 
 export declare const createCodeBlock: (code?: string, language?: string) => EditorBlock;
@@ -154,6 +177,25 @@ export declare const createTableBlock: (rows?: number, cols?: number) => EditorB
 
 export declare const createTextBlock: (content?: string) => EditorBlock;
 
+/**
+ * Deep compare two values and return if they are equal
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+
+export declare interface DiffResult {
+    blocks: BlockDiff[];
+    summary: DiffSummary;
+}
+
+export declare interface DiffSummary {
+    added: number;
+    removed: number;
+    modified: number;
+    unchanged: number;
+}
+
+export declare type DiffType = 'added' | 'removed' | 'modified' | 'unchanged';
+
 /**
  * Divider style mapping
  */
@@ -190,6 +232,11 @@ export declare const FONT_SIZE_CLASSES: {
     readonly xl: "text-xl leading-relaxed";
 };
 
+/**
+ * Format a value for display
+ */
+export declare function formatValue(value: unknown): string;
+
 /**
  * Generate a unique ID for blocks.
  * Uses crypto.randomUUID() when available (modern browsers & Node 19+),
@@ -197,6 +244,16 @@ export declare const FONT_SIZE_CLASSES: {
  */
 export declare const generateId: () => string;
 
+/**
+ * Get a preview of block content
+ */
+export declare function getBlockPreview(block: EditorBlock, maxLength?: number): string;
+
+/**
+ * Get a human-readable label for a block type
+ */
+export declare function getBlockTypeLabel(block: EditorBlock): string;
+
 /**
  * Get muted text class
  */
@@ -212,6 +269,11 @@ export declare const getPlaceholderClass: (isDark: boolean) => string;
  */
 export declare const getPrimaryTextClass: (isDark: boolean) => string;
 
+/**
+ * Get property changes between two blocks
+ */
+export declare function getPropertyChanges(oldBlock: EditorBlock, newBlock: EditorBlock): PropertyChange[];
+
 /**
  * Get secondary text class
  */
@@ -260,6 +322,23 @@ export declare interface ImageBlock {
  */
 export declare const isDarkTheme: (theme: Theme) => boolean;
 
+export declare function JsonDiff({ oldData, newData, onChange, theme, className, initialSplitPosition, minPanelWidth, allowRevert, }: JsonDiffProps): JSX.Element;
+
+export declare interface JsonDiffProps {
+    oldData: EditorData;
+    newData: EditorData;
+    /** Callback when user reverts changes. Receives the updated EditorData. */
+    onChange?: (data: EditorData) => void;
+    theme?: Theme;
+    className?: string;
+    /** Initial split position as percentage (0-100). Default: 50 */
+    initialSplitPosition?: number;
+    /** Minimum panel width as percentage. Default: 20 */
+    minPanelWidth?: number;
+    /** Allow reverting individual changes. Default: true */
+    allowRevert?: boolean;
+}
+
 export declare interface ListBlock {
     type: 'list';
     id: string;
@@ -283,6 +362,12 @@ export declare interface PagesEditorProps {
     theme?: Theme;
 }
 
+export declare interface PropertyChange {
+    path: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+
 /**
  * Quote style mapping
  */
@@ -373,4 +458,6 @@ export declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T
 
 export declare const validateEditorData: (data: unknown) => data is EditorData;
 
+export declare type ViewMode = 'split' | 'unified';
+
 export { }