@flogeez/angular-tiptap-editor 3.1.3 → 3.1.5

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

@@ -0,0 +1,82 @@
+import { Editor } from "@tiptap/core";
+import { AteResizeOptions, AteImageUploadOptions, AteImageUploadHandler, AteImageUploadResult, AteImageData } from "../models/ate-image.model";
+import * as i0 from "@angular/core";
+export declare class AteImageService {
+    /** Signals for image state */
+    selectedImage: import("@angular/core").WritableSignal<AteImageData | null>;
+    isImageSelected: import("@angular/core").Signal<boolean>;
+    /** Resizing state */
+    isResizing: import("@angular/core").WritableSignal<boolean>;
+    private i18n;
+    private readonly t;
+    /** Upload state signals */
+    isUploading: import("@angular/core").WritableSignal<boolean>;
+    uploadProgress: import("@angular/core").WritableSignal<number>;
+    uploadMessage: import("@angular/core").WritableSignal<string>;
+    /**
+     * Custom upload handler.
+     * If set, this handler replaces the default base64 conversion.
+     */
+    uploadHandler: AteImageUploadHandler | null;
+    private currentEditor;
+    /** Select and track an image from the editor */
+    selectImage(editor: Editor): void;
+    clearSelection(): void;
+    /** Insert a new image and ensure it's selected */
+    insertImage(editor: Editor, imageData: AteImageData): void;
+    /** Update attributes of the currently active image */
+    updateImageAttributes(editor: Editor, attributes: Partial<AteImageData>): void;
+    /** Resize image with optional aspect ratio maintenance */
+    resizeImage(editor: Editor, options: AteResizeOptions): void;
+    /** Predetermined resize helpers used by UI */
+    resizeImageToSmall(editor: Editor): void;
+    resizeImageToMedium(editor: Editor): void;
+    resizeImageToLarge(editor: Editor): void;
+    resizeImageToOriginal(editor: Editor): void;
+    /** Get current image dimensions */
+    getImageDimensions(editor: Editor): {
+        width: number;
+        height: number;
+    } | 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?: {
+        maxSize?: number;
+        allowedTypes?: string[];
+    }): {
+        valid: boolean;
+        error?: string;
+    };
+    /** Compress and process image on client side */
+    compressImage(file: File, quality?: number, maxWidth?: number, maxHeight?: number): Promise<AteImageUploadResult>;
+    /** Core upload logic with progress tracking */
+    private uploadImageWithProgress;
+    private resetUploadState;
+    /** Main entry point for file upload and insertion */
+    uploadAndInsertImage(editor: Editor, file: File, options?: AteImageUploadOptions): Promise<void>;
+    /** Trigger an editor transaction to force decoration update */
+    private forceEditorUpdate;
+    /** Generic helper to open file picker and process selection */
+    private selectFileAndProcess;
+    /** Select file and upload as new image */
+    selectAndUploadImage(editor: Editor, options?: AteImageUploadOptions): Promise<void>;
+    /** 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>;
+    /**
+     * Handle image drop event.
+     * Calculates the position from coordinates and sets the selection accordingly.
+     */
+    handleDrop(editor: Editor, event: DragEvent, options?: AteImageUploadOptions): boolean;
+    /**
+     * Handle image paste event.
+     */
+    handlePaste(editor: Editor, event: ClipboardEvent, options?: AteImageUploadOptions): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AteImageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AteImageService>;
+}

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

