@memberjunction/ng-conversations 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/lib/components/realtime/realtime-surface-placement-prefs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `MJ: User Settings` keys under which the call overlay saves the user's layout of its channel surfaces, per user via
+ * `UserInfoEngine`. The saved forms, and how they are read back, are the shared ones in
+ * `@memberjunction/ai-realtime-client/media`, which the meeting room uses too:
+ * - {@link SURFACE_PLACEMENT_PREF_KEY}: where the user moved each channel's surface (the stage, a picture-in-picture
+ *   box, its tab, hidden), as `SerializePlacementMoves` writes the moves: oldest first, one per surface, so the most
+ *   recent move to the stage wins it in every later session too.
+ * - {@link SURFACE_PIP_PREF_KEY}: where the user put each picture-in-picture box, as `SerializePipRects` writes them.
+ */
+/** `MJ: User Settings` key for the surface placement preference (versioned shape). */
+export declare const SURFACE_PLACEMENT_PREF_KEY = "mj.realtime.placement.v1";
+/** `MJ: User Settings` key for picture-in-picture boxes: `{ [channelKey]: { X, Y, W, H } }`, fractions of the stage. */
+export declare const SURFACE_PIP_PREF_KEY = "mj.realtime.pip.v1";
+//# sourceMappingURL=realtime-surface-placement-prefs.d.ts.map

package/dist/lib/components/realtime/realtime-surface-placement-prefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-surface-placement-prefs.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-placement-prefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sFAAsF;AACtF,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,wHAAwH;AACxH,eAAO,MAAM,oBAAoB,uBAAuB,CAAC"}

package/dist/lib/components/realtime/realtime-surface-placement-prefs.js

@@ -0,0 +1,14 @@
+/**
+ * The `MJ: User Settings` keys under which the call overlay saves the user's layout of its channel surfaces, per user via
+ * `UserInfoEngine`. The saved forms, and how they are read back, are the shared ones in
+ * `@memberjunction/ai-realtime-client/media`, which the meeting room uses too:
+ * - {@link SURFACE_PLACEMENT_PREF_KEY}: where the user moved each channel's surface (the stage, a picture-in-picture
+ *   box, its tab, hidden), as `SerializePlacementMoves` writes the moves: oldest first, one per surface, so the most
+ *   recent move to the stage wins it in every later session too.
+ * - {@link SURFACE_PIP_PREF_KEY}: where the user put each picture-in-picture box, as `SerializePipRects` writes them.
+ */
+/** `MJ: User Settings` key for the surface placement preference (versioned shape). */
+export const SURFACE_PLACEMENT_PREF_KEY = 'mj.realtime.placement.v1';
+/** `MJ: User Settings` key for picture-in-picture boxes: `{ [channelKey]: { X, Y, W, H } }`, fractions of the stage. */
+export const SURFACE_PIP_PREF_KEY = 'mj.realtime.pip.v1';
+//# sourceMappingURL=realtime-surface-placement-prefs.js.map

package/dist/lib/components/realtime/realtime-surface-placement-prefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-surface-placement-prefs.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-placement-prefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAErE,wHAAwH;AACxH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC","sourcesContent":["/**\n * The `MJ: User Settings` keys under which the call overlay saves the user's layout of its channel surfaces, per user via\n * `UserInfoEngine`. The saved forms, and how they are read back, are the shared ones in\n * `@memberjunction/ai-realtime-client/media`, which the meeting room uses too:\n * - {@link SURFACE_PLACEMENT_PREF_KEY}: where the user moved each channel's surface (the stage, a picture-in-picture\n *   box, its tab, hidden), as `SerializePlacementMoves` writes the moves: oldest first, one per surface, so the most\n *   recent move to the stage wins it in every later session too.\n * - {@link SURFACE_PIP_PREF_KEY}: where the user put each picture-in-picture box, as `SerializePipRects` writes them.\n */\n\n/** `MJ: User Settings` key for the surface placement preference (versioned shape). */\nexport const SURFACE_PLACEMENT_PREF_KEY = 'mj.realtime.placement.v1';\n\n/** `MJ: User Settings` key for picture-in-picture boxes: `{ [channelKey]: { X, Y, W, H } }`, fractions of the stage. */\nexport const SURFACE_PIP_PREF_KEY = 'mj.realtime.pip.v1';\n"]}

package/dist/lib/components/realtime/realtime-surface-stage.model.d.ts

