Files
NetMesh/electron/bridges/windowManager/windowsWindowChrome.cjs

57 lines
1.9 KiB
JavaScript
Raw Normal View History

/**
* Windows frameless window chrome helpers.
*
* Background (#2505):
* - Frameless Win11 windows need an explicit `roundedCorners: true` so DWM
* applies the system round clip (Electron 34+).
* - Transparent tray popups that keep the default opaque white backdrop + CSS
* `border-radius` produce square tips under a rounded panel.
*
* Approach:
* - App content windows (resizable): solid host + native `roundedCorners`.
* Do NOT set `transparent: true` here - Electron documents transparent
* windows as not resizable, and `resizable: true` can break them
* (https://www.electronjs.org/docs/latest/tutorial/custom-window-styles).
* - Tray / CSS-shaped popovers (`resizable: false`): transparent host + clear
* backdrop + `roundedCorners: false` so only the CSS radius defines the
* silhouette (Electron #46468: Win11 otherwise forces OS rounding on
* transparent windows).
*/
const CLEAR_BACKGROUND = "#00000000";
function isWindowsPlatform(platform = process.platform) {
return platform === "win32";
}
/**
* Options for full-bleed app windows (main / settings / terminal popup).
* Safe to spread on non-Windows - returns an empty object.
*/
function windowsFramelessContentChromeOptions(platform = process.platform) {
if (!isWindowsPlatform(platform)) return {};
return {
roundedCorners: true,
};
}
/**
* Options for CSS-rounded overlay windows (tray panel).
* Always apply when creating those windows; callers already opt into transparency.
*/
function windowsCssRoundedOverlayChromeOptions(platform = process.platform) {
return {
transparent: true,
backgroundColor: CLEAR_BACKGROUND,
// Overlay shape comes from CSS; keep OS rounding off on Win11.
...(isWindowsPlatform(platform) ? { roundedCorners: false } : {}),
};
}
module.exports = {
CLEAR_BACKGROUND,
isWindowsPlatform,
windowsFramelessContentChromeOptions,
windowsCssRoundedOverlayChromeOptions,
};