texditor 2.0.0

package/dist/types/texditor.d.ts

@@ -0,0 +1,66 @@
+import { BlockManager, Config, Events, SelectionAPI, Tools, I18N, Commands, HistoryManager, Extensions, BlockSchema } from '.';
+export interface TexditorRootElement extends HTMLElement {
+    texditor: Texditor;
+}
+/**
+ * Main Texditor editor interface
+ * Defines the public API and core component accessors for the editor instance
+ */
+export interface Texditor {
+    /** Editor configuration object containing settings, plugins, and behaviors */
+    config: Config;
+    /** Manages all editor blocks (creation, deletion, manipulation, ordering) */
+    blockManager: BlockManager;
+    /** Handles text selection, cursor position, and range management operations */
+    selectionApi: SelectionAPI;
+    /** Event system for editor lifecycle and user action notifications and subscriptions */
+    events: Events;
+    /** Tool management system for additional editor functionalities and UI components */
+    tools: Tools;
+    /** Internationalization system providing multi-language support and translations */
+    i18n: I18N;
+    /** Command execution system for complex editor operations and batch manipulations */
+    commands: Commands;
+    /** Undo/redo history manager for state tracking, restoration, and time travel */
+    historyManager: HistoryManager;
+    /** Extension system for third-party plugins, custom features, and external integrations */
+    extensions: Extensions;
+    /**
+     * Gets the root element of the editor
+     * @returns Root element or null if not found
+     */
+    getRoot(): TexditorRootElement | null;
+    /**
+     * Returns the main content body element inside the editor root
+     * @returns The body HTMLElement or null if not found
+     */
+    getBody(): HTMLElement | null;
+    /**
+     * Checks if the editor is empty (no content)
+     * @returns True if editor is empty
+     */
+    isEmpty(): boolean;
+    /**
+     * Gets the current editor content
+     * @returns Array of block outputs
+     */
+    getContent(): BlockSchema[];
+    /**
+     * Saves the current editor state to a serializable format
+     * @returns Array of block output objects ready for storage or transmission
+     */
+    save(): BlockSchema[] | [];
+    /**
+     * Sets the editor content
+     * @param content - JSON string or array of block schemas
+     * @param index - Optional block index to set as active (default: 0)
+     * @param focusDelay - Focus delay in milliseconds (default: 0)
+     */
+    setContent(content: string | BlockSchema[], index?: number, focusDelay?: number): void;
+    /**
+     * Completely destroys the editor instance
+     * Cleans up all resources, event listeners, and DOM elements
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=texditor.d.ts.map

package/dist/types/texditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texditor.d.ts","sourceRoot":"","sources":["../../src/types/texditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,MAAM,EACN,MAAM,EACN,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,UAAU,EACV,WAAW,EACZ,MAAM,GAAG,CAAC;AAEX,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IAEf,6EAA6E;IAC7E,YAAY,EAAE,YAAY,CAAC;IAE3B,+EAA+E;IAC/E,YAAY,EAAE,YAAY,CAAC;IAE3B,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IAEf,qFAAqF;IACrF,KAAK,EAAE,KAAK,CAAC;IAEb,oFAAoF;IACpF,IAAI,EAAE,IAAI,CAAC;IAEX,qFAAqF;IACrF,QAAQ,EAAE,QAAQ,CAAC;IAEnB,iFAAiF;IACjF,cAAc,EAAE,cAAc,CAAC;IAE/B,2FAA2F;IAC3F,UAAU,EAAE,UAAU,CAAC;IAEvB;;;OAGG;IACH,OAAO,IAAI,mBAAmB,GAAG,IAAI,CAAC;IAEtC;;;OAGG;IACH,OAAO,IAAI,WAAW,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;OAGG;IACH,UAAU,IAAI,WAAW,EAAE,CAAC;IAE5B;;;OAGG;IACH,IAAI,IAAI,WAAW,EAAE,GAAG,EAAE,CAAC;IAE3B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvF;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types/utils/ajax.d.ts

@@ -0,0 +1,31 @@
+/** HTTP method types for AJAX requests */
+export type AjaxMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/** Supported data types for request body */
+export type AjaxData = FormData | Record<string, unknown> | string;
+/** Configuration options for AJAX request */
+export interface AjaxOptions<TResponse = unknown, TData extends AjaxData = AjaxData, THeaders extends Record<string, string> = Record<string, string>> {
+    /** HTTP method (default: GET) */
+    method?: AjaxMethod;
+    /** Request body data */
+    data?: TData;
+    /** Custom HTTP headers */
+    headers?: THeaders;
+    /** Progress callback for upload tracking */
+    progress?: (percent: number, loaded: number, total: number) => void;
+    /** Success callback */
+    success?: (data: TResponse) => void;
+    /** Error callback */
+    error?: (error: Error) => void;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/** Complete AJAX configuration with URL */
+export interface AjaxConfig<TResponse = unknown, TData extends AjaxData = AjaxData, THeaders extends Record<string, string> = Record<string, string>> {
+    /** Target URL for the request */
+    url: string;
+    /** Request options */
+    options?: AjaxOptions<TResponse, TData, THeaders>;
+}
+/** Response data type alias */
+export type AjaxResponse<T = unknown> = T;
+//# sourceMappingURL=ajax.d.ts.map

package/dist/types/utils/ajax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajax.d.ts","sourceRoot":"","sources":["../../../src/types/utils/ajax.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;AAEnE,6CAA6C;AAC7C,MAAM,WAAW,WAAW,CAC1B,SAAS,GAAG,OAAO,EACnB,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACjC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEhE,iCAAiC;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,wBAAwB;IACxB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,0BAA0B;IAC1B,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,uBAAuB;IACvB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,qBAAqB;IACrB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU,CACzB,SAAS,GAAG,OAAO,EACnB,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACjC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEhE,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;CACnD;AAED,+BAA+B;AAC/B,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC"}

package/dist/types/utils/icon.d.ts

@@ -0,0 +1,10 @@
+export interface RenderIconOptions {
+    width?: number;
+    height?: number;
+    classes?: string;
+}
+export interface RenderIconObject {
+    raw?: string;
+}
+export type RenderIconContent = string | RenderIconObject;
+//# sourceMappingURL=icon.d.ts.map

package/dist/types/utils/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/types/utils/icon.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,gBAAgB,CAAC"}

package/dist/types/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ajax';
+export * from './icon';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

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

package/dist/utils/ajax.d.ts

@@ -0,0 +1,9 @@
+import { AjaxOptions, AjaxResponse, AjaxData } from '../types';
+/**
+ * Sends an AJAX request with support for FormData and plain data, including progress tracking
+ * @param url - Request URL
+ * @param options - Request configuration
+ * @returns Promise that resolves with the response data
+ */
+export declare function ajax<TResponse = unknown, TData extends AjaxData = AjaxData, THeaders extends Record<string, string> = Record<string, string>>(url: string, options?: AjaxOptions<TResponse, TData, THeaders>): Promise<AjaxResponse<TResponse>>;
+//# sourceMappingURL=ajax.d.ts.map

package/dist/utils/ajax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajax.d.ts","sourceRoot":"","sources":["../../src/utils/ajax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,IAAI,CAClB,SAAS,GAAG,OAAO,EACnB,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACjC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAM,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CA2FtG"}

package/dist/utils/common.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Detects the mobile operating system from user agent
+ * @returns Detected OS: 'android', 'ios', 'windows_phone', or 'other'
+ */
+export declare function detectMobileOS(): 'android' | 'ios' | 'windows_phone' | 'other';
+/**
+ * Gets the cursor or touch position coordinates
+ * @param event - Pointer or Touch event (optional)
+ * @returns Coordinates object with x and y, or null if not available
+ */
+export declare function getCaretPosition(event?: PointerEvent | TouchEvent): {
+    x: number;
+    y: number;
+} | null;
+/**
+ * Gets the bounding rectangle of the current text selection
+ * @returns DOMRect of the selection, or null if no selection exists
+ */
+export declare function getSelectionRect(): DOMRect | null;
+/**
+ * Executes a class method if it exists on the given instance
+ * @param instance - The class instance containing the method to execute
+ * @param methodName - The name of the method to look up and execute
+ * @param args - An array of arguments to pass to the method (default: [])
+ * @returns The return value of the executed method, or null if the method doesn't exist or is not callable
+ */
+export declare function executeMethodIfExists<T extends object, R = unknown, Args extends unknown[] = unknown[]>(instance: T, methodName: string, args?: Args): R | null;
+//# sourceMappingURL=common.d.ts.map

package/dist/utils/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/utils/common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAU9E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAanG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,mBAM/B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACrG,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,IAA4B,GACjC,CAAC,GAAG,IAAI,CAQV"}

package/dist/utils/icon.d.ts

@@ -0,0 +1,12 @@
+import { RenderIconContent, RenderIconOptions } from '../types';
+/**
+ * Renders an SVG icon as an HTML string
+ * @param content - SVG path content as string or object with raw SVG string
+ * @param options - Optional configuration for icon rendering
+ * @param options.classes - Additional CSS classes to apply to the SVG element
+ * @param options.width - Width of the icon in pixels (default: 24)
+ * @param options.height - Height of the icon in pixels (default: 24)
+ * @returns Complete SVG element HTML string or empty string if content is invalid
+ */
+export declare function renderIcon(content: RenderIconContent, options?: RenderIconOptions): string;
+//# sourceMappingURL=icon.d.ts.map

package/dist/utils/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../src/utils/icon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA2B1F"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ajax';
+export * from './common';
+export * from './icon';
+export * from './sanitizer';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

package/dist/utils/sanitizer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sanitizes JSON by removing or escaping control characters and Unicode formatting marks
+ *
+ * @param json - Input JSON as string or object
+ * @returns Sanitized JSON string or null if parsing fails
+ */
+export declare function sanitizeJson(json: string | object): string | null;
+//# sourceMappingURL=sanitizer.d.ts.map

package/dist/utils/sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CA+DjE"}

package/dist/views/extensions.d.ts

@@ -0,0 +1,3 @@
+import { Texditor } from '../types';
+export default function ExtensionsView(editor: Texditor): HTMLElement | Node;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/views/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/views/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAwC3E"}

package/dist/views/main.d.ts

@@ -0,0 +1,3 @@
+import { Texditor } from '../types';
+export default function MainView(editor: Texditor): HTMLElement;
+//# sourceMappingURL=main.d.ts.map

package/dist/views/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/views/main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAiB9D"}

package/dist/views/tools.d.ts

@@ -0,0 +1,2 @@
+export default function ToolsView(): HTMLElement;
+//# sourceMappingURL=tools.d.ts.map

package/dist/views/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/views/tools.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,SAAS,IAAI,WAAW,CAgB/C"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "texditor",
+  "version": "2.0.0",
+  "description": "Texditor is a modern, block-based text editor written in TypeScript. It has a clean architecture and an extensible design that allows users to customize the content blocks",
+  "type": "module",
+  "main": "./dist/texditor.mjs",
+  "module": "./dist/texditor.mjs",
+  "types": "./dist/texditor.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/texditor.mjs",
+      "types": "./dist/texditor.d.ts"
+    },
+    "./core/base": {
+      "import": "./dist/core/base.mjs",
+      "types": "./dist/core/base.d.ts"
+    },
+    "./core/models": {
+      "import": "./dist/core/models.mjs",
+      "types": "./dist/core/models.d.ts"
+    },
+    "./entities/actions": {
+      "import": "./dist/entities/actions.mjs",
+      "types": "./dist/entities/actions.d.ts"
+    },
+    "./entities/blocks": {
+      "import": "./dist/entities/blocks.mjs",
+      "types": "./dist/entities/blocks.d.ts"
+    },
+    "./entities/tools": {
+      "import": "./dist/entities/tools.mjs",
+      "types": "./dist/entities/tools.d.ts"
+    },
+    "./locales": {
+      "import": "./dist/locales.mjs",
+      "types": "./dist/locales.d.ts"
+    },
+    "./entities/extensions": {
+      "import": "./dist/entities/extensions.mjs",
+      "types": "./dist/entities/extensions.d.ts"
+    },
+    "./styles/*.css": {
+      "default": "./dist/styles/*.css"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "lint": "eslint . --fix",
+    "format": "prettier --write .",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.9.1",
+    "eslint": "^10.4.0",
+    "globals": "^17.6.0",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.60.0",
+    "vite": "^8.0.14",
+    "vite-plugin-dts": "^5.0.1"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "snappykit": "^1.0.11",
+    "sortum": "^1.0.6"
+  }
+}