ソフトナビゲーションとインタラクション・コンテンツフル・ペイント

Window window が与えられたとき、 increment the current navigation id するには、次を実行する。

1. window の navigation count を、window の navigation count に 1 を加えた値に設定する。

2. newId を、window の initial navigation id value に、 （window の navigation count と window の navigation id increment の積）を加えた値とする。

3. window の current navigation id を newId に設定する。

[Exposed=(Window,Worker)]
partial interface PerformanceEntry {
    readonly attribute unsigned long long navigationId;
};

現在の 操作コンテキストを取得するには、Document document が与えられたとき、次を実行する:

1. context を、内部 AsyncContext.Variable [[ActiveInteractionContext]] の値とする。

2. context が null でなく、かつ context の コンテキスト文書 が document と等しくない場合、null を返す。

3. context を返す。

操作のコンテキストを取得または作成するには、 Document document と PerformanceEventTiming timing entry が与えられたとき、次を実行する:

1. interaction id を、timing entry の interactionId とする。

2. interaction id が 0 より大きいことを 表明する。

3. document の 操作 ID から操作コンテキストへの写像[interaction id] が 存在する場合、 document の 操作 ID から操作コンテキストへの写像[interaction id] を返す。

4. interaction context を新しい InteractionContext とする。

5. interaction context の id を interaction id に設定する。

6. interaction context の コンテキスト文書 を document に設定する。

7. interaction context の 開始 時刻 を timing entry の startTime に設定する。

8. document の 操作 ID から操作コンテキストへの写像[interaction id] を interaction context に 設定する。

9. interaction context を返す。

イベントの操作コンテキストを更新するには、 Document document と Event event が与えられたとき、次を実行する:

1. timestamp を、document の 関連するグローバルオブジェクト を指定して得られる 現在の高分解能時刻 とする。

2. is scroll を、event の型が "scroll" であれば true、そうでなければ false とする。

3. is input を、event の型が 入力イベントを配送済みである を引き起こすイベント型 （[EVENT-TIMING] で定義される）であれば true、そうでなければ false とする。

4. is scroll が false で、かつ is input が false である場合、返る。

5. document の 操作 ID から操作 コンテキストへの写像 の 値の各 interaction context について:

   1. is scroll が true で、かつ interaction context の 最初のスクロールタイムスタンプ が 0 である場合:

      1. interaction context の 最初のスクロール タイムスタンプ を timestamp に設定する。

   2. is input が true で、かつ interaction context の 最初の入力タイムスタンプ が 0 である場合:

      1. interaction context の 最初の入力 タイムスタンプ を timestamp に設定する。

イベント配送のために現在の操作コンテキストを 設定するには、null または PerformanceEventTiming オブジェクト timing entry が与えられたとき、次を実行する:

1. timing entry が null である場合、null を返す。

2. interaction id を、timing entry の interactionId とする。

3. interaction id が 0 である場合、null を返す。

4. event を、timing entry の 関連付けられたイベント とする。

5. document を、event の 関連するグローバルオブジェクト の 関連付けられた Document とする。

6. document と event が与えられたものとして、イベントの操作コンテキストを 更新する。

7. interaction context を、document と timing entry が与えられたものとして 操作のコンテキストを取得または作成する 結果とする。

8. 内部 AsyncContext.Variable [[ActiveInteractionContext]] の値を interaction context に設定する。

9. interaction context を返す。

イベント配送後に現在の操作コンテキストを 設定解除するには、次を実行する:

1. 内部 AsyncContext.Variable [[ActiveInteractionContext]] の値を null に設定する。

[Exposed=Window]
interface InteractionContentfulPaint : PerformanceEntry {
    readonly attribute LargestContentfulPaint largestContentfulPaint;
    readonly attribute unsigned long long interactionId;

    object toJSON();
};

InteractionContentfulPaint includes PaintTimingMixin;

Window window、InteractionContext interaction context、LargestContentfulPaint lcpEntry、および paint timing info paintTimingInfo が与えられたとき、 create an interaction contentful paint entry するには、次を実行する。

1. entry を、window の realm 内の新しい InteractionContentfulPaint オブジェクトとする。

