macos: set main window in addition to key

If we are showing the window, we might also want to make it the main
window for the application when shown.

macos: make transient-for key window when hiding surface

This only handled the popover case before and not the transient-for case.

macos: actually drop unnecessary momentum events

These would get passed along to the NSApplication which we don't really
need to have happen. Denote it as such.

macos: queue all pending events

Rather than process these a single event at a time, queue all of the
outstanding events from the NSEvent queue.

macos: drop enter/exit when in manual drag/resize

If we are in a manual resize/drag then we don't want to generate crossing
events as they can just confuse things.

macos: allow dropping NSEvent without propagation

There are cases we might want to consume a NSEvent without creating a
GdkEvent or passing it along to the NSApplication for processing. This
creates a new value we can use and check against to propagate that without
having to do out parameters at the slightly odd invalid pointer value for
a GdkEvent (similar to how MMAP_FAILED is done).

macos: do not focus new window when resigning main

This can get in the way of how we track changes while events are actively
processing. Instead, we may want to delay this until the next main loop
idle and then check to see if we have a main window as the NSNotification
may have come in right after this.

Update Finnish translation

(cherry picked from commit d188c6dbaf4c2d55a53379bc6aafa091913480c9)

Merge branch 'fix_gtk_accessible_update_relation_example' into 'main'

fix docs for gtk_accessible_update_relation example

See merge request GNOME/gtk!4559

Fixed Czech translation

fix docs for gtk_accessible_update_relation example

Update Swedish translation

(cherry picked from commit 9053fd8335ff5bd8a94171b791a70347ebc232e9)

Merge branch 'fix-focus-issues' into 'main'

Fix some focus issues

See merge request GNOME/gtk!4556

Update Persian translation

(cherry picked from commit a9720259f00de1ff9ab99b60627af34c0bbe5c90)

text: Stop blinking when we lose focus

We were looking at GtkWidget:has-focus from
event controller signal handlers here, but
the widget property is only changed after
the event controllers.

focus controller: Update for active window

When the window gains or looses active status,
update the focus controllers status.

window: Update has-focus property

Update the :has-focus property of the focus
widget when the active status of the window
changes.

We change the property after generating the
GDK_CROSSING_ACTIVE crossing events.

Updated Danish translation

Updated Danish translation of gtk-properties

Updated Lithuanian translation

Merge branch 'gdk-tests-naming' into 'main'

Use the correct name for installed gdk tests

See merge request GNOME/gtk!4555

Use the correct name for installed gdk tests

Update Swedish translation

(cherry picked from commit 89bba41fd75346aaee5037db7275cfe3c1925fa0)

Merge branch 'wip/chergert/for-main' into 'main'

macos: fixes for main

See merge request GNOME/gtk!4553

macos: fix cursor blink time

The value from settings is for the duration of the blink period, not the
timeout. This fixes the blink lasting longer than 10 seconds.

macos: require input region to become key

Some things cannot become key windows (like tooltips). We can use the
input_region existence to determine if we should allow it as a key window.

Merge branch 'fix-doc-typo' into 'main'

Fix a documentation typo

Closes #4747

See merge request GNOME/gtk!4552

Fix a documentation typo

It is XDG_DATA_HOME.

Fixes: #4747

Update Catalan translation

(cherry picked from commit 2be2912e431b6fffdbbccef765c6540537500f9b)

Update Korean translation

Update Korean translation

(cherry picked from commit 2755ad19be279ddced4a220f52a09d40d844dc91)

Merge branch 'fixup-shadernode-constructor' into 'main'

Fix up preconditions of gsk_gl_shader_node_new

Closes #4739

See merge request GNOME/gtk!4551

Fix up preconditions of gsk_gl_shader_node_new

These were not quite right, and implied that args
may be NULL, when it really can't.

Fixes: #4739

Merge branch 'center-layout-setters' into 'main'

gtk: Have GtkCenterLayout hold a reference to its widgets

See merge request GNOME/gtk!4544

gtk: Have GtkCenterLayout hold a reference to its widgets

Merge branch 'wip/chergert/KHR_swap_buffers_with_damage' into 'main'

