diff --git a/src/siwin/platforms/wayland/siwinGlobals.nim b/src/siwin/platforms/wayland/siwinGlobals.nim
index 86f2fd4..5f895ab 100644
--- a/src/siwin/platforms/wayland/siwinGlobals.nim
+++ b/src/siwin/platforms/wayland/siwinGlobals.nim
@@ -6,9 +6,14 @@ import ./[libwayland, protocol, bitfields, libdecor]
 type
   WaylandExtensionNotFound* = object of CatchableError
 
+  WaylandOutput* = object
+    registryName*: uint32
+    output*: Wl_output
+
   SiwinGlobalsWayland* = ref SiwinGlobalsWaylandObj
   SiwinGlobalsWaylandObj* = object of SiwinGlobals
     seatEventsInitialized*: bool
+    seatCapabilitiesChanged*: proc(globals: SiwinGlobalsWayland)
     dataDeviceManagerEventsInitialized*: bool
 
     display*: WlDisplay
@@ -26,6 +31,7 @@ type
     viewporter*: Wp_viewporter
     fractionalScaleManager*: Wp_fractional_scale_manager_v1
     xdgToplevelIconManager*: Xdg_toplevel_icon_manager_v1
+    outputs*: seq[WaylandOutput]
 
     serverDecorationManager*: Zxdg_decoration_manager_v1
     plasmaShell*: Org_kde_plasma_shell
@@ -118,6 +124,8 @@ proc initRegistryCallbacks(globals: SiwinGlobalsWayland) =
     globals.seatCapabilities = globals.seatCapabilities.typeof.default
     globals.seat.onCapabilities:
       globals.seatCapabilities = capabilities.asBitfield
+      if not globals.seatCapabilitiesChanged.isNil:
+        globals.seatCapabilitiesChanged(globals)
     
     discard wl_display_roundtrip globals.display
 
@@ -155,6 +163,9 @@ proc initRegistryCallbacks(globals: SiwinGlobalsWayland) =
   addRegistry Wp_cursor_shape_manager_v1:
     globals.cursorShapeManager = binded 
 
+  addRegistry Wl_output:
+    globals.outputs.add WaylandOutput(registryName: name, output: binded)
+
 
 proc isWaylandAvailable*: bool =
   proc isSocket(filename: string): bool =
@@ -208,6 +219,12 @@ proc newWaylandGlobals*(): SiwinGlobalsWayland =
       if interfaceString == targetIface:
         callback(globals.registry, name, version)
 
+  globals.registry.onGlobal_remove:
+    for idx in countdown(globals.outputs.high, 0):
+      if globals.outputs[idx].registryName == name:
+        release globals.outputs[idx].output
+        globals.outputs.delete(idx)
+
 
 proc roundtrip*(globals: SiwinGlobalsWayland) =
   discard wl_display_roundtrip globals.display
