@idosgames/module-sdk 0.1.11 → 0.2.0

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';function t(e){return e}exports.defineModule=t;
+'use strict';var m=/^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*@[1-9]\d*$/;function x(e){return typeof e=="string"&&m.test(e)}function M(e){let t=e.indexOf(":");return t<0?"":e.slice(0,t)}var l=/^(string|number|boolean)(\[\])?(\?)?$/;function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function c(e,t){return e==="number"?typeof t=="number"&&Number.isFinite(t):typeof t===e}function f(e,t,r){if(!u(t))return `${r||"payload"} must be an object`;for(let[n,o]of Object.entries(e)){let i=r?`${r}.${n}`:n,a=t[n];if(typeof o!="string"){let p=f(o,a,i);if(p)return p;continue}let d=l.exec(o);if(!d)return `${i}: invalid descriptor "${o}"`;let[,s="",g,S]=d;if(a===void 0){if(S)continue;return `${i} is missing`}if(g){if(!Array.isArray(a))return `${i} must be ${s}[]`;if(!a.every(p=>c(s,p)))return `${i} must contain only ${s} values`;continue}if(!c(s,a))return `${i} must be a ${s}`}return null}function y(e,t){for(let[r,n]of Object.entries(e)){let o=t?`${t}.${r}`:r;if(typeof n=="string"){if(!l.test(n))throw new Error(`shape(): field "${o}" has invalid type "${n}" \u2014 use "string" | "number" | "boolean", optionally with "[]" and/or a trailing "?"`)}else if(u(n))y(n,o);else throw new Error(`shape(): field "${o}" must be a type string or an object`)}}function h(e){return y(e,""),{descriptor:e,check:t=>f(e,t,"")}}function v(e,t){if(!x(e))throw new Error(`defineTopic(): "${e}" is not a valid topic name \u2014 expected "<module-id>:<event>@<major>", e.g. "idle-rpg:character-upgraded@1"`);return {name:e,shape:t}}var E={modeChanged:v("host:mode-changed@1",h({from:"string?",to:"string"}))};var T=["currency-bar","wallet","status","account"];function $(e){return typeof e=="string"&&T.includes(e)}function D(e){return e}exports.SHARED_UI_ROLES=T;exports.TOPIC_NAME_RE=m;exports.defineModule=D;exports.defineTopic=v;exports.hostTopics=E;exports.isSharedUiRole=$;exports.isTopicName=x;exports.shape=h;exports.topicNamespace=M;

package/dist/index.d.cts

@@ -2,6 +2,136 @@ import { IDosGamesClient } from '@idosgames/core';
 export { IDosGamesClient, SdkEvents } from '@idosgames/core';
 import { ComponentType } from 'react';
 
