[permissions] Add an optional topLevelOrigin parameter to the permissions.setPermission command w3c/permissions@a867a0e

Author: triple-underscore

webappsec-permissions-ja.html

@@ -144,8 +144,8 @@
 ●●options
 
 spec_title:Permissions
-spec_date:2025-06-24
-trans_update:2024-12-21
+spec_date:2025-09-26
+trans_update:2025-09-30
 source_checked:230612
 page_state_key:WEBAPPSEC
 original_url:https://w3c.github.io/permissions/
@@ -612,6 +612,11 @@
 	%生成元:target origin
 	%~UA:user agent
 	%利用者~文脈~ID:user context id
+	%~key:target key
+	%~target群:targets
+	%設定群~list:settings list
+	%設定群~key:settings key
+	%合致したか:matches
 
 	●許可／保安
 許容list:allowlist::許容 list:許容リスト
@@ -732,54 +737,54 @@
 ●●ref_normative
 
 [dom]
-    ＜DOM Standard＞. Anne van Kesteren.  WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/
+    ＜DOM Standard＞. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/ 
 [ecma-262]
-    ＜ECMAScript Language Specification＞.  Ecma International. URL: https://tc39.es/ecma262/multipage/
+    ＜ECMAScript Language Specification＞. Ecma International. URL: https://tc39.es/ecma262/multipage/ 
 [HTML]
-    ＜HTML Standard＞. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters.  WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/
+    ＜HTML Standard＞. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/ 
 [infra]
-    ＜Infra Standard＞. Anne van Kesteren; Domenic Denicola.  WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/
+    ＜Infra Standard＞. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/ 
 [Notifications]
-    ＜Notifications API Standard＞. Anne van Kesteren.  WHATWG. Living Standard. URL: https://notifications.spec.whatwg.org/
+    ＜Notifications API Standard＞. Anne van Kesteren. WHATWG. Living Standard. URL: https://notifications.spec.whatwg.org/ 
 [Permissions-Policy]
-    ＜Permissions Policy＞. Ian Clelland.  W3C. 6 May 2025. W3C Working Draft. URL: https://www.w3.org/TR/permissions-policy-1/
+    ＜Permissions Policy＞. Ian Clelland. W3C. 6 August 2025. W3C Working Draft. URL: https://www.w3.org/TR/permissions-policy-1/ 
 [permissions-registry]
-    ＜Permissions Registry＞.  W3C. Draft Registry. URL: https://w3c.github.io/permissions-registry/
+    ＜Permissions Registry＞. W3C. Draft Registry. URL: https://w3c.github.io/permissions-registry/ 
 [RFC2119]
-    ＜Key words for use in RFCs to Indicate Requirement Levels＞. S. Bradner.  IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
+    ＜Key words for use in RFCs to Indicate Requirement Levels＞. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119 
 [RFC8174]
-    ＜Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words＞. B. Leiba.  IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174
+    ＜Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words＞. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174 
 [WebDriver]
-    ＜WebDriver＞. Simon Stewart; David Burns.  W3C. 5 June 2018. W3C Recommendation. URL: https://www.w3.org/TR/webdriver1/
+    ＜WebDriver＞. Simon Stewart; David Burns. W3C. 5 June 2018. W3C Recommendation. URL: https://www.w3.org/TR/webdriver1/ 
 [WebDriver-BiDi]
-    ＜WebDriver BiDi＞. James Graham; Alex Rudenko; Maksim Sadym.  W3C. 20 June 2025. W3C Working Draft. URL: https://www.w3.org/TR/webdriver-bidi/
+    ＜WebDriver BiDi＞. James Graham; Alex Rudenko; Maksim Sadym. W3C. 26 September 2025. W3C Working Draft. URL: https://www.w3.org/TR/webdriver-bidi/ 
 [webdriver2]
-    ＜WebDriver＞. Simon Stewart; David Burns.  W3C. 20 June 2025. W3C Working Draft. URL: https://www.w3.org/TR/webdriver2/
+    ＜WebDriver＞. Simon Stewart; David Burns. W3C. 8 September 2025. W3C Working Draft. URL: https://www.w3.org/TR/webdriver2/ 
 [WEBIDL]
-    ＜Web IDL Standard＞. Edgar Chen; Timothy Gu.  WHATWG. Living Standard. URL: https://webidl.spec.whatwg.org/
+    ＜Web IDL Standard＞. Edgar Chen; Timothy Gu. WHATWG. Living Standard. URL: https://webidl.spec.whatwg.org/ 
 
 ●●ref_informative
 
 [appmanifest]
