update

Author: CppCXY

CHANGELOG.md

@@ -2,6 +2,58 @@
 
 *All notable changes to the EmmyLua Analyzer Rust project will be documented in this file.*
 
+## [0.20.0] - 2026-1-30
+### ✨ Added
+- **Support .emmyrc.lua configuration file**: The language server and emmylua_check now support loading configuration from `.emmyrc.lua` in addition to `.emmyrc.json` and `.luarc.json`. Lua configuration is parsed using the [luars](https://github.com/CppCXY/lua-rs) library. A basic config looks like:
+```lua
+local diagnostics = {
+  disable = { "undefined-global" },
+}
+
+return {
+  diagnostics = diagnostics,
+}
+```
+You can use standard libraries such as os, table, utf8, string to write more complex configuration logic. `print` can be used for debugging; its output is redirected to the language server log.
+
+Note: The current `.emmyrc.lua` does not have dedicated code completions; this will be added in a future release.
+Note2: The `luars` project was developed by me with AI assistance. It is an almost-complete Lua 5.5 implementation but is still experimental and contains many bugs. Use with caution.
+
+### 🔧 Changed
+- **Enhance workspace.library**: `workspace.library` now supports per-entry ignore configuration, for example:
+```json
+{
+  "workspace": {
+  "library": [
+    {
+    "path": "/path/to/lib1",
+    "ignoreGlobs": [ "**/test/**" ],
+    "ignoreDir": ["docs"]
+    }
+  ]
+  }
+}
+```
+Additionally, `workspace.library` can now point directly to a single file instead of a directory:
+```json
+{
+  "workspace": {
+  "library": [
+    "/path/to/single/file.lua"
+  ]
+  }
+}
+```
+
+- **Improve type narrowing for 'and'/'or'**: Improved type narrowing for the `and` and `or` operators when used with nullable types and table/literal expressions.
+
+### 🐛 Fixed
+- Fixed preferred_local_alias diagnostic
+- Fixed some type checking issues
+- Fixed recursive behavior in reference computation
+- Optimized generic-related computations
+
+
 ## [0.19.0] - 2025-12-25
 
 ### ✨ Added

Cargo.lock

@@ -7,9 +7,9 @@ members = [
 
 [workspace.dependencies]
 # local
-emmylua_code_analysis = { path = "crates/emmylua_code_analysis", version = "0.19.0" }
-emmylua_parser = { path = "crates/emmylua_parser", version = "0.21.0" }
-emmylua_parser_desc = { path = "crates/emmylua_parser_desc", version = "0.21.0" }
+emmylua_code_analysis = { path = "crates/emmylua_code_analysis", version = "0.20.0" }
+emmylua_parser = { path = "crates/emmylua_parser", version = "0.22.0" }
+emmylua_parser_desc = { path = "crates/emmylua_parser_desc", version = "0.22.0" }
 emmylua_diagnostic_macro = { path = "crates/emmylua_diagnostic_macro", version = "0.5.0" }
 
 # external
@@ -53,6 +53,7 @@ num-traits = { version = "0.2", features = ["std"] }
 mimalloc = "0.1.48"
 googletest = "0.14.2"
 unicode-general-category = "1.0.0"
+luars = { version = "0.1.0", features = ["serde"] }
 
 # Lint configuration for the entire workspace
 [workspace.lints.clippy]

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "emmylua_check"
-version = "0.19.0"
+version = "0.20.0"
 edition = "2024"
 authors = ["CppCXY"]
 description = "A command-line tool for checking lua code."

crates/emmylua_check/Cargo.toml

@@ -9,7 +9,7 @@ use std::path::PathBuf;
 #[cfg_attr(feature = "cli", command(version))]
 pub struct CmdArgs {
     /// Configuration file paths.
-    /// If not provided, both ".emmyrc.json" and ".luarc.json" will be searched in the workspace
+    /// If not provided, both ".emmyrc.json" ".emmyrc.lua" and ".luarc.json" will be searched in the workspace
     /// directory
     #[cfg_attr(feature = "cli", arg(short, long, value_delimiter = ','))]
     pub config: Option<Vec<PathBuf>>,

crates/emmylua_check/src/cmd_args.rs

@@ -1,6 +1,6 @@
 [package]
 name = "emmylua_code_analysis"
-version = "0.19.0"
+version = "0.20.0"
 edition = "2024"
 authors = ["CppCXY"]
 description = "A library for analyzing lua code."
@@ -49,6 +49,7 @@ serde_with.workspace = true
 include_dir.workspace = true
 emmylua_codestyle.workspace = true
 itertools.workspace = true
+luars.workspace = true
 
 [package.metadata.i18n]
 available-locales = ["en", "zh_CN", "zh_HK"]

crates/emmylua_code_analysis/Cargo.toml

@@ -2,7 +2,7 @@ use std::{collections::HashSet, path::PathBuf};
 
 use serde_json::Value;
 
-use crate::read_file_with_encoding;
+use crate::{config::lua_loader::load_lua_config, read_file_with_encoding};
 
 use super::{Emmyrc, flatten_config::FlattenConfigObject};
 
@@ -11,8 +11,8 @@ pub fn load_configs_raw(config_files: Vec<PathBuf>, partial_emmyrcs: Option<Vec<
 
     for config_file in config_files {
         log::info!("Loading config file: {:?}", config_file);
-        let config_json_str = match read_file_with_encoding(&config_file, "utf-8") {
-            Some(json_str) => json_str,
+        let config_content = match read_file_with_encoding(&config_file, "utf-8") {
+            Some(content) => content,
             None => {
                 log::error!(
                     "Failed to read config file: {:?}, error: File not found or unreadable",
@@ -22,19 +22,33 @@ pub fn load_configs_raw(config_files: Vec<PathBuf>, partial_emmyrcs: Option<Vec<
             }
         };
 
-        let config_json: Value = match serde_json::from_str(&config_json_str) {
-            Ok(json) => json,
-            Err(e) => {
-                log::error!(
-                    "Failed to parse config file: {:?}, error: {:?}",
-                    &config_file,
-                    e
-                );
-                continue;
+        let config_value = if config_file.extension().and_then(|s| s.to_str()) == Some("lua") {
+            match load_lua_config(&config_content) {
+                Ok(value) => value,
+                Err(e) => {
+                    log::error!(
+                        "Failed to parse lua config file: {:?}, error: {:?}",
+                        &config_file,
+                        e
+                    );
+                    continue;
+                }
+            }
+        } else {
+            match serde_json::from_str(&config_content) {
+                Ok(json) => json,
+                Err(e) => {
+                    log::error!(
+                        "Failed to parse config file: {:?}, error: {:?}",
+                        &config_file,
+                        e
+                    );
+                    continue;
+                }
             }
         };
 
-        config_jsons.push(config_json);
+        config_jsons.push(config_value);
     }
 
     if let Some(partial_emmyrcs) = partial_emmyrcs {

crates/emmylua_code_analysis/src/config/config_loader.rs

@@ -0,0 +1,51 @@
+use luars::{
+    LuaResult, LuaVM, LuaValue,
+    lua_vm::{LuaState, SafeOption},
+};
+use serde_json::Value;
+
+pub fn load_lua_config(content: &str) -> Result<Value, String> {
+    let mut lua = LuaVM::new(SafeOption {
+        max_call_depth: 64,
+        max_stack_size: 256,
+        max_memory_limit: 100 * 1024 * 1024, // 100 MB
+    });
+
+    let _ = lua.open_stdlib(luars::Stdlib::Package);
+    let _ = lua.open_stdlib(luars::Stdlib::Basic);
+    let _ = lua.open_stdlib(luars::Stdlib::Table);
+    let _ = lua.open_stdlib(luars::Stdlib::String);
+    let _ = lua.open_stdlib(luars::Stdlib::Math);
+    let _ = lua.open_stdlib(luars::Stdlib::Os);
+    let _ = lua.open_stdlib(luars::Stdlib::Utf8);
+    let _ = lua.set_global("print", LuaValue::cfunction(ls_println));
+
+    let values = match lua.execute_string(content) {
+        Ok(v) => v,
+        Err(e) => {
+            let err_msg = lua.main_state().get_error_msg(e);
+            return Err(format!("Failed to execute lua config: {:?}", err_msg));
+        }
+    };
+
+    if values.is_empty() {
+        return Err("Lua config did not return any value".to_string());
+    }
+
+    let value = values[0];
+    lua.serialize_to_json(&value)
+}
+
+fn ls_println(l: &mut LuaState) -> LuaResult<usize> {
+    let args = l.get_args();
+    let mut output = String::new();
+    for (index, arg) in args.iter().enumerate() {
+        let s = l.to_string(arg)?;
+        output.push_str(&s);
+        if index < args.len() - 1 {
+            output.push('\t');
+        }
+    }
+    log::info!("{}", output);
+    Ok(0)
+}

crates/emmylua_code_analysis/src/config/lua_loader/mod.rs

@@ -1,6 +1,7 @@
 mod config_loader;
 mod configs;
 mod flatten_config;
+mod lua_loader;
 mod pre_process;
 
 use std::{collections::HashMap, path::Path};

crates/emmylua_code_analysis/src/config/mod.rs

@@ -1,6 +1,6 @@
 [package]
 name = "emmylua_doc_cli"
-version = "0.19.0"
+version = "0.20.0"
 edition = "2024"
 authors = ["CppCXY"]
 description = "A command-line tool for generating lua documentation."