@underverse-ui/underverse 1.0.23 → 1.0.25

package/dist/index.d.cts

@@ -2829,12 +2829,44 @@ declare function useSmartTranslations(namespace: string): (key: string) => strin
  */
 declare function useSmartLocale(): Locale$1;
 
+type UEditorUploadImageForSaveResult = string | ({
+    url: string;
+} & Record<string, unknown>);
+type UEditorUploadImageForSave = (file: File) => Promise<UEditorUploadImageForSaveResult>;
+type UEditorPrepareContentUploadMeta = Record<string, unknown>;
+type UEditorInlineUploadedItem = {
+    index: number;
+    url: string;
+    file?: File;
+    meta?: UEditorPrepareContentUploadMeta;
+};
+type UEditorPrepareContentForSaveResult = {
+    html: string;
+    uploaded: Array<{
+        url: string;
+        file?: File;
+        meta?: UEditorPrepareContentUploadMeta;
+    }>;
+    inlineImageUrls: string[];
+    inlineUploaded: UEditorInlineUploadedItem[];
+    errors: Array<{
+        index: number;
+        reason: string;
+    }>;
+};
+type UEditorPrepareContentForSaveOptions = {
+    throwOnError?: boolean;
+};
+interface UEditorRef {
+    prepareContentForSave: (options?: UEditorPrepareContentForSaveOptions) => Promise<UEditorPrepareContentForSaveResult>;
+}
 interface UEditorProps {
     content?: string;
     onChange?: (content: string) => void;
     onHtmlChange?: (html: string) => void;
     onJsonChange?: (json: object) => void;
     uploadImage?: (file: File) => Promise<string> | string;
+    uploadImageForSave?: UEditorUploadImageForSave;
     imageInsertMode?: "base64" | "upload";
     placeholder?: string;
     className?: string;
@@ -2851,7 +2883,18 @@ interface UEditorProps {
 }
 type UEditorVariant = NonNullable<UEditorProps["variant"]>;
 
-declare const UEditor: ({ content, onChange, onHtmlChange, onJsonChange, uploadImage, imageInsertMode, placeholder, className, editable, autofocus, showToolbar, showBubbleMenu, showFloatingMenu, showCharacterCount, maxCharacters, minHeight, maxHeight, variant, }: UEditorProps) => react_jsx_runtime.JSX.Element;
+declare const UEditor: React__default.ForwardRefExoticComponent<UEditorProps & React__default.RefAttributes<UEditorRef>>;
+
+declare function normalizeImageUrl(url: string): string;
+declare function extractImageSrcsFromHtml(html: string): string[];
+declare class UEditorPrepareContentForSaveError extends Error {
+    readonly result: UEditorPrepareContentForSaveResult;
+    constructor(result: UEditorPrepareContentForSaveResult);
+}
+declare function prepareUEditorContentForSave({ html, uploadImageForSave, }: {
+    html: string;
+    uploadImageForSave?: UEditorUploadImageForSave;
+}): Promise<UEditorPrepareContentForSaveResult>;
 
 declare const underverseMessages: {
     readonly en: {
@@ -3630,4 +3673,4 @@ declare function getUnderverseMessages(locale?: UnderverseLocale): {
     };
 };
 
-export { AccessDenied, Alert, AreaChart, type AreaChartDataPoint, type AreaChartProps, type AreaChartSeries, Avatar, Badge, Badge as BadgeBase, BarChart, type BarChartDataPoint, type BarChartProps, type BarChartSeries, BatteryProgress, BottomSheet, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, Carousel, CategoryTreeSelect, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxProps, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, FallingIcons, FileUpload, type FileUploadProps, FloatingContacts, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GaugeChart, type GaugeChartProps, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, LineChart, type LineChartDataPoint, type LineChartProps, type LineChartSeries, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type Locale$1 as Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NotificationBadge, NotificationModal, NumberInput, OverlayControls, PageLoading, Pagination, type PaginationProps, PasswordInput, PieChart, type PieChartDataPoint, type PieChartProps, PillTabs, Popover, Progress, PulseBadge, RadarChart, type RadarChartDataPoint, type RadarChartProps, type RadarChartSeries, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, SearchInput, Section, SegmentedProgress, SelectDropdown, Sheet, SidebarSheet, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, Slider, SmartImage, type Song, type Sorter, Sparkline, type SparklineDataPoint, type SparklineProps, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorProps, type UEditorVariant, type UnderverseLocale, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VerticalTabs, Watermark, type WatermarkProps, cn$1 as cn, cn as cnLocal, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, shadcnAnimationStyles, underverseMessages, useFormField, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };
+export { AccessDenied, Alert, AreaChart, type AreaChartDataPoint, type AreaChartProps, type AreaChartSeries, Avatar, Badge, Badge as BadgeBase, BarChart, type BarChartDataPoint, type BarChartProps, type BarChartSeries, BatteryProgress, BottomSheet, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, Carousel, CategoryTreeSelect, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxProps, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, FallingIcons, FileUpload, type FileUploadProps, FloatingContacts, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GaugeChart, type GaugeChartProps, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, LineChart, type LineChartDataPoint, type LineChartProps, type LineChartSeries, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type Locale$1 as Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NotificationBadge, NotificationModal, NumberInput, OverlayControls, PageLoading, Pagination, type PaginationProps, PasswordInput, PieChart, type PieChartDataPoint, type PieChartProps, PillTabs, Popover, Progress, PulseBadge, RadarChart, type RadarChartDataPoint, type RadarChartProps, type RadarChartSeries, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, SearchInput, Section, SegmentedProgress, SelectDropdown, Sheet, SidebarSheet, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, Slider, SmartImage, type Song, type Sorter, Sparkline, type SparklineDataPoint, type SparklineProps, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorInlineUploadedItem, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, type UnderverseLocale, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VerticalTabs, Watermark, type WatermarkProps, cn$1 as cn, cn as cnLocal, extractImageSrcsFromHtml, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, normalizeImageUrl, prepareUEditorContentForSave, shadcnAnimationStyles, underverseMessages, useFormField, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };

package/dist/index.d.ts

@@ -2829,12 +2829,44 @@ declare function useSmartTranslations(namespace: string): (key: string) => strin
  */
 declare function useSmartLocale(): Locale$1;
 
+type UEditorUploadImageForSaveResult = string | ({
+    url: string;
+} & Record<string, unknown>);
+type UEditorUploadImageForSave = (file: File) => Promise<UEditorUploadImageForSaveResult>;
+type UEditorPrepareContentUploadMeta = Record<string, unknown>;
+type UEditorInlineUploadedItem = {
+    index: number;
+    url: string;
+    file?: File;
+    meta?: UEditorPrepareContentUploadMeta;
+};
+type UEditorPrepareContentForSaveResult = {
+    html: string;
+    uploaded: Array<{
+        url: string;
+        file?: File;
+        meta?: UEditorPrepareContentUploadMeta;
+    }>;
+    inlineImageUrls: string[];
+    inlineUploaded: UEditorInlineUploadedItem[];
+    errors: Array<{
+        index: number;
+        reason: string;
+    }>;
+};
+type UEditorPrepareContentForSaveOptions = {
+    throwOnError?: boolean;
+};
+interface UEditorRef {
+    prepareContentForSave: (options?: UEditorPrepareContentForSaveOptions) => Promise<UEditorPrepareContentForSaveResult>;
+}
 interface UEditorProps {
     content?: string;
     onChange?: (content: string) => void;
     onHtmlChange?: (html: string) => void;
     onJsonChange?: (json: object) => void;
     uploadImage?: (file: File) => Promise<string> | string;
+    uploadImageForSave?: UEditorUploadImageForSave;
     imageInsertMode?: "base64" | "upload";
     placeholder?: string;
     className?: string;
@@ -2851,7 +2883,18 @@ interface UEditorProps {
 }
 type UEditorVariant = NonNullable<UEditorProps["variant"]>;
 
-declare const UEditor: ({ content, onChange, onHtmlChange, onJsonChange, uploadImage, imageInsertMode, placeholder, className, editable, autofocus, showToolbar, showBubbleMenu, showFloatingMenu, showCharacterCount, maxCharacters, minHeight, maxHeight, variant, }: UEditorProps) => react_jsx_runtime.JSX.Element;
+declare const UEditor: React__default.ForwardRefExoticComponent<UEditorProps & React__default.RefAttributes<UEditorRef>>;
+
+declare function normalizeImageUrl(url: string): string;
+declare function extractImageSrcsFromHtml(html: string): string[];
+declare class UEditorPrepareContentForSaveError extends Error {
+    readonly result: UEditorPrepareContentForSaveResult;
+    constructor(result: UEditorPrepareContentForSaveResult);
+}
+declare function prepareUEditorContentForSave({ html, uploadImageForSave, }: {
+    html: string;
+    uploadImageForSave?: UEditorUploadImageForSave;
+}): Promise<UEditorPrepareContentForSaveResult>;
 
 declare const underverseMessages: {
     readonly en: {
@@ -3630,4 +3673,4 @@ declare function getUnderverseMessages(locale?: UnderverseLocale): {
     };
 };
 
-export { AccessDenied, Alert, AreaChart, type AreaChartDataPoint, type AreaChartProps, type AreaChartSeries, Avatar, Badge, Badge as BadgeBase, BarChart, type BarChartDataPoint, type BarChartProps, type BarChartSeries, BatteryProgress, BottomSheet, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, Carousel, CategoryTreeSelect, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxProps, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, FallingIcons, FileUpload, type FileUploadProps, FloatingContacts, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GaugeChart, type GaugeChartProps, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, LineChart, type LineChartDataPoint, type LineChartProps, type LineChartSeries, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type Locale$1 as Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NotificationBadge, NotificationModal, NumberInput, OverlayControls, PageLoading, Pagination, type PaginationProps, PasswordInput, PieChart, type PieChartDataPoint, type PieChartProps, PillTabs, Popover, Progress, PulseBadge, RadarChart, type RadarChartDataPoint, type RadarChartProps, type RadarChartSeries, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, SearchInput, Section, SegmentedProgress, SelectDropdown, Sheet, SidebarSheet, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, Slider, SmartImage, type Song, type Sorter, Sparkline, type SparklineDataPoint, type SparklineProps, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorProps, type UEditorVariant, type UnderverseLocale, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VerticalTabs, Watermark, type WatermarkProps, cn$1 as cn, cn as cnLocal, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, shadcnAnimationStyles, underverseMessages, useFormField, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };
+export { AccessDenied, Alert, AreaChart, type AreaChartDataPoint, type AreaChartProps, type AreaChartSeries, Avatar, Badge, Badge as BadgeBase, BarChart, type BarChartDataPoint, type BarChartProps, type BarChartSeries, BatteryProgress, BottomSheet, Breadcrumb, Button, ButtonLoading, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, CalendarTimeline, type CalendarTimelineDateInput, type CalendarTimelineDayRangeMode, type CalendarTimelineEvent, type CalendarTimelineFormatters, type CalendarTimelineGroup, type CalendarTimelineInteractions, type CalendarTimelineLabels, type CalendarTimelineProps, type CalendarTimelineResource, type CalendarTimelineSize, type CalendarTimelineView, type CalendarTimelineVirtualization, Card, Carousel, CategoryTreeSelect, Checkbox, type CheckboxProps, CircularProgress, ClientOnly, ColorPicker, type ColorPickerProps, Combobox, type ComboboxProps, CompactPagination, type CompactPaginationProps, DataTable, type DataTableColumn, type DataTableDensity, type DataTableQuery, type DataTableSize, DatePicker, type DatePickerProps, DateRangePicker, DateTimePicker, type DateTimePickerProps, date as DateUtils, Drawer, DropdownMenu, DropdownMenuItem, DropdownMenuSeparator, FallingIcons, FileUpload, type FileUploadProps, FloatingContacts, ForceInternalTranslationsProvider, Form, FormActions, FormCheckbox, FormControl, FormDescription, FormField, FormInput, FormItem, FormLabel, FormMessage, FormSubmitButton, GaugeChart, type GaugeChartProps, GlobalLoading, GradientBadge, Grid, GridItem, type GridItemProps, type GridProps, ImageUpload, InlineLoading, Input, type InputProps, InteractiveBadge, Label, type LanguageOption, LanguageSwitcherHeadless as LanguageSwitcher, LanguageSwitcherHeadless, type LanguageSwitcherHeadlessProps, type LanguageSwitcherHeadlessProps as LanguageSwitcherProps, LineChart, type LineChartDataPoint, type LineChartProps, type LineChartSeries, List, ListItem, LoadingBar, LoadingDots, LoadingProgress, LoadingSpinner, type Locale$1 as Locale, MiniProgress, Modal, MonthYearPicker, MonthYearPicker as MonthYearPickerBase, type MonthYearPickerProps, MultiCombobox, type MultiComboboxProps, MusicPlayer, MusicPlayer as MusicPlayerDefault, type MusicPlayerProps, NotificationBadge, NotificationModal, NumberInput, OverlayControls, PageLoading, Pagination, type PaginationProps, PasswordInput, PieChart, type PieChartDataPoint, type PieChartProps, PillTabs, Popover, Progress, PulseBadge, RadarChart, type RadarChartDataPoint, type RadarChartProps, type RadarChartSeries, RadioGroup, RadioGroupItem, SIZE_STYLES_BTN, ScrollArea, SearchInput, Section, SegmentedProgress, SelectDropdown, Sheet, SidebarSheet, SimplePagination, type SimplePaginationProps, SimpleTabs, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonList, SkeletonMessage, SkeletonPost, SkeletonTable, SkeletonText, SlideOver, Slider, SmartImage, type Song, type Sorter, Sparkline, type SparklineDataPoint, type SparklineProps, StatusBadge, StepProgress, type SupportedLocale, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TagBadge, TagInput, TagInput as TagInputBase, type TagInputProps, Textarea, type ThemeMode, ThemeToggleHeadless as ThemeToggle, ThemeToggleHeadless, type ThemeToggleHeadlessProps, type ThemeToggleHeadlessProps as ThemeToggleProps, TimePicker, type TimePickerProps, Timeline, TimelineItem, ToastProvider, Tooltip, TranslationProvider, type TranslationProviderProps, type Translations, UEditor, type UEditorInlineUploadedItem, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, type UnderverseLocale, UnderverseProvider, type UnderverseProviderProps, type UploadedFile, VARIANT_STYLES_ALERT, VARIANT_STYLES_BTN, VerticalTabs, Watermark, type WatermarkProps, cn$1 as cn, cn as cnLocal, extractImageSrcsFromHtml, getAnimationStyles, getUnderverseMessages, injectAnimationStyles, normalizeImageUrl, prepareUEditorContentForSave, shadcnAnimationStyles, underverseMessages, useFormField, useShadCNAnimations, useSmartLocale, useSmartTranslations, useToast, useTranslations as useUnderverseI18n, useLocale as useUnderverseI18nLocale, useUnderverseLocale, useUnderverseTranslations };

package/dist/index.js

@@ -14159,7 +14159,7 @@ function ImageUpload({
 import { useState as useState33, useRef as useRef17, useCallback as useCallback14, useMemo as useMemo17 } from "react";
 import {
   Upload as Upload2,
-  File,
+  File as File2,
   FileText,
   FileImage,
   FileVideo,
@@ -14241,7 +14241,7 @@ var getFileIcon = (mimeType, fileName) => {
     case "c":
       return FileCode;
     default:
-      return File;
+      return File2;
   }
 };
 var getFileTypeColor = (mimeType) => {
@@ -14454,7 +14454,7 @@ function FileUpload({
     [uploadHandler, processFiles, handleRemove]
   );
   const renderFileItem = (file) => {
-    const IconComponent = showTypeIcons ? getFileIcon(file.type, file.name) : File;
+    const IconComponent = showTypeIcons ? getFileIcon(file.type, file.name) : File2;
     const iconColor = getFileTypeColor(file.type);
     const isImage = file.type.startsWith("image/") && file.url;
     return /* @__PURE__ */ jsxs41(
@@ -21297,7 +21297,7 @@ function useSmartLocale() {
 }
 
 // ../../components/ui/UEditor/UEditor.tsx
-import { useEffect as useEffect36, useMemo as useMemo28 } from "react";
+import React72, { useEffect as useEffect36, useImperativeHandle as useImperativeHandle3, useMemo as useMemo28, useRef as useRef34 } from "react";
 import { useTranslations as useTranslations7 } from "next-intl";
 import { useEditor, EditorContent } from "@tiptap/react";
 
@@ -24259,14 +24259,261 @@ var CharacterCountDisplay = ({ editor, maxCharacters }) => {
   ] });
 };
 
+// ../../components/ui/UEditor/prepare-content-for-save.ts
+var MIME_EXTENSION_MAP = {
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/webp": "webp",
+  "image/gif": "gif",
+  "image/svg+xml": "svg",
+  "image/bmp": "bmp",
+  "image/x-icon": "ico",
+  "image/avif": "avif"
+};
+function isDataImageUrl(value) {
+  return /^data:image\//i.test(value.trim());
+}
+function parseDataImageUrl(dataUrl) {
+  const value = dataUrl.trim();
+  if (!isDataImageUrl(value)) return null;
+  const commaIndex = value.indexOf(",");
+  if (commaIndex < 0) return null;
+  const header = value.slice(5, commaIndex);
+  const base64Data = value.slice(commaIndex + 1).trim();
+  if (!/;base64/i.test(header)) return null;
+  const mime = header.split(";")[0]?.trim().toLowerCase();
+  if (!mime || !base64Data) return null;
+  return { mime, base64Data };
+}
+function decodeBase64ToBytes(base64Data) {
+  const normalized = base64Data.replace(/\s+/g, "");
+  const binary = atob(normalized);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i += 1) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+function inferFileExtension(mime) {
+  return MIME_EXTENSION_MAP[mime] ?? "bin";
+}
+function createFileFromDataImageUrl(dataUrl, index) {
+  const parsed = parseDataImageUrl(dataUrl);
+  if (!parsed) {
+    throw new Error("Invalid data image URL format.");
+  }
+  const bytes = decodeBase64ToBytes(parsed.base64Data);
+  const extension = inferFileExtension(parsed.mime);
+  const name = `ueditor-image-${index + 1}.${extension}`;
+  return new File([bytes], name, { type: parsed.mime });
+}
+function normalizeUploadResult(result) {
+  if (typeof result === "string") {
+    const url2 = result.trim();
+    if (!url2) throw new Error("Upload handler returned an empty URL.");
+    return { url: url2 };
+  }
+  if (!result || typeof result !== "object") {
+    throw new Error("Upload handler returned invalid result.");
+  }
+  const url = typeof result.url === "string" ? result.url.trim() : "";
+  if (!url) throw new Error("Upload handler object result is missing `url`.");
+  const { url: _ignoredUrl, ...rest } = result;
+  const meta = Object.keys(rest).length > 0 ? rest : void 0;
+  return { url, meta };
+}
+function getErrorReason(error) {
+  if (error instanceof Error && error.message) return error.message;
+  if (typeof error === "string" && error.trim()) return error;
+  return "Unknown upload error.";
+}
+function decodeHtmlEntities(value) {
+  return value.replace(/&quot;/gi, '"').replace(/&#39;/gi, "'").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&nbsp;/gi, " ");
+}
+function normalizeImageUrl(url) {
+  const input = decodeHtmlEntities(url.trim());
+  if (!input) return "";
+  if (isDataImageUrl(input)) return input;
+  const isAbsolute = /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(input);
+  if (!isAbsolute) {
+    return input.split("#")[0] ?? input;
+  }
+  try {
+    const parsed = new URL(input);
+    parsed.hash = "";
+    if (parsed.protocol === "http:" || parsed.protocol === "https:") {
+      parsed.hostname = parsed.hostname.toLowerCase();
+      if (parsed.protocol === "http:" && parsed.port === "80" || parsed.protocol === "https:" && parsed.port === "443") {
+        parsed.port = "";
+      }
+      if (parsed.pathname.length > 1 && parsed.pathname.endsWith("/")) {
+        parsed.pathname = parsed.pathname.slice(0, -1);
+      }
+    }
+    return parsed.toString();
+  } catch {
+    return input.split("#")[0] ?? input;
+  }
+}
+function replaceSrcInTag(match, nextSrc) {
+  if (!match.srcAttr) return match.tag;
+  const { start, end, quote } = match.srcAttr;
+  const escaped = quote === '"' ? nextSrc.replace(/"/g, "&quot;") : quote === "'" ? nextSrc.replace(/'/g, "&#39;") : nextSrc;
+  const srcAttr = quote ? `src=${quote}${escaped}${quote}` : `src=${escaped}`;
+  return `${match.tag.slice(0, start)}${srcAttr}${match.tag.slice(end)}`;
+}
+function collectImgTagMatches(html) {
+  const matches = [];
+  const imgRegex = /<img\b[^>]*>/gi;
+  const srcAttrRegex = /\bsrc\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+))/i;
+  let tagMatch = imgRegex.exec(html);
+  while (tagMatch) {
+    const tag = tagMatch[0];
+    const start = tagMatch.index;
+    const end = start + tag.length;
+    const srcMatch = srcAttrRegex.exec(tag);
+    let srcAttr = null;
+    if (srcMatch) {
+      const value = srcMatch[1] ?? srcMatch[2] ?? srcMatch[3] ?? "";
+      const quote = srcMatch[1] !== void 0 ? '"' : srcMatch[2] !== void 0 ? "'" : "";
+      srcAttr = {
+        start: srcMatch.index,
+        end: srcMatch.index + srcMatch[0].length,
+        value,
+        quote
+      };
+    }
+    matches.push({ start, end, tag, srcAttr });
+    tagMatch = imgRegex.exec(html);
+  }
+  return matches;
+}
+function extractImageSrcsFromHtml(html) {
+  if (!html || !html.includes("<img")) return [];
+  return collectImgTagMatches(html).map((match) => decodeHtmlEntities(match.srcAttr?.value.trim() ?? "")).filter(Boolean);
+}
+function createResult({
+  html,
+  uploaded,
+  inlineUploaded,
+  errors
+}) {
+  return {
+    html,
+    uploaded,
+    inlineImageUrls: extractImageSrcsFromHtml(html),
+    inlineUploaded,
+    errors
+  };
+}
+var UEditorPrepareContentForSaveError = class extends Error {
+  constructor(result) {
+    super(
+      `Failed to upload ${result.errors.length} image(s): ${result.errors.map((item) => `#${item.index} ${item.reason}`).join("; ")}`
+    );
+    this.name = "UEditorPrepareContentForSaveError";
+    this.result = result;
+  }
+};
+async function prepareUEditorContentForSave({
+  html,
+  uploadImageForSave
+}) {
+  if (!html || !html.includes("<img")) {
+    return createResult({ html, uploaded: [], inlineUploaded: [], errors: [] });
+  }
+  const imgMatches = collectImgTagMatches(html);
+  if (imgMatches.length === 0) {
+    return createResult({ html, uploaded: [], inlineUploaded: [], errors: [] });
+  }
+  const base64Candidates = [];
+  for (const match of imgMatches) {
+    if (!match.srcAttr) continue;
+    const src = match.srcAttr.value.trim();
+    if (!isDataImageUrl(src)) continue;
+    base64Candidates.push({
+      id: `${match.start}:${match.end}`,
+      match,
+      index: base64Candidates.length,
+      src
+    });
+  }
+  if (base64Candidates.length === 0) {
+    return createResult({ html, uploaded: [], inlineUploaded: [], errors: [] });
+  }
+  if (!uploadImageForSave) {
+    return createResult({
+      html,
+      uploaded: [],
+      inlineUploaded: [],
+      errors: base64Candidates.map((item) => ({
+        index: item.index,
+        reason: "`uploadImageForSave` is required to transform base64 images before save."
+      }))
+    });
+  }
+  const uploaded = [];
+  const inlineUploaded = [];
+  const errors = [];
+  const replacements = /* @__PURE__ */ new Map();
+  const uploadResults = await Promise.all(
+    base64Candidates.map(async (candidate) => {
+      try {
+        const file = createFileFromDataImageUrl(candidate.src, candidate.index);
+        const uploadResult = await uploadImageForSave(file);
+        const normalized = normalizeUploadResult(uploadResult);
+        return { candidate, file, ...normalized };
+      } catch (error) {
+        return { candidate, error: getErrorReason(error) };
+      }
+    })
+  );
+  for (const item of uploadResults) {
+    if ("error" in item) {
+      errors.push({
+        index: item.candidate.index,
+        reason: item.error ?? "Unknown upload error."
+      });
+      continue;
+    }
+    replacements.set(item.candidate.id, item.url);
+    uploaded.push({
+      url: item.url,
+      file: item.file,
+      meta: item.meta
+    });
+    inlineUploaded.push({
+      index: item.candidate.index,
+      url: item.url,
+      file: item.file,
+      meta: item.meta
+    });
+  }
+  if (replacements.size === 0) {
+    return createResult({ html, uploaded, inlineUploaded, errors });
+  }
+  let transformed = "";
+  let cursor = 0;
+  for (const match of imgMatches) {
+    transformed += html.slice(cursor, match.start);
+    const replacementKey = `${match.start}:${match.end}`;
+    const replacementUrl = replacements.get(replacementKey);
+    transformed += replacementUrl ? replaceSrcInTag(match, replacementUrl) : match.tag;
+    cursor = match.end;
+  }
+  transformed += html.slice(cursor);
+  return createResult({ html: transformed, uploaded, inlineUploaded, errors });
+}
+
 // ../../components/ui/UEditor/UEditor.tsx
 import { jsx as jsx85, jsxs as jsxs78 } from "react/jsx-runtime";
-var UEditor = ({
+var UEditor = React72.forwardRef(({
   content = "",
   onChange,
   onHtmlChange,
   onJsonChange,
   uploadImage,
+  uploadImageForSave,
   imageInsertMode = "base64",
   placeholder,
   className,
@@ -24280,9 +24527,10 @@ var UEditor = ({
   minHeight = "200px",
   maxHeight = "auto",
   variant = "default"
-}) => {
+}, ref) => {
   const t = useTranslations7("UEditor");
   const effectivePlaceholder = placeholder ?? t("placeholder");
+  const inFlightPrepareRef = useRef34(null);
   const extensions = useMemo28(
     () => buildUEditorExtensions({ placeholder: effectivePlaceholder, maxCharacters, uploadImage, imageInsertMode, editable }),
     [effectivePlaceholder, maxCharacters, uploadImage, imageInsertMode, editable]
@@ -24392,6 +24640,28 @@ var UEditor = ({
       onJsonChange?.(editor2.getJSON());
     }
   });
+  useImperativeHandle3(
+    ref,
+    () => ({
+      prepareContentForSave: async ({ throwOnError = false } = {}) => {
+        if (!inFlightPrepareRef.current) {
+          const htmlSnapshot = editor?.getHTML() ?? content ?? "";
+          inFlightPrepareRef.current = prepareUEditorContentForSave({
+            html: htmlSnapshot,
+            uploadImageForSave
+          }).finally(() => {
+            inFlightPrepareRef.current = null;
+          });
+        }
+        const result = await inFlightPrepareRef.current;
+        if (throwOnError && result.errors.length > 0) {
+          throw new UEditorPrepareContentForSaveError(result);
+        }
+        return result;
+      }
+    }),
+    [content, editor, uploadImageForSave]
+  );
   useEffect36(() => {
     if (editor && content !== editor.getHTML()) {
       if (editor.isEmpty && content) {
@@ -24439,7 +24709,8 @@ var UEditor = ({
       ]
     }
   );
-};
+});
+UEditor.displayName = "UEditor";
 var UEditor_default = UEditor;
 
 // src/index.ts
@@ -24584,6 +24855,7 @@ export {
   Tooltip,
   TranslationProvider,
   UEditor_default as UEditor,
+  UEditorPrepareContentForSaveError,
   UnderverseProvider,
   VARIANT_STYLES_ALERT,
   VARIANT_STYLES_BTN,
@@ -24591,9 +24863,12 @@ export {
   Watermark_default as Watermark,
   cn,
   cn2 as cnLocal,
+  extractImageSrcsFromHtml,
   getAnimationStyles,
   getUnderverseMessages,
   injectAnimationStyles,
+  normalizeImageUrl,
+  prepareUEditorContentForSave,
   shadcnAnimationStyles2 as shadcnAnimationStyles,
   underverseMessages,
   useFormField,