texditor 2.0.0

package/dist/texditor.mjs

@@ -0,0 +1,138 @@
+import { detectMobileOS as e, executeMethodIfExists as t, getCaretPosition as n, getSelectionRect as r } from "./src/utils/common.mjs";
+import { C as i, S as a, j as o, n as s, oe as c, se as l, w as u } from "./node_modules/snappykit/dist/snappykit.mjs";
+import d from "./src/core/events.mjs";
+import { ajax as f } from "./src/utils/ajax.mjs";
+import { renderIcon as p } from "./src/utils/icon.mjs";
+import { sanitizeJson as m } from "./src/utils/sanitizer.mjs";
+import { mainStore as h } from "./src/store/mainStore.mjs";
+import g from "./src/core/block-manager.mjs";
+import _ from "./src/core/config.mjs";
+import v from "./src/core/selection-api.mjs";
+import y from "./src/core/tools.mjs";
+import b from "./src/core/i18n.mjs";
+import x from "./src/core/commands.mjs";
+import S from "./src/core/history-manager.mjs";
+import C from "./src/core/extensions.mjs";
+import w from "./src/views/main.mjs";
+/* empty css                         */
+/* empty css                           */
+//#region src/texditor.ts
+var T = class {
+	constructor(e) {
+		this.config = new _(e), this.i18n = new b(this), this.events = new d(this), this.historyManager = new S(this), this.blockManager = new g(this), this.selectionApi = new v(this), this.tools = new y(this), this.commands = new x(this), this.extensions = new C(this), this.ready();
+	}
+	ready() {
+		this.mount(), this.historyManager.save(), t(this.extensions, "__apply");
+		let e = this.config.get("onReady", !1);
+		typeof e == "function" && e(this), this.blockManager.detectEmpty(), this.blockManager.normalize(), this.events.refresh();
+	}
+	getRoot() {
+		let e = this.rootElement || null;
+		if (!e) throw Error("The root element of the editor was not found.");
+		return e;
+	}
+	getBody() {
+		let e = this.getRoot();
+		if (!e) return null;
+		let [t] = c(".tex", e);
+		return t || null;
+	}
+	isEmpty() {
+		let { blockManager: e } = this, t = e.count(), n = e.getModel(0);
+		return t === 0 ? !0 : !!(t === 1 && n && n.isEmpty());
+	}
+	setContent(e, n = 0, r = 0) {
+		let { blockManager: i, config: a, events: o } = this, c = i.getBlocksContainer(), d = {
+			type: a.get("defaultBlock", "p"),
+			data: [""]
+		}, f = [d];
+		try {
+			f = typeof e == "string" ? s(e) ? [] : JSON.parse(m(e.trim()) || "") : e;
+		} catch (e) {
+			console.warn("The input data is not supported or contains errors when working with JSON", e);
+		}
+		if (c) {
+			l(c, "");
+			let e = i.parseBlocks(f), a = n || 0;
+			if (!e.length) {
+				let t = i.parseBlock(d);
+				if (!t) throw Error("The default block model has not been found.");
+				e.push(t);
+			}
+			u(c, e), i.detectEmpty(!1), i.normalize(), e.forEach((e) => {
+				t(e.baseModel, "__onMount", [e]);
+			}), o.refresh(), n !== -1 && setTimeout(() => {
+				i.use(a), i.focus(a);
+			}, r || 0), o.change({
+				type: "setContent",
+				container: c,
+				index: a
+			});
+		}
+	}
+	getContent() {
+		return this.save();
+	}
+	save() {
+		let e = [], { blockManager: n, events: r } = this, i = this.getRoot();
+		return r.trigger("save"), i ? (n.getBlocks().forEach((i) => {
+			r.trigger("saveEach", { blockElement: i });
+			let a = i.baseModel;
+			if (a.getName()) {
+				let r = o(i, "options"), s = {
+					type: a.getName(),
+					data: [],
+					...r
+				}, c = n.getContentElement(i);
+				if (c && a) if (a.isCustomSave()) s = t(a, "__save", [s, i]);
+				else if (a.isRaw()) s.data = [c.innerText];
+				else {
+					let e = n.htmlToData(l(c));
+					if (a.isEditableItems() && a.getItemsLength()) {
+						let e = 0;
+						a.getItems().forEach(() => {
+							let t = a.getItemBody(e);
+							if (t) {
+								let e = n.htmlToData(l(t));
+								if (e.length) {
+									let t = {
+										type: a.getItemName(),
+										data: e
+									};
+									s.data.push(t);
+								}
+							}
+							e++;
+						});
+					} else s.data = e.filter((e) => typeof e == "string" || typeof e == "object" && !!e);
+				}
+				s.data.length && e.push(s);
+			}
+			r.trigger("saveEachEnd", { blockElement: i });
+		}), r.trigger("saveEnd"), e) : [];
+	}
+	destroy() {
+		let { blockManager: e, events: t, extensions: n, historyManager: r, tools: i } = this;
+		this.rootElement && l(this.rootElement, "");
+		let a = h.get("editors");
+		h.set("editors", a.filter((e) => e != this.rootElement)), e.destroy(), t.destroy(), n.destroy(), i.destroy(), r.clear();
+	}
+	mount() {
+		let { config: e } = this, t = this.config.get("handle", "texditor");
+		if (!i("#" + t)) throw Error("The editor's ID was not found.");
+		if (a("#" + t, (e) => {
+			let t = e;
+			t?.texditor && t.texditor.destroy(), u(e, w(this)), Object.defineProperty(t, "texditor", {
+				value: this,
+				writable: !0
+			}), this.rootElement = t;
+			let n = h.get("editors");
+			n.push(this.rootElement), h.set("editors", n);
+		}), this.getRoot()) {
+			let t = e.get("content", []);
+			this.setContent(t, e.get("autofocus", !0) ? 0 : -1, e.get("autofocusDelay", 10));
+		}
+	}
+};
+//#endregion
+export { f as ajax, T as default, e as detectMobileOS, t as executeMethodIfExists, n as getCaretPosition, r as getSelectionRect, p as renderIcon, m as sanitizeJson };

