lua/cosmic-ui/init.lua

Intent

Root plugin module that users require (require("cosmic-ui")). It stores setup state indirectly via cosmic-ui.config and lazily loads feature modules (rename, codeactions, formatters) on first access.

Exposed API

setup(user_opts)

Initializes cosmic-ui config state and stores merged module options.

user_opts definition:

Field	Type	Required	Default	Description
notify_title	string|nil	No	"CosmicUI"	Notification title used by module logging/warnings.
rename	table|nil	No	disabled if omitted	Rename module config; set table to enable module.
rename.enabled	boolean|nil	No	true when table exists	Explicit enable/disable switch for rename module.
codeactions	table|nil	No	disabled if omitted	Codeactions module config; set table to enable module.
codeactions.enabled	boolean|nil	No	true when table exists	Explicit enable/disable switch for codeactions module.
formatters	table|nil	No	disabled if omitted	Formatters module config; set table to enable module.
formatters.enabled	boolean|nil	No	true when table exists	Explicit enable/disable switch for formatters module.

Module enable semantics:

• Missing module key (rename, codeactions, formatters) means disabled.
• enabled = false inside a module table disables that module.

is_setup() -> boolean

Returns whether setup() has already been called.

rename

Lazy-loaded proxy to require("cosmic-ui").rename module methods.

codeactions

Lazy-loaded proxy to require("cosmic-ui").codeactions module methods.

formatters

Lazy-loaded proxy to require("cosmic-ui").formatters module methods.

Usage

local CosmicUI = require("cosmic-ui")

CosmicUI.setup({
  rename = {},
  codeactions = {},
  formatters = {},
})

if require("cosmic-ui").is_setup() then
  require("cosmic-ui").codeactions.open()
end