@flogeez/angular-tiptap-editor 3.5.4 → 3.6.0

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

@@ -55,6 +55,7 @@ export declare class AteColorBubbleMenuComponent extends AteBaseSubBubbleMenu {
     activeMode: import("@angular/core").WritableSignal<"highlight" | "text">;
     protected onStateChange(): void;
     shouldShow(): boolean;
+    private findColoredElementInContent;
     getSelectionRect(): DOMRect;
     protected onTippyShow(_instance: TippyInstance): void;
     protected onTippyHide(_instance: TippyInstance): void;

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

@@ -1,5 +1,6 @@
 import { ElementRef, OnDestroy, AfterViewInit } from "@angular/core";
 import { Editor, EditorOptions, Extension, Node, Mark, JSONContent } from "@tiptap/core";
+import { type StarterKitOptions } from "@tiptap/starter-kit";
 import { Node as PMNode } from "@tiptap/pm/model";
 import { AteCustomSlashCommands } from "../../models/ate-slash-command.model";
 import { AteI18nService } from "../../services/ate-i18n.service";
@@ -9,7 +10,7 @@ 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, AtePastedImageRejection } from "../../models/ate-image.model";
+import { AteImageUploadHandler, AteImageUploadOptions, AteImageUploadResult, AteImageRejection, AtePastedImageRejection } from "../../models/ate-image.model";
 import { SupportedLocale } from "../../i18n/ateTranslationsModel";
 import * as i0 from "@angular/core";
 import * as i1 from "../../directives/ate-noop-value-accessor.directive";
@@ -39,6 +40,7 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     maxCharacters: import("@angular/core").InputSignal<number | undefined>;
     enableOfficePaste: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
     enableSlashCommands: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    enableBlockShortcuts: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
     slashCommands: import("@angular/core").InputSignal<AteSlashCommandsConfig | undefined>;
     customSlashCommands: import("@angular/core").InputSignal<AteCustomSlashCommands | undefined>;
     blockControls: import("@angular/core").InputSignal<AteBlockControlsMode | undefined>;
@@ -51,6 +53,7 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     spellcheck: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
     tiptapExtensions: import("@angular/core").InputSignal<(Mark<any, any> | Node<any, any> | Extension<any, any>)[] | undefined>;
     tiptapOptions: import("@angular/core").InputSignal<Partial<EditorOptions> | undefined>;
+    starterKitOptions: import("@angular/core").InputSignal<Partial<StarterKitOptions> | undefined>;
     showBubbleMenu: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
     bubbleMenu: import("@angular/core").InputSignal<Partial<AteBubbleMenuConfig> | undefined>;
     showImageBubbleMenu: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
@@ -106,6 +109,8 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     }>;
     editableChange: import("@angular/core").OutputEmitterRef<boolean>;
     imageUploaded: import("@angular/core").OutputEmitterRef<AteImageUploadResult>;
+    /** Emitted when an image file is rejected (disallowed type, too large or failed upload) */
+    imageRejected: import("@angular/core").OutputEmitterRef<AteImageRejection>;
     /** Emitted when an image from pasted HTML is dropped (unreachable source or failed upload) */
     pastedImageRejected: import("@angular/core").OutputEmitterRef<AtePastedImageRejection>;
     editorElement: import("@angular/core").Signal<ElementRef<any>>;
@@ -158,12 +163,14 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     readonly finalSlashCommandsConfig: import("@angular/core").Signal<AteCustomSlashCommands>;
     readonly finalAutofocus: import("@angular/core").Signal<AteAutofocusMode | undefined>;
     readonly finalMaxCharacters: import("@angular/core").Signal<number | undefined>;
+    readonly finalEnableBlockShortcuts: import("@angular/core").Signal<boolean>;
     readonly finalBlockControls: import("@angular/core").Signal<AteBlockControlsMode>;
     readonly finalShowCharacterCount: import("@angular/core").Signal<boolean>;
     readonly finalShowWordCount: import("@angular/core").Signal<boolean>;
     readonly finalLocale: import("@angular/core").Signal<SupportedLocale>;
     readonly finalTiptapExtensions: import("@angular/core").Signal<(Mark<any, any> | Node<any, any> | Extension<any, any>)[]>;
     readonly finalTiptapOptions: import("@angular/core").Signal<Partial<EditorOptions>>;
