@idosgames/module-sdk 0.11.0 → 0.13.0

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { RealtimeSession, IDosGamesClient } from '@idosgames/core';
+import { RealtimeSession, VoiceController, IDosGamesClient } from '@idosgames/core';
 export { IDosGamesClient, SdkEvents } from '@idosgames/core';
 import { ComponentType } from 'react';
 
@@ -232,6 +232,13 @@ interface FeatureDefinition {
     primary?: boolean;
     /** The screen. Rendered by the presenter, inside the kit provider and the client provider. */
     Screen: ComponentType<FeatureScreenProps>;
+    /**
+     * The screen paints edge to edge (its own background, a stage like the Heroes screen): the lobby
+     * gives it the whole area between its top row and the menu — no side padding, no width limit — and
+     * stretches it to that height. Default `false`: a page on the lobby's background, padded and kept
+     * to a readable width on a wide window.
+     */
+    fullBleed?: boolean;
     /**
      * Whether the title has something for this screen yet. Default `true`. A screen that depends on
      * title data (a shop without offers is an empty tab) registers with `false` and calls
@@ -345,6 +352,13 @@ interface MultiplayerRoom {
     readonly lateJoin: boolean;
     /** Leave the room for good: closes the session and the rooms screen forgets it. */
     leave(): Promise<void>;
+    /**
+     * The room's voice chat, or `null` when the room has none. The rooms system owns it and draws its
+     * controls (the mic button over the game included); a game reads it for its own touches — who is
+     * speaking (`isSpeaking`, `on("change")`), a talking player's marker, proximity volume
+     * (`setPeerVolume` by distance).
+     */
+    readonly voice: VoiceController | null;
 }
 /** What `ctx.features.open("multiplayer", args)` understands. */
 interface MultiplayerScreenArgs {
@@ -525,6 +539,76 @@ interface AppNotifications {
     dismiss(id: string): void;
 }
 
+/** The room's voices, as the recording takes them (the multiplayer system provides this). */
+interface RecordingVoiceSource {
+    /** This player's microphone track (silent while not transmitting); null — mic off. */
+    mic(): MediaStreamTrack | null;
+    /** Other players' voice tracks. */
+    others(): MediaStreamTrack[];
+    /** The publisher allows other players' voices in videos (`Multiplayer.RecordVoices`). */
+    recordOthers(): boolean;
+    /** Called when tracks come or go (a player joined, the mic went on). */
+    subscribe(listener: () => void): () => void;
+}
+/** `ctx.clips`. */
+interface ClipsRegistry {
+    /**
+     * A bright moment right now. `weight` 1–10 (default 5): how much it is worth showing — a boss
+     * kill 8, a level-up 4. Close marks merge into one clip (their weights add up).
+     */
+    mark(name: string, weight?: number): void;
+    /** The multiplayer system registers the room's voices here; `null` when the room is gone. */
+    setVoiceSource(source: RecordingVoiceSource | null): void;
+    /** This player is making a long recording right now. */
+    isRecording(): boolean;
+    /** Called when `isRecording` changes. */
+    subscribe(listener: () => void): () => void;
+}
+
+/** The hero to draw, as the engine's Character system describes it. */
+interface CharacterArtSubject {
+    /** The character's id (`CharacterID` of its definition). */
+    characterId: string;
+    /** Its class (`Classification.ClassID`), if any. */
+    classId?: string | null;
+    /** What it wears: equipment slot id → the worn item's `ItemID`. */
+    equipment: Readonly<Record<string, string>>;
+    /** The worn skin (`WornSkinID`), if any. */
+    skinId?: string | null;
+    /** Not the player's yet (shown dimmed by the screen) — the art may draw it in a calmer pose. */
+    locked?: boolean;
+}
+interface CharacterArtOptions {
+    /**
+     * "live" — the figure moving (breathing, blinking), for a big view; "still" — one frame, for a list
+     * of many heroes. Default "live".
+     */
+    mode?: "live" | "still";
+}
+/** One mounted figure. */
+interface CharacterArtView {
+    /** The hero changed (equipped, switched): redraw it. A changed weapon may play a short move. */
+    update(subject: CharacterArtSubject): void;
+    /** Stop drawing and free what was made (the screen unmounts). */
+    destroy(): void;
+}
+interface CharacterArt {
+    /**
+     * Draw the hero into `host` — an element the screen sizes and positions; fill it, the figure
+     * standing on its bottom edge and centred. The returned view is updated and destroyed by the screen.
+     */
+    mount(host: HTMLElement, subject: CharacterArtSubject, options?: CharacterArtOptions): CharacterArtView;
+}
+/** `ctx.characterArt` — the game's character art, shared by every module of the session. */
+interface CharacterArtRegistry {
+    /** Make this the art every screen draws heroes with. Returns the unregister function. */
+    set(art: CharacterArt): () => void;
+    /** The art now, or null — no game set one (the screen draws its own picture). */
+    get(): CharacterArt | null;
+    /** Called when the art is set or removed (a screen remounts its figures). */
+    subscribe(listener: () => void): () => void;
+}
+
 /** What a module is, for catalog/UI purposes. Not every module is a game. */
 type ModuleType = "game" | "app" | "ai-app";
 /**
@@ -719,6 +803,12 @@ interface ModuleContext {
      * `LobbyHeroDefinition`.
      */
     lobby: LobbyRegistry;
+    /**
+     * The game's character art (see `CharacterArt`): a game sets how its hero is drawn (`set`), a
+     * screen of another module (the Heroes screen) draws the hero with it (`get()?.mount(...)`) — or its
+     * own picture when no game set one.
+     */
+    characterArt: CharacterArtRegistry;
     /**
      * Switch the host to another mode (a route id registered by any module) — e.g. the lobby starts a
      * game, the Workshop opens a world and hands the screen to the game. Unknown ids are ignored. Called
@@ -750,6 +840,12 @@ interface ModuleContext {
      * one look, one queue, one sound for the whole app. The module's own id is the default `source`.
      */
     notifications: AppNotifications;
+    /**
+     * The platform's video recording (see `ClipsRegistry`): a game marks bright moments
+     * (`ctx.clips.mark("boss_down", 8)`) — they become the player's "Best moments" clips on
+     * idosgames.com. A no-op anywhere else.
+     */
+    clips: ClipsRegistry;
 }
 /**
  * A module's debug surface for the agent: read its state, drive it with named actions.
@@ -842,6 +938,21 @@ interface EngineScene {
      * host falls back to reading the canvas itself, which is correct for 2D canvases.
      */
     capture?(): Promise<Blob | null>;