+/** `"<module-id>:<event>@<major>"`, e.g. `"idle-rpg:character-upgraded@1"`. */
+type TopicName = `${string}:${string}@${number}`;
+/** The exact grammar of a topic name. The part before ":" is the owning module's id. */
+declare const TOPIC_NAME_RE: RegExp;
+declare function isTopicName(value: unknown): value is TopicName;
+/** The namespace (owning module id) of a topic name: `"idle-rpg:x@1"` → `"idle-rpg"`. */
+declare function topicNamespace(name: string): string;
+type ShapeLeaf = "string" | "number" | "boolean";
+/** A leaf field: a type, optionally an array (`[]`), optionally optional (`?`, always last). */
+type ShapeLeafSpec = ShapeLeaf | `${ShapeLeaf}[]` | `${ShapeLeaf}?` | `${ShapeLeaf}[]?`;
+/** A flat JSON payload descriptor. Nested objects are allowed (and required when present). */
+interface ShapeDescriptor {
+    readonly [field: string]: ShapeLeafSpec | ShapeDescriptor;
+}
+type LeafType<L> = L extends "string" ? string : L extends "number" ? number : L extends "boolean" ? boolean : never;
+type StripOptional<S extends string> = S extends `${infer B}?` ? B : S;
+type SpecType<S> = S extends string ? StripOptional<S> extends `${infer L}[]` ? LeafType<L>[] : LeafType<StripOptional<S>> : S extends ShapeDescriptor ? InferShape<S> : never;
+type OptionalKeys<D> = {
+    [K in keyof D]: D[K] extends `${string}?` ? K : never;
+}[keyof D];
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** The TypeScript payload type described by a `ShapeDescriptor`. */
+type InferShape<D> = Simplify<{
+    -readonly [K in Exclude<keyof D, OptionalKeys<D>>]: SpecType<D[K]>;
+} & {
+    -readonly [K in OptionalKeys<D>]?: SpecType<D[K]>;
+}>;
+/** A payload shape: the descriptor plus its runtime check. `T` is the inferred payload type. */
+interface Shape<T> {
+    readonly descriptor: ShapeDescriptor;
+    /** `null` when `value` fits, otherwise a short reason naming the first bad field. */
+    check(value: unknown): string | null;
+    /** Type-only marker carrying `T`; never set at runtime. */
+    readonly __payload?: T;
+}
+/**
+ * Describe a payload. `shape({ characterId: "string", level: "number", tags: "string[]?" })` is typed
+ * `{ characterId: string; level: number; tags?: string[] }` and validates the same thing at runtime.
+ */
+declare function shape<const D extends ShapeDescriptor>(descriptor: D): Shape<InferShape<D>>;
+/** A topic token: name + payload shape. Create with `defineTopic`, pass it to `ctx.events`. */
+interface Topic<T> {
+    readonly name: TopicName;
+    readonly shape: Shape<T>;
+}
+/** The payload type of a topic token. */
+type TopicPayload<X> = X extends Topic<infer T> ? T : never;
+/**
+ * Declare a topic. The name must start with the OWNING module's id — the host refuses to deliver an
+ * emit into another module's namespace. Declare it in `module.meta.json` too (`events.emits` for your
+ * own topics, `events.listens` for another module's), so the catalog and the agent can see it.
+ */
+declare function defineTopic<T>(name: TopicName, payload: Shape<T>): Topic<T>;
+/**
+ * Topics the HOST emits. The only topics a module may import: their owner is this npm package, not a
+ * module. The `host:` namespace is closed to modules.
+ */
+declare const hostTopics: {
+    /** The player switched modes via the nav. `from` is absent on the first activation. */
+    readonly modeChanged: Topic<{
+        to: string;
+        from?: string | undefined;
+    }>;
+};
+/**
+ * `ctx.events` — this module's handle on the host's event bus.
+ *
+ * - `emit` only into your own namespace (`"<your-id>:…"`); anything else is dropped with an error.
+ * - Subscribe in `setup()`, not in a panel effect: `activeOnly` panels unmount with their mode and
+ *   would miss events. Subscriptions live for the session and the host removes them on logout.
+ * - An event is a SIGNAL, not state, and is never replayed. Money, inventory and progress go through
+ *   `ctx.client`; "what exists right now" goes through `ctx.sharedUi` and the SDK.
+ * - Payloads are plain JSON — no functions, class instances or engine objects.
+ */
+interface ModuleEvents {
+    emit<T>(topic: Topic<T>, payload: T): void;
+    /** @deprecated Untyped string topics. Use `defineTopic(...)` and pass the token. */
+    emit(topic: string, payload: unknown): void;
+    /** Subscribe; returns an unsubscribe function. The handler only sees payloads that fit YOUR shape. */
+    on<T>(topic: Topic<T>, handler: (payload: T) => void): () => void;
+    /** @deprecated Untyped string topics. Use `defineTopic(...)` and pass the token. */
+    on(topic: string, handler: (payload: unknown) => void): () => void;
+}
+/** One topic a module emits, as declared in `module.meta.json`. */
+interface ModuleEventEmit {
+    topic: TopicName;
+    /** When it fires, in plain words. */
+    when?: string;
+    /** The descriptor passed to `shape()` — copied verbatim by listeners. */
+    payload: ShapeDescriptor;
+}
+/** One topic a module listens to. Always optional: the module must work without the emitter. */
+interface ModuleEventListen {
+    topic: TopicName;
+    /** What the module does with it. */
+    why?: string;
+}
+interface ModuleEventsManifest {
+    emits?: ModuleEventEmit[];
+    listens?: ModuleEventListen[];
+}
+
+/**
+ * The closed list of roles. Closed on purpose: a role is a promise "I draw this for everybody", so
+ * each one has to mean the same thing across the whole catalog. A new role is a minor release of
+ * this package; anything that does not fit a role is plain events + SDK data.
+ */
+declare const SHARED_UI_ROLES: readonly ["currency-bar", "wallet", "status", "account"];
+type SharedUiRole = (typeof SHARED_UI_ROLES)[number];
+/** Static declaration on a module (`Module.sharedUi`). */
+interface ModuleSharedUi {
+    /** Roles this module draws for every mode. The first provider in `src/modules.ts` wins a role. */
+    provides?: readonly SharedUiRole[];
+    /**
+     * Roles this module relies on but does not draw (a shop that shows prices but no balance bar).
+     * With no provider installed the host warns in dev, and the catalog tells the agent to install one.
+     */
+    requires?: readonly SharedUiRole[];
+}
+/** `ctx.sharedUi` — the host's answer, fixed for the whole session. */
+interface SharedUiContext {
+    /** Which module draws `role` for everybody, or `null` when nobody took it. */
+    ownerOf(role: SharedUiRole): string | null;
+    /** Should THIS module draw its own copy: nobody took the role, or this module is its owner. */
+    shouldDraw(role: SharedUiRole): boolean;
+}
+declare function isSharedUiRole(value: unknown): value is SharedUiRole;
+
 /** What a module is, for catalog/UI purposes. Not every module is a game. */
 type ModuleType = "game" | "app" | "ai-app";
 /**
@@ -77,6 +207,12 @@ interface ModuleManifest {
     author?: ModuleAuthor;
     /** Semver of the module content; defaults to the module's package.json `version`. */
     version?: string;