package/dist/types/core/base/base-model.d.ts

@@ -0,0 +1,212 @@
+import { EventManager, RenderIconContent, Texditor } from '../../../texditor';
+/**
+ * Generic model constructor interface
+ * @template T - Model interface type that extends BaseModel
+ * @template C - Model config type that extends BaseModelConfig
+ */
+export interface ModelConstructor<T extends BaseModel = BaseModel, C extends BaseModelConfig = BaseModelConfig> {
+    /**
+     * Create a new model instance
+     * @param editor - Editor instance
+     * @returns Model instance of type T
+     */
+    new (editor: Texditor): T;
+    /**
+     * Set up global configuration for the model
+     * @param config - Configuration object
+     * @returns Model constructor
+     */
+    setup?(config: Partial<C>): ModelConstructor<T, C>;
+}
+/**
+ * DOM node interface
+ * Extends HTMLElement with base model reference
+ */
+export interface BaseElement extends HTMLElement {
+    /** Reference to the base model instance */
+    baseModel: BaseModel;
+}
+/**
+ * Model configuration interface
+ * @property name - Model name identifier
+ * @property translation - Translation key for localization
+ * @property icon - Icon content for the button
+ * @property iconWidth - Icon width in pixels
+ * @property iconHeight - Icon height in pixels
+ * @property className - CSS class name for styling
+ * @property visibleTitle - Whether title is always visible
+ * @property __modelCode - Model code identifier for parent models
+ */
+export interface BaseModelConfig {
+    name: string;
+    elementTagName: string;
+    translation: string;
+    icon: RenderIconContent;
+    visibleIcon: boolean;
+    iconWidth: number;
+    iconHeight: number;
+    className: string;
+    attributeTitle: boolean;
+    visibleTitle: boolean;
+    __modelCode: string;
+    [key: string]: unknown;
+}
+/**
+ * Base model constructor type alias
+ */
+export type BaseModelConstructor = ModelConstructor<BaseModel, BaseModelConfig>;
+/**
+ * Base model behavior interface
+ * Defines all public methods for model manipulation
+ */
+export interface BaseModel<TElement extends BaseElement = BaseElement> extends EventManager {
+    /**
+     * Returns the unique identifier for this event listener instance
+     * @returns The unique event ID string used to identify and manage event listeners
+     */
+    getEventId(): string;
+    /**
+     * Get model name
+     * @returns Model name string
+     */
+    getName(): string;
+    /**
+     * Get model node tag name
+     * @returns Tag name string (default: 'div')
+     */
+    getElementTagName(): string;
+    /**
+     * Get model ID
+     * @returns Unique model identifier string
+     */
+    getId(): string;
+    /**
+     * Get model DOM node
+     * @returns Model button element
+     */
+    getElement(): TElement;
+    /**
+     * Get CSS class name
+     * @returns CSS class name string
+     */
+    getClassName(): string;
+    /**
+     * Get the immutable root CSS class name.
+     * @returns Root CSS class name string
+     */
+    getRootClassName(): string;
+    /**
+     * Get translation for localization
+     * @returns Translated string
+     */
+    getTranslation(): string;
+    /**
+     * Get icon content for the model button
+     * @returns Icon content
+     */
+    getIcon(): RenderIconContent;
+    /**
+     * Get icon width
+     * @returns Icon width in pixels
+     */
+    getIconWidth(): number;
+    /**
+     * Get icon height
+     * @returns Icon height in pixels
+     */
+    getIconHeight(): number;
+    /**
+     * Get model code identifier
+     * @returns Model code string
+     */
+    getModelCode(): string;
+    /**
+     * Check if title is always visible
+     * @returns True if title should be always visible
+     */
+    isVisibleTitle(): boolean;
+    /**
+     * Checks if the attribute title is configured to be always visible.
+     * @returns True if the 'attributeTitle' config option is enabled, false otherwise.
+     */
+    isAttributeTitle(): boolean;
+    /**
+     * Check if icon is always visible
+     * @returns True if icon should be always visible
+     */
+    isVisibleIcon(): boolean;
+    /**
+     * Check if model is active
+     * @returns True if model is active
+     */
+    isActive(): boolean;
+    /**
+     * Check if model is visible
+     * @returns True if model should be displayed
+     */
+    isVisible(): boolean;
+    /**
+     * Destroy instance and clean up resources
+     * @returns void
+     */
+    destroy(): void;
+    /**
+     * Get configuration value by key
+     * @param key - Configuration key
+     * @param defaultValue - Default value
+     * @returns Configuration value
+     */
+    getConfig(key: string, defaultValue: boolean): boolean;
+    getConfig(key: string, defaultValue: string): string;
+    getConfig(key: string, defaultValue: number): number;
+    getConfig<K extends keyof BaseModelConfig>(key: K): BaseModelConfig[K];
+    getConfig<K extends keyof BaseModelConfig>(key: K, defaultValue: BaseModelConfig[K]): BaseModelConfig[K];
+    getConfig(key: string, defaultValue: unknown): unknown;
+    /**
+     * Get option value by key
+     * @param key - Configuration key
+     * @param defaultValue - Default value (optional)
+     * @returns Configuration value or null if not found
+     */
+    getOption<T = unknown>(key: string, defaultValue?: T): T | null;
+    /**
+     * Set single option value
+     * @param key - Configuration key
+     * @param value - Value to set
+     */
+    setOption(key: string, value: unknown): void;
+    /**
+     * Set multiple options (merges with existing options)
+     * @param options - Object with options to merge
+     */
+    setOptions(options: Record<string, unknown>): void;
+    /**
+     * Get all options
+     * @returns Copy of all options
+     */
+    getOptions(): Record<string, unknown>;
+    /**
+     * Remove single option by key
+     * @param key - Configuration key to remove
+     * @returns True if option existed and was deleted, false otherwise
+     */
+    removeOption(key: string): boolean;
+    /**
+     * Clear all options (resets to empty object)
+     */
+    clearOptions(): void;
+    /**
+     * Set the value in the store
+     * @param key - Storage key
+     * @param value - Value to store
+     * @returns Current instance for chaining
+     */
+    setStore(key: string, value: unknown): this;
+    /**
+     * Get the value in the store
+     * @param key - Storage key (null for all)
+     * @returns Stored value or null
+     */
+    getStore(key: string | null): unknown;
+}
+//# sourceMappingURL=base-model.d.ts.map