+    readonly finalStarterKitOptions: import("@angular/core").Signal<Partial<StarterKitOptions>>;
     readonly finalStateCalculators: import("@angular/core").Signal<AteStateCalculator[]>;
     readonly finalAngularNodesConfig: import("@angular/core").Signal<AteAngularNode[]>;
     readonly finalImageUploadConfig: import("@angular/core").Signal<{
@@ -182,6 +189,7 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
     readonly editorCommandsService: AteEditorCommandsService;
     readonly editorState: import("@angular/core").Signal<import("../../models/ate-editor-state.model").AteEditorStateSnapshot>;
     private editorRegistry;
+    private readonly warnedExtensionOverrides;
     private iconRegistry;
     private _registeredId;
     readonly registeredId: import("@angular/core").Signal<string | null>;
@@ -216,6 +224,7 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
         showCellMenu?: boolean | undefined;
         downloadImage?: boolean | undefined;
         enableSlashCommands?: boolean | undefined;
+        enableBlockShortcuts?: boolean | undefined;
         maxCharacters?: number | undefined;
         blockControls?: AteBlockControlsMode | undefined;
         toolbar?: AteToolbarConfig | undefined;
@@ -230,6 +239,7 @@ export declare class AngularTiptapEditorComponent implements AfterViewInit, OnDe
         angularNodes?: AteAngularNode[] | undefined;
         tiptapExtensions?: (Mark<any, any> | Node<any, any> | Extension<any, any>)[] | undefined;
         tiptapOptions?: Partial<EditorOptions> | undefined;
+        starterKitOptions?: Partial<StarterKitOptions> | undefined;
         stateCalculators?: AteStateCalculator[] | undefined;
         customSlashCommands?: AteCustomSlashCommands | undefined;
     }>;
@@ -253,5 +263,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; }; "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; }; "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"; "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; }; "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: {}; }]>;
 }

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

@@ -28,6 +28,7 @@ export declare function createDefaultSlashCommands(i18n: AteI18nService, command
     quality?: number;
     maxWidth?: number;
     maxHeight?: number;
+    maxSize?: number;
     allowedTypes?: string[];
 }): AteSlashCommandItem[];
 /**
@@ -37,5 +38,6 @@ export declare function filterSlashCommands(config: AteSlashCommandsConfig, i18n
     quality?: number;
     maxWidth?: number;
     maxHeight?: number;
+    maxSize?: number;
     allowedTypes?: string[];
 }): AteSlashCommandItem[];

package/lib/extensions/ate-block-shortcuts.extension.d.ts

@@ -0,0 +1,32 @@
+import { Extension } from "@tiptap/core";
+import { Node as ProseMirrorNode } from "@tiptap/pm/model";
+import { EditorState, Selection, Transaction } from "@tiptap/pm/state";
+export interface AteBlockShortcutsOptions {
+    /** Whether the shortcuts are active. Evaluated on every key press, so it can change at runtime */
+    enabled: () => boolean;
+}
+export interface AteBlockAtSelection {
+    node: ProseMirrorNode;
+    /** Document position right before the block */
+    pos: number;
+    parent: ProseMirrorNode;
+    /** Index of the block among its parent's children */
+    index: number;
+}
+/**
+ * Resolves the block the shortcuts act on: a selected block node, the list or task item
+ * holding the cursor, or else the top-level block holding the cursor.
+ */
+export declare function findBlockAtSelection(selection: Selection): AteBlockAtSelection | null;
+/** Inserts a copy of the current block right after it */
+export declare function duplicateBlock(state: EditorState): Transaction | null;
+/** Swaps the current block with its previous sibling, or returns `null` at the first position */
+export declare function moveBlockUp(state: EditorState): Transaction | null;
+/** Swaps the current block with its next sibling, or returns `null` at the last position */
+export declare function moveBlockDown(state: EditorState): Transaction | null;
+/**
+ * Notion-style block shortcuts: `Mod+D` duplicates the current block, `Mod+Shift+ArrowUp` and
+ * `Mod+Shift+ArrowDown` move it one sibling up or down. Inside a list the block is the list
+ * or task item, which moves within its list. At the edges the key event is left alone.
+ */
+export declare const AteBlockShortcuts: Extension<AteBlockShortcutsOptions, any>;

package/lib/i18n/ateTranslationsModel.d.ts

