I will save this but will probably change this

.luarc.json

@@ -0,0 +1,8 @@
+{
+  "workspace.library": [
+    "./lsp"
+  ],
+  "diagnostics.disable": [
+    "undefined-global"
+  ]
+}

lsp/fes.lua

@@ -0,0 +1,31 @@
+---@meta
+
+---@class Fes
+---@field version string|nil
+---@field title string|nil
+---@field copyright string|nil
+---@field favicon string|nil
+---@field header string
+---@field footer string
+---@field parts string[]
+---@field [string] fun(self: Fes, ...: any): Fes
+
+local Fes = {}
+Fes.__index = Fes
+
+---@param header? string
+---@param footer? string
+---@return Fes
+function Fes.fes(header, footer) end
+
+---@param html string
+---@return Fes
+function Fes:custom(html) end
+
+---@return string
+function Fes:build() end
+
+---@return string
+function Fes:__tostring() end
+
+return Fes

lsp/std.lua

@@ -0,0 +1,155 @@
+---@meta
+
+---@class FesStd
+local M = {}
+
+---@return string
+function M.fes_version() end
+
+---@return string
+function M.site_version() end
+
+---@param link? string
+---@param str? string
+---@return string
+function M.a(link, str) end
+
+---@param link? string
+---@param str? string
+---@return string
+function M.ha(link, str) end
+
+---@param link string
+---@param str string
+---@return string
+function M.external(link, str) end
+
+---@param str string
+---@return string
+function M.note(str) end
+
+---@param str string
+---@return string
+function M.muted(str) end
+
+---@param str string
+---@return string
+function M.callout(str) end
+
+---@param str? string
+---@return string
+function M.h1(str) end
+
+---@param str? string
+---@return string
+function M.h2(str) end
+
+---@param str? string
+---@return string
+function M.h3(str) end
+
+---@param str? string
+---@return string
+function M.h4(str) end
+
+---@param str? string
+---@return string
+function M.h5(str) end
+
+---@param str? string
+---@return string
+function M.h6(str) end
+
+---@param str? string
+---@return string
+function M.p(str) end
+
+---@param str? string
+---@return string
+function M.pre(str) end
+
+---@param str? string
+---@return string
+function M.code(str) end
+
+---@param items? any[]
+---@return string
+function M.ul(items) end
+
+---@param items? any[]
+---@return string
+function M.ol(items) end
+
+---@param items? any[]
+---@return string
+function M.tl(items) end
+
+---@param str? string
+---@return string
+function M.blockquote(str) end
+
+---@return string
+function M.hr() end
+
+---@param src? string
+---@param alt? string
+---@return string
+function M.img(src, alt) end
+
+---@param str? string
+---@return string
+function M.strong(str) end
+
+---@param str? string
+---@return string
+function M.em(str) end
+
+---@return string
+function M.br() end
+
+---@param content? string
+---@param class? string
+---@return string
+function M.div(content, class) end
+
+---@param content? string
+---@param class? string
+---@return string
+function M.span(content, class) end
+
+---@param str any
+---@return string
+function M.escape(str) end
+
+---@return string
+function M.site_name() end
+
+---@return string
+function M.site_title() end
+
+---@return any[]
+function M.site_authors() end
+
+---@param str? string
+---@return string
+function M.highlight(str) end
+
+---@param str? string
+---@return string
+function M.banner(str) end
+
+---@param str? string
+---@return string
+function M.center(str) end
+
+---@param link? string
+---@param str? string
+---@return string
+function M.nav(link, str) end
+
+---@param right? string
+---@param left? string
+---@return string
+function M.rl(right, left) end
+
+return M

lsp/symbol.lua

@@ -0,0 +1,20 @@
+
+---@meta
+
+---@class FesSymbol
+local M = {}
+
+
+--@type string
+--@readonly
+M.copyright = "©"
+
+--@type string
+--@readonly
+M.registered_trademark = "®"
+
+--@type string
+--@readonly
+M.trademark = "™"
+
+return M

lsp/util.lua

@@ -0,0 +1,15 @@
+---@meta
+
+---@class CopyrightUtil
+local M = {}
+
+---@param tbl string[]
+---@return string
+function M.cc(tbl) end
+
+---@param link string
+---@param holder string
+---@return string
+function M.copyright(link, holder) end
+
+return M

main.go