+    /**
+     * Where the action is right now, 0–1 on both axes of the canvas (the player, the explosion) — for
+     * the platform's video recording: a vertical (TikTok) cut of a landscape game follows this point
+     * instead of cutting the middle. Called a few times a second; keep it cheap. Omit — the centre.
+     */
+    focus?(): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * The game's own sound as a MediaStream, for the platform's video recording — e.g. a
+     * `MediaStreamAudioDestinationNode` your audio graph also feeds (Three.js: `listener.context`).
+     * Omit — videos carry the voices but not the game's sound.
+     */
+    audio?(): MediaStream | null;
     /** Permanent teardown — dispose GPU resources, remove listeners. */
     destroy(): void;
 }
@@ -930,4 +1041,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 AppNotifications, type CapturedContent, type ContentFileData, type ContentRegistry, type ContentTypeHandler, type DownloadedContent, type EngineScene, type FeatureDefinition, type FeatureEntry, type FeatureGroup, type FeaturePresenter, type FeatureRegistry, type FeatureScreenProps, type InferShape, type LoadingReporter, type LoadingTask, type LobbyHeroAction, type LobbyHeroDefinition, type LobbyHeroStage, type LobbyHeroView, type LobbyRegistry, type LocalContentItem, type ModeEntry, type ModeRegistry, 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 MultiplayerGame, type MultiplayerRegistry, type MultiplayerRoom, type MultiplayerScreenArgs, type MultiplayerSetting, type NotificationAction, type NotificationInput, type NotificationLevel, 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 };
+export { type AppNotifications, type CapturedContent, type CharacterArt, type CharacterArtOptions, type CharacterArtRegistry, type CharacterArtSubject, type CharacterArtView, type ClipsRegistry, type ContentFileData, type ContentRegistry, type ContentTypeHandler, type DownloadedContent, type EngineScene, type FeatureDefinition, type FeatureEntry, type FeatureGroup, type FeaturePresenter, type FeatureRegistry, type FeatureScreenProps, type InferShape, type LoadingReporter, type LoadingTask, type LobbyHeroAction, type LobbyHeroDefinition, type LobbyHeroStage, type LobbyHeroView, type LobbyRegistry, type LocalContentItem, type ModeEntry, type ModeRegistry, 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 MultiplayerGame, type MultiplayerRegistry, type MultiplayerRoom, type MultiplayerScreenArgs, type MultiplayerSetting, type NotificationAction, type NotificationInput, type NotificationLevel, type PanelSlot, type RecordingVoiceSource, 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

@@ -1,4 +1,4 @@
-import { RealtimeSession, IDosGamesClient } from '@idosgames/core';
+import { RealtimeSession, VoiceController, IDosGamesClient } from '@idosgames/core';
 export { IDosGamesClient, SdkEvents } from '@idosgames/core';
 import { ComponentType } from 'react';
 
@@ -232,6 +232,13 @@ interface FeatureDefinition {
     primary?: boolean;
     /** The screen. Rendered by the presenter, inside the kit provider and the client provider. */
     Screen: ComponentType<FeatureScreenProps>;
+    /**
+     * The screen paints edge to edge (its own background, a stage like the Heroes screen): the lobby
+     * gives it the whole area between its top row and the menu — no side padding, no width limit — and
+     * stretches it to that height. Default `false`: a page on the lobby's background, padded and kept
+     * to a readable width on a wide window.
+     */
+    fullBleed?: boolean;
     /**
      * Whether the title has something for this screen yet. Default `true`. A screen that depends on
      * title data (a shop without offers is an empty tab) registers with `false` and calls
@@ -345,6 +352,13 @@ interface MultiplayerRoom {
     readonly lateJoin: boolean;
     /** Leave the room for good: closes the session and the rooms screen forgets it. */
     leave(): Promise<void>;
+    /**
+     * The room's voice chat, or `null` when the room has none. The rooms system owns it and draws its
+     * controls (the mic button over the game included); a game reads it for its own touches — who is
+     * speaking (`isSpeaking`, `on("change")`), a talking player's marker, proximity volume
+     * (`setPeerVolume` by distance).
+     */
+    readonly voice: VoiceController | null;
 }
 /** What `ctx.features.open("multiplayer", args)` understands. */
 interface MultiplayerScreenArgs {
@@ -525,6 +539,76 @@ interface AppNotifications {
     dismiss(id: string): void;
 }
 
+/** The room's voices, as the recording takes them (the multiplayer system provides this). */
+interface RecordingVoiceSource {
+    /** This player's microphone track (silent while not transmitting); null — mic off. */
+    mic(): MediaStreamTrack | null;
+    /** Other players' voice tracks. */
+    others(): MediaStreamTrack[];
+    /** The publisher allows other players' voices in videos (`Multiplayer.RecordVoices`). */
+    recordOthers(): boolean;
+    /** Called when tracks come or go (a player joined, the mic went on). */
+    subscribe(listener: () => void): () => void;
+}
+/** `ctx.clips`. */
+interface ClipsRegistry {
+    /**
+     * A bright moment right now. `weight` 1–10 (default 5): how much it is worth showing — a boss
+     * kill 8, a level-up 4. Close marks merge into one clip (their weights add up).
+     */
+    mark(name: string, weight?: number): void;
+    /** The multiplayer system registers the room's voices here; `null` when the room is gone. */
+    setVoiceSource(source: RecordingVoiceSource | null): void;
+    /** This player is making a long recording right now. */
+    isRecording(): boolean;
+    /** Called when `isRecording` changes. */
+    subscribe(listener: () => void): () => void;
+}
+
+/** The hero to draw, as the engine's Character system describes it. */
+interface CharacterArtSubject {
+    /** The character's id (`CharacterID` of its definition). */
+    characterId: string;
+    /** Its class (`Classification.ClassID`), if any. */
+    classId?: string | null;
+    /** What it wears: equipment slot id → the worn item's `ItemID`. */
+    equipment: Readonly<Record<string, string>>;
+    /** The worn skin (`WornSkinID`), if any. */
+    skinId?: string | null;
+    /** Not the player's yet (shown dimmed by the screen) — the art may draw it in a calmer pose. */
+    locked?: boolean;
+}
+interface CharacterArtOptions {
+    /**
+     * "live" — the figure moving (breathing, blinking), for a big view; "still" — one frame, for a list
+     * of many heroes. Default "live".
+     */
+    mode?: "live" | "still";
+}
+/** One mounted figure. */
+interface CharacterArtView {
+    /** The hero changed (equipped, switched): redraw it. A changed weapon may play a short move. */
+    update(subject: CharacterArtSubject): void;
+    /** Stop drawing and free what was made (the screen unmounts). */
+    destroy(): void;
+}
+interface CharacterArt {
+    /**
+     * Draw the hero into `host` — an element the screen sizes and positions; fill it, the figure
+     * standing on its bottom edge and centred. The returned view is updated and destroyed by the screen.
+     */
+    mount(host: HTMLElement, subject: CharacterArtSubject, options?: CharacterArtOptions): CharacterArtView;
+}
+/** `ctx.characterArt` — the game's character art, shared by every module of the session. */
+interface CharacterArtRegistry {
+    /** Make this the art every screen draws heroes with. Returns the unregister function. */
+    set(art: CharacterArt): () => void;
+    /** The art now, or null — no game set one (the screen draws its own picture). */
+    get(): CharacterArt | null;
+    /** Called when the art is set or removed (a screen remounts its figures). */
+    subscribe(listener: () => void): () => void;
+}
+
 /** What a module is, for catalog/UI purposes. Not every module is a game. */
 type ModuleType = "game" | "app" | "ai-app";
 /**
@@ -719,6 +803,12 @@ interface ModuleContext {
      * `LobbyHeroDefinition`.
      */
     lobby: LobbyRegistry;
+    /**
+     * The game's character art (see `CharacterArt`): a game sets how its hero is drawn (`set`), a
+     * screen of another module (the Heroes screen) draws the hero with it (`get()?.mount(...)`) — or its
+     * own picture when no game set one.
+     */
+    characterArt: CharacterArtRegistry;
     /**
      * Switch the host to another mode (a route id registered by any module) — e.g. the lobby starts a
      * game, the Workshop opens a world and hands the screen to the game. Unknown ids are ignored. Called
@@ -750,6 +840,12 @@ interface ModuleContext {
      * one look, one queue, one sound for the whole app. The module's own id is the default `source`.
      */
     notifications: AppNotifications;
+    /**
+     * The platform's video recording (see `ClipsRegistry`): a game marks bright moments
+     * (`ctx.clips.mark("boss_down", 8)`) — they become the player's "Best moments" clips on
+     * idosgames.com. A no-op anywhere else.
+     */
+    clips: ClipsRegistry;
 }
 /**
  * A module's debug surface for the agent: read its state, drive it with named actions.
@@ -842,6 +938,21 @@ interface EngineScene {
      * host falls back to reading the canvas itself, which is correct for 2D canvases.
      */
     capture?(): Promise<Blob | null>;
+    /**
+     * Where the action is right now, 0–1 on both axes of the canvas (the player, the explosion) — for
+     * the platform's video recording: a vertical (TikTok) cut of a landscape game follows this point
+     * instead of cutting the middle. Called a few times a second; keep it cheap. Omit — the centre.
+     */
+    focus?(): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * The game's own sound as a MediaStream, for the platform's video recording — e.g. a
+     * `MediaStreamAudioDestinationNode` your audio graph also feeds (Three.js: `listener.context`).
+     * Omit — videos carry the voices but not the game's sound.
+     */
+    audio?(): MediaStream | null;
     /** Permanent teardown — dispose GPU resources, remove listeners. */
     destroy(): void;
 }