@@ -0,0 +1,74 @@
+import { type MediaPlacementMove } from '@memberjunction/ai-realtime-client/media';
+import type { MediaStagePlacement, MediaStageSurface } from '@memberjunction/ng-realtime-media';
+import type { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';
+/**
+ * Which channel surfaces the call overlay's stage (`mj-media-stage`) holds, and where each one shows.
+ *
+ * **Placement.** Every surface starts where its channel's registry row places it (`SurfacePlacement`: its tab, unless the
+ * row says otherwise). The user moves it to the stage (it fills the call), into a picture-in-picture box, to its tab, or
+ * out of sight, within the placements the row allows; the moves are kept in order, one per surface, and resolved by
+ * `ResolveSurfacePlacements`, so the most recent move to the stage wins it, the surface it displaces returns to where its
+ * channel places it, and picture-in-picture boxes stack newest first. The host saves {@link Moves} and loads them back
+ * ({@link LoadMoves}), so a layout carries over to later sessions.
+ *
+ * **Creation.** A channel's surface is created the first time it is seen (its tab shows it, or it is on the stage or
+ * in a picture-in-picture box) and kept until the channel leaves the session. Moving it, hiding the panel or switching tabs only changes where it
+ * shows, so a whiteboard keeps its view and a stream keeps playing.
+ *
+ * Pure state with no Angular: the overlay reports the session's channels, the channel tab the panel is showing and
+ * the user's moves, and binds {@link Surfaces} to the stage.
+ */
+export declare class RealtimeSurfaceStageModel {
+    /** Channels with a surface, by key, in the order their tabs registered. */
+    private readonly plugins;
+    /** Keys whose surface has been seen, so it stays created. */
+    private readonly seen;
+    private moves;
+    private activeTabKey;
+    private placements;
+    /** Picture-in-picture surfaces, newest first. */
+    private pipOrder;
+    private surfaces;
+    private allowedPlacements;
+    /** The stage's surfaces. The array is replaced only when a surface or a placement changes, so it binds cheaply. */
+    get Surfaces(): readonly MediaStageSurface[];
+    /** Where each registered channel's surface is placed, by key. Replaced only when a placement changes. */
+    get Placements(): ReadonlyMap<string, MediaStagePlacement>;
+    /** Where the user may move each registered channel's surface, by key. Replaced only when the channels change. */
+    get AllowedPlacements(): ReadonlyMap<string, readonly MediaStagePlacement[]>;
+    /** The user's moves, oldest first, one per surface: what the host saves. */
+    get Moves(): readonly MediaPlacementMove[];
+    /** The channel whose surface is on the stage, or `null`. */
+    get StageKey(): string | null;
+    /** The plugin behind a surface, or `null` once its channel has left. */
+    PluginFor(key: string): BaseRealtimeChannelClient | null;
+    /** Where the user may move a channel's surface; nowhere for a channel without a surface in this session. */
+    AllowedFor(key: string): readonly MediaStagePlacement[];
+    /**
+     * Where a channel's surface goes when it leaves the stage (the user leaves the focus layout, or the channel lets go of
+     * it): where its channel places it, or the first of picture-in-picture, tab and hidden that it allows.
+     */
+    OffStagePlacement(key: string): MediaStagePlacement;
+    /** A channel with a surface got its tab. Registering its key again follows the channel's new plugin instance. */
+    Register(plugin: BaseRealtimeChannelClient): void;
+    /** The session's channels changed: a surface whose plugin is no longer among them is dropped. Moves are kept. */
+    KeepOnly(channels: readonly BaseRealtimeChannelClient[]): void;
+    /** The channel whose tab the panel is showing, or `null` when it shows none (another tab, collapsed, hidden). */
+    SetActiveTab(key: string | null): void;
+    /** Starts from saved moves, such as the user's last layout. */
+    LoadMoves(moves: readonly MediaPlacementMove[]): void;
+    /**
+     * Moves a channel's surface. Returns `false`, changing nothing, for a channel without a surface in this session, a
+     * placement its channel does not allow, or the placement it already has.
+     */
+    Move(key: string, placement: MediaStagePlacement): boolean;
+    /** Forgets every move: each surface returns to where its channel places it. */
+    ResetLayout(): void;
+    private update;
+    /** Rebuilds {@link AllowedPlacements} from the registered channels, keeping the map when nothing in it changed. */
+    private updateAllowedPlacements;
+    /** A stage surface for a channel: its placement, its name, and where it stacks when it is picture-in-picture. */
+    private surfaceFor;
+    private resolvePlacements;
+}
+//# sourceMappingURL=realtime-surface-stage.model.d.ts.map

package/dist/lib/components/realtime/realtime-surface-stage.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-surface-stage.model.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-stage.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoE,KAAK,kBAAkB,EAAqB,MAAM,0CAA0C,CAAC;AACxK,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,yBAAyB;IACpC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IACxE,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAAuD;IACzE,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,iBAAiB,CAAkE;IAE3F,mHAAmH;IACnH,IAAW,QAAQ,IAAI,SAAS,iBAAiB,EAAE,CAElD;IAED,yGAAyG;IACzG,IAAW,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAEhE;IAED,iHAAiH;IACjH,IAAW,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC,CAElF;IAED,4EAA4E;IAC5E,IAAW,KAAK,IAAI,SAAS,kBAAkB,EAAE,CAEhD;IAED,4DAA4D;IAC5D,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAOnC;IAED,wEAAwE;IACjE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAI/D,4GAA4G;IACrG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE;IAI9D;;;OAGG;IACI,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAK1D,iHAAiH;IAC1G,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI;IAMxD,iHAAiH;IAC1G,QAAQ,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,GAAG,IAAI;IAWrE,iHAAiH;IAC1G,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK7C,+DAA+D;IACxD,SAAS,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAK5D;;;OAGG;IACI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,OAAO;IASjE,+EAA+E;IACxE,WAAW,IAAI,IAAI;IAK1B,OAAO,CAAC,MAAM;IAad,mHAAmH;IACnH,OAAO,CAAC,uBAAuB;IAO/B,iHAAiH;IACjH,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;CAc1B"}

package/dist/lib/components/realtime/realtime-surface-stage.model.js

@@ -0,0 +1,171 @@
+import { PlacementOffStage, RecordPlacementMove, ResolveSurfacePlacements } from '@memberjunction/ai-realtime-client/media';
+/**
+ * Which channel surfaces the call overlay's stage (`mj-media-stage`) holds, and where each one shows.
+ *
+ * **Placement.** Every surface starts where its channel's registry row places it (`SurfacePlacement`: its tab, unless the
+ * row says otherwise). The user moves it to the stage (it fills the call), into a picture-in-picture box, to its tab, or
+ * out of sight, within the placements the row allows; the moves are kept in order, one per surface, and resolved by
+ * `ResolveSurfacePlacements`, so the most recent move to the stage wins it, the surface it displaces returns to where its
+ * channel places it, and picture-in-picture boxes stack newest first. The host saves {@link Moves} and loads them back
+ * ({@link LoadMoves}), so a layout carries over to later sessions.
+ *
+ * **Creation.** A channel's surface is created the first time it is seen (its tab shows it, or it is on the stage or
+ * in a picture-in-picture box) and kept until the channel leaves the session. Moving it, hiding the panel or switching tabs only changes where it
+ * shows, so a whiteboard keeps its view and a stream keeps playing.
+ *
+ * Pure state with no Angular: the overlay reports the session's channels, the channel tab the panel is showing and
+ * the user's moves, and binds {@link Surfaces} to the stage.
+ */
+export class RealtimeSurfaceStageModel {
+    /** Channels with a surface, by key, in the order their tabs registered. */
+    plugins = new Map();
+    /** Keys whose surface has been seen, so it stays created. */
+    seen = new Set();
+    moves = [];
+    activeTabKey = null;
+    placements = new Map();
+    /** Picture-in-picture surfaces, newest first. */
+    pipOrder = [];
+    surfaces = [];
+    allowedPlacements = new Map();
+    /** The stage's surfaces. The array is replaced only when a surface or a placement changes, so it binds cheaply. */
+    get Surfaces() {
+        return this.surfaces;
+    }
+    /** Where each registered channel's surface is placed, by key. Replaced only when a placement changes. */
+    get Placements() {
+        return this.placements;
+    }
+    /** Where the user may move each registered channel's surface, by key. Replaced only when the channels change. */
+    get AllowedPlacements() {
+        return this.allowedPlacements;
+    }
+    /** The user's moves, oldest first, one per surface: what the host saves. */
+    get Moves() {
+        return this.moves;
+    }
+    /** The channel whose surface is on the stage, or `null`. */
+    get StageKey() {
+        for (const [key, placement] of this.placements) {
+            if (placement === 'stage') {
+                return key;
+            }
+        }
+        return null;
+    }
+    /** The plugin behind a surface, or `null` once its channel has left. */
+    PluginFor(key) {
+        return this.plugins.get(key) ?? null;
+    }
+    /** Where the user may move a channel's surface; nowhere for a channel without a surface in this session. */
+    AllowedFor(key) {
+        return this.allowedPlacements.get(key) ?? [];
+    }
+    /**
+     * Where a channel's surface goes when it leaves the stage (the user leaves the focus layout, or the channel lets go of
+     * it): where its channel places it, or the first of picture-in-picture, tab and hidden that it allows.
+     */
+    OffStagePlacement(key) {
+        const plugin = this.plugins.get(key);
+        return plugin ? PlacementOffStage(surfaceOf(plugin)) : 'tab';
+    }
+    /** A channel with a surface got its tab. Registering its key again follows the channel's new plugin instance. */
+    Register(plugin) {
+        this.plugins.set(plugin.ChannelName, plugin);
+        this.updateAllowedPlacements();
+        this.update();
+    }
+    /** The session's channels changed: a surface whose plugin is no longer among them is dropped. Moves are kept. */
+    KeepOnly(channels) {
+        for (const [key, plugin] of [...this.plugins]) {
+            if (!channels.includes(plugin)) {
+                this.plugins.delete(key);
+                this.seen.delete(key);
+            }
+        }
+        this.updateAllowedPlacements();
+        this.update();
+    }
+    /** The channel whose tab the panel is showing, or `null` when it shows none (another tab, collapsed, hidden). */
+    SetActiveTab(key) {
+        this.activeTabKey = key;
+        this.update();
+    }
+    /** Starts from saved moves, such as the user's last layout. */
+    LoadMoves(moves) {
+        this.moves = [...moves];
+        this.update();
+    }
+    /**
+     * Moves a channel's surface. Returns `false`, changing nothing, for a channel without a surface in this session, a
+     * placement its channel does not allow, or the placement it already has.
+     */
+    Move(key, placement) {
+        if (!this.AllowedFor(key).includes(placement) || this.placements.get(key) === placement) {
+            return false;
+        }
+        this.moves = RecordPlacementMove(this.moves, { SurfaceKey: key, Placement: placement });
+        this.update();
+        return true;
+    }
+    /** Forgets every move: each surface returns to where its channel places it. */
+    ResetLayout() {
+        this.moves = [];
+        this.update();
+    }
+    update() {
+        this.resolvePlacements();
+        for (const [key, placement] of this.placements) {
+            if (placement === 'stage' || placement === 'pip' || (placement === 'tab' && key === this.activeTabKey)) {
+                this.seen.add(key);
+            }
+        }
+        const surfaces = [...this.plugins.keys()].filter((key) => this.seen.has(key)).map((key) => this.surfaceFor(key));
+        if (!sameSurfaces(surfaces, this.surfaces)) {
+            this.surfaces = surfaces;
+        }
+    }
+    /** Rebuilds {@link AllowedPlacements} from the registered channels, keeping the map when nothing in it changed. */
+    updateAllowedPlacements() {
+        const allowed = new Map([...this.plugins].map(([key, plugin]) => [key, plugin.SurfacePlacement.Allowed]));
+        if (!sameAllowedPlacements(allowed, this.allowedPlacements)) {
+            this.allowedPlacements = allowed;
+        }
+    }
+    /** A stage surface for a channel: its placement, its name, and where it stacks when it is picture-in-picture. */
+    surfaceFor(key) {
+        const placement = this.placements.get(key) ?? 'tab';
+        const surface = { Key: key, Placement: placement, Label: this.plugins.get(key)?.TabTitle };
+        return placement === 'pip' ? { ...surface, PipIndex: this.pipOrder.indexOf(key) } : surface;
+    }
+    resolvePlacements() {
+        const resolved = ResolveSurfacePlacements([...this.plugins.values()].map(surfaceOf), this.moves);
+        const placements = new Map();
+        if (resolved.Stage) {
+            placements.set(resolved.Stage.Key, 'stage');
+        }
+        resolved.Pips.forEach((surface) => placements.set(surface.Key, 'pip'));
+        resolved.Tabs.forEach((surface) => placements.set(surface.Key, 'tab'));
+        resolved.Hidden.forEach((surface) => placements.set(surface.Key, 'hidden'));
+        if (!samePlacements(placements, this.placements)) {
+            this.placements = placements;
+        }
+        this.pipOrder = resolved.Pips.map((surface) => surface.Key);
+    }
+}
+/** A channel's surface as the layout model sees it: where its channel places it unless moved, and where it may go. */
+function surfaceOf(plugin) {
+    const { Default, Allowed } = plugin.SurfacePlacement;
+    return { Key: plugin.ChannelName, Label: plugin.TabTitle, DefaultPlacement: Default, AllowedPlacements: Allowed };
+}
+function sameAllowedPlacements(a, b) {
+    return a.size === b.size && [...a].every(([key, allowed]) => b.get(key) === allowed);
+}
+function samePlacements(a, b) {
+    return a.size === b.size && [...a].every(([key, placement]) => b.get(key) === placement);
+}
+function sameSurfaces(a, b) {
+    return (a.length === b.length &&
+        a.every((surface, i) => surface.Key === b[i].Key && surface.Placement === b[i].Placement && surface.Label === b[i].Label && surface.PipIndex === b[i].PipIndex));
+}
+//# sourceMappingURL=realtime-surface-stage.model.js.map

package/dist/lib/components/realtime/realtime-surface-stage.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-surface-stage.model.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-stage.model.ts"],"names":[],"mappings":"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","sourcesContent":["import { PlacementOffStage, RecordPlacementMove, ResolveSurfacePlacements, type MediaPlacementMove, type MediaSurface } from '@memberjunction/ai-realtime-client/media';\nimport type { MediaStagePlacement, MediaStageSurface } from '@memberjunction/ng-realtime-media';\nimport type { BaseRealtimeChannelClient } from '@memberjunction/realtime-runtime';\n\n/**\n * Which channel surfaces the call overlay's stage (`mj-media-stage`) holds, and where each one shows.\n *\n * **Placement.** Every surface starts where its channel's registry row places it (`SurfacePlacement`: its tab, unless the\n * row says otherwise). The user moves it to the stage (it fills the call), into a picture-in-picture box, to its tab, or\n * out of sight, within the placements the row allows; the moves are kept in order, one per surface, and resolved by\n * `ResolveSurfacePlacements`, so the most recent move to the stage wins it, the surface it displaces returns to where its\n * channel places it, and picture-in-picture boxes stack newest first. The host saves {@link Moves} and loads them back\n * ({@link LoadMoves}), so a layout carries over to later sessions.\n *\n * **Creation.** A channel's surface is created the first time it is seen (its tab shows it, or it is on the stage or\n * in a picture-in-picture box) and kept until the channel leaves the session. Moving it, hiding the panel or switching tabs only changes where it\n * shows, so a whiteboard keeps its view and a stream keeps playing.\n *\n * Pure state with no Angular: the overlay reports the session's channels, the channel tab the panel is showing and\n * the user's moves, and binds {@link Surfaces} to the stage.\n */\nexport class RealtimeSurfaceStageModel {\n  /** Channels with a surface, by key, in the order their tabs registered. */\n  private readonly plugins = new Map<string, BaseRealtimeChannelClient>();\n  /** Keys whose surface has been seen, so it stays created. */\n  private readonly seen = new Set<string>();\n  private moves: MediaPlacementMove[] = [];\n  private activeTabKey: string | null = null;\n  private placements: ReadonlyMap<string, MediaStagePlacement> = new Map();\n  /** Picture-in-picture surfaces, newest first. */\n  private pipOrder: readonly string[] = [];\n  private surfaces: readonly MediaStageSurface[] = [];\n  private allowedPlacements: ReadonlyMap<string, readonly MediaStagePlacement[]> = new Map();\n\n  /** The stage's surfaces. The array is replaced only when a surface or a placement changes, so it binds cheaply. */\n  public get Surfaces(): readonly MediaStageSurface[] {\n    return this.surfaces;\n  }\n\n  /** Where each registered channel's surface is placed, by key. Replaced only when a placement changes. */\n  public get Placements(): ReadonlyMap<string, MediaStagePlacement> {\n    return this.placements;\n  }\n\n  /** Where the user may move each registered channel's surface, by key. Replaced only when the channels change. */\n  public get AllowedPlacements(): ReadonlyMap<string, readonly MediaStagePlacement[]> {\n    return this.allowedPlacements;\n  }\n\n  /** The user's moves, oldest first, one per surface: what the host saves. */\n  public get Moves(): readonly MediaPlacementMove[] {\n    return this.moves;\n  }\n\n  /** The channel whose surface is on the stage, or `null`. */\n  public get StageKey(): string | null {\n    for (const [key, placement] of this.placements) {\n      if (placement === 'stage') {\n        return key;\n      }\n    }\n    return null;\n  }\n\n  /** The plugin behind a surface, or `null` once its channel has left. */\n  public PluginFor(key: string): BaseRealtimeChannelClient | null {\n    return this.plugins.get(key) ?? null;\n  }\n\n  /** Where the user may move a channel's surface; nowhere for a channel without a surface in this session. */\n  public AllowedFor(key: string): readonly MediaStagePlacement[] {\n    return this.allowedPlacements.get(key) ?? [];\n  }\n\n  /**\n   * Where a channel's surface goes when it leaves the stage (the user leaves the focus layout, or the channel lets go of\n   * it): where its channel places it, or the first of picture-in-picture, tab and hidden that it allows.\n   */\n  public OffStagePlacement(key: string): MediaStagePlacement {\n    const plugin = this.plugins.get(key);\n    return plugin ? PlacementOffStage(surfaceOf(plugin)) : 'tab';\n  }\n\n  /** A channel with a surface got its tab. Registering its key again follows the channel's new plugin instance. */\n  public Register(plugin: BaseRealtimeChannelClient): void {\n    this.plugins.set(plugin.ChannelName, plugin);\n    this.updateAllowedPlacements();\n    this.update();\n  }\n\n  /** The session's channels changed: a surface whose plugin is no longer among them is dropped. Moves are kept. */\n  public KeepOnly(channels: readonly BaseRealtimeChannelClient[]): void {\n    for (const [key, plugin] of [...this.plugins]) {\n      if (!channels.includes(plugin)) {\n        this.plugins.delete(key);\n        this.seen.delete(key);\n      }\n    }\n    this.updateAllowedPlacements();\n    this.update();\n  }\n\n  /** The channel whose tab the panel is showing, or `null` when it shows none (another tab, collapsed, hidden). */\n  public SetActiveTab(key: string | null): void {\n    this.activeTabKey = key;\n    this.update();\n  }\n\n  /** Starts from saved moves, such as the user's last layout. */\n  public LoadMoves(moves: readonly MediaPlacementMove[]): void {\n    this.moves = [...moves];\n    this.update();\n  }\n\n  /**\n   * Moves a channel's surface. Returns `false`, changing nothing, for a channel without a surface in this session, a\n   * placement its channel does not allow, or the placement it already has.\n   */\n  public Move(key: string, placement: MediaStagePlacement): boolean {\n    if (!this.AllowedFor(key).includes(placement) || this.placements.get(key) === placement) {\n      return false;\n    }\n    this.moves = RecordPlacementMove(this.moves, { SurfaceKey: key, Placement: placement });\n    this.update();\n    return true;\n  }\n\n  /** Forgets every move: each surface returns to where its channel places it. */\n  public ResetLayout(): void {\n    this.moves = [];\n    this.update();\n  }\n\n  private update(): void {\n    this.resolvePlacements();\n    for (const [key, placement] of this.placements) {\n      if (placement === 'stage' || placement === 'pip' || (placement === 'tab' && key === this.activeTabKey)) {\n        this.seen.add(key);\n      }\n    }\n    const surfaces = [...this.plugins.keys()].filter((key) => this.seen.has(key)).map((key) => this.surfaceFor(key));\n    if (!sameSurfaces(surfaces, this.surfaces)) {\n      this.surfaces = surfaces;\n    }\n  }\n\n  /** Rebuilds {@link AllowedPlacements} from the registered channels, keeping the map when nothing in it changed. */\n  private updateAllowedPlacements(): void {\n    const allowed = new Map([...this.plugins].map(([key, plugin]) => [key, plugin.SurfacePlacement.Allowed]));\n    if (!sameAllowedPlacements(allowed, this.allowedPlacements)) {\n      this.allowedPlacements = allowed;\n    }\n  }\n\n  /** A stage surface for a channel: its placement, its name, and where it stacks when it is picture-in-picture. */\n  private surfaceFor(key: string): MediaStageSurface {\n    const placement = this.placements.get(key) ?? 'tab';\n    const surface: MediaStageSurface = { Key: key, Placement: placement, Label: this.plugins.get(key)?.TabTitle };\n    return placement === 'pip' ? { ...surface, PipIndex: this.pipOrder.indexOf(key) } : surface;\n  }\n\n  private resolvePlacements(): void {\n    const resolved = ResolveSurfacePlacements([...this.plugins.values()].map(surfaceOf), this.moves);\n    const placements = new Map<string, MediaStagePlacement>();\n    if (resolved.Stage) {\n      placements.set(resolved.Stage.Key, 'stage');\n    }\n    resolved.Pips.forEach((surface) => placements.set(surface.Key, 'pip'));\n    resolved.Tabs.forEach((surface) => placements.set(surface.Key, 'tab'));\n    resolved.Hidden.forEach((surface) => placements.set(surface.Key, 'hidden'));\n    if (!samePlacements(placements, this.placements)) {\n      this.placements = placements;\n    }\n    this.pipOrder = resolved.Pips.map((surface) => surface.Key);\n  }\n}\n\n/** A channel's surface as the layout model sees it: where its channel places it unless moved, and where it may go. */\nfunction surfaceOf(plugin: BaseRealtimeChannelClient): MediaSurface {\n  const { Default, Allowed } = plugin.SurfacePlacement;\n  return { Key: plugin.ChannelName, Label: plugin.TabTitle, DefaultPlacement: Default, AllowedPlacements: Allowed };\n}\n\nfunction sameAllowedPlacements(\n  a: ReadonlyMap<string, readonly MediaStagePlacement[]>,\n  b: ReadonlyMap<string, readonly MediaStagePlacement[]>\n): boolean {\n  return a.size === b.size && [...a].every(([key, allowed]) => b.get(key) === allowed);\n}\n\nfunction samePlacements(a: ReadonlyMap<string, MediaStagePlacement>, b: ReadonlyMap<string, MediaStagePlacement>): boolean {\n  return a.size === b.size && [...a].every(([key, placement]) => b.get(key) === placement);\n}\n\nfunction sameSurfaces(a: readonly MediaStageSurface[], b: readonly MediaStageSurface[]): boolean {\n  return (\n    a.length === b.length &&\n    a.every(\n      (surface, i) =>\n        surface.Key === b[i].Key && surface.Placement === b[i].Placement && surface.Label === b[i].Label && surface.PipIndex === b[i].PipIndex\n    )\n  );\n}\n"]}

package/dist/lib/components/realtime/realtime-surface-tabs.component.d.ts

@@ -1,18 +1,25 @@
-import { EventEmitter, OnInit, OnDestroy } from '@angular/core';
+import { AfterViewChecked, EventEmitter, OnInit, OnDestroy } from '@angular/core';
+import { type MediaMoveRequest, type MediaStagePlacement } from '@memberjunction/ng-realtime-media';
 import { UserInfo } from '@memberjunction/core';
 import { RealtimeSessionState } from './realtime-session-state';
 import { ChannelOnboardingDetails } from '@memberjunction/realtime-runtime';
 import { RealtimeSurfaceTabsModel, RealtimeSurfaceTab, RealtimeChannelTabRegistration } from './realtime-surface-tabs.model';
 import { ParsedDelegationArtifact } from '@memberjunction/realtime-runtime';
 import * as i0 from "@angular/core";
+/** Where the active channel tab's surface shows: the tab's key and the element its pane keeps for the surface. */
+export interface RealtimeChannelSlot {
+    Key: string;
+    Element: HTMLElement;
+}
 /**
  * The call overlay's TABBED SURFACE PANEL (the right panel) — decluttered redesign:
  *
  *  - **Channel tabs** (LEFT cluster) — one per channel that has come into play. The whiteboard
  *    tabs immediately at session start; every other channel tabs only once the agent first
- *    USES it. Each carries a distinct accent color + its plugin icon. The pane creates the
- *    plugin's surface component dynamically (via `mj-realtime-channel-pane`); a placeholder
- *    shows the "coming online…" state until a plugin/template is supplied.
+ *    USES it. Each carries a distinct accent color + its plugin icon. A plugin's surface lives
+ *    on the overlay's stage, which lays it over the pane's slot while the tab is active
+ *    ({@link ChannelSlotChange}); a placeholder shows the "coming online…" state until a
+ *    plugin/template is supplied.
  *  - **Activity** (RIGHT-aligned, pinned LAST) — gated: appears only once ≥1 agent run has
  *    occurred (or in review mode). Hosts {@link RealtimeActivityRailComponent}, which now also
  *    renders inline artifact previews and a split-pane artifact viewer. Styled distinctly from
@@ -22,15 +29,16 @@ import * as i0 from "@angular/core";
  * Artifacts NO LONGER get their own tab — they live inside the Activity tab (cleaner than a
  * row of per-artifact tabs).
  *
- * Panes are kept ALIVE while hidden (CSS `display:none`) so switching tabs never reloads a
- * channel surface or resets the rail. The whole panel collapses to a slim strip via the chevron.
+ * Panes are kept ALIVE while hidden (CSS `display:none`) so switching tabs never resets the rail;
+ * channel surfaces are on the overlay's stage, so switching tabs or collapsing the panel never
+ * reloads them either. The whole panel collapses to a slim strip via the chevron.
  *
  * SIZING IS EXTERNAL: the overlay shell hosts this panel in a fixed-width flex item and owns
  * the width. This panel just fills it and REPORTS the layout signals the shell sizes from:
  * {@link CollapsedChange} (slim-strip toggle) and {@link WideChanged} (a channel tab is focused
  * → the default width tier widens).
  */
-export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
+export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy, AfterViewChecked {
     /** How long a just-revealed channel tab keeps its flash highlight. */
     private static readonly flashDurationMs;
     /** Shared live-session state, owned by the overlay shell (feeds the Activity rail). */
@@ -38,9 +46,9 @@ export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
     /** Whether developer affordances ("Open run" links) are revealed (gear-gated). */
     DevMode: boolean;
     /**
-     * FILL presentation: the panel stretches to the overlay's full width (the board-focus
-     * layout, where the main call column is hidden and a channel surface owns the screen).
-     * Bound by the overlay shell; overrides the normal / wide width tiers.
+     * FILL presentation: the panel stretches to its host's full width with no left border,
+     * overriding the normal / wide width tiers. The overlay no longer binds it: in focus mode
+     * the focused channel's surface fills the overlay's stage instead.
      */
     Fill: boolean;
     /** The signed-in user, threaded to the artifact viewer panel. */
@@ -73,12 +81,45 @@ export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
      * the user has never dragged an explicit width).
      */
     WideChanged: EventEmitter<boolean>;
+    /**
+     * The channel whose tab the user is looking at changed (`null` when a non-channel tab, such as Activity, is active).
+     * Lets the session show the model the surface the user is on when it can only watch one.
+     */
+    ActiveChannelChange: EventEmitter<string | null>;
+    /**
+     * The active channel tab's slot changed: the element its pane keeps for the channel's surface, or `null` while no
+     * channel tab is showing (another tab is active, or the panel is collapsed). The overlay's stage lays the surface
+     * over this element.
+     */
+    ChannelSlotChange: EventEmitter<RealtimeChannelSlot | null>;
+    /**
+     * Where each channel's surface is placed, by channel key (a channel not listed is on its tab). A channel whose
+     * surface is elsewhere shows where in its pane, with "Bring it here" when its channel allows the tab.
+     */
+    SurfacePlacements: ReadonlyMap<string, MediaStagePlacement>;
+    /** Where each channel lets the user move its surface, by channel key (a channel not listed allows anywhere). */
+    AllowedPlacements: ReadonlyMap<string, readonly MediaStagePlacement[]>;
+    /** The user asked to move a channel's surface (from "Move to…" or "Bring it here"). */
+    MoveRequested: EventEmitter<MediaMoveRequest>;
+    /** The user asked to put every surface back where its channel places it. */
+    ResetLayoutRequested: EventEmitter<void>;
     /** The panel's tab state (add / focus / dedupe / flash) — see the model for the rules. */
     readonly Model: RealtimeSurfaceTabsModel;
-    /** Whether the panel is collapsed to its slim strip. */
-    Collapsed: boolean;
+    /**
+     * Whether the panel is collapsed to its slim strip. The chevron toggles it, a reveal expands it, and the panel reports
+     * each such change through {@link CollapsedChange}. A host may bind it, so that a panel it creates again starts as the
+     * user left the one before (the call overlay does when only the call's width hid the panel, #5433). A value the host
+     * sets is not reported back.
+     */
+    set Collapsed(value: boolean);
+    get Collapsed(): boolean;
+    private collapsed;
     /** The embedded Activity rail (owns the inline artifact previews + the split-pane viewer). */
     private activityRail?;
+    /** The slots of the plugin channel panes, one per tab. */
+    private channelSlots?;
+    /** The slot last reported through {@link ChannelSlotChange}. */
+    private reportedSlot;
     private flashTimer;
     private subs;
     private lastWide;
@@ -96,7 +137,20 @@ export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
     /** Wide presentation when a channel tab is focused (the Activity tab keeps the normal tier). */
     get IsWide(): boolean;
     ngOnInit(): void;
+    ngAfterViewChecked(): void;
     ngOnDestroy(): void;
+    /** Reports the active channel tab's slot when it differs from the one last reported. */
+    private reportChannelSlot;
+    /** The active tab's slot: present while that tab is a plugin channel and the panel is expanded. */
+    private activeChannelSlot;
+    /** Where a channel's surface is placed. */
+    PlacementOf(key: string): MediaStagePlacement;
+    /** Where a channel lets the user move its surface. */
+    AllowedOf(key: string): readonly MediaStagePlacement[];
+    /** Where a moved channel's surface is, as its tab says it: "on the stage", "in picture-in-picture", "hidden". */
+    AwayText(key: string): string;
+    /** The icon for where a moved channel's surface is. */
+    AwayIcon(key: string): string;
     /** Toggle the panel between expanded and slim-collapsed. */
     ToggleCollapsed(): void;
     /** Collapse-state transitions funnel through here so the shell always hears about them. */
@@ -140,6 +194,10 @@ export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
     RegisterArtifactTab(artifact: ParsedDelegationArtifact, focus?: boolean): void;
     /** On model changes: schedule the flash clear, report a wide-tier flip, re-render. */
     private onModelChanged;
+    /** The channel key last reported through {@link ActiveChannelChange}. */
+    private lastReportedChannel;
+    /** Reports the focused channel when it differs from the last one reported. */
+    private emitActiveChannelIfChanged;
     /**
      * Decides whether the first-run channel intro should be visible for the ACTIVE tab: shows it
      * the first time the user opens (focuses) a channel tab whose plugin supplies onboarding and
@@ -166,6 +224,6 @@ export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
     /** Clears the model's flash highlight after a beat (one timer; latest flash wins). */
     private scheduleFlashClear;
     static ɵfac: i0.ɵɵFactoryDeclaration<RealtimeSurfaceTabsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RealtimeSurfaceTabsComponent, "mj-realtime-surface-tabs", never, { "State": { "alias": "State"; "required": true; }; "DevMode": { "alias": "DevMode"; "required": false; }; "Fill": { "alias": "Fill"; "required": false; }; "CurrentUser": { "alias": "CurrentUser"; "required": false; }; "EnvironmentID": { "alias": "EnvironmentID"; "required": false; }; "ExtraArtifacts": { "alias": "ExtraArtifacts"; "required": false; }; "ShowActivityTab": { "alias": "ShowActivityTab"; "required": false; }; }, { "OpenRunRequested": "OpenRunRequested"; "CollapsedChange": "CollapsedChange"; "WideChanged": "WideChanged"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RealtimeSurfaceTabsComponent, "mj-realtime-surface-tabs", never, { "State": { "alias": "State"; "required": true; }; "DevMode": { "alias": "DevMode"; "required": false; }; "Fill": { "alias": "Fill"; "required": false; }; "CurrentUser": { "alias": "CurrentUser"; "required": false; }; "EnvironmentID": { "alias": "EnvironmentID"; "required": false; }; "ExtraArtifacts": { "alias": "ExtraArtifacts"; "required": false; }; "ShowActivityTab": { "alias": "ShowActivityTab"; "required": false; }; "SurfacePlacements": { "alias": "SurfacePlacements"; "required": false; }; "AllowedPlacements": { "alias": "AllowedPlacements"; "required": false; }; "Collapsed": { "alias": "Collapsed"; "required": false; }; }, { "OpenRunRequested": "OpenRunRequested"; "CollapsedChange": "CollapsedChange"; "WideChanged": "WideChanged"; "ActiveChannelChange": "ActiveChannelChange"; "ChannelSlotChange": "ChannelSlotChange"; "MoveRequested": "MoveRequested"; "ResetLayoutRequested": "ResetLayoutRequested"; }, never, never, true, never>;
 }
 //# sourceMappingURL=realtime-surface-tabs.component.d.ts.map

package/dist/lib/components/realtime/realtime-surface-tabs.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-surface-tabs.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-tabs.component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"realtime-surface-tabs.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-tabs.component.ts"],"names":[],"mappings":"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"}