feat: scan vendor framework config files as fallback

Scan vendor/laravel/framework/config/ for default config values
when the project does not override them with its own config/ file.
Project configs take precedence, then package service provider
configs, then framework defaults.

Also adds the same vendor scanning to config key enumeration so
completion and diagnostics know about framework default keys.

Author: calebdw

docs/CHANGELOG.md

@@ -9,7 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **Config return type inference.** `config('database.default')`, `Config::get('app.name')`, and `$repository->get('mail.from')` now infer their return type from the project's `config/*.php` files. Scalar values resolve to their base type (`string`, `int`, `bool`), `env()` defaults resolve through their fallback argument, and nested arrays resolve to array shapes with typed keys. Parsed config trees are cached and invalidated when config files change. Contributed by @calebdw.
+- **Config return type inference.** `config('database.default')`, `Config::get('app.name')`, and `$repository->get('mail.from')` now infer their return type from the project's `config/*.php` files. Scalar values resolve to their base type (`string`, `int`, `bool`), `env()` defaults resolve through their fallback argument, and nested arrays resolve to array shapes with typed keys. Framework default configs from `vendor/laravel/framework/config/` are scanned as a fallback when the project does not override them. Parsed config trees are cached and invalidated when config files change. Contributed by @calebdw.
 - **Semantic token modes.** `.phpantom.toml` now supports `[semantic_tokens] mode = "contextual" | "full" | "off"`. The default `contextual` mode emits only context-sensitive highlighting that complements editor syntax grammars, while `full` keeps the previous broad semantic-token stream and `off` disables semantic tokens. Contributed by @calebdw.
 - **`@phpstan-ignore` identifiers are highlighted and completed.** PHPStan ignore comments now highlight the `@phpstan-ignore` tag and each listed error identifier in both docblocks and ordinary `//` comments. Identifier completion works inside the comma-separated ignore list, using PHPStan diagnostic codes already seen in the current file while staying out of per-code parenthesized reasons. Contributed by @calebdw.
 - **Parent member override completion.** Typing a method name after `function` in a class body (for example `protected function get`) now suggests public and protected methods from parent classes and interfaces that can still be overridden or implemented, inserting a full signature snippet. The same flow suggests parent properties after `$` (for example `protected $tit`) and parent constants after `const`. Snippets insert `#[\Override]` above methods on PHP 8.3+, properties on PHP 8.5+, and constants on PHP 8.6+ (from `composer.json` / `config.platform.php`). Private members and ones already defined on the class are omitted. Contributed by @calebdw.

src/completion/laravel_string_keys.rs

@@ -324,6 +324,30 @@ impl Backend {
             }
         }
 
+        if let Some(root) = self.workspace.workspace_root.read().clone() {
+            let framework_config = root.join("vendor/laravel/framework/config");
+            if framework_config.is_dir()
+                && let Ok(entries) = std::fs::read_dir(&framework_config)
+            {
+                for entry in entries.flatten() {
+                    let path = entry.path();
+                    if !path.extension().is_some_and(|e| e == "php") {
+                        continue;
+                    }
+                    let Some(stem) = path.file_stem().and_then(|s| s.to_str()) else {
+                        continue;
+                    };
+                    let prefix = stem.to_string();
+                    if let Ok(content) = std::fs::read_to_string(&path) {
+                        let decls = collect_laravel_config_declarations(&content, &prefix);
+                        for d in decls {
+                            keys.push(d.key);
+                        }
+                    }
+                }
+            }
+        }
+
         keys.sort();
         keys.dedup();
         keys

src/virtual_members/laravel/config_values.rs