@@ -1,4 +1,4 @@
-export type SupportedLocale = "en" | "fr" | "de" | (string & {});
+export type SupportedLocale = "en" | "fr" | "de" | "pt" | "es" | (string & {});
 export interface AteTranslations {
     toolbar: {
         bold: string;

package/lib/i18n/es_ateTranslations.d.ts

@@ -0,0 +1,2 @@
+import { AteTranslations } from "./ateTranslationsModel";
+export declare const SPANISH_TRANSLATIONS: AteTranslations;

package/lib/i18n/pt_ateTranslations.d.ts

@@ -0,0 +1,2 @@
+import { AteTranslations } from "./ateTranslationsModel";
+export declare const PORTUGUESE_TRANSLATIONS: AteTranslations;

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

@@ -6,6 +6,7 @@ import { AteSlashCommandsConfig } from "../config/ate-slash-commands.config";
 import { AteImageUploadConfig } from "./ate-image.model";
 import { AteTocConfig } from "./ate-toc.model";
 import { Extension, Node, Mark, EditorOptions } from "@tiptap/core";
+import type { StarterKitOptions } from "@tiptap/starter-kit";
 import { AteStateCalculator } from "./ate-editor-state.model";
 import { AteCustomSlashCommands } from "./ate-slash-command.model";
 /**
@@ -70,6 +71,11 @@ export interface AteEditorConfig {
     downloadImage?: boolean;
     /** Enable or disable slash commands (/) */
     enableSlashCommands?: boolean;
+    /**
+     * Enable the block keyboard shortcuts: `Mod+D` duplicates the current block,
+     * `Mod+Shift+ArrowUp` / `Mod+Shift+ArrowDown` move it up or down.
+     */
+    enableBlockShortcuts?: boolean;
     /** Maximum number of characters allowed */
     maxCharacters?: number;
     /**
@@ -106,6 +112,8 @@ export interface AteEditorConfig {
     tiptapExtensions?: (Extension | Node | Mark)[];
     /** Raw TipTap editor options (e.g., enableInputRules, injectCSS, etc.) */
     tiptapOptions?: Partial<EditorOptions>;
+    /** Options for Tiptap's StarterKit, merged over the library defaults (e.g. `{ undoRedo: false }` for collaboration) */
+    starterKitOptions?: Partial<StarterKitOptions>;
     /** Reactive state calculators to extend the editor's live state */
     stateCalculators?: AteStateCalculator[];
     /**

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

@@ -15,13 +15,41 @@ export interface AteImageUploadResult {
     height?: number;
     originalSize?: number;
 }
+/** Why an image failed validation: its type is not in `allowedTypes`, or it exceeds `maxSize` */
+export type AteImageValidationReason = "invalid-type" | "too-large";
+/**
+ * Thrown when an image fails validation, before compression and before `imageUploadHandler` runs.
+ * `message` is the translated, user-facing text.
+ */
+export declare class AteImageValidationError extends Error {
+    readonly reason: AteImageValidationReason;
+    constructor(reason: AteImageValidationReason, message: string);
+}
+/** Where a rejected image file came from */
+export type AteImageSource = "paste" | "drop" | "picker" | "api";
+/**
+ * Emitted when an image file cannot be inserted.
+ * - `invalid-type`: the file type is not in `allowedTypes`
+ * - `too-large`: the file exceeds `maxSize`
+ * - `upload-failed`: processing or `imageUploadHandler` failed
+ *
+ * `source` is `paste` (clipboard file), `drop`, `picker` (toolbar, slash menu, image bubble menu)
+ * or `api` (`uploadImage`).
+ */
+export interface AteImageRejection {
+    reason: AteImageValidationReason | "upload-failed";
+    file: File;
+    source: AteImageSource;
+}
 /**
  * Emitted when an image found in pasted HTML cannot be kept.
  * - `unreachable`: the page cannot load its source (e.g. `attachment:`, `file:`, `cid:`, foreign `blob:`, malformed base64)
- * - `upload-failed`: a pasted base64 image was rejected by validation or by the upload handler
+ * - `invalid-type`: a pasted base64 image has a type that is not in `allowedTypes`
+ * - `too-large`: a pasted base64 image exceeds `maxSize`
+ * - `upload-failed`: a pasted base64 image was rejected by the upload handler
  */
 export interface AtePastedImageRejection {
-    reason: "unreachable" | "upload-failed";
+    reason: "unreachable" | AteImageValidationReason | "upload-failed";
     src: string;
 }
 export interface AteResizeOptions {

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 } from "../models/ate-image.model";
+import { AteImageUploadHandler, AteImageUploadOptions, AteImageUploadResult, AteImageRejection } from "../models/ate-image.model";
 import * as i0 from "@angular/core";
 export declare class AteEditorCommandsService {
     private imageService;
@@ -20,6 +20,7 @@ export declare class AteEditorCommandsService {
     readonly uploadProgress: import("@angular/core").Signal<number>;
     readonly uploadMessage: import("@angular/core").Signal<string>;
     set onImageUploaded(callback: ((result: AteImageUploadResult) => void) | null);
+    set onImageRejected(callback: ((rejection: AteImageRejection) => void) | null);
     set uploadHandler(handler: AteImageUploadHandler | null);
     /** Update state (called by TiptapStateExtension) */
     updateState(state: AteEditorStateSnapshot): void;

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

@@ -35,7 +35,7 @@ export declare class AteI18nService {
         table: string;
         undo: string;
         redo: string;
-        clear: string; /** All loaded translations (useful for dynamic key access) */
+        clear: string;
         textColor: string;
         customColor: string;
         presets: string;
@@ -206,6 +206,8 @@ export declare class AteI18nService {
     autoDetectLocale(): void;
     getSupportedLocales(): SupportedLocale[];
     addTranslations(locale: string, translations: AteTranslations | Partial<AteTranslations>): void;
+    getTranslations(locale: SupportedLocale): AteTranslations | undefined;
+    private resolveLocale;
     private detectBrowserLanguage;
     getToolbarTitle(key: keyof AteTranslations["toolbar"]): string;
     getBubbleMenuTitle(key: keyof AteTranslations["bubbleMenu"]): string;

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

@@ -1,8 +1,9 @@
 import { Editor } from "@tiptap/core";
-import { AteResizeOptions, AteImageUploadOptions, AteImageUploadHandler, AteImageUploadResult, AteImageData } from "../models/ate-image.model";
+import { AteResizeOptions, AteImageUploadOptions, AteImageUploadHandler, AteImageUploadResult, AteImageData, AteImageRejection, AteImageSource, AteImageValidationReason } from "../models/ate-image.model";
 import * as i0 from "@angular/core";
 export declare class AteImageService {
     onImageUploadedCallback?: (result: AteImageUploadResult) => void;
+    onImageRejectedCallback?: (rejection: AteImageRejection) => void;
     /** Signals for image state */
     selectedImage: import("@angular/core").WritableSignal<AteImageData | null>;
     isImageSelected: import("@angular/core").Signal<boolean>;
@@ -51,6 +52,7 @@ export declare class AteImageService {
     }): {
         valid: boolean;
         error?: string;
+        reason?: AteImageValidationReason;
     };
     /** Compress and process image on client side */
     compressImage(file: File, quality?: number, maxWidth?: number, maxHeight?: number): Promise<AteImageUploadResult>;
@@ -65,7 +67,7 @@ export declare class AteImageService {
     rehostImage(file: File, options?: AteImageUploadOptions): Promise<string>;
     private resetUploadState;
     /** Main entry point for file upload and insertion */
-    uploadAndInsertImage(editor: Editor, file: File, options?: AteImageUploadOptions): Promise<void>;
+    uploadAndInsertImage(editor: Editor, file: File, options?: AteImageUploadOptions, source?: AteImageSource): Promise<void>;
     /** Trigger an editor transaction to force decoration update */
     private forceEditorUpdate;
     /** Generic helper to open file picker and process selection */
@@ -75,7 +77,7 @@ export declare class AteImageService {
     /** Select file and replace currently selected image */
     selectAndReplaceImage(editor: Editor, options?: AteImageUploadOptions): Promise<void>;
     /** Internal helper used by replacement logic */
-    uploadAndReplaceImage(editor: Editor, file: File, options?: AteImageUploadOptions): Promise<void>;
+    uploadAndReplaceImage(editor: Editor, file: File, options?: AteImageUploadOptions, source?: AteImageSource): Promise<void>;
     /**
      * Handle image drop event.
      * Calculates the position from coordinates and sets the selection accordingly.

package/lib/utils/ate-equality.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function shallowArrayEqual<T>(a: readonly T[], b: readonly T[]): boolean;
+export declare function shallowObjectEqual<T extends object>(a: T, b: T): boolean;

package/lib/utils/ate-extensions.utils.d.ts

@@ -0,0 +1,13 @@
+import type { Extension, Mark, Node } from "@tiptap/core";
+import type { StarterKitOptions } from "@tiptap/starter-kit";
+/**
+ * Maps the runtime `.name` of each extension bundled in `@tiptap/starter-kit`
+ * to its corresponding option key in `StarterKitOptions`.
+ */
+export declare const STARTER_KIT_NAME_TO_OPTION: Readonly<Record<string, keyof StarterKitOptions>>;
+/**
+ * Describes which parts of Angular Tiptap Editor's UI or state calculators
+ * depend on a given built-in or StarterKit extension name.
+ */
+export declare const ATE_BUILTIN_UI_DEPENDENCIES: Readonly<Record<string, string>>;
+export declare function getExtensionName(ext: Extension | Node | Mark): string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flogeez/angular-tiptap-editor",
-  "version": "3.5.4",
+  "version": "3.6.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

@@ -25,6 +25,7 @@ export * from "./lib/extensions/calculators/ate-structure.calculator";
 export * from "./lib/extensions/calculators/ate-table.calculator";
 export { AtePastedImage, classifyPastedImageSrc, dataUriToFile, sanitizePastedImages, type AtePastedImageOptions, type AtePastedImageSource, } from "./lib/extensions/ate-pasted-image.extension";
 export { AteLinkShortcut, isLinkShortcut, type AteLinkShortcutOptions, } from "./lib/extensions/ate-link-shortcut.extension";
+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-bubble-menu.model";