@underverse-ui/underverse 1.0.203 → 1.0.204

package/dist/ueditor.d.cts

@@ -0,0 +1,136 @@
+import React__default from 'react';
+import { Extension, Editor } from '@tiptap/core';
+
+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 {
+    editor?: Editor | null;
+    prepareContentForSave: (options?: UEditorPrepareContentForSaveOptions) => Promise<UEditorPrepareContentForSaveResult>;
+}
+type UEditorFontFamilyOption = {
+    label: string;
+    value: string;
+};
+type UEditorFontSizeOption = {
+    label: string;
+    value: string;
+};
+type UEditorLineHeightOption = {
+    label: string;
+    value: string;
+};
+type UEditorLetterSpacingOption = {
+    label: string;
+    value: string;
+};
+/** Public props for the `UEditor` component. */
+interface UEditorProps {
+    /** Initial or controlled HTML content for the editor. */
+    content?: string;
+    /** Called with the current HTML after editor updates. Kept for backward compatibility with `onHtmlChange`. */
+    onChange?: (content: string) => void;
+    /** Called with the current HTML after editor updates. Prefer this when the consumer stores HTML. */
+    onHtmlChange?: (html: string) => void;
+    /** Called with the current TipTap JSON document after editor updates. */
+    onJsonChange?: (json: object) => void;
+    /** Uploads images immediately when they are inserted in `imageInsertMode="upload"`. */
+    uploadImage?: (file: File) => Promise<string> | string;
+    /** Uploads embedded/base64 images during `prepareContentForSave`; use this for save-time normalization. */
+    uploadImageForSave?: UEditorUploadImageForSave;
+    /** Maximum number of concurrent save-time image/file uploads. */
+    uploadImageConcurrency?: number;
+    /** Whether inserted images are kept as base64 in editor state or uploaded immediately. */
+    imageInsertMode?: "base64" | "upload";
+    maxImageFileSize?: number;
+    allowedImageMimeTypes?: string[];
+    fallbackToDataUrl?: boolean;
+    placeholder?: string;
+    className?: string;
+    editable?: boolean;
+    autofocus?: boolean;
+    showToolbar?: boolean;
+    showBubbleMenu?: boolean;
+    showFloatingMenu?: boolean;
+    showCharacterCount?: boolean;
+    /** Whether to show the editor footer. Defaults to `true`. */
+    showFooter?: boolean;
+    maxCharacters?: number;
+    minHeight?: number | string;
+    maxHeight?: number | string;
+    variant?: "default" | "minimal" | "medium" | "medium-full" | "full" | "notion";
+    /** Whether the editor has rounded corners. Defaults to `true`. */
+    rounded?: boolean;
+    fontFamilies?: UEditorFontFamilyOption[];
+    fontSizes?: UEditorFontSizeOption[];
+    lineHeights?: UEditorLineHeightOption[];
+    letterSpacings?: UEditorLetterSpacingOption[];
+    fetchMetadata?: (url: string) => Promise<{
+        title?: string;
+        description?: string;
+        image?: string;
+        publisher?: string;
+    }>;
+    /** Uploads file cards immediately after insertion when available. */
+    uploadFile?: (file: File) => Promise<string> | string;
+    /** Uploads embedded/base64 file cards during `prepareContentForSave`; falls back to `uploadImageForSave` if omitted. */
+    uploadFileForSave?: (file: File) => Promise<string | ({
+        url: string;
+    } & Record<string, unknown>)>;
+    /** Additional TipTap extensions appended after the built-in UEditor extensions. */
+    extraExtensions?: Extension[];
+    showMenuBar?: boolean;
+    onSave?: () => void;
+    onExport?: () => void;
+    onSourceCode?: () => void;
+    /**
+     * Fires when View > Preview or the eye button is clicked.
+     * Return false to prevent the built-in preview dialog.
+     */
+    onPreview?: (html: string) => void | false;
+}
+type UEditorVariant = NonNullable<UEditorProps["variant"]>;
+
+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, uploadFileForSave, uploadConcurrency, }: {
+    html: string;
+    uploadImageForSave?: UEditorUploadImageForSave;
+    uploadFileForSave?: (file: File) => Promise<string | ({
+        url: string;
+    } & Record<string, unknown>)>;
+    uploadConcurrency?: number;
+}): Promise<UEditorPrepareContentForSaveResult>;
+
+export { type UEditorFontFamilyOption, type UEditorFontSizeOption, type UEditorInlineUploadedItem, type UEditorLetterSpacingOption, type UEditorLineHeightOption, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, UEditor as default, extractImageSrcsFromHtml, normalizeImageUrl, prepareUEditorContentForSave };