@@ -930,4 +1041,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 AppNotifications, type CapturedContent, type ContentFileData, type ContentRegistry, type ContentTypeHandler, type DownloadedContent, type EngineScene, type FeatureDefinition, type FeatureEntry, type FeatureGroup, type FeaturePresenter, type FeatureRegistry, type FeatureScreenProps, type InferShape, type LoadingReporter, type LoadingTask, type LobbyHeroAction, type LobbyHeroDefinition, type LobbyHeroStage, type LobbyHeroView, type LobbyRegistry, type LocalContentItem, type ModeEntry, type ModeRegistry, 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 MultiplayerGame, type MultiplayerRegistry, type MultiplayerRoom, type MultiplayerScreenArgs, type MultiplayerSetting, type NotificationAction, type NotificationInput, type NotificationLevel, 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 };
+export { type AppNotifications, type CapturedContent, type CharacterArt, type CharacterArtOptions, type CharacterArtRegistry, type CharacterArtSubject, type CharacterArtView, type ClipsRegistry, type ContentFileData, type ContentRegistry, type ContentTypeHandler, type DownloadedContent, type EngineScene, type FeatureDefinition, type FeatureEntry, type FeatureGroup, type FeaturePresenter, type FeatureRegistry, type FeatureScreenProps, type InferShape, type LoadingReporter, type LoadingTask, type LobbyHeroAction, type LobbyHeroDefinition, type LobbyHeroStage, type LobbyHeroView, type LobbyRegistry, type LocalContentItem, type ModeEntry, type ModeRegistry, 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 MultiplayerGame, type MultiplayerRegistry, type MultiplayerRoom, type MultiplayerScreenArgs, type MultiplayerSetting, type NotificationAction, type NotificationInput, type NotificationLevel, type PanelSlot, type RecordingVoiceSource, 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 @@
-var x=/^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*@[1-9]\d*$/;function S(e){return typeof e=="string"&&x.test(e)}function M(e){let t=e.indexOf(":");return t<0?"":e.slice(0,t)}var c=/^(string|number|boolean)(\[\])?(\?)?$/;function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(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=c.exec(o);if(!d)return `${i}: invalid descriptor "${o}"`;let[,s="",g,m]=d;if(a===void 0){if(m)continue;return `${i} is missing`}if(g){if(!Array.isArray(a))return `${i} must be ${s}[]`;if(!a.every(p=>l(s,p)))return `${i} must contain only ${s} values`;continue}if(!l(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(!c.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(!S(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 T={modeChanged:v("host:mode-changed@1",h({from:"string?",to:"string"}))};var b=["currency-bar","wallet","status","account","menu","modes"];function R(e){return typeof e=="string"&&b.includes(e)}function D(e){return e}export{b as SHARED_UI_ROLES,x as TOPIC_NAME_RE,D as defineModule,v as defineTopic,T as hostTopics,R as isSharedUiRole,S as isTopicName,h as shape,M as topicNamespace};
+var x=/^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*@[1-9]\d*$/;function S(e){return typeof e=="string"&&x.test(e)}function M(e){let t=e.indexOf(":");return t<0?"":e.slice(0,t)}var c=/^(string|number|boolean)(\[\])?(\?)?$/;function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(e,t){return e==="number"?typeof t=="number"&&Number.isFinite(t):typeof t===e}function f(e,t,o){if(!u(t))return `${o||"payload"} must be an object`;for(let[r,n]of Object.entries(e)){let i=o?`${o}.${r}`:r,a=t[r];if(typeof n!="string"){let p=f(n,a,i);if(p)return p;continue}let d=c.exec(n);if(!d)return `${i}: invalid descriptor "${n}"`;let[,s="",g,m]=d;if(a===void 0){if(m)continue;return `${i} is missing`}if(g){if(!Array.isArray(a))return `${i} must be ${s}[]`;if(!a.every(p=>l(s,p)))return `${i} must contain only ${s} values`;continue}if(!l(s,a))return `${i} must be a ${s}`}return null}function y(e,t){for(let[o,r]of Object.entries(e)){let n=t?`${t}.${o}`:o;if(typeof r=="string"){if(!c.test(r))throw new Error(`shape(): field "${n}" has invalid type "${r}" \u2014 use "string" | "number" | "boolean", optionally with "[]" and/or a trailing "?"`)}else if(u(r))y(r,n);else throw new Error(`shape(): field "${n}" 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(!S(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 T={modeChanged:v("host:mode-changed@1",h({from:"string?",to:"string"}))};var b=["currency-bar","wallet","status","account","menu","modes"];function R(e){return typeof e=="string"&&b.includes(e)}function D(e){return e}export{b as SHARED_UI_ROLES,x as TOPIC_NAME_RE,D as defineModule,v as defineTopic,T as hostTopics,R as isSharedUiRole,S as isTopicName,h as shape,M as topicNamespace};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idosgames/module-sdk",
-  "version": "0.11.0",
+  "version": "0.13.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.21.0"
+    "@idosgames/core": "^0.23.0"
   },
   "peerDependencies": {
     "react": "^18.3.1 || ^19.0.0"