README

This directory contains code that is shared between

• Browser Settings (chrome://settings)
• CrOS Settings (chrome://os-settings)

The pattern used here is referred to as "limited sharing" unlike the chrome://resources approach which is "unlimited sharing".

This approach has the following advantages over moving shared code under chrome://resources/:

• It allows a limited number of WebUI surfaces to use it, instead of exposing to all WebUI surfaces (hence the "limited sharing" name).
• It also allows leveraging $i18n{} C++ string replacements, which is not possible in cr_elements/ or cr_components/. WebUIs that use the shared code are still responsible for registering all necessary strings.

The "limited sharing" mechanism works as follows

• Code to be shared is built on its own, with a dedicated build_webui() target.
• The resulting grd file entries kSettingsSharedResources are included in the build once and registered at runtime under all WebUIDataSource instances that need to use this code.
• Shared code is exposed under /shared/settings/* URLs (same as chrome://settings/shared/settings/ or chrome://os-settings/shared/settings/ respectively).
• build_webui()'s ts_path_mappings and optimize_webui_external_paths parameters are leveraged so that the respective underlying tools (TS compiler and Rollup) can correctly resolve such paths.

A similar approach is also followed in c/b/r/side_panel/shared.

Note: The files in this folder are only added as standalone files to the build when optimize_webui=false. In other cases the same files are already bundled within the UIs that use them and therefore adding them as standalone files is unnecessary.