@@ -11,6 +11,7 @@ import (
 
 	"fes/modules/config"
 	"fes/modules/doc"
+	"fes/modules/lsp"
 	"fes/modules/new"
 	"fes/modules/server"
 	"fes/modules/version"
@@ -19,6 +20,9 @@ import (
 //go:embed lib/*
 var lib embed.FS
 
+//go:embed lsp/*
+var lspStubs embed.FS
+
 //go:embed index.html
 var documentation string
 
@@ -27,20 +31,23 @@ func init() {
 	config.Color = flag.Bool("no-color", false, "Disable color output")
 	config.Static = flag.Bool("static", false, "Render and save all pages")
 	config.Docker = flag.Bool("docker", false, "Create a docker project")
+
 	config.Lib = lib
+	config.LspStubs = lspStubs
 	config.Doc = documentation
 }
 
 func main() {
 	flag.Usage = func() {
 		fmt.Fprintf(flag.CommandLine.Output(), "Usage: %s [options] <command> <project_dir>\n", os.Args[0])
-		fmt.Fprintf(os.Stderr, "Commands:")
+		fmt.Fprintln(flag.CommandLine.Output(), "Commands:")
-		fmt.Fprintf(os.Stderr, "  new <project_dir>   Create a new project")
+		fmt.Fprintln(flag.CommandLine.Output(), "  new <project_dir>   Create a new project")
-		fmt.Fprintf(os.Stderr, "  doc                 Open documentation")
+		fmt.Fprintln(flag.CommandLine.Output(), "  doc                 Open documentation")
-		fmt.Fprintf(os.Stderr, "  run <project_dir>   Start the server")
+		fmt.Fprintln(flag.CommandLine.Output(), "  run <project_dir>   Start the server")
-		fmt.Fprintf(os.Stderr, "Options:")
+		fmt.Fprintln(flag.CommandLine.Output(), "  lsp <sub_command>   Work with Lsp")
+		fmt.Fprintln(flag.CommandLine.Output(), "Options:")
 		flag.PrintDefaults()
-		fmt.Fprintf(os.Stderr, "For bug reports, contact a developer and describe the issue. Provide the output of the `-V1` flag.")
+		fmt.Fprintln(flag.CommandLine.Output(), "For bug reports, contact a developer and describe the issue. Provide the output of the `-V1` flag.")
 	}
 
 	showVersion := flag.Bool("version", false, "Show version and exit")
@@ -67,32 +74,39 @@ func main() {
 	}
 
 	cmd := args[0]
-	var dir string
+	var arg string
-	if cmd == "new" || cmd == "run" {
-		if len(args) < 2 {
-			fmt.Fprintf(os.Stderr, "Error: %s requires <project_dir>\n", cmd)
-			flag.Usage()
-			os.Exit(1)
-		}
-		dir = args[1]
-	}
 
-	switch cmd {
+	if cmd == "doc" {
-	case "new":
-		if err := new.Project(dir); err != nil {
-			fmt.Fprintln(os.Stderr, "Error:", err)
-			os.Exit(1)
-		}
-	case "doc":
 		if err := doc.Open(); err != nil {
 			fmt.Fprintln(os.Stderr, "Error:", err)
 			os.Exit(1)
 		}
+		os.Exit(0)
+	}
+
+	if len(args) < 2 {
+		fmt.Fprintln(os.Stderr, "Error: not enough arguments")
+		flag.Usage()
+		os.Exit(1)
+	}
+	arg = args[1]
+
+	switch cmd {
+	case "new":
+		if err := new.Project(arg); err != nil {
+			fmt.Fprintln(os.Stderr, "Error:", err)
+			os.Exit(1)
+		}
+	case "lsp":
+		if err := lsp.Do(arg); err != nil {
+			fmt.Fprintln(os.Stderr, "Error:", err)
+			os.Exit(1)
+		}
 	case "run":
-		if err := server.Start(dir); err != nil {
+		if err := server.Start(arg); err != nil {
 			if errors.Is(err, os.ErrNotExist) {
-				fmt.Fprintf(os.Stderr, "%s does not exist\n", dir)
+				fmt.Fprintf(os.Stderr, "%s does not exist\n", arg)
-				fmt.Fprintf(os.Stderr, "Try: fes new %s\n", dir)
+				fmt.Fprintf(os.Stderr, "Try: fes new %s\n", arg)
 				os.Exit(1)
 			} else {
 				fmt.Fprintln(os.Stderr, "Error:", err)

modules/config/config.go

@@ -6,6 +6,8 @@ import (
 )
 
 var Lib embed.FS
+var LspStubs embed.FS
+
 var Doc string
 var Port *int
 var Color *bool

modules/lsp/lsp.go

@@ -0,0 +1,173 @@
+package lsp
+
+import (
+	"embed"
+	"errors"
+	"flag"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"fes/modules/config"
+)
+
+var destRoot string = filepath.Join(func () string {
+	res, err := os.UserHomeDir()
+	if err != nil { panic(err) }
+	return res
+}(), ".local", "LuaAddons", "fes")
+
+func usage(status int) {
+	fmt.Fprintln(flag.CommandLine.Output(), "Lsp Usage:")
+	fmt.Fprintln(flag.CommandLine.Output(), "  help        Print this help and exit")
+	fmt.Fprintln(flag.CommandLine.Output(), "  install     Install the Lsp")
+	fmt.Fprintln(flag.CommandLine.Output(), "  uninstall   Uninstall the Lsp")
+	fmt.Fprintln(flag.CommandLine.Output(), "  doctor      Verify Lsp installation")
+	os.Exit(status)
+}
+
+func writeFile(fs embed.FS, src, dst string) error {
+	in, err := fs.Open(src)
+	if err != nil {
+		return err
+	}
+	defer in.Close()
+
+	if err := os.MkdirAll(filepath.Dir(dst), 0755); err != nil {
+		return err
+	}
+
+	out, err := os.Create(dst)
+	if err != nil {
+		return err
+	}
+	defer out.Close()
+
+	_, err = io.Copy(out, in)
+	return err
+}
+
+func install() error {
+	if err := os.RemoveAll(destRoot); err != nil {
+		return err
+	}
+
+	var found bool
+
+	err := fsWalkDir(config.LspStubs, "lsp", func(path string) error {
+		if path == "lsp" {
+			return nil
+		}
+
+		rel := strings.TrimPrefix(path, "lsp/")
+		dst := filepath.Join("library", destRoot, rel)
+
+		info, err := fsStat(config.LspStubs, path)
+		if err != nil {
+			return err
+		}
+
+		if info.IsDir() {
+			return os.MkdirAll(dst, 0755)
+		}
+
+		found = true
+		return writeFile(config.LspStubs, path, dst)
+	})
+
+	if err != nil {
+		return err
+	}
+
+	if !found {
+		return errors.New("no lsp stubs found in embedded fs")
+	}
+
+	err = os.WriteFile(filepath.Join("dstRoot", "config.json"), []byte(""), 0755)
+
+	fmt.Println("Lua LSP installed to:", destRoot)
+	return nil
+}
+
+func uninstall() error {
+	if _, err := os.Stat(destRoot); err != nil {
+		if os.IsNotExist(err) {
+			fmt.Println("Lua LSP not installed")
+			return nil
+		}
+		return err
+	}
+
+	if err := os.RemoveAll(destRoot); err != nil {
+		return err
+	}
+
+	fmt.Println("Lua LSP uninstalled from:", destRoot)
+	return nil
+}
+
+func doctor() error {
+	info, err := os.Stat(destRoot)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return errors.New("lsp not installed")
+		}
+		return err
+	}
+
+	if !info.IsDir() {
+		return errors.New("lsp install path is not a directory")
+	}
+
+	var luaFiles int
+
+	err = filepath.Walk(destRoot, func(path string, info os.FileInfo, err error) error {
+		if err != nil {
+			return err
+		}
+		if !info.IsDir() && strings.HasSuffix(info.Name(), ".lua") {
+			luaFiles++
+		}
+		return nil
+	})
+	if err != nil {
+		return err
+	}
+
+	if luaFiles == 0 {
+		return errors.New("no lua stubs found in lsp directory")
+	}
+
+	fmt.Println("LSP stubs: OK")
+	fmt.Println("Location:", destRoot)
+	fmt.Println()
+	fmt.Println("LuaLS configuration required:")
+	fmt.Println()
+	fmt.Println(`  "Lua.workspace.library": {`)
+	fmt.Printf(`    "%s": true`, destRoot)
+	fmt.Println()
+	fmt.Println(`  }`)
+	fmt.Println()
+	fmt.Println("Restart your editor after installing or updating the LSP stubs")
+
+	return nil
+}
+
+func Do(arg string) error {
+	switch arg {
+	case "help":
+		usage(0)
+	case "install":
+		return install()
+	case "uninstall":
+		return uninstall()
+	case "doctor":
+		return doctor()
+	default:
+		fmt.Fprintf(os.Stderr, "Unknown command: %s\n", arg)
+		usage(1)
+	}
+	return nil
+}

modules/lsp/util.go

@@ -0,0 +1,36 @@
+package lsp
+
+import (
+	"embed"
+	"os"
+	"path/filepath"
+)
+
+func fsWalkDir(fs embed.FS, root string, fn func(string) error) error {
+	entries, err := fs.ReadDir(root)
+	if err != nil {
+		return err
+	}
+
+	for _, e := range entries {
+		p := filepath.Join(root, e.Name())
+		if err := fn(p); err != nil {
+			return err
+		}
+		if e.IsDir() {
+			if err := fsWalkDir(fs, p, fn); err != nil {
+				return err
+			}
+		}
+	}
+	return nil
+}
+
+func fsStat(fs embed.FS, path string) (os.FileInfo, error) {
+	f, err := fs.Open(path)
+	if err != nil {
+		return nil, err
+	}
+	defer f.Close()
+	return f.Stat()
+}