tiptapify 0.2.4 → 0.2.5

package/src/i18n/locales/vi.json

@@ -1,206 +1,212 @@
 {
-  "defaultValue": "Giá trị mặc định",
-  "content": {
-    "placeholder": "Viết điều gì đó..."
-  },
-  "style": {
-    "paragraph": "Đoạn văn",
-    "heading": "Tiêu đề",
-    "headings": {
-      "h1": "Tiêu đề cấp 1",
-      "h2": "Tiêu đề cấp 2",
-      "h3": "Tiêu đề cấp 3",
-      "h4": "Tiêu đề cấp 4",
-      "h5": "Tiêu đề cấp 5",
-      "h6": "Tiêu đề cấp 6"
-    },
-    "fontFamily": "Gia phông chữ",
-    "fontSize": "Kích cỡ chữ",
-    "lineHeight": "Khoảng cách dòng",
-    "color": {
-      "highlight": "Màu tô đậm",
-      "text": "Màu văn bản",
-      "unset": "Xóa màu",
-      "custom": "Tùy chọn tùy chỉnh"
-    }
-  },
-  "format": {
-    "bold": "In đậm",
-    "italic": "In nghiêng",
-    "strike": "Gạch ngang",
-    "underline": "Gạch chân",
-    "sup": "Chữ viết trên",
-    "sub": "Chữ viết dưới",
-    "break": "Xuống dòng",
-    "line": "Đường thẳng ngang",
-    "blockquote": "Trích dẫn",
-    "code": "Mã",
-    "codeblock": "Khối mã",
-    "formatClear": "Xóa định dạng"
+  "action": {
+    "redo": "Làm lại",
+    "undo": "Hoàn tác"
   },
-  "media": {
-    "link": "Liên kết ngoài",
-    "iframe": "khung nhúng",
-    "image": "Hình ảnh",
-    "emoji": {
-      "title": "Biểu tượng cảm xúc",
-      "search": "Tìm kiếm biểu tượng cảm xúc...",
-      "categories": {
-        "activities": "Hoạt động",
-        "animals_and_nature": "Động vật và thiên nhiên",
-        "component": "Thành phần",
-        "flags": "Cờ",
-        "food_and_drink": "Đồ ăn thức uống",
-        "objects": "Vật thể",
-        "people_and_body": "Con người và cơ thể",
-        "smileys_and_emotion": "Biểu tượng cảm xúc",
-        "symbols": "Ký hiệu",
-        "travel_and_places": "Du lịch và địa điểm"
+  "ai": {
+    "append": "Thêm vào cuối",
+    "defaultExamples": {
+      "expand": {
+        "prompt": "Mở rộng đoạn văn này thành phiên bản chi tiết hơn.",
+        "title": "Mở rộng"
+      },
+      "improve": {
+        "prompt": "Hãy cải thiện sự rõ ràng và giọng văn của đoạn văn này.",
+        "title": "Cải thiện bài viết"
+      },
+      "proofReading": {
+        "prompt": "Sửa ngữ pháp, chính tả và dấu câu mà không thay đổi ý nghĩa.",
+        "title": "Soạn thảo"
+      },
+      "summarize": {
+        "prompt": "Tóm tắt đoạn văn này thành một đoạn ngắn gọn.",
+        "title": "Tóm tắt"
       }
     },
-    "tables": {
-      "table": "Bảng",
-      "insertTable": "Chèn bảng",
-      "deleteTable": "Xóa bảng",
-      "insertWithHeaderRow": "Chèn bảng có dòng tiêu đề",
-      "rows": "Hàng",
-      "row": "Hàng",
-      "insertRowBefore": "Chèn hàng trước",
-      "insertRowAfter": "Chèn hàng sau",
-      "deleteRow": "Xóa hàng",
-      "cols": "Cột",
-      "col": "Cột",
-      "insertColBefore": "Chèn cột trước",
-      "insertColAfter": "Chèn cột sau",
-      "deleteCol": "Xóa cột",
-      "mergeCells": "Hợp nhất ô",
-      "splitCell": "Tách ô"
-    },
-    "video": "Video",
-    "charmap": {
-      "title": "Chèn ký tự đặc biệt",
-      "search": "Tìm kiếm ký tự...",
-      "noResults": "Không tìm thấy ký tự phù hợp",
-      "categories": {
-        "punctuation": "Dấu câu",
-        "symbols": "Ký hiệu",
-        "math": "Toán học",
-        "currency": "Tiền tệ",
-        "greek": "Chữ cái Hy Lạp",
-        "extended_letters": "Chữ cái mở rộng",
-        "diacritics": "Dấu phụ",
-        "typography": "In ấn",
-        "cyrillic": "Chữ Kirin",
-        "hebrew": "Tiếng Do Thái",
-        "arrows": "Mũi tên",
-        "box_drawing": "Vẽ khung"
-      }
-    }
-  },
-  "action": {
-    "undo": "Hoàn tác",
-    "redo": "Làm lại"
+    "error": "Tạo nội dung AI thất bại",
+    "generate": "Tạo",
+    "insert": "Chèn",
+    "limit_exceeded": "Kết quả vượt quá giới hạn ký tự của trình soạn thảo. Hãy rút ngắn văn bản và áp dụng lại.",
+    "loading": "Đang tạo...",
+    "prompt": "Lệnh",
+    "quick_prompts": "Lệnh nhanh",
+    "reasoning_effort": "Mức độ suy luận",
+    "replace": "Thay thế",
+    "result": "Kết quả",
+    "stop": "Dừng",
+    "thinking": "Tư duy",
+    "title": "Viết bằng AI",
+    "unavailable": "Hãy cấu hình nhà cung cấp AI để sử dụng thao tác này"
   },
   "alignment": "Căn chỉnh",
   "alignments": {
-    "left": "Canh trái",
     "center": "Canh giữa",
-    "right": "Canh phải",
-    "justify": "Canh đều"
+    "justify": "Canh đều",
+    "left": "Canh trái",
+    "right": "Canh phải"
   },
-  "list": "Danh sách",
-  "lists": {
-    "bullet": "Danh sách không đánh số",
-    "numbered": "Danh sách có đánh số",
-    "task": "Danh sách công việc",
-    "indent": "Tăng thụt đầu dòng",
-    "outdent": "Giảm thụt đầu dòng"
+  "content": {
+    "placeholder": "Viết điều gì đó..."
   },
+  "defaultValue": "Giá trị mặc định",
   "dialog": {
     "apply": "Áp dụng",
     "clear": "Xóa",
     "close": "Đóng",
     "iframe": {
       "dialog_title": "Thêm/sửa khung nhúng",
-      "src": "Nguồn",
+      "frameborder": "Viền khung",
+      "height": "Chiều cao",
       "name": "Tên",
+      "src": "Nguồn",
+      "src_invalid": "URL đã nhập không hợp lệ",
       "title": "Tiêu đề",
-      "width": "Chiều rộng",
-      "height": "Chiều cao",
-      "frameborder": "Viền khung",
-      "src_invalid": "URL đã nhập không hợp lệ"
+      "width": "Chiều rộng"
     },
     "image": {
-      "title": "Tiêu đề",
-      "src": "Nguồn",
-      "keep_ratio": "Giữ tỷ lệ khung hình",
       "alt": "Văn bản thay thế",
-      "width": "Chiều rộng",
+      "dialog_title": "Thêm/sửa hình ảnh",
       "height": "Chiều cao",
-      "dialog_title": "Thêm/sửa hình ảnh"
+      "keep_ratio": "Giữ tỷ lệ khung hình",
+      "src": "Nguồn",
+      "title": "Tiêu đề",
+      "width": "Chiều rộng"
     },
     "link": {
-      "title": "Thêm/sửa liên kết",
+      "class": "Lớp CSS",
       "href": "Địa chỉ liên kết",
       "href_error": "Địa chỉ liên kết không hợp lệ",
+      "rel": "liên hệ",
       "target": "Mở tại...",
       "target_blank": "Cửa sổ mới",
       "target_self": "Cửa sổ hiện tại",
-      "rel": "liên hệ",
-      "class": "Lớp CSS"
+      "title": "Thêm/sửa liên kết"
     },
     "preview": {
       "title": "Xem trước"
     },
     "source": {
-      "title": "Xem mã nguồn",
-      "prettify": "Làm đẹp"
+      "prettify": "Làm đẹp",
+      "title": "Xem mã nguồn"
     },
     "video": {
-      "title": "Thêm/sửa video",
+      "height": "Chiều cao",
       "src": "Nguồn",
-      "width": "Chiều rộng",
-      "height": "Chiều cao"
+      "title": "Thêm/sửa video",
+      "width": "Chiều rộng"
     }
   },
+  "footer": {
+    "chars": "ký tự",
+    "limit": "giới hạn ký tự",
+    "words": "từ ngữ"
+  },
+  "format": {
+    "blockquote": "Trích dẫn",
+    "bold": "In đậm",
+    "break": "Xuống dòng",
+    "code": "Mã",
+    "codeblock": "Khối mã",
+    "formatClear": "Xóa định dạng",
+    "italic": "In nghiêng",
+    "line": "Đường thẳng ngang",
+    "strike": "Gạch ngang",
+    "sub": "Chữ viết dưới",
+    "sup": "Chữ viết trên",
+    "underline": "Gạch chân"
+  },
+  "list": "Danh sách",
+  "lists": {
+    "bullet": "Danh sách không đánh số",
+    "indent": "Tăng thụt đầu dòng",
+    "numbered": "Danh sách có đánh số",
+    "outdent": "Giảm thụt đầu dòng",
+    "task": "Danh sách công việc"
+  },
+  "media": {
+    "charmap": {
+      "categories": {
+        "arrows": "Mũi tên",
+        "box_drawing": "Vẽ khung",
+        "currency": "Tiền tệ",
+        "cyrillic": "Chữ Kirin",
+        "diacritics": "Dấu phụ",
+        "extended_letters": "Chữ cái mở rộng",
+        "greek": "Chữ cái Hy Lạp",
+        "hebrew": "Tiếng Do Thái",
+        "math": "Toán học",
+        "punctuation": "Dấu câu",
+        "symbols": "Ký hiệu",
+        "typography": "In ấn"
+      },
+      "noResults": "Không tìm thấy ký tự phù hợp",
+      "search": "Tìm kiếm ký tự...",
+      "title": "Chèn ký tự đặc biệt"
+    },
+    "emoji": {
+      "categories": {
+        "activities": "Hoạt động",
+        "animals_and_nature": "Động vật và thiên nhiên",
+        "component": "Thành phần",
+        "flags": "Cờ",
+        "food_and_drink": "Đồ ăn thức uống",
+        "objects": "Vật thể",
+        "people_and_body": "Con người và cơ thể",
+        "smileys_and_emotion": "Biểu tượng cảm xúc",
+        "symbols": "Ký hiệu",
+        "travel_and_places": "Du lịch và địa điểm"
+      },
+      "search": "Tìm kiếm biểu tượng cảm xúc...",
+      "title": "Biểu tượng cảm xúc"
+    },
+    "iframe": "khung nhúng",
+    "image": "Hình ảnh",
+    "link": "Liên kết ngoài",
+    "tables": {
+      "col": "Cột",
+      "cols": "Cột",
+      "deleteCol": "Xóa cột",
+      "deleteRow": "Xóa hàng",
+      "deleteTable": "Xóa bảng",
+      "insertColAfter": "Chèn cột sau",
+      "insertColBefore": "Chèn cột trước",
+      "insertRowAfter": "Chèn hàng sau",
+      "insertRowBefore": "Chèn hàng trước",
+      "insertTable": "Chèn bảng",
+      "insertWithHeaderRow": "Chèn bảng có dòng tiêu đề",
+      "mergeCells": "Hợp nhất ô",
+      "row": "Hàng",
+      "rows": "Hàng",
+      "splitCell": "Tách ô",
+      "table": "Bảng"
+    },
+    "video": "Video"
+  },
   "misc": {
     "fullscreen": "Chế độ toàn màn hình",
     "preview": "Xem trước",
     "source": "Xem mã nguồn",
     "toggleInvisibleCharacters": "Hiện/ẩn ký tự vô hình"
   },
-  "footer": {
-    "words": "từ ngữ",
-    "chars": "ký tự",
-    "limit": "giới hạn ký tự"
-  },
-  "ai": {
-    "title": "AI assistant",
-    "prompt": "Prompt",
-    "examples": "Examples",
-    "generate": "Generate",
-    "apply": "Apply",
-    "result": "Result",
-    "loading": "Generating...",
-    "unavailable": "Configure an AI provider to use this action",
-    "error": "AI generation failed",
-    "defaultExamples": {
-      "improve": {
-        "title": "Improve writing",
-        "prompt": "Improve the clarity and tone of this text."
-      },
-      "proofReading": {
-        "title": "Proof-reading",
-        "prompt": "Correct grammar, spelling, and punctuation without changing the meaning."
-      },
-      "summarize": {
-        "title": "Summarize",
-        "prompt": "Summarize this text in a concise paragraph."
-      },
-      "expand": {
-        "title": "Expand",
-        "prompt": "Expand this into a more detailed version."
-      }
-    }
+  "style": {
+    "color": {
+      "custom": "Tùy chọn tùy chỉnh",
+      "highlight": "Màu tô đậm",
+      "text": "Màu văn bản",
+      "unset": "Xóa màu"
+    },
+    "fontFamily": "Gia phông chữ",
+    "fontSize": "Kích cỡ chữ",
+    "heading": "Tiêu đề",
+    "headings": {
+      "h1": "Tiêu đề cấp 1",
+      "h2": "Tiêu đề cấp 2",
+      "h3": "Tiêu đề cấp 3",
+      "h4": "Tiêu đề cấp 4",
+      "h5": "Tiêu đề cấp 5",
+      "h6": "Tiêu đề cấp 6"
+    },
+    "lineHeight": "Khoảng cách dòng",
+    "paragraph": "Đoạn văn"
   }
 }

package/src/index.ts

@@ -54,9 +54,12 @@ export type {
   TiptapifyAiEditorContext,
   TiptapifyAiOpenAiResponse,
   TiptapifyAiPromptExample,
+  TiptapifyAiReasoningEffort,
+  TiptapifyAiReasoningEffortOptions,
   TiptapifyAiProvider,
   TiptapifyAiRequest,
   TiptapifyAiResponse,
   TiptapifyAiStorage,
+  TiptapifyAiStream,
   TiptapifyAiTokenProvider,
 } from '@tiptapify/types/editor'

package/src/types/editor.ts

@@ -38,10 +38,17 @@ export type TiptapifyAiRequest = {
   model?: string,
   messages: TiptapifyAiChatMessage[],
   temperature?: number,
-  stream?: false,
+  stream?: boolean,
   [key: string]: unknown,
 }
 
+export type TiptapifyAiReasoningEffort = 'low' | 'medium' | 'high'
+
+export type TiptapifyAiReasoningEffortOptions = {
+  options: TiptapifyAiReasoningEffort[],
+  default?: TiptapifyAiReasoningEffort,
+}
+
 export type TiptapifyAiResponse = {
   content: string,
 }
@@ -55,7 +62,17 @@ export type TiptapifyAiOpenAiResponse = {
   }>,
 }
 
-export type TiptapifyAiProvider = (request: TiptapifyAiRequest, context: TiptapifyAiEditorContext) => Promise<TiptapifyAiResponse | TiptapifyAiOpenAiResponse | string>
+export type TiptapifyAiStream = {
+  signal: AbortSignal,
+  onChunk: (chunk: string) => void,
+  onReasoning: (chunk: string) => void,
+}
+
+export type TiptapifyAiProvider = (
+  request: TiptapifyAiRequest,
+  context: TiptapifyAiEditorContext,
+  stream?: TiptapifyAiStream,
+) => Promise<TiptapifyAiResponse | TiptapifyAiOpenAiResponse | string>
 
 export type TiptapifyAiTokenProvider = () => Promise<string | null> | string | null
 
@@ -73,6 +90,10 @@ export type TiptapifyAiOptions = {
   defaultPrompt?: string,
   systemPrompt?: string,
   temperature?: number,
+  stream?: boolean,
+  thinking?: boolean,
+  reasoningEffort?: TiptapifyAiReasoningEffortOptions,
+  showReasoning?: boolean,
   chatCompletionOptions?: Record<string, unknown>,
   createMessages?: (context: TiptapifyAiEditorContext) => TiptapifyAiChatMessage[],
   tokenProvider?: TiptapifyAiTokenProvider,

package/src/utils/validateHref.test.ts

@@ -0,0 +1,68 @@
+import { describe, it, expect } from 'vitest'
+import { isValidHref } from './validateHref'
+
+describe('isValidHref', () => {
+  it('accepts a URL with a path and query parameters', () => {
+    expect(isValidHref('https://google.com/search?q=123&page=12')).toBe(true)
+  })
+
+  it('accepts a URL with query parameters right after the domain slash', () => {
+    expect(isValidHref('https://google.com/?q=123&page=12')).toBe(true)
+  })
+
+  it('accepts a URL with only a trailing slash', () => {
+    expect(isValidHref('https://google.com/')).toBe(true)
+  })
+
+  it('accepts a URL with only a domain', () => {
+    expect(isValidHref('https://google.com')).toBe(true)
+  })
+
+  it('accepts http URLs', () => {
+    expect(isValidHref('http://example.com')).toBe(true)
+  })
+
+  it('accepts a URL with basic auth, nested path, fragment, query and extra parameters', () => {
+    expect(isValidHref('https://user:pass@example.com/a/b#frag?q=1&r=2')).toBe(true)
+  })
+
+  it('accepts a query value with dashes, underscores and percent-encoded characters', () => {
+    expect(isValidHref('https://example.com/a/b?q=1-2_3%40&r=99')).toBe(true)
+  })
+
+  it('accepts mailto links', () => {
+    expect(isValidHref('mailto:test@example.com')).toBe(true)
+  })
+
+  it('accepts tel links', () => {
+    expect(isValidHref('tel:+79990001122')).toBe(true)
+  })
+
+  it('rejects an empty string', () => {
+    expect(isValidHref('')).toBe(false)
+  })
+
+  it('rejects a protocol-only URL', () => {
+    expect(isValidHref('https://')).toBe(false)
+  })
+
+  it('rejects a domain without a TLD dot', () => {
+    expect(isValidHref('https://.com')).toBe(false)
+  })
+
+  it('rejects unsupported protocols', () => {
+    expect(isValidHref('ftp://example.com')).toBe(false)
+  })
+
+  it('rejects javascript pseudo-protocols', () => {
+    expect(isValidHref('javascript:alert(1)')).toBe(false)
+  })
+
+  it('rejects URLs containing spaces', () => {
+    expect(isValidHref('https://exa mple.com')).toBe(false)
+  })
+
+  it('rejects plain text', () => {
+    expect(isValidHref('not a url')).toBe(false)
+  })
+})

package/src/utils/validateHref.ts

@@ -0,0 +1,21 @@
+const azAZ09 = 'a-zA-Z0-9'
+
+const regexHrefProto = 'https?:\\/\\/'
+const regexHrefAuth = `([${azAZ09}]+(:[${azAZ09}]+)?@)?`
+const regexHrefDomain = `[${azAZ09}]+(\\.[${azAZ09}]+(-?[${azAZ09}]+)?)+`
+const regexHrefPath = `(\\/[${azAZ09}\\-]+)*\\/?`
+const regexHrefFragment = '(#[^\\s]*)?'
+const regexHrefQueryParam = `(\\?[${azAZ09}\\-_]+((\\[[${azAZ09}]+\\])?=[${azAZ09}\\-_%]+)?)?`
+const regexHrefQueryParamExtra = `(&[${azAZ09}\\-_]+((\\[[${azAZ09}]+\\])?=[${azAZ09}\\-_%]+)?)*`
+const regexHref = `${regexHrefProto}${regexHrefAuth}${regexHrefDomain}${regexHrefPath}${regexHrefFragment}${regexHrefQueryParam}${regexHrefQueryParamExtra}`
+
+const regexMailto = `mailto:\\w+@[${azAZ09}]+(\\.[${azAZ09}]+)*`
+const regexTel = 'tel:\\+?[0-9]+'
+
+const regexAll = [regexHref, regexMailto, regexTel].join('|')
+
+const hrefRegex = new RegExp(`^(${regexAll})$`, 'i')
+
+export function isValidHref(href: string): boolean {
+  return hrefRegex.test(href || '')
+}