bugfix: remove dead code related to parallax modes, remove dead docs,… (#77)

* bugfix: remove dead code related to parallax modes, remove dead docs, add dedicated input guide

* if no inputs are set, enable workspace by default

---------

Co-authored-by: sandwich <[email protected]>

Author: dskvr

Makefile

@@ -100,7 +100,7 @@ PROTOCOL_HDRS =
 endif
 
 # Core module sources (always included)
-CORE_SRCS = src/core/easing.c src/core/animation.c src/core/layer.c src/core/config.c src/core/monitor.c src/core/log.c src/core/parallax.c src/core/cursor.c src/core/render_core.c src/core/event_loop.c \
+CORE_SRCS = src/core/easing.c src/core/animation.c src/core/layer.c src/core/config.c src/core/monitor.c src/core/log.c src/core/cursor.c src/core/render_core.c src/core/event_loop.c \
             src/core/input/input_manager.c src/core/input/providers.c src/core/input/modes/workspace.c src/core/input/modes/cursor.c src/core/input/modes/window.c
 
 # Renderer module sources (conditional)

docs/configuration/environment.md

@@ -58,7 +58,7 @@ The following variables are recognized by hyprlax today (non-exhaustive; impleme
   - `HYPRLAX_RENDER_MARGIN_PX_X=24`         Extra horizontal safe margin (px)
   - `HYPRLAX_RENDER_MARGIN_PX_Y=24`         Extra vertical safe margin (px)
   - `HYPRLAX_RENDER_OVERFLOW=repeat_x`      Overflow behavior (repeat_edge|repeat|repeat_x|repeat_y|none)
-  - `HYPRLAX_PARALLAX_MODE=cursor`          Parallax mode (workspace|cursor|hybrid)
+  - `HYPRLAX_PARALLAX_INPUT=workspace,cursor:0.3`   Parallax inputs (comma list; optional weights)
   - `HYPRLAX_PARALLAX_SOURCES_CURSOR_WEIGHT=0.5`    Cursor source weight (0..1)
   - `HYPRLAX_PARALLAX_SOURCES_WORKSPACE_WEIGHT=0.5` Workspace source weight (0..1)
 

docs/configuration/examples/cursor-parallax.toml

@@ -9,11 +9,9 @@ vsync = false
 easing = expo
 
 [global.parallax]
-mode = "cursor"           # Mouse-driven parallax for focus-follow effect
+input = "cursor"           # Mouse-driven parallax for focus-follow effect
 
-[global.parallax.sources]
-workspace.weight = 1.0     # disable workspace-driven movement
-cursor.weight = 1.0
+# No workspace influence when using cursor-only input
 
 # Invert X so layers shift opposite cursor (stronger depth feeling)
 [global.parallax.invert.cursor]

docs/configuration/examples/multi-layer.toml

@@ -11,11 +11,7 @@ easing = "expo"
 
 # Optional: Add subtle cursor influence
 [global.parallax]
-mode = "hybrid"
-
-[global.parallax.sources]
-workspace.weight = 0.8    # Primarily workspace-driven
-cursor.weight = 0.2       # Subtle cursor influence
+input = "workspace,cursor:0.2"   # Primarily workspace-driven
 
 [global.input.cursor]
 sensitivity_x = 0.5
@@ -73,4 +69,4 @@ align = { x = 0.5, y = 1.0 }  # Bottom-aligned
 # shift_multiplier = { x = 1.0, y = 0.5 }  # Different X/Y speeds
 # opacity = 0.3
 # blur = 0.0
-# fit = "cover"
+# fit = "cover"

docs/configuration/migration-guide.md

@@ -65,7 +65,7 @@ TOML allows cursor-driven parallax:
 
 ```toml
 [global.parallax]
-mode = "cursor"  # New feature!
+input = "cursor"  # New feature!
 
 [global.input.cursor]
 sensitivity_x = 1.0
@@ -133,7 +133,7 @@ margin_px = { x = 50, y = 50 }
 
 # Cursor parallax
 [global.parallax]
-mode = "cursor"
+input = "cursor"
 
 [global.input.cursor]
 sensitivity_x = 1.2
@@ -203,11 +203,7 @@ debug = false
 
 # Optional: Add cursor parallax
 [global.parallax]
-mode = "hybrid"  # Both workspace and cursor
-
-[global.parallax.sources]
-workspace.weight = 0.7
-cursor.weight = 0.3
+input = ["workspace", "cursor:0.3"]  # Both workspace and cursor
 
 [global.input.cursor]
 sensitivity_x = 0.8

docs/configuration/toml-reference.md

@@ -46,11 +46,11 @@ Complete reference for hyprlax TOML configuration format.
 
 | Key | Type | Default | Description |
 |-----|------|---------|-------------|
-| `mode` | string | "workspace" | Parallax mode: "workspace", "cursor", "hybrid" |
+| `input` | string/array | "workspace" | Active sources (e.g., "workspace,cursor:0.3" or ["workspace", "cursor:0.3"]) |
 
 ### [global.parallax.sources]
 
-Control input source influence in hybrid mode:
+Control input source influence via weights:
 
 | Key | Type | Range | Description |
 |-----|------|-------|-------------|
@@ -152,16 +152,12 @@ shift_multiplier = { x = 1.0, y = 0.5 }
 [global]
 fps = 144
 debug = false
-duration = 0.0          # Not used in cursor mode
+duration = 0.0
 vsync = true
 easing = "expo"
 
 [global.parallax]
-mode = "cursor"         # Enable cursor tracking
-
-[global.parallax.sources]
-workspace.weight = 0.0
-cursor.weight = 1.0
+input = "cursor"         # Enable cursor-only tracking
 
 [global.parallax.invert.cursor]
 x = true               # Layers move opposite to cursor

docs/guides/animation.md

@@ -2,7 +2,7 @@
 
 Master the animation system to create smooth, natural parallax effects.
 
-## Parallax Modes
+## Parallax Inputs
 
 Hyprlax combines one or more **input sources** to drive layer movement:
 - `workspace`: driven by workspace changes (original behavior)
@@ -16,9 +16,6 @@ Configure sources via CLI or TOML:
 hyprlax --input workspace                      # workspace only
 hyprlax --input workspace,cursor:0.3           # workspace + cursor blend
 
-# Legacy knobs (warn but still supported)
-hyprlax --parallax hybrid --mouse-weight 0.3
-
 # TOML (preferred)
 [global.parallax]
 input = ["workspace", "cursor:0.3"]
@@ -34,7 +31,7 @@ deadzone_px = 3
 ema_alpha = 0.25
 ```
 
-> **Deprecated:** `parallax.mode` + `parallax.sources.(workspace|cursor).weight` remain for compatibility. Prefer `parallax.input` and the `--input` flag for new configurations.
+> Use `parallax.input` (or `--input` on CLI) to select sources and optional weights.
 
 ### Per-Layer Axis Control
 

docs/guides/cursor-tracking.md

@@ -12,7 +12,7 @@ Cursor-driven parallax makes layers shift based on mouse position, creating an i
 
 ```toml
 [global.parallax]
-mode = "cursor"
+input = "cursor"
 
 [global.input.cursor]
 sensitivity_x = 1.0
@@ -27,38 +27,30 @@ path = "foreground.png"
 shift_multiplier = 1.0
 ```
 
-## Parallax Modes
+## Parallax Inputs
 
 ### Cursor-Only Mode
 Layers move only with mouse movement:
 
 ```toml
 [global.parallax]
-mode = "cursor"
-
-[global.parallax.sources]
-workspace.weight = 0.0
-cursor.weight = 1.0
+input = "cursor"
 ```
 
-### Hybrid Mode
+### Blended Inputs
 Combine workspace and cursor movement:
 
 ```toml
 [global.parallax]
-mode = "hybrid"
-
-[global.parallax.sources]
-workspace.weight = 0.7    # 70% workspace influence
-cursor.weight = 0.3       # 30% cursor influence
+input = ["workspace", "cursor:0.3"]    # 30% cursor influence
 ```
 
 ### Workspace-Only Mode (Traditional)
 Disable cursor tracking:
 
 ```toml
 [global.parallax]
-mode = "workspace"
+input = "workspace"
 ```
 
 ## Cursor Input Settings
@@ -157,7 +149,7 @@ Objects appear to shift based on depth:
 
 ```toml
 [global.parallax]
-mode = "cursor"
+input = "cursor"
 
 [global.input.cursor]
 sensitivity_x = 0.8
@@ -269,7 +261,7 @@ sensitivity_y = 1.2
 
 ### Cursor Not Tracked
 - Check compositor supports cursor position reporting
-- Verify `mode` includes cursor: `"cursor"` or `"hybrid"`
+    - Verify `parallax.input` includes cursor, e.g., `"cursor"` or `"workspace,cursor:0.3"`
 - Run with `--debug` to see cursor position
 
 ### Jittery Movement
@@ -304,11 +296,7 @@ vsync = true
 debug = false
 
 [global.parallax]
-mode = "cursor"
-
-[global.parallax.sources]
-workspace.weight = 0.0
-cursor.weight = 1.0
+input = "cursor"
 
 [global.parallax.invert.cursor]
 x = false