feat: add internal tag

This commit introduces the `internal` tag to mark items with internal visibility.
Note that the usage of `---@field internal xx integer` is not supported, as "internal" is already reserved for field names.

Author: CppCXY

crates/emmylua_code_analysis/src/db_index/module/mod.rs

@@ -409,7 +409,19 @@ impl LuaModuleIndex {
     }
 
     pub fn is_std(&self, file_id: &FileId) -> bool {
-        self.get_std_file_ids().contains(file_id)
+        if let Some(module_info) = self.file_module_map.get(file_id) {
+            return module_info.workspace_id == WorkspaceId::STD;
+        }
+
+        false
+    }
+
+    pub fn is_library(&self, file_id: &FileId) -> bool {
+        if let Some(module_info) = self.file_module_map.get(file_id) {
+            return module_info.workspace_id.is_library();
+        }
+
+        false
     }
 
     pub fn get_main_workspace_file_ids(&self) -> Vec<FileId> {
@@ -447,6 +459,14 @@ impl LuaModuleIndex {
 
         false
     }
+
+    pub fn get_workspace_id(&self, file_id: FileId) -> Option<WorkspaceId> {
+        if let Some(module_info) = self.file_module_map.get(&file_id) {
+            return Some(module_info.workspace_id);
+        }
+
+        None
+    }
 }
 
 impl LuaIndex for LuaModuleIndex {

crates/emmylua_code_analysis/src/diagnostic/checker/access_invisible.rs

@@ -125,6 +125,9 @@ fn report_reason(
             VisibilityKind::Package => {
                 t!("The property is package-private and cannot be accessed outside the package.")
             }
+            VisibilityKind::Internal => {
+                t!("The property is internal and cannot be accessed outside the module.")
+            }
             _ => {
                 return None;
             }

crates/emmylua_code_analysis/src/semantic/visibility/mod.rs

@@ -26,17 +26,32 @@ pub fn check_visibility(
 
     if let Some(visibility) = property.visibility {
         match visibility {
-            VisibilityKind::None |
-            // this donot use
-            VisibilityKind::Internal |
-            VisibilityKind::Public => return Some(true),
-            VisibilityKind::Protected |
-            VisibilityKind::Private => {
-                return Some(check_visibility_by_visibility(db, infer_config, file_id, property_owner, token, visibility).unwrap_or(false));
-            },
+            VisibilityKind::None | VisibilityKind::Public => return Some(true),
+            VisibilityKind::Protected | VisibilityKind::Private => {
+                return Some(
+                    check_visibility_by_visibility(
+                        db,
+                        infer_config,
+                        file_id,
+                        property_owner,
+                        token,
+                        visibility,
+                    )
+                    .unwrap_or(false),
+                );
+            }
             VisibilityKind::Package => {
                 return Some(file_id == property_owner.get_file_id()?);
-            },
+            }
+            VisibilityKind::Internal => {
+                let property_file_id = property_owner.get_file_id()?;
+                let property_workspace_id =
+                    db.get_module_index().get_workspace_id(property_file_id)?;
+                let current_workspace_id = db.get_module_index().get_workspace_id(file_id)?;
+                if current_workspace_id != property_workspace_id {
+                    return Some(false);
+                }
+            }
         }
     }
 

crates/emmylua_ls/src/handlers/completion/data/doc_tags.rs

@@ -17,6 +17,7 @@ pub const DOC_TAGS: &[&str] = &[
     "protected",
     "private",
     "package",
+    "internal",
     "meta",
     "diagnostic",
     "version",

crates/emmylua_parser/src/lexer/lua_doc_lexer.rs

@@ -555,7 +555,9 @@ fn to_tag(text: &str) -> LuaTokenKind {
         "async" => LuaTokenKind::TkTagAsync,
         "cast" => LuaTokenKind::TkTagCast,
         "deprecated" => LuaTokenKind::TkTagDeprecated,
-        "private" | "protected" | "public" | "package" => LuaTokenKind::TkTagVisibility,
+        "private" | "protected" | "public" | "package" | "internal" => {
+            LuaTokenKind::TkTagVisibility
+        }
         "readonly" => LuaTokenKind::TkTagReadonly,
         "diagnostic" => LuaTokenKind::TkTagDiagnostic,
         "meta" => LuaTokenKind::TkTagMeta,