@editora/plugins 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ajay Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,559 @@
+# @editora/plugins
+
+Comprehensive plugin collection for Editora Rich Text Editor with 40+ plugins for text formatting, media management, accessibility, and more.
+
+## 📦 Installation
+
+```bash
+npm install @editora/plugins @editora/core
+```
+
+## 🎯 Overview
+
+This package provides a complete set of plugins for building feature-rich text editors. Each plugin is modular, tree-shakeable, and can be used independently.
+
+## ✨ Plugin Categories
+
+### Text Formatting (12 plugins)
+- Bold, Italic, Underline, Strikethrough
+- Font Family, Font Size, Text Color, Background Color
+- Subscript, Superscript, Code Inline
+- Clear Formatting
+
+### Block Elements (8 plugins)
+- Headings (H1-H6)
+- Paragraphs
+- Blockquotes
+- Code Blocks with syntax highlighting
+- Horizontal Rules
+- Page Breaks
+- Preformatted Text
+- Footnotes
+
+### Lists & Structure (5 plugins)
+- Bullet Lists
+- Numbered Lists
+- Checklists
+- Indent/Outdent
+- Text Alignment (Left, Center, Right, Justify)
+
+### Media & Embeds (6 plugins)
+- Images with upload
+- Videos
+- Audio
+- Embed IFrames
+- Media Manager
+- Special Characters & Emojis
+
+### Advanced Features (10 plugins)
+- Tables (full editing capabilities)
+- Math Equations (LaTeX support)
+- Merge Tags / Templates
+- Comments & Annotations
+- Document Manager (import/export)
+- Spell Checker
+- Accessibility Checker
+- Link Management
+- Anchor Links
+- Print Preview
+
+### Utilities (4 plugins)
+- History (Undo/Redo)
+- Fullscreen Mode
+- Line Height
+- Text Direction (LTR/RTL)
+- Capitalization (uppercase, lowercase, title case)
+
+## 🚀 Quick Start
+
+### Basic Formatting
+
+```typescript
+import {
+  createBoldPlugin,
+  createItalicPlugin,
+  createUnderlinePlugin,
+  createStrikethroughPlugin
+} from '@editora/plugins';
+
+const plugins = [
+  createBoldPlugin(),
+  createItalicPlugin(),
+  createUnderlinePlugin(),
+  createStrikethroughPlugin()
+];
+```
+
+### Complete Editor Setup
+
+```typescript
+import {
+  // Text formatting
+  createBoldPlugin,
+  createItalicPlugin,
+  createUnderlinePlugin,
+  createFontFamilyPlugin,
+  createFontSizePlugin,
+  createTextColorPlugin,
+  createBackgroundColorPlugin,
+  
+  // Block elements
+  createHeadingPlugin,
+  createParagraphPlugin,
+  createBlockquotePlugin,
+  createCodeSamplePlugin,
+  
+  // Lists
+  createListPlugin,
+  createChecklistPlugin,
+  createIndentPlugin,
+  createTextAlignmentPlugin,
+  
+  // Media
+  createImagePlugin,
+  createLinkPlugin,
+  createTablePlugin,
+  
+  // Advanced
+  createMathPlugin,
+  createCommentsPlugin,
+  createHistoryPlugin,
+  createFullscreenPlugin,
+  createDocumentManagerPlugin
+} from '@editora/plugins';
+
+const plugins = [
+  // ... initialize all plugins
+];
+```
+
+## 📖 Plugin API Reference
+
+### Text Formatting Plugins
+
+#### Bold Plugin
+```typescript
+createBoldPlugin(options?: {
+  keyboard?: string; // Default: 'Mod-b'
+  icon?: ReactNode;
+  className?: string;
+})
+```
+
+#### Font Family Plugin
+```typescript
+createFontFamilyPlugin(options?: {
+  fonts?: Array<{
+    name: string;
+    value: string;
+    fallback?: string;
+  }>;
+  defaultFont?: string;
+})
+
+// Example
+const fontFamilyPlugin = createFontFamilyPlugin({
+  fonts: [
+    { name: 'Arial', value: 'Arial, sans-serif' },
+    { name: 'Times New Roman', value: 'Times New Roman, serif' },
+    { name: 'Courier New', value: 'Courier New, monospace' }
+  ]
+});
+```
+
+#### Font Size Plugin
+```typescript
+createFontSizePlugin(options?: {
+  sizes?: string[]; // Default: ['8pt', '10pt', '12pt', '14pt', '18pt', '24pt', '36pt']
+  defaultSize?: string;
+})
+```
+
+#### Text Color Plugin
+```typescript
+createTextColorPlugin(options?: {
+  colors?: string[];
+  customColors?: boolean;
+  recentColors?: boolean;
+})
+```
+
+### Block Element Plugins
+
+#### Heading Plugin
+```typescript
+createHeadingPlugin(options?: {
+  levels?: number[]; // Default: [1, 2, 3, 4, 5, 6]
+  defaultLevel?: number;
+  keyboard?: Record<number, string>;
+})
+
+// Example
+const headingPlugin = createHeadingPlugin({
+  levels: [1, 2, 3],
+  keyboard: {
+    1: 'Mod-Alt-1',
+    2: 'Mod-Alt-2',
+    3: 'Mod-Alt-3'
+  }
+});
+```
+
+#### Code Sample Plugin
+```typescript
+createCodeSamplePlugin(options?: {
+  languages?: Array<{
+    name: string;
+    value: string;
+  }>;
+  theme?: 'light' | 'dark' | 'github' | 'monokai';
+  lineNumbers?: boolean;
+  highlightActiveLine?: boolean;
+})
+
+// Example
+const codeSamplePlugin = createCodeSamplePlugin({
+  languages: [
+    { name: 'JavaScript', value: 'javascript' },
+    { name: 'TypeScript', value: 'typescript' },
+    { name: 'Python', value: 'python' },
+    { name: 'HTML', value: 'html' },
+    { name: 'CSS', value: 'css' }
+  ],
+  theme: 'github',
+  lineNumbers: true
+});
+```
+
+### List Plugins
+
+#### List Plugin
+```typescript
+createListPlugin(options?: {
+  bulletList?: boolean;
+  orderedList?: boolean;
+  keyboard?: {
+    bullet?: string; // Default: 'Mod-Shift-8'
+    ordered?: string; // Default: 'Mod-Shift-7'
+  };
+})
+```
+
+#### Checklist Plugin
+```typescript
+createChecklistPlugin(options?: {
+  nested?: boolean;
+  keyboard?: string;
+})
+```
+
+### Media Plugins
+
+#### Image Plugin
+```typescript
+createImagePlugin(options: {
+  upload: (file: File) => Promise<string>;
+  validate?: (file: File) => boolean;
+  maxSize?: number; // bytes
+  allowedTypes?: string[];
+  resize?: boolean;
+  maxWidth?: number;
+  maxHeight?: number;
+  quality?: number; // 0-1
+})
+
+// Example
+const imagePlugin = createImagePlugin({
+  upload: async (file) => {
+    const formData = new FormData();
+    formData.append('image', file);
+    const response = await fetch('/api/upload', {
+      method: 'POST',
+      body: formData
+    });
+    const data = await response.json();
+    return data.url;
+  },
+  maxSize: 5 * 1024 * 1024, // 5MB
+  allowedTypes: ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],
+  resize: true,
+  maxWidth: 1200,
+  quality: 0.9
+});
+```
+
+#### Link Plugin
+```typescript
+createLinkPlugin(options?: {
+  openOnClick?: boolean;
+  validate?: (url: string) => boolean;
+  onLinkClick?: (url: string) => void;
+  targetBlank?: boolean;
+  nofollow?: boolean;
+})
+
+// Example
+const linkPlugin = createLinkPlugin({
+  openOnClick: false,
+  validate: (url) => {
+    return url.startsWith('http://') || url.startsWith('https://');
+  },
+  onLinkClick: (url) => {
+    window.open(url, '_blank', 'noopener,noreferrer');
+  },
+  targetBlank: true
+});
+```
+
+### Advanced Plugins
+
+#### Table Plugin
+```typescript
+createTablePlugin(options?: {
+  allowResize?: boolean;
+  defaultRows?: number;
+  defaultCols?: number;
+  maxRows?: number;
+  maxCols?: number;
+  cellSelection?: boolean;
+  headerRow?: boolean;
+})
+
+// Example
+const tablePlugin = createTablePlugin({
+  allowResize: true,
+  defaultRows: 3,
+  defaultCols: 3,
+  maxRows: 20,
+  maxCols: 10,
+  cellSelection: true,
+  headerRow: true
+});
+```
+
+#### Math Plugin
+```typescript
+createMathPlugin(options?: {
+  engine?: 'katex' | 'mathjax';
+  inline?: boolean;
+  display?: boolean;
+  macros?: Record<string, string>;
+})
+
+// Example
+const mathPlugin = createMathPlugin({
+  engine: 'katex',
+  inline: true,
+  display: true,
+  macros: {
+    '\\R': '\\mathbb{R}',
+    '\\N': '\\mathbb{N}'
+  }
+});
+```
+
+#### Comments Plugin
+```typescript
+createCommentsPlugin(options?: {
+  onCommentAdd?: (comment: Comment) => void;
+  onCommentEdit?: (comment: Comment) => void;
+  onCommentDelete?: (commentId: string) => void;
+  onCommentResolve?: (commentId: string) => void;
+  showResolved?: boolean;
+})
+```
+
+#### Document Manager Plugin
+```typescript
+createDocumentManagerPlugin(options?: {
+  export?: {
+    word?: boolean;
+    pdf?: boolean;
+    html?: boolean;
+    markdown?: boolean;
+  };
+  import?: {
+    word?: boolean;
+    html?: boolean;
+    markdown?: boolean;
+  };
+  fileName?: string;
+})
+
+// Example
+const documentManagerPlugin = createDocumentManagerPlugin({
+  export: {
+    word: true,
+    pdf: true,
+    html: true
+  },
+  fileName: 'document'
+});
+```
+
+#### Spell Check Plugin
+```typescript
+createSpellCheckPlugin(options?: {
+  language?: string; // Default: 'en-US'
+  customDictionary?: string[];
+  ignoreUppercase?: boolean;
+  ignoreNumbers?: boolean;
+})
+```
+
+#### Accessibility Checker Plugin
+```typescript
+createA11yCheckerPlugin(options?: {
+  rules?: string[];
+  autoCheck?: boolean;
+  severity?: 'error' | 'warning' | 'info';
+})
+```
+
+### Utility Plugins
+
+#### History Plugin
+```typescript
+createHistoryPlugin(options?: {
+  depth?: number; // Default: 100
+  keyboard?: {
+    undo?: string; // Default: 'Mod-z'
+    redo?: string; // Default: 'Mod-Shift-z'
+  };
+})
+```
+
+#### Fullscreen Plugin
+```typescript
+createFullscreenPlugin(options?: {
+  keyboard?: string; // Default: 'F11'
+  onEnter?: () => void;
+  onExit?: () => void;
+})
+```
+
+## 💡 Usage Examples
+
+### Blog Editor
+
+```typescript
+import {
+  createBoldPlugin,
+  createItalicPlugin,
+  createHeadingPlugin,
+  createParagraphPlugin,
+  createLinkPlugin,
+  createImagePlugin,
+  createListPlugin,
+  createBlockquotePlugin,
+  createHistoryPlugin
+} from '@editora/plugins';
+
+const blogPlugins = [
+  createBoldPlugin(),
+  createItalicPlugin(),
+  createHeadingPlugin({ levels: [1, 2, 3] }),
+  createParagraphPlugin(),
+  createLinkPlugin({ targetBlank: true }),
+  createImagePlugin({ 
+    upload: uploadImage,
+    maxSize: 2 * 1024 * 1024 
+  }),
+  createListPlugin(),
+  createBlockquotePlugin(),
+  createHistoryPlugin()
+];
+```
+
+### Technical Documentation Editor
+
+```typescript
+import {
+  createBoldPlugin,
+  createItalicPlugin,
+  createCodePlugin,
+  createCodeSamplePlugin,
+  createHeadingPlugin,
+  createTablePlugin,
+  createLinkPlugin,
+  createAnchorPlugin,
+  createMathPlugin,
+  createHistoryPlugin
+} from '@editora/plugins';
+
+const docsPlugins = [
+  createBoldPlugin(),
+  createItalicPlugin(),
+  createCodePlugin(),
+  createCodeSamplePlugin({
+    languages: [
+      { name: 'JavaScript', value: 'javascript' },
+      { name: 'TypeScript', value: 'typescript' },
+      { name: 'Python', value: 'python' }
+    ],
+    lineNumbers: true
+  }),
+  createHeadingPlugin(),
+  createTablePlugin({ headerRow: true }),
+  createLinkPlugin(),
+  createAnchorPlugin(),
+  createMathPlugin({ engine: 'katex' }),
+  createHistoryPlugin()
+];
+```
+
+### Collaborative Editor
+
+```typescript
+import {
+  createBoldPlugin,
+  createItalicPlugin,
+  createCommentsPlugin,
+  createHistoryPlugin,
+  createMergeTagPlugin
+} from '@editora/plugins';
+
+const collaborativePlugins = [
+  createBoldPlugin(),
+  createItalicPlugin(),
+  createCommentsPlugin({
+    onCommentAdd: async (comment) => {
+      await saveComment(comment);
+    },
+    onCommentResolve: async (commentId) => {
+      await resolveComment(commentId);
+    }
+  }),
+  createMergeTagPlugin({
+    tags: [
+      { label: 'First Name', value: '{{firstName}}' },
+      { label: 'Last Name', value: '{{lastName}}' },
+      { label: 'Email', value: '{{email}}' }
+    ]
+  }),
+  createHistoryPlugin()
+];
+```
+
+## 🔧 TypeScript Support
+
+All plugins include full TypeScript definitions:
+
+```typescript
+import type { Plugin, PluginConfig } from '@editora/plugins';
+
+const customConfig: PluginConfig = {
+  // Full type safety
+};
+```
+
+## 📄 License
+
+MIT © [Ajay Kumar](https://github.com/ajaykr089)
+
+## 🔗 Links
+
+- [Documentation](https://github.com/ajaykr089/Editora#readme)
+- [GitHub Repository](https://github.com/ajaykr089/Editora)
+- [Issue Tracker](https://github.com/ajaykr089/Editora/issues)
+- [npm Package](https://www.npmjs.com/package/@editora/plugins)

package/dist/documentManager-By_jb4HX.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./index-CGbrgpa_.js");async function l(i){return new Promise((o,r)=>{const t=new FileReader;t.onload=async e=>{try{const n=e.target?.result,a=await c.mammoth.convertToHtml({arrayBuffer:n});o(a.value)}catch(n){r(new Error(`Failed to import Word document: ${n}`))}},t.onerror=()=>r(new Error("Failed to read file")),t.readAsArrayBuffer(i)})}async function m(i,o="document.docx"){try{const r=c.getApiUrl("exportWord"),t=c.getApiHeaders(),e=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json",...t},body:JSON.stringify({htmlContent:i,filename:o})});if(!e.ok){const a=await e.json();throw new Error(a.error||"Failed to export document")}const n=await e.blob();h(n,o)}catch(r){throw new Error(`Failed to export to Word: ${r}`)}}async function p(i,o="document.pdf",r){try{const t=new c.E({orientation:"portrait",unit:"mm",format:"a4"}),e=20;if(r){const n=await c.html2canvas(r,{scale:2,useCORS:!0,allowTaint:!0}),a=n.toDataURL("image/png"),d=t.internal.pageSize.getWidth()-2*e,s=n.height*d/n.width;t.addImage(a,"PNG",e,e,d,s)}else{const n=u(i).split(`
+`);let a=e;n.forEach(d=>{a>t.internal.pageSize.getHeight()-e&&(t.addPage(),a=e),t.text(d,e,a),a+=7})}t.save(o)}catch(t){throw new Error(`Failed to export to PDF: ${t}`)}}function u(i){const o=document.createElement("div");return o.innerHTML=i,o.textContent||o.innerText||""}function h(i,o){const r=URL.createObjectURL(i),t=document.createElement("a");t.href=r,t.download=o,document.body.appendChild(t),t.click(),document.body.removeChild(t),URL.revokeObjectURL(r)}exports.exportToPdf=p;exports.exportToWord=m;exports.importFromWord=l;