package/dist/types/core/base/base-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-model.d.ts","sourceRoot":"","sources":["../../../../src/types/core/base/base-model.ts"],"names":[],"mappings":"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"}

package/dist/types/core/base/event-manager.d.ts

@@ -0,0 +1,42 @@
+import { TexditorEventBase } from '../..';
+/**
+ * Event trigger storage structure
+ * Maps event names to collections of callback functions with unique IDs
+ */
+export type EventTriggerObject = {
+    [name: string]: {
+        [id: string]: CallableFunction;
+    };
+};
+/**
+ * Interface defining the contract for event management
+ * All event managers must implement these methods
+ */
+export interface EventManager {
+    /**
+     * Adds an event listener with optional identifier
+     * @param name - Event name (can include .id suffix)
+     * @param callback - Function to call when event triggers
+     */
+    on(name: string, callback: CallableFunction): void;
+    /**
+     * Checks if an event listener exists
+     * @param name - Event name (can include .id suffix)
+     * @returns True if event exists
+     */
+    hasEvent(name: string): boolean;
+    /**
+     * Removes an event listener
+     * @param name - Event name
+     * @param id - Optional specific event ID to remove
+     * @returns True if removal was successful
+     */
+    off(name: string, id?: string): boolean;
+    /**
+     * Triggers all callbacks for an event
+     * @param name - Event name to trigger
+     * @param params - Parameters to pass to callbacks
+     */
+    trigger(name: string, params?: TexditorEventBase): void;
+}
+//# sourceMappingURL=event-manager.d.ts.map

