@tsonic/core 0.6.3 → 10.0.3

package/README.md

@@ -2,6 +2,14 @@
 
 Core type definitions for Tsonic - a TypeScript to native compiler.
 
+## Versioning
+
+This repo is versioned by **.NET major**:
+
+- **.NET 10** → `versions/10/` → npm: `@tsonic/core@10.x`
+
+When publishing, run: `npm publish versions/10 --access public`
+
 ## Installation
 
 ```bash

package/lang.d.ts

@@ -169,6 +169,52 @@ export declare function nameof(expression: unknown): string;
  */
 export declare function trycast<T>(value: unknown): T | null;
 
+/**
+ * Compile-time-only interface view.
+ *
+ * This is NOT a runtime cast. The compiler must erase this call before emitting C#.
+ *
+ * Primary use: treat a value as a CLR interface/nominal type for TypeScript type checking,
+ * without introducing runtime casts in emitted C# (important for EF Core precompilation).
+ *
+ * @example
+ * ```ts
+ * import { asinterface } from "@tsonic/core/lang.js";
+ * import type { IQueryable } from "@tsonic/dotnet/System.Linq.js";
+ *
+ * const q = asinterface<IQueryable<User>>(db.Users);
+ * // q is typed as IQueryable<User> in TS, but emits without a cast in C#.
+ * ```
+ */
+export declare function asinterface<T>(value: unknown): T;
+
+/**
+ * Compile-time-only type selection marker.
+ *
+ * This is NOT a runtime type test. The compiler must erase this call before emitting C#.
+ *
+ * Primary use: specialize a single TypeScript overload implementation into one CLR method
+ * per signature (e.g., overriding a protected virtual overload family).
+ *
+ * @example
+ * ```ts
+ * import { istype } from "@tsonic/core/lang.js";
+ * import type { int } from "@tsonic/core/types.js";
+ *
+ * // Overload signatures
+ * Foo(x: int): int;
+ * Foo(x: string): int;
+ *
+ * // Single implementation (compile-time specialized)
+ * Foo(p0: unknown): unknown {
+ *   if (istype<int>(p0)) return p0 + 1;
+ *   if (istype<string>(p0)) return p0.length;
+ *   throw new Error("unreachable");
+ * }
+ * ```
+ */
+export declare function istype<T>(value: unknown): value is T;
+
 // ============================================================================
 // Extension Method Intrinsics
 // ============================================================================
@@ -203,6 +249,6 @@ export type thisarg<T> = T;
  * Used as the return type of stackalloc.
  */
 export interface Span<T> {
-  readonly length: int;
+  readonly Length: int;
   [index: number]: T;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tsonic/core",
-  "version": "0.6.3",
-  "description": "Core type definitions for Tsonic - TypeScript to native compiler",
+  "version": "10.0.3",
+  "description": "Core type definitions for Tsonic (versioned by .NET major)",
   "type": "module",
   "keywords": [
     "typescript",
@@ -11,7 +11,8 @@
     "primitives",
     "interop",
     "csharp",
-    "tsonic"
+    "tsonic",
+    "net10"
   ],
   "author": "Tsonic Team",
   "license": "MIT",
@@ -22,5 +23,8 @@
   "bugs": {
     "url": "https://github.com/tsoniclang/core/issues"
   },
-  "homepage": "https://github.com/tsoniclang/core#readme"
+  "homepage": "https://github.com/tsoniclang/core#readme",
+  "peerDependencies": {
+    "@tsonic/dotnet": "^10.0.1"
+  }
 }