manifest-types.ts

The current types in manifest-types.ts are out of date in places and incorrect in places. This PR resolves the known issues.

file_handlers

The file_handlers array should contain objects with an accept object not an accept array.

See:

• https://developer.mozilla.org/en-US/docs/Web/Manifest/file_handlers
• https://wicg.github.io/manifest-incubations/#accept-member

icons and shortcuts.icons

The icon.purpose badge value was replaced by monochrome and no longer exists in the specification.

See:

• https://developer.mozilla.org/en-US/docs/Web/Manifest/icons
• BREAKING CHANGE: Replace "badge" with "monochrome" w3c/manifest#833
• https://www.w3.org/TR/appmanifest/#:~:text=BREAKING%20CHANGE%3A%20Replace%20%22badge%22%20with%20%22monochrome%22

launch_handler

The launch_handler object currently supports one value client_mode that is a string or array of strings.
The strings have to be one of the defined values.

I'm curious where the platform and url values came from. I could not find those values in any documentation new or old.

See:

• https://developer.mozilla.org/en-US/docs/Web/Manifest/launch_handler
• https://wicg.github.io/web-app-launch/#launch_handler-member
• https://wicg.github.io/web-app-launch/#client_mode-member

protocol_handlers

The protocol_handlers object does not support a title value.

I could not find any old or new documentation showing the title value.

See:

• https://developer.mozilla.org/en-US/docs/Web/Manifest/protocol_handlers
• https://wicg.github.io/manifest-incubations/#protocol-handler-items

screenshots

The screenshots object supports form_factor, label, and platform in addition to the other image related values.
The form_factor value has to be either narrow or wide if specified.
The platform value, if specified, has to be one of the defined values.

See:

• https://developer.mozilla.org/en-US/docs/Web/Manifest/screenshots
• https://w3c.github.io/manifest-app-info/#screenshot-object-and-its-members

serviceworker

This member was removed from the specification.

See:

• BREAKING CHANGE: remove serviceworker member w3c/manifest#825
• https://www.w3.org/TR/appmanifest/#:~:text=BREAKING%20CHANGE%3A%20remove%20serviceworker%20member
• https://developer.mozilla.org/en-US/docs/Web/Manifest/serviceworker#specifications

share_target

The share_target.params had the values name, value, and required. I could not find any old or new documentation showing these values.
The share_target had the values url, title, text, and files as direct values. These values should be, instead, values of share_target.params.

The action and params members are required.

The method string is case insensitive. (See bullet point 2. at https://w3c.github.io/web-share-target/level-2/#share_target-member). For practical reasons the type includes all caps and all lower variants.

The enctype must be application/x-www-form-urlencoded or multipart/form-data. Previously text/plain was included as a valid value but it is not. (See various places where it lists the valid values at https://w3c.github.io/web-share-target/level-2/#share_target-member)

The share_target.params value should be an object not an array of objects.

The share_target.params.files value should accept a single file or an array of files. (See bullet point 5. for single file and bullet point 6. for array of files at https://w3c.github.io/web-share-target/level-2/#share_target-member)

The share_target.params.files.accept value should accept a string or array of strings. (See bullet point 7. 2. for string and bullet point 7. 3. for array of strings at https://w3c.github.io/web-share-target/level-2/#share_target-member)

See:

• https://developer.mozilla.org/en-US/docs/Web/Manifest/share_target
• https://w3c.github.io/web-share-target/level-2/#share_target-member
• https://w3c.github.io/web-share-target/level-2/#sharetarget-and-its-members
• https://w3c.github.io/web-share-target/level-2/#dom-sharetargetparams