-    ＜Web Application Manifest＞. Marcos Caceres; Kenneth Christiansen; Diego Gonzalez-Zuniga; Daniel Murphy; Christian Liebel.  W3C. 5 May 2025. W3C Working Draft. URL: https://www.w3.org/TR/appmanifest/
+    ＜Web Application Manifest＞. Marcos Caceres; Kenneth Christiansen; Diego Gonzalez-Zuniga; Daniel Murphy; Christian Liebel. W3C. 3 September 2025. W3C Working Draft. URL: https://www.w3.org/TR/appmanifest/ 
 [Geolocation]
-    ＜Geolocation＞. Marcos Caceres; Reilly Grant.  W3C. 11 April 2025. W3C Recommendation. URL: https://www.w3.org/TR/geolocation/
+    ＜Geolocation＞. Marcos Caceres; Reilly Grant. W3C. 23 September 2025. W3C Recommendation. URL: https://www.w3.org/TR/geolocation/ 
 [GETUSERMEDIA]
-    ＜Media Capture and Streams＞. Cullen Jennings; Jan-Ivar Bruaroey; Henrik Boström; youenn fablet.  W3C. 26 May 2025. CRD. URL: https://www.w3.org/TR/mediacapture-streams/
+    ＜Media Capture and Streams＞. Cullen Jennings; Jan-Ivar Bruaroey; Henrik Boström; youenn fablet. W3C. 25 September 2025. CRD. URL: https://www.w3.org/TR/mediacapture-streams/ 
 [local-font-access]
-    ＜Local Font Access API＞.  W3C. Draft Community Group Report. URL: https://wicg.github.io/local-font-access/
+    ＜Local Font Access API＞. W3C. Draft Community Group Report. URL: https://wicg.github.io/local-font-access/ 
 [orientation-event]
-    ＜Device Orientation and Motion＞. Reilly Grant; Marcos Caceres.  W3C. 12 February 2025. CRD. URL: https://www.w3.org/TR/orientation-event/
+    ＜Device Orientation and Motion＞. Reilly Grant; Marcos Caceres. W3C. 12 February 2025. CRD. URL: https://www.w3.org/TR/orientation-event/ 
 [Permissions]
-    ＜Permissions＞. Marcos Caceres; Mike Taylor.  W3C. 20 December 2024. W3C Working Draft. URL: https://www.w3.org/TR/permissions/
+    ＜Permissions＞. Marcos Caceres; Mike Taylor. W3C. 24 June 2025. W3C Working Draft. URL: https://www.w3.org/TR/permissions/ 
 [push-api]
-    ＜Push API＞. Peter Beverloo; Martin Thomson; Marcos Caceres.  W3C. 3 September 2024. W3C Working Draft. URL: https://www.w3.org/TR/push-api/
+    ＜Push API＞. Marcos Caceres; Kagami Rosylight. W3C. 25 September 2025. W3C Working Draft. URL: https://www.w3.org/TR/push-api/ 
 [w3c-process]
-    ＜W3C Process Document＞. Elika J. Etemad (fantasai); Florian Rivoal.  W3C. 3 November 2023. URL: https://www.w3.org/policies/process/
+    ＜W3C Process Document＞. Elika J. Etemad (fantasai); Florian Rivoal. W3C. 18 August 2025. URL: https://www.w3.org/policies/process/ 
 [Web-Share]
-    ＜Web Share API＞. Marcos Caceres; Eric Willigers; Matt Giuca.  W3C. 30 May 2023. W3C Recommendation. URL: https://www.w3.org/TR/web-share/
+    ＜Web Share API＞. Marcos Caceres; Eric Willigers; Matt Giuca. W3C. 30 May 2023. W3C Recommendation. URL: https://www.w3.org/TR/web-share/ 
 [window-management]
-    ＜Window Management＞. Joshua Bell; Mike Wasserman.  W3C. 7 June 2024. W3C Working Draft. URL: https://www.w3.org/TR/window-management/
+    ＜Window Management＞. Joshua Bell; Mike Wasserman. W3C. 7 June 2024. W3C Working Draft. URL: https://www.w3.org/TR/window-management/ 
 
 
 ●●trans_metadata
@@ -2118,9 +2123,18 @@ <h2 title="Specifying a powerful feature">4. 強力な特能の指定-法</h2>
 A permission key generation algorithm:
 </dt>
 	<dd>
-所与の`環境~設定群~obj$に対し，新たな`許可~key$を返す。
+<p>
+所与の
+( `生成元$, `生成元$ )
+に対し，新たな`許可~key$を返す。
+</p>
+
+<p class="trans-note">【
+2 個目の生成元には、
+通例的には，ある`環境~設定群~obj$の`~top-level生成元$enVが渡される。
+】</p>
 ◎
-Takes an environment settings object, and returns a new permission key.＼
+Takes an origin origin and an origin top level origin, and returns a new permission key.＼
 </dd>
 	<dd>
 未指定な場合の既定は、
@@ -2138,13 +2152,13 @@ <h2 title="Specifying a powerful feature">4. 強力な特能の指定-法</h2>
 `既定の許可~key生成~algo@
 は、
 所与の
