@syncfusion/ej2-inputs 30.2.6 → 31.1.17

package/dist/ts/smart-textarea/caret-helper.d.ts

@@ -0,0 +1,17 @@
+export declare type CaretPosition = {
+    left: number;
+    top: number;
+    height: number;
+    pos?: number;
+    elemStyle?: CSSStyleDeclaration;
+};
+export declare class CaretPositionHelper {
+    private static properties;
+    private static createStyledDiv;
+    private static createCaretMarker;
+    private static escapeHtml;
+    static getCaretPosition(target: HTMLInputElement | HTMLTextAreaElement): CaretPosition;
+    static adjustScrollToCaretPosition(element: HTMLInputElement | HTMLTextAreaElement): void;
+    static getTextAreaPosition(element: HTMLInputElement | HTMLTextAreaElement): CaretPosition;
+    static insertCharacter(element: HTMLInputElement | HTMLTextAreaElement, text: string): void;
+}

package/dist/ts/smart-textarea/caret-helper.ts

@@ -0,0 +1,95 @@
+
+type CSSProperties = { [key: string]: string | number };
+export type CaretPosition = { left: number, top: number, height: number, pos?: number, elemStyle?: CSSStyleDeclaration };
+
+export class CaretPositionHelper {
+    private static properties: string[] = [
+        'borderBottomWidth', 'borderLeftWidth', 'borderRightWidth', 'borderTopStyle',
+        'borderRightStyle', 'borderBottomStyle', 'borderLeftStyle', 'borderTopWidth',
+        'boxSizing', 'fontFamily', 'fontSize', 'fontWeight', 'height', 'letterSpacing',
+        'lineHeight', 'marginBottom', 'marginLeft', 'marginRight', 'marginTop',
+        'outlineWidth', 'overflow', 'overflowX', 'overflowY', 'paddingBottom',
+        'paddingLeft', 'paddingRight', 'paddingTop', 'textAlign', 'textOverflow',
+        'textTransform', 'whiteSpace', 'wordBreak', 'wordWrap', 'width'
+    ];
+
+    private static createStyledDiv(target: HTMLElement, htmlContent: string): HTMLDivElement {
+        const div: HTMLDivElement = document.createElement('div');
+        const styles: CSSProperties = {
+            position: 'absolute',
+            left: -9999,
+            top: 0,
+            zIndex: -2000
+        };
+        this.properties.forEach((prop: string) => {
+            styles[`${prop}`] = getComputedStyle(target)[prop as any];
+        });
+        Object.keys(styles).forEach((key: string) => {
+            div.style[`${key}` as any] = styles[`${key}`] as any;
+        });
+        const scrollbarWidth: number = target.offsetWidth - target.clientWidth;
+        div.style.width = (target.clientWidth + scrollbarWidth) + 'px';
+        div.innerHTML = htmlContent;
+        if (target && target.parentNode) {
+            target.parentNode.insertBefore(div, target.nextSibling);
+        }
+        return div;
+    }
+
+    private static createCaretMarker(target: HTMLElement, htmlContent: string): CaretPosition {
+        const div: HTMLDivElement = this.createStyledDiv(target, htmlContent);
+        const marker: HTMLElement = div.ownerDocument.getElementById('caret-position-marker');
+        const position: CaretPosition = {
+            left: marker!.offsetLeft,
+            top: marker!.offsetTop,
+            height: marker!.offsetHeight
+        };
+        if (div && div.parentNode) {
+            div.parentNode.removeChild(div);
+        }
+        return position;
+    }
+
+    private static escapeHtml(value: string): string {
+        return value.replace(/<|>|`|"|&/g, '?').replace(/\r\n|\r|\n/g, '<br/>');
+    }
+
+    static getCaretPosition(target: HTMLInputElement | HTMLTextAreaElement): CaretPosition {
+        const position: number = target.selectionStart || 0;
+        const textBeforeCaret: string = target.value.slice(0, position);
+        const textAfterCaret: string = target.value.slice(position);
+        let content: string = `<span style="position: relative; display: inline;">${this.escapeHtml(textBeforeCaret)}</span>`;
+        content += '<span id="caret-position-marker" style="position: relative; display: inline;">|</span>';
+        content += `<span style="position: relative; display: inline;">${this.escapeHtml(textAfterCaret)}</span>`;
+        const rect: CaretPosition = this.createCaretMarker(target, content);
+        rect.pos = position;
+        return rect;
+    }
+
+    static adjustScrollToCaretPosition(element: HTMLInputElement | HTMLTextAreaElement): void {
+        const caretPosition: CaretPosition = this.getCaretPosition(element);
+        const lineHeight: number = parseFloat(window.getComputedStyle(element).lineHeight);
+        if (caretPosition.top > element.clientHeight + element.scrollTop - lineHeight) {
+            element.scrollTop = caretPosition.top - element.clientHeight + lineHeight;
+        }
+    }
+
+    static getTextAreaPosition(element: HTMLInputElement | HTMLTextAreaElement): CaretPosition {
+        const computedStyle: CSSStyleDeclaration = window.getComputedStyle(element);
+        const position: CaretPosition = this.getCaretPosition(element);
+        return {
+            top: position.top + parseFloat(computedStyle.borderTopWidth) + element.offsetTop - element.scrollTop,
+            left: position.left + parseFloat(computedStyle.borderLeftWidth) + element.offsetLeft - element.scrollLeft - 0.25,
+            height: position.height,
+            elemStyle: computedStyle
+        };
+    }
+
+    static insertCharacter(element: HTMLInputElement | HTMLTextAreaElement, text: string): void {
+        let start: number = element.selectionStart;
+        const end: number = element.selectionEnd;
+        element.value = element.value.substring(0, start) + text + element.value.substring(end);
+        start += text.length;
+        element.setSelectionRange(start, start);
+    }
+}

package/dist/ts/smart-textarea/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Smart TextArea modules
+ */
+export * from './smart-textarea';
+export * from './smart-textarea-model';

package/dist/ts/smart-textarea/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Smart TextArea modules
+ */
+export * from './smart-textarea';
+export * from './smart-textarea-model';

package/dist/ts/smart-textarea/smart-textarea-model.d.ts

@@ -0,0 +1,44 @@
+import { EventHandler, Property, createElement } from '@syncfusion/ej2-base';import { TextArea } from '../textarea/textarea';import { CaretPosition, CaretPositionHelper } from './caret-helper';
+import {SuggestionMode} from "./smart-textarea";
+import {TextAreaModel} from "../textarea/textarea-model";
+
+/**
+ * Interface for a class SmartTextArea
+ */
+export interface SmartTextAreaModel extends TextAreaModel{
+
+    /**
+     * Represents the user's role or designation, which can be used to provide role-specific suggestions or content within the smart textarea.
+     * Provide a string that describes who is typing and for what reason, optionally giving other contextual information.
+     *
+     * @default ''
+     */
+    userRole?: string;
+
+    /**
+     * Specifies a collection of phrases commonly used by the user, which can be leveraged for auto-completion and suggestions.
+     * Provide an array of string phrases commonly used by the user to enhance auto-completion and suggestions. Include preferred tone, voice, and any relevant information such as policies, URLs, or keywords for improved suggestions.
+     *
+     * @default []
+     */
+    UserPhrases?: string[];
+
+    /**
+     * Callback function to get suggestion text from server to display smart suggestion.
+     *
+     * @returns {string}
+     */
+    aiSuggestionHandler?: Function;
+
+    /**
+     * Specifies whether suggestions should appear in a popup or inline within the text area.
+     * possible values are:
+     * * `Enable` - Suggestions are always shown as a floating overlay, which can be tapped or clicked.
+     * * `Disable` - Suggestions are always shown inline and can be accepted by pressing `Tab` key.
+     * * `None` - Touch devices display suggestions as an overlay, while non-touch devices use inline suggestions.
+     *
+     * @default None
+     */
+    showSuggestionOnPopup?: SuggestionMode;
+
+}

package/dist/ts/smart-textarea/smart-textarea.d.ts

@@ -0,0 +1,80 @@
+/// <reference path="../textarea/textarea-model.d.ts" />
+import { TextArea } from '../textarea/textarea';
+import { SmartTextAreaModel } from './smart-textarea-model';
+export interface ChatParameters {
+    messages: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    stopSequences: string[];
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+}
+export declare enum ChatMessageRole {
+    System = "system",
+    User = "user",
+    Assistant = "assistant"
+}
+export interface ChatMessage {
+    role: ChatMessageRole;
+    content: string;
+}
+export declare type SuggestionMode = 'Enable' | 'Disable' | 'None';
+export declare class SmartTextArea extends TextArea {
+    private pendingSuggestionAbort;
+    /**
+     * Represents the user's role or designation, which can be used to provide role-specific suggestions or content within the smart textarea.
+     * Provide a string that describes who is typing and for what reason, optionally giving other contextual information.
+     *
+     * @default ''
+     */
+    userRole: string;
+    /**
+     * Specifies a collection of phrases commonly used by the user, which can be leveraged for auto-completion and suggestions.
+     * Provide an array of string phrases commonly used by the user to enhance auto-completion and suggestions. Include preferred tone, voice, and any relevant information such as policies, URLs, or keywords for improved suggestions.
+     *
+     * @default []
+     */
+    UserPhrases: string[];
+    /**
+     * Callback function to get suggestion text from server to display smart suggestion.
+     *
+     * @returns {string}
+     */
+    aiSuggestionHandler: Function;
+    /**
+     * Specifies whether suggestions should appear in a popup or inline within the text area.
+     * possible values are:
+     * * `Enable` - Suggestions are always shown as a floating overlay, which can be tapped or clicked.
+     * * `Disable` - Suggestions are always shown inline and can be accepted by pressing `Tab` key.
+     * * `None` - Touch devices display suggestions as an overlay, while non-touch devices use inline suggestions.
+     *
+     * @default None
+     */
+    showSuggestionOnPopup: SuggestionMode;
+    /**
+     * Constructor for creating the widget
+     *
+     * @private
+     * @param {SmartTextArea} options - Specifies Smart text area model
+     * @param {string | HTMLTextAreaElement} element - Specifies target element
+     */
+    constructor(options?: SmartTextAreaModel, element?: string | HTMLTextAreaElement);
+    private textArea;
+    private suggestionDisplay;
+    private typingDebounceTimeout;
+    render(): void;
+    protected wireEvents(): void;
+    protected unWireEvents(): void;
+    protected keydownHandler(): void;
+    private shouldShowInlineSuggestions;
+    private handleKeyDown;
+    private handleKeyUp;
+    private handleTypingPaused;
+    private removeExistingOrPendingSuggestion;
+    private createSuggestionPrompt;
+    private requestSuggestionAsync;
+    private validateSuggestion;
+    private indexOfAny;
+    getModuleName(): string;
+    destroy(): void;
+}