@@ -0,0 +1,42 @@
+import type { Editor } from "@tiptap/core";
+import * as i0 from "@angular/core";
+export declare class AteLinkService {
+    /** Whether link edit mode is active */
+    readonly editMode: import("@angular/core").WritableSignal<boolean>;
+    /** Reference to the element that triggered the menu (for anchoring) */
+    readonly menuTrigger: import("@angular/core").WritableSignal<HTMLElement | null>;
+    /** Whether the user is currently interacting with the link UI (input focus) */
+    readonly isInteracting: import("@angular/core").WritableSignal<boolean>;
+    /**
+     * Open the link edit menu.
+     */
+    open(trigger?: HTMLElement): void;
+    /**
+     * Close the link edit menu.
+     */
+    close(): void;
+    /**
+     * Final cleanup (called after UI is hidden)
+     */
+    done(): void;
+    /**
+     * Set interaction state
+     */
+    setInteracting(value: boolean): void;
+    /**
+     * Toggle link mode from UI.
+     * If a URL string is provided, applies the link and closes.
+     * If an Event is provided, extracts the trigger for anchoring.
+     */
+    toggle(editor: Editor, urlOrEvent?: string | Event): void;
+    /**
+     * Apply a link to the current selection.
+     */
+    setLink(editor: Editor, url: string): void;
+    /**
+     * Remove link from the current selection.
+     */
+    unsetLink(editor: Editor): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AteLinkService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AteLinkService>;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Normalizes color values (rgb/rgba to hex).
+ */
+export declare function normalizeColor(color: string | null | undefined): string | null;
+/**
+ * Calculate luminance (0-255).
+ */
+export declare function getLuminance(color: string | null | undefined): number;
+/**
+ * Returns contrast color for readability.
+ */
+export declare function getContrastColor(color: string): "black" | "white";

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

@@ -0,0 +1,4 @@
+/**
+ * HTML to Markdown converter utility (no external dependencies).
+ */
+export declare function htmlToMarkdown(html: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flogeez/angular-tiptap-editor",
-  "version": "3.1.3",
+  "version": "3.1.5",
   "description": "A modern, customizable rich-text editor for Angular (18+), built with Tiptap and featuring complete internationalization support",
   "keywords": [
     "angular",
@@ -53,6 +53,8 @@
     },
     ".": {
       "types": "./index.d.ts",
+      "esm2022": "./esm2022/flogeez-angular-tiptap-editor.mjs",
+      "esm": "./esm2022/flogeez-angular-tiptap-editor.mjs",
       "default": "./fesm2022/flogeez-angular-tiptap-editor.mjs"
     }
   }

package/public-api.d.ts

@@ -0,0 +1,32 @@
+export * from "./lib/components/editor/angular-tiptap-editor.component";
+export * from "./lib/ate-editor.provider";
+export * from "./lib/directives/ate-noop-value-accessor.directive";
+export * from "./lib/directives/ate-tooltip.directive";
+export * from "./lib/services/ate-i18n.service";
+export * from "./lib/services/ate-editor-commands.service";
+export * from "./lib/services/ate-image.service";
+export * from "./lib/services/ate-color-picker.service";
+export * from "./lib/services/ate-link.service";
+export * from "./lib/services/ate-export.service";
+export * from "./lib/models/ate-editor-state.model";
+export * from "./lib/extensions/calculators/ate-discovery.calculator";
+export * from "./lib/extensions/calculators/ate-image.calculator";
+export * from "./lib/extensions/calculators/ate-marks.calculator";
+export * from "./lib/extensions/calculators/ate-selection.calculator";
+export * from "./lib/extensions/calculators/ate-structure.calculator";
+export * from "./lib/extensions/calculators/ate-table.calculator";
+export * from "./lib/models/ate-toolbar.model";
+export * from "./lib/models/ate-image.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";
+export * from "./lib/config/ate-editor.config";
+export * from "./lib/config/ate-global-config.token";
+export * from "./lib/config/ate-slash-commands.config";
+export type { SupportedLocale } from "./lib/services/ate-i18n.service";
+export { AteAngularNodeView } from "./lib/node-view/ate-angular-node-view";
+export { AteNodeViewRenderer } from "./lib/node-view/ate-node-view.renderer";
+export { createAngularComponentExtension } from "./lib/node-view/ate-node-view.factory";
+export { registerAngularComponent } from "./lib/node-view/ate-register-angular-component";
+export type { AteAngularNode } from "./lib/models/ate-editor-config.model";
+export type { RegisterAngularComponentOptions, AteComponentRenderOptions, } from "./lib/node-view/ate-node-view.models";