package/dist/ueditor.d.ts

@@ -0,0 +1,136 @@
+import React__default from 'react';
+import { Extension, Editor } from '@tiptap/core';
+
+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 {
+    editor?: Editor | null;
+    prepareContentForSave: (options?: UEditorPrepareContentForSaveOptions) => Promise<UEditorPrepareContentForSaveResult>;
+}
+type UEditorFontFamilyOption = {
+    label: string;
+    value: string;
+};
+type UEditorFontSizeOption = {
+    label: string;
+    value: string;
+};
+type UEditorLineHeightOption = {
+    label: string;
+    value: string;
+};
+type UEditorLetterSpacingOption = {
+    label: string;
+    value: string;
+};
+/** Public props for the `UEditor` component. */
+interface UEditorProps {
+    /** Initial or controlled HTML content for the editor. */
+    content?: string;
+    /** Called with the current HTML after editor updates. Kept for backward compatibility with `onHtmlChange`. */
+    onChange?: (content: string) => void;
+    /** Called with the current HTML after editor updates. Prefer this when the consumer stores HTML. */
+    onHtmlChange?: (html: string) => void;
+    /** Called with the current TipTap JSON document after editor updates. */
+    onJsonChange?: (json: object) => void;
+    /** Uploads images immediately when they are inserted in `imageInsertMode="upload"`. */
+    uploadImage?: (file: File) => Promise<string> | string;
+    /** Uploads embedded/base64 images during `prepareContentForSave`; use this for save-time normalization. */
+    uploadImageForSave?: UEditorUploadImageForSave;
+    /** Maximum number of concurrent save-time image/file uploads. */
+    uploadImageConcurrency?: number;
+    /** Whether inserted images are kept as base64 in editor state or uploaded immediately. */
+    imageInsertMode?: "base64" | "upload";
+    maxImageFileSize?: number;
+    allowedImageMimeTypes?: string[];
+    fallbackToDataUrl?: boolean;
+    placeholder?: string;
+    className?: string;
+    editable?: boolean;
+    autofocus?: boolean;
+    showToolbar?: boolean;
+    showBubbleMenu?: boolean;
+    showFloatingMenu?: boolean;
+    showCharacterCount?: boolean;
+    /** Whether to show the editor footer. Defaults to `true`. */
+    showFooter?: boolean;
+    maxCharacters?: number;
+    minHeight?: number | string;
+    maxHeight?: number | string;
+    variant?: "default" | "minimal" | "medium" | "medium-full" | "full" | "notion";
+    /** Whether the editor has rounded corners. Defaults to `true`. */
+    rounded?: boolean;
+    fontFamilies?: UEditorFontFamilyOption[];
+    fontSizes?: UEditorFontSizeOption[];
+    lineHeights?: UEditorLineHeightOption[];
+    letterSpacings?: UEditorLetterSpacingOption[];
+    fetchMetadata?: (url: string) => Promise<{
+        title?: string;
+        description?: string;
+        image?: string;
+        publisher?: string;
+    }>;
+    /** Uploads file cards immediately after insertion when available. */
+    uploadFile?: (file: File) => Promise<string> | string;
+    /** Uploads embedded/base64 file cards during `prepareContentForSave`; falls back to `uploadImageForSave` if omitted. */
+    uploadFileForSave?: (file: File) => Promise<string | ({
+        url: string;
+    } & Record<string, unknown>)>;
+    /** Additional TipTap extensions appended after the built-in UEditor extensions. */
+    extraExtensions?: Extension[];
+    showMenuBar?: boolean;
+    onSave?: () => void;
+    onExport?: () => void;
+    onSourceCode?: () => void;
+    /**
+     * Fires when View > Preview or the eye button is clicked.
+     * Return false to prevent the built-in preview dialog.
+     */
+    onPreview?: (html: string) => void | false;
+}
+type UEditorVariant = NonNullable<UEditorProps["variant"]>;
+
+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, uploadFileForSave, uploadConcurrency, }: {
+    html: string;
+    uploadImageForSave?: UEditorUploadImageForSave;
+    uploadFileForSave?: (file: File) => Promise<string | ({
+        url: string;
+    } & Record<string, unknown>)>;
+    uploadConcurrency?: number;
+}): Promise<UEditorPrepareContentForSaveResult>;
+
+export { type UEditorFontFamilyOption, type UEditorFontSizeOption, type UEditorInlineUploadedItem, type UEditorLetterSpacingOption, type UEditorLineHeightOption, UEditorPrepareContentForSaveError, type UEditorPrepareContentForSaveOptions, type UEditorPrepareContentForSaveResult, type UEditorProps, type UEditorRef, type UEditorUploadImageForSave, type UEditorUploadImageForSaveResult, type UEditorVariant, UEditor as default, extractImageSrcsFromHtml, normalizeImageUrl, prepareUEditorContentForSave };