package/dist/types/core/base/event-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-manager.d.ts","sourceRoot":"","sources":["../../../../src/types/core/base/event-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,IAAI,EAAE,MAAM,GAAG;QACd,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAAC;KAChC,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACzD"}

package/dist/types/core/base/index.d.ts

@@ -0,0 +1,3 @@
+export * from './event-manager';
+export * from './base-model';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/core/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/types/core/block-manager.d.ts

@@ -0,0 +1,223 @@
+import { BlockChildSchema, BlockCreateSchema, BlockModel, BlockModelSchema, BlockElement, BlockSchema, Toasts } from '.';
+import { VirtualSelection } from './ui/virtual-selection';
+export interface BlockManager {
+    /**
+     * Gets the Toasts service instance
+     * @returns {Toasts} The Toasts service
+     */
+    toasts(): Toasts;
+    /**
+     * Recreates the VirtualSelection instance with current options.
+     * @returns The new VirtualSelection instance, or null.
+     */
+    refreshVirtualSelection(): VirtualSelection | null;
+    /**
+     * Returns the current VirtualSelection instance if it exists
+     * @returns The new VirtualSelection instance, or null.
+     */
+    getVirtualSelection(): VirtualSelection | null;
+    /**
+     * Clear Selection UI
+     */
+    clearVirtualSelection(): void;
+    /**
+     * Destroys the current VirtualSelection instance if it exists
+     */
+    destroyVirtualSelection(): void;
+    /**
+     * Gets the container element that holds all blocks
+     * @returns The blocks container element or null if not found
+     */
+    getBlocksContainer(): HTMLElement | null;
+    /**
+     * Gets all block elements in the editor.
+     * @returns Array of block elements.
+     */
+    getBlocks(): BlockElement[];
+    /**
+     * Gets a specific block element by index
+     * @param index - Block index (defaults to current index)
+     * @returns Block element or null if not found
+     */
+    getBlock(index?: number): BlockElement | null;
+    /**
+     * Gets the content element within a block
+     * @param blockElement - Block node (defaults to current block)
+     * @returns Content element or null
+     */
+    getContentElement(blockElement?: BlockElement): HTMLElement | null;
+    /**
+     * Gets the next block node after current active block
+     * @returns Next block node or null
+     */
+    getNextBlockElement(): BlockElement | null;
+    /**
+     * Gets the previous block node before current active block
+     * @returns Previous block node or null
+     */
+    getPrevBlockElement(): BlockElement | null;
+    /**
+     * Finds parent block of a target element
+     * @param targetElement - Target element or event target
+     * @returns Parent block node or null
+     */
+    findParent(targetElement: EventTarget | BlockElement | HTMLElement): BlockElement | null;
+    /**
+     * Gets the index of a block
+     * @param el - Target node (defaults to current block)
+     * @returns Block index
+     */
+    getIndex(el?: BlockElement | HTMLElement | EventTarget): number;
+    /**
+     * Sets the active block index and updates UI
+     * @param index - Block index to set as active
+     */
+    use(index: number): void;
+    /**
+     * Gets the total number of blocks
+     * @returns Block count
+     */
+    count(): number;
+    /**
+     * Checks if a block is empty
+     * @param index - Block index (defaults to current block)
+     * @returns True if block is empty
+     */
+    isEmpty(index?: number): boolean;
+    /**
+     * Gets the block model for a specific block
+     * @param index - Block index (defaults to current block)
+     * @returns Block model or null
+     */
+    getModel(index?: number): BlockModel | null;
+    /**
+     * Sets focus to a specific block by index
+     * @param index - Block index to focus
+     * @param startPos - Starting the selection position
+     * @param endPos - End of selection position
+     * @param itemIndex - Item index
+     * @returns The focused block node or null if focus failed
+     */
+    focus(index: number, startPos?: number, endPos?: number, itemIndex?: number): BlockElement | null;
+    /**
+     * Creates a default block based on editor configuration
+     * @param index - Index of the block to create (-1 after the current block)
+     * @param options - Block Options
+     * @returns Created block node or null
+     */
+    createDefaultBlock(index?: number, options?: BlockCreateSchema): BlockElement | null;
+    /**
+     * Creates a new block of specified type
+     * @param name - Block type name
+     * @param index - Index of the block to create (-1 after the current block)
+     * @param options - Block Options
+     * @param skipEvents - If true, no events will be emitted and focus won't be automatically managed
+     * @param scrollIntoView - If true or ScrollIntoViewOptions provided, the created block will be scrolled into view. Default is true
+     * @returns Created block node or null
+     */
+    createBlock(name: string, index?: number, options?: BlockCreateSchema, skipEvents?: boolean, scrollIntoView?: boolean | ScrollIntoViewOptions): BlockElement | null;
+    /**
+     * Recreates a block at the given index using the existing data.
+     *
+     * @param index - The index of the block to rebuild
+     * @returns A new block element or null
+     */
+    rebuild(index: number): BlockElement | null;
+    /**
+     * Move block to new position
+     * @param index - Item index
+     * @param targetIndex - Target item index
+     * @param skipEvents - Skip events
+     */
+    moveBlock(index: number, targetIndex: number, skipEvents?: boolean): void;
+    /**
+     * Removes one or multiple blocks
+     * @param index - Index of the block to delete (-1 to the current block)
+     * @param skipEvents - If true, no events will be emitted and focus won't be automatically managed
+     * @returns Index of last removed block or null
+     */
+    removeBlock(index?: number | number[], skipEvents?: boolean): number | null;
+    /**
+     * Merges two blocks together
+     * @param index - Block index
+     * @param targetIndex - Target block index
+     * @param focus - The index of the focus block
+     * @param useItems - Use all the contents of the editable child elements.
+     */
+    merge(index: number, targetIndex: number, focus?: number, useItems?: boolean | false): void;
+    /**
+     * Converts a block to a different type
+     * @param block - Block to convert
+     * @param targetModel - Target block model
+     * @returns Convert status
+     */
+    convert(block: BlockElement, targetModel: BlockModel): boolean;
+    /**
+     * Updates empty state data attributes on blocks
+     * @param emptyAttr - Whether to set empty attribute
+     */
+    detectEmpty(emptyAttr?: boolean): void;
+    /**
+     * Normalizes all blocks that require normalization
+     */
+    normalize(): void;
+    /**
+     * Retrieves a list of block models based on nodes
+     * @returns List of block models
+     */
+    getModels(): BlockModel[];
+    /**
+     * Gets all registered block models
+     * @returns Array of block model structures
+     */
+    getSchemas(): BlockModelSchema[];
+    /**
+     * Gets the block model schema by supported type name
+     * @param name - Supported type name or alias
+     * @returns Block model schema, or null if not found
+     */
+    getSchema(name: string): BlockModelSchema | null;
+    /**
+     * Gets the real block type name from a related type alias
+     * @param name - Supported type name or alias
+     * @returns Real block type name, or null if not found
+     */
+    getRealName(name: string): string | null;
+    /**
+     * Converts HTML string to an array of BlockSchema objects or text strings.
+     *
+     * @param html - HTML string to parse
+     * @returns Array of BlockSchema for elements or strings for text nodes
+     */
+    htmlToData(html: string): Array<BlockSchema | string>;
+    /**
+     * Parses a block schema into a BlockElement instance
+     * @param blockSchema - Block schema object containing type and data
+     * @param skipDecode - Whether to skip decoding of child content (default: false)
+     * @returns Parsed BlockElement instance, or null if parsing failed
+     */
+    parseBlock(blockSchema: BlockSchema, skipDecode?: boolean): BlockElement | null;
+    /**
+     * Converts an array of BlockSchema objects into an array of BlockElement objects.
+     *
+     * @param data - Array of BlockSchema objects to be parsed
+     * @param skipDecode - If true, skips HTML entity decoding for text content
+     * @returns An array of parsed BlockElement objects
+     */
+    parseBlocks(data: BlockSchema[], skipDecode?: boolean): BlockElement[];
+    /**
+     * Recursively parses a BlockSchema structure and converts it into an array of DOM Nodes.
+     * For root call returns children nodes, for recursive calls returns the element itself.
+     *
+     * @param schema - The BlockSchema or BlockChildSchema object containing type, data, and optional attributes
+     * @param skipDecode - If true, skips HTML entity decoding for text content
+     * @param returnElement - Internal parameter to track if this is a recursive call
+     * @returns An array of DOM Nodes
+     */
+    parseChildren(schema: BlockSchema | BlockChildSchema, skipDecode?: boolean, returnElement?: boolean): Node[];
+    /**
+     * Cleans up event listeners
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=block-manager.d.ts.map

package/dist/types/core/block-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-manager.d.ts","sourceRoot":"","sources":["../../../src/types/core/block-manager.ts"],"names":[],"mappings":"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"}