2. entry の context を interaction context に設定する。

3. entry の largest contentful paint を lcpEntry に設定する。

4. entry に関連付けられた paint timing info を paintTimingInfo に設定する。

5. entry を返す。

新しい属性付けされたコンテンツフルペイント 候補を処理するには、 最大コンテンツフルペイント候補 lcpCandidate、Document document、 InteractionContext interaction context、および ペイント タイミング情報 paintTimingInfo が与えられたとき、次を実行する:

1. interaction context の 最初のスクロールタイムスタンプ が 0 より大きく、かつ lcpEntry の renderTime が interaction context の 最初のスクロールタイムスタンプ より大きい場合、返る。

2. interaction context の 最初の入力タイムスタンプ が 0 より大きく、 かつ lcpEntry の renderTime が interaction context の 最初の入力タイムスタンプ より大きい場合、返る。

3. lcpEntry を、lcpCandidate、paintTimingInfo、および document で LargestContentfulPaint エントリを作成する結果とする。

4. global を document の 関連するグローバルオブジェクト とする。

5. paint timing info を、lcpEntry に関連付けられた ペイントタイミング情報 とする。

6. icpEntry を、global、interaction context、lcpEntry、および paint timing info が与えられたものとして、操作コンテンツフル ペイントエントリを作成する結果とする。

7. icpEntry をキューに入れる。

8. icpEntry を global の パフォーマンスエントリバッファ に追加する。

9. interaction context の 最初のコンテンツフルペイント が null である場合:

   1. interaction context の 最初のコンテンツフルペイント を icpEntry に設定する。

10. interaction context の 最大コンテンツフルペイント を icpEntry に設定する。

11. interaction context の 現在の最大 コンテンツフルペイント候補 を lcpCandidate に設定する。

To インタラクション・コンテンツフル・ペイントおよび ソフトナビゲーションを報告するには、Document document、ペイントタイミング情報 paintTimingInfo、 順序付き セットである 保留中の画像レコード paintedImages、および 順序付き セットである 要素 paintedTextNodes が与えられたとき：

1. contextToCandidateSets を新しい マップとする。

2. paintedImages の各 record について反復する：

   1. element を record の 要素とする。

   2. interaction context を、element について ペイント帰属インタラクション コンテキストを取得する結果とする。

   3. interaction context が null でない場合：

      1. contextToCandidateSets が interaction context を 含まない場合、 contextToCandidateSets[interaction context] を « «», «» » に 設定する。

      2. record を contextToCandidateSets[interaction context][0] に 追加する。

3. paintedTextNodes の各 element について反復する：

   1. interaction context を、element について ペイント帰属インタラクション コンテキストを取得する結果とする。

   2. interaction context が null でない場合：

      1. contextToCandidateSets が interaction context を 含まない場合、 contextToCandidateSets[interaction context] を « «», «» » に 設定する。

      2. element を contextToCandidateSets[interaction context][1] に 追加する。

4. contextToCandidateSets 内の各 interaction context → candidateSets について反復する：

   1. newCandidate を、document、candidateSets[0]、 candidateSets[1]、および interaction context の 現在の 最大コンテンツフル・ペイント候補が与えられたときの 新しい 最大コンテンツフル・ペイント候補を計算する結果とする。

   2. newCandidate が null でない場合：

      1. newCandidate、document、 interaction context、および paintTimingInfo が 与えられたとき、 新しい 帰属済みコンテンツフル・ペイント候補を処理する。

      2. document および interaction context が与えられたとき、 ソフトナビゲーションの送出を 評価する。

InteractionPaintTimingNodeState node state が、InteractionPaintTimingNodeState または null である other node state より 新しい かどうかを判定するには：

1. other node state が null である場合、または node state の modification id が other node state の modification id より大きい場合は true を返し、 それ以外の場合は false を返す。

所与の Node node について、 ペイント帰属インタラクションコンテキストを取得する には：

1. document を node の ノード文書とする。

2. node state を、document の 伝播済みノード状態[node] の デフォルト値付き null とする。

3. node state が null である場合は null を返し、そうでなければ node state の context を返す。

