Add Permissions types

baselines/dom.generated.d.ts

@@ -334,6 +334,11 @@ interface DeviceOrientationEventInit extends EventInit {
     gamma?: number | null;
 }
 
+interface DevicePermissionDescriptor extends PermissionDescriptor {
+    deviceId?: string;
+    name: "camera" | "microphone" | "speaker";
+}
+
 interface DeviceRotationRateDict {
     alpha?: number | null;
     beta?: number | null;
@@ -738,6 +743,11 @@ interface MessageEventInit extends EventInit {
     source?: MessageEventSource | null;
 }
 
+interface MidiPermissionDescriptor extends PermissionDescriptor {
+    name: "midi";
+    sysex?: boolean;
+}
+
 interface MouseEventInit extends EventModifierInit {
     button?: number;
     buttons?: number;
@@ -911,6 +921,10 @@ interface PeriodicWaveOptions extends PeriodicWaveConstraints {
     real?: number[] | Float32Array;
 }
 
+interface PermissionDescriptor {
+    name: PermissionName;
+}
+
 interface PipeOptions {
     preventAbort?: boolean;
     preventCancel?: boolean;
@@ -958,6 +972,11 @@ interface PropertyIndexedKeyframes {
     [property: string]: string | string[] | number | null | (number | null)[] | undefined;
 }
 
+interface PushPermissionDescriptor extends PermissionDescriptor {
+    name: "push";
+    userVisibleOnly?: boolean;
+}
+
 interface PushSubscriptionJSON {
     endpoint?: string;
     expirationTime?: number | null;
@@ -10504,6 +10523,7 @@ interface Navigator extends NavigatorID, NavigatorOnLine, NavigatorContentUtils,
     readonly msManipulationViewsEnabled: boolean;
     readonly msMaxTouchPoints: number;
     readonly msPointerEnabled: boolean;
+    readonly permissions: Permissions;
     readonly plugins: PluginArray;
     readonly pointerEnabled: boolean;
     readonly serviceWorker: ServiceWorkerContainer;
@@ -11368,6 +11388,33 @@ declare var PermissionRequestedEvent: {
     new(): PermissionRequestedEvent;
 };
 
+interface PermissionStatusEventMap {
+    "change": Event;
+}
+
+interface PermissionStatus extends EventTarget {
+    onchange: ((this: PermissionStatus, ev: Event) => any) | null;
+    readonly state: PermissionState;
+    addEventListener<K extends keyof PermissionStatusEventMap>(type: K, listener: (this: PermissionStatus, ev: PermissionStatusEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof PermissionStatusEventMap>(type: K, listener: (this: PermissionStatus, ev: PermissionStatusEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+
+declare var PermissionStatus: {
+    prototype: PermissionStatus;
+    new(): PermissionStatus;
+};
+
+interface Permissions {
+    query(permissionDesc: PermissionDescriptor | DevicePermissionDescriptor | MidiPermissionDescriptor | PushPermissionDescriptor): Promise<PermissionStatus>;
+}
+
+declare var Permissions: {
+    prototype: Permissions;
+    new(): Permissions;
+};
+
 /** Provides information about a browser plugin. */
 interface Plugin {
     readonly description: string;
@@ -18486,6 +18533,8 @@ type OverSampleType = "none" | "2x" | "4x";
 type PanningModelType = "equalpower" | "HRTF";
 type PaymentComplete = "success" | "fail" | "unknown";
 type PaymentShippingType = "shipping" | "delivery" | "pickup";
+type PermissionName = "geolocation" | "notifications" | "push" | "midi" | "camera" | "microphone" | "speaker" | "device-info" | "background-sync" | "bluetooth" | "persistent-storage" | "ambient-light-sensor" | "accelerometer" | "gyroscope" | "magnetometer" | "clipboard";
+type PermissionState = "granted" | "denied" | "prompt";
 type PlaybackDirection = "normal" | "reverse" | "alternate" | "alternate-reverse";
 type PositionAlignSetting = "line-left" | "center" | "line-right" | "auto";
 type PushEncryptionKeyName = "p256dh" | "auth";

baselines/webworker.generated.d.ts

@@ -120,6 +120,11 @@ interface DOMRectInit {
     y?: number;
 }
 
+interface DevicePermissionDescriptor extends PermissionDescriptor {
+    deviceId?: string;
+    name: "camera" | "microphone" | "speaker";
+}
+
 interface EcKeyGenParams extends Algorithm {
     namedCurve: NamedCurve;
 }
@@ -243,6 +248,11 @@ interface MessageEventInit extends EventInit {
     source?: MessageEventSource | null;
 }
 
+interface MidiPermissionDescriptor extends PermissionDescriptor {
+    name: "midi";
+    sysex?: boolean;
+}
+
 interface NavigationPreloadState {
     enabled?: boolean;
     headerValue?: string;
@@ -287,6 +297,10 @@ interface PerformanceObserverInit {
     entryTypes: string[];
 }
 
+interface PermissionDescriptor {
+    name: PermissionName;
+}
+
 interface PipeOptions {
     preventAbort?: boolean;
     preventCancel?: boolean;
@@ -308,6 +322,11 @@ interface PushEventInit extends ExtendableEventInit {
     data?: PushMessageDataInit;
 }
 
+interface PushPermissionDescriptor extends PermissionDescriptor {
+    name: "push";
+    userVisibleOnly?: boolean;
+}
+
 interface PushSubscriptionChangeInit extends ExtendableEventInit {
     newSubscription?: PushSubscription;
     oldSubscription?: PushSubscription;
@@ -2332,6 +2351,33 @@ declare var PerformanceResourceTiming: {
     new(): PerformanceResourceTiming;
 };
 
+interface PermissionStatusEventMap {
+    "change": Event;
+}
+
+interface PermissionStatus extends EventTarget {
+    onchange: ((this: PermissionStatus, ev: Event) => any) | null;
+    readonly state: PermissionState;
+    addEventListener<K extends keyof PermissionStatusEventMap>(type: K, listener: (this: PermissionStatus, ev: PermissionStatusEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof PermissionStatusEventMap>(type: K, listener: (this: PermissionStatus, ev: PermissionStatusEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+
+declare var PermissionStatus: {
+    prototype: PermissionStatus;
+    new(): PermissionStatus;
+};
+
+interface Permissions {
+    query(permissionDesc: PermissionDescriptor | DevicePermissionDescriptor | MidiPermissionDescriptor | PushPermissionDescriptor): Promise<PermissionStatus>;
+}
+
+declare var Permissions: {
+    prototype: Permissions;
+    new(): Permissions;
+};
+
 /** Events measuring progress of an underlying process, like an HTTP request (for an XMLHttpRequest, or the loading of the underlying resource of an <img>, <audio>, <video>, <style> or <link>). */
 interface ProgressEvent extends Event {
     readonly lengthComputable: boolean;
@@ -4078,6 +4124,7 @@ declare var WorkerLocation: {
 
 /** A subset of the Navigator interface allowed to be accessed from a Worker. Such an object is initialized for each worker and is available via the WorkerGlobalScope.navigator property obtained by calling window.self.navigator. */
 interface WorkerNavigator extends NavigatorID, NavigatorOnLine, NavigatorBeacon, NavigatorConcurrentHardware, NavigatorStorage {
+    readonly permissions: Permissions;
     readonly serviceWorker: ServiceWorkerContainer;
 }
 
@@ -4509,6 +4556,8 @@ type KeyType = "public" | "private" | "secret";
 type KeyUsage = "encrypt" | "decrypt" | "sign" | "verify" | "deriveKey" | "deriveBits" | "wrapKey" | "unwrapKey";
 type NotificationDirection = "auto" | "ltr" | "rtl";
 type NotificationPermission = "default" | "denied" | "granted";
+type PermissionName = "geolocation" | "notifications" | "push" | "midi" | "camera" | "microphone" | "speaker" | "device-info" | "background-sync" | "bluetooth" | "persistent-storage" | "ambient-light-sensor" | "accelerometer" | "gyroscope" | "magnetometer" | "clipboard";
+type PermissionState = "granted" | "denied" | "prompt";
 type PushEncryptionKeyName = "p256dh" | "auth";
 type PushPermissionState = "denied" | "granted" | "prompt";
 type ReferrerPolicy = "" | "no-referrer" | "no-referrer-when-downgrade" | "same-origin" | "origin" | "strict-origin" | "origin-when-cross-origin" | "strict-origin-when-cross-origin" | "unsafe-url";

inputfiles/idl/Permissions.widl

@@ -0,0 +1,61 @@
+dictionary PermissionDescriptor {
+  required PermissionName name;
+};
+
+enum PermissionState {
+  "granted",
+  "denied",
+  "prompt",
+};
+
+[Exposed=(Window,Worker)]
+interface PermissionStatus : EventTarget {
+  readonly attribute PermissionState state;
+  attribute EventHandler onchange;
+};
+
+[Exposed=(Window)]
+partial interface Navigator {
+  readonly attribute Permissions permissions;
+};
+
+[Exposed=(Worker)]
+partial interface WorkerNavigator {
+  readonly attribute Permissions permissions;
+};
+
+[Exposed=(Window,Worker)]
+interface Permissions {
+  Promise<PermissionStatus> query(object permissionDesc);
+};
+
+enum PermissionName {
+  "geolocation",
+  "notifications",
+  "push",
+  "midi",
+  "camera",
+  "microphone",
+  "speaker",
+  "device-info",
+  "background-sync",
+  "bluetooth",
+  "persistent-storage",
+  "ambient-light-sensor",
+  "accelerometer",
+  "gyroscope",
+  "magnetometer",
+  "clipboard",
+};
+
+dictionary PushPermissionDescriptor : PermissionDescriptor {
+  boolean userVisibleOnly = false;
+};
+
+dictionary MidiPermissionDescriptor : PermissionDescriptor {
+  boolean sysex = false;
+};
+
+dictionary DevicePermissionDescriptor : PermissionDescriptor {
+  DOMString deviceId;
+};

inputfiles/idlSources.json

@@ -234,6 +234,10 @@
         "url": "https://w3c.github.io/performance-timeline/",
         "title": "Performance Timeline"
     },
+    {
+        "url": "https://www.w3.org/TR/permissions/",
+        "title": "Permissions"
+    },
     {
         "url": "https://www.w3.org/TR/pointerevents2/",
         "title": "Pointer Events"

inputfiles/knownTypes.json

@@ -21,6 +21,7 @@
         "ConstrainDouble",
         "ConstrainLong",
         "ConstrainVideoFacingModeParameters",
+        "DevicePermissionDescriptor",
         "DisplayCaptureSurfaceType",
         "EcKeyAlgorithm",
         "EcKeyGenParams",
@@ -41,10 +42,14 @@
         "KeyType",
         "KeyUsage",
         "Keyframe",
+        "MidiPermissionDescriptor",
         "MutationRecordType",
         "NamedCurve",
         "Pbkdf2Params",
+        "PermissionDescriptor",
+        "PermissionName",
         "PropertyIndexedKeyframes",
+        "PushPermissionDescriptor",
         "RTCAnswerOptions",
         "RTCCertificateExpiration",
         "RTCDtlsParameters",
@@ -94,6 +99,7 @@
         "BigInteger",
         "ClientTypes",
         "CryptoKeyPair",
+        "DevicePermissionDescriptor",
         "EcdhKeyDeriveParams",
         "EcdsaParams",
         "EcKeyGenParams",
@@ -103,8 +109,12 @@
         "HmacKeyGenParams",
         "IDBArrayKey",
         "IDBValidKey",
+        "MidiPermissionDescriptor",
         "NamedCurve",
         "Pbkdf2Params",
+        "PermissionDescriptor",
+        "PermissionName",
+        "PushPermissionDescriptor",
         "RsaHashedImportParams",
         "RsaHashedKeyGenParams",
         "RsaKeyGenParams",

inputfiles/overridingTypes.json

@@ -2749,6 +2749,17 @@
                         }
                     }
                 }
+            },
+            "Permissions": {
+                "methods": {
+                    "method": {
+                        "query": {
+                            "override-signatures": [
+                                "query(permissionDesc: PermissionDescriptor | DevicePermissionDescriptor | MidiPermissionDescriptor | PushPermissionDescriptor): Promise<PermissionStatus>"
+                            ]
+                        }
+                    }
+                }
             }
         }
     },
@@ -3093,6 +3104,39 @@
                     }
                 }
             },
+            "DevicePermissionDescriptor": {
+                "members": {
+                    "member": {
+                        "name": {
+                            "name": "name",
+                            "required": 1,
+                            "override-type": "\"camera\" | \"microphone\" | \"speaker\""
+                        }
+                    }
+                }
+            },
+            "MidiPermissionDescriptor": {
+                "members": {
+                    "member": {
+                        "name": {
+                            "name": "name",
+                            "required": 1,
+                            "override-type": "\"midi\""
+                        }
+                    }
+                }
+            },
+            "PushPermissionDescriptor": {
+                "members": {
+                    "member": {
+                        "name": {
+                            "name": "name",
+                            "required": 1,
+                            "override-type": "\"push\""
+                        }
+                    }
+                }
+            },
             "ModuleExportDescriptor": {
                 "legacy-namespace": "WebAssembly"
             },

src/idlfetcher.ts

@@ -15,7 +15,8 @@ interface IDLSource {
 const idlSelector = [
     "pre.idl:not(.extract):not(.example)", // bikeshed and ReSpec
     "pre.code code.idl-code", // Web Cryptography
-    "pre:not(.extract) code.idl" // HTML
+    "pre:not(.extract) code.idl", // HTML
+    "#permission-registry + pre.highlight" // Permissions
 ].join(",");
 
 const cssPropSelector = "dfn.css[data-dfn-type=property]";