@@ -478,9 +478,11 @@ impl Backend {
     fn enumerate_config_trees(&self) -> Vec<(String, ConfigNode)> {
         use crate::virtual_members::laravel::laravel_config_prefix_from_uri;
 
-        let snapshot = self.user_file_symbol_maps();
         let mut trees = Vec::new();
+        let mut seen_prefixes = std::collections::HashSet::new();
 
+        // 1. Project config files take highest precedence.
+        let snapshot = self.user_file_symbol_maps();
         for (file_uri, _) in &snapshot {
             let Some(prefix) = laravel_config_prefix_from_uri(file_uri) else {
                 continue;
@@ -489,18 +491,51 @@ impl Backend {
                 continue;
             };
             if let Some(tree) = parse_config_tree(&content) {
+                seen_prefixes.insert(prefix.clone());
                 trees.push((prefix, tree));
             }
         }
 
+        // 2. Package config files from service providers.
         for res in &self.laravel_provider_resources.read().config_files {
+            if seen_prefixes.contains(&res.namespace) {
+                continue;
+            }
             if let Ok(content) = std::fs::read_to_string(&res.path)
                 && let Some(tree) = parse_config_tree(&content)
             {
+                seen_prefixes.insert(res.namespace.clone());
                 trees.push((res.namespace.clone(), tree));
             }
         }
 
+        // 3. Laravel framework default configs from vendor.
+        if let Some(root) = self.workspace.workspace_root.read().clone() {
+            let framework_config = root.join("vendor/laravel/framework/config");
+            if framework_config.is_dir()
+                && let Ok(entries) = std::fs::read_dir(&framework_config)
+            {
+                for entry in entries.flatten() {
+                    let path = entry.path();
+                    if !path.extension().is_some_and(|e| e == "php") {
+                        continue;
+                    }
+                    let Some(stem) = path.file_stem().and_then(|s| s.to_str()) else {
+                        continue;
+                    };
+                    let prefix = stem.to_string();
+                    if seen_prefixes.contains(&prefix) {
+                        continue;
+                    }
+                    if let Ok(content) = std::fs::read_to_string(&path)
+                        && let Some(tree) = parse_config_tree(&content)
+                    {
+                        trees.push((prefix, tree));
+                    }
+                }
+            }
+        }
+
         trees
     }
 }

tests/integration/hover.rs

@@ -248,6 +248,52 @@ function test(): void {
     );
 }
 
+#[test]
+fn hover_config_vendor_framework_fallback() {
+    let (backend, _dir) = create_psr4_workspace(
+        r#"{ "autoload": { "psr-4": { "App\\": "src/" } } }"#,
+        &[
+            (
+                "config/app.php",
+                "<?php\nreturn [\n    'name' => env('APP_NAME', 'Laravel'),\n];\n",
+            ),
+            (
+                "vendor/laravel/framework/config/app.php",
+                "<?php\nreturn [\n    'name' => env('APP_NAME', 'Laravel'),\n    'faker_locale' => 'en_US',\n    'timezone' => 'UTC',\n];\n",
+            ),
+            (
+                "vendor/laravel/framework/config/cache.php",
+                "<?php\nreturn [\n    'default' => env('CACHE_STORE', 'database'),\n    'prefix' => env('CACHE_PREFIX', ''),\n];\n",
+            ),
+        ],
+    );
+
+    let uri = "file:///test_vendor_config.php";
+    let content = r#"<?php
+function test(): void {
+    $locale = config('app.faker_locale');
+    $locale;
+    $cache = config('cache.default');
+    $cache;
+}
+"#;
+    backend.update_ast(uri, content);
+
+    let h = hover_at(&backend, uri, content, 3, 6).expect("hover on $locale");
+    let text = hover_text(&h);
+    assert!(
+        text.contains("string"),
+        "vendor framework config should provide app.faker_locale as string: {text}"
+    );
+
+    let h = hover_at(&backend, uri, content, 5, 6).expect("hover on $cache");
+    let text = hover_text(&h);
+    assert!(
+        text.contains("string"),
+        "vendor framework config should provide cache.default as string: {text}"
+    );
+}
+
 #[test]
 fn hover_variable_without_type() {
     let backend = create_test_backend();