Node target node が与えられたとき、それを インタラクション・ペイントタイミング用に 変更済みのノードとして記録するには：

1. document を node の ノード文書とする。

2. target node が、document を与えたときの ペイントタイミング用に公開されるものでない場合、 return する。

3. interaction context を、document が与えられたときの 現在のインタラクションコンテキストを取得する結果とする。

4. interaction context が null の場合、return する。

5. document の 最後の変更コンテキストが interaction context と等しくない場合：

   1. document の 最後の変更コンテキストを interaction context に設定する。

   2. document の 現在の変更世代 IDを 1 増やす。

6. previous node state を、document の マーク済みノード 状態[target node] の デフォルト値付き null とする。

7. previous node state が null でなく、かつ previous node state の modification id が document の 現在の変更世代 IDと等しい場合、return する。

8. node state を新しい InteractionPaintTimingNodeState とする。

9. node state の context を interaction context に設定する。

10. node state の modification id を document の 現在の変更世代 IDに設定する。

11. document の マーク済みノード 状態[node] を node state に設定する。

12. document の インタラクション・ペイントタイミングが dirty であるを true に設定する。

Document document が与えられたとき、 文書とその子孫の インタラクションコンテキストを更新するには：

1. document の インタラクション・ペイントタイミングが dirty であるが false の場合、return する。

2. document および null が与えられたとき、 ノードとその子孫の インタラクションコンテキストを更新する。

3. document の インタラクション・ペイントタイミングが dirty であるを false に設定する。

Node node、および InteractionPaintTimingNodeState inherited node state または null が与えられたとき、 ノードとその子孫の インタラクションコンテキストを更新するには：

1. document を node の ノード文書とする。

2. node state を、document の マーク済みノード 状態[node] の デフォルト値付き null とする。

3. node state が null でない場合：

   1. node state が inherited node state より 新しい場合：

      1. inherited node state を node state に設定する。

      2. node が Text ノードである場合、document の マーク済みノード 状態[node] を削除する。

   2. そうでなければ、document の マーク済み ノード状態[node] を削除する。

4. inherited node state が null でなく、かつ node が タイミング対象である場合：

   1. attribution element を、node について 帰属要素を取得する結果とする。

   2. previous propagated state を 伝播済みノード 状態[attribution element] の デフォルト値付き null とする。

   3. inherited node state が previous propagated state より新しい場合：

      1. 伝播済みノード 状態[attribution element] を inherited node state に設定する。

      2. previous propagated state が null である、または previous propagated state の context が inherited node state の context と等しくない場合、 attribution element について ペイント追跡をリセットする。

5. node の各 子 child node について反復し、 child node および inherited node state が与えられたとき、 ノードとその子孫の インタラクションコンテキストを更新する。

[Exposed=Window]
interface PerformanceSoftNavigation : PerformanceEntry {
    readonly attribute NavigationType navigationType;
    readonly attribute unsigned long long interactionId;
    InteractionContentfulPaint? getLargestInteractionContentfulPaint();
};

PerformanceSoftNavigation includes PaintTimingMixin;

To ソフトナビゲーション発行を評価する given a Document document and an InteractionContext interaction context:

1. interaction context の 発行済み が true である場合、返る。

2. document の アクティブなソフトナビゲーション候補 が interaction context でない場合、返る。

3. interaction context の 最初の URL 値 が null である場合、返る。

4. interaction context の 最初のコンテンツフルペイント が null である場合、返る。

5. window を document の 関連するグローバルオブジェクト とする。

6. entry を、window と interaction context が与えられたものとして ソフトナビゲーション エントリを作成する結果とする。

7. window と entry が与えられたものとして、ソフトナビゲーションエントリを発行する。

8. interaction context の 発行済み を true に設定する。

To ソフト ナビゲーションエントリを作成する given a Window window, and an InteractionContext interaction context:

1. entry を、window の realm 内の新しい PerformanceSoftNavigation オブジェクトとする。

2. entry の コンテキスト を interaction context に設定する。

3. first paint を interaction context の 最初のコンテンツフルペイント とする。

4. first paint が null でないことを 表明する。

