Merge remote-tracking branch 'upstream'

10 files changed, 289 insertions, 98 deletions

diff --git a/config/hypr/UserConfigs/UserDecorations.conf b/config/hypr/UserConfigs/UserDecorations.conf
index e7e30651..bef67138 100644
--- a/config/hypr/UserConfigs/UserDecorations.conf
+++ b/config/hypr/UserConfigs/UserDecorations.conf
@@ -35,7 +35,7 @@ decoration {
 
   shadow {
     enabled = true
-    range = 3
+    range = 1
     render_power = 1
 
     color =  $color12
diff --git a/config/hypr/UserConfigs/user_animations.lua b/config/hypr/UserConfigs/user_animations.lua
new file mode 100644
index 00000000..5c5bb484
--- /dev/null
+++ b/config/hypr/UserConfigs/user_animations.lua
@@ -0,0 +1,17 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User animation overrides template.
+-- Use this to override defaults from lua/animations.lua.
+
+-- Example:
+-- hl.config({
+--   animations = {
+--     enabled = true,
+--   },
+-- })
+--
+-- hl.animation({ leaf = "windows", enabled = true, speed = 5, bezier = "wind", style = "slide" })
diff --git a/config/hypr/UserConfigs/user_decorations.lua b/config/hypr/UserConfigs/user_decorations.lua
index 6b34666e..6d2bab7a 100644
--- a/config/hypr/UserConfigs/user_decorations.lua
+++ b/config/hypr/UserConfigs/user_decorations.lua
@@ -4,103 +4,61 @@
 --  License: GNU GPLv3
 --  SPDX-License-Identifier: GPL-3.0-or-later
 -- ==================================================
+-- User decorations overrides template.
+-- Keep this repo copy as comments only; put active custom values in:
+--   ~/.config/hypr/UserConfigs/user_decorations.lua
+--
+-- Uncomment and edit examples below if you want defaults in the repo template.
 
--- User decorations overrides (auto-generated).
--- This file is intentionally split from other user overrides.
--- Add only user-specific Lua overrides here.
--- Example:
--- hl.config({ general = { gaps_in = 4, gaps_out = 8 } })
+-- Example general overrides:
+-- hl.config({
+--   general = {
+--     border_size = 1,
+--     gaps_in = 4,
+--     gaps_out = 6,
+--   },
+-- })
 
--- Source reference from UserDecorations.conf (hyprlang):
--- source = $HOME/.config/hypr/wallust/wallust-hyprland.conf
--- general {
--- border_size = 2
--- gaps_in = 2
--- gaps_out = 4
--- col.active_border = $color12
--- col.inactive_border = $color10
--- }
--- decoration {
--- rounding = 10
--- active_opacity = 1.0
--- inactive_opacity = 0.9
--- fullscreen_opacity = 1.0
--- dim_inactive = true
--- dim_strength = 0.1
--- dim_special = 0.8
--- shadow {
--- enabled = true
--- range = 3
--- render_power = 1
--- color =  $color12
--- color_inactive = $color10
--- }
--- blur {
--- enabled = true
--- size = 6
--- passes = 3
--- new_optimizations = true
--- xray = true
--- ignore_opacity = true
--- special = true
--- popups = true
--- }
--- }
--- group {
--- col.border_active = $color15
--- groupbar {
--- col.active = $color0
--- }
--- }
+-- Example decoration overrides:
+-- hl.config({
+--   decoration = {
+--     rounding = 10,
+--     active_opacity = 1.0,
+--     inactive_opacity = 0.95,
+--     fullscreen_opacity = 1.0,
+--     dim_inactive = true,
+--     dim_strength = 0.1,
+--     dim_special = 0.8,
+--     shadow = {
+--       enabled = true,
+--       range = 2,
+--       render_power = 1,
+--       color = "rgba(8db4ffff)",
+--       color_inactive = "rgba(5f6578ff)",
+--     },
+--     blur = {
+--       enabled = true,
+--       size = 6,
+--       passes = 3,
+--       new_optimizations = true,
+--       xray = true,
+--       ignore_opacity = true,
+--       special = true,
+--       popups = true,
+--     },
+--   },
+-- })
 
-local function read_wallust_colors(path)
-  local colors = {}
-  local handle = io.open(path, "r")
-  if not handle then
-    return colors
-  end
-  for line in handle:lines() do
-    local key, hex = line:match("^%$([%w_]+)%s*=%s*rgb%(([0-9A-Fa-f]+)%)")
-    if key and hex then
-      colors[key] = "rgb(" .. hex .. ")"
-    end
-  end
-  handle:close()
-  return colors
-end
-
-local wallust_path = (os.getenv("HOME") or "") .. "/.config/hypr/wallust/wallust-hyprland.conf"
-local colors = read_wallust_colors(wallust_path)
-
-if next(colors) then
-  hl.config({
-    general = {
-      col = {
-        active_border = colors.color12 or "rgba(8db4ffff)",
-        inactive_border = colors.color10 or "rgba(5f6578ff)",
-      },
-    },
-  })
-
-  hl.config({
-    decoration = {
-      shadow = {
-        color = colors.color12 or "rgba(8db4ffff)",
-        color_inactive = colors.color10 or "rgba(5f6578ff)",
-      },
-    },
-  })
-
-  hl.config({
-    group = {
-      col = {
-        border_active = colors.color15 or "rgba(ffffffff)",
-      },
-      groupbar = {
-        col = {
-          active = colors.color0 or "rgba(0f111aff)",
-        },
-      },
-    },
-  })
-end
+-- Example group styling:
+-- hl.config({
+--   group = {
+--     col = {
+--       border_active = "rgba(ffffffff)",
+--     },
+--     groupbar = {
+--       col = {
+--         active = "rgba(0f111aff)",
+--       },
+--     },
+--   },
+-- })
diff --git a/config/hypr/UserConfigs/user_defaults.lua b/config/hypr/UserConfigs/user_defaults.lua
new file mode 100644
index 00000000..dd889134
--- /dev/null
+++ b/config/hypr/UserConfigs/user_defaults.lua
@@ -0,0 +1,17 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User defaults overrides template.
+-- This file is sourced by lua/user_defaults.lua.
+
+KOOLDOTS_DEFAULTS = KOOLDOTS_DEFAULTS or {}
+
+-- Examples:
+-- KOOLDOTS_DEFAULTS.edit = "nvim"
+-- KOOLDOTS_DEFAULTS.visual = "nvim"
+-- KOOLDOTS_DEFAULTS.term = "kitty"
+-- KOOLDOTS_DEFAULTS.files = "thunar"
+-- KOOLDOTS_DEFAULTS.search_engine = "https://duckduckgo.com/?q={}"
diff --git a/config/hypr/UserConfigs/user_env.lua b/config/hypr/UserConfigs/user_env.lua
new file mode 100644
index 00000000..12d134bb
--- /dev/null
+++ b/config/hypr/UserConfigs/user_env.lua
@@ -0,0 +1,13 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User environment overrides template.
+-- Keep this file for personal env additions that should survive updates.
+
+-- Examples:
+-- hl.env("QT_QPA_PLATFORMTHEME", "qt6ct")
+-- hl.env("GDK_SCALE", "1")
+-- hl.env("QT_SCALE_FACTOR", "1")
diff --git a/config/hypr/UserConfigs/user_laptops.lua b/config/hypr/UserConfigs/user_laptops.lua
new file mode 100644
index 00000000..ac3c7f8c
--- /dev/null
+++ b/config/hypr/UserConfigs/user_laptops.lua
@@ -0,0 +1,12 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User laptop overrides template.
+-- Add lid/display behavior here if you need laptop-specific logic.
+
+-- Examples:
+-- hl.monitor({ output = "eDP-1", mode = "preferred", position = "auto", scale = "1" })
+-- hl.monitor({ output = "eDP-1", disabled = true })
diff --git a/config/hypr/UserConfigs/user_layer_rules.lua b/config/hypr/UserConfigs/user_layer_rules.lua
new file mode 100644
index 00000000..ab1cbeef
--- /dev/null
+++ b/config/hypr/UserConfigs/user_layer_rules.lua
@@ -0,0 +1,50 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User layer-rule overrides template.
+
+local user_layer_rules_helper = nil
+do
+  local source = (debug.getinfo(1, "S") or {}).source or ""
+  local source_path = source:match("^@(.+)$")
+  local source_dir = source_path and source_path:match("^(.*)/[^/]+$") or nil
+  local home = os.getenv("HOME") or ""
+  local candidate_paths = {
+    source_dir and (source_dir .. "/../lua/user_layer_rules_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/lua/user_layer_rules_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/user_layer_rules_helper.lua") or nil,
+  }
+
+  local tried_paths = {}
+  for _, helper_path in ipairs(candidate_paths) do
+    if helper_path then
+      table.insert(tried_paths, helper_path)
+      local f = io.open(helper_path, "r")
+      if f then
+        f:close()
+        local loaded_ok, loaded_helpers = pcall(dofile, helper_path)
+        if loaded_ok and type(loaded_helpers) == "table" and loaded_helpers.apply_layer_rule then
+          user_layer_rules_helper = loaded_helpers
+          break
+        end
+      end
+    end
+  end
+
+  if not user_layer_rules_helper then
+    error("Failed to load user_layer_rules_helper.lua from: " .. table.concat(tried_paths, ", "))
+  end
+end
+
+local apply_layer_rule = user_layer_rules_helper.apply_layer_rule
+
+-- Example:
+-- apply_layer_rule({
+--   name = "user-rofi-blur",
+--   match = { namespace = "rofi" },
+--   blur = true,
+--   ignore_alpha = 0,
+-- })
diff --git a/config/hypr/UserConfigs/user_settings.lua b/config/hypr/UserConfigs/user_settings.lua
new file mode 100644
index 00000000..ea31c0eb
--- /dev/null
+++ b/config/hypr/UserConfigs/user_settings.lua
@@ -0,0 +1,27 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User settings overrides template.
+-- Add your personal hl.config(...) values here.
+
+-- Example:
+-- hl.config({
+--   general = {
+--     gaps_in = 4,
+--     gaps_out = 8,
+--     border_size = 1,
+--   },
+-- })
+--
+
+-- Disable cursor being centered when swap workspaces
+--
+-- hl.config({
+-- 	cursor = {
+-- 		no_warps = true,
+-- 		warp_on_change_workspace = 0,
+-- 	},
+-- })
diff --git a/config/hypr/UserConfigs/user_startup.lua b/config/hypr/UserConfigs/user_startup.lua
new file mode 100644
index 00000000..efe51c61
--- /dev/null
+++ b/config/hypr/UserConfigs/user_startup.lua
@@ -0,0 +1,47 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User startup overrides template.
+-- Add personal exec-once commands here.
+
+local user_startup_helper = nil
+do
+  local source = (debug.getinfo(1, "S") or {}).source or ""
+  local source_path = source:match("^@(.+)$")
+  local source_dir = source_path and source_path:match("^(.*)/[^/]+$") or nil
+  local home = os.getenv("HOME") or ""
+  local candidate_paths = {
+    source_dir and (source_dir .. "/../lua/user_startup_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/lua/user_startup_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/user_startup_helper.lua") or nil,
+  }
+
+  local tried_paths = {}
+  for _, helper_path in ipairs(candidate_paths) do
+    if helper_path then
+      table.insert(tried_paths, helper_path)
+      local f = io.open(helper_path, "r")
+      if f then
+        f:close()
+        local loaded_ok, loaded_helpers = pcall(dofile, helper_path)
+        if loaded_ok and type(loaded_helpers) == "table" and loaded_helpers.exec_once then
+          user_startup_helper = loaded_helpers
+          break
+        end
+      end
+    end
+  end
+
+  if not user_startup_helper then
+    error("Failed to load user_startup_helper.lua from: " .. table.concat(tried_paths, ", "))
+  end
+end
+
+local exec_once = user_startup_helper.exec_once
+
+-- Examples:
+-- exec_once("blueman-applet")
+-- exec_once("$HOME/.config/hypr/UserScripts/RainbowBorders.sh")
diff --git a/config/hypr/UserConfigs/user_window_rules.lua b/config/hypr/UserConfigs/user_window_rules.lua
new file mode 100644
index 00000000..5df5dc7c
--- /dev/null
+++ b/config/hypr/UserConfigs/user_window_rules.lua
@@ -0,0 +1,50 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+-- User window-rule overrides template.
+
+local user_window_rules_helper = nil
+do
+  local source = (debug.getinfo(1, "S") or {}).source or ""
+  local source_path = source:match("^@(.+)$")
+  local source_dir = source_path and source_path:match("^(.*)/[^/]+$") or nil
+  local home = os.getenv("HOME") or ""
+  local candidate_paths = {
+    source_dir and (source_dir .. "/../lua/user_window_rules_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/lua/user_window_rules_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/user_window_rules_helper.lua") or nil,
+  }
+
+  local tried_paths = {}
+  for _, helper_path in ipairs(candidate_paths) do
+    if helper_path then
+      table.insert(tried_paths, helper_path)
+      local f = io.open(helper_path, "r")
+      if f then
+        f:close()
+        local loaded_ok, loaded_helpers = pcall(dofile, helper_path)
+        if loaded_ok and type(loaded_helpers) == "table" and loaded_helpers.apply_window_rule then
+          user_window_rules_helper = loaded_helpers
+          break
+        end
+      end
+    end
+  end
+
+  if not user_window_rules_helper then
+    error("Failed to load user_window_rules_helper.lua from: " .. table.concat(tried_paths, ", "))
+  end
+end
+
+local apply_window_rule = user_window_rules_helper.apply_window_rule
+
+-- Example:
+-- apply_window_rule({
+--   name = "user-float-pavucontrol",
+--   match = { class = "pavucontrol" },
+--   float = true,
+--   center = true,
+-- })