Commit all pending workspace changes

Author: mrdevrobot

BLite.Server.sln

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
@@ -7,15 +7,22 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <RootNamespace>BLite.Sample</RootNamespace>
     <AssemblyName>BLite.Sample</AssemblyName>
+    <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
   </PropertyGroup>
 
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="10.0.*" />
     <PackageReference Include="Scalar.AspNetCore" Version="2.*" />
+    <PackageReference Include="BLite.SourceGenerators" Version="3.6.4">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
   </ItemGroup>
 
   <ItemGroup>
     <ProjectReference Include="..\..\src\BLite.Client\BLite.Client.csproj" />
+    <ProjectReference Include="..\..\src\BLite.Client.SourceGenerators\BLite.Client.SourceGenerators.csproj"
+                      OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
   </ItemGroup>
 
 </Project>

global.json

@@ -0,0 +1,31 @@
+// BLite.Sample — Product entity
+// Copyright (C) 2026 Luca Fabbri — AGPL-3.0
+
+using BLite.Bson;
+
+namespace BLite.Sample;
+
+/// <summary>
+/// Product catalog entity.  The source generator discovers it through the
+/// <see cref="ProductCatalogContext.Products"/> property and produces:
+///   • a C-BSON serialiser/deserialiser (<c>ProductCatalogContext_*_Mappers.BLite_Sample_ProductMapper</c>)
+///   • the <c>InitializeCollections</c> override that wires the collection property
+/// Default collection name: "products" (lowercase class name + "s").
+/// </summary>
+public class Product
+{
+    [BsonId]
+    public ObjectId Id { get; set; }
+
+    public string Name { get; set; } = string.Empty;
+
+    public string Category { get; set; } = string.Empty;
+
+    public double Price { get; set; }
+
+    public int Stock { get; set; }
+
+    public bool Active { get; set; } = true;
+
+    public DateTime CreatedAt { get; set; }
+}

samples/BLite.Sample/BLite.Sample.csproj

@@ -0,0 +1,38 @@
+// BLite.Sample — ProductCatalogContext
+// Copyright (C) 2026 Luca Fabbri — AGPL-3.0
+//
+// Remote document context.  Two source generators cooperate at compile time:
+//
+//   BLite.SourceGenerators (from the BLite core repo):
+//     - Analyses the Products property and generates the C-BSON mapper for Product
+//     - Generates the InitializeCollections() override that assigns Products
+//
+//   BLite.Client.SourceGenerators (from this repo):
+//     - Generates: ProductCatalogContext(BLiteClient client) : base()
+//     - Generates: CreateCollection<TId,T> override → client.GetDocumentCollection(mapper)
+//
+// Usage:
+//   services.AddSingleton(sp => new ProductCatalogContext(sp.GetRequiredService<BLiteClient>()));
+//   ...
+//   app.MapGet("/products", async (ProductCatalogContext db, CancellationToken ct) =>
+//       TypedResults.Ok(await db.Products.AsQueryable().ToListAsync(ct)));
+
+using BLite.Bson;
+using BLite.Core;
+using BLite.Core.Collections;
+using BLite.Core.Metadata;
+
+namespace BLite.Sample;
+
+public partial class ProductCatalogContext : DocumentDbContext
+{
+    public IDocumentCollection<ObjectId, Product> Products { get; set; } = null!;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        base.OnModelCreating(modelBuilder);
+
+        modelBuilder.Entity<Product>()
+            .HasKey(p => p.Id);
+    }
+}