package/dist/ueditor.js

@@ -0,0 +1,20 @@
+"use client";
+import {
+  UEditorPrepareContentForSaveError,
+  UEditor_default,
+  extractImageSrcsFromHtml,
+  normalizeImageUrl,
+  prepareUEditorContentForSave
+} from "./chunk-CC3QO2YM.js";
+import "./chunk-ZUAIBY2Z.js";
+import "./chunk-KFTYWTJR.js";
+import "./chunk-GSBRTFP2.js";
+import "./chunk-NSBPE2FW.js";
+export {
+  UEditorPrepareContentForSaveError,
+  UEditor_default as default,
+  extractImageSrcsFromHtml,
+  normalizeImageUrl,
+  prepareUEditorContentForSave
+};
+//# sourceMappingURL=ueditor.js.map

package/dist/ueditor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@underverse-ui/underverse",
-  "version": "1.0.203",
+  "version": "1.0.204",
   "private": false,
   "description": "Underverse UI – reusable React/Next.js UI components",
   "type": "module",
@@ -23,6 +23,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./ueditor": {
+      "types": "./dist/ueditor.d.ts",
+      "import": "./dist/ueditor.js",
+      "require": "./dist/ueditor.cjs"
     }
   },
   "files": [
@@ -48,6 +53,8 @@
     "typecheck": "tsc -p tsconfig.tsup.json --noEmit --incremental false",
     "generate:api": "node ./scripts/generate-api-reference.mjs",
     "verify:agent-metadata": "npm run generate:api && node ./scripts/verify-agent-metadata.mjs",
+    "verify:package-exports": "node ./scripts/verify-package-exports.mjs",
+    "verify:root-tree-shaking": "node ./scripts/verify-root-tree-shaking.mjs",
     "test:overlay-scrollbar": "node --test --experimental-strip-types ./tests/overlay-scrollbar-provider.test.mjs",
     "test:data-table": "node --test --experimental-strip-types ./tests/data-table-sticky.test.mjs",
     "test:data-table-deep": "node --test --experimental-strip-types ./tests/data-table-headers-validation.test.mjs",
@@ -62,12 +69,13 @@
     "test:ueditor-form-fields": "node --test --experimental-strip-types ./tests/ueditor-form-fields.test.mjs",
     "test:ueditor-formula": "node --test --experimental-strip-types ./tests/ueditor-table-formula.test.mjs",
     "test:ueditor-ui": "node --test ./tests/ueditor.interaction.test.mjs",
+    "benchmark:ueditor": "node --expose-gc ./scripts/benchmark-ueditor.mjs",
     "test:public-api": "node --test ./tests/public-api-smoke.test.mjs",
     "test:components-smoke": "node --test ./tests/components-smoke.test.mjs",
     "test:sticker-ui": "node --test ./tests/sticker.interaction.test.mjs",
     "test:lunar": "node --test --experimental-strip-types ./tests/lunar-utils.test.mjs",
     "test:smoke": "npm run test:public-api && npm run test:components-smoke",
-    "build": "npm run typecheck && npm run check:boundaries && npm run generate:api && tsup --config tsup.config.ts",
+    "build": "npm run typecheck && npm run check:boundaries && npm run generate:api && tsup --config tsup.config.ts && npm run verify:package-exports && npm run verify:root-tree-shaking",
     "clean": "rimraf dist",
     "prepublishOnly": "npm run clean && node ./scripts/prepare-emojis.mjs && npm run prepare:stickers && npm run build",
     "release": "node ./scripts/release.mjs",
@@ -143,50 +151,50 @@
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
-    "@tiptap/core": "^3.16.0",
-    "@tiptap/extension-blockquote": "^3.16.0",
-    "@tiptap/extension-bold": "^3.16.0",
-    "@tiptap/extension-bubble-menu": "^3.16.0",
-    "@tiptap/extension-bullet-list": "^3.16.0",
-    "@tiptap/extension-character-count": "^3.16.0",
-    "@tiptap/extension-code": "^3.16.0",
-    "@tiptap/extension-code-block": "^3.16.0",
-    "@tiptap/extension-code-block-lowlight": "^3.16.0",
-    "@tiptap/extension-color": "^3.16.0",
-    "@tiptap/extension-document": "^3.16.0",
-    "@tiptap/extension-dropcursor": "^3.16.0",
-    "@tiptap/extension-floating-menu": "^3.16.0",
-    "@tiptap/extension-gapcursor": "^3.16.0",
-    "@tiptap/extension-heading": "^3.16.0",
-    "@tiptap/extension-highlight": "^3.16.0",
-    "@tiptap/extension-history": "^3.16.0",
-    "@tiptap/extension-horizontal-rule": "^3.17.0",
-    "@tiptap/extension-image": "^3.16.0",
-    "@tiptap/extension-italic": "^3.16.0",
-    "@tiptap/extension-link": "^3.16.0",
-    "@tiptap/extension-list": "^3.16.0",
-    "@tiptap/extension-list-item": "^3.16.0",
-    "@tiptap/extension-ordered-list": "^3.16.0",
-    "@tiptap/extension-paragraph": "^3.16.0",
-    "@tiptap/extension-placeholder": "^3.16.0",
-    "@tiptap/extension-strike": "^3.16.0",
-    "@tiptap/extension-subscript": "^3.16.0",
-    "@tiptap/extension-superscript": "^3.16.0",
-    "@tiptap/extension-table": "^3.16.0",
-    "@tiptap/extension-table-cell": "^3.16.0",
-    "@tiptap/extension-table-header": "^3.16.0",
-    "@tiptap/extension-table-row": "^3.16.0",
-    "@tiptap/extension-task-item": "^3.16.0",
-    "@tiptap/extension-task-list": "^3.16.0",
-    "@tiptap/extension-text": "^3.16.0",
-    "@tiptap/extension-text-align": "^3.16.0",
-    "@tiptap/extension-text-style": "^3.16.0",
-    "@tiptap/extension-typography": "^3.16.0",
-    "@tiptap/extension-underline": "^3.16.0",
-    "@tiptap/extensions": "^3.16.0",
-    "@tiptap/pm": "^3.16.0",
-    "@tiptap/react": "^3.16.0",
-    "@tiptap/suggestion": "^3.17.0",
+    "@tiptap/core": "^3.20.0",
+    "@tiptap/extension-blockquote": "^3.20.0",
+    "@tiptap/extension-bold": "^3.20.0",
+    "@tiptap/extension-bubble-menu": "^3.20.0",
+    "@tiptap/extension-bullet-list": "^3.20.0",
+    "@tiptap/extension-character-count": "^3.20.0",
+    "@tiptap/extension-code": "^3.20.0",
+    "@tiptap/extension-code-block": "^3.20.0",
+    "@tiptap/extension-code-block-lowlight": "^3.20.0",
+    "@tiptap/extension-color": "^3.20.0",
+    "@tiptap/extension-document": "^3.20.0",
+    "@tiptap/extension-dropcursor": "^3.20.0",
+    "@tiptap/extension-floating-menu": "^3.20.0",
+    "@tiptap/extension-gapcursor": "^3.20.0",
+    "@tiptap/extension-heading": "^3.20.0",
+    "@tiptap/extension-highlight": "^3.20.0",
+    "@tiptap/extension-history": "^3.20.0",
+    "@tiptap/extension-horizontal-rule": "^3.20.0",
+    "@tiptap/extension-image": "^3.20.0",
+    "@tiptap/extension-italic": "^3.20.0",
+    "@tiptap/extension-link": "^3.20.0",
+    "@tiptap/extension-list": "^3.20.0",
+    "@tiptap/extension-list-item": "^3.20.0",
+    "@tiptap/extension-ordered-list": "^3.20.0",
+    "@tiptap/extension-paragraph": "^3.20.0",
+    "@tiptap/extension-placeholder": "^3.20.0",
+    "@tiptap/extension-strike": "^3.20.0",
+    "@tiptap/extension-subscript": "^3.20.0",
+    "@tiptap/extension-superscript": "^3.20.0",
+    "@tiptap/extension-table": "^3.20.0",
+    "@tiptap/extension-table-cell": "^3.20.0",
+    "@tiptap/extension-table-header": "^3.20.0",
+    "@tiptap/extension-table-row": "^3.20.0",
+    "@tiptap/extension-task-item": "^3.20.0",
+    "@tiptap/extension-task-list": "^3.20.0",
+    "@tiptap/extension-text": "^3.20.0",
+    "@tiptap/extension-text-align": "^3.20.0",
+    "@tiptap/extension-text-style": "^3.20.0",
+    "@tiptap/extension-typography": "^3.20.0",
+    "@tiptap/extension-underline": "^3.20.0",
+    "@tiptap/extensions": "^3.20.0",
+    "@tiptap/pm": "^3.20.0",
+    "@tiptap/react": "^3.20.0",
+    "@tiptap/suggestion": "^3.20.0",
     "@types/tippy.js": "^6.3.0",
     "emoji-datasource-apple": "15.0.1",
     "jsdom": "^28.1.0",