+    /**
+     * The module's event contract: topics it emits (with the payload descriptor listeners copy) and
+     * topics of OTHER modules it listens to (always optional). `npm run check` in the SDK repo and the
+     * AI Coder's hygiene notes compare this with the `defineTopic("…")` literals in `src/`.
+     */
+    events?: ModuleEventsManifest;
 }
 /**
  * The manifest a module exports. The host calls `setup` exactly once, passing shared services;
@@ -86,6 +222,13 @@ interface Module {
     /** Stable unique id — also the mode id the nav switches by. */
     id: string;
     meta: ModuleMeta;
+    /**
+     * Shared chrome this module draws for every mode (`provides`) or needs someone to draw
+     * (`requires`). Static on purpose: the host reads it for ALL modules before the first `setup()`,
+     * so `ctx.sharedUi` answers correctly whatever the module order. A template that draws its own
+     * wallet/balances/status hides them when `ctx.sharedUi.shouldDraw(role)` is false.
+     */
+    sharedUi?: ModuleSharedUi;
     setup(ctx: ModuleContext): void;
 }
 /** Services the host injects into every module at `setup` time. */
@@ -98,8 +241,14 @@ interface ModuleContext {
      * and a module that disagrees with its host talks to a different title's data.
      */
     titleId: string;
-    /** Cross-module bus — e.g. an idle module emits "gold:granted", a board module reacts. */
-    events: SharedEventBus;
+    /**
+     * Cross-module bus, scoped to this module: emit typed topics of your own namespace
+     * (`defineTopic("<your-id>:<event>@1", shape({…}))`), listen to others' with your own copy of their
+     * descriptor. Subscribe in `setup()`; the host removes the subscriptions on logout.
+     */
+    events: ModuleEvents;
+    /** Who draws the shared chrome (balances, wallet, status, account) — see `Module.sharedUi`. */
+    sharedUi: SharedUiContext;
     /** Requests host-managed DOM surfaces (canvas hosts, HUD slots) when a module needs one directly. */
     surface: SurfaceAllocator;
     /** Register a rendered scene (Three/Phaser/custom). The host drives its lifecycle. */
@@ -211,8 +360,8 @@ interface RouteEntry {
     order?: number;
 }
 /**
- * Typed pub/sub shared by every module. Defaults to an open `Record<string, unknown>` topic map;
- * a host may parameterize it with a known event map for stronger typing.
+ * @deprecated The pre-0.2 string-topic bus. `ctx.events` is now `ModuleEvents` (typed topic tokens,
+ * see `defineTopic`); this type stays only so older code that named it still compiles.
  */
 interface SharedEventBus<Events extends Record<string, unknown> = Record<string, unknown>> {
     emit<K extends keyof Events & string>(topic: K, payload: Events[K]): void;
@@ -222,4 +371,4 @@ interface SharedEventBus<Events extends Record<string, unknown> = Record<string,
 /** Identity helper that pins a module literal to the `Module` type for editor help and errors. */
 declare function defineModule(module: Module): Module;
 
-export { type EngineScene, type Module, type ModuleAgentApi, type ModuleAuthor, type ModuleContext, type ModuleEngine, type ModuleManifest, type ModuleMedia, type ModuleMeta, type ModuleType, type PanelSlot, type RouteEntry, type SceneMountContext, type SharedEventBus, type SurfaceAllocator, type SurfaceHandle, type SurfaceKind, type UiPanel, defineModule };
+export { type EngineScene, type InferShape, type Module, type ModuleAgentApi, type ModuleAuthor, type ModuleContext, type ModuleEngine, type ModuleEventEmit, type ModuleEventListen, type ModuleEvents, type ModuleEventsManifest, type ModuleManifest, type ModuleMedia, type ModuleMeta, type ModuleSharedUi, type ModuleType, type PanelSlot, type RouteEntry, SHARED_UI_ROLES, type SceneMountContext, type Shape, type ShapeDescriptor, type ShapeLeaf, type ShapeLeafSpec, type SharedEventBus, type SharedUiContext, type SharedUiRole, type SurfaceAllocator, type SurfaceHandle, type SurfaceKind, TOPIC_NAME_RE, type Topic, type TopicName, type TopicPayload, type UiPanel, defineModule, defineTopic, hostTopics, isSharedUiRole, isTopicName, shape, topicNamespace };

package/dist/index.d.ts

@@ -2,6 +2,136 @@ import { IDosGamesClient } from '@idosgames/core';
 export { IDosGamesClient, SdkEvents } from '@idosgames/core';
 import { ComponentType } from 'react';
 
+/** `"<module-id>:<event>@<major>"`, e.g. `"idle-rpg:character-upgraded@1"`. */
+type TopicName = `${string}:${string}@${number}`;
+/** The exact grammar of a topic name. The part before ":" is the owning module's id. */
+declare const TOPIC_NAME_RE: RegExp;
+declare function isTopicName(value: unknown): value is TopicName;
+/** The namespace (owning module id) of a topic name: `"idle-rpg:x@1"` → `"idle-rpg"`. */
+declare function topicNamespace(name: string): string;
+type ShapeLeaf = "string" | "number" | "boolean";
+/** A leaf field: a type, optionally an array (`[]`), optionally optional (`?`, always last). */
+type ShapeLeafSpec = ShapeLeaf | `${ShapeLeaf}[]` | `${ShapeLeaf}?` | `${ShapeLeaf}[]?`;
+/** A flat JSON payload descriptor. Nested objects are allowed (and required when present). */
+interface ShapeDescriptor {
+    readonly [field: string]: ShapeLeafSpec | ShapeDescriptor;
+}
+type LeafType<L> = L extends "string" ? string : L extends "number" ? number : L extends "boolean" ? boolean : never;
+type StripOptional<S extends string> = S extends `${infer B}?` ? B : S;
+type SpecType<S> = S extends string ? StripOptional<S> extends `${infer L}[]` ? LeafType<L>[] : LeafType<StripOptional<S>> : S extends ShapeDescriptor ? InferShape<S> : never;
+type OptionalKeys<D> = {
+    [K in keyof D]: D[K] extends `${string}?` ? K : never;
+}[keyof D];
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** The TypeScript payload type described by a `ShapeDescriptor`. */
+type InferShape<D> = Simplify<{
+    -readonly [K in Exclude<keyof D, OptionalKeys<D>>]: SpecType<D[K]>;
+} & {
+    -readonly [K in OptionalKeys<D>]?: SpecType<D[K]>;
+}>;
+/** A payload shape: the descriptor plus its runtime check. `T` is the inferred payload type. */
+interface Shape<T> {
+    readonly descriptor: ShapeDescriptor;
+    /** `null` when `value` fits, otherwise a short reason naming the first bad field. */
+    check(value: unknown): string | null;
+    /** Type-only marker carrying `T`; never set at runtime. */
+    readonly __payload?: T;
+}
+/**
+ * Describe a payload. `shape({ characterId: "string", level: "number", tags: "string[]?" })` is typed
+ * `{ characterId: string; level: number; tags?: string[] }` and validates the same thing at runtime.
+ */
+declare function shape<const D extends ShapeDescriptor>(descriptor: D): Shape<InferShape<D>>;
+/** A topic token: name + payload shape. Create with `defineTopic`, pass it to `ctx.events`. */
+interface Topic<T> {
+    readonly name: TopicName;
+    readonly shape: Shape<T>;
+}
+/** The payload type of a topic token. */
+type TopicPayload<X> = X extends Topic<infer T> ? T : never;
+/**
+ * Declare a topic. The name must start with the OWNING module's id — the host refuses to deliver an
+ * emit into another module's namespace. Declare it in `module.meta.json` too (`events.emits` for your
+ * own topics, `events.listens` for another module's), so the catalog and the agent can see it.
+ */
+declare function defineTopic<T>(name: TopicName, payload: Shape<T>): Topic<T>;
+/**
+ * Topics the HOST emits. The only topics a module may import: their owner is this npm package, not a
+ * module. The `host:` namespace is closed to modules.
+ */
+declare const hostTopics: {
+    /** The player switched modes via the nav. `from` is absent on the first activation. */
+    readonly modeChanged: Topic<{
+        to: string;
+        from?: string | undefined;
+    }>;
+};
+/**
+ * `ctx.events` — this module's handle on the host's event bus.
+ *
+ * - `emit` only into your own namespace (`"<your-id>:…"`); anything else is dropped with an error.
+ * - Subscribe in `setup()`, not in a panel effect: `activeOnly` panels unmount with their mode and
+ *   would miss events. Subscriptions live for the session and the host removes them on logout.
+ * - An event is a SIGNAL, not state, and is never replayed. Money, inventory and progress go through
+ *   `ctx.client`; "what exists right now" goes through `ctx.sharedUi` and the SDK.
+ * - Payloads are plain JSON — no functions, class instances or engine objects.
+ */
+interface ModuleEvents {
+    emit<T>(topic: Topic<T>, payload: T): void;
+    /** @deprecated Untyped string topics. Use `defineTopic(...)` and pass the token. */
+    emit(topic: string, payload: unknown): void;
+    /** Subscribe; returns an unsubscribe function. The handler only sees payloads that fit YOUR shape. */
+    on<T>(topic: Topic<T>, handler: (payload: T) => void): () => void;
+    /** @deprecated Untyped string topics. Use `defineTopic(...)` and pass the token. */
+    on(topic: string, handler: (payload: unknown) => void): () => void;
+}
+/** One topic a module emits, as declared in `module.meta.json`. */
+interface ModuleEventEmit {
+    topic: TopicName;
+    /** When it fires, in plain words. */
+    when?: string;
+    /** The descriptor passed to `shape()` — copied verbatim by listeners. */
+    payload: ShapeDescriptor;
+}
+/** One topic a module listens to. Always optional: the module must work without the emitter. */
+interface ModuleEventListen {
+    topic: TopicName;
+    /** What the module does with it. */
+    why?: string;
+}
+interface ModuleEventsManifest {
+    emits?: ModuleEventEmit[];
+    listens?: ModuleEventListen[];
+}
+
+/**
+ * The closed list of roles. Closed on purpose: a role is a promise "I draw this for everybody", so
+ * each one has to mean the same thing across the whole catalog. A new role is a minor release of
+ * this package; anything that does not fit a role is plain events + SDK data.
+ */
+declare const SHARED_UI_ROLES: readonly ["currency-bar", "wallet", "status", "account"];
+type SharedUiRole = (typeof SHARED_UI_ROLES)[number];
+/** Static declaration on a module (`Module.sharedUi`). */
+interface ModuleSharedUi {
+    /** Roles this module draws for every mode. The first provider in `src/modules.ts` wins a role. */
+    provides?: readonly SharedUiRole[];
+    /**
+     * Roles this module relies on but does not draw (a shop that shows prices but no balance bar).
+     * With no provider installed the host warns in dev, and the catalog tells the agent to install one.
+     */
+    requires?: readonly SharedUiRole[];
+}
+/** `ctx.sharedUi` — the host's answer, fixed for the whole session. */
+interface SharedUiContext {
+    /** Which module draws `role` for everybody, or `null` when nobody took it. */
+    ownerOf(role: SharedUiRole): string | null;
+    /** Should THIS module draw its own copy: nobody took the role, or this module is its owner. */
+    shouldDraw(role: SharedUiRole): boolean;
+}
+declare function isSharedUiRole(value: unknown): value is SharedUiRole;
+
 /** What a module is, for catalog/UI purposes. Not every module is a game. */
 type ModuleType = "game" | "app" | "ai-app";
 /**
@@ -77,6 +207,12 @@ interface ModuleManifest {
     author?: ModuleAuthor;
     /** Semver of the module content; defaults to the module's package.json `version`. */
     version?: string;
+    /**
+     * The module's event contract: topics it emits (with the payload descriptor listeners copy) and
+     * topics of OTHER modules it listens to (always optional). `npm run check` in the SDK repo and the
+     * AI Coder's hygiene notes compare this with the `defineTopic("…")` literals in `src/`.
+     */
+    events?: ModuleEventsManifest;
 }
 /**
  * The manifest a module exports. The host calls `setup` exactly once, passing shared services;
@@ -86,6 +222,13 @@ interface Module {
     /** Stable unique id — also the mode id the nav switches by. */
     id: string;
     meta: ModuleMeta;
+    /**
+     * Shared chrome this module draws for every mode (`provides`) or needs someone to draw
+     * (`requires`). Static on purpose: the host reads it for ALL modules before the first `setup()`,
+     * so `ctx.sharedUi` answers correctly whatever the module order. A template that draws its own
+     * wallet/balances/status hides them when `ctx.sharedUi.shouldDraw(role)` is false.
+     */
+    sharedUi?: ModuleSharedUi;
     setup(ctx: ModuleContext): void;
 }
 /** Services the host injects into every module at `setup` time. */