gdk: use EGL_KHR_swap_buffers_with_damage

See merge request GNOME/gtk!4548

Merge branch 'bilelmoussaoui/docs' into 'main'

headerbar: Fix docs

See merge request GNOME/gtk!4545

Update Korean translation

(cherry picked from commit 156f99560d2687c938d1266ad34bc91a9549081e)

gdk: use EGL_KHR_swap_buffers_with_damage

It appears that NVIDIA does not implement EGL_EXT_swap_buffers_with_damage
on their EGL implementation, but does implement the KHR variant of it.
This checks for a suitable implementation and stores a pointer to the
compatible implementation within the GdkGLContextPrivate struct.

headerbar: Fix docs

Merge branch 'wip/chergert/for-main' into 'main'

macos: various fixes

See merge request GNOME/gtk!4543

Merge branch 'xdg-activation-no-surface' into 'main'

wayland: xdg-activation: Don't assume there's a focus surface

See merge request GNOME/gtk!4366

macos: clear window stack before requesting motion

We want to ensure that we recalculate the sort order of windows before
processing the motion. Generally this would be done in response from the
display server in GdkMacosWindow, but I've seen it possible to race there.

macos: invalidate surface contents when mapping

macos: move children when monitor changes

We can rely on other code to move monitors, but specifically with children
we want to try harder to move them as a group and keep positioning in tact.

macos: make move_resize possibly idempotent

We need to handle the case where we might be racing against an incoming
configure event due to how notifications are queued from the display
server. Rather than calling configure (and possibly causing other things
to move around) this just queries the display server directly for the
coordinates that we care about.

Additionally, we can display:NO as we are in control of all the display
process now using CALayer.

macos: handle transient-for from configure

We failed to handle the toplevel with transient-for case here which could
cause our X/Y calculations to be off in other areas such as best monitor
detection.

macos: use parent frame clock again

We do actually need the parent frame clock here because it is the way we
ensure that we get layout called for our popup surfaces at the same time
as the parent surface.

macos: reduce chances for layout cycles

We need to be more careful about when we request a layout because it can
cause us to get into a layout cycle at maximum frame rate.

macos: improve initial placement of toplevels with parent

This doesn't appear to happen much, but if it does it is nice to setup
the window placement initially. Generally, transient-for is set after
the creation of the toplevel rather than here.

macos: leave a note about monitor configuration

It can be helpful to see what the range of monitor values is when emulating
the GDK coordinate system.

macos: use GdkMacosBuffer for storing damage region

The GdkMacosBuffer object already has storage for tracking the damage
region as it is used in GdkMacosCairoContext to manually copy regions from
the front buffer to the back buffer. This makes the GdkMacosGLContext also
use that field so that we can easily drop old damage regions when the
buffer is lost. This happens during resizes, monitor changes, etc.

macos: add clamp helper to keep rectangle in workarea

This helper is useful to ensure we are consistent with how we keep a
window clamped to the workarea of a monitor when placing windows on
screen. (This does not affect snap-to-edges).

macos: style cleanup

macos: add re-entrancy check when monitors change

macos: check for best_monitor before using

Make sure we have a monitor to enqueue/dequeue from before using it. That
also allows us to use this from destroy and what-not.

Update Croatian translation

(cherry picked from commit 4eee322654907f2f16c2b36bbd7aa47e36a0462f)

Update Croatian translation

(cherry picked from commit 67ae05d85598f5ba7dcdd8da3420c41d7347b158)

Merge branch 'wip/carlosg/focus-request-over-xdg-activation' into 'main'

wayland: Use xdg-activation for non-startup initiated focus requests

See merge request GNOME/gtk!4535

Updated Czech translation

wayland: Use xdg-activation for non-startup initiated focus requests

Currently, we have all the plumbing in place so that GTK consumes the
startup notification ID when focusing a window through the xdg-activation
protocol.

This however misses the case that a window might be requested to be
focused with no startup ID (i.e. via interaction with the application,
not through GApplication or other application launching logic).

In this case, we let the application create a token that will be
consumed by itself. The serial used is that from the last
interaction, so the compositor will still be able to do focus prevention
logic if it applies.

