feat(manifests)!: add top-level manifests folder + move Web App Manifest (#26109)

queengooborg · caugner · web-flow · commit 248a906fe6c0 · 2025-03-25T14:46:04.000+01:00
Introduces a top-level `manifests/` folder, which will eventually store more manifest types.

For now, it only holds the `webapp` manifests, which were moved from `html.manifest`.

---------

Co-authored-by: Claas Augner &lt;caugner@mozilla.com&gt;
diff --git a/.github/issue-regex-labeler.yml b/.github/issue-regex-labeler.yml
@@ -13,6 +13,9 @@ data:http:
 data:js:
   - 'js\.'
   - '\/docs\/Web\/JavaScript'
+data:manifests:
+  - 'manifests\.'
+  - '\/docs\/Web\/Progressive_web_apps\/Manifest'
 data:mathml:
   - 'mathml\.'
   - '\/docs\/Web\/MathML'
diff --git a/.github/labeler.yml b/.github/labeler.yml
@@ -28,6 +28,10 @@ data:js:
   - changed-files:
       - any-glob-to-any-file:
           - "javascript/**"
+data:manifests:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "manifests/**"
 data:mathml:
   - changed-files:
       - any-glob-to-any-file:
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -16,6 +16,7 @@
         "/html/*.json",
         "/http/*.json",
         "/javascript/*.json",
+        "/manifests/*.json",
         "/mathml/*.json",
         "/svg/*.json",
         "/webdriver/*.json",
diff --git a/.vscode/snippets.code-snippets b/.vscode/snippets.code-snippets
@@ -4,7 +4,7 @@
     "prefix": ["bcd", "browser-compat"],
     "body": [
       "{",
-      "  \"${1|api,css,html,http,javascript,mathml,svg,webdriver,webextensions|}\": {",
+      "  \"${1|api,css,html,http,javascript,manifests,mathml,svg,webassembly,webdriver,webextensions|}\": {",
       "    \"${2:${TM_FILENAME_BASE}}\": {",
       "      \"__compat\": {",
       "        \"mdn_url\": \"${3:mdn-url}\",",
diff --git a/README.md b/README.md
@@ -148,7 +148,6 @@ Data for [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML) features, inc
 
 - `elements` - Elements
 - `global_attributes` - Global attributes
-- `manifest` - Web App manifest keys
 
 ### [`http`](http)
 
@@ -169,6 +168,10 @@ Data for JavaScript language features, including:
 - `operators` - Mathematical and logical operators
 - `statements` - Language statements and expressions
 
+### [`manifests`](./manifests)
+
+- `webapp` - Web App manifest keys
+
 ### [`mathml`](./mathml)
 
 Data for [MathML](https://developer.mozilla.org/en-US/docs/Web/MathML) features, including:
diff --git a/manifests/webapp/background_color.json b/manifests/webapp/background_color.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "background_color": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/background_color",
diff --git a/manifests/webapp/description.json b/manifests/webapp/description.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "description": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/description",
diff --git a/manifests/webapp/display.json b/manifests/webapp/display.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "display": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/display",
diff --git a/manifests/webapp/display_override.json b/manifests/webapp/display_override.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "display_override": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/display_override",
diff --git a/manifests/webapp/file_handlers.json b/manifests/webapp/file_handlers.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "file_handlers": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/file_handlers",
diff --git a/manifests/webapp/icons.json b/manifests/webapp/icons.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "icons": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/icons",
diff --git a/manifests/webapp/id.json b/manifests/webapp/id.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "id": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/id",
diff --git a/manifests/webapp/launch_handler.json b/manifests/webapp/launch_handler.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "launch_handler": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/launch_handler",
diff --git a/manifests/webapp/name.json b/manifests/webapp/name.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "name": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/name",
diff --git a/manifests/webapp/note_taking.json b/manifests/webapp/note_taking.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "note_taking": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/note_taking",
diff --git a/manifests/webapp/orientation.json b/manifests/webapp/orientation.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "orientation": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/orientation",
diff --git a/manifests/webapp/prefer_related_applications.json b/manifests/webapp/prefer_related_applications.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "prefer_related_applications": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/prefer_related_applications",
diff --git a/manifests/webapp/protocol_handlers.json b/manifests/webapp/protocol_handlers.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "protocol_handlers": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
diff --git a/manifests/webapp/related_applications.json b/manifests/webapp/related_applications.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "related_applications": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/related_applications",
diff --git a/manifests/webapp/scope.json b/manifests/webapp/scope.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "scope": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/scope",
diff --git a/manifests/webapp/serviceworker.json b/manifests/webapp/serviceworker.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "serviceworker": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/serviceworker",
diff --git a/manifests/webapp/share_target.json b/manifests/webapp/share_target.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "share_target": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/share_target",
diff --git a/manifests/webapp/short_name.json b/manifests/webapp/short_name.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "short_name": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/short_name",
diff --git a/manifests/webapp/shortcuts.json b/manifests/webapp/shortcuts.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "shortcuts": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/shortcuts",
diff --git a/manifests/webapp/start_url.json b/manifests/webapp/start_url.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "start_url": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/start_url",
diff --git a/manifests/webapp/theme_color.json b/manifests/webapp/theme_color.json
@@ -1,6 +1,6 @@
 {
-  "html": {
-    "manifest": {
+  "manifests": {
+    "webapp": {
       "theme_color": {
         "__compat": {
           "mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/theme_color",
diff --git a/schemas/compat-data-schema.md b/schemas/compat-data-schema.md
@@ -18,6 +18,8 @@ Compatibility data is organized in top-level directories for each broad area cov
 
 - [javascript/](../javascript) contains data for [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript) built-in Objects, statement, operators, and other ECMAScript language features.
 
+- [manifests/](../manifests) contains data for various manifests, such as the [Web Application Manifest](https://developer.mozilla.org/docs/Web/Progressive_web_apps/manifest).
+
 - [mathml/](../mathml) contains data for [MathML](https://developer.mozilla.org/docs/Web/MathML) elements, attributes, and global attributes.
 
 - [svg/](../svg) contains data for [SVG](https://developer.mozilla.org/en-US/docs/Web/SVG) elements, attributes, and global attributes.
diff --git a/scripts/generate-types.ts b/scripts/generate-types.ts
@@ -34,6 +34,8 @@ const compatDataTypes = {
   http: 'Contains data for [HTTP](https://developer.mozilla.org/docs/Web/HTTP) headers, statuses, and methods.',
   javascript:
     'Contains data for [JavaScript](https://developer.mozilla.org/docs/Web/JavaScript) built-in Objects, statement, operators, and other ECMAScript language features.',
+  manifests:
+    'Contains data for various manifests, such as the [Web Application Manifest](https://developer.mozilla.org/docs/Web/Progressive_web_apps/manifest).',
   mathml:
     'Contains data for [MathML](https://developer.mozilla.org/docs/Web/MathML) elements, attributes, and global attributes.',
   svg: 'Contains data for [SVG](https://developer.mozilla.org/docs/Web/SVG) elements, attributes, and global attributes.',
diff --git a/scripts/lib/data-folders.ts b/scripts/lib/data-folders.ts
@@ -7,6 +7,7 @@ export const dataFoldersMinusBrowsers = [
   'html',
   'http',
   'javascript',
+  'manifests',
   'mathml',
   'svg',
   'webassembly',

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`		`- "html": {`
`3`		`- "manifest": {`
	`2`	`+ "manifests": {`
	`3`	`+ "webapp": {`
`4`	`4`	`"background_color": {`
`5`	`5`	`"__compat": {`
`6`	`6`	`"mdn_url": "https://developer.mozilla.org/docs/Web/Progressive_web_apps/Manifest/Reference/background_color",`