feat: docking-full convenience bundle (#8)

docking-full = ["docking", "viewports"] — one word for the full docking
experience (implication closure verified: both defines activate). The two
primitives stay orthogonal (upstream has two independent config flags;
docking-only remains Wayland-safe and avoids the per-frame platform-window
pass). Example switches to the bundle; README documents all three.

Co-authored-by: sunrisepeak <x.d2learn.org@gmail.com>

Author: Sunrisepeak

README.md

@@ -43,7 +43,7 @@ which `CreateWindow`/`Init` use by default.
 
 ## Features
 
-- `docking` — exports the Dock* API surface (`DockSpace`, `DockSpaceOverViewport`,
+- `docking` — dockable panels inside the main window (Wayland-safe). Exports the Dock* API surface (`DockSpace`, `DockSpaceOverViewport`,
   `SetNextWindowDockID`, `IsWindowDocked`, ...) and makes the `imgui.app` facade
   enable `ImGuiConfigFlags_DockingEnable` automatically:
 
@@ -52,9 +52,20 @@ which `CreateWindow`/`Init` use by default.
   imgui = { version = "0.0.4", features = ["docking"] }
   ```
 
+- `viewports` — panels dragged (or positioned) outside the main window detach
+  into real OS windows (multi-viewport). X11/Windows/macOS; note GLFW/Wayland
+  does not support it upstream.
+- `docking-full = ["docking", "viewports"]` — convenience bundle: the full
+  docking experience.
+
+  ```toml
+  [dependencies]
+  imgui = { version = "0.0.5", features = ["docking-full"] }
+  ```
+
   See `examples/docking/`. Sources come from upstream's docking tag
   (`compat.imgui 1.92.8-docking`, a superset of mainline — identical behavior
-  while the feature is off).
+  while the features are off).
 
 ## Dependencies
 

examples/docking/mcpp.toml

@@ -5,4 +5,4 @@ description = "Dockable-windows demo using the imgui `docking` feature"
 license     = "MIT"
 
 [dependencies]
-imgui = { path = "../..", features = ["docking", "viewports"] }
+imgui = { path = "../..", features = ["docking-full"] }

mcpp.toml

@@ -30,6 +30,9 @@ docking = []
 # viewports: ImGui windows dragged outside the main window detach into real
 # OS windows (multi-viewport). Usually combined with docking.
 viewports = []
+# Convenience bundle: the full docking experience (dockable panels + windows
+# that detach into real OS windows). Equivalent to ["docking", "viewports"].
+docking-full = ["docking", "viewports"]
 
 [dependencies]
 compat.imgui = "1.92.8-docking"