@crowdedkingdoms/crowdyjs 17.6.0-test.1 → 17.7.0-dev.1

package/dist/live-coding/assets/manifest.json

@@ -12,7 +12,7 @@
     },
     {
       "name": "browser-authoring-index.json",
-      "bytes": 140085,
+      "bytes": 144927,
       "provenance": "cks-game-api generated browser authoring index"
     }
   ]

package/dist/live-coding/browser-authoring-index.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-authoring-index.generated.d.ts","sourceRoot":"","sources":["../../src/live-coding/browser-authoring-index.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iCAAiC,EAAE,OAqgK/C,CAAC"}
+{"version":3,"file":"browser-authoring-index.generated.d.ts","sourceRoot":"","sources":["../../src/live-coding/browser-authoring-index.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iCAAiC,EAAE,OAqnK/C,CAAC"}

package/dist/live-coding/browser-authoring-index.generated.js

@@ -2,9 +2,9 @@
 export const GENERATED_BROWSER_AUTHORING_INDEX = {
     "schemaVersion": 2,
     "rustVersion": "1.97.1",
-    "sdkVersion": "0.1.5",
+    "sdkVersion": "0.1.6",
     "abiVersion": 0,
-    "contentHash": "3f5f39d46f732a346033aaf2435528a183e2ab0d0e3691f29c3fa3ecada18ffb",
+    "contentHash": "403558606363e0ed9227513fb31aacacad18d4215843321f7d7874370ff8702e",
     "crates": [
         {
             "name": "alloc",
@@ -18,8 +18,8 @@ export const GENERATED_BROWSER_AUTHORING_INDEX = {
         },
         {
             "name": "crowdy-compute-sdk",
-            "version": "0.1.5",
-            "sourceHash": "a43147b89a4ec0ca03cc1e7d15a7cc858df36faa2f1f486cb536342155615852"
+            "version": "0.1.6",
+            "sourceHash": "33e063cbb758695b01ea2cce6f9d1b7b12878d939b231f3b9cb4905bb8b879b0"
         },
         {
             "name": "crowdy-game-kit-ai",
@@ -29,7 +29,7 @@ export const GENERATED_BROWSER_AUTHORING_INDEX = {
         {
             "name": "crowdy-game-kit-core",
             "version": "0.1.0",
-            "sourceHash": "9750b5294348076d2b75cc67229cdb9e198ed6c2fbc4d76adc063e7124c9e84d"
+            "sourceHash": "25e6bd39c2fe668915f58af556e5346fac46a4bff4c512cab76f6f54176ae988"
         },
         {
             "name": "crowdy-game-kit-econ",
@@ -508,7 +508,14 @@ export const GENERATED_BROWSER_AUTHORING_INDEX = {
             "name": "emit_event",
             "kind": "function",
             "signature": "pub fn emit_event(name: &str, payload: Value) -> Result<Value, HostError>",
-            "docs": "Emit a compute event other modules (or this one) can subscribe to via an on_event=compute_event trigger. Cascade depth is host-bounded."
+            "docs": "Emit a compute event. Studio modules publish on the app event bus (on_event=compute_event triggers); player modules publish on their grid's bus, which reaches the other modules on the same grid (on_event=grid_event) and Studio modules that opted in with a grid_event trigger. Cascade depth is host-bounded; nothing reaches a client."
+        },
+        {
+            "module": "crowdy_compute_sdk::api",
+            "name": "emit_event_to",
+            "kind": "function",
+            "signature": "pub fn emit_event_to(target: &str, name: &str, payload: Value) -> Result<Value, HostError>",
+            "docs": "Address one module by name on the same bus (on a grid: a module on the same grid, itself included). Delivered through its `on_event` whether or not it subscribed to `name`."
         },
         {
             "module": "crowdy_compute_sdk::api",
@@ -552,6 +559,13 @@ export const GENERATED_BROWSER_AUTHORING_INDEX = {
             "signature": "pub fn model_invoke_with_world( function_name: &str, self_container_id: &str, params: Value, session_id: Option<&str>, caller_user_id: Option<&str>, world_writes: &[WorldWrite], ) -> Result<Value, HostError>",
             "docs": "`model_invoke` with atomic world writes: the voxel writes and the Model function's mutations commit in ONE transaction — if either side fails, both roll back. Use for referee actions that change the world and the ledger together (mine/place). Up to 16 writes per call; each write charges a db op. Requires SDK 0.1.4+ on the host."
         },
+        {
+            "module": "crowdy_compute_sdk::api",
+            "name": "pointer_clicks",
+            "kind": "function",
+            "signature": "pub fn pointer_clicks() -> Result<Value, HostError>",
+            "docs": "Drain queued holodeck mouse clicks since the last call (CLIENT). Returns `{ nowMs, buttons, holdingMs, clicks }`. `buttons` is the live `MouseEvent.buttons` bitfield (1 = left held). `holdingMs` maps button index → milliseconds already held (`\"0\"` = left). `clicks` is drained: `{ t: \"down\"|\"up\", button, atMs, heldMs?, nx, ny }` with canvas NDC (`nx`/`ny` in −1..1, +ny up). Studio chrome is omitted. Call every `on_tick`. Click-to-charge: start on left `down`, read `holdingMs[\"0\"]` for the power bar, fire on left `up` using `heldMs`."
+        },
         {
             "module": "crowdy_compute_sdk::api",
             "name": "property_set",
@@ -1196,6 +1210,13 @@ export const GENERATED_BROWSER_AUTHORING_INDEX = {
             "signature": "pub mod events;",
             "docs": ""
         },
+        {
+            "module": "crowdy_game_kit_core",
+            "name": "grid",
+            "kind": "module",
+            "signature": "pub mod grid;",
+            "docs": ""
+        },
         {
             "module": "crowdy_game_kit_core",
             "name": "invoke",
@@ -1469,6 +1490,97 @@ export const GENERATED_BROWSER_AUTHORING_INDEX = {
             "signature": "pub fn encode_event(event_type: u16, state: &[u8]) -> Vec<u8>",
             "docs": ""
         },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent",
+            "kind": "struct",
+            "signature": "pub struct GridEvent { /// The grid whose bus carried it (`None` on a grid: it is always your own). pub grid_id: Option<String>, /// The grid's owner (Studio side only). pub owner_user_id: Option<String>, pub event_name: String, /// Module that published it, when the platform names one. pub source_module: Option<String>, /// Set when the publisher addressed one module by name. pub target: Option<String>, pub payload: Value, pub cascade_depth: u32, }",
+            "docs": "A grid-bus event as a module's `on_event` receives it."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::cascade_depth",
+            "kind": "field",
+            "signature": "pub cascade_depth: u32",
+            "docs": ""
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::event_name",
+            "kind": "field",
+            "signature": "pub event_name: String",
+            "docs": ""
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::grid_id",
+            "kind": "field",
+            "signature": "pub grid_id: Option<String>",
+            "docs": "The grid whose bus carried it (`None` on a grid: it is always your own)."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::owner_user_id",
+            "kind": "field",
+            "signature": "pub owner_user_id: Option<String>",
+            "docs": "The grid's owner (Studio side only)."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::payload",
+            "kind": "field",
+            "signature": "pub payload: Value",
+            "docs": ""
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::source_module",
+            "kind": "field",
+            "signature": "pub source_module: Option<String>",
+            "docs": "Module that published it, when the platform names one."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "GridEvent::target",
+            "kind": "field",
+            "signature": "pub target: Option<String>",
+            "docs": "Set when the publisher addressed one module by name."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "decode",
+            "kind": "function",
+            "signature": "pub fn decode(body: &[u8]) -> Option<GridEvent>",
+            "docs": "Decode an `on_event` body. Returns `None` for any other event kind. Two shapes carry grid events: a player module gets the player-plane event (`kind: \"grid_event\"`, with `eventName`, `sourceModuleName`, `targetModuleName`, `payload`), and a Studio module gets the app-plane one (`event: \"grid_event\"`, `eventName`, and `payload: { gridId, ownerUserId, sourceModule, payload }`)."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "post",
+            "kind": "function",
+            "signature": "pub fn post(channel_id: &str, bytes: &[u8]) -> Result<Value, HostError>",
+            "docs": "Post raw bytes into a grid channel. The platform stamps the sender uuid as `grid:<gridId>`; a channel of another grid is `unavailable`."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "post_json",
+            "kind": "function",
+            "signature": "pub fn post_json(channel_id: &str, message: &Value) -> Result<Value, HostError>",
+            "docs": "Post a JSON message into a grid channel."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "publish",
+            "kind": "function",
+            "signature": "pub fn publish(name: &str, payload: Value) -> Result<Value, HostError>",
+            "docs": "Publish `name` on this grid's bus: every other module on the grid with a `grid_event` subscription to it (or to `*`), and any Studio module that opted in. Never another grid, never a client."
+        },
+        {
+            "module": "crowdy_game_kit_core::grid",
+            "name": "send_to",
+            "kind": "function",
+            "signature": "pub fn send_to(module: &str, name: &str, payload: Value) -> Result<Value, HostError>",
+            "docs": "Deliver `name` to one module on this grid (itself included), whether or not it subscribed to `name`."
+        },
         {
             "module": "crowdy_game_kit_core::invoke",
             "name": "InvokeCtx",

package/dist/player-runtime/client-grid-event-bus.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The page-local half of the grid event bus (DN-10 §4). A CLIENT mod's
+ * `emit_event(name, payload, target?)` never leaves the page: it reaches the
+ * other client mods running on the SAME grid in this browser, through their
+ * `on_event` export. A mod on another grid never sees it, and neither does the
+ * server (server mods have their own grid bus, reached by server code).
+ */
+/** What a subscribed mod receives in `on_event` (JSON-encoded). */
+export interface ClientGridEvent {
+    kind: 'grid_event';
+    gridId: string;
+    eventName: string;
+    payload: unknown;
+    sourceModule: string | null;
+    /** Set when the emitter addressed one module by name. */
+    target: string | null;
+    /** Hops since the originating dispatch; the bus drops anything past the cap. */
+    cascadeDepth: number;
+}
+export interface ClientGridEventSubscriber {
+    moduleName: string | null;
+    deliver(event: ClientGridEvent): boolean;
+}
+/** Same ceiling as the server event buses. */
+export declare const CLIENT_GRID_EVENT_MAX_CASCADE = 8;
+export declare class ClientGridEventBus {
+    private readonly byGrid;
+    subscribe(gridId: string, subscriber: ClientGridEventSubscriber): () => void;
+    /**
+     * Deliver to every subscriber on `event.gridId` except the sender (unless
+     * the sender addressed itself). Returns how many mods accepted it.
+     */
+    publish(event: ClientGridEvent, sender?: ClientGridEventSubscriber): number;
+}
+/** The bus every broker joins unless it is given its own (or `null`). */
+export declare const defaultClientGridEventBus: ClientGridEventBus;
+//# sourceMappingURL=client-grid-event-bus.d.ts.map

package/dist/player-runtime/client-grid-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-grid-event-bus.d.ts","sourceRoot":"","sources":["../../src/player-runtime/client-grid-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yDAAyD;IACzD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC;CAC1C;AAED,8CAA8C;AAC9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqD;IAE5E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAe5E;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,MAAM;CAe5E;AAED,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,oBAA2B,CAAC"}

package/dist/player-runtime/client-grid-event-bus.js

@@ -0,0 +1,56 @@
+/**
+ * The page-local half of the grid event bus (DN-10 §4). A CLIENT mod's
+ * `emit_event(name, payload, target?)` never leaves the page: it reaches the
+ * other client mods running on the SAME grid in this browser, through their
+ * `on_event` export. A mod on another grid never sees it, and neither does the
+ * server (server mods have their own grid bus, reached by server code).
+ */
+/** Same ceiling as the server event buses. */
+export const CLIENT_GRID_EVENT_MAX_CASCADE = 8;
+export class ClientGridEventBus {
+    constructor() {
+        this.byGrid = new Map();
+    }
+    subscribe(gridId, subscriber) {
+        let set = this.byGrid.get(gridId);
+        if (!set) {
+            set = new Set();
+            this.byGrid.set(gridId, set);
+        }
+        set.add(subscriber);
+        return () => {
+            const current = this.byGrid.get(gridId);
+            if (!current)
+                return;
+            current.delete(subscriber);
+            if (current.size === 0)
+                this.byGrid.delete(gridId);
+        };
+    }
+    /**
+     * Deliver to every subscriber on `event.gridId` except the sender (unless
+     * the sender addressed itself). Returns how many mods accepted it.
+     */
+    publish(event, sender) {
+        if (event.cascadeDepth > CLIENT_GRID_EVENT_MAX_CASCADE)
+            return 0;
+        const set = this.byGrid.get(event.gridId);
+        if (!set)
+            return 0;
+        let delivered = 0;
+        for (const subscriber of [...set]) {
+            if (event.target !== null) {
+                if (subscriber.moduleName !== event.target)
+                    continue;
+            }
+            else if (subscriber === sender) {
+                continue;
+            }
+            if (subscriber.deliver(event))
+                delivered += 1;
+        }
+        return delivered;
+    }
+}
+/** The bus every broker joins unless it is given its own (or `null`). */
+export const defaultClientGridEventBus = new ClientGridEventBus();

package/dist/player-runtime/glue-runtime.d.ts

@@ -19,8 +19,8 @@
  * (the worker blocks; the page/broker services the async SDK call and writes
  * the reply back). Everything else here is pure.
  */
-/** The host-call names surfaced to a guest (mirrors the broker allowlist). */
-export declare const GLUE_HOST_FUNCTIONS: readonly ["container_create", "container_get", "containers_list", "container_delete", "property_set", "model_invoke", "user_state_get", "user_state_set", "grid_state_get", "grid_state_set", "chunk_get", "voxels_list", "actors_list", "actors_list_radius", "voxel_set", "emit_spatial", "hud_set", "overlay_draw", "pointer_clicks", "grid_permission_check"];
+/** The host-call names surfaced to a guest: the client half of the host catalog (the broker allowlist). */
+export declare const GLUE_HOST_FUNCTIONS: readonly string[];
 export interface GlueInitMessage {
     type: 'init';
     artifact: ArrayBuffer;
@@ -95,6 +95,8 @@ export declare class GlueRuntime {
     init(): void;
     /** Run one `tick(dt_ms)`. Throws propagate to the caller's watchdog wrapper. */
     tick(dtMs: number): void;
+    /** Deliver one grid event to `on_event`; a module without the export ignores it. */
+    event(payload: Uint8Array): void;
     /** Invoke the module with an opaque payload; returns the reply bytes (copied out). */
     invoke(payload: Uint8Array): Uint8Array;
 }

package/dist/player-runtime/glue-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glue-runtime.d.ts","sourceRoot":"","sources":["../../src/player-runtime/glue-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"glue-runtime.d.ts","sourceRoot":"","sources":["../../src/player-runtime/glue-runtime.ts"],"names":[],"mappings":"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"}

package/dist/player-runtime/glue-runtime.js

@@ -19,29 +19,11 @@
  * (the worker blocks; the page/broker services the async SDK call and writes
  * the reply back). Everything else here is pure.
  */
-/** The host-call names surfaced to a guest (mirrors the broker allowlist). */
-export const GLUE_HOST_FUNCTIONS = [
-    'container_create',
-    'container_get',
-    'containers_list',
-    'container_delete',
-    'property_set',
-    'model_invoke',
-    'user_state_get',
-    'user_state_set',
-    'grid_state_get',
-    'grid_state_set',
-    'chunk_get',
-    'voxels_list',
-    'actors_list',
-    'actors_list_radius',
-    'voxel_set',
-    'emit_spatial',
-    'hud_set',
-    'overlay_draw',
-    'pointer_clicks',
-    'grid_permission_check',
-];
+import { GENERATED_HOST_CATALOG } from './host-catalog.generated.js';
+/** The host-call names surfaced to a guest: the client half of the host catalog (the broker allowlist). */
+export const GLUE_HOST_FUNCTIONS = GENERATED_HOST_CATALOG.functions
+    .filter((fn) => fn.targets.includes('client'))
+    .map((fn) => fn.name);
 /**
  * Parse the server-authored budget used to refill an instrumented artifact's
  * mutable `ck_fuel` global before every guest dispatch.
@@ -238,6 +220,21 @@ export class GlueRuntime {
         this.resetFuel();
         this.exports?.tick?.(dtMs);
     }
+    /** Deliver one grid event to `on_event`; a module without the export ignores it. */
+    event(payload) {
+        const ex = this.exports;
+        if (!ex || typeof ex.on_event !== 'function')
+            return;
+        const ptr = ex.ck_alloc(payload.length);
+        if (payload.length > 0 && ptr === 0) {
+            throw new RangeError('ck_alloc returned a null event pointer');
+        }
+        assertMemoryRange(ex.memory.buffer, ptr, payload.length, 'event write');
+        new Uint8Array(ex.memory.buffer, ptr, payload.length).set(payload);
+        this.resetFuel();
+        ex.on_event(ptr, payload.length);
+        ex.ck_free?.(ptr, payload.length);
+    }
     /** Invoke the module with an opaque payload; returns the reply bytes (copied out). */
     invoke(payload) {
         const ex = this.exports;

package/dist/player-runtime/host-catalog.generated.d.ts

@@ -0,0 +1,16 @@
+export interface HostCatalogFunction {
+    name: string;
+    group: string;
+    targets: ReadonlyArray<'server' | 'client'>;
+    egress?: boolean;
+    app: string;
+    grid: string;
+}
+export interface HostCatalog {
+    catalogVersion: number;
+    description: string;
+    groups: Readonly<Record<string, string>>;
+    functions: ReadonlyArray<HostCatalogFunction>;
+}
+export declare const GENERATED_HOST_CATALOG: HostCatalog;
+//# sourceMappingURL=host-catalog.generated.d.ts.map

package/dist/player-runtime/host-catalog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-catalog.generated.d.ts","sourceRoot":"","sources":["../../src/player-runtime/host-catalog.generated.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,SAAS,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,sBAAsB,EAAE,WAuSpC,CAAC"}