ReviewOS

also looking at this

craft-native/craft

feat: add Linux and Windows named-window routing

#325
Merged glennmichael123 wants to merge codex/multi-window-linux-windows into main
29 files +2250 -200
docs/usage.mdmodified+7-6
Changes to docs/usage.md
@@ -330,15 +330,16 @@ await settingsWindow.focus()
330330```
331331
332332Calling `createWindow` again with the same `id` brings the retained native
333window forward and returns the same typed handle. Runtime creation currently
334uses the macOS host. `close()` retains that page for a later reopen, while
335`destroy()` permanently releases a runtime-created window; the unnamed primary
336window is not destroyable through this API. Modal and parent-window
337relationships are not supported.
333window forward and returns the same typed handle on macOS, Linux, and Windows.
334On macOS, `close()` retains the page for a later reopen. On Linux and Windows,
335closing releases the native page; reopening the same ID creates a fresh one
336behind the stable typed handle. `destroy()` permanently releases a
337runtime-created window; the unnamed primary window is not destroyable through
338this API. Modal and parent-window relationships are not supported.
338339
339340The [multi-window ownership contract](architecture/multi-window-ownership.md)
340341tracks which state is window-scoped, which events intentionally target the
341primary page and what remains before the feature is cross-platform.
342primary page, and which advanced behaviors remain outside the contract.
342343
343344### Window Lifecycle Events
344345