fix(generator): support DbContext/entities declared in the global namespace

README.md

@@ -680,6 +680,11 @@ dotnet add package BLite
 ### 2. Basic Usage
 
 ```csharp
+using BLite.Bson;              // ObjectId
+using BLite.Core;              // DocumentDbContext
+using BLite.Core.Collections;  // DocumentCollection<TId, T>, UpsertResult<T>
+using BLite.Core.Query;        // async LINQ extensions (ToListAsync, ...)
+
 // 1. Define your Entities
 public class User 
 { 

src/BLite.SourceGenerators/EntityAnalyzer.cs

@@ -14,7 +14,7 @@ public static EntityInfo Analyze(INamedTypeSymbol entityType, SemanticModel sema
             var entityInfo = new EntityInfo
             {
                 Name = entityType.Name,
-                Namespace = entityType.ContainingNamespace.ToDisplayString(),
+                Namespace = SyntaxHelper.GetNamespaceOrEmpty(entityType),
                 FullTypeName = SyntaxHelper.GetFullName(entityType),
                 CollectionName = entityType.Name.ToLowerInvariant() + BLiteConventions.DefaultCollectionNameSuffix
             };
@@ -342,7 +342,7 @@ private static void AnalyzeNestedTypesRecursive(
                  var nestedInfo = new NestedTypeInfo
                  {
                      Name = simpleName,
-                     Namespace = nestedTypeSymbol.ContainingNamespace.ToDisplayString(),
+                     Namespace = SyntaxHelper.GetNamespaceOrEmpty(nestedTypeSymbol),
                      FullTypeName = fullTypeName,
                      Depth = currentDepth
                  };

src/BLite.SourceGenerators/Helpers/SyntaxHelper.cs

@@ -100,6 +100,18 @@ public static string GetFullName(INamedTypeSymbol symbol)
                 .Replace("global::", "");
         }
 
+        /// <summary>
+        /// Returns the containing namespace's display string, or an empty string when the
+        /// symbol lives in the global namespace. <see cref="INamespaceSymbol.ToDisplayString()"/>
+        /// returns the literal text "&lt;global namespace&gt;" for global types, which produces
+        /// invalid source and invalid generator hint names if used directly.
+        /// </summary>
+        public static string GetNamespaceOrEmpty(ISymbol symbol)
+        {
+            var ns = symbol.ContainingNamespace;
+            return ns is { IsGlobalNamespace: false } ? ns.ToDisplayString() : string.Empty;
+        }
+
         public static string GetTypeName(ITypeSymbol type)
         {
             if (type is INamedTypeSymbol namedType && 

src/BLite.SourceGenerators/MapperGenerator.cs

@@ -126,7 +126,9 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
                 sb.AppendLine();
 
                 // Use safeName (Context + Filename) to avoid collisions
-                var mapperNamespace = $"{dbContext.Namespace}.{safeName}_Mappers";
+                var mapperNamespace = string.IsNullOrEmpty(dbContext.Namespace)
+                    ? $"{safeName}_Mappers"
+                    : $"{dbContext.Namespace}.{safeName}_Mappers";
                 sb.AppendLine($"namespace {mapperNamespace}");
                 sb.AppendLine($"{{");
 
@@ -169,8 +171,14 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
                 // Partial DbContext for InitializeCollections (Only for top-level partial classes)
                 if (!dbContext.IsNested && dbContext.IsPartial)
                 {
-                    sb.AppendLine($"namespace {dbContext.Namespace}");
-                    sb.AppendLine($"{{");
+                    // Global-namespace DbContexts (e.g. declared in a top-level Program.cs)
+                    // emit the partial class without a namespace wrapper.
+                    var wrapNamespace = !string.IsNullOrEmpty(dbContext.Namespace);
+                    if (wrapNamespace)
+                    {
+                        sb.AppendLine($"namespace {dbContext.Namespace}");
+                        sb.AppendLine($"{{");
+                    }
                     sb.AppendLine($"    public partial class {dbContext.ClassName}");
                     sb.AppendLine($"    {{");
                     sb.AppendLine($"        protected override void InitializeCollections()");
@@ -289,10 +297,16 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
                     }
 
                     sb.AppendLine($"    }}");
-                    sb.AppendLine($"}}");
+                    if (wrapNamespace)
+                    {
+                        sb.AppendLine($"}}");
+                    }
                 }
-
-                spc.AddSource($"{dbContext.Namespace}.{safeName}.Mappers.g.cs", sb.ToString());
+
+                var hintName = string.IsNullOrEmpty(dbContext.Namespace)
+                    ? $"{safeName}.Mappers.g.cs"
+                    : $"{dbContext.Namespace}.{safeName}.Mappers.g.cs";
+                spc.AddSource(hintName, sb.ToString());
             });
 
             // ── Filter pipeline: emit exactly one {Entity}Filter per unique entity type ──
@@ -808,7 +822,7 @@ private static string EscapeString(string s)
             var info = new DbContextInfo
             {
                 ClassName = classSymbol.Name,
-                Namespace = classSymbol.ContainingNamespace.ToDisplayString(),
+                Namespace = SyntaxHelper.GetNamespaceOrEmpty(classSymbol),
                 FilePath = classDecl.SyntaxTree.FilePath,
                 IsNested = classSymbol.ContainingType != null,
                 IsPartial = classDecl.Modifiers.Any(m => m.IsKind(Microsoft.CodeAnalysis.CSharp.SyntaxKind.PartialKeyword)),