Since we already do have a last serial at hand, prefer xdg-activation
all the way over the now stale gtk-shell focusing support. The timestamp
argument becomes unused, but that is a weak argument to prefer the
private protocol over the standard one. The gtk-shell protocol support
is so far left for interaction with older Mutter.

Merge branch 'wip/chergert/for-main' into 'main'

macos: various fixes and multi-monitor frame clocks

Closes #4736, #4735, #4732, #4733, and #4734

See merge request GNOME/gtk!4533

Merge branch 'wip/carlosg/scrolledwindow-warning' into 'main'

gtkscrolledwindow: Do not try to doubly trigger deceleration

Closes #4730

See merge request GNOME/gtk!4536

macos: avoid size/origin changes when possible

If _gdk_macos_surface_move_resize() was called with various -1 parameters
we really want to avoid changing anything even if we think we know what
the value might be. Otherwise, we risk messing up in-flight operations that
we have not yet been notified of yet.

This improves the chances we place windows in an appropriate location as
they don't et screwed up before window-manager placement.

macos: start application in foreground

We need to bring the application to the foreground in multiple ways, and
this call to [NSApp activateIgnoringOtherApps:YES] ensures that we become
foreground before the first window is opened. Otherwise we end up starting
applications in the background.

Fixes #4736

macos: add GDK_NOTE when surface changes monitor

macos: add GDK_NOTE for surface sizing and placement

This can be useful to debug sizing issues with the surface as well as the
"window manager" placement code.

macos: leave note about monitor discovery

macos: external access to display name helpers

These can be handy to print debug information when we don't have a
GdkMacosMonitor to work with.

macos: fix redisplay of GdkPopup

This broke recently during the configure cleanups and also needed to have
the tail directions fixed again.

macos: fix cairo renderer with double buffering

If we are double buffering surfaces with IOSurface then we need to copy
the area that was damaged in the previous frame to the back buffer. This
can be done with IOSurface but we need to hold the read-only lock so that
we don't cause the underlying IOSurface contents to be invalidated.

Additionally, since this is only used in the context of rendering to a
GdkMacosSurface, we know the life-time of the cairo_surface_t and can
simply lock/unlock the IOSurface buffer from begin_frame/end_frame to have
the buffer flushing semantics we want.

To ensure that we don't over damage, we store the damage in begin_frame
(and copy it) and then subtract it from the next frames damage to determine
the smallest amount we need to copy (taking scale factor into account).

We don't care to modify the damage region to swapBuffers because they
already have the right contents and could potentially fall into another
tile anyway and we'd like to avoid damaging that.

Fixes #4735

macos: add readonly IOSurfaceLock helper

This can be used to lock a surface for reading to avoid causing the
surface contents to be invalidated. This is needed when reading back from
a front-buffer to the back-buffer as is needed when using Cairo surfaces
to implement something similar to BufferAge.

macos: short-circuit on NSEventPhaseMayBegin

We only need to send a single event in this case, so just short-circuit
instead of trying to return an additional event.

macos: support mix-rate monitors

Previously, a single CVDisplayLink was used to drive updates for all
surfaces across all monitors. It used a 'best guess' rate which would
allow for updates across monitors of mixed rates. This is undesirable for
situations where you might have a 144hz monitor as it does not allow for
reaching up to that frame rate.

Instead, we want to use a per-monitor CVDisplayLink which will fire at the
rate of the monitor down to the level of updates we require. This commit
does just that.

When a surface crosses onto a new monitor, that monitor is used to drive
the GdkFrameClock.

Fixes #4732

macos: use video mode for refresh rate and interval

Using the mode allows better detection of refresh rate and refresh
interval for the CVDisplayLink bridge to GdkFrameClock. Using it can help
ensure that our 144hz displays can actually reach that rather than falling
back to just 60hz.

This will also need future commits to rework the displaylink source to be
per-monitor.

macos: send stop event when fingers touch

When the fingers are placed on the touchpad, we get a scroll event with
the phase NSEventPhaseMayBegin. We can use this to synthesize an is_stop
event. This results in the scrolledwindow stopping scroll with stop
gestures.

