@flogeez/angular-tiptap-editor 3.6.1 → 3.7.0

package/lib/components/bubble-menus/base/ate-base-bubble-menu.d.ts

@@ -2,14 +2,14 @@ import { ElementRef, OnDestroy, AfterViewInit } from "@angular/core";
 import { Instance as TippyInstance } from "tippy.js";
 import { Editor } from "@tiptap/core";
 import { AteEditorCommandsService } from "../../../services/ate-editor-commands.service";
-import { AteI18nService } from "../../../services/ate-i18n.service";
+import { AteEditorI18n } from "../../../services/ate-editor-i18n.service";
 import * as i0 from "@angular/core";
 /**
  * Base abstract class for all Bubble Menus (Text, Image, Table, Cell).
  * Handles common logic for Tippy.js initialization, positioning, and visibility.
  */
 export declare abstract class AteBaseBubbleMenu implements AfterViewInit, OnDestroy {
-    protected readonly i18nService: AteI18nService;
+    protected readonly i18nService: AteEditorI18n;
     protected readonly editorCommands: AteEditorCommandsService;
     editor: import("@angular/core").InputSignal<Editor>;
     menuRef: import("@angular/core").Signal<ElementRef<HTMLDivElement>>;

package/lib/components/bubble-menus/base/ate-base-sub-bubble-menu.d.ts

@@ -2,14 +2,14 @@ import { ElementRef, OnDestroy, AfterViewInit } from "@angular/core";
 import { Instance as TippyInstance } from "tippy.js";
 import { Editor } from "@tiptap/core";
 import { AteEditorCommandsService } from "../../../services/ate-editor-commands.service";
-import { AteI18nService } from "../../../services/ate-i18n.service";
+import { AteEditorI18n } from "../../../services/ate-editor-i18n.service";
 import * as i0 from "@angular/core";
 /**
  * Base abstract class for Sub-Bubble Menus (Link, Color).
  * These menus are "sub-menus" of the main bubble menu or triggered/anchored by specific UI elements.
  */
 export declare abstract class AteBaseSubBubbleMenu implements AfterViewInit, OnDestroy {
-    protected readonly i18nService: AteI18nService;
+    protected readonly i18nService: AteEditorI18n;
     protected readonly editorCommands: AteEditorCommandsService;
     editor: import("@angular/core").InputSignal<Editor>;
     menuRef: import("@angular/core").Signal<ElementRef<HTMLDivElement>>;

package/lib/components/bubble-menus/table/ate-cell-bubble-menu.component.d.ts

@@ -7,7 +7,7 @@ export declare class AteCellBubbleMenuComponent extends AteBaseBubbleMenu {
         mergeCells: boolean;
         splitCell: boolean;
     }>;
-    readonly i18n: () => import("@flogeez/angular-tiptap-editor").AteI18nService;
+    readonly i18n: () => import("../../../services/ate-editor-i18n.service").AteEditorI18n;
     shouldShow(): boolean;
     getSelectionRect(): DOMRect;
     protected executeCommand(editor: Editor, command: string, ...args: unknown[]): void;

package/lib/components/editor/angular-tiptap-editor.component.d.ts

@@ -10,7 +10,8 @@ import { AteSlashCommandsConfig } from "../../config/ate-slash-commands.config";
 import { AteToolbarConfig } from "../../models/ate-toolbar.model";
 import { AteBubbleMenuConfig } from "../../models/ate-bubble-menu.model";
 import { AteEditorConfig, AteAngularNode, AteBlockControlsMode, AteAutofocusMode } from "../../models/ate-editor-config.model";
-import { AteImageUploadHandler, AteImageUploadOptions, AteImageUploadResult, AteImageRejection, AtePastedImageRejection } from "../../models/ate-image.model";
+import { AteImageUploadHandler, AteImageSrcResolver, AteImageUploadOptions, AteImageUploadResult, AteImageRejection, AtePastedImageRejection } from "../../models/ate-image.model";
+import { AtePasteConfig } from "../../models/ate-paste.model";
 import { SupportedLocale } from "../../i18n/ateTranslationsModel";
 import * as i0 from "@angular/core";
 import * as i1 from "../../directives/ate-noop-value-accessor.directive";
@@ -68,6 +69,11 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
      */
     stateCalculators: import("@angular/core").InputSignal<AteStateCalculator[] | undefined>;
     imageUpload: import("@angular/core").InputSignal<Partial<AteImageUploadOptions> | undefined>;
+    /**
+     * What is kept from HTML pasted or dropped from other apps (`colors`, `highlights`),
+     * and an optional `transformHTML` hook. Merged over `config.paste`.
+     */
+    paste: import("@angular/core").InputSignal<AtePasteConfig | undefined>;
     /**
      * Custom handler for image uploads.
      * When provided, images will be processed through this handler instead of being converted to base64.
@@ -88,6 +94,11 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
      * ```
      */
     imageUploadHandler: import("@angular/core").InputSignal<AteImageUploadHandler | undefined>;
+    /**
+     * Maps the `src` stored in the document to the URL the editor displays and downloads.
+     * The document, `getHTML()` and exports keep the original `src`.
+     */
+    imageSrcResolver: import("@angular/core").InputSignal<AteImageSrcResolver | undefined>;
     /**
      * Optional unique identifier for the editor instance in the registry.
      * If not specified, a unique ID is automatically generated.
@@ -173,6 +184,7 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     readonly finalStarterKitOptions: import("@angular/core").Signal<Partial<StarterKitOptions>>;
     readonly finalStateCalculators: import("@angular/core").Signal<AteStateCalculator[]>;
     readonly finalAngularNodesConfig: import("@angular/core").Signal<AteAngularNode[]>;
+    readonly finalPasteConfig: import("@angular/core").Signal<AtePasteConfig>;
     readonly finalImageUploadConfig: import("@angular/core").Signal<{
         maxSize: number;
         quality?: number | undefined;
@@ -181,7 +193,9 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
         allowedTypes?: string[] | undefined;
         handler?: AteImageUploadHandler | undefined;
     }>;
+    readonly finalImageSrcResolver: import("@angular/core").Signal<AteImageSrcResolver | undefined>;
     readonly finalImageUploadHandler: import("@angular/core").Signal<AteImageUploadHandler | undefined>;
+    private readonly editorI18n;
     readonly currentTranslations: import("@angular/core").Signal<import("../../i18n/ateTranslationsModel").AteTranslations>;
     private _destroyRef;
     private ngControl;
@@ -235,7 +249,9 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
         slashCommands?: AteSlashCommandsConfig | undefined;
         tableOfContents?: import("@flogeez/angular-tiptap-editor").AteTocConfig | undefined;
         floatingToolbar?: boolean | undefined;
+        paste?: AtePasteConfig | undefined;
         imageUpload?: import("../../models/ate-image.model").AteImageUploadConfig | undefined;
+        imageSrcResolver?: AteImageSrcResolver | undefined;
         angularNodes?: AteAngularNode[] | undefined;
         tiptapExtensions?: (Mark<any, any> | Node<any, any> | Extension<any, any>)[] | undefined;
         tiptapOptions?: Partial<EditorOptions> | undefined;
@@ -263,5 +279,5 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     private setupFormControlSubscription;
     onEditorClick(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AngularTiptapEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AngularTiptapEditorComponent, "angular-tiptap-editor", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "fillContainer": { "alias": "fillContainer"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "showFooter": { "alias": "showFooter"; "required": false; "isSignal": true; }; "showCharacterCount": { "alias": "showCharacterCount"; "required": false; "isSignal": true; }; "showWordCount": { "alias": "showWordCount"; "required": false; "isSignal": true; }; "maxCharacters": { "alias": "maxCharacters"; "required": false; "isSignal": true; }; "enableOfficePaste": { "alias": "enableOfficePaste"; "required": false; "isSignal": true; }; "enableSlashCommands": { "alias": "enableSlashCommands"; "required": false; "isSignal": true; }; "enableBlockShortcuts": { "alias": "enableBlockShortcuts"; "required": false; "isSignal": true; }; "slashCommands": { "alias": "slashCommands"; "required": false; "isSignal": true; }; "customSlashCommands": { "alias": "customSlashCommands"; "required": false; "isSignal": true; }; "blockControls": { "alias": "blockControls"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "seamless": { "alias": "seamless"; "required": false; "isSignal": true; }; "floatingToolbar": { "alias": "floatingToolbar"; "required": false; "isSignal": true; }; "showEditToggle": { "alias": "showEditToggle"; "required": false; "isSignal": true; }; "spellcheck": { "alias": "spellcheck"; "required": false; "isSignal": true; }; "tiptapExtensions": { "alias": "tiptapExtensions"; "required": false; "isSignal": true; }; "tiptapOptions": { "alias": "tiptapOptions"; "required": false; "isSignal": true; }; "starterKitOptions": { "alias": "starterKitOptions"; "required": false; "isSignal": true; }; "showBubbleMenu": { "alias": "showBubbleMenu"; "required": false; "isSignal": true; }; "bubbleMenu": { "alias": "bubbleMenu"; "required": false; "isSignal": true; }; "showImageBubbleMenu": { "alias": "showImageBubbleMenu"; "required": false; "isSignal": true; }; "imageBubbleMenu": { "alias": "imageBubbleMenu"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "showTableBubbleMenu": { "alias": "showTableBubbleMenu"; "required": false; "isSignal": true; }; "tableBubbleMenu": { "alias": "tableBubbleMenu"; "required": false; "isSignal": true; }; "showCellBubbleMenu": { "alias": "showCellBubbleMenu"; "required": false; "isSignal": true; }; "cellBubbleMenu": { "alias": "cellBubbleMenu"; "required": false; "isSignal": true; }; "stateCalculators": { "alias": "stateCalculators"; "required": false; "isSignal": true; }; "imageUpload": { "alias": "imageUpload"; "required": false; "isSignal": true; }; "imageUploadHandler": { "alias": "imageUploadHandler"; "required": false; "isSignal": true; }; "editorId": { "alias": "editorId"; "required": false; "isSignal": true; }; }, { "contentChange": "contentChange"; "editorCreated": "editorCreated"; "editorUpdate": "editorUpdate"; "editorFocus": "editorFocus"; "editorBlur": "editorBlur"; "editableChange": "editableChange"; "imageUploaded": "imageUploaded"; "imageRejected": "imageRejected"; "pastedImageRejected": "pastedImageRejected"; }, never, never, true, [{ directive: typeof i1.AteNoopValueAccessorDirective; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AngularTiptapEditorComponent, "angular-tiptap-editor", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "fillContainer": { "alias": "fillContainer"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "showFooter": { "alias": "showFooter"; "required": false; "isSignal": true; }; "showCharacterCount": { "alias": "showCharacterCount"; "required": false; "isSignal": true; }; "showWordCount": { "alias": "showWordCount"; "required": false; "isSignal": true; }; "maxCharacters": { "alias": "maxCharacters"; "required": false; "isSignal": true; }; "enableOfficePaste": { "alias": "enableOfficePaste"; "required": false; "isSignal": true; }; "enableSlashCommands": { "alias": "enableSlashCommands"; "required": false; "isSignal": true; }; "enableBlockShortcuts": { "alias": "enableBlockShortcuts"; "required": false; "isSignal": true; }; "slashCommands": { "alias": "slashCommands"; "required": false; "isSignal": true; }; "customSlashCommands": { "alias": "customSlashCommands"; "required": false; "isSignal": true; }; "blockControls": { "alias": "blockControls"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "seamless": { "alias": "seamless"; "required": false; "isSignal": true; }; "floatingToolbar": { "alias": "floatingToolbar"; "required": false; "isSignal": true; }; "showEditToggle": { "alias": "showEditToggle"; "required": false; "isSignal": true; }; "spellcheck": { "alias": "spellcheck"; "required": false; "isSignal": true; }; "tiptapExtensions": { "alias": "tiptapExtensions"; "required": false; "isSignal": true; }; "tiptapOptions": { "alias": "tiptapOptions"; "required": false; "isSignal": true; }; "starterKitOptions": { "alias": "starterKitOptions"; "required": false; "isSignal": true; }; "showBubbleMenu": { "alias": "showBubbleMenu"; "required": false; "isSignal": true; }; "bubbleMenu": { "alias": "bubbleMenu"; "required": false; "isSignal": true; }; "showImageBubbleMenu": { "alias": "showImageBubbleMenu"; "required": false; "isSignal": true; }; "imageBubbleMenu": { "alias": "imageBubbleMenu"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "showTableBubbleMenu": { "alias": "showTableBubbleMenu"; "required": false; "isSignal": true; }; "tableBubbleMenu": { "alias": "tableBubbleMenu"; "required": false; "isSignal": true; }; "showCellBubbleMenu": { "alias": "showCellBubbleMenu"; "required": false; "isSignal": true; }; "cellBubbleMenu": { "alias": "cellBubbleMenu"; "required": false; "isSignal": true; }; "stateCalculators": { "alias": "stateCalculators"; "required": false; "isSignal": true; }; "imageUpload": { "alias": "imageUpload"; "required": false; "isSignal": true; }; "paste": { "alias": "paste"; "required": false; "isSignal": true; }; "imageUploadHandler": { "alias": "imageUploadHandler"; "required": false; "isSignal": true; }; "imageSrcResolver": { "alias": "imageSrcResolver"; "required": false; "isSignal": true; }; "editorId": { "alias": "editorId"; "required": false; "isSignal": true; }; }, { "contentChange": "contentChange"; "editorCreated": "editorCreated"; "editorUpdate": "editorUpdate"; "editorFocus": "editorFocus"; "editorBlur": "editorBlur"; "editableChange": "editableChange"; "imageUploaded": "imageUploaded"; "imageRejected": "imageRejected"; "pastedImageRejected": "pastedImageRejected"; }, never, never, true, [{ directive: typeof i1.AteNoopValueAccessorDirective; inputs: {}; outputs: {}; }]>;
 }

package/lib/components/editor/ate-block-controls.component.d.ts

@@ -1,13 +1,13 @@
 import { ElementRef, OnDestroy, AfterViewInit } from "@angular/core";
 import { Editor } from "@tiptap/core";
 import { Node as PMNode } from "@tiptap/pm/model";
-import { AteI18nService } from "../../services/ate-i18n.service";
+import { AteEditorI18n } from "../../services/ate-editor-i18n.service";
 import * as i0 from "@angular/core";
 /**
  * Component providing Notion-like block controls (Plus button and Drag Handle).
  */
 export declare class AteBlockControlsComponent implements AfterViewInit, OnDestroy {
-    protected readonly i18n: AteI18nService;
+    protected readonly i18n: AteEditorI18n;
     editor: import("@angular/core").InputSignal<Editor>;
     hoveredData: import("@angular/core").InputSignal<{
         node: PMNode;

package/lib/components/slash-commands/ate-slash-commands.component.d.ts

@@ -1,10 +1,10 @@
 import { ElementRef, OnDestroy, AfterViewInit } from "@angular/core";
 import { Editor } from "@tiptap/core";
-import { AteI18nService } from "../../services/ate-i18n.service";
+import { AteEditorI18n } from "../../services/ate-editor-i18n.service";
 import { AteSlashCommandItem, AteCustomSlashCommands } from "../../models/ate-slash-command.model";
 import * as i0 from "@angular/core";
 export declare class AteSlashCommandsComponent implements AfterViewInit, OnDestroy {
-    readonly i18nService: AteI18nService;
+    readonly i18nService: AteEditorI18n;
     editor: import("@angular/core").InputSignal<Editor>;
     config: import("@angular/core").InputSignal<AteCustomSlashCommands | undefined>;
     menuRef: import("@angular/core").Signal<ElementRef<HTMLDivElement>>;

package/lib/config/ate-editor.config.d.ts

@@ -8,6 +8,9 @@ export declare const ATE_DEFAULT_TABLE_MENU_CONFIG: AteTableBubbleMenuConfig;
 export declare const ATE_DEFAULT_CELL_MENU_CONFIG: AteCellBubbleMenuConfig;
 export declare const ATE_DEFAULT_IMAGE_UPLOAD_CONFIG: AteImageUploadConfig;
 import { AteEditorConfig } from "../models/ate-editor-config.model";
+import { AtePasteConfig } from "../models/ate-paste.model";
+/** Default paste settings: everything pasted from other apps is kept */
+export declare const ATE_DEFAULT_PASTE_CONFIG: AtePasteConfig;
 /**
  * Ultimate default configuration for the Angular Tiptap Editor.
  * This serves as the 'Level 4' fallback in the configuration hierarchy:

package/lib/config/ate-slash-commands.config.d.ts

@@ -24,7 +24,7 @@ export declare const ATE_DEFAULT_SLASH_COMMANDS_CONFIG: AteSlashCommandsConfig;
  * Factory pour créer les commandes natives avec leurs traductions et leur logique d'exécution.
  * Utilise les services de l'éditeur pour garantir une cohérence de comportement.
  */
-export declare function createDefaultSlashCommands(i18n: AteI18nService, commands: AteEditorCommandsService, imageOptions?: {
+export declare function createDefaultSlashCommands(i18n: Pick<AteI18nService, "slashCommands">, commands: AteEditorCommandsService, imageOptions?: {
     quality?: number;
     maxWidth?: number;
     maxHeight?: number;
@@ -34,7 +34,7 @@ export declare function createDefaultSlashCommands(i18n: AteI18nService, command
 /**
  * Filtre et assemble les commandes selon la configuration fournie.
  */
-export declare function filterSlashCommands(config: AteSlashCommandsConfig, i18n: AteI18nService, commands: AteEditorCommandsService, imageOptions?: {
+export declare function filterSlashCommands(config: AteSlashCommandsConfig, i18n: Pick<AteI18nService, "slashCommands">, commands: AteEditorCommandsService, imageOptions?: {
     quality?: number;
     maxWidth?: number;
     maxHeight?: number;

package/lib/extensions/ate-paste.extension.d.ts

@@ -0,0 +1,24 @@
+import { Extension } from "@tiptap/core";
+import { AtePasteConfig, AtePasteSource } from "../models/ate-paste.model";
+export interface AtePasteOptions {
+    /** Paste settings, read on every paste so they can change at runtime */
+    config: () => AtePasteConfig;
+}
+export interface AtePasteStorage {
+    /** Source of the paste being processed, detected before any cleanup */
+    source: AtePasteSource;
+}
+declare module "@tiptap/core" {
+    interface Storage {
+        atePaste: AtePasteStorage;
+    }
+}
+/** Detects where clipboard HTML comes from. Must run on the HTML as copied, before any cleanup */
+export declare function detectPasteSource(html: string): AtePasteSource;
+/** Removes the formats turned off in `config` (`colors`, `highlights`) from pasted HTML */
+export declare function stripPastedFormats(html: string, config: AtePasteConfig): string;
+/**
+ * Applies `AtePasteConfig` to pasted and dropped HTML, after the Office cleanup:
+ * removes the formats turned off for content from other apps, then calls `transformHTML`.
+ */
+export declare const AtePaste: Extension<AtePasteOptions, AtePasteStorage>;

package/lib/extensions/ate-resizable-image.extension.d.ts

@@ -1,10 +1,19 @@
 import { Node } from "@tiptap/core";
+import { AteImageSrcResolver } from "../models/ate-image.model";
 export interface AteResizableImageOptions {
     inline: boolean;
     allowBase64: boolean;
     HTMLAttributes: Record<string, unknown>;
+    srcResolver: () => AteImageSrcResolver | null | undefined;
+}
+export interface AteResizableImageStorage {
+    /** One callback per image node view: re-applies the resolver when it changes */
+    srcRefreshers: Set<() => void>;
 }
 declare module "@tiptap/core" {
+    interface Storage {
+        resizableImage: AteResizableImageStorage;
+    }
     interface Commands<ReturnType> {
         resizableImage: {
             setResizableImage: (options: {
@@ -24,4 +33,4 @@ declare module "@tiptap/core" {
         };
     }
 }
-export declare const AteResizableImage: Node<AteResizableImageOptions, any>;
+export declare const AteResizableImage: Node<AteResizableImageOptions, AteResizableImageStorage>;

package/lib/models/ate-editor-config.model.d.ts

@@ -3,7 +3,8 @@ import { AteToolbarConfig } from "./ate-toolbar.model";
 import { RegisterAngularComponentOptions } from "../node-view/ate-node-view.models";
 import { AteBubbleMenuConfig, AteImageBubbleMenuConfig, AteTableBubbleMenuConfig, AteCellBubbleMenuConfig } from "./ate-bubble-menu.model";
 import { AteSlashCommandsConfig } from "../config/ate-slash-commands.config";
-import { AteImageUploadConfig } from "./ate-image.model";
+import { AteImageSrcResolver, AteImageUploadConfig } from "./ate-image.model";
+import { AtePasteConfig } from "./ate-paste.model";
 import { AteTocConfig } from "./ate-toc.model";
 import { Extension, Node, Mark, EditorOptions } from "@tiptap/core";
 import type { StarterKitOptions } from "@tiptap/starter-kit";
@@ -101,8 +102,12 @@ export interface AteEditorConfig {
     tableOfContents?: AteTocConfig;
     /** If true, shows the floating toolbar on focus */
     floatingToolbar?: boolean;
+    /** What is kept from HTML pasted or dropped from other apps, and an optional `transformHTML` hook */
+    paste?: AtePasteConfig;
     /** Technical configuration for image uploads */
     imageUpload?: AteImageUploadConfig;
+    /** Maps the `src` stored in the document to the URL the editor displays and downloads (e.g. a `blob:` fetched with a token) */
+    imageSrcResolver?: AteImageSrcResolver;
     /**
      * List of Angular components to automatically register as interactive editor nodes.
      * This is the preferred way to extend the editor with custom Angular logic.

package/lib/models/ate-image.model.d.ts

@@ -139,3 +139,15 @@ export interface AteImageUploadConfig {
     /** Accepted file types (e.g., ['image/jpeg', 'image/png']) */
     allowedTypes?: string[];
 }
+/**
+ * Maps the `src` stored in the document to the URL the editor displays (and downloads).
+ * The document, `getHTML()`, `getJSON()` and exports always keep the original `src`.
+ *
+ * Use it for images that cannot be loaded by a plain `<img src>`, e.g. endpoints that need an
+ * authorization header: fetch the image and resolve to a `blob:` URL.
+ *
+ * Can return a string, a Promise or an Observable (only the first emission is used).
+ * When it throws, rejects or emits nothing, the original `src` is displayed instead.
+ * The library never revokes the URLs it returns: if you create `blob:` URLs, you own their lifetime.
+ */
+export type AteImageSrcResolver = (src: string) => string | Promise<string> | Observable<string>;

package/lib/models/ate-paste.model.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Where pasted (or dropped) HTML comes from.
+ * - `editor`: copied from an Angular Tiptap Editor (this one or another one, in any app)
+ * - `office`: copied from Microsoft Word or Excel
+ * - `external`: anything else (Google Docs, web pages, other editors such as Confluence)
+ */
+export type AtePasteSource = "editor" | "office" | "external";
+/** Context given to `AtePasteConfig.transformHTML` */
+export interface AtePasteContext {
+    /** Where the HTML comes from, detected on the clipboard HTML as copied */
+    source: AtePasteSource;
+}
+/**
+ * Controls what is kept from HTML pasted or dropped into the editor.
+ * Format keys only apply to content from other apps (`office` and `external` sources):
+ * content copied from an editor always keeps its formatting.
+ * Every key is read at paste time, so changes apply to the next paste.
+ */
+export interface AtePasteConfig {
+    /** Keep text colors from other apps (`color` styles, `<font color>`). Default: `true` */
+    colors?: boolean;
+    /** Keep highlights and background colors from other apps (`<mark>`, `background-color`). Default: `true` */
+    highlights?: boolean;
+    /**
+     * Last step before the HTML is parsed: receives the HTML (after the Office cleanup and the format keys above)
+     * and returns the HTML to insert. Called for every source, including `editor`.
+     * If it throws or does not return a string, the HTML is inserted as it was before this step.
+     *
+     * @example Drop images pasted from web pages
+     * ```typescript
+     * transformHTML: (html, { source }) =>
+     *   source === 'external' ? html.replace(/<img[^>]*>/g, '') : html
+     * ```
+     */
+    transformHTML?: (html: string, context: AtePasteContext) => string;
+}

package/lib/services/ate-editor-commands.service.d.ts

@@ -1,7 +1,7 @@
 import { Editor } from "@tiptap/core";
 import { AteExportFormat, AteExportOptions } from "./ate-export.service";
 import { AteEditorStateSnapshot } from "../models/ate-editor-state.model";
-import { AteImageUploadHandler, AteImageUploadOptions, AteImageUploadResult, AteImageRejection } from "../models/ate-image.model";
+import { AteImageUploadHandler, AteImageSrcResolver, AteImageUploadOptions, AteImageUploadResult, AteImageRejection } from "../models/ate-image.model";
 import * as i0 from "@angular/core";
 export declare class AteEditorCommandsService {
     private imageService;
@@ -22,6 +22,8 @@ export declare class AteEditorCommandsService {
     set onImageUploaded(callback: ((result: AteImageUploadResult) => void) | null);
     set onImageRejected(callback: ((rejection: AteImageRejection) => void) | null);
     set uploadHandler(handler: AteImageUploadHandler | null);
+    get srcResolver(): AteImageSrcResolver | null;
+    set srcResolver(resolver: AteImageSrcResolver | null);
     /** Update state (called by TiptapStateExtension) */
     updateState(state: AteEditorStateSnapshot): void;
     /** Signal to toggle link edit mode from UI (Toolbar) - Immediate response */

package/lib/services/ate-editor-i18n.service.d.ts

@@ -0,0 +1,208 @@
+import { AteTranslations, SupportedLocale } from "../i18n/ateTranslationsModel";
+import * as i0 from "@angular/core";
+/**
+ * Translations seen by one editor instance. The editor provides its own copy and binds its
+ * `locale` input to it; without a locale (or outside an editor) it follows the global
+ * `AteI18nService` locale. Internal: not part of the public API.
+ */
+export declare class AteEditorI18n {
+    private readonly global;
+    private readonly localeSource;
+    readonly translations: import("@angular/core").Signal<AteTranslations>;
+    readonly toolbar: import("@angular/core").Signal<{
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        code: string;
+        codeBlock: string;
+        superscript: string;
+        subscript: string;
+        highlight: string;
+        highlightPicker: string;
+        heading1: string;
+        heading2: string;
+        heading3: string;
+        bulletList: string;
+        orderedList: string;
+        blockquote: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
+        alignJustify: string;
+        link: string;
+        image: string;
+        horizontalRule: string;
+        table: string;
+        undo: string;
+        redo: string;
+        clear: string;
+        textColor: string;
+        customColor: string;
+        presets: string;
+    }>;
+    readonly bubbleMenu: import("@angular/core").Signal<{
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        code: string;
+        superscript: string;
+        subscript: string;
+        highlight: string;
+        highlightPicker: string;
+        textColor: string;
+        link: string;
+        addLink: string;
+        editLink: string;
+        removeLink: string;
+        linkUrl: string;
+        linkText: string;
+        openLink: string;
+        customColor: string;
+        presets: string;
+    }>;
+    readonly slashCommands: import("@angular/core").Signal<{
+        heading1: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        heading2: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        heading3: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        bulletList: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        orderedList: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        blockquote: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        code: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        image: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        horizontalRule: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        table: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        tableOfContents: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
+        filterPlaceholder?: string | undefined;
+    }>;
+    readonly table: import("@angular/core").Signal<{
+        addRowBefore: string;
+        addRowAfter: string;
+        deleteRow: string;
+        addColumnBefore: string;
+        addColumnAfter: string;
+        deleteColumn: string;
+        deleteTable: string;
+        toggleHeaderRow: string;
+        toggleHeaderColumn: string;
+        mergeCells: string;
+        splitCell: string;
+    }>;
+    readonly imageUpload: import("@angular/core").Signal<{
+        selectImage: string;
+        loadError: string;
+        uploadingImage: string;
+        uploadProgress: string;
+        uploadError: string;
+        uploadSuccess: string;
+        imageTooLarge: string;
+        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;
+        validating: string;
+        uploadingToServer: string;
+        replacingImage: string;
+        insertingImage: string;
+        noFileSelected: string;
+        selectionCancelled: string;
+    }>;
+    readonly editor: import("@angular/core").Signal<{
+        placeholder: string;
+        character: string;
+        characterPlural: string;
+        word: string;
+        wordPlural: string;
+        linkPrompt: string;
+        linkUrlPrompt: string;
+        confirmDelete: string;
+        toggleEdit: string;
+        viewMode: string;
+        blockAdd: string;
+        blockDrag: string;
+        tableOfContents: string;
+    }>;
+    readonly common: import("@angular/core").Signal<{
+        cancel: string;
+        confirm: string;
+        apply: string;
+        delete: string;
+        save: string;
+        close: string;
+        loading: string;
+        error: string;
+        success: string;
+    }>;
+    readonly export: import("@angular/core").Signal<{
+        export: string;
+        html: string;
+        markdown: string;
+        text: string;
+        copyHtml: string;
+        copyMarkdown: string;
+        copyText: string;
+        downloadHtml: string;
+        downloadMarkdown: string;
+        downloadText: string;
+        copiedSuccess: string;
+    }>;
+    bindLocale(source: () => SupportedLocale | undefined): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AteEditorI18n, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AteEditorI18n>;
+}

package/lib/services/ate-image.service.d.ts

@@ -1,5 +1,5 @@
 import { Editor } from "@tiptap/core";
-import { AteResizeOptions, AteImageUploadOptions, AteImageUploadHandler, AteImageUploadResult, AteImageData, AteImageRejection, AteImageSource, AteImageValidationReason } from "../models/ate-image.model";
+import { AteResizeOptions, AteImageUploadOptions, AteImageUploadHandler, AteImageSrcResolver, AteImageUploadResult, AteImageData, AteImageRejection, AteImageSource, AteImageValidationReason } from "../models/ate-image.model";
 import * as i0 from "@angular/core";
 export declare class AteImageService {
     onImageUploadedCallback?: (result: AteImageUploadResult) => void;
@@ -20,6 +20,7 @@ export declare class AteImageService {
      * If set, this handler replaces the default base64 conversion.
      */
     uploadHandler: AteImageUploadHandler | null;
+    srcResolver: AteImageSrcResolver | null;
     private currentEditor;
     /** Select and track an image from the editor */
     selectImage(editor: Editor): void;
@@ -44,6 +45,7 @@ export declare class AteImageService {
     deleteImage(editor: Editor): void;
     /** Download the current image */
     downloadImage(editor: Editor): void;
+    private downloadResolvedImage;
     private updateSelectedImage;
     /** Validate file type and size */
     validateImage(file: File, options?: {

package/lib/utils/ate-image-src-resolver.utils.d.ts

@@ -0,0 +1,2 @@
+import { AteImageSrcResolver } from "../models/ate-image.model";
+export declare function ateResolveImageSrc(resolver: AteImageSrcResolver | null | undefined, src: string): Promise<string>;

package/package.json

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

package/public-api.d.ts

@@ -28,6 +28,7 @@ export { AteLinkShortcut, isLinkShortcut, type AteLinkShortcutOptions, } from ".
 export { AteBlockShortcuts, type AteBlockShortcutsOptions, } from "./lib/extensions/ate-block-shortcuts.extension";
 export * from "./lib/models/ate-toolbar.model";
 export * from "./lib/models/ate-image.model";
+export * from "./lib/models/ate-paste.model";
 export * from "./lib/models/ate-bubble-menu.model";
 export * from "./lib/models/ate-editor-config.model";
 export * from "./lib/models/ate-slash-command.model";