@s2script/sdk 0.34.0 → 0.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2script/sdk",
-  "version": "0.34.0",
+  "version": "0.36.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/sound.d.ts

@@ -73,6 +73,19 @@ export interface PrecacheContext {
    * precache, and its resources stay unusable until the next map change.
    */
   add(path: string): boolean;
+  /**
+   * Precache an entity class: everything that class needs to spawn (its models, particles and
+   * soundevents, and the classes it precaches in turn), the same precache the engine runs for each
+   * entity a map spawns. Use it for a class the map doesn't already contain, before you create one.
+   *
+   * @example
+   * pc.addEntity("chicken");
+   * pc.addEntity("prop_physics_multiplayer");
+   *
+   * Returns true when the engine ran the class's precache. It does not check the class name: an
+   * unknown class precaches nothing and still returns true. Same TIMING rule as {@link add}.
+   */
+  addEntity(classname: string): boolean;
 }
 
 /**

package/usermessages.d.ts

@@ -43,6 +43,14 @@ export interface UserMessageView {
   readBool(path: string): boolean | null;
   /** Scalar string/bytes read. Dotted nested paths supported. null if absent/repeated/no message. */
   readString(path: string): string | null;
+  /** Repeated UTF-8 strings in order; [] when empty, null on wrong type/missing/invalid UTF-8/expired view.
+   * Dotted paths through singular sub-messages are supported. Requires matching runtime support. */
+  readStrings(path: string): string[] | null;
+  /** Edit a scalar int32/uint32/fixed32 field on the current message, preserving all other fields.
+   * Returns false for invalid type/range/path, a missing parent, or an expired view.
+   * Later handlers see edits; Continue/Changed delivers them, Handled/Stop suppresses the send.
+   * Requires matching runtime support. */
+  setInt(path: string, value: number): boolean;
 }
 
 /**