@s2script/sdk 0.16.0 → 0.18.0

package/dist/cli.js

@@ -4492,7 +4492,7 @@ async function buildPlugin(dir, packagesDir) {
     const allowedBases = [`${unscoped}.gamedata.jsonc`, `${unscoped}.gamedata.json`];
     if (!allowedBases.includes(actualBase)) {
       throw new Error(
-        `s2script.gamedata must be named '${unscoped}.gamedata.jsonc' (after the plugin name without its scope, like the framework's own core.gamedata.jsonc), but is '${actualBase}'`
+        `s2script.gamedata must be named '${unscoped}.gamedata.jsonc' (after the plugin name without its scope \u2014 a plugin's gamedata is named for its owner, the plugin itself), but is '${actualBase}'`
       );
     }
     const raw = stripJsonComments(readFileSync8(gdPath, "utf8"));

package/entity.d.ts

@@ -3,6 +3,8 @@
  * NO runtime code: the engine injects the implementation at load time.
  */
 
+import type { Vector } from "./math";
+
 /**
  * A host-liveness-gated handle to a live entity. `id` is a HOST-MINTED monotonic liveness
  * id — liveness is decided by the host's books (fed by engine create/delete notifications,
@@ -23,6 +25,16 @@ export declare class EntityRef {
   /** This entity's targetname (`CEntityIdentity::m_name`) — e.g. a map trigger's `"map_start"`. `""` if
    *  the entity has no targetname; `null` if the ref is stale/invalid. */
   readonly name: string | null;
+  /** This entity's target (`CBaseEntity::m_target`) — the targetname of the entity it acts on, e.g. a
+   *  `func_button`'s target entity. `""` if the entity has no target; `null` if the ref is stale/invalid. */
+  readonly target: string | null;
+  /** This entity's world-space position (`CGameSceneNode::m_vecAbsOrigin`, reached via
+   *  `CBaseEntity::m_CBodyComponent` -> `CBodyComponent::m_pSceneNode`) — the same field CS2's
+   *  `Pawn.origin` exposes for player pawns, readable here on any entity (e.g. ranking candidate
+   *  `func_button`s by distance to a reference point). There is no meaningful "empty" position, so
+   *  unlike {@link EntityRef.name}/{@link EntityRef.target}, `null` means exactly one thing: could not
+   *  read (the ref is stale/invalid, or the field/chain didn't resolve) — never "no position". */
+  readonly origin: Vector | null;
   /** @internal The host mints refs; this is not part of the public API surface. */
   private constructor();
   /** True iff the host's books say live AND the identity slot still matches. */

package/package.json

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