@@ -98,8 +241,14 @@ interface ModuleContext {
      * and a module that disagrees with its host talks to a different title's data.
      */
     titleId: string;
-    /** Cross-module bus — e.g. an idle module emits "gold:granted", a board module reacts. */
-    events: SharedEventBus;
+    /**
+     * Cross-module bus, scoped to this module: emit typed topics of your own namespace
+     * (`defineTopic("<your-id>:<event>@1", shape({…}))`), listen to others' with your own copy of their
+     * descriptor. Subscribe in `setup()`; the host removes the subscriptions on logout.
+     */
+    events: ModuleEvents;
+    /** Who draws the shared chrome (balances, wallet, status, account) — see `Module.sharedUi`. */
+    sharedUi: SharedUiContext;
     /** Requests host-managed DOM surfaces (canvas hosts, HUD slots) when a module needs one directly. */
     surface: SurfaceAllocator;
     /** Register a rendered scene (Three/Phaser/custom). The host drives its lifecycle. */
@@ -211,8 +360,8 @@ interface RouteEntry {
     order?: number;
 }
 /**
- * Typed pub/sub shared by every module. Defaults to an open `Record<string, unknown>` topic map;
- * a host may parameterize it with a known event map for stronger typing.
+ * @deprecated The pre-0.2 string-topic bus. `ctx.events` is now `ModuleEvents` (typed topic tokens,
+ * see `defineTopic`); this type stays only so older code that named it still compiles.
  */
 interface SharedEventBus<Events extends Record<string, unknown> = Record<string, unknown>> {
     emit<K extends keyof Events & string>(topic: K, payload: Events[K]): void;
@@ -222,4 +371,4 @@ interface SharedEventBus<Events extends Record<string, unknown> = Record<string,
 /** Identity helper that pins a module literal to the `Module` type for editor help and errors. */
 declare function defineModule(module: Module): Module;
 
-export { type EngineScene, type Module, type ModuleAgentApi, type ModuleAuthor, type ModuleContext, type ModuleEngine, type ModuleManifest, type ModuleMedia, type ModuleMeta, type ModuleType, type PanelSlot, type RouteEntry, type SceneMountContext, type SharedEventBus, type SurfaceAllocator, type SurfaceHandle, type SurfaceKind, type UiPanel, defineModule };
+export { type EngineScene, type InferShape, type Module, type ModuleAgentApi, type ModuleAuthor, type ModuleContext, type ModuleEngine, type ModuleEventEmit, type ModuleEventListen, type ModuleEvents, type ModuleEventsManifest, type ModuleManifest, type ModuleMedia, type ModuleMeta, type ModuleSharedUi, type ModuleType, type PanelSlot, type RouteEntry, SHARED_UI_ROLES, type SceneMountContext, type Shape, type ShapeDescriptor, type ShapeLeaf, type ShapeLeafSpec, type SharedEventBus, type SharedUiContext, type SharedUiRole, type SurfaceAllocator, type SurfaceHandle, type SurfaceKind, TOPIC_NAME_RE, type Topic, type TopicName, type TopicPayload, type UiPanel, defineModule, defineTopic, hostTopics, isSharedUiRole, isTopicName, shape, topicNamespace };

package/dist/index.js

@@ -1 +1 @@
-function t(e){return e}export{t as defineModule};
+var m=/^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*@[1-9]\d*$/;function x(e){return typeof e=="string"&&m.test(e)}function M(e){let t=e.indexOf(":");return t<0?"":e.slice(0,t)}var l=/^(string|number|boolean)(\[\])?(\?)?$/;function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function c(e,t){return e==="number"?typeof t=="number"&&Number.isFinite(t):typeof t===e}function f(e,t,r){if(!u(t))return `${r||"payload"} must be an object`;for(let[n,o]of Object.entries(e)){let i=r?`${r}.${n}`:n,a=t[n];if(typeof o!="string"){let p=f(o,a,i);if(p)return p;continue}let d=l.exec(o);if(!d)return `${i}: invalid descriptor "${o}"`;let[,s="",g,S]=d;if(a===void 0){if(S)continue;return `${i} is missing`}if(g){if(!Array.isArray(a))return `${i} must be ${s}[]`;if(!a.every(p=>c(s,p)))return `${i} must contain only ${s} values`;continue}if(!c(s,a))return `${i} must be a ${s}`}return null}function y(e,t){for(let[r,n]of Object.entries(e)){let o=t?`${t}.${r}`:r;if(typeof n=="string"){if(!l.test(n))throw new Error(`shape(): field "${o}" has invalid type "${n}" \u2014 use "string" | "number" | "boolean", optionally with "[]" and/or a trailing "?"`)}else if(u(n))y(n,o);else throw new Error(`shape(): field "${o}" must be a type string or an object`)}}function h(e){return y(e,""),{descriptor:e,check:t=>f(e,t,"")}}function v(e,t){if(!x(e))throw new Error(`defineTopic(): "${e}" is not a valid topic name \u2014 expected "<module-id>:<event>@<major>", e.g. "idle-rpg:character-upgraded@1"`);return {name:e,shape:t}}var E={modeChanged:v("host:mode-changed@1",h({from:"string?",to:"string"}))};var T=["currency-bar","wallet","status","account"];function $(e){return typeof e=="string"&&T.includes(e)}function D(e){return e}export{T as SHARED_UI_ROLES,m as TOPIC_NAME_RE,D as defineModule,v as defineTopic,E as hostTopics,$ as isSharedUiRole,x as isTopicName,h as shape,M as topicNamespace};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idosgames/module-sdk",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "description": "The composable-module contract for the iDosGames host shell: Module / ModuleContext types plus tiny authoring helpers. Framework-neutral at runtime — a module can be a game (Three/Phaser), a plain app, or an AI app.",
   "type": "module",
   "license": "MIT",
@@ -46,7 +46,7 @@
   },
   "//": "@idosgames/core is a real range, not '*': a published contract must name the version of core whose IDosGamesClient/SdkEvents shapes it references. Bump in step with core (see RELEASING.md). react is an OPTIONAL peer — the contract references React's ComponentType type only (a UI panel is a React component), which is erased at build, so a runtime-only module needs no React.",
   "dependencies": {
-    "@idosgames/core": "^0.10.0"
+    "@idosgames/core": "^0.12.0"
   },
   "peerDependencies": {
     "react": "^18.3.1 || ^19.0.0"