This can cause another warning as well, however, which should be addressed
from #4730.

Fixes #4733

macos: remove emulated scroll events

We don't appear to actually need the emulated scroll events and they get
in the way of proper scrolling with the touchpad.

Fixes #4734

macos: do not inherit parents frame clock

Windows can end up on different monitors despite having a parent or
transient-for ancestor. We want them to be driven by the CVDisplayLink
for the best-monitor, and so this needs to be unshared.

macos: calculate best monitor when changing screens

When we change screens, we can keep track of the best monitor so that we
can use it to register CVDisplayLink callbacks.

macos: remove duplicated opaque_region field

This can be relied upon from GdkSurface and we do not need to keep a copy
of it. Just remove it and use the GdkSurface.opaque_region field.

macos: use display id when creating CVDisplayLink

Currently we're using a display link that is for all active displays which
is just the display server trying to find some timings that try to overlap
as many as possible.

That was fine for a prototype, but we really need to do better for
situations with mixed frame rate (such as 60hz and 120hz promotion
displays). Additionally, the 144hz external monitor I have will never
reach 144hz using the current design.

This is just the first step in changing this, but the goal is to have
one of these attached to each GdkMacosMonitor which we can then use to
thaw surfaces specific to that monitor.

macos: move feedback mechanisms into separate file

We will eventually be needing additional feedback from the display server
which would be nice to keep away from the rest of GdkMacosDisplay for
cleanliness sake. Particularly for feedback from mission control and other
environment factors that requires private API for proper integration.

gtkscrolledwindow: Do not try to doubly trigger deceleration

This may come from different sources at around the same time, e.g.
a hold gesture while on overshoot. Avoid doing that if an
animation is already set.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/4730

Merge branch 'startup-vs-xdg-activation' into 'main'

Startup tracking with xdg-activation

See merge request GNOME/gtk!3883

print-editor: Use gtk_window_present()

This lets xdg-activation work as otherwise gdk_wayland_surface_focus is
never invoked.

demo: Use gtk_window_present()

This lets xdg-activation work as otherwise gdk_wayland_surface_focus is
never invoked.

widget-factory: Use gtk_window_present()

This lets xdg-activation work as otherwise gdk_wayland_surface_focus is
never invoked.

wayland: Keep startup_notification_id around long enough

When using xdg_activation we need to keep the id around until we send
the first activate to signal succesful startup.

window: Make sure we call gdk_wayland_surface_focus

When using xdg_activation this is responsible for submitting
the activation token / startup id to the compositor.

Merge branch 'gdk-win32-configure-as-needed-fullscreen' into 'main'

GdkWin32: Configure as needed when fullscreening toplevels

Closes #4631

See merge request GNOME/gtk!4506

Merge branch 'win32-fix-4724-gtk4' into 'main'

gdkkeys-win32: Only perform substitution as last-resort [GTK4]

See merge request GNOME/gtk!4531

Merge branch 'ci-disable-debug' into 'main'

CI: disable debug for MSVC

See merge request GNOME/gtk!4525

gdkkeys-win32: Only perform substitution as last-resort

Instead of performing keyboard layout substitution whenever we find a matching
entry in the registry, first try to load the original layout and only attempt
substitution when that fails.

See #4724

Merge branch 'wip/ricotz/annotations' into 'main'

gdk: Add missing out annotation on gdk_content_deserialize_finish

See merge request GNOME/gtk!4529

gdk: Add missing out annotation on gdk_content_deserialize_finish

Merge branch 'wip/otte/for-main' into 'main'

glrenderer: Don't return NULL form render_texture()

See merge request GNOME/gtk!4522

listview: Fix return_if_fail()s

flattenlistmodel: Fix indentation

renderers: Handle large viewports

When large viewports are passed to gsk_renderer_render_texture(), don't
fail (or even return NULL).

Instead, draw multiple tiles and assemble them into a memory texture.

Tests added to the testsuite for this.

Merge branch 'try-to-fix-ci-build' into 'main'

Revert "Bump the wayland-protocols dep"

See merge request GNOME/gtk!4528