haori 0.1.0

package/dist/src/fragment.d.ts

@@ -0,0 +1,427 @@
+/**
+ * 仮想DOMのフラグメントの抽象クラス。
+ */
+export default abstract class Fragment {
+    /** フラグメントの対象ノードに対するキャッシュ */
+    protected static readonly FRAGMENT_CACHE: WeakMap<Node, Fragment>;
+    /**
+     * フラグメントを取得もしくは作成します。
+     *
+     * @param node 対象ノード
+     * @returns フラグメント
+     */
+    static get(node: HTMLElement): ElementFragment;
+    static get(node: Text): TextFragment;
+    static get(node: Comment): CommentFragment;
+    static get(node: Node | null): Fragment | null;
+    /** 親フラグメント */
+    protected parent: ElementFragment | null;
+    /** 対象ノード */
+    protected readonly target: Node;
+    /** フラグメントがDOMにマウントされているかどうか */
+    protected mounted: boolean;
+    /** ノード更新スキップフラグ（オブザーバーによる無限ループ対応） */
+    protected skipMutationNodes: boolean;
+    /**
+     * フラグメントのコンストラクタ。
+     *
+     * @param target 対象ノード
+     */
+    protected constructor(target: Node);
+    /**
+     * skipMutationNodesフラグの値を取得します。
+     *
+     * @returns skipMutationNodesの値
+     */
+    isSkipMutationNodes(): boolean;
+    /**
+     * フラグメントをDOMから除去します。
+     *
+     * @return 除去のPromise
+     */
+    unmount(): Promise<void>;
+    /**
+     * フラグメントをDOMに追加します。
+     *
+     * @return 追加のPromise
+     */
+    mount(): Promise<void>;
+    /**
+     * フラグメントのマウント状態を取得します。
+     *
+     * @returns マウント状態
+     */
+    isMounted(): boolean;
+    /**
+     * フラグメントのマウント状態を設定します。
+     *
+     * @param mounted マウント状態
+     */
+    setMounted(mounted: boolean): void;
+    /**
+     * フラグメントをクローンします。
+     *
+     * @returns クローンされたフラグメント
+     */
+    abstract clone(): Fragment;
+    /**
+     * フラグメントとノードを削除します。
+     *
+     * @param unmount DOMからの除去を行うかどうか（内部の子呼び出しの場合のみfalseとする）
+     * @return 除去のPromise
+     */
+    remove(unmount?: boolean): Promise<void>;
+    /**
+     * 対象ノードを取得します。
+     *
+     * @returns 対象ノード
+     */
+    getTarget(): Node;
+    /**
+     * 親フラグメントを取得します。
+     *
+     * @returns 親フラグメント
+     */
+    getParent(): ElementFragment | null;
+    /**
+     * 親フラグメントを設定します。
+     *
+     * @param parent 親フラグメント
+     */
+    setParent(parent: ElementFragment | null): void;
+}
+/**
+ * エレメントフラグメント。
+ * DOM要素を表現し、子ノードを持つことができます。
+ */
+export declare class ElementFragment extends Fragment {
+    /** inputイベントを発生させるタイプ */
+    private readonly INPUT_EVENT_TYPES;
+    /** 子フラグメントのリスト */
+    private readonly children;
+    /** 属性名に対する属性情報のマップ */
+    private readonly attributeMap;
+    /** バインドデータ */
+    private bindingData;
+    /** バインドデータのキャッシュ */
+    private bindingDataCache;
+    /** 表示状態 */
+    private visible;
+    /** 元の display 値 */
+    private display;
+    /** each用のテンプレート */
+    private template;
+    /** each比較用のキー */
+    private listKey;
+    /** valueプロパティの値 */
+    private value;
+    /** 属性更新スキップフラグ（オブザーバーによる無限ループ対応） */
+    private skipMutationAttributes;
+    /** 値変更スキップフラグ（更新イベントによる無限ループ対応） */
+    private skipChangeValue;
+    /**
+     * エレメントフラグメントのコンストラクタ。
+     * アトリビュートや子フラグメントの作成も行います。
+     *
+     * @param target 対象エレメント
+     */
+    constructor(target: HTMLElement);
+    /**
+     * 子フラグメントのリストを取得します。
+     *
+     * @returns 子フラグメントのリスト
+     */
+    getChildren(): Fragment[];
+    /**
+     * 子エレメントフラグメントのリストを取得します。
+     *
+     * @returns 子エレメントフラグメントのリスト
+     */
+    getChildElementFragments(): ElementFragment[];
+    /**
+     * 子フラグメントをリストに追加します。
+     * DOMの追加は行いません。
+     *
+     * @param child 追加する子フラグメント
+     */
+    pushChild(child: Fragment): void;
+    /**
+     * 子フラグメントをリストから削除します。
+     * DOMからの削除は行いません。
+     *
+     * @param child 削除する子フラグメント
+     */
+    removeChild(child: Fragment): void;
+    /**
+     * フラグメントをクローンします。
+     *
+     * @returns クローンされたフラグメント
+     */
+    clone(): ElementFragment;
+    /**
+     * フラグメントとノードを削除します。
+     *
+     * @param unmount DOMからの除去を行うかどうか（内部の子呼び出しの場合のみfalseとする）
+     * @return 除去のPromise
+     */
+    remove(unmount?: boolean): Promise<void>;
+    /**
+     * フラグメントの対象エレメントを取得します。
+     *
+     * @returns フラグメントの対象エレメント
+     */
+    getTarget(): HTMLElement;
+    /**
+     * 継承を考慮したバインドデータを取得します。
+     *
+     * @returns バインドデータのオブジェクト
+     */
+    getBindingData(): Record<string, unknown>;
+    /**
+     * 生のバインドデータを取得します。
+     *
+     * @returns 生のバインドデータ
+     */
+    getRawBindingData(): Record<string, unknown> | null;
+    /**
+     * バインドデータを設定します。
+     *
+     * @param data バインドデータ
+     */
+    setBindingData(data: Record<string, unknown>): void;
+    /**
+     * バインドデータのキャッシュをクリアします。
+     */
+    clearBindingDataCache(): void;
+    /**
+     * フラグメントのテンプレートを取得します。
+     *
+     * @returns テンプレート
+     */
+    getTemplate(): ElementFragment | null;
+    /**
+     * フラグメントのテンプレートを設定します。
+     *
+     * @param template フラグメントのテンプレート
+     */
+    setTemplate(template: ElementFragment | null): void;
+    /**
+     * 比較用リストキーを設定します。
+     *
+     * @param key 比較用リストキー
+     */
+    setListKey(key: string): void;
+    /**
+     * 比較用リストキーを取得します。
+     *
+     * @returns 比較用リストキー
+     */
+    getListKey(): string | null;
+    /**
+     * 入力エレメントに値を設定します。
+     * チェックボックとラジオボタンの場合は値に一致するかどうかでチェック状態を変更します。
+     *
+     * @param value 値
+     * @returns エレメントの更新のPromise
+     */
+    setValue(value: string | number | boolean | null): Promise<void>;
+    /**
+     * 入力エレメントの値を取得します。
+     * DOM要素の現在の値と同期します。
+     *
+     * @returns 入力エレメントの値
+     */
+    getValue(): string | number | boolean | null;
+    /**
+     * 内部の値をクリアします。エレメントのvalue値は変化しません。
+     */
+    clearValue(): void;
+    /**
+     * 内部の値をDOMの値と同期します。
+     * changeイベント時など、DOM値が変更された後に呼び出されます。
+     */
+    syncValue(): void;
+    /**
+     * 属性の値を評価して設定します。
+     * 評価値がfalseの場合は属性を削除します。
+     * 矯正評価属性の場合は元の値を設定します。
+     *
+     * @param name 属性名
+     * @param value 属性値
+     * @returns 属性の更新のPromise
+     */
+    setAttribute(name: string, value: string | null): Promise<void>;
+    /**
+     * 属性の値を削除します。
+     *
+     * @param name 属性名
+     * @returns 属性の削除のPromise
+     */
+    removeAttribute(name: string): Promise<void>;
+    /**
+     * 属性の評価された値を取得します。
+     * 複数の評価値がある場合は結合して返します。
+     *
+     * @param name 属性名
+     * @returns 評価された値
+     */
+    getAttribute(name: string): string | false | unknown | null;
+    /**
+     * 属性の生の値を取得します。
+     *
+     * @param name 属性名
+     * @returns 生の属性値
+     */
+    getRawAttribute(name: string): string | null;
+    /**
+     * 属性名のリストを取得します。
+     *
+     * @return 属性名のリスト
+     */
+    getAttributeNames(): string[];
+    /**
+     * 属性の有無を確認します。
+     *
+     * @param name 属性名
+     * @returns 属性の有無
+     */
+    hasAttribute(name: string): boolean;
+    /**
+     * 子ノードを参照ノードの前に挿入します。
+     * 参照ノードがnullの場合、親の最後に追加されます。
+     *
+     * @param newChild 新しい子ノード
+     * @param referenceChild 参照ノード
+     * @return 挿入のPromise
+     */
+    insertBefore(newChild: Fragment, referenceChild: Fragment | null): Promise<void>;
+    /**
+     * 指定した参照ノードの後に子ノードを挿入します。
+     *
+     * @param newChild 子ノード
+     * @param referenceChild 参照ノード
+     * @returns 挿入のPromise
+     */
+    insertAfter(newChild: Fragment, referenceChild: Fragment | null): Promise<void>;
+    /**
+     * 前のエレメントフラグメントを取得します。
+     * 存在しない場合はnullを返します。
+     *
+     * @return 前のエレメントフラグメントまたはnull
+     */
+    getPrevious(): ElementFragment | null;
+    /**
+     * 次のエレメントフラグメントを取得します。
+     * 存在しない場合はnullを返します。
+     *
+     * @return 次のエレメントフラグメントまたはnull
+     */
+    getNext(): ElementFragment | null;
+    /**
+     * 表示状態を返します。
+     *
+     * @returns 表示状態
+     */
+    isVisible(): boolean;
+    /**
+     * エレメントを非表示にします。
+     *
+     * @returns エレメントの非表示のPromise
+     */
+    hide(): Promise<void>;
+    /**
+     * エレメントを表示します。
+     *
+     * @return エレメントの表示のPromise
+     */
+    show(): Promise<void>;
+    /**
+     * 指定した属性名を持つ最も近い親要素を返します。
+     * 見つからない場合はnullを返します。
+     *
+     * @param name 属性名
+     * @returns 最も近い親要素またはnull
+     */
+    closestByAttribute(name: string): ElementFragment | null;
+}
+/**
+ * テキストフラグメント。
+ * テキストノードを表現します。
+ */
+export declare class TextFragment extends Fragment {
+    /** 未評価のテキスト文字列 */
+    private text;
+    /** コンテンツ */
+    private contents;
+    /** 更新スキップフラグ（オブザーバーによる無限ループ対応） */
+    private skipMutation;
+    /**
+     * テキストフラグメントのコンストラクタ。
+     * 対象テキストノードの内容を初期化します。
+     *
+     * @param target 対象テキストノード
+     */
+    constructor(target: Text);
+    /**
+     * フラグメントをクローンします。
+     *
+     * @returns クローンされたフラグメント
+     */
+    clone(): TextFragment;
+    /**
+     * フラグメントの対象ノードを取得します。
+     *
+     * @returns フラグメントの対象ノード
+     */
+    getTarget(): Text;
+    /**
+     * コンテンツを更新します。
+     *
+     * @param text テキスト
+     * @returns 更新のPromise
+     */
+    setContent(text: string): Promise<void>;
+    /**
+     * フラグメントを評価します。
+     *
+     * @returns 評価結果のPromise
+     */
+    evaluate(): Promise<void>;
+}
+/**
+ * コメントフラグメント。
+ * コメントノードを表現します。
+ */
+export declare class CommentFragment extends Fragment {
+    /** コメント文字列 */
+    private text;
+    /** 更新スキップフラグ（オブザーバーによる無限ループ対応） */
+    private skipMutation;
+    /**
+     * コメントフラグメントのコンストラクタ。
+     * 対象コメントノードの内容を初期化します。
+     *
+     * @param target 対象コメントノード
+     */
+    constructor(target: Comment);
+    /**
+     * フラグメントをクローンします。
+     *
+     * @returns クローンされたフラグメント
+     */
+    clone(): Fragment;
+    /**
+     * フラグメントの対象ノードを取得します。
+     *
+     * @returns フラグメントの対象ノード
+     */
+    getTarget(): Comment;
+    /**
+     * コンテンツを更新します。
+     *
+     * @param text テキスト
+     * @return 更新のPromise
+     */
+    setContent(text: string): Promise<void>;
+}
+//# sourceMappingURL=fragment.d.ts.map

package/dist/src/fragment.d.ts.map

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