diff --git a/src/siwin/platforms/wayland/window.nim b/src/siwin/platforms/wayland/window.nim
index 51b9d3b..23cbb53 100644
--- a/src/siwin/platforms/wayland/window.nim
+++ b/src/siwin/platforms/wayland/window.nim
@@ -10,9 +10,46 @@ import ./[libwayland, protocol, siwinGlobals, sharedBuffer, bitfields, xkb, libd
 
 privateAccess Window
 
+when siwin_use_pure_enums:
+  {.pragma: siwin_enum, pure.}
+else:
+  {.pragma: siwin_enum.}
+
 type
+  LayerSurfaceLayer* {.siwin_enum.} = enum
+    lslBackground
+    lslBottom
+    lslTop
+    lslOverlay
+
+  LayerSurfaceAnchor* {.siwin_enum.} = enum
+    lsaTop
+    lsaBottom
+    lsaLeft
+    lsaRight
+
+  LayerSurfaceKeyboardMode* {.siwin_enum.} = enum
+    lskNone
+    lskExclusive
+    lskOnDemand
+
+  LayerSurfaceMargins* = object
+    top*: int32
+    right*: int32
+    bottom*: int32
+    left*: int32
+
+  LayerSurfaceConfig* = object
+    layer*: LayerSurfaceLayer
+    anchors*: set[LayerSurfaceAnchor]
+    margins*: LayerSurfaceMargins
+    exclusiveZone*: int32
+    keyboardMode*: LayerSurfaceKeyboardMode
+    namespace*: string
+
   ScreenWayland* = ref object of Screen
     id: cint
+    output: Wl_output
 
   WindowWaylandKind* {.pure.} = enum
     XdgSurface
@@ -22,6 +59,7 @@ type
   WindowWayland* = ref WindowWaylandObj
   WindowWaylandObj* = object of Window
     globals: SiwinGlobalsWayland
+    screen: ScreenWayland
     surface: Wl_surface
     xdgSurface: Xdg_surface
     xdgToplevel: Xdg_toplevel
@@ -248,16 +286,19 @@ proc refreshKeyboardModifiers(window: WindowWayland) =
 method swapBuffers(window: WindowWayland) {.base.} = discard
 
 proc screenCountWayland*(globals: SiwinGlobalsWayland): int32 =
-  ## todo
-  1
+  globals.outputs.len.int32
 
 proc screenWayland*(globals: SiwinGlobalsWayland, number: int32): ScreenWayland =
   new result
   if number notin 0..<globals.screenCountWayland(): raise IndexDefect.newException(&"screen {number} doesn't exist")
   result.id = number.cint
+  result.output = globals.outputs[number].output
 
 proc defaultScreenWayland*(globals: SiwinGlobalsWayland): ScreenWayland =
-  ScreenWayland(id: 0.cint)
+  if globals.outputs.len == 0:
+    ScreenWayland(id: -1.cint)
+  else:
+    ScreenWayland(id: 0.cint, output: globals.outputs[0].output)
 
 method number*(screen: ScreenWayland): int32 = screen.id
 
@@ -521,6 +562,7 @@ proc initClipboardsIfNeeded(globals: SiwinGlobalsWayland) =
 
 proc basicInitWindow(window: WindowWayland; size: IVec2; screen: ScreenWayland) =
   window.m_size = size
+  window.screen = screen
   window.m_focused = false
   window.m_resizable = true
   window.m_frameless = true
@@ -1159,12 +1201,15 @@ var cursor: Wp_cursor_shape_device_v1
 var cursor_surface: CursorWayland
 
 proc initSeatEvents*(globals: SiwinGlobalsWayland) =
-  if globals.seatEventsInitialized: return
-  globals.seatEventsInitialized = true
+  if not globals.seatEventsInitialized:
+    globals.seatEventsInitialized = true
+    globals.seatCapabilitiesChanged = proc(updatedGlobals: SiwinGlobalsWayland) =
+      updatedGlobals.initSeatEvents()
 
   if globals.seat == nil: return
 
-  if `WlSeat / Capability`.`pointer` in globals.seatCapabilities:
+  if `WlSeat / Capability`.`pointer` in globals.seatCapabilities and
+      globals.seat_pointer == nil:
     globals.seat_pointer = globals.seat.get_pointer
 
     cursor_surface = globals.loadBuiltinCursor(arrow)
@@ -1304,7 +1349,8 @@ proc initSeatEvents*(globals: SiwinGlobalsWayland) =
         return
 
 
-  if `WlSeat / Capability`.keyboard in globals.seatCapabilities:
+  if `WlSeat / Capability`.keyboard in globals.seatCapabilities and
+      globals.seat_keyboard == nil:
     globals.seat_keyboard = globals.seat.get_keyboard
     # Default repeat values; compositor-provided repeat_info overrides these.
     globals.seat_keyboard_repeatSettings = (rate: 25, delay: 600)
@@ -1411,7 +1457,7 @@ proc initSeatEvents*(globals: SiwinGlobalsWayland) =
         globals.seat_keyboard_repeatSettings = (rate: rate, delay: delay)
   
 
-  if globals.tabletManager != nil:
+  if globals.tabletManager != nil and globals.seat_tablet == nil:
     globals.seat_tablet = globals.tabletManager.get_tablet_seat(globals.seat)
     
     globals.seat_tablet.onTool_added:
@@ -1796,9 +1842,10 @@ proc setupWindow(window: WindowWayland, fullscreen, frameless, transparent: bool
       window.resize(ivec2(width, height))
 
   of LayerSurface:
+    expectExtension window.globals.layerShell
     window.layerShellSurface = window.globals.layerShell.get_layer_surface(
       window.surface,
-      Wl_output(proxy: Wl_proxy(raw: nil)),
+      window.screen.output,
       `Zwlr_layer_shell_v1/Layer`(window.layer.int),
       window.namespace.cstring
     )
@@ -1903,6 +1950,19 @@ proc setExclusiveZone*(window: WindowWayland, zone: int32) =
   window.layerShellSurface.set_exclusive_zone(zone)
 
 
+proc setMargins*(window: WindowWayland, margins: LayerSurfaceMargins) =
+  if window.layerShellSurface == nil:
+    raise newException(
+      ValueError,
+      "Attempt to set margins when layer shell surface hasn't been initialized." &
+      "\nHint: Construct this window as a Wayland layer surface."
+    )
+
+  window.layerShellSurface.set_margin(
+    margins.top, margins.right, margins.bottom, margins.left
+  )
+
+
 proc constructClipboardContent*(
   data: sink string, kind: ClipboardContentKind, mimeType: string
 ): ClipboardContent =
@@ -2238,7 +2298,7 @@ proc newSoftwareRenderingWindowWayland*(
   frameless = false,
   transparent = false,
 
-  class = "", # window class (used on linux), equals to title if not specified
+  class = "", # application ID; defaults to title
 ): WindowWaylandSoftwareRendering =
   new result
   result.globals = globals
@@ -2247,6 +2307,76 @@ proc newSoftwareRenderingWindowWayland*(
   result.title = title
   if not resizable: result.resizable = false
 
+proc initLayerSurfaceWindow(
+  window: WindowWayland,
+  size: IVec2,
+  screen: ScreenWayland,
+  config: LayerSurfaceConfig,
+  transparent: bool,
+  class: string,
+) =
+  window.kind = WindowWaylandKind.LayerSurface
+  window.layer = Layer(config.layer.ord)
+  window.namespace = config.namespace
+  window.basicInitWindow(size, screen)
+  window.setupWindow(
+    fullscreen = false,
+    frameless = true,
+    transparent = transparent,
+    size = size,
+    class = class,
+  )
+
+  var anchors: uint32
+  for anchor in config.anchors:
+    anchors = anchors or (1'u32 shl anchor.ord)
+  window.layerShellSurface.set_anchor(
+    cast[`Zwlr_layer_surface_v1/Anchor`](anchors)
+  )
+  window.setMargins(config.margins)
+  window.setExclusiveZone(config.exclusiveZone)
+  window.setKeyboardInteractivity(
+    LayerInteractivityMode(config.keyboardMode.ord)
+  )
+
+  let
+    requestedWidth =
+      if {lsaLeft, lsaRight} <= config.anchors: 0'u32 else: size.x.uint32
+    requestedHeight =
+      if {lsaTop, lsaBottom} <= config.anchors: 0'u32 else: size.y.uint32
+  window.layerShellSurface.set_size(requestedWidth, requestedHeight)
+
+proc newSoftwareRenderingLayerSurfaceWindowWayland*(
+    globals: SiwinGlobalsWayland,
+    size = ivec2(1280, 32),
+    title = "",
+    screen: ScreenWayland,
+    config: LayerSurfaceConfig,
+    transparent = false,
+): WindowWaylandSoftwareRendering =
+  ## Creates a software-rendered window backed by a Wayland layer-shell surface.
+  ##
+  ## `config` controls the layer, anchors, margins, exclusive zone, keyboard
+  ## interactivity, and namespace. Anchoring to both horizontal or both vertical
+  ## edges lets the compositor determine that dimension; otherwise `size` is
+  ## requested. When `transparent` is enabled, the backing buffer includes an
+  ## alpha channel.
+  ##
+  ## Raises `WaylandExtensionNotFound` when a required Wayland extension is
+  ## unavailable.
+  new result
+  result.globals = globals
+  result.softwarePresentEnabled = true
+  expectExtension result.globals.shm
+  result.initLayerSurfaceWindow(size, screen, config, transparent, title)
+  result.buffer = result.globals.create(
+    result.globals.shm,
+    result.bufferSize(size),
+    (if transparent: argb8888 else: xrgb8888),
+    bufferCount = 2,
+  )
+  result.title = title
+
 proc newPopupWindowWayland*(
     globals: SiwinGlobalsWayland,
     parent: WindowWayland,
diff --git a/src/siwin/platforms/wayland/windowOpengl.nim b/src/siwin/platforms/wayland/windowOpengl.nim
index 5f202b4..0e9a486 100644
--- a/src/siwin/platforms/wayland/windowOpengl.nim
+++ b/src/siwin/platforms/wayland/windowOpengl.nim
@@ -85,7 +85,7 @@ proc newOpenglWindowWayland*(
   layer = Layer.Overlay,
   namespace = "siwin",
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # application ID; defaults to title
 ): WindowWaylandOpengl =
   new result
   result.globals = globals
@@ -96,3 +96,33 @@ proc newOpenglWindowWayland*(
   result.title = title
   result.`vsync=`(vsync, silent=true)
   if not resizable: result.resizable = false
+
+proc newOpenglLayerSurfaceWindowWayland*(
+  globals: SiwinGlobalsWayland,
+  size = ivec2(1280, 32),
+  title = "",
+  screen: ScreenWayland,
+  config: LayerSurfaceConfig,
+  transparent = false,
+  vsync = true,
+): WindowWaylandOpengl =
+  ## Creates an OpenGL window backed by a Wayland layer-shell surface.
+  ##
+  ## `config` controls the layer-shell role. Anchoring to both horizontal or
+  ## both vertical edges lets the compositor determine that dimension;
+  ## otherwise `size` is requested.
+  ##
+  ## Raises `WaylandExtensionNotFound` when a required Wayland extension is
+  ## unavailable.
+  new result
+  result.globals = globals
+  initEgl(result.globals.display.raw)
+  result.initLayerSurfaceWindow(size, screen, config, transparent, title)
+
+  let scaledSize = result.bufferSize(size)
+  result.eglContext = newOpenglContext(
+    result.surface.proxy.raw, scaledSize.x, scaledSize.y
+  )
+  makeCurrent result.eglContext
+  result.title = title
+  result.`vsync=`(vsync, silent = true)
diff --git a/src/siwin/platforms/wayland/windowVulkan.nim b/src/siwin/platforms/wayland/windowVulkan.nim
index 74b9422..621e5e1 100644
--- a/src/siwin/platforms/wayland/windowVulkan.nim
+++ b/src/siwin/platforms/wayland/windowVulkan.nim
@@ -45,21 +45,7 @@ method vulkanSurface*(window: WindowWaylandVulkan): pointer =
   window.vulkan_surface.raw
 
 
-proc initVulkanWindow(
-  window: WindowWaylandVulkan, vkInstance: pointer,
-  size: IVec2, screen: ScreenWayland,
-  fullscreen, frameless, transparent: bool, class: string
-) =
-  window.basicInitWindow size, screen
-  
-  window.setupWindow fullscreen, frameless, transparent, size, class
-  window.configureSurface()
-
-  # window.eglContext = newOpenglContext(window.surface.proxy.raw, size.x, size.y)
-  # makeCurrent window.eglContext
-
-  # commit window.surface
-
+proc initVulkanSurface(window: WindowWaylandVulkan, vkInstance: pointer) =
   window.vulkan_surface.instance = vkInstance
   var info = VkWaylandSurfaceCreateInfoKHR(
     sType: VK_STRUCTURE_TYPE_WAYLAND_SURFACE_CREATE_INFO_KHR,
@@ -73,6 +59,17 @@ proc initVulkanWindow(
     raise OSError.newException("Failed to create Vulkan surface, error: " & $res)
 
 
+proc initVulkanWindow(
+  window: WindowWaylandVulkan, vkInstance: pointer,
+  size: IVec2, screen: ScreenWayland,
+  fullscreen, frameless, transparent: bool, class: string
+) =
+  window.basicInitWindow size, screen
+  window.setupWindow fullscreen, frameless, transparent, size, class
+  window.configureSurface()
+  window.initVulkanSurface(vkInstance)
+
+
 proc newVulkanWindowWayland*(
   globals: SiwinGlobalsWayland,
   vkInstance: pointer,
@@ -84,10 +81,34 @@ proc newVulkanWindowWayland*(
   frameless = false,
   transparent = false,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # application ID; defaults to title
 ): WindowWaylandVulkan =
   new result
   result.globals = globals
   result.initVulkanWindow(vkInstance, size, screen, fullscreen, frameless, transparent, (if class == "": title else: class))
   result.title = title
   if not resizable: result.resizable = false
+
+proc newVulkanLayerSurfaceWindowWayland*(
+  globals: SiwinGlobalsWayland,
+  vkInstance: pointer,
+  size = ivec2(1280, 32),
+  title = "",
+  screen: ScreenWayland,
+  config: LayerSurfaceConfig,
+  transparent = false,
+): WindowWaylandVulkan =
+  ## Creates a Vulkan window backed by a Wayland layer-shell surface.
+  ##
+  ## `config` controls the layer-shell role. Anchoring to both horizontal or
+  ## both vertical edges lets the compositor determine that dimension;
+  ## otherwise `size` is requested.
+  ##
+  ## Raises `WaylandExtensionNotFound` when a required Wayland extension is
+  ## unavailable.
+  new result
+  result.globals = globals
+  result.initLayerSurfaceWindow(size, screen, config, transparent, title)
+  result.configureSurface()
+  result.initVulkanSurface(vkInstance)
+  result.title = title
diff --git a/src/siwin/window.nim b/src/siwin/window.nim
index de21084..763b12b 100644
--- a/src/siwin/window.nim
+++ b/src/siwin/window.nim
@@ -80,7 +80,7 @@ when not siwin_use_lib:
     frameless = false,
     transparent = false,
 
-    class = "", # window class (used in x11), equals to title if not specified
+    class = "", # X11 window class / Wayland app ID; defaults to title
   ): Window =
     when defined(android):
       newSoftwareRenderingWindowAndroid(
@@ -101,7 +101,8 @@ when not siwin_use_lib:
         result = globals.SiwinGlobalsWayland.newSoftwareRenderingWindowWayland(
           size, title,
           (if screen == -1: globals.SiwinGlobalsWayland.defaultScreenWayland() else: globals.SiwinGlobalsWayland.screenWayland(screen)),
-          resizable, fullscreen, frameless, transparent
+          resizable, fullscreen, frameless, transparent,
+          class = class
         )
       else:
         raise SiwinPlatformSupportDefect.newException("Unsupported platform")
@@ -148,6 +149,40 @@ when not siwin_use_lib:
     elif defined(macosx):
       result = newPopupWindowCocoa(parent.WindowCocoa, placement, transparent, grab)
 
+  when defined(linux) or defined(bsd):
+    proc newSoftwareRenderingLayerSurfaceWindow*(
+        globals: SiwinGlobals,
+        size = ivec2(1280, 32),
+        title = "",
+        screen: int32 = -1,
+        config: waylandWindow.LayerSurfaceConfig,
+        transparent = false,
+    ): Window =
+      ## Creates a software-rendered window backed by a Wayland layer-shell surface.
+      ##
+      ## `config` controls the layer, anchors, margins, exclusive zone, keyboard
+      ## interactivity, and namespace. A `screen` value of `-1` selects the
+      ## default Wayland output.
+      ##
+      ## Raises `SiwinPlatformSupportDefect` when `globals` uses the X11 backend.
+      if globals of SiwinGlobalsWayland:
+        let waylandGlobals = globals.SiwinGlobalsWayland
+        result = waylandGlobals.newSoftwareRenderingLayerSurfaceWindowWayland(
+          size = size,
+          title = title,
+          screen =
+            if screen == -1:
+              waylandGlobals.defaultScreenWayland()
+            else:
+              waylandGlobals.screenWayland(screen),
+          config = config,
+          transparent = transparent,
+        )
+      else:
+        raise SiwinPlatformSupportDefect.newException(
+          "Layer-shell surfaces require the Wayland platform"
+        )
+
 
 when defined(android):
   proc loadExtensions*() =
@@ -196,7 +231,7 @@ proc newSoftwareRenderingWindow*(
   frameless = false,
   transparent = false,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # X11 window class / Wayland app ID; defaults to title
 ): Window {.siwin_export_import.} =
   result = siwin_new_software_rendering_window(
     globals,
@@ -216,7 +251,7 @@ proc newSoftwareRenderingWindow*(
   frameless = false,
   transparent = false,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # X11 window class / Wayland app ID; defaults to title
   
   preferedPlatform: Platform = defaultPreferedPlatform(),
 ): Window =
diff --git a/src/siwin/windowOpengl.nim b/src/siwin/windowOpengl.nim
index 567c6fd..dc4fcd0 100644
--- a/src/siwin/windowOpengl.nim
+++ b/src/siwin/windowOpengl.nim
@@ -37,7 +37,7 @@ when not siwin_use_lib:
     transparent = false,
     vsync = true,
 
-    class = "", # window class (used in x11), equals to title if not specified
+    class = "", # X11 window class / Wayland app ID; defaults to title
   ): Window =
     when defined(android):
       newOpenglWindowAndroid(
@@ -58,7 +58,8 @@ when not siwin_use_lib:
         result = globals.SiwinGlobalsWayland.newOpenglWindowWayland(
           size, title,
           (if screen == -1: globals.SiwinGlobalsWayland.defaultScreenWayland() else: globals.SiwinGlobalsWayland.screenWayland(screen)),
-          resizable, fullscreen, frameless, transparent, vsync
+          resizable, fullscreen, frameless, transparent, vsync,
+          class = class
         )
       else:
         raise SiwinPlatformSupportDefect.newException("Unsupported platform")
@@ -77,6 +78,42 @@ when not siwin_use_lib:
         resizable, fullscreen, frameless, transparent, vsync
       )
 
+  when defined(linux) or defined(bsd):
+    proc newOpenglLayerSurfaceWindow*(
+      globals: SiwinGlobals,
+      size = ivec2(1280, 32),
+      title = "",
+      screen: int32 = -1,
+      config: waylandWindow.LayerSurfaceConfig,
+      transparent = false,
+      vsync = true,
+    ): Window =
+      ## Creates an OpenGL window backed by a Wayland layer-shell surface.
+      ##
+      ## `config` controls the layer, anchors, margins, exclusive zone, keyboard
+      ## interactivity, and namespace. A `screen` value of `-1` selects the
+      ## default Wayland output.
+      ##
+      ## Raises `SiwinPlatformSupportDefect` when `globals` uses the X11 backend.
+      if globals of SiwinGlobalsWayland:
+        let waylandGlobals = globals.SiwinGlobalsWayland
+        result = waylandGlobals.newOpenglLayerSurfaceWindowWayland(
+          size = size,
+          title = title,
+          screen =
+            if screen == -1:
+              waylandGlobals.defaultScreenWayland()
+            else:
+              waylandGlobals.screenWayland(screen),
+          config = config,
+          transparent = transparent,
+          vsync = vsync,
+        )
+      else:
+        raise SiwinPlatformSupportDefect.newException(
+          "Layer-shell surfaces require the Wayland platform"
+        )
+
 
 
 proc siwin_new_opengl_window(
@@ -105,7 +142,7 @@ proc newOpenglWindow*(
   transparent = false,
   vsync = true,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # X11 window class / Wayland app ID; defaults to title
 ): Window {.siwin_export_import.} =
   result = siwin_new_opengl_window(
     globals,
@@ -126,9 +163,8 @@ proc newOpenglWindow*(
   transparent = false,
   vsync = true,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # X11 window class / Wayland app ID; defaults to title
   
   preferedPlatform: Platform = defaultPreferedPlatform(),
 ): Window =
   newOpenglWindow(newSiwinGlobals(preferedPlatform), size, title, screen, fullscreen, resizable, frameless, transparent, vsync, class)
-
diff --git a/src/siwin/windowVulkan.nim b/src/siwin/windowVulkan.nim
index ff6279c..206d628 100644
--- a/src/siwin/windowVulkan.nim
+++ b/src/siwin/windowVulkan.nim
@@ -34,7 +34,7 @@ when not siwin_use_lib:
     frameless = false,
     transparent = false,
 
-    class = "", # window class (used in x11), equals to title if not specified
+    class = "", # X11 window class / Wayland app ID; defaults to title
   ): Window =
     when defined(android):
       # todo
@@ -58,7 +58,8 @@ when not siwin_use_lib:
           vkInstance,
           size, title,
           (if screen == -1: globals.SiwinGlobalsWayland.defaultScreenWayland() else: globals.SiwinGlobalsWayland.screenWayland(screen)),
-          resizable, fullscreen, frameless, transparent
+          resizable, fullscreen, frameless, transparent,
+          class = class
         )
       else:
         raise SiwinPlatformSupportDefect.newException("Unsupported platform")
@@ -71,6 +72,42 @@ when not siwin_use_lib:
         resizable, fullscreen, frameless, transparent
       )
 
+  when defined(linux) or defined(bsd):
+    proc newVulkanLayerSurfaceWindow*(
+      globals: SiwinGlobals,
+      vkInstance: pointer,
+      size = ivec2(1280, 32),
+      title = "",
+      screen: int32 = -1,
+      config: waylandWindow.LayerSurfaceConfig,
+      transparent = false,
+    ): Window =
+      ## Creates a Vulkan window backed by a Wayland layer-shell surface.
+      ##
+      ## `config` controls the layer, anchors, margins, exclusive zone, keyboard
+      ## interactivity, and namespace. A `screen` value of `-1` selects the
+      ## default Wayland output.
+      ##
+      ## Raises `SiwinPlatformSupportDefect` when `globals` uses the X11 backend.
+      if globals of SiwinGlobalsWayland:
+        let waylandGlobals = globals.SiwinGlobalsWayland
+        result = waylandGlobals.newVulkanLayerSurfaceWindowWayland(
+          vkInstance = vkInstance,
+          size = size,
+          title = title,
+          screen =
+            if screen == -1:
+              waylandGlobals.defaultScreenWayland()
+            else:
+              waylandGlobals.screenWayland(screen),
+          config = config,
+          transparent = transparent,
+        )
+      else:
+        raise SiwinPlatformSupportDefect.newException(
+          "Layer-shell surfaces require the Wayland platform"
+        )
+
 
 
 proc siwin_new_vulkan_window(
@@ -99,7 +136,7 @@ proc newVulkanWindow*(
   frameless = false,
   transparent = false,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # X11 window class / Wayland app ID; defaults to title
 ): Window {.siwin_export_import.} =
   result = siwin_new_vulkan_window(
     globals, vkInstance,
@@ -120,7 +157,7 @@ proc newVulkanWindow*(
   frameless = false,
   transparent = false,
 
-  class = "", # window class (used in x11), equals to title if not specified
+  class = "", # X11 window class / Wayland app ID; defaults to title
   
   preferedPlatform: Platform = defaultPreferedPlatform(),
 ): Window =
diff --git a/tests/t_layershell.nim b/tests/t_layershell.nim
index 4d1c898..dd86e80 100644
--- a/tests/t_layershell.nim
+++ b/tests/t_layershell.nim
@@ -1,7 +1,23 @@
 
 import std/[unittest]
-import siwin, opengl, vmath
-import siwin/platforms/wayland/[siwinGlobals, window, windowOpengl]
+import siwin
+
+when defined(linux) or defined(bsd):
+  import opengl, vmath
+  import siwin/platforms/wayland/[siwinGlobals, window, windowOpengl]
+
+  static:
+    doAssert compiles(
+      block:
+        var globals: SiwinGlobals
+        let config = default(LayerSurfaceConfig)
+        discard globals.newSoftwareRenderingLayerSurfaceWindow(config = config)
+        discard globals.newOpenglLayerSurfaceWindow(config = config)
+        discard globals.newVulkanLayerSurfaceWindow(
+          vkInstance = nil,
+          config = config,
+        )
+    )
 
 test "wlr-layer-shell":
   when not defined(linux) and not defined(bsd):
@@ -14,17 +30,24 @@ test "wlr-layer-shell":
       try:
         let globals = newWaylandGlobals()
         roundtrip(globals)
-        let window = globals.newOpenglWindowWayland(
+        let config = LayerSurfaceConfig(
+          layer: LayerSurfaceLayer.lslOverlay,
+          anchors: {
+            LayerSurfaceAnchor.lsaTop,
+            LayerSurfaceAnchor.lsaBottom,
+            LayerSurfaceAnchor.lsaLeft,
+          },
+          exclusiveZone: 1,
+          keyboardMode: LayerSurfaceKeyboardMode.lskOnDemand,
+          namespace: "siwin-layer-shell-test",
+        )
+        let window = globals.newOpenglLayerSurfaceWindowWayland(
           size = ivec2(1000, 1000),
-          kind = WindowWaylandKind.LayerSurface,
-          layer = Layer.Overlay,
           screen = globals.defaultScreenWayland,
+          config = config,
         )
         loadExtensions()
 
-        window.setAnchor(@[LayerEdge.Top, LayerEdge.Bottom, LayerEdge.Left])
-        window.setKeyboardInteractivity(LayerInteractivityMode.OnDemand)
-        window.setExclusiveZone(1)
         window.run(
           WindowEventsHandler(
             onRender: proc(e: RenderEvent) =