-( `環境~設定群~obj$ %設定群 )
+( `生成元$ %生成元, `生成元$ %~top-level生成元 )
 に対し
 ⇒
-~RET %設定群 の`~top-level生成元$enV
+~RET %~top-level生成元
 ◎
-The default permission key generation algorithm, given an environment settings object settings, runs the following steps:
-• Return settings's top-level origin.
+The default permission key generation algorithm, given an origin origin and an origin top level origin, runs the following steps:
+• Return top level origin.
 </dd>
 	<dd class="note">注記（許可の委任）：
 ほとんどの`強力な特能$は、
@@ -2382,7 +2396,7 @@ <h2 title="Specifying a powerful feature">4. 強力な特能の指定-法</h2>
 <p>
 `既定の強力な特能@
 とは、
-`強力な特能$のうち，上の各種［
+`強力な特能$のうち，上に挙げた各種［
 型／~algo
 ］すべてが既定のそれらにされたものをいう。
 ◎
@@ -2494,9 +2508,9 @@ <h3 title="Reading the current permission state">5.1. 現在の許可~状態の
 • If document is not allowed to use feature, return "denied".
 </li>
 	<li>
-%~key ~LET %特能 の`許可~key生成~algo$( %記述子, %設定群 )
+%~key ~LET %特能 の`許可~key生成~algo$( %設定群 の`生成元$enV, %設定群 の`~top-level生成元$enV )
 ◎
-Let key be the result of generating a permission key for descriptor with settings.
+Let key be the result of generating a permission key for descriptor with settings's origin and settings's top-level origin.
 </li>
 	<li>
 %~entry ~LET `許可~store~entryを取得する$( %記述子, %~key )
@@ -2629,13 +2643,18 @@ <h3 title="Requesting permission to use a powerful feature">5.2. 強力な特能
 </div>
 	</li>
 	<li>
-%~key ~LET `許可~key生成~algo$( `現在の設定群~obj$ )
+%設定群 ~LET `現在の設定群~obj$
+◎
+Let settings be the current settings object.
+</li>
+	<li>
+%~key ~LET %特能 の`許可~key生成~algo$( %設定群 の`生成元$enV, %設定群 の`~top-level生成元$enV )
 ◎
-Let key be the result of generating a permission key with the current settings object.
+Let key be the result of generating a permission key for descriptor with settings's origin and settings's top-level origin.
 </li>
 	<li>
 <p>
-`~taskを~queueする$( 【`~task~source$が指定されていない（`許可~task~source$？）】, 次の手続き, `現在の設定群~obj$の`担当の~event~loop$enV )
+`~taskを~queueする$( 【`~task~source$が指定されていない（`許可~task~source$？）】, 次の手続き, %設定群 の`担当の~event~loop$enV )
 ◎
 Queue a task on the current settings object's responsible event loop to＼
 </p>
@@ -3347,52 +3366,82 @@ <h2 title="Automated testing">B. 自動化された~test法</h2>
 ⇒＃
 `PermissionDescriptor$I %記述子,
 `PermissionState$I %状態,
-`生成元$ %生成元 ~DF ~NULL,
+`許可~key$ %~key ~DF ~NULL,
 `~UA$ %~UA ~DF ε
 ◎終
 に対し：
 ◎
-To set a permission given a PermissionDescriptor descriptor, a PermissionState state, an optional origin, and an optional user agent:
+To set a permission given a PermissionDescriptor descriptor, a PermissionState state, an optional permission key key, and an optional user agent:
 </p>
 <ol>
 	<li>
-~IF［
-%生成元 ~EQ ~NULL
-］
-⇒
-%生成元 ~SET `現在の設定群~obj$の`生成元$enV
+%特能 ~LET %記述子 で`識別される特能$
 ◎
-Let target origin be current settings object's origin if origin is null, or origin otherwise.
-</li>
+↓</li>
 	<li>
-%~target群 ~LET ~AND↓ を満たす
-`環境~設定群~obj$たちが成す`~list$
-【順序は指定されていない】
+~IF［
+%~key ~EQ ~NULL
+］
 ⇒
-( その`生成元$enV, %生成元 )
-は`同一-生成元$である
+%~key ~SET %特能 の`許可~key生成~algo$( `現在の設定群~obj$の`生成元$enV, `現在の設定群~obj$の`~top-level生成元$enV )
 ◎
-Let targets be a list containing all environment settings objects whose origin is same origin with target origin,＼
+Let target key be the result of generating a permission key for descriptor with current settings object's origin and current settings object's top-level origin if key is null, or key otherwise.
 </li>
 	<li>
 <p>
-~IF［
-%~UA ~NEQ ε
-］
-⇒
-%~target群 から %~UA に属さないものを`除去する$
+%設定群~list ~LET %~UA に応じて［
+~NULL ならば すべての`環境~設定群~obj$／
+~ELSE_ %~UA に属する`環境~設定群~obj$
+］たちが成す`~list$
+◎
+Let settings list be a list containing all environment settings objects which belong to the user agent if provided, or all user agents otherwise.
 </p>
+
 <p class="trans-note">【
-この段の~logicは、
+順序は指定されていない。
+以下の~logicは、
 複数の`~UA$が`同時に稼働し得る＠https://github.com/w3c/permissions/pull/438$ことに基づく。
 例えば、［
 私的~閲覧~mode下で稼働するものと他のもの／
 異なる利用者~profileの下で稼働するものどうし
 ］は，異なる~UAであると見なされる。
 】</p>
+	</li>
+	<li>
+%~target群 ~LET 新たな`~list$
+◎
+Let targets be an empty list.
+</li>
+	<li>
+<p>
+%設定群~list を成す
+~EACH( %設定群 )
+に対し：
+◎
+For each environment settings object settings in settings list:
+</p>
+		<ol>
+			<li>
+%設定群~key ~LET %特能 の`許可~key生成~algo$( %設定群 の`生成元$enV, %設定群 の`~top-level生成元$enV )
+◎
+Let settings key be be the result of generating a permission key for descriptor with settings's origin and settings's top-level origin.
+</li>
+			<li>
+%合致したか ~LET %特能 の`許可~key比較~algo$( %設定群~key, %~key )
+◎
+Let matches be the result of running the permission key comparison algorithm for descriptor, given settings key and key.
+</li>
+			<li>
+~IF［
+%合致したか ~EQ ~T
+］
+⇒
+%~target群 に %設定群 を`付加する$
 ◎
-and which belong to the user agent if provided, or all user agents otherwise.
+If matches, then append settings to targets.
 </li>
+		</ol>
+	</li>
 	<li>
 %~task群 ~LET 新たな`~list$
 ◎
@@ -3421,7 +3470,9 @@ <h2 title="Automated testing">B. 自動化された~test法</h2>
 <div class="algo">
 手続きは
 ⇒
-%状態 を，この時点で次を呼出した結果であったかのように解釈する
+%状態 を［
+この時点で次を呼出した結果
+］であったかのように解釈する
 ⇒
 `現在の許可~状態を取得する$( %記述子, %~target )
 ◎
@@ -3718,6 +3769,7 @@ <h6 title="The permissions.setPermission Command">B.2.1.3.1. `permissions.setPer
   descriptor: permissions.PermissionDescriptor,
   state: permissions.PermissionState,
   origin: text,
+  ? topLevelOrigin: text,
   ? userContext: text,
 }
 </pre>
@@ -3787,7 +3839,11 @@ <h6 title="The permissions.setPermission Command">B.2.1.3.1. `permissions.setPer
 ◎
 ↓</li>
 	<li>
-%有型~記述子 ~LET `~IDL値に変換する$( %~parameter群, %許可~名 で`識別される特能$の`許可~記述子~型$ )
+%特能 ~LET %許可~名 で`識別される特能$
+◎
+↓</li>
+	<li>
+%有型~記述子 ~LET `~IDL値に変換する$( %~parameter群, %特能 の`許可~記述子~型$ )
 ⇒
 例外が投出されたときは
 ⇒
@@ -3799,6 +3855,19 @@ <h6 title="The permissions.setPermission Command">B.2.1.3.1. `permissions.setPer
 %生成元 ~LET %~command~parameter群 を成す `origin^c ~fieldの値
 ◎
 Let origin be the value of the origin field of command parameters.
+</li>
+	<li>
+%~top-level生成元 ~LET %~command~parameter群 を成す `topLevelOrigin^c ~fieldは［
+在るならば その値／
+無いならば %生成元
+］
+◎
+Let top level origin be the value of the topLevelOrigin field of command parameters, if present, and origin otherwise.
+</li>
+	<li>
+%~key ~LET %特能 の`許可~key生成~algo$( %生成元, %~top-level生成元 )
+◎
+Let key be the result of generating a permission key for descriptor with origin and top level origin.
 </li>
 	<li>
 <p>
@@ -3816,9 +3885,9 @@ <h6 title="The permissions.setPermission Command">B.2.1.3.1. `permissions.setPer
 】</p>
 	</li>
 	<li>
-`許可を設定する$( %有型~記述子, %状態, %生成元, %~UA )
+`許可を設定する$( %有型~記述子, %状態, %~key, %~UA )
 ◎
-Set a permission with typedDescriptor, state, and origin. 
+Set a permission with typedDescriptor, state, key, and user agent.
 </li>
 	<li>
 ~RET `成功$wdr( ~NULL )