@mdaemon/html-editor 1.0.5 → 1.0.7

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 import { Editor } from '@tiptap/core';
 import { Extension } from '@tiptap/core';
+import { Node as Node_2 } from '@tiptap/core';
+
+/** List of all supported locale codes */
+export declare const availableLocales: string[];
 
 declare type BlurCallback = () => void;
 
@@ -51,6 +55,26 @@ export declare interface ColorOption {
     label?: string;
 }
 
+/**
+ * Confab icon set — clean SVG stroke icons for the confab and confab-dark skins.
+ * All icons use viewBox="0 0 24 24", stroke="currentColor", stroke-width="2".
+ * Emoticons and charmap keep their emoji/text icons.
+ */
+export declare const CONFAB_ICONS: IconSet;
+
+/**
+ * Create a TranslateFunction for a given language code.
+ * Returns a function that looks up keys in the locale map,
+ * falling back to the key itself if not found.
+ */
+export declare function createTranslateFunction(code: string): TranslateFunction;
+
+/**
+ * Default icon set — used by oxide and oxide-dark skins.
+ * Text characters and emoji for most buttons, inline SVGs for alignment/image/code.
+ */
+export declare const DEFAULT_ICONS: IconSet;
+
 declare type DirtyCallback = (dirty: boolean) => void;
 
 /**
@@ -88,6 +112,8 @@ export declare interface EditorConfig {
     images_upload_url?: string;
     images_upload_credentials?: boolean;
     images_upload_base_path?: string;
+    images_upload_max_size?: number;
+    images_upload_headers?: Record<string, string>;
     font_family_formats?: string;
     font_size_formats?: string;
     fontName?: string;
@@ -95,10 +121,12 @@ export declare interface EditorConfig {
     directionality?: 'ltr' | 'rtl';
     language?: string;
     height?: string | number;
+    min_height?: string | number;
+    max_height?: string | number;
     auto_focus?: string;
     setFocus?: string;
-    skin?: 'oxide' | 'oxide-dark';
-    content_css?: 'default' | 'dark';
+    skin?: 'oxide' | 'oxide-dark' | 'confab' | 'confab-dark';
+    content_css?: 'default' | 'dark' | 'confab' | 'confab-dark';
     content_style?: string;
     toolbar?: string;
     toolbar_mode?: 'sliding' | 'floating' | 'wrap';
@@ -124,6 +152,8 @@ export declare interface EditorEventMap {
     change: ChangeCallback;
     focus: FocusCallback;
     blur: BlurCallback;
+    languagechange: LanguageChangeCallback;
+    templatechange: TemplateChangeCallback;
 }
 
 export declare interface EditorEvents {
@@ -185,6 +215,12 @@ declare interface FontSizeOptions {
  */
 export declare function getGetFileSrc(): (path: string) => string;
 
+/**
+ * Get the locale string map for a given language code.
+ * Falls back to English if the code is not found.
+ */
+export declare function getLocale(code: string): Record<string, string>;
+
 /**
  * Get global translation function
  */
@@ -215,9 +251,13 @@ export declare class HTMLEditor implements MDHTMLEditor {
     private customButtons;
     private eventListeners;
     private changeTimeout;
+    private imageUploadHelper;
     constructor(container: HTMLElement, config?: EditorConfig);
     private normalizeConfig;
     private createEditor;
+    private getImageUploadHelper;
+    private setupImageHandlers;
+    private handleImageFileUpload;
     private buildExtensions;
     private handleChange;
     getContent(): string;
@@ -233,6 +273,10 @@ export declare class HTMLEditor implements MDHTMLEditor {
     fire<K extends keyof EditorEventMap>(event: K, ...args: Parameters<EditorEventMap[K]>): void;
     destroy(): void;
     getTipTap(): Editor | null;
+    /**
+     * Set the UI language, updating all toolbar and dialog translations.
+     */
+    setLanguage(code: string): void;
     /**
      * Get the editor config
      */
@@ -243,6 +287,12 @@ export declare class HTMLEditor implements MDHTMLEditor {
     isBasicEditor(): boolean;
 }
 
+/**
+ * MDHTMLEditor Icon Sets
+ * Skin-specific icon registries for toolbar buttons
+ */
+export declare type IconSet = Record<string, string>;
+
 /**
  * Image upload handler
  */
@@ -263,6 +313,8 @@ export declare interface ImageUploadResult {
  */
 declare type InitCallback = (editor: MDHTMLEditor) => void;
 
+export declare type LanguageChangeCallback = (code: string) => void;
+
 export declare const LineHeight: Extension<LineHeightOptions, any>;
 
 declare interface LineHeightOptions {
@@ -290,9 +342,17 @@ export declare interface MDHTMLEditor {
     off<K extends keyof EditorEventMap>(event: K, callback: EditorEventMap[K]): void;
     fire<K extends keyof EditorEventMap>(event: K, ...args: Parameters<EditorEventMap[K]>): void;
     destroy(): void;
+    setLanguage(code: string): void;
     getTipTap(): Editor | null;
 }
 
+/**
+ * Reset the global translation function to the default identity function.
+ * This also clears the customized flag so that the next editor created
+ * will auto-apply the built-in locale based on its language config.
+ */
+export declare function resetTranslate(): void;
+
 export declare class SearchReplace {
     private options;
     private overlay;
@@ -342,6 +402,8 @@ export declare function setGetFileSrc(fn: (path: string) => string): void;
  */
 export declare function setTranslate(fn: TranslateFunction): void;
 
+export declare const SignatureBlock: Node_2<any, any>;
+
 /**
  * Template object for email templates
  */
@@ -352,6 +414,8 @@ export declare interface Template {
     content: string;
 }
 
+declare type TemplateChangeCallback = (template: Template) => void;
+
 export declare const TextDirection: Extension<TextDirectionOptions, any>;
 
 declare interface TextDirectionOptions {
@@ -367,12 +431,21 @@ export declare class Toolbar {
     private dropdowns;
     private charMap;
     private emojiPicker;
+    private imageUpload;
     private searchReplace;
     private updateInterval;
+    private boundClickHandler;
+    private boundKeydownHandler;
+    private overflowEl;
+    private toggleBtn;
     constructor(container: HTMLElement, options: ToolbarOptions);
     private get tiptap();
     private get trans();
+    private icon;
     private render;
+    private renderGroups;
+    private createToggleButton;
+    private toggleOverflow;
     private createButton;
     private createActionButton;
     private createCustomButton;
@@ -383,6 +456,7 @@ export declare class Toolbar {
     private createDropdown;
     private createColorPicker;
     private bindEvents;
+    private unbindEvents;
     private closeAllDropdowns;
     private startStateUpdates;
     private updateButtonStates;
@@ -394,6 +468,7 @@ export declare class Toolbar {
     private openSourceCode;
     private openPreview;
     private toggleFullscreen;
+    rebuild(): void;
     destroy(): void;
 }
 
@@ -423,6 +498,7 @@ declare interface ToolbarOptions {
     sticky: boolean;
     customButtons: Map<string, ToolbarButtonSpec>;
     config: EditorConfig;
+    iconSet: IconSet;
 }
 
 /**
@@ -430,6 +506,9 @@ declare interface ToolbarOptions {
  */
 export declare type TranslateFunction = (key: string) => string;
 
+/** All translation keys used by the editor */
+export declare const TRANSLATION_KEYS: string[];
+
 /**
  * UI Registry for custom buttons (TinyMCE-compatible)
  */