@optilogic/core 1.0.0-beta.15 → 1.0.0-beta.17

package/dist/index.d.cts

@@ -2706,6 +2706,293 @@ interface UseContextMenuResult<T = unknown> {
 }
 declare function useContextMenu<T = unknown>(): UseContextMenuResult<T>;
 
+/**
+ * Built-in content types that FileView can render.
+ */
+type BuiltInContentType = "code" | "markdown" | "image" | "pdf" | "csv" | "html" | "plaintext" | "unknown";
+/**
+ * Content type - either a built-in type or a custom string.
+ * The `(string & {})` pattern preserves autocomplete for built-in types
+ * while accepting arbitrary strings for custom renderers.
+ */
+type ContentType = BuiltInContentType | (string & {});
+/**
+ * Callback to resolve image `src` values to renderable URLs.
+ * Called for non-remote, non-data-URI image sources in markdown content.
+ * Can return a blob URL, data URL, or any string that works as an `<img>` src.
+ */
+type ResolveImageUrl = (src: string) => Promise<string> | string;
+/**
+ * Props passed to every renderer component.
+ * All renderers receive a consistent contract regardless of content type.
+ */
+interface FileRendererProps {
+    /** Text content of the file. Null when content is binary/URL-based. */
+    content: string | null;
+    /** URL for binary content (images, PDFs). Null for text-based content. */
+    url: string | null;
+    /** The file name, used for display and language detection. */
+    fileName: string;
+    /** The resolved content type. */
+    contentType: ContentType;
+    /** Optional className for the renderer container. */
+    className?: string;
+    /** Optional callback to resolve relative image URLs in markdown content. */
+    resolveImageUrl?: ResolveImageUrl;
+}
+/**
+ * A renderer component that can render file content.
+ */
+type FileRenderer = React$1.ComponentType<FileRendererProps>;
+/**
+ * Registry mapping content types to renderer components.
+ * Users can override individual renderers by providing their own map.
+ */
+type RendererRegistry = Partial<Record<ContentType, FileRenderer>>;
+/**
+ * Error information for the FileView.
+ */
+interface FileViewError {
+    /** Error message to display. */
+    message: string;
+    /** Optional retry callback. If provided, a retry button is shown. */
+    onRetry?: () => void;
+}
+/**
+ * Props for the FileView component.
+ */
+interface FileViewProps {
+    /**
+     * Text content of the file.
+     * For text-based files (code, markdown, plaintext, csv), pass the string content.
+     * For binary files (images, PDFs), pass null and use `url` instead.
+     */
+    content: string | null;
+    /**
+     * URL for binary content.
+     * Used for images, PDFs, and other non-text content.
+     * Can be an object URL, data URL, or HTTP URL.
+     */
+    url?: string | null;
+    /**
+     * The file name including extension.
+     * Used for content type detection and display context.
+     * @example "README.md", "app.tsx", "photo.png"
+     */
+    fileName: string;
+    /**
+     * Explicit content type override.
+     * When provided, bypasses automatic detection from fileName.
+     */
+    contentType?: ContentType;
+    /**
+     * Custom renderer overrides.
+     * Merges with (and overrides) the default renderer registry.
+     * Only the types you specify are overridden; others use defaults.
+     *
+     * @example
+     * renderers={{ code: MyCustomCodeRenderer }}
+     */
+    renderers?: RendererRegistry;
+    /** Loading state. When true, shows loading indicator. */
+    loading?: boolean;
+    /** Error state. When provided, shows error message with optional retry. */
+    error?: FileViewError | null;
+    /** Custom loading component. Replaces the default spinner. */
+    loadingComponent?: React$1.ReactNode;
+    /** Custom empty state component. Shown when content is null/empty and not loading/error. */
+    emptyComponent?: React$1.ReactNode;
+    /**
+     * Empty state message. Used when no custom emptyComponent is provided.
+     * @default "No content to display"
+     */
+    emptyMessage?: string;
+    /** Custom error component. Replaces the default error display. */
+    errorComponent?: React$1.ComponentType<{
+        error: FileViewError;
+    }>;
+    /** Additional class name for the outermost container. */
+    className?: string;
+    /** Additional class name passed to the active renderer. */
+    rendererClassName?: string;
+    /**
+     * Optional callback to resolve image `src` values to renderable URLs.
+     * Used by MarkdownRenderer for relative/non-remote image paths.
+     * Remote URLs (http/https) and data URIs are passed through unchanged.
+     */
+    resolveImageUrl?: ResolveImageUrl;
+}
+/**
+ * Content type detection result.
+ */
+interface ContentTypeDetectionResult {
+    /** The detected content type. */
+    type: ContentType;
+    /** The file extension that was matched, if any. */
+    extension: string | null;
+}
+
+/**
+ * FileView
+ *
+ * A configurable file viewer that detects content type from the file name
+ * and delegates rendering to a pluggable renderer system.
+ *
+ * Built-in renderers: Code, Markdown, Image, PlainText.
+ * Users can override any renderer or add custom ones via the `renderers` prop.
+ *
+ * @example
+ * <FileView fileName="app.tsx" content={sourceCode} />
+ *
+ * @example
+ * <FileView fileName="photo.png" content={null} url={imageUrl} />
+ *
+ * @example
+ * <FileView
+ *   fileName="data.txt"
+ *   content={jsonContent}
+ *   contentType="code"
+ *   renderers={{ code: MyCustomCodeRenderer }}
+ * />
+ */
+declare function FileView({ content, url, fileName, contentType: contentTypeOverride, renderers: userRenderers, loading, error, loadingComponent, emptyComponent, emptyMessage, errorComponent: ErrorComponent, className, rendererClassName, resolveImageUrl, }: FileViewProps): react_jsx_runtime.JSX.Element;
+declare namespace FileView {
+    var displayName: string;
+}
+
+/**
+ * CodeRenderer
+ *
+ * Renders text content as code with line numbers in a left gutter.
+ * Uses shiki for syntax highlighting when available, falling back to
+ * plain monospace text otherwise.
+ *
+ * Layout:
+ * ┌─────────────────────────────────────────┐
+ * │  1 │ import React from "react";         │
+ * │  2 │                                    │
+ * │  3 │ export function App() {            │
+ * │  4 │   return <div>Hello</div>;         │
+ * │  5 │ }                                  │
+ * └─────────────────────────────────────────┘
+ */
+declare function CodeRenderer({ content, fileName, className, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace CodeRenderer {
+    var displayName: string;
+}
+
+/**
+ * MarkdownRenderer
+ *
+ * Renders markdown content using react-markdown + remark-gfm.
+ * Fenced code blocks use shiki syntax highlighting when available.
+ * Styled with Tailwind using semantic CSS variables for theme support.
+ *
+ * Requires `react-markdown` and `remark-gfm` as peer dependencies of @optilogic/core.
+ */
+declare function MarkdownRenderer({ content, className, resolveImageUrl, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace MarkdownRenderer {
+    var displayName: string;
+}
+
+/**
+ * ImageRenderer
+ *
+ * Renders an image from a URL, centered in its container.
+ * Handles load errors with a fallback message.
+ */
+declare function ImageRenderer({ url, fileName, className, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace ImageRenderer {
+    var displayName: string;
+}
+
+/**
+ * PlainTextRenderer
+ *
+ * Renders plain text content without line numbers.
+ * Used for .txt, .log, and as the ultimate fallback renderer.
+ */
+declare function PlainTextRenderer({ content, className }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace PlainTextRenderer {
+    var displayName: string;
+}
+
+/**
+ * CsvRenderer
+ *
+ * Parses CSV/TSV content and renders it in a DataGrid
+ * with sorting, filtering, resizable columns, and virtualization.
+ */
+declare function CsvRenderer({ content, className }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace CsvRenderer {
+    var displayName: string;
+}
+
+/**
+ * HtmlRenderer
+ *
+ * Renders HTML content in a fully sandboxed iframe.
+ */
+declare function HtmlRenderer({ content, fileName, className, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace HtmlRenderer {
+    var displayName: string;
+}
+
+interface UseContentTypeOptions {
+    fileName: string;
+    contentTypeOverride?: ContentType;
+}
+interface UseContentTypeReturn extends ContentTypeDetectionResult {
+    /** Whether the type was explicitly overridden. */
+    isOverridden: boolean;
+}
+/**
+ * Hook to determine the content type for a file.
+ * Uses explicit override if provided, otherwise auto-detects from fileName.
+ */
+declare function useContentType({ fileName, contentTypeOverride, }: UseContentTypeOptions): UseContentTypeReturn;
+
+/**
+ * Extract the file extension from a file name.
+ * Handles dotfiles (e.g., ".gitignore" -> "gitignore") and
+ * compound extensions (e.g., "file.test.ts" -> "ts").
+ */
+declare function getFileExtension(fileName: string): string | null;
+/**
+ * Detect content type from a file name.
+ *
+ * @example
+ * detectContentType("app.tsx")     // { type: "code", extension: "tsx" }
+ * detectContentType("README.md")   // { type: "markdown", extension: "md" }
+ * detectContentType("photo.png")   // { type: "image", extension: "png" }
+ * detectContentType("unknown.xyz") // { type: "unknown", extension: "xyz" }
+ */
+declare function detectContentType(fileName: string): ContentTypeDetectionResult;
+/**
+ * Check if a content type is text-based (uses `content` string).
+ */
+declare function isTextContentType(contentType: ContentType): boolean;
+/**
+ * Check if a content type is URL-based (uses `url` string).
+ */
+declare function isUrlContentType(contentType: ContentType): boolean;
+
+/**
+ * Default renderer registry.
+ * Maps built-in content types to their default renderer components.
+ */
+declare const DEFAULT_RENDERERS: RendererRegistry;
+/**
+ * Merge user-provided renderers with defaults.
+ * User renderers override defaults for the same content type.
+ */
+declare function mergeRenderers(userRenderers?: RendererRegistry): RendererRegistry;
+/**
+ * Resolve a renderer for a given content type.
+ * Falls back to PlainTextRenderer if no match found.
+ */
+declare function resolveRenderer(registry: RendererRegistry, contentType: string): FileRenderer;
+
 /** @deprecated Use SortConfig instead */
 type SortingConfig = {
     field: string;
@@ -2713,4 +3000,4 @@ type SortingConfig = {
     onSort: (field: string) => void;
 };
 
-export { ALL_THEMES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, AccordionTrigger, type AccordionTriggerProps, type AccordionVariant, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Autocomplete, type AutocompleteOption, type AutocompleteProps, Badge, type BadgeProps, Board, BoardContent, type BoardContentProps, BoardHeader, type BoardHeaderProps, type BoardProps, Button, type ButtonProps, CYBERPUNK_THEME, Calendar, type CalendarProps, Card, CardActions, type CardActionsProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardGrid, type CardGridProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, CardList, type CardListProps, type CardProps, CardTitle, type CardTitleProps, type CellEditEvent, CellEditor, type CellEditorProps$1 as CellEditorProps, type CellPosition, Checkbox, type CheckboxProps, Chip, type ChipProps, type ColorFieldConfig, type ColumnDef, ConfirmationModal, type ConfirmationModalProps, ContextMenu, type ContextMenuItem, type ContextMenuProps, CopyButton, type CopyButtonProps, DARK_ELEGANT_THEME, DataGrid, type DataGridContextValue, type DataGridInternalState, type DataGridProps, type DataGridState, DataTable, type DataTableColumn, type DataTableProps, type DataTableSort, type DateFilterOperator, DatePicker, DatePickerInput, type DatePickerInputProps, type DatePickerProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type EditingCell, type EditorType, FOREST_THEME, FUTURISTIC_THEME, type FilterConfig, type FilterOperator, FilterPopover, type FilterPopoverProps$1 as FilterPopoverProps, type FilterType, GREEN_THEME, type GridCellProps, HeaderCell, type HeaderCellProps$1 as HeaderCellProps, IconButton, type IconButtonProps, Input, type InputProps, Label, type LabelProps, LoadingSpinner, type LoadingSpinnerProps, MINIMALIST_LIGHT_THEME, Modal, ModalButton, type ModalButtonProps, type ModalProps, NATURE_THEME, type NumberFilterOperator, OCEAN_THEME, OPTILOGIC_LEGACY_THEME, PRESET_THEMES, type PaginationConfig, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, Progress, type ProgressProps, ResizablePanel, type ResizablePanelProps, ResizeHandle, type ResizeHandleProps, SCIFI_THEME, SUNSET_THEME, type SearchConfig, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, SelectableCard, type SelectableCardProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SortConfig, type SortingConfig, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, TabsContent, TabsList, TabsTrigger, type TextFilterOperator, Textarea, type TextareaProps, type Theme, type ThemeHSL, type ThemeHex, ThemePicker, type ThemePickerProps, Toaster, type ToasterProps, Tooltip, TooltipArrow, TooltipContent, TooltipPortal, type TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, type UseContextMenuResult, accordionContentVariants, accordionItemVariants, accordionTriggerVariants, applyFilterOperator, applyFilters, applySorting, applyTheme, areThemesEqual, badgeVariants, boardVariants, buttonVariants, cardActionsVariants, cardGridVariants, cardImageVariants, cardListVariants, cardVariants, cloneTheme, cn, exportTheme, getCellValue, getCurrentTheme, getDefaultTheme, getPresetTheme, hexToHsl, iconButtonVariants, importTheme, isPresetTheme, labelVariants, loadingSpinnerVariants, themeToHsl, useColumnResize, useColumnResizeManager, useConfirmation, useContextMenu, useDataGridState, useKeyboardNavigation, validateTheme };
+export { ALL_THEMES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, AccordionTrigger, type AccordionTriggerProps, type AccordionVariant, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Autocomplete, type AutocompleteOption, type AutocompleteProps, Badge, type BadgeProps, Board, BoardContent, type BoardContentProps, BoardHeader, type BoardHeaderProps, type BoardProps, type BuiltInContentType, Button, type ButtonProps, CYBERPUNK_THEME, Calendar, type CalendarProps, Card, CardActions, type CardActionsProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardGrid, type CardGridProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, CardList, type CardListProps, type CardProps, CardTitle, type CardTitleProps, type CellEditEvent, CellEditor, type CellEditorProps$1 as CellEditorProps, type CellPosition, Checkbox, type CheckboxProps, Chip, type ChipProps, CodeRenderer, type ColorFieldConfig, type ColumnDef, ConfirmationModal, type ConfirmationModalProps, type ContentType, type ContentTypeDetectionResult, ContextMenu, type ContextMenuItem, type ContextMenuProps, CopyButton, type CopyButtonProps, CsvRenderer, DARK_ELEGANT_THEME, DEFAULT_RENDERERS, DataGrid, type DataGridContextValue, type DataGridInternalState, type DataGridProps, type DataGridState, DataTable, type DataTableColumn, type DataTableProps, type DataTableSort, type DateFilterOperator, DatePicker, DatePickerInput, type DatePickerInputProps, type DatePickerProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type EditingCell, type EditorType, FOREST_THEME, FUTURISTIC_THEME, type FileRenderer, type FileRendererProps, FileView, type FileViewError, type FileViewProps, type FilterConfig, type FilterOperator, FilterPopover, type FilterPopoverProps$1 as FilterPopoverProps, type FilterType, GREEN_THEME, type GridCellProps, HeaderCell, type HeaderCellProps$1 as HeaderCellProps, HtmlRenderer, IconButton, type IconButtonProps, ImageRenderer, Input, type InputProps, Label, type LabelProps, LoadingSpinner, type LoadingSpinnerProps, MINIMALIST_LIGHT_THEME, MarkdownRenderer, Modal, ModalButton, type ModalButtonProps, type ModalProps, NATURE_THEME, type NumberFilterOperator, OCEAN_THEME, OPTILOGIC_LEGACY_THEME, PRESET_THEMES, type PaginationConfig, PlainTextRenderer, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, Progress, type ProgressProps, type RendererRegistry, ResizablePanel, type ResizablePanelProps, ResizeHandle, type ResizeHandleProps, type ResolveImageUrl, SCIFI_THEME, SUNSET_THEME, type SearchConfig, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, SelectableCard, type SelectableCardProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SortConfig, type SortingConfig, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, TabsContent, TabsList, TabsTrigger, type TextFilterOperator, Textarea, type TextareaProps, type Theme, type ThemeHSL, type ThemeHex, ThemePicker, type ThemePickerProps, Toaster, type ToasterProps, Tooltip, TooltipArrow, TooltipContent, TooltipPortal, type TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, type UseContentTypeOptions, type UseContentTypeReturn, type UseContextMenuResult, accordionContentVariants, accordionItemVariants, accordionTriggerVariants, applyFilterOperator, applyFilters, applySorting, applyTheme, areThemesEqual, badgeVariants, boardVariants, buttonVariants, cardActionsVariants, cardGridVariants, cardImageVariants, cardListVariants, cardVariants, cloneTheme, cn, detectContentType, exportTheme, getCellValue, getCurrentTheme, getDefaultTheme, getFileExtension, getPresetTheme, hexToHsl, iconButtonVariants, importTheme, isPresetTheme, isTextContentType, isUrlContentType, labelVariants, loadingSpinnerVariants, mergeRenderers, resolveRenderer, themeToHsl, useColumnResize, useColumnResizeManager, useConfirmation, useContentType, useContextMenu, useDataGridState, useKeyboardNavigation, validateTheme };

package/dist/index.d.ts

@@ -2706,6 +2706,293 @@ interface UseContextMenuResult<T = unknown> {
 }
 declare function useContextMenu<T = unknown>(): UseContextMenuResult<T>;
 
+/**
+ * Built-in content types that FileView can render.
+ */
+type BuiltInContentType = "code" | "markdown" | "image" | "pdf" | "csv" | "html" | "plaintext" | "unknown";
+/**
+ * Content type - either a built-in type or a custom string.
+ * The `(string & {})` pattern preserves autocomplete for built-in types
+ * while accepting arbitrary strings for custom renderers.
+ */
+type ContentType = BuiltInContentType | (string & {});
+/**
+ * Callback to resolve image `src` values to renderable URLs.
+ * Called for non-remote, non-data-URI image sources in markdown content.
+ * Can return a blob URL, data URL, or any string that works as an `<img>` src.
+ */
+type ResolveImageUrl = (src: string) => Promise<string> | string;
+/**
+ * Props passed to every renderer component.
+ * All renderers receive a consistent contract regardless of content type.
+ */
+interface FileRendererProps {
+    /** Text content of the file. Null when content is binary/URL-based. */
+    content: string | null;
+    /** URL for binary content (images, PDFs). Null for text-based content. */
+    url: string | null;
+    /** The file name, used for display and language detection. */
+    fileName: string;
+    /** The resolved content type. */
+    contentType: ContentType;
+    /** Optional className for the renderer container. */
+    className?: string;
+    /** Optional callback to resolve relative image URLs in markdown content. */
+    resolveImageUrl?: ResolveImageUrl;
+}
+/**
+ * A renderer component that can render file content.
+ */
+type FileRenderer = React$1.ComponentType<FileRendererProps>;
+/**
+ * Registry mapping content types to renderer components.
+ * Users can override individual renderers by providing their own map.
+ */
+type RendererRegistry = Partial<Record<ContentType, FileRenderer>>;
+/**
+ * Error information for the FileView.
+ */
+interface FileViewError {
+    /** Error message to display. */
+    message: string;
+    /** Optional retry callback. If provided, a retry button is shown. */
+    onRetry?: () => void;
+}
+/**
+ * Props for the FileView component.
+ */
+interface FileViewProps {
+    /**
+     * Text content of the file.
+     * For text-based files (code, markdown, plaintext, csv), pass the string content.
+     * For binary files (images, PDFs), pass null and use `url` instead.
+     */
+    content: string | null;
+    /**
+     * URL for binary content.
+     * Used for images, PDFs, and other non-text content.
+     * Can be an object URL, data URL, or HTTP URL.
+     */
+    url?: string | null;
+    /**
+     * The file name including extension.
+     * Used for content type detection and display context.
+     * @example "README.md", "app.tsx", "photo.png"
+     */
+    fileName: string;
+    /**
+     * Explicit content type override.
+     * When provided, bypasses automatic detection from fileName.
+     */
+    contentType?: ContentType;
+    /**
+     * Custom renderer overrides.
+     * Merges with (and overrides) the default renderer registry.
+     * Only the types you specify are overridden; others use defaults.
+     *
+     * @example
+     * renderers={{ code: MyCustomCodeRenderer }}
+     */
+    renderers?: RendererRegistry;
+    /** Loading state. When true, shows loading indicator. */
+    loading?: boolean;
+    /** Error state. When provided, shows error message with optional retry. */
+    error?: FileViewError | null;
+    /** Custom loading component. Replaces the default spinner. */
+    loadingComponent?: React$1.ReactNode;
+    /** Custom empty state component. Shown when content is null/empty and not loading/error. */
+    emptyComponent?: React$1.ReactNode;
+    /**
+     * Empty state message. Used when no custom emptyComponent is provided.
+     * @default "No content to display"
+     */
+    emptyMessage?: string;
+    /** Custom error component. Replaces the default error display. */
+    errorComponent?: React$1.ComponentType<{
+        error: FileViewError;
+    }>;
+    /** Additional class name for the outermost container. */
+    className?: string;
+    /** Additional class name passed to the active renderer. */
+    rendererClassName?: string;
+    /**
+     * Optional callback to resolve image `src` values to renderable URLs.
+     * Used by MarkdownRenderer for relative/non-remote image paths.
+     * Remote URLs (http/https) and data URIs are passed through unchanged.
+     */
+    resolveImageUrl?: ResolveImageUrl;
+}
+/**
+ * Content type detection result.
+ */
+interface ContentTypeDetectionResult {
+    /** The detected content type. */
+    type: ContentType;
+    /** The file extension that was matched, if any. */
+    extension: string | null;
+}
+
+/**
+ * FileView
+ *
+ * A configurable file viewer that detects content type from the file name
+ * and delegates rendering to a pluggable renderer system.
+ *
+ * Built-in renderers: Code, Markdown, Image, PlainText.
+ * Users can override any renderer or add custom ones via the `renderers` prop.
+ *
+ * @example
+ * <FileView fileName="app.tsx" content={sourceCode} />
+ *
+ * @example
+ * <FileView fileName="photo.png" content={null} url={imageUrl} />
+ *
+ * @example
+ * <FileView
+ *   fileName="data.txt"
+ *   content={jsonContent}
+ *   contentType="code"
+ *   renderers={{ code: MyCustomCodeRenderer }}
+ * />
+ */
+declare function FileView({ content, url, fileName, contentType: contentTypeOverride, renderers: userRenderers, loading, error, loadingComponent, emptyComponent, emptyMessage, errorComponent: ErrorComponent, className, rendererClassName, resolveImageUrl, }: FileViewProps): react_jsx_runtime.JSX.Element;
+declare namespace FileView {
+    var displayName: string;
+}
+
+/**
+ * CodeRenderer
+ *
+ * Renders text content as code with line numbers in a left gutter.
+ * Uses shiki for syntax highlighting when available, falling back to
+ * plain monospace text otherwise.
+ *
+ * Layout:
+ * ┌─────────────────────────────────────────┐
+ * │  1 │ import React from "react";         │
+ * │  2 │                                    │
+ * │  3 │ export function App() {            │
+ * │  4 │   return <div>Hello</div>;         │
+ * │  5 │ }                                  │
+ * └─────────────────────────────────────────┘
+ */
+declare function CodeRenderer({ content, fileName, className, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace CodeRenderer {
+    var displayName: string;
+}
+
+/**
+ * MarkdownRenderer
+ *
+ * Renders markdown content using react-markdown + remark-gfm.
+ * Fenced code blocks use shiki syntax highlighting when available.
+ * Styled with Tailwind using semantic CSS variables for theme support.
+ *
+ * Requires `react-markdown` and `remark-gfm` as peer dependencies of @optilogic/core.
+ */
+declare function MarkdownRenderer({ content, className, resolveImageUrl, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace MarkdownRenderer {
+    var displayName: string;
+}
+
+/**
+ * ImageRenderer
+ *
+ * Renders an image from a URL, centered in its container.
+ * Handles load errors with a fallback message.
+ */
+declare function ImageRenderer({ url, fileName, className, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace ImageRenderer {
+    var displayName: string;
+}
+
+/**
+ * PlainTextRenderer
+ *
+ * Renders plain text content without line numbers.
+ * Used for .txt, .log, and as the ultimate fallback renderer.
+ */
+declare function PlainTextRenderer({ content, className }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace PlainTextRenderer {
+    var displayName: string;
+}
+
+/**
+ * CsvRenderer
+ *
+ * Parses CSV/TSV content and renders it in a DataGrid
+ * with sorting, filtering, resizable columns, and virtualization.
+ */
+declare function CsvRenderer({ content, className }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace CsvRenderer {
+    var displayName: string;
+}
+
+/**
+ * HtmlRenderer
+ *
+ * Renders HTML content in a fully sandboxed iframe.
+ */
+declare function HtmlRenderer({ content, fileName, className, }: FileRendererProps): react_jsx_runtime.JSX.Element;
+declare namespace HtmlRenderer {
+    var displayName: string;
+}
+
+interface UseContentTypeOptions {
+    fileName: string;
+    contentTypeOverride?: ContentType;
+}
+interface UseContentTypeReturn extends ContentTypeDetectionResult {
+    /** Whether the type was explicitly overridden. */
+    isOverridden: boolean;
+}
+/**
+ * Hook to determine the content type for a file.
+ * Uses explicit override if provided, otherwise auto-detects from fileName.
+ */
+declare function useContentType({ fileName, contentTypeOverride, }: UseContentTypeOptions): UseContentTypeReturn;
+
+/**
+ * Extract the file extension from a file name.
+ * Handles dotfiles (e.g., ".gitignore" -> "gitignore") and
+ * compound extensions (e.g., "file.test.ts" -> "ts").
+ */
+declare function getFileExtension(fileName: string): string | null;
+/**
+ * Detect content type from a file name.
+ *
+ * @example
+ * detectContentType("app.tsx")     // { type: "code", extension: "tsx" }
+ * detectContentType("README.md")   // { type: "markdown", extension: "md" }
+ * detectContentType("photo.png")   // { type: "image", extension: "png" }
+ * detectContentType("unknown.xyz") // { type: "unknown", extension: "xyz" }
+ */
+declare function detectContentType(fileName: string): ContentTypeDetectionResult;
+/**
+ * Check if a content type is text-based (uses `content` string).
+ */
+declare function isTextContentType(contentType: ContentType): boolean;
+/**
+ * Check if a content type is URL-based (uses `url` string).
+ */
+declare function isUrlContentType(contentType: ContentType): boolean;
+
+/**
+ * Default renderer registry.
+ * Maps built-in content types to their default renderer components.
+ */
+declare const DEFAULT_RENDERERS: RendererRegistry;
+/**
+ * Merge user-provided renderers with defaults.
+ * User renderers override defaults for the same content type.
+ */
+declare function mergeRenderers(userRenderers?: RendererRegistry): RendererRegistry;
+/**
+ * Resolve a renderer for a given content type.
+ * Falls back to PlainTextRenderer if no match found.
+ */
+declare function resolveRenderer(registry: RendererRegistry, contentType: string): FileRenderer;
+
 /** @deprecated Use SortConfig instead */
 type SortingConfig = {
     field: string;
@@ -2713,4 +3000,4 @@ type SortingConfig = {
     onSort: (field: string) => void;
 };
 
-export { ALL_THEMES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, AccordionTrigger, type AccordionTriggerProps, type AccordionVariant, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Autocomplete, type AutocompleteOption, type AutocompleteProps, Badge, type BadgeProps, Board, BoardContent, type BoardContentProps, BoardHeader, type BoardHeaderProps, type BoardProps, Button, type ButtonProps, CYBERPUNK_THEME, Calendar, type CalendarProps, Card, CardActions, type CardActionsProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardGrid, type CardGridProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, CardList, type CardListProps, type CardProps, CardTitle, type CardTitleProps, type CellEditEvent, CellEditor, type CellEditorProps$1 as CellEditorProps, type CellPosition, Checkbox, type CheckboxProps, Chip, type ChipProps, type ColorFieldConfig, type ColumnDef, ConfirmationModal, type ConfirmationModalProps, ContextMenu, type ContextMenuItem, type ContextMenuProps, CopyButton, type CopyButtonProps, DARK_ELEGANT_THEME, DataGrid, type DataGridContextValue, type DataGridInternalState, type DataGridProps, type DataGridState, DataTable, type DataTableColumn, type DataTableProps, type DataTableSort, type DateFilterOperator, DatePicker, DatePickerInput, type DatePickerInputProps, type DatePickerProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type EditingCell, type EditorType, FOREST_THEME, FUTURISTIC_THEME, type FilterConfig, type FilterOperator, FilterPopover, type FilterPopoverProps$1 as FilterPopoverProps, type FilterType, GREEN_THEME, type GridCellProps, HeaderCell, type HeaderCellProps$1 as HeaderCellProps, IconButton, type IconButtonProps, Input, type InputProps, Label, type LabelProps, LoadingSpinner, type LoadingSpinnerProps, MINIMALIST_LIGHT_THEME, Modal, ModalButton, type ModalButtonProps, type ModalProps, NATURE_THEME, type NumberFilterOperator, OCEAN_THEME, OPTILOGIC_LEGACY_THEME, PRESET_THEMES, type PaginationConfig, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, Progress, type ProgressProps, ResizablePanel, type ResizablePanelProps, ResizeHandle, type ResizeHandleProps, SCIFI_THEME, SUNSET_THEME, type SearchConfig, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, SelectableCard, type SelectableCardProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SortConfig, type SortingConfig, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, TabsContent, TabsList, TabsTrigger, type TextFilterOperator, Textarea, type TextareaProps, type Theme, type ThemeHSL, type ThemeHex, ThemePicker, type ThemePickerProps, Toaster, type ToasterProps, Tooltip, TooltipArrow, TooltipContent, TooltipPortal, type TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, type UseContextMenuResult, accordionContentVariants, accordionItemVariants, accordionTriggerVariants, applyFilterOperator, applyFilters, applySorting, applyTheme, areThemesEqual, badgeVariants, boardVariants, buttonVariants, cardActionsVariants, cardGridVariants, cardImageVariants, cardListVariants, cardVariants, cloneTheme, cn, exportTheme, getCellValue, getCurrentTheme, getDefaultTheme, getPresetTheme, hexToHsl, iconButtonVariants, importTheme, isPresetTheme, labelVariants, loadingSpinnerVariants, themeToHsl, useColumnResize, useColumnResizeManager, useConfirmation, useContextMenu, useDataGridState, useKeyboardNavigation, validateTheme };
+export { ALL_THEMES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, AccordionTrigger, type AccordionTriggerProps, type AccordionVariant, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, type AlertDialogFooterProps, AlertDialogHeader, type AlertDialogHeaderProps, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, Autocomplete, type AutocompleteOption, type AutocompleteProps, Badge, type BadgeProps, Board, BoardContent, type BoardContentProps, BoardHeader, type BoardHeaderProps, type BoardProps, type BuiltInContentType, Button, type ButtonProps, CYBERPUNK_THEME, Calendar, type CalendarProps, Card, CardActions, type CardActionsProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardGrid, type CardGridProps, CardHeader, type CardHeaderProps, CardImage, type CardImageProps, CardList, type CardListProps, type CardProps, CardTitle, type CardTitleProps, type CellEditEvent, CellEditor, type CellEditorProps$1 as CellEditorProps, type CellPosition, Checkbox, type CheckboxProps, Chip, type ChipProps, CodeRenderer, type ColorFieldConfig, type ColumnDef, ConfirmationModal, type ConfirmationModalProps, type ContentType, type ContentTypeDetectionResult, ContextMenu, type ContextMenuItem, type ContextMenuProps, CopyButton, type CopyButtonProps, CsvRenderer, DARK_ELEGANT_THEME, DEFAULT_RENDERERS, DataGrid, type DataGridContextValue, type DataGridInternalState, type DataGridProps, type DataGridState, DataTable, type DataTableColumn, type DataTableProps, type DataTableSort, type DateFilterOperator, DatePicker, DatePickerInput, type DatePickerInputProps, type DatePickerProps, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuShortcutProps, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type EditingCell, type EditorType, FOREST_THEME, FUTURISTIC_THEME, type FileRenderer, type FileRendererProps, FileView, type FileViewError, type FileViewProps, type FilterConfig, type FilterOperator, FilterPopover, type FilterPopoverProps$1 as FilterPopoverProps, type FilterType, GREEN_THEME, type GridCellProps, HeaderCell, type HeaderCellProps$1 as HeaderCellProps, HtmlRenderer, IconButton, type IconButtonProps, ImageRenderer, Input, type InputProps, Label, type LabelProps, LoadingSpinner, type LoadingSpinnerProps, MINIMALIST_LIGHT_THEME, MarkdownRenderer, Modal, ModalButton, type ModalButtonProps, type ModalProps, NATURE_THEME, type NumberFilterOperator, OCEAN_THEME, OPTILOGIC_LEGACY_THEME, PRESET_THEMES, type PaginationConfig, PlainTextRenderer, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, Progress, type ProgressProps, type RendererRegistry, ResizablePanel, type ResizablePanelProps, ResizeHandle, type ResizeHandleProps, type ResolveImageUrl, SCIFI_THEME, SUNSET_THEME, type SearchConfig, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, SelectableCard, type SelectableCardProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SortConfig, type SortingConfig, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, TabsContent, TabsList, TabsTrigger, type TextFilterOperator, Textarea, type TextareaProps, type Theme, type ThemeHSL, type ThemeHex, ThemePicker, type ThemePickerProps, Toaster, type ToasterProps, Tooltip, TooltipArrow, TooltipContent, TooltipPortal, type TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, type UseContentTypeOptions, type UseContentTypeReturn, type UseContextMenuResult, accordionContentVariants, accordionItemVariants, accordionTriggerVariants, applyFilterOperator, applyFilters, applySorting, applyTheme, areThemesEqual, badgeVariants, boardVariants, buttonVariants, cardActionsVariants, cardGridVariants, cardImageVariants, cardListVariants, cardVariants, cloneTheme, cn, detectContentType, exportTheme, getCellValue, getCurrentTheme, getDefaultTheme, getFileExtension, getPresetTheme, hexToHsl, iconButtonVariants, importTheme, isPresetTheme, isTextContentType, isUrlContentType, labelVariants, loadingSpinnerVariants, mergeRenderers, resolveRenderer, themeToHsl, useColumnResize, useColumnResizeManager, useConfirmation, useContentType, useContextMenu, useDataGridState, useKeyboardNavigation, validateTheme };