refactor code structure

noctalia.lua

@@ -1,10 +1,13 @@
 -- Generated by Noctalia
+-- This file is the generated color boundary: config/appearance.lua calls
+-- apply_theme(), while other modules remain independent of palette values.
 
 local primary = "rgb(fff59b)"
 local surface = "rgb(070722)"
 local secondary = "rgb(a9aefe)"
 local error = "rgb(fd4663)"
 
+-- Apply generated colors to regular borders, grouped windows, and group tabs.
 local function apply_theme()
     hl.config({
         general = {
@@ -35,11 +38,14 @@ local function apply_theme()
 end
 
 return {
+    -- Expose the raw palette for future modules that need matching colors.
     colors = {
         primary = primary,
         surface = surface,
         secondary = secondary,
         error = error,
     },
+    -- Keep application explicit so requiring this generated file has no side
+    -- effects on its own.
     apply_theme = apply_theme
 }