5. entry に関連付けられた ペイントタイミング情報 を、first paint に関連付けられた ペイントタイミング情報 に設定する。

6. entry を返す。

To ソフト ナビゲーションエントリを発行する given a Window window and a PerformanceSoftNavigation entry:

1. window が与えられたものとして、現在のナビゲーション ID を増加させる。

2. entry をキューに入れる。

3. entry を window の パフォーマンスエントリバッファ に追加する。

To 同一 文書コミットを処理する given a Document document, 文字列 url, and NavigationType navigation type:

1. url が document の url と等しい場合、返る。

2. interaction context を、document が与えられたものとして 現在の操作 コンテキストを取得する結果とする。

3. interaction context が null である場合、返る。

4. interaction context の 最後の URL 値 を url に設定する。

5. interaction context の 最初の URL 更新タイムスタンプ が null である場合:

   1. interaction context の 最初の URL 更新 タイムスタンプ を、document の 関連するグローバルオブジェクト が与えられたものとして得られる 現在の高分解能時刻 に設定する。

   2. interaction context の 最初の URL 値 を url に設定する。

   3. interaction context の ナビゲーション型 を navigation type に設定する。

6. document の アクティブなソフトナビゲーション候補 を interaction context に設定する。

7. document と interaction context が与えられたものとして、ソフトナビゲーション発行を評価する。

node insert において、または node node が 次のいずれかの方法で変更されたとき：

• 要素の class または style 属性が変更された。

• リソース属性（たとえば img または video 要素の src など）が変更された。

次の手順を実行する：

1. node が与えられたとき、インタラクション・ペイントタイミング用に 変更済みのノードとして記録する。

履歴ステップ適用のために文書を更新するにおいて、 5.5.1（documentsEntryChanged が true であり、かつ documentIsNew が false である場合）の前に、同一 文書コミットを処理するを、Document、 対象エントリの url、および "traverse" が与えられたものとして実行する。

共有 履歴 push/replace ステップ （[HTML] で定義される）において、 URL が更新された後、同一文書コミットを処理するを、 Document、新しい URL、および操作型（"push" または "replace" のいずれか）が与えられたものとして実行する。

[NAVIGATION-TIMING] において、初期ナビゲーション用の PerformanceNavigationTiming エントリを作成するとき、ユーザーエージェントは、その navigationId を Window の 現在のナビゲーション ID に設定しなければならない。

Window window について、 次の interactionId を取得するには：

1. window の interaction count を、window の interaction count に 1 を加えた値に設定する。

2. window の initial interactionId value に、 （window の interaction count と window の interactionId increment の積）を加えた値を返す。

[EVENT-TIMING] で定義される DOM 仕様の イベント 配送アルゴリズムへの変更において：

1. timingEntry を イベントタイミング処理開始を初期化して記録する 結果に設定する手順の直後に、次の手順を実行する：

   1. timingEntry が与えられたとき、イベント配送用の現在の インタラクションコンテキストを設定する。

2. イベントタイミング処理終了を記録するを呼び出す手順の 直前に、次の手順を実行する：

   1. イベント配送後に現在の インタラクションコンテキストを未設定にする。

mark paint timing を変更し、 Document document が与えられたとき、手順 1 の後に次の手順を追加する：

1. document が与えられたとき、文書とその子孫の インタラクションコンテキストを更新する。

mark paint timing を変更し、手順 10.3（largest contentful paint を報告する）の後に次の手順を追加する。 その際、Document document、ペイントタイミング情報 paintTimingInfo、 順序付きセットである 保留中の画像レコード paintedImages、および 順序付き セットである 要素 paintedTextNodes を与える：

1. document、 paintTimingInfo、paintedImages、および paintedTextNodes が与えられたとき、 インタラクション・ コンテンツフル・ペイントおよびソフトナビゲーションを報告する。

Node node について、 ペイント 追跡をリセットするには：

1. node のテキスト要素追跡をリセットする。

2. node の画像要素追跡をリセットする。

Node node について、 帰属 要素を取得するには：

1. node が Text node である場合、node の 包含ブロックを決定する Element を返す。

2. そうでなければ、node を返す。