@seyamali/aurelia-editor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seyam Ali
+
+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,154 @@
+# Aurelia Editor
+
+[![NPM Version](https://img.shields.io/npm/v/@seyamali/aurelia-editor?style=flat-square&color=blue)](https://www.npmjs.com/package/@seyamali/aurelia-editor)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/Written%20With-TypeScript-3178C6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+
+**Aurelia Editor** is a powerful, customizable, and framework-agnostic rich text editor built on top of [Lexical](https://lexical.dev/). It is designed for modern content creation, offering a clean, "Notion-style" interface combined with enterprise-grade features like MS Word compatibility, PDF export, and advanced layout tools.
+
+![Editor Preview](https://via.placeholder.com/800x400?text=Aurelia+Editor+Preview)
+
+---
+
+## ✨ Features
+ 
+**Aurelia Editor** delivers a premium writing experience with a "batteries-included" philosophy:
+ 
+### 📝 Core Editing
+*   **Rich Text**: Bold, Italic, Underline, Strikethrough, Subscript, Superscript, Inline Code.
+*   **Typography**: Hierarchical headings (H1-H6), Blockquotes, Dividers.
+*   **Fonts & Color**: Custom font families, text colors, and background highlights.
+*   **Lists**: Nested bullet and numbered lists with indentation controls.
+*   **Case Converter**: Toggle text between Uppercase, Lowercase, and Title Case.
+*   **Clear Formatting**: Instantly strip styles from copied text.
+ 
+### 🖼️ Media & Embeds
+*   **Smart Images**: Drag & drop upload, resize, alignment positioning, captions, and link support.
+*   **Video Embedding**: YouTube integration with preview.
+*   **HTML Snippets**: Insert raw HTML for custom widgets or layouts.
+*   **Files**: Support for generic file attachments (extensible).
+ 
+### 📊 Structured Content
+*   **Advanced Tables**: Header rows, cell merging, splitting, column resizing, and row/column management.
+*   **Code Blocks**: Syntax highlighting for multiple languages with copy support.
+*   **Table of Contents**: Auto-generated TOC based on document headings with scroll-spy.
+*   **Footnotes**: Academic-style referencing and footnotes.
+*   **Page Layout**: Page breaks and print-ready styles.
+ 
+### 🚀 Productivity Tools
+*   **Slash Commands**: Type `/` to access a unified menu for all tools.
+*   **Format Painter**: Copy and paste styles between text blocks.
+*   **Find & Replace**: Search with match highlighting and bulk replacement.
+*   **Autosave**: Automatic local backup to prevent data loss.
+*   **Mentions & Tags**: Support for `@user` mentions or custom tags (configurable).
+*   **Placeholders / Merge Fields**: Insert dynamic variables like `{{FirstName}}`.
+*   **Emoji Picker**: Built-in library for expressive writing.
+ 
+### 👀 View & Analysis
+*   **Document Outline**: Sidebar navigation for long documents.
+*   **Minimap**: VS Code-style minimap for quick scrolling.
+*   **Zen Mode**: Distraction-free full-screen writing.
+*   **Source View**: Edit the underlying HTML directly.
+*   **Word Count**: Real-time statistics.
+ 
+### 🔄 Collaboration & History
+*   **Track Changes**: Suggestion mode (Accept/Reject changes).
+*   **Revision History**: visual history of edits (if backend connected).
+*   **Comments**: Threaded comments support (framework ready).
+ 
+### 📤 Import / Export
+*   **PDF Export**: High-fidelity client-side PDF generation.
+*   **Word Support**: Import `.docx` files and export content to Word.
+*   **Markdown**: Full Markdown shortcut support (`##`, `*`, `>`).
+
+---
+
+## 📦 Installation
+
+Install the package via npm:
+
+```bash
+npm install @seyamali/aurelia-editor
+```
+
+---
+
+## 🛠️ Usage
+
+### Basic Setup
+Initialize the editor by mounting it to a DOM element:
+
+```typescript
+import { AureliaEditor } from '@seyamali/aurelia-editor';
+import '@seyamali/aurelia-editor/dist/style.css';
+
+const editor = new AureliaEditor({
+  element: document.getElementById('editor-root'),
+  theme: 'default',
+  placeholder: 'Start writing...'
+});
+
+editor.render();
+```
+
+### Retrieval & Events
+Listen to changes or get the content:
+
+```typescript
+// Get HTML content
+const html = editor.getHTML();
+
+// Get JSON State
+const jsonState = editor.getEditorState();
+
+// Listen for updates
+editor.on('update', (content) => {
+  console.log('Document updated:', content);
+});
+```
+
+---
+
+## ⚙️ Configuration
+
+Aurelia Editor features a dynamic toolbar system. You can switch between built-in presets or define your own configuration.
+
+### Toolbar Presets
+Available presets: `standard`, `minimal`, `blogging`, `full`.
+
+```typescript
+import { ToolbarConfigManager } from '@seyamali/aurelia-editor';
+
+// Switch to a minimal, distraction-free interface
+ToolbarConfigManager.applyPreset('minimal');
+```
+
+---
+
+## ⌨️ Shortcuts
+
+| Context | Shortcut | Action |
+| :--- | :--- | :--- |
+| **Formatting** | `Ctrl + B` | Bold |
+| | `Ctrl + I` | Italic |
+| | `Ctrl + U` | Underline |
+| **History** | `Ctrl + Z` | Undo |
+| | `Ctrl + Y` | Redo |
+| **Tools** | `/` | Slash Menu |
+| | `Ctrl + F` | Find & Replace |
+| | `Ctrl + S` | Save (Autosave trigger) |
+| **Navigation** | `Ctrl + K` | Insert Link |
+
+---
+
+## 📄 License & Attribution
+
+This project is open-source software licensed under the **MIT License**.
+
+### Terms of Use:
+*   ✅ **Commercial Use**: Allowed
+*   ✅ **Modification**: Allowed
+*   ✅ **Private Use**: Allowed
+*   ⚠️ **Attribution Required**: You must retain the copyright notice and license file in your source code.
+
+**Copyright © 2026 Seyam Ali**. All rights reserved.

package/dist/core/commands.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine.d.ts

@@ -0,0 +1,11 @@
+import { LexicalEditor } from 'lexical';
+import { EditorPlugin } from './registry';
+export declare class AureliaEditor {
+    private editor;
+    private registry;
+    constructor(element: HTMLDivElement);
+    use(plugin: EditorPlugin): void;
+    execute(command: any, payload?: any): void;
+    update(updateFn: () => void): void;
+    getInternalEditor(): LexicalEditor;
+}

package/dist/core/registry.d.ts

@@ -0,0 +1,13 @@
+import { LexicalEditor } from 'lexical';
+import { EditorSDK } from './sdk';
+export interface EditorPlugin {
+    name: string;
+    init: (sdk: EditorSDK) => void;
+}
+export declare class PluginRegistry {
+    private plugins;
+    private sdk;
+    constructor(editor: LexicalEditor);
+    register(plugin: EditorPlugin): void;
+    getSDK(): EditorSDK;
+}

package/dist/core/sdk.d.ts

@@ -0,0 +1,57 @@
+import { LexicalEditor, LexicalCommand, CommandListenerPriority } from 'lexical';
+/**
+ * The EditorSDK provides a stable, simplified interface for plugin developers
+ * to interact with the AureliaEditor without needing deep knowledge of Lexical internals.
+ */
+export declare class EditorSDK {
+    private editor;
+    constructor(editor: LexicalEditor);
+    /**
+     * Get the underlying Lexical editor instance.
+     */
+    getLexicalEditor(): LexicalEditor;
+    /**
+     * Dispatch a command to the editor.
+     */
+    dispatchCommand<T>(command: LexicalCommand<T>, payload: T): void;
+    /**
+     * Register a command with the editor.
+     */
+    registerCommand<P>(command: LexicalCommand<P>, handler: (payload: P) => boolean, priority: CommandListenerPriority): () => void;
+    /**
+     * Register an update listener.
+     */
+    registerUpdateListener(listener: any): () => void;
+    /**
+     * Run an update on the editor state.
+     */
+    update(updateFn: () => void): void;
+    /**
+     * Get the editor root element.
+     */
+    getRootElement(): HTMLElement | null;
+    /**
+     * Check if nodes are registered.
+     */
+    hasNodes(nodes: Array<any>): boolean;
+    /**
+     * Get a node element by its key.
+     */
+    getElementByKey(key: string): HTMLElement | null;
+    /**
+     * Announce a message to screen readers (Accessibility).
+     */
+    announce(message: string): void;
+    /**
+     * Register a new button on the toolbar programmatically.
+     * @param buttonConfig Configuration for the new button.
+     */
+    addToolbarButton(config: {
+        id: string;
+        label: string;
+        icon?: string;
+        onClick: () => void;
+        tooltip?: string;
+        i18nKey?: string;
+    }): void;
+}

package/dist/counter.d.ts

@@ -0,0 +1 @@
+export declare function setupCounter(element: HTMLButtonElement): void;

package/dist/horizontal-rule-plugin-DdpCd1us.js

@@ -0,0 +1,20 @@
+import { J as r, f as i } from "./index-C9G087KG.js";
+import { $getSelection as n, COMMAND_PRIORITY_EDITOR as a } from "lexical";
+import { $insertNodeToNearestRoot as l } from "@lexical/utils";
+const d = {
+  name: "HorizontalRulePlugin",
+  init: (e) => {
+    const t = e.getLexicalEditor();
+    t.registerCommand(
+      r,
+      () => t.getEditorState().read(() => n()) ? (t.update(() => {
+        const o = i();
+        l(o);
+      }), !0) : !1,
+      a
+    );
+  }
+};
+export {
+  d as HorizontalRulePlugin
+};