@tsonic/efcore 10.0.11 → 10.0.16

package/Microsoft.EntityFrameworkCore.ValueGeneration.Internal/internal/index.d.ts

@@ -22,7 +22,6 @@ export interface ConvertedValueGenerator$instance extends ValueGenerator {
     readonly GeneratesStableValues: boolean;
     readonly GeneratesTemporaryValues: boolean;
     NextAsync(entry: EntityEntry, cancellationToken?: CancellationToken): ValueTask_1<unknown>;
-    NextAsync(entry: EntityEntry, cancellationToken?: CancellationToken): ValueTask_1<unknown>;
     NextValue(entry: EntityEntry): unknown | undefined;
 }
 
@@ -54,8 +53,8 @@ export interface TemporaryBinaryValueGenerator$instance extends ValueGenerator_1
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryBinaryValueGenerator: never;
 
     readonly GeneratesTemporaryValues: boolean;
-    Next4(entry: EntityEntry): byte[];
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): byte[];
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -69,8 +68,8 @@ export type TemporaryBinaryValueGenerator = TemporaryBinaryValueGenerator$instan
 export interface TemporaryByteValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Byte> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryByteValueGenerator: never;
 
-    Next4(entry: EntityEntry): byte;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): byte;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -84,8 +83,8 @@ export type TemporaryByteValueGenerator = TemporaryByteValueGenerator$instance;
 export interface TemporaryCharValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Char> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryCharValueGenerator: never;
 
-    Next4(entry: EntityEntry): char;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): char;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -100,8 +99,8 @@ export interface TemporaryDateTimeOffsetValueGenerator$instance extends ValueGen
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryDateTimeOffsetValueGenerator: never;
 
     readonly GeneratesTemporaryValues: boolean;
-    Next4(entry: EntityEntry): DateTimeOffset;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): DateTimeOffset;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -116,8 +115,8 @@ export interface TemporaryDateTimeValueGenerator$instance extends ValueGenerator
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryDateTimeValueGenerator: never;
 
     readonly GeneratesTemporaryValues: boolean;
-    Next4(entry: EntityEntry): DateTime;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): DateTime;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -131,8 +130,8 @@ export type TemporaryDateTimeValueGenerator = TemporaryDateTimeValueGenerator$in
 export interface TemporaryDecimalValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Decimal> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryDecimalValueGenerator: never;
 
-    Next4(entry: EntityEntry): decimal;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): decimal;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -146,8 +145,8 @@ export type TemporaryDecimalValueGenerator = TemporaryDecimalValueGenerator$inst
 export interface TemporaryDoubleValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Double> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryDoubleValueGenerator: never;
 
-    Next4(entry: EntityEntry): double;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): double;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -161,8 +160,8 @@ export type TemporaryDoubleValueGenerator = TemporaryDoubleValueGenerator$instan
 export interface TemporaryFloatValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Single> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryFloatValueGenerator: never;
 
-    Next4(entry: EntityEntry): float;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): float;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -176,8 +175,8 @@ export type TemporaryFloatValueGenerator = TemporaryFloatValueGenerator$instance
 export interface TemporaryIntValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Int32> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryIntValueGenerator: never;
 
-    Next4(entry: EntityEntry): int;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): int;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -191,8 +190,8 @@ export type TemporaryIntValueGenerator = TemporaryIntValueGenerator$instance;
 export interface TemporaryLongValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Int64> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryLongValueGenerator: never;
 
-    Next4(entry: EntityEntry): long;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): long;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -219,8 +218,8 @@ export type TemporaryNumberValueGenerator_1<TValue> = TemporaryNumberValueGenera
 export interface TemporarySByteValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.SByte> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporarySByteValueGenerator: never;
 
-    Next4(entry: EntityEntry): sbyte;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): sbyte;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -234,8 +233,8 @@ export type TemporarySByteValueGenerator = TemporarySByteValueGenerator$instance
 export interface TemporaryShortValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.Int16> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryShortValueGenerator: never;
 
-    Next4(entry: EntityEntry): short;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): short;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -250,8 +249,8 @@ export interface TemporaryStringValueGenerator$instance extends ValueGenerator_1
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryStringValueGenerator: never;
 
     readonly GeneratesTemporaryValues: boolean;
-    Next4(entry: EntityEntry): string;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): string;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -265,8 +264,8 @@ export type TemporaryStringValueGenerator = TemporaryStringValueGenerator$instan
 export interface TemporaryUIntValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.UInt32> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryUIntValueGenerator: never;
 
-    Next4(entry: EntityEntry): uint;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): uint;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -280,8 +279,8 @@ export type TemporaryUIntValueGenerator = TemporaryUIntValueGenerator$instance;
 export interface TemporaryULongValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.UInt64> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryULongValueGenerator: never;
 
-    Next4(entry: EntityEntry): ulong;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): ulong;
+    Next(entry: EntityEntry): unknown;
 }
 
 
@@ -295,8 +294,8 @@ export type TemporaryULongValueGenerator = TemporaryULongValueGenerator$instance
 export interface TemporaryUShortValueGenerator$instance extends TemporaryNumberValueGenerator_1<System_Internal.UInt16> {
     readonly __tsonic_type_Microsoft_EntityFrameworkCore_ValueGeneration_Internal_TemporaryUShortValueGenerator: never;
 
-    Next4(entry: EntityEntry): ushort;
-    Next4(entry: EntityEntry): unknown;
+    Next(entry: EntityEntry): ushort;
+    Next(entry: EntityEntry): unknown;
 }
 
 

package/README.md

@@ -1,5 +1,122 @@
 # @tsonic/efcore
 
