@next2d/text 1.14.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Next2D
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+@next2d/text
+=============
+
+## Installation
+
+```
+npm install @next2d/text
+```
+
+## License
+This project is licensed under the [MIT License](https://opensource.org/licenses/MIT) - see the [LICENSE](LICENSE) file for details.

package/dist/TextField.d.ts

@@ -0,0 +1,635 @@
+import { TextFormat } from "./TextFormat";
+import { InteractiveObject } from "@next2d/display";
+import { BoundsImpl, TextFieldTypeImpl, TextFormatVerticalAlignImpl, TextFieldAutoSizeImpl, ParentImpl, TextDataImpl, DictionaryTagImpl, TextCharacterImpl, PlayerHitObjectImpl, Character } from "@next2d/interface";
+import { CanvasToWebGLContext } from "@next2d/webgl";
+/**
+ * TextField クラスは、テキストの表示と入力用の表示オブジェクトを作成するために使用されます。
+ * プロパティインスペクターを使用して、テキストフィールドにインスタンス名を付けることができます。
+ * また、TextField クラスのメソッドとプロパティを使用して、JavaScript でテキストフィールドを操作できます。
+ *
+ * The TextField class is used to create display objects for text display and input.
+ * You can give a text field an instance name in the Property inspector
+ * and use the methods and properties of the TextField class to manipulate it with JavaScript.
+ *
+ * @class
+ * @memberOf next2d.text
+ * @extends  InteractiveObject
+ */
+export declare class TextField extends InteractiveObject {
+    private readonly _$bounds;
+    private readonly _$originBounds;
+    private readonly _$textData;
+    private readonly _$widthTable;
+    private readonly _$heightTable;
+    private readonly _$textFormatTable;
+    private readonly _$objectTable;
+    private readonly _$imageData;
+    private readonly _$textHeightTable;
+    private readonly _$heightCache;
+    private _$background;
+    private _$backgroundColor;
+    private _$border;
+    private _$borderColor;
+    private _$htmlText;
+    private _$multiline;
+    private _$text;
+    private _$wordWrap;
+    private _$scrollH;
+    private _$scrollV;
+    private _$maxScrollV;
+    private _$maxScrollH;
+    private _$maxChars;
+    private _$defaultTextFormat;
+    private _$rawHtmlText;
+    private _$restrict;
+    private _$isHTML;
+    private _$textHeight;
+    private _$textWidth;
+    private _$textarea;
+    private _$autoSize;
+    private _$autoFontSize;
+    private _$textAreaActive;
+    private _$totalWidth;
+    private _$scrollEnabled;
+    private _$scrollSprite;
+    private _$type;
+    private _$focus;
+    private _$isComposing;
+    private _$thickness;
+    private _$thicknessColor;
+    private _$verticalAlign;
+    private _$createdTextData;
+    /**
+     * @constructor
+     * @public
+     */
+    constructor();
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class TextField]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.text.TextField
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object TextField]
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.text.TextField
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description テキストサイズの自動的な拡大 / 縮小および整列を制御します。
+     *              Controls automatic sizing and alignment of text size.
+     *
+     * @member {boolean}
+     * @default false
+     * @public
+     */
+    get autoFontSize(): boolean;
+    set autoFontSize(auto_font_size: boolean);
+    /**
+     * @description テキストフィールドの自動的な拡大 / 縮小および整列を制御します。
+     *              Controls automatic sizing and alignment of text fields.
+     *
+     * @member {string}
+     * @default TextFieldAutoSize.NONE
+     * @public
+     */
+    get autoSize(): TextFieldAutoSizeImpl;
+    set autoSize(auto_size: TextFieldAutoSizeImpl);
+    /**
+     * @description テキストフィールドに背景の塗りつぶしがあるかどうかを指定します。
+     *              Specifies whether the text field has a background fill.
+     *
+     * @member {boolean}
+     * @default false
+     * @public
+     */
+    get background(): boolean;
+    set background(background: boolean);
+    /**
+     * @description テキストフィールドの背景の色です。
+     *              The color of the text field background.
+     *
+     * @member {number}
+     * @default 0xffffff
+     * @public
+     */
+    get backgroundColor(): number;
+    set backgroundColor(background_color: string | number);
+    /**
+     * @description テキストフィールドに境界線があるかどうかを指定します。
+     *              Specifies whether the text field has a border.
+     *
+     * @member {boolean}
+     * @default false
+     * @public
+     */
+    get border(): boolean;
+    set border(border: boolean);
+    /**
+     * @description テキストフィールドの境界線の色です。
+     *              The color of the text field border.
+     *
+     * @member {number}
+     * @default 0x000000
+     * @public
+     */
+    get borderColor(): number;
+    set borderColor(border_color: string | number);
+    /**
+     * @description テキストに適用するフォーマットを指定します。
+     *              Specifies the formatting to be applied to the text.
+     *
+     * @member {TextFormat}
+     * @public
+     */
+    get defaultTextFormat(): TextFormat;
+    set defaultTextFormat(text_format: TextFormat);
+    /**
+     * @description このオブジェクトでマウスまたはその他のユーザー入力メッセージを
+     *
+     * @member {boolean}
+     * @default false
+     * @public
+     */
+    get focus(): boolean;
+    set focus(focus: boolean);
+    /**
+     * @description テキストフィールドの内容を HTML で表します。
+     *              Contains the HTML representation of the text field contents.
+     *
+     * @member {string}
+     * @default ""
+     * @public
+     */
+    get htmlText(): string;
+    set htmlText(html_text: string);
+    /**
+     * @description テキストフィールド内の文字数です。
+     *              The int of characters in a text field.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get length(): number;
+    /**
+     * @description ユーザーが入力するときに、テキストフィールドに入力できる最大の文字数です。
+     *              The maximum number of characters that the text field can contain,
+     *              as entered by a user.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get maxChars(): number;
+    set maxChars(max_chars: number);
+    /**
+     * TODO
+     * @description scrollH の最大値です。
+     *              The maximum value of scrollH.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get maxScrollH(): number;
+    /**
+     * @description scrollV の最大値です。
+     *              The maximum value of scrollV.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get maxScrollV(): number;
+    /**
+     * @description フィールドが複数行テキストフィールドであるかどうかを示します。
+     *              Indicates whether field is a multiline text field.
+     *
+     * @member {boolean}
+     * @default false
+     * @public
+     */
+    get multiline(): boolean;
+    set multiline(multiline: boolean);
+    /**
+     * @description フィールドが複数行テキストフィールドであるかどうかを示します。
+     *              Indicates whether field is a multiline text field.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get numLines(): number;
+    /**
+     * @description ユーザーがテキストフィールドに入力できる文字のセットを指定します。
+     *              Indicates the set of characters that a user can enter into the text field.
+     *
+     * @member {string}
+     * @default null
+     * @public
+     */
+    get restrict(): string;
+    set restrict(restrict: string);
+    /**
+     * @description スクロール機能のON/OFFの制御。
+     *              Control ON/OFF of the scroll function.
+     *
+     * @member {boolean}
+     * @default true
+     * @public
+     */
+    get scrollEnabled(): boolean;
+    set scrollEnabled(scroll_enabled: boolean);
+    /**
+     * TODO
+     * @description 現在の水平スクロール位置です。
+     *              The current horizontal scrolling position.
+     *
+     * @member {number}
+     * @public
+     */
+    get scrollH(): number;
+    set scrollH(scroll_h: number);
+    /**
+     * @description テキストフィールドのテキストの垂直位置です。
+     *              The vertical position of text in a text field.
+     *
+     * @member {number}
+     * @public
+     */
+    get scrollV(): number;
+    set scrollV(scroll_v: number);
+    /**
+     * @description テキストフィールド内の現在のテキストであるストリングです。
+     *              A string that is the current text in the text field.
+     *
+     * @member {string}
+     * @default ""
+     * @public
+     */
+    get text(): string;
+    set text(text: string | null);
+    /**
+     * @description テキストフィールドのテキストの色です（16 進数形式）。
+     *              The color of the text in a text field, in hexadecimal format.
+     *
+     * @member {number}
+     * @public
+     */
+    get textColor(): number;
+    set textColor(text_color: number);
+    /**
+     * @description テキストの高さです（ピクセル単位）。
+     *              The height of the text in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get textHeight(): number;
+    /**
+     * @description テキストの幅です（ピクセル単位）。
+     *              The width of the text in pixels.
+     *
+     * @member {number}
+     * @readonly
+     * @public
+     */
+    get textWidth(): number;
+    /**
+     * @description 輪郭のテキスト幅です。0(デフォルト値)で無効にできます。
+     *              The text width of the outline, which can be disabled with 0 (the default value).
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get thickness(): number;
+    set thickness(thickness: number);
+    /**
+     * @description 輪郭のテキストの色です（16 進数形式）。
+     *              The color of the outline text. (Hexadecimal format)
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get thicknessColor(): number;
+    set thicknessColor(thickness_color: number);
+    /**
+     * @description テキストフィールドのタイプです。
+     *              The type of the text field.
+     *
+     * @member {string}
+     * @default TextFieldType.STATIC
+     * @public
+     */
+    get type(): TextFieldTypeImpl;
+    set type(type: TextFieldTypeImpl);
+    /**
+     * @description 縦方向の揃え位置を指定するプロパティです。
+     *              This property specifies the vertical alignment position.
+     *
+     * @member {string}
+     * @default TextFormatVerticalAlign.TOP
+     * @public
+     */
+    get verticalAlign(): TextFormatVerticalAlignImpl;
+    set verticalAlign(vertical_align: TextFormatVerticalAlignImpl);
+    /**
+     * @description テキストフィールドのテキストを折り返すかどうかを示すブール値です。
+     *              A Boolean value that indicates whether the text field has word wrap.
+     *
+     * @member {boolean}
+     * @default false
+     * @public
+     */
+    get wordWrap(): boolean;
+    set wordWrap(word_wrap: boolean);
+    /**
+     * @description 表示オブジェクトの幅を示します（ピクセル単位）。
+     *              Indicates the width of the display object, in pixels.
+     *
+     * @member {number}
+     * @public
+     */
+    get width(): number;
+    set width(width: number);
+    /**
+     * @description 表示オブジェクトの高さを示します（ピクセル単位）。
+     *              Indicates the height of the display object, in pixels.
+     *
+     * @member {number}
+     * @public
+     */
+    get height(): number;
+    set height(height: number);
+    /**
+     * @description 親 DisplayObjectContainer のローカル座標を基準にした
+     *              DisplayObject インスタンスの x 座標を示します。
+     *              Indicates the x coordinate
+     *              of the DisplayObject instance relative to the local coordinates
+     *              of the parent DisplayObjectContainer.
+     *
+     * @member {number}
+     * @public
+     */
+    get x(): number;
+    set x(x: number);
+    /**
+     * @description 親 DisplayObjectContainer のローカル座標を基準にした
+     *              DisplayObject インスタンスの y 座標を示します。
+     *              Indicates the y coordinate
+     *              of the DisplayObject instance relative to the local coordinates
+     *              of the parent DisplayObjectContainer.
+     *
+     * @member {number}
+     * @public
+     */
+    get y(): number;
+    set y(y: number);
+    /**
+     * @description newText パラメーターで指定されたストリングを、
+     *              テキストフィールドのテキストの最後に付加します。
+     *              Appends the string specified by the newText parameter
+     *              to the end of the text of the text field.
+     *
+     * @param  {string} new_text
+     * @return void
+     * @method
+     * @public
+     */
+    appendText(new_text: string): void;
+    /**
+     * @description beginIndex パラメーターと endIndex パラメーターで指定された範囲の
+     *              テキストのフォーマット情報を含む TextFormat オブジェクトを返します。
+     *              Returns a TextFormat object that contains formatting information
+     *              for the range of text that the beginIndex and endIndex parameters specify.
+     *
+     * @param  {int} [begin_index=-1]
+     * @param  {int} [end_index=-1]
+     * @return {TextFormat}
+     * @method
+     * @public
+     */
+    getTextFormat(begin_index?: number, end_index?: number): TextFormat;
+    /**
+     * @description lineIndex パラメーターで指定された行のテキストを返します。
+     *              Returns the text of the line specified by the lineIndex parameter.
+     *
+     * @param  {number} line_index
+     * @return {string}
+     * @public
+     */
+    getLineText(line_index: number): string;
+    /**
+     * @description beginIndex パラメーターと endIndex パラメーターで指定された文字範囲を、
+     *              newText パラメーターの内容に置き換えます。
+     *              Replaces the range of characters that the beginIndex
+     *              and endIndex parameters specify with the contents of the newText parameter.
+     *
+     * @param  {number} begin_index
+     * @param  {number} end_index
+     * @param  {string} new_text
+     * @return {void}
+     * @method
+     * @public
+     */
+    replaceText(begin_index: number, end_index: number, new_text: string): void;
+    /**
+     * @description format パラメーターで指定したテキストフォーマットを、
+     *              テキストフィールド内の指定されたテキストに適用します。
+     *              Applies the text formatting that the format parameter specifies
+     *              to the specified text in a text field.
+     *
+     * @param  {TextFormat} text_format
+     * @param  {number}     [begin_index=-1]
+     * @param  {number}     [end_index=-1]
+     * @return {void}
+     * @method
+     * @public
+     */
+    setTextFormat(text_format: TextFormat, begin_index?: number, end_index?: number): void;
+    /**
+     * @return {array}
+     * @method
+     * @private
+     */
+    _$getTextData(): TextDataImpl<any>[];
+    /**
+     * @param  {Element}    tag
+     * @param  {TextFormat} text_format
+     * @param  {number}     tf_copy_offset
+     * @return {void}
+     * @private
+     */
+    _$parseTag(tag: HTMLElement, text_format: TextFormat, tf_copy_offset: number): void;
+    /**
+     * @param   {string} text
+     * @param   {TextFormat} text_format
+     * @param   {number} tf_copy_offset
+     * @returns {number}
+     * @method
+     * @private
+     */
+    _$parseText(text: string, text_format: TextFormat, tf_copy_offset: number): number;
+    /**
+     * @param  {TextFormat} text_format
+     * @return {number}
+     * @private
+     */
+    _$getTextHeight(text_format: TextFormat): number;
+    /**
+     * @return {number}
+     * @private
+     */
+    _$getImageOffsetX(): number;
+    /**
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$reset(): void;
+    /**
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$reload(): void;
+    /**
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$resize(): void;
+    /**
+     * @param  {object} obj
+     * @param  {number} width
+     * @return {number}
+     * @private
+     */
+    _$getAlignOffset(obj: TextDataImpl<any>, width: number): number;
+    /**
+     * @param   {Float32Array} [matrix=null]
+     * @returns {object}
+     * @method
+     * @private
+     */
+    _$getBounds(matrix?: Float32Array | null): BoundsImpl;
+    /**
+     * @param  {object} character
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$buildCharacter(character: Character<TextCharacterImpl>): void;
+    /**
+     * @param  {object} character
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$sync(character: TextCharacterImpl): void;
+    /**
+     * @param  {object} tag
+     * @param  {DisplayObjectContainer} parent
+     * @return {object}
+     * @method
+     * @private
+     */
+    _$build(tag: DictionaryTagImpl, parent: ParentImpl<any>): TextCharacterImpl;
+    /**
+     * @param   {CanvasToWebGLContext} context
+     * @param   {Float32Array} matrix
+     * @returns {void}
+     * @method
+     * @private
+     */
+    _$clip(context: CanvasToWebGLContext, matrix: Float32Array): void;
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @param  {Float32Array} matrix
+     * @param  {Float32Array} color_transform
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$draw(context: CanvasToWebGLContext, matrix: Float32Array, color_transform: Float32Array): void;
+    /**
+     * @param  {CanvasRenderingContext2D} context
+     * @param  {Float32Array} matrix
+     * @param  {Float32Array} color_transform
+     * @param  {number} width
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$doDraw(context: CanvasRenderingContext2D, matrix: Float32Array, color_transform: Float32Array, width: number): void;
+    /**
+     * @param  {CanvasRenderingContext2D} context
+     * @param  {Float32Array} matrix
+     * @param  {object}  options
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$mouseHit(context: CanvasRenderingContext2D, matrix: Float32Array, options: PlayerHitObjectImpl): boolean;
+    /**
+     * @param  {CanvasRenderingContext2D} context
+     * @param  {Float32Array} matrix
+     * @param  {object} options
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$hit(context: CanvasRenderingContext2D, matrix: Float32Array, options: PlayerHitObjectImpl): boolean;
+    /**
+     * @param  {number} scale
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$createTextAreaElement(scale: number): void;
+    /**
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$createWorkerInstance(): void;
+    /**
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$postProperty(): void;
+}