tiptop-editor 1.0.18 → 1.2.0

package/dist/types.d.ts

@@ -1,5 +1,33 @@
 import { Editor, EditorContentProps, Range, UseEditorOptions } from '@tiptap/react';
 import { icons } from 'lucide-react';
+export type ImageUploadResponseResolver = string | string[] | ((response: Record<string, unknown>) => string | null | undefined);
+export type TiptopEditorOptions = Omit<Partial<UseEditorOptions & {
+    /**
+   * The url of the server where the file should be uploaded.
+   * If not specified, the imageUploader will "fake" an upload for
+   * some seconds and create a local Url with the image file.
+   * @default undefined
+   */
+    imgUploadUrl?: string;
+    /**
+   * The key that holds the value of the image url from your server's response.
+   * Supports nested paths like `data.url`, path arrays like `['data', 'url']`,
+   * or a custom resolver function.
+   * @default undefined
+   */
+    imgUploadResponseKey?: ImageUploadResponseResolver;
+    /**
+   * Disables the default Card wrapper and removes the editor's built-in padding.
+   * Use this when you want to embed the editor inside your own layout container.
+   * @default false
+   */
+    disableDefaultContainer?: boolean;
+    /**
+   * Controls whether the drag handle is rendered.
+   * @default true
+   */
+    showDragHandle?: boolean;
+}>, 'extensions'>;
 export interface EditorButtonProps {
     tooltipText?: React.ReactNode;
     isIconOnly?: boolean;
@@ -35,20 +63,7 @@ export type TiptopEditorProps = Omit<EditorContentProps, 'editor'> & {
    * plus some other options specific to the Tiptop ccomponent
    * implementation.
    */
-    editorOptions?: Omit<Partial<UseEditorOptions & {
-        /**
-       * The url of the server where the file should be uploaded.
-       * If not specified, the imageUploader will "fake" an upload for
-       * some seconds and create a local Url with the image file.
-       * @default undefined
-       */
-        imgUploadUrl?: string;
-        /**
-         * The key that holds the value of the image url from your server's response.
-         * @default undefined
-         */
-        imgUploadResponseKey?: string;
-    }>, 'extensions'>;
+    editorOptions?: TiptopEditorOptions;
 };
 export interface ColorButtonProps {
     editor: Editor;
@@ -64,6 +79,12 @@ export interface TextSelectionMenuProps {
     prepend?: React.ReactNode;
     append?: React.ReactNode;
 }
+export interface TiptopEditorHandle {
+    getEditor: () => Editor | null;
+    on: Editor['on'];
+    off: Editor['off'];
+    once: Editor['once'];
+}
 export interface KeyDownRef {
     onKeyDown: (props: {
         event: KeyboardEvent;
@@ -79,9 +100,11 @@ export interface ImageUploaderExtensionOptions {
     imgUploadUrl?: string;
     /**
      * The key that holds the value of the image url from your server's response.
+     * Supports nested paths like `data.url`, path arrays like `['data', 'url']`,
+     * or a custom resolver function.
      * @default undefined
      */
-    imgUploadResponseKey?: string;
+    imgUploadResponseKey?: ImageUploadResponseResolver;
     allowedMimeTypes?: string[];
     maxFileSize: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiptop-editor",
-  "version": "1.0.18",
+  "version": "1.2.0",
   "description": "Notion-like editor built with Tiptap v3 and HeroUI",
   "type": "module",
   "main": "./dist/tiptop-editor.umd.js",
@@ -17,6 +17,10 @@
   "files": [
     "dist"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ds-mbappe/tiptop-editor"
+  },
   "homepage": "https://github.com/ds-mbappe/tiptop-editor#readme",
   "bugs": {
     "url": "https://github.com/ds-mbappe/tiptop-editor/issues",
@@ -26,7 +30,9 @@
     "dev": "vite",
     "clean": "rm -rf dist",
     "preview": "vite preview",
-    "build": "npm run clean && vite build"
+    "build": "npm run clean && vite build",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
   },
   "keywords": [
     "tiptap",
@@ -78,6 +84,7 @@
     "@tiptap/extension-node-range": "^3.0.9",
     "@tiptap/extension-subscript": "^3.0.9",
     "@tiptap/extension-superscript": "^3.0.9",
+    "@tiptap/extension-table": "^3.20.0",
     "@tiptap/extension-text-align": "^3.0.9",
     "@tiptap/extension-text-style": "^3.0.9",
     "@tiptap/extensions": "^3.0.9",
@@ -86,6 +93,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.30.1",
+    "@storybook/addon-docs": "^10.2.13",
+    "@storybook/react-vite": "^10.2.13",
     "@tailwindcss/vite": "^4.1.11",
     "@types/node": "^24.1.0",
     "@types/react": "^19.1.8",
@@ -96,6 +105,7 @@
     "eslint-plugin-react-refresh": "^0.4.20",
     "globals": "^16.3.0",
     "rollup-plugin-visualizer": "^6.0.3",
+    "storybook": "^10.2.13",
     "tailwindcss": "^4.1.11",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.35.1",

package/dist/components/TiptopEditor.d.ts

@@ -1,7 +0,0 @@
-import { useEditorState } from '@tiptap/react';
-import { TiptopEditorProps } from '../types';
-export interface TiptopEditorHandle {
-    getEditor: () => ReturnType<typeof useEditorState> | null;
-}
-declare const TiptopEditor: import('react').ForwardRefExoticComponent<Omit<TiptopEditorProps, "ref"> & import('react').RefAttributes<TiptopEditorHandle>>;
-export default TiptopEditor;