-TypeScript type definitions for `Microsoft.EntityFrameworkCore.*` for .NET 10.
+TypeScript type definitions for **Entity Framework Core 10** (`Microsoft.EntityFrameworkCore.*`) for use with the **Tsonic** compiler (TypeScript → .NET).
 
-Generated by `tsbindgen` from NuGet packages and intended for use with the Tsonic compiler.
+This package is generated by `tsbindgen` from the official NuGet assemblies and is intended to give you an editor-friendly, strongly typed surface while compiling to real EF Core APIs.
+
+## What this package is (and isn’t)
+
+- ✅ **It is** a TypeScript type package (`.d.ts`) + ESM stubs for the EF Core assemblies.
+- ❌ **It is not** a JavaScript runtime implementation of EF Core (the `.js` files are module stubs for type-only use).
+- ✅ **You still need** the actual **.NET assemblies** via NuGet in your Tsonic workspace (see below).
+
+## Install (types)
+
+```bash
+npm install @tsonic/efcore @tsonic/dotnet @tsonic/core
+```
+
+## Use with Tsonic (recommended)
+
+If you want a deterministic “one command” setup for both the **.NET assemblies** and the **TypeScript bindings**, use `tsonic add nuget` and pass this package as the `types` argument:
+
+```bash
+tsonic add nuget Microsoft.EntityFrameworkCore <version> @tsonic/efcore
+```
+
+If you omit the `@tsonic/efcore` argument, Tsonic will generate bindings locally instead.
+
+### Providers
+
+Pick the provider that matches your database:
+
+- SQLite: `@tsonic/efcore-sqlite`
+- SQL Server: `@tsonic/efcore-sqlserver`
+- PostgreSQL (Npgsql): `@tsonic/efcore-npgsql`
+
+Example:
+
+```bash
+tsonic add nuget Microsoft.EntityFrameworkCore.Sqlite <version> @tsonic/efcore-sqlite
+```
+
+## Imports
+
+The package is shipped as **ESM**. Import EF Core namespaces via explicit module paths:
+
+```ts
+import { DbContext, DbContextOptions, DbSet } from "@tsonic/efcore/Microsoft.EntityFrameworkCore.js";
+```
+
+Provider-specific APIs come from the provider package:
+
+```ts
+import { SqliteDbContextOptionsBuilderExtensions } from "@tsonic/efcore-sqlite/Microsoft.EntityFrameworkCore.js";
+```
+
+## LINQ + EF extension methods (idiomatic queries)
+
+EF Core relies heavily on **extension methods** (LINQ operators like `Where`/`Select` and EF async operators like `CountAsync`/`ToArrayAsync`).
+
+In Tsonic, you opt into a “C# using semantics” extension surface by wrapping the receiver with `asinterface<...>` and the generated `ExtensionMethods` helpers:
+
+```ts
+import { asinterface } from "@tsonic/core/lang.js";
+import type { ExtensionMethods as Linq } from "@tsonic/dotnet/System.Linq.js";
+import type { ExtensionMethods as Ef } from "@tsonic/efcore/Microsoft.EntityFrameworkCore.js";
+import type { DbSet } from "@tsonic/efcore/Microsoft.EntityFrameworkCore.js";
+
+type DbSetQuery<T> = Ef<Linq<DbSet<T>>>;
+
+// Example: turn a DbSet<T> into something that has LINQ + EF async operators.
+const q = asinterface<DbSetQuery<PostEntity>>(db.posts);
+
+const pageviews = await q.Where((p) => p.Published === true).CountAsync();
+const rows = await q.Where((p) => p.Published === true).ToArrayAsync();
+```
+
+You can always call extension methods via their static classes as well, but the pattern above gives you the most idiomatic “instance-style” call sites.
+
+## Example
+
+Minimal `DbContext` + options:
+
+```ts
+import { DbContext, DbContextOptions, DbContextOptionsBuilder, DbSet } from "@tsonic/efcore/Microsoft.EntityFrameworkCore.js";
+import { SqliteDbContextOptionsBuilderExtensions } from "@tsonic/efcore-sqlite/Microsoft.EntityFrameworkCore.js";
+
+export class BlogDbContext extends DbContext {
+  get posts(): DbSet<PostEntity> {
+    return this.Set<PostEntity>();
+  }
+
+  constructor(options: DbContextOptions) {
+    super(options);
+  }
+}
+
+export const createDbOptions = (dbPath: string): DbContextOptions => {
+  const optionsBuilder = new DbContextOptionsBuilder();
+  SqliteDbContextOptionsBuilderExtensions.UseSqlite(optionsBuilder, `Data Source=${dbPath}`);
+  return optionsBuilder.Options;
+};
+```
+
+## Versioning
+
+This repo is versioned by **.NET major**:
+
+- .NET 10 → npm: `@tsonic/efcore@10.x`
+
+## Development (regenerating bindings)
+
+This repo is generated from NuGet assemblies:
+
+```bash
+npm install
+npm run generate:10
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsonic/efcore",
-  "version": "10.0.11",
+  "version": "10.0.16",
   "description": "TypeScript type definitions for Microsoft.EntityFrameworkCore.* for .NET 10",
   "type": "module",
   "keywords": [
@@ -19,8 +19,8 @@
     "url": "https://github.com/tsoniclang/efcore.git"
   },
   "peerDependencies": {
-    "@tsonic/core": "10.0.11",
-    "@tsonic/dotnet": "10.0.11",
-    "@tsonic/microsoft-extensions": "10.0.11"
+    "@tsonic/core": "10.0.16",
+    "@tsonic/dotnet": "10.0.16",
+    "@tsonic/microsoft-extensions": "10.0.16"
   }
 }