package/dist/documentManager-DgU7aG0G.mjs

@@ -0,0 +1,77 @@
+import { m as s, g as l, a as m, E as p, h } from "./index-560-K8WX.mjs";
+async function w(i) {
+  return new Promise((o, r) => {
+    const t = new FileReader();
+    t.onload = async (e) => {
+      try {
+        const n = e.target?.result, a = await s.convertToHtml({ arrayBuffer: n });
+        o(a.value);
+      } catch (n) {
+        r(new Error(`Failed to import Word document: ${n}`));
+      }
+    }, t.onerror = () => r(new Error("Failed to read file")), t.readAsArrayBuffer(i);
+  });
+}
+async function y(i, o = "document.docx") {
+  try {
+    const r = l("exportWord"), t = m(), e = await fetch(r, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...t
+      },
+      body: JSON.stringify({
+        htmlContent: i,
+        filename: o
+      })
+    });
+    if (!e.ok) {
+      const a = await e.json();
+      throw new Error(a.error || "Failed to export document");
+    }
+    const n = await e.blob();
+    f(n, o);
+  } catch (r) {
+    throw new Error(`Failed to export to Word: ${r}`);
+  }
+}
+async function x(i, o = "document.pdf", r) {
+  try {
+    const t = new p({
+      orientation: "portrait",
+      unit: "mm",
+      format: "a4"
+    }), e = 20;
+    if (r) {
+      const n = await h(r, {
+        scale: 2,
+        useCORS: !0,
+        allowTaint: !0
+      }), a = n.toDataURL("image/png"), c = t.internal.pageSize.getWidth() - 2 * e, d = n.height * c / n.width;
+      t.addImage(a, "PNG", e, e, c, d);
+    } else {
+      const n = u(i).split(`
+`);
+      let a = e;
+      n.forEach((c) => {
+        a > t.internal.pageSize.getHeight() - e && (t.addPage(), a = e), t.text(c, e, a), a += 7;
+      });
+    }
+    t.save(o);
+  } catch (t) {
+    throw new Error(`Failed to export to PDF: ${t}`);
+  }
+}
+function u(i) {
+  const o = document.createElement("div");
+  return o.innerHTML = i, o.textContent || o.innerText || "";
+}
+function f(i, o) {
+  const r = URL.createObjectURL(i), t = document.createElement("a");
+  t.href = r, t.download = o, document.body.appendChild(t), t.click(), document.body.removeChild(t), URL.revokeObjectURL(r);
+}
+export {
+  x as exportToPdf,
+  y as exportToWord,
+  w as importFromWord
+};