@s2script/sdk 0.26.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2script/sdk",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "license": "MIT OR Apache-2.0",
   "description": "s2script SDK — the builtin capability types (imported as @s2script/sdk/entity, …) plus the `s2s` CLI for building Source 2 / CS2 plugins.",
   "type": "module",

package/sdkhooks.d.ts

@@ -55,7 +55,11 @@ export declare const UseType: {
  * that is not a member here throws.
  */
 export declare const SDKHookType: {
-  /** Pre-apply damage (`DispatchTraceAttack`). Mutate {@link DamageInfo.damage} in place. */
+  /**
+   * Pre-apply damage, provided by the selected game package (CS2: `CBaseEntity::TakeDamageOld`).
+   * Mutate {@link DamageInfo.damage} in place. {@link SDKHook} returns `false` when no game package
+   * provides damage hooks.
+   */
   readonly OnTakeDamage: "OnTakeDamage";
   /**
    * CheckTransmit mux (wiki `SDKHook_SetTransmit`). `Handled` / `Stop` hide this entity from this
@@ -112,8 +116,8 @@ export declare const SDKHookType: {
   /** `CanBeAutobalanced`. Return a boolean (not {@link HookResultValue}); last defined wins. */
   readonly CanBeAutobalanced: "CanBeAutobalanced";
   /**
-   * Post-apply damage (`DispatchTraceAttack` after the original). {@link DamageInfo} is read-only
-   * for effect; mutations are not written back. Return is ignored.
+   * Post-apply damage (after the original ran), provided by the selected game package.
+   * {@link DamageInfo} is read-only for effect; `damage` assignment is ignored. Return is ignored.
    */
   readonly OnTakeDamagePost: "OnTakeDamagePost";
   /**
@@ -126,7 +130,7 @@ export declare const SDKHookType: {
   readonly OnTakeDamageAlivePost: "OnTakeDamageAlivePost";
   /**
    * `TraceAttack` pre ({@link TraceAttackInfo}). No distinct CS2 virtual yet — {@link SDKHook}
-   * returns `false` (OnTakeDamage remains the DTA mux).
+   * returns `false` (use OnTakeDamage).
    */
   readonly TraceAttack: "TraceAttack";
   /**
@@ -220,8 +224,9 @@ export declare function SDKHook(
   callback: (info: DamageInfo) => HookResultValue | void,
 ): boolean;
 /**
- * Post-apply damage. {@link DamageInfo} is a read of the live info after the original ran.
- * Return is ignored; Handled does not zero the hit (that is the pre-hook).
+ * Post-apply damage. {@link DamageInfo} reads the info after the original ran; it is valid only
+ * during the synchronous callback. Return is ignored; Handled does not zero the hit (that is the
+ * pre-hook).
  */
 export declare function SDKHook(
   entity: EntityRef | null,

package/unsafe.d.ts

@@ -22,6 +22,32 @@ export interface EngineCalls {}
  */
 export interface EngineHooks {}
 
+/** Generated bindings augment this map from gamedata/functions.jsonc. */
+export interface EngineFunctions {}
+
+export interface FunctionStatus {
+  readonly canonicalId: string;
+  readonly availability: 'available' | 'unavailable';
+  readonly reason: string | null;
+  readonly hookObservation: 'not-requested' | 'pending' | 'active' | 'failed';
+  readonly provenance: {
+    readonly archiveHash: string;
+    readonly baseContractHash: string;
+    readonly appliedOverrides: readonly { readonly path: string; readonly sha256: string }[];
+    readonly finalTargetHash: string;
+    readonly resolverReceipt: string;
+    readonly required: boolean;
+  };
+}
+
+export interface Disposable { dispose(): boolean; }
+
+export interface FunctionSubscription extends Disposable {
+  readonly status: 'pending' | 'active' | 'failed' | 'disposed';
+  readonly reason: string | null;
+  dispose(): boolean;
+}
+
 /**
  * Plugin-declared engine calls and inbound hooks, resolved from this plugin's own gamedata.
  *
@@ -34,6 +60,7 @@ export interface EngineHooks {}
  * if (onFoo) onFoo((view) => { view.reason = 0; });
  */
 export declare const Engine: {
+  function<K extends keyof EngineFunctions>(name: K): EngineFunctions[K];
   /**
    * The declared call, or `null` when its descriptor failed a load-time gate (signature miss,
    * validator rejection, slot outside `.text`, missing platform entry, or the plugin is not