@flogeez/angular-tiptap-editor 3.0.1 → 3.0.3

package/index.d.ts

@@ -5,8 +5,26 @@ import { Editor, NodeConfig, Extension, Node as Node$2, Mark, EditorOptions, JSO
 import { Observable } from 'rxjs';
 import { Node as Node$1 } from '@tiptap/pm/model';
 import { ControlValueAccessor } from '@angular/forms';
+import * as _popperjs_core from '@popperjs/core';
 import { Decoration, EditorView, NodeView } from '@tiptap/pm/view';
 
+/**
+ * Interface representing a single item in the slash commands menu.
+ */
+interface AteSlashCommandItem {
+    title: string;
+    description: string;
+    icon: string;
+    keywords: string[];
+    command: (editor: Editor) => void;
+}
+/**
+ * Custom slash commands configuration.
+ */
+interface AteCustomSlashCommands {
+    commands?: AteSlashCommandItem[];
+}
+
 type SupportedLocale = "en" | "fr" | (string & {});
 interface AteTranslations {
     toolbar: {
@@ -138,11 +156,15 @@ interface AteTranslations {
         invalidFileType: string;
         dragDropText: string;
         changeImage: string;
+        downloadImage: string;
         deleteImage: string;
         resizeSmall: string;
         resizeMedium: string;
         resizeLarge: string;
         resizeOriginal: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
         resizing: string;
         compressing: string;
         compressionError: string;
@@ -312,11 +334,15 @@ declare class AteI18nService {
         invalidFileType: string;
         dragDropText: string;
         changeImage: string;
+        downloadImage: string;
         deleteImage: string;
         resizeSmall: string;
         resizeMedium: string;
         resizeLarge: string;
         resizeOriginal: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
         resizing: string;
         compressing: string;
         compressionError: string;
@@ -401,17 +427,6 @@ declare class AteI18nService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AteI18nService>;
 }
 
-interface AteSlashCommandItem {
-    title: string;
-    description: string;
-    icon: string;
-    keywords: string[];
-    command: (editor: Editor) => void;
-}
-interface AteCustomSlashCommands {
-    commands?: AteSlashCommandItem[];
-}
-
 type AteStateCalculator = (editor: Editor) => Partial<{
     [K in keyof AteEditorStateSnapshot]: AteEditorStateSnapshot[K] extends object ? Partial<AteEditorStateSnapshot[K]> : AteEditorStateSnapshot[K];
 }>;
@@ -690,6 +705,7 @@ declare class AteEditorCommandsService {
     insertContent(editor: Editor, content: string): void;
     insertImage(editor: Editor, options?: AteImageUploadOptions): Promise<void>;
     uploadImage(editor: Editor, file: File, options?: AteImageUploadOptions): Promise<void>;
+    downloadImage(editor: Editor): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AteEditorCommandsService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AteEditorCommandsService>;
 }
@@ -768,7 +784,7 @@ interface AteCustomBubbleMenuItem {
 /**
  * Clés des options du menu bulle d'image
  */
-declare const ATE_IMAGE_BUBBLE_MENU_KEYS: readonly ["changeImage", "resizeSmall", "resizeMedium", "resizeLarge", "resizeOriginal", "deleteImage", "separator"];
+declare const ATE_IMAGE_BUBBLE_MENU_KEYS: readonly ["changeImage", "downloadImage", "resizeSmall", "resizeMedium", "resizeLarge", "resizeOriginal", "alignLeft", "alignCenter", "alignRight", "deleteImage", "separator"];
 type AteImageBubbleMenuKey = (typeof ATE_IMAGE_BUBBLE_MENU_KEYS)[number];
 type AteImageBubbleMenuConfig = Partial<Record<AteImageBubbleMenuKey, boolean>>;
 /**
@@ -974,6 +990,8 @@ interface AteEditorConfig {
     showTableMenu?: boolean;
     /** Show or hide the cell menu */
     showCellMenu?: boolean;
+    /** Whether to allow image downloading from bubble menu */
+    downloadImage?: boolean;
     /** Enable or disable slash commands (/) */
     enableSlashCommands?: boolean;
     /** Maximum number of characters allowed */
@@ -1063,7 +1081,7 @@ declare class AngularTiptapEditorComponent implements AfterViewInit, OnDestroy {
     showBubbleMenu: _angular_core.InputSignal<boolean | undefined>;
     bubbleMenu: _angular_core.InputSignal<Partial<AteBubbleMenuConfig> | undefined>;
     showImageBubbleMenu: _angular_core.InputSignal<boolean | undefined>;
-    imageBubbleMenu: _angular_core.InputSignal<Partial<Partial<Record<"separator" | "changeImage" | "resizeSmall" | "resizeMedium" | "resizeLarge" | "resizeOriginal" | "deleteImage", boolean>>> | undefined>;
+    imageBubbleMenu: _angular_core.InputSignal<Partial<Partial<Record<"separator" | "alignLeft" | "alignCenter" | "alignRight" | "changeImage" | "downloadImage" | "resizeSmall" | "resizeMedium" | "resizeLarge" | "resizeOriginal" | "deleteImage", boolean>>> | undefined>;
     toolbar: _angular_core.InputSignal<Partial<AteToolbarConfig> | undefined>;
     showTableBubbleMenu: _angular_core.InputSignal<boolean | undefined>;
     tableBubbleMenu: _angular_core.InputSignal<Partial<Partial<Record<"addColumnBefore" | "addColumnAfter" | "deleteColumn" | "addRowBefore" | "addRowAfter" | "deleteRow" | "deleteTable" | "toggleHeaderColumn" | "toggleHeaderRow" | "separator", boolean>>> | undefined>;
@@ -1144,7 +1162,7 @@ declare class AngularTiptapEditorComponent implements AfterViewInit, OnDestroy {
     readonly finalShowBubbleMenu: _angular_core.Signal<boolean>;
     readonly finalBubbleMenuConfig: _angular_core.Signal<AteBubbleMenuConfig>;
     readonly finalShowImageBubbleMenu: _angular_core.Signal<boolean>;
-    readonly finalImageBubbleMenuConfig: _angular_core.Signal<Partial<Record<"separator" | "changeImage" | "resizeSmall" | "resizeMedium" | "resizeLarge" | "resizeOriginal" | "deleteImage", boolean>>>;
+    readonly finalImageBubbleMenuConfig: _angular_core.Signal<Partial<Record<"separator" | "alignLeft" | "alignCenter" | "alignRight" | "changeImage" | "downloadImage" | "resizeSmall" | "resizeMedium" | "resizeLarge" | "resizeOriginal" | "deleteImage", boolean>>>;
     readonly finalShowTableBubbleMenu: _angular_core.Signal<boolean>;
     readonly finalTableBubbleMenuConfig: _angular_core.Signal<Partial<Record<"addColumnBefore" | "addColumnAfter" | "deleteColumn" | "addRowBefore" | "addRowAfter" | "deleteRow" | "deleteTable" | "toggleHeaderColumn" | "toggleHeaderRow" | "separator", boolean>>>;
     readonly finalShowCellBubbleMenu: _angular_core.Signal<boolean>;
@@ -1162,15 +1180,11 @@ declare class AngularTiptapEditorComponent implements AfterViewInit, OnDestroy {
     readonly finalAngularNodesConfig: _angular_core.Signal<AteAngularNode[]>;
     readonly finalImageUploadConfig: _angular_core.Signal<{
         maxSize: number;
-        quality: number;
-        maxWidth: number;
-        maxHeight: number;
-        allowedTypes: string[];
+        quality?: number;
+        maxWidth?: number;
+        maxHeight?: number;
+        allowedTypes?: string[];
         handler?: AteImageUploadHandler;
-        enableDragDrop: boolean;
-        showPreview: boolean;
-        multiple: boolean;
-        compressImages: boolean;
     }>;
     readonly finalImageUploadHandler: _angular_core.Signal<AteImageUploadHandler | undefined>;
     readonly currentTranslations: _angular_core.Signal<_flogeez_angular_tiptap_editor.AteTranslations>;
@@ -1208,6 +1222,7 @@ declare class AngularTiptapEditorComponent implements AfterViewInit, OnDestroy {
         showImageBubbleMenu?: boolean;
         showTableMenu?: boolean;
         showCellMenu?: boolean;
+        downloadImage?: boolean;
         enableSlashCommands?: boolean;
         maxCharacters?: number;
         toolbar?: AteToolbarConfig;
@@ -1267,6 +1282,35 @@ declare class AngularTiptapEditorComponent implements AfterViewInit, OnDestroy {
  */
 declare function provideAteEditor(config?: AteEditorConfig): EnvironmentProviders;
 
+declare class AteTooltipDirective implements OnDestroy {
+    private readonly el;
+    private tippyInstance;
+    content: _angular_core.InputSignal<string | null>;
+    placement: _angular_core.InputSignal<_popperjs_core.Placement>;
+    delay: _angular_core.InputSignal<number | [number, number]>;
+    disabled: _angular_core.InputSignal<boolean>;
+    /**
+     * Computed logic for ARIA shortcuts.
+     */
+    protected readonly ariaShortcut: _angular_core.Signal<string | null>;
+    /**
+     * Computed logic for Tippy content.
+     * Includes strict escaping of dynamic content to prevent XSS.
+     */
+    private readonly processedTooltip;
+    constructor();
+    ngOnDestroy(): void;
+    /**
+     * Basic HTML escaping for security.
+     * Effectively neutralizes scripts or malicious HTML tags.
+     */
+    private escapeHtml;
+    private initTippy;
+    private destroyTippy;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AteTooltipDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AteTooltipDirective, "[ateTooltip]", never, { "content": { "alias": "ateTooltip"; "required": false; "isSignal": true; }; "placement": { "alias": "ateTooltipPlacement"; "required": false; "isSignal": true; }; "delay": { "alias": "ateTooltipDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "ateTooltipDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class AteImageService {
     /** Signals for image state */
     selectedImage: _angular_core.WritableSignal<AteImageData | null>;
@@ -1306,6 +1350,8 @@ declare class AteImageService {
     } | null;
     /** Remove the selected image */
     deleteImage(editor: Editor): void;
+    /** Download the current image */
+    downloadImage(editor: Editor): void;
     private updateSelectedImage;
     /** Validate file type and size */
     validateImage(file: File, options?: {
@@ -1463,6 +1509,7 @@ declare const ATE_DEFAULT_BUBBLE_MENU_CONFIG: AteBubbleMenuConfig;
 declare const ATE_DEFAULT_IMAGE_BUBBLE_MENU_CONFIG: AteImageBubbleMenuConfig;
 declare const ATE_DEFAULT_TABLE_MENU_CONFIG: AteTableBubbleMenuConfig;
 declare const ATE_DEFAULT_CELL_MENU_CONFIG: AteCellBubbleMenuConfig;
+declare const ATE_DEFAULT_IMAGE_UPLOAD_CONFIG: AteImageUploadConfig;
 
 /**
  * Ultimate default configuration for the Angular Tiptap Editor.
@@ -1650,5 +1697,5 @@ declare function createAngularComponentExtension<T = unknown>(injector: Injector
  */
 declare function registerAngularComponent<T = unknown>(injectorOrOptions: Injector | RegisterAngularComponentOptions<T>, maybeOptions?: RegisterAngularComponentOptions<T>): Node$2;
 
-export { ATE_BUBBLE_MENU_KEYS, ATE_CELL_BUBBLE_MENU_KEYS, ATE_DEFAULT_BUBBLE_MENU_CONFIG, ATE_DEFAULT_CELL_MENU_CONFIG, ATE_DEFAULT_CONFIG, ATE_DEFAULT_IMAGE_BUBBLE_MENU_CONFIG, ATE_DEFAULT_SLASH_COMMANDS_CONFIG, ATE_DEFAULT_TABLE_MENU_CONFIG, ATE_DEFAULT_TOOLBAR_CONFIG, ATE_GLOBAL_CONFIG, ATE_IMAGE_BUBBLE_MENU_KEYS, ATE_INITIAL_EDITOR_STATE, ATE_SLASH_COMMAND_KEYS, ATE_TABLE_BUBBLE_MENU_KEYS, ATE_TOOLBAR_KEYS, AngularTiptapEditorComponent, AteAngularNodeView, AteColorPickerService, AteDiscoveryCalculator, AteEditorCommandsService, AteI18nService, AteImageCalculator, AteImageService, AteLinkService, AteMarksCalculator, AteNodeViewRenderer, AteNoopValueAccessorDirective, AteSelectionCalculator, AteStructureCalculator, AteTableCalculator, createAngularComponentExtension, createDefaultSlashCommands, filterSlashCommands, provideAteEditor, registerAngularComponent };
+export { ATE_BUBBLE_MENU_KEYS, ATE_CELL_BUBBLE_MENU_KEYS, ATE_DEFAULT_BUBBLE_MENU_CONFIG, ATE_DEFAULT_CELL_MENU_CONFIG, ATE_DEFAULT_CONFIG, ATE_DEFAULT_IMAGE_BUBBLE_MENU_CONFIG, ATE_DEFAULT_IMAGE_UPLOAD_CONFIG, ATE_DEFAULT_SLASH_COMMANDS_CONFIG, ATE_DEFAULT_TABLE_MENU_CONFIG, ATE_DEFAULT_TOOLBAR_CONFIG, ATE_GLOBAL_CONFIG, ATE_IMAGE_BUBBLE_MENU_KEYS, ATE_INITIAL_EDITOR_STATE, ATE_SLASH_COMMAND_KEYS, ATE_TABLE_BUBBLE_MENU_KEYS, ATE_TOOLBAR_KEYS, AngularTiptapEditorComponent, AteAngularNodeView, AteColorPickerService, AteDiscoveryCalculator, AteEditorCommandsService, AteI18nService, AteImageCalculator, AteImageService, AteLinkService, AteMarksCalculator, AteNodeViewRenderer, AteNoopValueAccessorDirective, AteSelectionCalculator, AteStructureCalculator, AteTableCalculator, AteTooltipDirective, createAngularComponentExtension, createDefaultSlashCommands, filterSlashCommands, provideAteEditor, registerAngularComponent };
 export type { AteAngularNode, AteBubbleMenuConfig, AteBubbleMenuKey, AteCellBubbleMenuConfig, AteCellBubbleMenuKey, AteColorEditMode, AteColorPickerSelection, AteComponentRenderOptions, AteCustomBubbleMenuItem, AteCustomSlashCommands, AteCustomToolbarItem, AteEditorConfig, AteEditorStateSnapshot, AteImageBubbleMenuConfig, AteImageBubbleMenuKey, AteImageData, AteImageUploadConfig, AteImageUploadContext, AteImageUploadHandler, AteImageUploadHandlerResult, AteImageUploadOptions, AteImageUploadResult, AteResizeOptions, AteSlashCommandItem, AteSlashCommandKey, AteSlashCommandsConfig, AteStateCalculator, AteTableBubbleMenuConfig, AteTableBubbleMenuKey, AteToolbarConfig, AteToolbarKey, AteTranslations, RegisterAngularComponentOptions, SupportedLocale };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flogeez/angular-tiptap-editor",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "A modern, customizable rich-text editor for Angular (18+), built with Tiptap and featuring complete internationalization support",
   "keywords": [
     "angular",

package/src/lib/styles/ate-bubble-menu.global.css

@@ -1,44 +1,41 @@
-/* Styles globaux pour les menus contextuels Tiptap */
-.tippy-box {
-  /* Par défaut Tippy limite à 350px */
+/* Global styles for Tiptap bubble menus & Slash menu */
+.tippy-box[data-theme~="ate-bubble-menu"],
+.tippy-box[data-theme~="slash-menu"] {
+  /* Default Tippy limits to 350px */
   max-width: none !important;
   background: transparent !important;
   box-shadow: none !important;
 }
 
-.tippy-content {
-  /* Le container interne ne doit pas rajouter de padding, on gère dans .bubble-menu */
-  padding: 0;
+.tippy-box[data-theme~="ate-bubble-menu"] .tippy-content,
+.tippy-box[data-theme~="slash-menu"] .tippy-content {
+  /* Internal container shouldn't add padding, we handle it in .bubble-menu or .slash-commands-menu */
+  padding: 0 !important;
 }
 
-.tippy-box .bubble-menu {
+/* Scoped bubble-menu styles - Restoring original design exactly as requested */
+.tippy-box[data-theme~="ate-bubble-menu"] .bubble-menu {
   display: flex !important;
   align-items: center;
-  gap: 6px;
+  gap: var(--ate-menu-gap, 2px);
   background: var(--ate-menu-bg, rgb(255, 255, 255)) !important;
   border: 1px solid var(--ate-menu-border, rgba(0, 0, 0, 0.1));
   border-radius: var(--ate-menu-border-radius, 12px);
-  padding: var(--ate-menu-padding, 6px);
+  padding: var(--ate-menu-padding, 4px);
   box-shadow: var(--ate-menu-shadow, 0 8px 32px rgba(0, 0, 0, 0.12));
   z-index: 1000;
   animation: slideUp 0.18s cubic-bezier(0, 0, 0.2, 1);
   white-space: nowrap;
 }
 
-/* Cache le menu intelligemment si la source (le slash) est scrollée hors vue */
-.tippy-box[data-reference-hidden] {
+/* Hidden state when reference scrolls out of view */
+.tippy-box[data-theme~="ate-bubble-menu"][data-reference-hidden],
+.tippy-box[data-theme~="slash-menu"][data-reference-hidden] {
   opacity: 0 !important;
   transition: opacity 0.18s cubic-bezier(0, 0, 0.2, 1);
   pointer-events: none !important;
 }
 
-.bubble-menu .ate-separator {
-  width: 1px;
-  height: 28px;
-  background: color-mix(in srgb, var(--ate-menu-border), transparent 50%);
-  margin: 0 4px;
-}
-
 @keyframes slideUp {
   from {
     opacity: 0;

package/src/lib/styles/ate-tooltip.global.css

@@ -0,0 +1,47 @@
+/* ate-tooltip tippy theme */
+.tippy-box[data-theme~="ate-tooltip"] {
+  background-color: var(--ate-tooltip-bg, #0f172a);
+  color: var(--ate-tooltip-color, #e2e8f0);
+  border-radius: var(--ate-sub-border-radius, 6px);
+  font-size: 12px;
+  line-height: 1.4;
+  padding: 0;
+  box-shadow: 0 2px 6px rgba(0, 0, 0, 0.3);
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  pointer-events: none;
+  transition: opacity 0.1s ease-out;
+  text-align: center;
+}
+
+.tippy-box[data-theme~="ate-tooltip"] .tippy-content {
+  padding: 4px 6px;
+}
+
+/* Multi-line support */
+.tippy-box[data-theme~="ate-tooltip"] .ate-tooltip-label {
+  display: block;
+  color: var(--ate-tooltip-color, #e2e8f0);
+}
+
+.tippy-box[data-theme~="ate-tooltip"] .ate-tooltip-shortcut {
+  display: block;
+  font-size: 10px;
+  opacity: 0.6;
+  margin-top: 2px;
+  font-family:
+    ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New",
+    monospace;
+}
+
+.tippy-box[data-theme~="ate-tooltip"] .ate-tooltip-shortcut kbd {
+  background: none;
+  border: none;
+  padding: 0;
+  color: inherit;
+  font: inherit;
+}
+
+/* Visibility state */
+.tippy-box[data-theme~="ate-tooltip"][data-state="hidden"] {
+  opacity: 0;
+}

package/src/lib/styles/index.css

@@ -1,20 +1,21 @@
 @import "./ate-bubble-menu.global.css";
+@import "./ate-tooltip.global.css";
 @import "./material-symbols.css";
 
-/* Styles pour les liens */
+/* Styles for links */
 .ate-link {
-  color: var(--ate-primary, #1d4ed8);
+  color: var(--ate-primary, #2563eb);
   text-decoration: underline;
   cursor: pointer;
   transition: color 0.2s ease;
 }
 
 .ate-link:hover {
-  color: var(--ate-primary-light-alpha, #1d4ed8);
+  color: var(--ate-primary-hover, #153ca9);
   text-decoration: underline;
 }
 
-/* Styles pour la surbrillance */
+/* Styles for highlight */
 .ate-highlight {
   background-color: var(--ate-highlight-bg, #fef08a);
   padding: 0.1em 0.2em;
@@ -22,7 +23,7 @@
   color: var(--ate-highlight-color, #854d0e);
 }
 
-/* Styles pour les alignements de texte - Tiptap utilise des classes */
+/* Styles for text alignment - Tiptap uses classes */
 .ProseMirror .has-text-align-left {
   text-align: left;
 }