@next2d/events 1.18.12 → 2.0.0

package/{dist → src}/EventDispatcher.d.ts

@@ -1,68 +1,19 @@
-import { Event } from "./Event";
-import type { EventListenerImpl } from "@next2d/interface";
+import type { Event } from "./Event";
+import type { IEventListener } from "./interface/IEventListener";
 /**
- * EventDispatcher クラスは、イベントを送出するすべてのクラスの基本クラスです。
- *
- * The EventDispatcher class is the base class for all classes that dispatch events.
- *
- * @example <caption>Example usage of EventDispatcher.</caption>
- * // new ColorTransform
- * const {EventDispatcher} = next2d.events;
- * const eventDispatcher   = new EventDispatcher();
- * eventDispatcher.addEventListener(Event.ENTER_FRAME, function (event)
- * {
- *     // more...
- * });
+ * @description EventDispatcher クラスは、イベントを送出するすべてのクラスの基本クラスです。
+ *              The EventDispatcher class is the base class for all classes that dispatch events.
  *
  * @class
  * @memberOf next2d.events
  */
 export declare class EventDispatcher {
-    _$events: Map<string, EventListenerImpl[]> | null;
+    _$events: Map<string, IEventListener[]> | null;
     /**
      * @constructor
      * @public
      */
     constructor();
-    /**
-     * 指定されたクラスのストリングを返します。
-     * Returns the string representation of the specified class.
-     *
-     * @return  {string}
-     * @default [class EventDispatcher]
-     * @method
-     * @static
-     */
-    static toString(): string;
-    /**
-     * @description 指定されたクラスの空間名を返します。
-     *              Returns the space name of the specified class.
-     *
-     * @member  {string}
-     * @default next2d.events.EventDispatcher
-     * @const
-     * @static
-     */
-    static get namespace(): string;
-    /**
-     * @description 指定されたオブジェクトのストリングを返します。
-     *              Returns the string representation of the specified object.
-     *
-     * @return {string}
-     * @method
-     * @public
-     */
-    toString(): string;
-    /**
-     * @description 指定されたオブジェクトの空間名を返します。
-     *              Returns the space name of the specified object.
-     *
-     * @member  {string}
-     * @default next2d.events.EventDispatcher
-     * @const
-     * @public
-     */
-    get namespace(): string;
     /**
      * @description イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、
      *              リスナーがイベントの通知を受け取るようにします。
@@ -71,8 +22,8 @@ export declare class EventDispatcher {
      *
      * @param  {string}   type
      * @param  {function} listener
-     * @param  {boolean}  [use_capture=false]
-     * @param  {number}   [priority=0]
+     * @param  {boolean}  [use_capture = false]
+     * @param  {number}   [priority = 0]
      * @return {void}
      * @method
      * @public
@@ -87,7 +38,7 @@ export declare class EventDispatcher {
      * @method
      * @public
      */
-    dispatchEvent(event: Event): boolean;
+    dispatchEvent<E extends Event>(event: E): boolean;
     /**
      * @description EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
      *              Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
@@ -103,19 +54,19 @@ export declare class EventDispatcher {
      *              Removes a listener from the EventDispatcher object.
      *
      * @param  {string}   type
-     * @param  {function} [listener = null]
+     * @param  {function} listener
      * @param  {boolean}  [use_capture = false]
      * @return {void}
      * @method
      * @public
      */
-    removeEventListener(type: string, listener: Function | null, use_capture?: boolean): void;
+    removeEventListener(type: string, listener: Function, use_capture?: boolean): void;
     /**
      * @description EventDispatcherオブジェクトから指定したタイプのリスナーを全て削除します。
      *              Removes all listeners of the specified type from the EventDispatcher object.
      *
-     * @param  {string}   type
-     * @param  {boolean}  [use_capture=false]
+     * @param  {string}  type
+     * @param  {boolean} [use_capture=false]
      * @return {void}
      * @method
      * @public
@@ -129,7 +80,7 @@ export declare class EventDispatcher {
      *              with this EventDispatcher object or
      *              any of its ancestors for the specified event type.
      *
-     * @param  {string}  type
+     * @param  {string} type
      * @return {boolean}
      * @method
      * @public

package/src/EventDispatcher.js

@@ -0,0 +1,120 @@
+import { execute as eventDispatcherAddEventListenerService } from "./EventDispatcher/service/EventDispatcherAddEventListenerService";
+import { execute as eventDispatcherHasEventListenerService } from "./EventDispatcher/service/EventDispatcherHasEventListenerService";
+import { execute as eventDispatcherRemoveEventListenerService } from "./EventDispatcher/service/EventDispatcherRemoveEventListenerService";
+import { execute as eventDispatcherRemoveAllEventListenerService } from "./EventDispatcher/service/EventDispatcherRemoveAllEventListenerService";
+import { execute as eventDispatcherWillTriggerService } from "./EventDispatcher/service/EventDispatcherWillTriggerService";
+import { execute as eventDispatcherDispatchEventService } from "./EventDispatcher/service/EventDispatcherDispatchEventService";
+/**
+ * @description EventDispatcher クラスは、イベントを送出するすべてのクラスの基本クラスです。
+ *              The EventDispatcher class is the base class for all classes that dispatch events.
+ *
+ * @class
+ * @memberOf next2d.events
+ */
+export class EventDispatcher {
+    /**
+     * @constructor
+     * @public
+     */
+    constructor() {
+        Object.defineProperty(this, "_$events", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * @type {Map}
+         * @default null
+         * @private
+         */
+        this._$events = null;
+    }
+    /**
+     * @description イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、
+     *              リスナーがイベントの通知を受け取るようにします。
+     *              Registers an event listener object with an EventDispatcher object
+     *              so that the listener receives notification of an event.
+     *
+     * @param  {string}   type
+     * @param  {function} listener
+     * @param  {boolean}  [use_capture = false]
+     * @param  {number}   [priority = 0]
+     * @return {void}
+     * @method
+     * @public
+     */
+    addEventListener(type, listener, use_capture = false, priority = 0) {
+        if (!this._$events) {
+            this._$events = new Map();
+        }
+        eventDispatcherAddEventListenerService(this, type, listener, use_capture, priority);
+    }
+    /**
+     * @description イベントをイベントフローに送出します。
+     *              Dispatches an event into the event flow.
+     *
+     * @param  {Event} event
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    dispatchEvent(event) {
+        return eventDispatcherDispatchEventService(this, event);
+    }
+    /**
+     * @description EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
+     *              Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
+     *
+     * @param  {string} type
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    hasEventListener(type) {
+        return eventDispatcherHasEventListenerService(this, type);
+    }
+    /**
+     * @description EventDispatcher オブジェクトからリスナーを削除します。
+     *              Removes a listener from the EventDispatcher object.
+     *
+     * @param  {string}   type
+     * @param  {function} listener
+     * @param  {boolean}  [use_capture = false]
+     * @return {void}
+     * @method
+     * @public
+     */
+    removeEventListener(type, listener, use_capture = false) {
+        eventDispatcherRemoveEventListenerService(this, type, listener, use_capture);
+    }
+    /**
+     * @description EventDispatcherオブジェクトから指定したタイプのリスナーを全て削除します。
+     *              Removes all listeners of the specified type from the EventDispatcher object.
+     *
+     * @param  {string}  type
+     * @param  {boolean} [use_capture=false]
+     * @return {void}
+     * @method
+     * @public
+     */
+    removeAllEventListener(type, use_capture = false) {
+        eventDispatcherRemoveAllEventListenerService(this, type, use_capture);
+    }
+    /**
+     * @description 指定されたイベントタイプについて、
+     *              この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが
+     *              登録されているかどうかを確認します。
+     *              Checks whether an event listener is registered
+     *              with this EventDispatcher object or
+     *              any of its ancestors for the specified event type.
+     *
+     * @param  {string} type
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    willTrigger(type) {
+        return eventDispatcherWillTriggerService(this, type);
+    }
+}

package/src/EventPhase.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @description EventPhase クラスは、Event クラスの eventPhase プロパティの値を提供します。
+ *              The EventPhase class provides values for the eventPhase property of the Event class.
+ *
+ * @class
+ * @memberOf next2d.events
+ */
+export declare class EventPhase {
+    /**
+     * @description ターゲット段階（イベントフローの 2 番目の段階）です。
+     *              The target phase, which is the second phase of the event flow.
+     *
+     * @return  {number}
+     * @default 2
+     * @const
+     * @static
+     */
+    static get AT_TARGET(): number;
+    /**
+     * @description ターゲット段階（イベントフローの 2 番目の段階）です。
+     *              The target phase, which is the second phase of the event flow.
+     *
+     * @return  {number}
+     * @default 3
+     * @const
+     * @static
+     */
+    static get BUBBLING_PHASE(): number;
+    /**
+     * @description キャプチャ段階（イベントフローの最初の段階）です。
+     *              The capturing phase, which is the first phase of the event flow.
+     *
+     * @return  {number}
+     * @default 1
+     * @const
+     * @static
+     */
+    static get CAPTURING_PHASE(): number;
+}

package/src/EventPhase.js

@@ -0,0 +1,45 @@
+/**
+ * @description EventPhase クラスは、Event クラスの eventPhase プロパティの値を提供します。
+ *              The EventPhase class provides values for the eventPhase property of the Event class.
+ *
+ * @class
+ * @memberOf next2d.events
+ */
+export class EventPhase {
+    /**
+     * @description ターゲット段階（イベントフローの 2 番目の段階）です。
+     *              The target phase, which is the second phase of the event flow.
+     *
+     * @return  {number}
+     * @default 2
+     * @const
+     * @static
+     */
+    static get AT_TARGET() {
+        return 2;
+    }
+    /**
+     * @description ターゲット段階（イベントフローの 2 番目の段階）です。
+     *              The target phase, which is the second phase of the event flow.
+     *
+     * @return  {number}
+     * @default 3
+     * @const
+     * @static
+     */
+    static get BUBBLING_PHASE() {
+        return 3;
+    }
+    /**
+     * @description キャプチャ段階（イベントフローの最初の段階）です。
+     *              The capturing phase, which is the first phase of the event flow.
+     *
+     * @return  {number}
+     * @default 1
+     * @const
+     * @static
+     */
+    static get CAPTURING_PHASE() {
+        return 1;
+    }
+}

package/src/EventUtil.d.ts

@@ -0,0 +1,42 @@
+import type { IEventListener } from "./interface/IEventListener";
+/**
+ * @type {Map}
+ * @private
+ */
+export declare const $broadcastEvents: Map<string, IEventListener[]>;
+/**
+ * @return {array}
+ * @method
+ * @private
+ */
+export declare const $getArray: () => any[];
+/**
+ * @return {void}
+ * @method
+ * @private
+ */
+export declare const $poolArray: (array: any[]) => void;
+/**
+ * @private
+ */
+type IEvent = PointerEvent | KeyboardEvent | WheelEvent | Event | null;
+/**
+ * @description アクティブなイベントオブジェクをセット
+ *              Set the active event object
+ *
+ * @param  {IEvent} event
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const $setEvent: (event: IEvent) => void;
+/**
+ * @description アクティブなイベントオブジェクを取得
+ *              Get the active event object
+ *
+ * @return {IEvent}
+ * @method
+ * @protected
+ */
+export declare const $getEvent: () => IEvent;
+export {};

package/src/EventUtil.js

@@ -0,0 +1,59 @@
+/**
+ * @type {Map}
+ * @private
+ */
+export const $broadcastEvents = new Map();
+/**
+ * @type {array}
+ * @private
+ */
+const $array = [];
+/**
+ * @return {array}
+ * @method
+ * @private
+ */
+export const $getArray = () => {
+    return $array.length
+        ? $array.pop()
+        : [];
+};
+/**
+ * @return {void}
+ * @method
+ * @private
+ */
+export const $poolArray = (array) => {
+    if (10 > $array.length) {
+        array.length = 0;
+        $array.push(array);
+    }
+};
+/**
+ * @type {IEvent}
+ * @private
+ */
+let $event = null;
+/**
+ * @description アクティブなイベントオブジェクをセット
+ *              Set the active event object
+ *
+ * @param  {IEvent} event
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const $setEvent = (event) => {
+    $event = event;
+};
+/**
+ * @description アクティブなイベントオブジェクを取得
+ *              Get the active event object
+ *
+ * @return {IEvent}
+ * @method
+ * @protected
+ */
+export const $getEvent = () => {
+    return $event;
+};

package/src/FocusEvent.d.ts

@@ -0,0 +1,42 @@
+import { Event } from "./Event";
+/**
+ * @description FocusEvent オブジェクトは、ユーザーが表示リストの1つのオブジェクトから
+ *              別のオブジェクトにフォーカスを変更したときにオブジェクトによって送出されます。
+ *              次の2種類のフォーカスイベントがあります。
+ *
+ *              An object dispatches a FocusEvent object when the user changes
+ *              the focus from one object in the display list to another.
+ *              There are two types of focus events:
+ *
+ * @class
+ * @memberOf next2d.events
+ * @extends  Event
+ */
+export declare class FocusEvent extends Event {
+    /**
+     * @param {string}  type
+     * @param {boolean} [bubbles=true]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(type: string, bubbles?: boolean);
+    /**
+     * @description focusIn イベントオブジェクトの type プロパティ値を定義します。
+     *              Defines the value of the type property of a focusIn event object.
+     *
+     * @return {string}
+     * @const
+     * @static
+     */
+    static get FOCUS_IN(): string;
+    /**
+     * @description focusOut イベントオブジェクトの type プロパティ値を定義します。
+     *              Defines the value of the type property of a focusOut event object.
+     *
+     * @return {string}
+     * @const
+     * @static
+     */
+    static get FOCUS_OUT(): string;
+}

package/src/FocusEvent.js

@@ -0,0 +1,71 @@
+import { Event } from "./Event";
+import { $getEvent } from "./EventUtil";
+/**
+ * @description FocusEvent オブジェクトは、ユーザーが表示リストの1つのオブジェクトから
+ *              別のオブジェクトにフォーカスを変更したときにオブジェクトによって送出されます。
+ *              次の2種類のフォーカスイベントがあります。
+ *
+ *              An object dispatches a FocusEvent object when the user changes
+ *              the focus from one object in the display list to another.
+ *              There are two types of focus events:
+ *
+ * @class
+ * @memberOf next2d.events
+ * @extends  Event
+ */
+export class FocusEvent extends Event {
+    /**
+     * @param {string}  type
+     * @param {boolean} [bubbles=true]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(type, bubbles = true) {
+        super(type, bubbles);
+        return new Proxy(this, {
+            "get": (object, name) => {
+                if (name in object) {
+                    return object[name];
+                }
+                const event = $getEvent();
+                if (!event) {
+                    return undefined;
+                }
+                switch (event.type) {
+                    case FocusEvent.FOCUS_IN:
+                    case FocusEvent.FOCUS_OUT:
+                        if (name in event) {
+                            // @ts-ignore
+                            return $event[name];
+                        }
+                        return undefined;
+                    default:
+                        return undefined;
+                }
+            }
+        });
+    }
+    /**
+     * @description focusIn イベントオブジェクトの type プロパティ値を定義します。
+     *              Defines the value of the type property of a focusIn event object.
+     *
+     * @return {string}
+     * @const
+     * @static
+     */
+    static get FOCUS_IN() {
+        return "focusin";
+    }
+    /**
+     * @description focusOut イベントオブジェクトの type プロパティ値を定義します。
+     *              Defines the value of the type property of a focusOut event object.
+     *
+     * @return {string}
+     * @const
+     * @static
+     */
+    static get FOCUS_OUT() {
+        return "focusout";
+    }
+}

package/src/HTTPStatusEvent.d.ts

@@ -0,0 +1,63 @@
+import type { IURLRequestHeader } from "./interface/IURLRequestHeader";
+import { Event } from "./Event";
+/**
+ * @description ネットワーク要求が HTTP ステータスコードを返すと、アプリケーションによって HTTPStatusEvent オブジェクトが送出されます。
+ *              The application dispatches HTTPStatusEvent objects when a network request returns an HTTP status code.
+ *
+ * @class
+ * @memberOf next2d.events
+ * @extends  Event
+ */
+export declare class HTTPStatusEvent extends Event {
+    /**
+     * @description サーバーから返された HTTP ステータスコードです。
+     *              The HTTP status code returned by the server.
+     *
+     * @return {number}
+     * @readonly
+     * @public
+     */
+    readonly status: number;
+    /**
+     * @description 返された応答ヘッダー（URLRequestHeader オブジェクトの配列）です。
+     *              The response headers that the response returned,
+     *              as an array of URLRequestHeader objects.
+     *
+     * @return {array}
+     * @readonly
+     * @public
+     */
+    readonly responseHeaders: IURLRequestHeader[];
+    /**
+     * @description 応答の返送元の URL です。
+     *              The URL that the response was returned from.
+     *
+     * @return {string}
+     * @readonly
+     * @public
+     */
+    readonly responseURL: string;
+    /**
+     * @param {string}  type
+     * @param {boolean} [bubbles=false]
+     * @param {number}  [status=0]
+     * @param {string}  [response_url=""]
+     * @param {array}   [response_headers=[]]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(type: string, bubbles?: boolean, status?: number, response_url?: string, response_headers?: IURLRequestHeader[]);
+    /**
+     * @description HTTPStatusEvent.HTTP_STATUS 定数は、
+     *              httpStatus イベントオブジェクトの type プロパティの値を定義します。
+     *              The HTTPStatusEvent.HTTP_STATUS constant defines the value
+     *              of the type property of a httpStatus event object.
+     *
+     * @return {string}
+     * @default "httpStatus"
+     * @const
+     * @static
+     */
+    static get HTTP_STATUS(): string;
+}