@s2script/sdk 0.10.2 → 0.11.0

package/dist/cli.js

@@ -1539,7 +1539,7 @@ var PLATFORM = "linuxsteamrt64";
 var ARG_KINDS = ["bool", "int", "float", "string", "vector", "entity"];
 var RET_KINDS = ["void", "bool", "int", "float", "entity"];
 var INT_CLASS_ARGS = /* @__PURE__ */ new Set(["bool", "int", "string", "vector", "entity"]);
-var MAX_INT_ARGS = 5;
+var MAX_INT_ARGS = 9;
 var MAX_FLOAT_ARGS = 8;
 
 // src/gamedata/validate.ts
@@ -1604,8 +1604,12 @@ function validatePluginGamedata(gd, opts) {
     }
     const decl = rawDecl;
     const recv = decl.receiver;
-    if (!recv || recv.kind !== "entity") {
-      errs.push(`${where}: receiver.kind must be "entity" in v1`);
+    if (!recv || recv.kind !== "entity" && recv.kind !== "none") {
+      errs.push(`${where}: receiver.kind must be "entity" or "none"`);
+    } else if (recv.kind === "none") {
+      if (recv.via !== void 0) {
+        errs.push(`${where}: receiver.kind "none" cannot carry a 'via' sub-object hop`);
+      }
     } else if (recv.via !== void 0) {
       const via = recv.via;
       if (typeof via?.class !== "string" || typeof via?.field !== "string") {
@@ -1649,7 +1653,7 @@ function validatePluginGamedata(gd, opts) {
         else floats++;
       }
       if (ints > MAX_INT_ARGS) {
-        errs.push(`${where}: ${ints} integer-class args exceeds the max of ${MAX_INT_ARGS} (\`this\` occupies rdi)`);
+        errs.push(`${where}: ${ints} integer-class args exceeds the max of ${MAX_INT_ARGS}`);
       }
       if (floats > MAX_FLOAT_ARGS) {
         errs.push(`${where}: ${floats} float args exceeds the max of ${MAX_FLOAT_ARGS}`);
@@ -1710,8 +1714,9 @@ function generateGamedataTypes(gd) {
   const lines = Object.keys(calls).sort().map((name) => {
     const decl = calls[name];
     const names = decl.argNames;
+    const receiverless = decl.receiver?.kind === "none";
     const params = [
-      "self: EntityRef",
+      ...receiverless ? [] : ["self: EntityRef"],
       ...decl.args.map((a2, i2) => `${names?.[i2] ?? `a${i2}`}: ${ARG_TS[a2]}`)
     ];
     return `    ${name}: (${params.join(", ")}) => ${RET_TS[decl.returns]};`;
@@ -5305,6 +5310,9 @@ function emitNavJs(model) {
   }
   for (const w of model.wrappers) {
     out.push(`  function ${w.wrapper}(root, path, base) { this.root = root; this.path = path; this.base = base; }`);
+    out.push(`  ${w.wrapper}.prototype.notifyChanged = function () {`);
+    out.push(`    if (this.path.length > 0) this.root.notifyStateChanged(this.path[0]);`);
+    out.push(`  };`);
     out.push(`  Object.defineProperties(${w.wrapper}.prototype, {`);
     for (const f of w.fields) {
       const own = `off(${S2(f.declaringClass)},${S2(f.rawName)})`;
@@ -5404,6 +5412,16 @@ function emitNavDts(model) {
       out.push(` */`);
     }
     out.push(`export interface ${w.wrapper} {`);
+    out.push(
+      "  /**",
+      "   * Flag this sub-object for network replication after writing to it.",
+      "   *",
+      "   * Setters do not do this for you. For most targets it does not matter \u2014 the server reads the",
+      "   * field every tick \u2014 but anything a CLIENT renders (a scoreboard counter, say) will not update",
+      "   * until you call this.",
+      "   */",
+      "  notifyChanged(): void;"
+    );
     for (const f of w.fields) {
       out.push(`  ${f.navWritable ? "" : "readonly "}${f.propName}: ${TSTYPE[f.accessorKind]};`);
     }

package/entity.d.ts

@@ -116,6 +116,20 @@ export declare class EntityRef {
   notifyStateChanged(offset: number): void;
   /** Raw identity-slot flags (engine m_flags), or null when stale/unavailable. Bit meanings are game-specific. */
   identityFlags(): number | null;
+  /**
+   * CLEAR identity-slot flag bits; returns the flags after the write, or null when stale.
+   *
+   * Clear-only by design: `mask` names bits to DROP and nothing can be raised, because handing a
+   * plugin the ability to set arbitrary identity bits is a far larger foot-gun than the one this
+   * closes. The invalid-ehandle bit is refused outright — a dead slot must never be presentable as
+   * live.
+   *
+   * The case this exists for is the staging bit. `setModel` asserts that an entity is NOT in the
+   * staging list, and a created-but-unspawned entity is, so the create -> setModel -> spawn ordering
+   * (what CS2's own body spawner does) is otherwise unavailable and the alternatives produce
+   * half-initialised entities that clients fail to copy.
+   */
+  clearIdentityFlags(mask: number): number | null;
   /** DispatchSpawn this created entity. With keyvalues, the entity's own Spawn() parses them (the
    *  SourceMod DispatchKeyValue / CSSharp DispatchSpawn(kv) mechanism). Returns false if stale,
    *  unresolved, or the keyvalue map is rejected (non-finite number, unsupported value type, empty

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2script/sdk",
-  "version": "0.10.2",
+  "version": "0.11.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",