@memberjunction/ng-conversations 5.43.0 → 5.45.0

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

@@ -1,102 +1,92 @@
 import { Subject } from 'rxjs';
+import { ChannelTabColor } from './realtime-surface-tab-style';
 /**
  * Framework-free state for the call overlay's tabbed surface panel: the ordered tab list
- * (CHANNEL tabs first — the marquee surfaces — then artifact tabs in arrival order, with
- * Activity pinned LAST), the active tab, the transient "flash" highlight for a
- * just-arrived tab, and the persistent UNSEEN glow for content that arrived without
- * stealing focus (an artifact tab glows until the user visits it).
+ * (CHANNEL tabs first — the marquee surfaces, left cluster — with the session-activity tab
+ * pinned LAST and right-aligned by the strip), the active tab, and the transient "flash"
+ * highlight for a just-revealed channel tab.
+ *
+ * The Activity tab is GATED: it isn't listed until {@link SetShowActivityTab}(true) — i.e.
+ * once ≥1 agent run has occurred (or in review mode). Channel tabs appear only as channels
+ * come into play (the whiteboard up-front; every other channel on first use), so an
+ * idle voice-first session shows an empty/near-empty strip rather than a row of unused tabs.
  *
  * Owned by `RealtimeSurfaceTabsComponent`; kept free of Angular runtime imports so the
- * add / focus / dedupe / flash / unseen logic is unit-testable in isolation. All
- * collections are REPLACED (never mutated) on change, and every change emits {@link Changed$}.
+ * add / focus / dedupe / flash logic is unit-testable in isolation. All collections are
+ * REPLACED (never mutated) on change, and every change emits {@link Changed$}.
  */
 export class RealtimeSurfaceTabsModel {
-    /** The fixed key of the always-present Activity tab (pinned as the LAST tab). */
+    /** The fixed key of the session-activity tab (pinned LAST, right-aligned). */
     static ActivityTabKey = 'activity';
-    /** The ordered tabs (channels… · artifacts… · Activity last). Replaced immutably on every change. */
-    Tabs = [
-        { Key: RealtimeSurfaceTabsModel.ActivityTabKey, Title: 'Activity', Icon: 'fa-solid fa-list-check', Kind: 'activity' }
-    ];
+    /** The activity tab definition, appended last whenever {@link showActivity} is true. */
+    static ActivityTab = {
+        Key: RealtimeSurfaceTabsModel.ActivityTabKey,
+        Title: 'Activity',
+        Icon: 'fa-solid fa-wave-square',
+        Kind: 'activity'
+    };
+    /** Channel tabs (left cluster), in registration order. Replaced immutably on change. */
+    channelTabs = [];
+    /** Whether the gated Activity tab is currently shown (≥1 agent run, or review mode). */
+    showActivity = false;
     /** Key of the currently focused tab. */
     ActiveKey = RealtimeSurfaceTabsModel.ActivityTabKey;
     /**
-     * Key of the tab currently "flashing" (the brief violet highlight a just-arrived
-     * artifact tab gets, per the mockup). Cleared by the owning component after a beat
-     * via {@link ClearFlash}.
+     * Key of the tab currently "flashing" (the brief highlight a just-revealed channel tab
+     * gets when the agent first acts on it). Cleared by the owning component after a beat via
+     * {@link ClearFlash}.
      */
     FlashKey = null;
-    /**
-     * Tabs holding content the user hasn't visited yet (the persistent glow): an artifact
-     * tab that arrived WITHOUT stealing focus stays marked until it is focused. Replaced
-     * immutably on change.
-     */
-    unseenKeys = new Set();
     /** Emits after every model change so the owning component can mark for check. */
     Changed$ = new Subject();
-    /** The currently focused tab (always resolvable — Activity is never removed). */
-    get ActiveTab() {
-        return this.Tabs.find(t => t.Key === this.ActiveKey)
-            ?? this.Tabs.find(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey)
-            ?? this.Tabs[0];
+    /**
+     * The ordered tabs: channel tabs (left), then the Activity tab LAST when shown. The strip
+     * right-aligns the Activity tab via a flex spacer, so this order also matches reading order.
+     */
+    get Tabs() {
+        return this.showActivity
+            ? [...this.channelTabs, RealtimeSurfaceTabsModel.ActivityTab]
+            : [...this.channelTabs];
     }
-    /** True while the tab with `key` holds content the user hasn't visited (glow state). */
-    IsUnseen(key) {
-        return this.unseenKeys.has(key);
+    /** Whether the Activity tab is currently part of the strip. */
+    get IsActivityShown() {
+        return this.showActivity;
     }
-    /** The stable tab key for an artifact (one tab per produced artifact VERSION). */
-    static ArtifactTabKey(artifact) {
-        return `artifact:${artifact.ArtifactVersionID}`;
+    /**
+     * The currently focused tab. Resolves to the active key when it still exists, else falls
+     * back to the Activity tab (when shown), else the first channel tab, else the Activity tab
+     * definition (so a consumer always has SOMETHING to render even on an empty strip).
+     */
+    get ActiveTab() {
+        const tabs = this.Tabs;
+        return tabs.find(t => t.Key === this.ActiveKey)
+            ?? tabs.find(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey)
+            ?? tabs[0]
+            ?? RealtimeSurfaceTabsModel.ActivityTab;
     }
     /**
-     * Opens (or re-focuses) the tab for an artifact a delegated run produced.
+     * Shows or hides the gated Activity tab. Turning it ON when an empty strip was implicitly
+     * focusing Activity keeps focus on Activity; turning it OFF while it was focused falls
+     * focus back to the first channel tab (if any). No-op (no emission) when unchanged.
      *
-     * First arrival: inserts an `artifact` tab AFTER existing channel/artifact tabs but
-     * BEFORE the pinned-last Activity tab, marks it as the {@link FlashKey}, and — unless
-     * `focus` is true — leaves focus alone and marks the tab UNSEEN (it glows until
-     * visited; per product direction a finished artifact never steals the screen, only the
-     * agent's first channel activity does). Subsequent calls for the same artifact version
-     * just (optionally) focus the existing tab — no duplicate, no re-flash.
-     *
-     * @param artifact The produced artifact (id + version id + display name).
-     * @param focus Whether to focus the tab (default `false` — glow, don't grab).
-     * @param markUnseen Whether an unfocused first arrival glows (default `true`). Pass
-     *   `false` for HISTORY artifacts (session-review carryover) — they're context, not news.
-     * @returns The (new or existing) tab.
+     * @param show Whether ≥1 agent run has occurred (or review mode) — the gate.
      */
-    OpenArtifactTab(artifact, focus = false, markUnseen = true) {
-        const key = RealtimeSurfaceTabsModel.ArtifactTabKey(artifact);
-        const existing = this.Tabs.find(t => t.Key === key);
-        if (existing) {
-            if (focus) {
-                this.Focus(key);
-            }
-            return existing;
-        }
-        const tab = {
-            Key: key,
-            Title: artifact.Name,
-            Icon: 'fa-solid fa-file-lines',
-            Kind: 'artifact',
-            Data: { Artifact: artifact }
-        };
-        // Insert before the pinned-last Activity tab: channels… | artifacts… | Activity.
-        const at = this.activityIndex();
-        this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];
-        this.FlashKey = key;
-        if (focus) {
-            this.ActiveKey = key;
+    SetShowActivityTab(show) {
+        if (this.showActivity === show) {
+            return;
         }
-        else if (markUnseen) {
-            this.unseenKeys = new Set([...this.unseenKeys, key]);
+        this.showActivity = show;
+        if (!show && this.ActiveKey === RealtimeSurfaceTabsModel.ActivityTabKey) {
+            this.ActiveKey = this.channelTabs[0]?.Key ?? RealtimeSurfaceTabsModel.ActivityTabKey;
         }
         this.Changed$.next();
-        return tab;
     }
     /**
      * Registers (or updates) an interactive-channel tab. Re-registering an existing key
-     * replaces its title/icon/plugin/content in place (this is how a placeholder upgrades
-     * to the real surface once the channel comes online). New channel tabs lead the strip
-     * (before artifact tabs and the pinned-last Activity tab) — the marquee surfaces.
+     * replaces its title/icon/color/plugin/content in place (this is how a placeholder
+     * upgrades to the real surface once the channel comes online). New channel tabs join the
+     * left cluster in registration order. A registration without an explicit {@link
+     * RealtimeChannelTabRegistration.Color} gets a deterministic color from its key.
      *
      * @param registration The channel tab registration.
      * @returns The (new or updated) tab.
@@ -107,57 +97,37 @@ export class RealtimeSurfaceTabsModel {
             Title: registration.Title,
             Icon: registration.Icon,
             Kind: 'channel',
+            Color: registration.Color ?? ChannelTabColor(registration.Key),
             Data: { Plugin: registration.Plugin, Content: registration.Content }
         };
-        const idx = this.Tabs.findIndex(t => t.Key === registration.Key);
+        const idx = this.channelTabs.findIndex(t => t.Key === registration.Key);
         if (idx >= 0) {
-            const next = [...this.Tabs];
+            const next = [...this.channelTabs];
             next[idx] = tab;
-            this.Tabs = next;
+            this.channelTabs = next;
         }
         else {
-            // Insert after existing channel tabs, before artifacts and the pinned-last Activity.
-            const firstNonChannel = this.Tabs.findIndex(t => t.Kind !== 'channel');
-            const at = firstNonChannel >= 0 ? firstNonChannel : this.Tabs.length;
-            this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];
+            this.channelTabs = [...this.channelTabs, tab];
         }
         if (registration.Focus) {
             this.ActiveKey = tab.Key;
-            this.markSeen(tab.Key);
         }
         this.Changed$.next();
         return tab;
     }
-    /** Focuses the tab with `key` (no-op when it doesn't exist); visiting clears its unseen glow. */
+    /** Focuses the tab with `key` (no-op when it doesn't exist or is already active). */
     Focus(key) {
-        if (!this.Tabs.some(t => t.Key === key)) {
+        if (!this.Tabs.some(t => t.Key === key) || this.ActiveKey === key) {
             return;
         }
-        const changed = this.ActiveKey !== key || this.unseenKeys.has(key);
         this.ActiveKey = key;
-        this.markSeen(key);
-        if (changed) {
-            this.Changed$.next();
-        }
-    }
-    /** The index of the pinned-last Activity tab (insertion boundary for content tabs). */
-    activityIndex() {
-        const idx = this.Tabs.findIndex(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey);
-        return idx >= 0 ? idx : this.Tabs.length;
-    }
-    /** Clears a tab's unseen glow (no emission of its own — callers emit). */
-    markSeen(key) {
-        if (this.unseenKeys.has(key)) {
-            const next = new Set(this.unseenKeys);
-            next.delete(key);
-            this.unseenKeys = next;
-        }
+        this.Changed$.next();
     }
     /**
-     * Marks the tab with `key` as the {@link FlashKey} (the brief violet "just arrived"
-     * highlight) WITHOUT changing focus — used by the auto-reveal path when the agent first
-     * acts on a channel, so the user's eye lands on the tab that just came alive. No-op for
-     * unknown keys; the owning component clears it after a beat via {@link ClearFlash}.
+     * Marks the tab with `key` as the {@link FlashKey} (the brief "just arrived" highlight)
+     * WITHOUT changing focus — used by the auto-reveal path when the agent first acts on a
+     * channel, so the user's eye lands on the tab that just came alive. No-op for unknown
+     * keys; the owning component clears it after a beat via {@link ClearFlash}.
      */
     FlashTab(key) {
         if (this.FlashKey === key || !this.Tabs.some(t => t.Key === key)) {
@@ -167,27 +137,29 @@ export class RealtimeSurfaceTabsModel {
         this.Changed$.next();
     }
     /**
-     * Removes the tab with `key`. Rules:
-     *  - the Activity tab is IRREMOVABLE (always the panel's first tab) — removing it is a no-op;
+     * Removes the channel tab with `key`. Rules:
+     *  - the Activity tab is IRREMOVABLE — removing it is a no-op;
      *  - an unknown key is a no-op (returns `false`);
-     *  - when the removed tab was focused, focus falls back to the Activity tab;
+     *  - when the removed tab was focused, focus falls back to the Activity tab (if shown),
+     *    else the first remaining channel tab;
      *  - a pending flash on the removed tab is cleaned up so the highlight can't dangle.
      *
      * @param key The tab key to remove.
      * @returns `true` when a tab was removed.
      */
     RemoveTab(key) {
-        if (key === RealtimeSurfaceTabsModel.ActivityTabKey || !this.Tabs.some(t => t.Key === key)) {
+        if (key === RealtimeSurfaceTabsModel.ActivityTabKey || !this.channelTabs.some(t => t.Key === key)) {
             return false;
         }
-        this.Tabs = this.Tabs.filter(t => t.Key !== key);
+        this.channelTabs = this.channelTabs.filter(t => t.Key !== key);
         if (this.ActiveKey === key) {
-            this.ActiveKey = RealtimeSurfaceTabsModel.ActivityTabKey;
+            this.ActiveKey = this.showActivity
+                ? RealtimeSurfaceTabsModel.ActivityTabKey
+                : (this.channelTabs[0]?.Key ?? RealtimeSurfaceTabsModel.ActivityTabKey);
         }
         if (this.FlashKey === key) {
             this.FlashKey = null;
         }
-        this.markSeen(key); // a removed tab can't dangle an unseen glow
         this.Changed$.next();
         return true;
     }
@@ -210,8 +182,6 @@ export class RealtimeSurfaceTabsModel {
  *  - the live session's resolved channel set has NO Whiteboard channel — when it HAS one, the
  *    live plugin re-registers the same tab key and upgrades the pane in place instead.
  *
- * Review ARTIFACT tabs are deliberately NOT removed — they are wanted carryover.
- *
  * Kept framework-free (like the model) so the rule is unit-testable in isolation.
  */
 export function ShouldRemoveReviewWhiteboardTab(liveSessionActive, reviewWhiteboardTabRegistered, liveChannels) {

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

@@ -1 +1 @@
-{"version":3,"file":"realtime-surface-tabs.model.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-tabs.model.ts"],"names":[],"mappings":"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","sourcesContent":["import { Subject } from 'rxjs';\nimport type { TemplateRef } from '@angular/core';\nimport type { BaseRealtimeChannelClient } from './channels/base-realtime-channel-client';\nimport { ParsedDelegationArtifact } from '../../services/delegation-result-parser';\n\n/**\n * The kind of a surface-panel tab:\n *  - `activity` — the always-present first tab hosting the session activity rail.\n *  - `artifact` — one tab per artifact produced by a delegated run (auto-opened on arrival).\n *  - `channel`  — an interactive-channel surface (e.g. the Whiteboard). Registered per\n *    registry-resolved plugin via {@link RealtimeSurfaceTabsModel.RegisterChannelTab};\n *    renders the plugin's dynamically-created surface component (or a registered template\n *    for legacy/template-based panes), with the \"coming online…\" placeholder until either\n *    is supplied.\n */\nexport type RealtimeSurfaceTabKind = 'activity' | 'artifact' | 'channel';\n\n/**\n * Per-kind payload carried on a {@link RealtimeSurfaceTab}.\n */\nexport interface RealtimeSurfaceTabData {\n  /** For `artifact` tabs: the artifact this tab views (loaded by ArtifactID, latest version). */\n  Artifact?: ParsedDelegationArtifact;\n  /**\n   * For `channel` tabs: the channel PLUGIN whose surface component the pane creates\n   * dynamically (and binds back to the plugin) — the registry-driven path every real\n   * channel uses. Takes precedence over {@link Content}.\n   */\n  Plugin?: BaseRealtimeChannelClient;\n  /**\n   * For `channel` tabs: a TEMPLATE-based pane body. Backward-compatible alternative to\n   * {@link Plugin} for hosts that render a bespoke surface without a channel plugin.\n   * When BOTH are absent the pane renders the built-in \"coming online…\" placeholder.\n   */\n  Content?: TemplateRef<unknown>;\n}\n\n/**\n * One tab on the call overlay's tabbed surface panel (the right panel): Activity, an\n * artifact viewer, or an interactive-channel surface.\n */\nexport interface RealtimeSurfaceTab {\n  /** Stable unique key (`activity`, `artifact:<versionId>`, or the channel's registered key). */\n  Key: string;\n  /** Tab strip label (artifact tabs use the artifact's name). */\n  Title: string;\n  /** Font Awesome icon class for the tab strip (e.g. `fa-solid fa-file-lines`). */\n  Icon: string;\n  /** What the tab renders. */\n  Kind: RealtimeSurfaceTabKind;\n  /** Kind-specific payload. */\n  Data?: RealtimeSurfaceTabData;\n}\n\n/**\n * Registration for an interactive-channel tab. The overlay shell registers one per\n * registry-resolved channel plugin (supplying {@link Plugin}); supplying {@link Plugin}\n * or {@link Content} later under the same `Key` upgrades a placeholder tab to the real\n * surface.\n */\nexport interface RealtimeChannelTabRegistration {\n  /** Stable channel key (the plugin's `ChannelName`, e.g. `Whiteboard`). Re-registering the same key updates the tab. */\n  Key: string;\n  /** Tab strip label (e.g. `Whiteboard`). */\n  Title: string;\n  /** Font Awesome icon class (e.g. `fa-solid fa-chalkboard`). */\n  Icon: string;\n  /** The channel plugin whose surface the pane creates + binds. Preferred over {@link Content}. */\n  Plugin?: BaseRealtimeChannelClient;\n  /** A template-based pane body (legacy/bespoke panes). Omit both to show the \"coming online…\" placeholder. */\n  Content?: TemplateRef<unknown>;\n  /** Focus the tab immediately after registration (default `false`). */\n  Focus?: boolean;\n}\n\n/**\n * Framework-free state for the call overlay's tabbed surface panel: the ordered tab list\n * (CHANNEL tabs first — the marquee surfaces — then artifact tabs in arrival order, with\n * Activity pinned LAST), the active tab, the transient \"flash\" highlight for a\n * just-arrived tab, and the persistent UNSEEN glow for content that arrived without\n * stealing focus (an artifact tab glows until the user visits it).\n *\n * Owned by `RealtimeSurfaceTabsComponent`; kept free of Angular runtime imports so the\n * add / focus / dedupe / flash / unseen logic is unit-testable in isolation. All\n * collections are REPLACED (never mutated) on change, and every change emits {@link Changed$}.\n */\nexport class RealtimeSurfaceTabsModel {\n  /** The fixed key of the always-present Activity tab (pinned as the LAST tab). */\n  public static readonly ActivityTabKey = 'activity';\n\n  /** The ordered tabs (channels… · artifacts… · Activity last). Replaced immutably on every change. */\n  public Tabs: RealtimeSurfaceTab[] = [\n    { Key: RealtimeSurfaceTabsModel.ActivityTabKey, Title: 'Activity', Icon: 'fa-solid fa-list-check', Kind: 'activity' }\n  ];\n\n  /** Key of the currently focused tab. */\n  public ActiveKey: string = RealtimeSurfaceTabsModel.ActivityTabKey;\n\n  /**\n   * Key of the tab currently \"flashing\" (the brief violet highlight a just-arrived\n   * artifact tab gets, per the mockup). Cleared by the owning component after a beat\n   * via {@link ClearFlash}.\n   */\n  public FlashKey: string | null = null;\n\n  /**\n   * Tabs holding content the user hasn't visited yet (the persistent glow): an artifact\n   * tab that arrived WITHOUT stealing focus stays marked until it is focused. Replaced\n   * immutably on change.\n   */\n  private unseenKeys: ReadonlySet<string> = new Set<string>();\n\n  /** Emits after every model change so the owning component can mark for check. */\n  public readonly Changed$ = new Subject<void>();\n\n  /** The currently focused tab (always resolvable — Activity is never removed). */\n  public get ActiveTab(): RealtimeSurfaceTab {\n    return this.Tabs.find(t => t.Key === this.ActiveKey)\n      ?? this.Tabs.find(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey)\n      ?? this.Tabs[0];\n  }\n\n  /** True while the tab with `key` holds content the user hasn't visited (glow state). */\n  public IsUnseen(key: string): boolean {\n    return this.unseenKeys.has(key);\n  }\n\n  /** The stable tab key for an artifact (one tab per produced artifact VERSION). */\n  public static ArtifactTabKey(artifact: ParsedDelegationArtifact): string {\n    return `artifact:${artifact.ArtifactVersionID}`;\n  }\n\n  /**\n   * Opens (or re-focuses) the tab for an artifact a delegated run produced.\n   *\n   * First arrival: inserts an `artifact` tab AFTER existing channel/artifact tabs but\n   * BEFORE the pinned-last Activity tab, marks it as the {@link FlashKey}, and — unless\n   * `focus` is true — leaves focus alone and marks the tab UNSEEN (it glows until\n   * visited; per product direction a finished artifact never steals the screen, only the\n   * agent's first channel activity does). Subsequent calls for the same artifact version\n   * just (optionally) focus the existing tab — no duplicate, no re-flash.\n   *\n   * @param artifact The produced artifact (id + version id + display name).\n   * @param focus Whether to focus the tab (default `false` — glow, don't grab).\n   * @param markUnseen Whether an unfocused first arrival glows (default `true`). Pass\n   *   `false` for HISTORY artifacts (session-review carryover) — they're context, not news.\n   * @returns The (new or existing) tab.\n   */\n  public OpenArtifactTab(artifact: ParsedDelegationArtifact, focus: boolean = false, markUnseen: boolean = true): RealtimeSurfaceTab {\n    const key = RealtimeSurfaceTabsModel.ArtifactTabKey(artifact);\n    const existing = this.Tabs.find(t => t.Key === key);\n    if (existing) {\n      if (focus) {\n        this.Focus(key);\n      }\n      return existing;\n    }\n    const tab: RealtimeSurfaceTab = {\n      Key: key,\n      Title: artifact.Name,\n      Icon: 'fa-solid fa-file-lines',\n      Kind: 'artifact',\n      Data: { Artifact: artifact }\n    };\n    // Insert before the pinned-last Activity tab: channels… | artifacts… | Activity.\n    const at = this.activityIndex();\n    this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];\n    this.FlashKey = key;\n    if (focus) {\n      this.ActiveKey = key;\n    } else if (markUnseen) {\n      this.unseenKeys = new Set([...this.unseenKeys, key]);\n    }\n    this.Changed$.next();\n    return tab;\n  }\n\n  /**\n   * Registers (or updates) an interactive-channel tab. Re-registering an existing key\n   * replaces its title/icon/plugin/content in place (this is how a placeholder upgrades\n   * to the real surface once the channel comes online). New channel tabs lead the strip\n   * (before artifact tabs and the pinned-last Activity tab) — the marquee surfaces.\n   *\n   * @param registration The channel tab registration.\n   * @returns The (new or updated) tab.\n   */\n  public RegisterChannelTab(registration: RealtimeChannelTabRegistration): RealtimeSurfaceTab {\n    const tab: RealtimeSurfaceTab = {\n      Key: registration.Key,\n      Title: registration.Title,\n      Icon: registration.Icon,\n      Kind: 'channel',\n      Data: { Plugin: registration.Plugin, Content: registration.Content }\n    };\n    const idx = this.Tabs.findIndex(t => t.Key === registration.Key);\n    if (idx >= 0) {\n      const next = [...this.Tabs];\n      next[idx] = tab;\n      this.Tabs = next;\n    } else {\n      // Insert after existing channel tabs, before artifacts and the pinned-last Activity.\n      const firstNonChannel = this.Tabs.findIndex(t => t.Kind !== 'channel');\n      const at = firstNonChannel >= 0 ? firstNonChannel : this.Tabs.length;\n      this.Tabs = [...this.Tabs.slice(0, at), tab, ...this.Tabs.slice(at)];\n    }\n    if (registration.Focus) {\n      this.ActiveKey = tab.Key;\n      this.markSeen(tab.Key);\n    }\n    this.Changed$.next();\n    return tab;\n  }\n\n  /** Focuses the tab with `key` (no-op when it doesn't exist); visiting clears its unseen glow. */\n  public Focus(key: string): void {\n    if (!this.Tabs.some(t => t.Key === key)) {\n      return;\n    }\n    const changed = this.ActiveKey !== key || this.unseenKeys.has(key);\n    this.ActiveKey = key;\n    this.markSeen(key);\n    if (changed) {\n      this.Changed$.next();\n    }\n  }\n\n  /** The index of the pinned-last Activity tab (insertion boundary for content tabs). */\n  private activityIndex(): number {\n    const idx = this.Tabs.findIndex(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey);\n    return idx >= 0 ? idx : this.Tabs.length;\n  }\n\n  /** Clears a tab's unseen glow (no emission of its own — callers emit). */\n  private markSeen(key: string): void {\n    if (this.unseenKeys.has(key)) {\n      const next = new Set(this.unseenKeys);\n      next.delete(key);\n      this.unseenKeys = next;\n    }\n  }\n\n  /**\n   * Marks the tab with `key` as the {@link FlashKey} (the brief violet \"just arrived\"\n   * highlight) WITHOUT changing focus — used by the auto-reveal path when the agent first\n   * acts on a channel, so the user's eye lands on the tab that just came alive. No-op for\n   * unknown keys; the owning component clears it after a beat via {@link ClearFlash}.\n   */\n  public FlashTab(key: string): void {\n    if (this.FlashKey === key || !this.Tabs.some(t => t.Key === key)) {\n      return;\n    }\n    this.FlashKey = key;\n    this.Changed$.next();\n  }\n\n  /**\n   * Removes the tab with `key`. Rules:\n   *  - the Activity tab is IRREMOVABLE (always the panel's first tab) — removing it is a no-op;\n   *  - an unknown key is a no-op (returns `false`);\n   *  - when the removed tab was focused, focus falls back to the Activity tab;\n   *  - a pending flash on the removed tab is cleaned up so the highlight can't dangle.\n   *\n   * @param key The tab key to remove.\n   * @returns `true` when a tab was removed.\n   */\n  public RemoveTab(key: string): boolean {\n    if (key === RealtimeSurfaceTabsModel.ActivityTabKey || !this.Tabs.some(t => t.Key === key)) {\n      return false;\n    }\n    this.Tabs = this.Tabs.filter(t => t.Key !== key);\n    if (this.ActiveKey === key) {\n      this.ActiveKey = RealtimeSurfaceTabsModel.ActivityTabKey;\n    }\n    if (this.FlashKey === key) {\n      this.FlashKey = null;\n    }\n    this.markSeen(key); // a removed tab can't dangle an unseen glow\n    this.Changed$.next();\n    return true;\n  }\n\n  /** Clears the transient flash highlight (called by the component after a beat). */\n  public ClearFlash(): void {\n    if (this.FlashKey !== null) {\n      this.FlashKey = null;\n      this.Changed$.next();\n    }\n  }\n}\n\n/**\n * Pure decision helper for the REVIEW→LIVE continuation edge: should the overlay REMOVE the\n * review-registered (template-based, read-only) Whiteboard tab?\n *\n * Yes only when ALL hold:\n *  - a live session is active (the channel set emission belongs to a real session start, not\n *    the initial/teardown `[]` replay);\n *  - review mode actually registered a whiteboard tab (otherwise there is nothing stale);\n *  - the live session's resolved channel set has NO Whiteboard channel — when it HAS one, the\n *    live plugin re-registers the same tab key and upgrades the pane in place instead.\n *\n * Review ARTIFACT tabs are deliberately NOT removed — they are wanted carryover.\n *\n * Kept framework-free (like the model) so the rule is unit-testable in isolation.\n */\nexport function ShouldRemoveReviewWhiteboardTab(\n  liveSessionActive: boolean,\n  reviewWhiteboardTabRegistered: boolean,\n  liveChannels: ReadonlyArray<{ ChannelName: string }>\n): boolean {\n  if (!liveSessionActive || !reviewWhiteboardTabRegistered) {\n    return false;\n  }\n  return !liveChannels.some(c => c.ChannelName?.trim().toLowerCase() === 'whiteboard');\n}\n"]}
+{"version":3,"file":"realtime-surface-tabs.model.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-surface-tabs.model.ts"],"names":[],"mappings":"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","sourcesContent":["import { Subject } from 'rxjs';\nimport type { TemplateRef } from '@angular/core';\nimport type { BaseRealtimeChannelClient } from './channels/base-realtime-channel-client';\nimport { ChannelTabColor } from './realtime-surface-tab-style';\n\n/**\n * The kind of a surface-panel tab:\n *  - `activity` — the session-activity tab (pinned LAST, right-aligned). Hosts the activity\n *    rail AND, since the artifact redesign, the inline artifact previews + the split-pane\n *    artifact viewer. Shown only once ≥1 agent run has occurred (see\n *    {@link RealtimeSurfaceTabsModel.SetShowActivityTab}).\n *  - `channel`  — an interactive-channel surface (e.g. the Whiteboard). Registered per\n *    used channel via {@link RealtimeSurfaceTabsModel.RegisterChannelTab}; renders the\n *    plugin's dynamically-created surface component (or a registered template for\n *    legacy/template-based panes), with the \"coming online…\" placeholder until either\n *    is supplied.\n *\n * NOTE: artifacts NO LONGER get their own tab. A delegated run's artifacts now render\n * INSIDE the Activity tab (inline previews + an `as-split` viewer pane) — see\n * `RealtimeActivityRailComponent`.\n */\nexport type RealtimeSurfaceTabKind = 'activity' | 'channel';\n\n/**\n * Per-kind payload carried on a {@link RealtimeSurfaceTab}.\n */\nexport interface RealtimeSurfaceTabData {\n  /**\n   * For `channel` tabs: the channel PLUGIN whose surface component the pane creates\n   * dynamically (and binds back to the plugin) — the registry-driven path every real\n   * channel uses. Takes precedence over {@link Content}.\n   */\n  Plugin?: BaseRealtimeChannelClient;\n  /**\n   * For `channel` tabs: a TEMPLATE-based pane body. Backward-compatible alternative to\n   * {@link Plugin} for hosts that render a bespoke surface without a channel plugin.\n   * When BOTH are absent the pane renders the built-in \"coming online…\" placeholder.\n   */\n  Content?: TemplateRef<unknown>;\n}\n\n/**\n * One tab on the call overlay's tabbed surface panel (the right panel): a channel surface\n * (left cluster) or the session-activity tab (right-aligned).\n */\nexport interface RealtimeSurfaceTab {\n  /** Stable unique key (`activity`, or the channel's registered key). */\n  Key: string;\n  /** Tab strip label (channel name, or \"Activity\"). */\n  Title: string;\n  /** Font Awesome icon class for the tab strip (e.g. `fa-solid fa-chalkboard`). */\n  Icon: string;\n  /** What the tab renders. */\n  Kind: RealtimeSurfaceTabKind;\n  /**\n   * Accent color for the tab's dot + active underline. Channel tabs carry a distinct color\n   * (plugin-supplied or a deterministic hash of the name); the Activity tab uses its own\n   * fixed accent in CSS, so its `Color` is left undefined.\n   */\n  Color?: string;\n  /** Kind-specific payload. */\n  Data?: RealtimeSurfaceTabData;\n}\n\n/**\n * Registration for an interactive-channel tab. The overlay shell registers one per\n * USED channel plugin (supplying {@link Plugin}); supplying {@link Plugin} or\n * {@link Content} later under the same `Key` upgrades a placeholder tab to the real surface.\n */\nexport interface RealtimeChannelTabRegistration {\n  /** Stable channel key (the plugin's `ChannelName`, e.g. `Whiteboard`). Re-registering the same key updates the tab. */\n  Key: string;\n  /** Tab strip label (e.g. `Whiteboard`). */\n  Title: string;\n  /** Font Awesome icon class (e.g. `fa-solid fa-chalkboard`). */\n  Icon: string;\n  /**\n   * Optional explicit accent color for the tab. When omitted, a deterministic color is\n   * derived from {@link Key} so every channel tab still reads as a distinct surface.\n   */\n  Color?: string | null;\n  /** The channel plugin whose surface the pane creates + binds. Preferred over {@link Content}. */\n  Plugin?: BaseRealtimeChannelClient;\n  /** A template-based pane body (legacy/bespoke panes). Omit both to show the \"coming online…\" placeholder. */\n  Content?: TemplateRef<unknown>;\n  /** Focus the tab immediately after registration (default `false`). */\n  Focus?: boolean;\n}\n\n/**\n * Framework-free state for the call overlay's tabbed surface panel: the ordered tab list\n * (CHANNEL tabs first — the marquee surfaces, left cluster — with the session-activity tab\n * pinned LAST and right-aligned by the strip), the active tab, and the transient \"flash\"\n * highlight for a just-revealed channel tab.\n *\n * The Activity tab is GATED: it isn't listed until {@link SetShowActivityTab}(true) — i.e.\n * once ≥1 agent run has occurred (or in review mode). Channel tabs appear only as channels\n * come into play (the whiteboard up-front; every other channel on first use), so an\n * idle voice-first session shows an empty/near-empty strip rather than a row of unused tabs.\n *\n * Owned by `RealtimeSurfaceTabsComponent`; kept free of Angular runtime imports so the\n * add / focus / dedupe / flash logic is unit-testable in isolation. All collections are\n * REPLACED (never mutated) on change, and every change emits {@link Changed$}.\n */\nexport class RealtimeSurfaceTabsModel {\n  /** The fixed key of the session-activity tab (pinned LAST, right-aligned). */\n  public static readonly ActivityTabKey = 'activity';\n\n  /** The activity tab definition, appended last whenever {@link showActivity} is true. */\n  private static readonly ActivityTab: RealtimeSurfaceTab = {\n    Key: RealtimeSurfaceTabsModel.ActivityTabKey,\n    Title: 'Activity',\n    Icon: 'fa-solid fa-wave-square',\n    Kind: 'activity'\n  };\n\n  /** Channel tabs (left cluster), in registration order. Replaced immutably on change. */\n  private channelTabs: RealtimeSurfaceTab[] = [];\n\n  /** Whether the gated Activity tab is currently shown (≥1 agent run, or review mode). */\n  private showActivity = false;\n\n  /** Key of the currently focused tab. */\n  public ActiveKey: string = RealtimeSurfaceTabsModel.ActivityTabKey;\n\n  /**\n   * Key of the tab currently \"flashing\" (the brief highlight a just-revealed channel tab\n   * gets when the agent first acts on it). Cleared by the owning component after a beat via\n   * {@link ClearFlash}.\n   */\n  public FlashKey: string | null = null;\n\n  /** Emits after every model change so the owning component can mark for check. */\n  public readonly Changed$ = new Subject<void>();\n\n  /**\n   * The ordered tabs: channel tabs (left), then the Activity tab LAST when shown. The strip\n   * right-aligns the Activity tab via a flex spacer, so this order also matches reading order.\n   */\n  public get Tabs(): RealtimeSurfaceTab[] {\n    return this.showActivity\n      ? [...this.channelTabs, RealtimeSurfaceTabsModel.ActivityTab]\n      : [...this.channelTabs];\n  }\n\n  /** Whether the Activity tab is currently part of the strip. */\n  public get IsActivityShown(): boolean {\n    return this.showActivity;\n  }\n\n  /**\n   * The currently focused tab. Resolves to the active key when it still exists, else falls\n   * back to the Activity tab (when shown), else the first channel tab, else the Activity tab\n   * definition (so a consumer always has SOMETHING to render even on an empty strip).\n   */\n  public get ActiveTab(): RealtimeSurfaceTab {\n    const tabs = this.Tabs;\n    return tabs.find(t => t.Key === this.ActiveKey)\n      ?? tabs.find(t => t.Key === RealtimeSurfaceTabsModel.ActivityTabKey)\n      ?? tabs[0]\n      ?? RealtimeSurfaceTabsModel.ActivityTab;\n  }\n\n  /**\n   * Shows or hides the gated Activity tab. Turning it ON when an empty strip was implicitly\n   * focusing Activity keeps focus on Activity; turning it OFF while it was focused falls\n   * focus back to the first channel tab (if any). No-op (no emission) when unchanged.\n   *\n   * @param show Whether ≥1 agent run has occurred (or review mode) — the gate.\n   */\n  public SetShowActivityTab(show: boolean): void {\n    if (this.showActivity === show) {\n      return;\n    }\n    this.showActivity = show;\n    if (!show && this.ActiveKey === RealtimeSurfaceTabsModel.ActivityTabKey) {\n      this.ActiveKey = this.channelTabs[0]?.Key ?? RealtimeSurfaceTabsModel.ActivityTabKey;\n    }\n    this.Changed$.next();\n  }\n\n  /**\n   * Registers (or updates) an interactive-channel tab. Re-registering an existing key\n   * replaces its title/icon/color/plugin/content in place (this is how a placeholder\n   * upgrades to the real surface once the channel comes online). New channel tabs join the\n   * left cluster in registration order. A registration without an explicit {@link\n   * RealtimeChannelTabRegistration.Color} gets a deterministic color from its key.\n   *\n   * @param registration The channel tab registration.\n   * @returns The (new or updated) tab.\n   */\n  public RegisterChannelTab(registration: RealtimeChannelTabRegistration): RealtimeSurfaceTab {\n    const tab: RealtimeSurfaceTab = {\n      Key: registration.Key,\n      Title: registration.Title,\n      Icon: registration.Icon,\n      Kind: 'channel',\n      Color: registration.Color ?? ChannelTabColor(registration.Key),\n      Data: { Plugin: registration.Plugin, Content: registration.Content }\n    };\n    const idx = this.channelTabs.findIndex(t => t.Key === registration.Key);\n    if (idx >= 0) {\n      const next = [...this.channelTabs];\n      next[idx] = tab;\n      this.channelTabs = next;\n    } else {\n      this.channelTabs = [...this.channelTabs, tab];\n    }\n    if (registration.Focus) {\n      this.ActiveKey = tab.Key;\n    }\n    this.Changed$.next();\n    return tab;\n  }\n\n  /** Focuses the tab with `key` (no-op when it doesn't exist or is already active). */\n  public Focus(key: string): void {\n    if (!this.Tabs.some(t => t.Key === key) || this.ActiveKey === key) {\n      return;\n    }\n    this.ActiveKey = key;\n    this.Changed$.next();\n  }\n\n  /**\n   * Marks the tab with `key` as the {@link FlashKey} (the brief \"just arrived\" highlight)\n   * WITHOUT changing focus — used by the auto-reveal path when the agent first acts on a\n   * channel, so the user's eye lands on the tab that just came alive. No-op for unknown\n   * keys; the owning component clears it after a beat via {@link ClearFlash}.\n   */\n  public FlashTab(key: string): void {\n    if (this.FlashKey === key || !this.Tabs.some(t => t.Key === key)) {\n      return;\n    }\n    this.FlashKey = key;\n    this.Changed$.next();\n  }\n\n  /**\n   * Removes the channel tab with `key`. Rules:\n   *  - the Activity tab is IRREMOVABLE — removing it is a no-op;\n   *  - an unknown key is a no-op (returns `false`);\n   *  - when the removed tab was focused, focus falls back to the Activity tab (if shown),\n   *    else the first remaining channel tab;\n   *  - a pending flash on the removed tab is cleaned up so the highlight can't dangle.\n   *\n   * @param key The tab key to remove.\n   * @returns `true` when a tab was removed.\n   */\n  public RemoveTab(key: string): boolean {\n    if (key === RealtimeSurfaceTabsModel.ActivityTabKey || !this.channelTabs.some(t => t.Key === key)) {\n      return false;\n    }\n    this.channelTabs = this.channelTabs.filter(t => t.Key !== key);\n    if (this.ActiveKey === key) {\n      this.ActiveKey = this.showActivity\n        ? RealtimeSurfaceTabsModel.ActivityTabKey\n        : (this.channelTabs[0]?.Key ?? RealtimeSurfaceTabsModel.ActivityTabKey);\n    }\n    if (this.FlashKey === key) {\n      this.FlashKey = null;\n    }\n    this.Changed$.next();\n    return true;\n  }\n\n  /** Clears the transient flash highlight (called by the component after a beat). */\n  public ClearFlash(): void {\n    if (this.FlashKey !== null) {\n      this.FlashKey = null;\n      this.Changed$.next();\n    }\n  }\n}\n\n/**\n * Pure decision helper for the REVIEW→LIVE continuation edge: should the overlay REMOVE the\n * review-registered (template-based, read-only) Whiteboard tab?\n *\n * Yes only when ALL hold:\n *  - a live session is active (the channel set emission belongs to a real session start, not\n *    the initial/teardown `[]` replay);\n *  - review mode actually registered a whiteboard tab (otherwise there is nothing stale);\n *  - the live session's resolved channel set has NO Whiteboard channel — when it HAS one, the\n *    live plugin re-registers the same tab key and upgrades the pane in place instead.\n *\n * Kept framework-free (like the model) so the rule is unit-testable in isolation.\n */\nexport function ShouldRemoveReviewWhiteboardTab(\n  liveSessionActive: boolean,\n  reviewWhiteboardTabRegistered: boolean,\n  liveChannels: ReadonlyArray<{ ChannelName: string }>\n): boolean {\n  if (!liveSessionActive || !reviewWhiteboardTabRegistered) {\n    return false;\n  }\n  return !liveChannels.some(c => c.ChannelName?.trim().toLowerCase() === 'whiteboard');\n}\n"]}

package/dist/lib/components/realtime/realtime-ui-config.d.ts

@@ -0,0 +1,270 @@
+/**
+ * @fileoverview Declarative UI configuration for the realtime voice widget.
+ *
+ * The realtime widget historically decided *what to show* from an internal
+ * "disclosure ratchet" ({@link import('./realtime-disclosure').RealtimeDisclosureModel})
+ * plus a handful of scattered getters. That made it impossible for a host
+ * (the chat overlay, a full-screen route, an embedded demo surface, a kiosk,
+ * a mobile sheet…) to tailor the surface to its context.
+ *
+ * This module introduces a single, pure, side-effect-free resolution step that
+ * sits between three concerns:
+ *
+ * 1. **{@link RealtimeUiInputs}** — the *consumer's intent*. A flat bag of
+ *    `@Input()`-friendly feature switches ("show the surface panel?",
+ *    "allow text?", "which chrome?") with documented defaults. A host sets
+ *    only what it cares about; everything else stays on its sensible default,
+ *    so the widget behaves exactly as before when no inputs are provided.
+ *
+ * 2. **{@link RealtimeUiSignals}** — the *live runtime state*. Read-only facts
+ *    the widget already knows: how wide its container is, whether the user has
+ *    revealed text, what the disclosure model currently permits, whether a
+ *    surface/channel/activity exists, the connection state, review/focus modes.
+ *
+ * 3. **{@link ResolvedRealtimeUi}** — the *answer*. A fully-resolved, boolean
+ *    view-model the template binds to directly. No `&&` chains in the HTML; no
+ *    business logic in getters. One source of truth, trivially unit-testable.
+ *
+ * ## The headline behaviour: auto orb ↔ console
+ *
+ * The default {@link RealtimeChromeMode} is `'auto'`. In auto mode the widget is
+ * a calm **orb** until *two* things are true at once:
+ *
+ *   - the container is at least {@link RealtimeUiInputs.consoleBreakpointPx}
+ *     wide (there's room for a structured console), **and**
+ *   - the user has actually asked to see text (`textRevealed`), or the widget
+ *     is reviewing a past session (which always shows the transcript).
+ *
+ * In other words: **getting bigger is not enough — if the user hasn't asked for
+ * text, we keep the orb.** This preserves the loved "ambient by default"
+ * feeling while letting the experience graduate to a full command console the
+ * moment it earns the space *and* the intent. Hosts that want to force one
+ * chrome forever can pass `chrome: 'orb'` or `chrome: 'console'`.
+ *
+ * The resolver is intentionally framework-free (no Angular import) so it can be
+ * unit-tested in isolation and reused by any host.
+ *
+ * @module realtime-ui-config
+ */
+/**
+ * Which visual chrome the widget renders.
+ *
+ * - `'orb'` — the ambient hero orb. Minimal controls; transcript/console hidden
+ *   unless the user reveals them. Best for narrow/overlay/mobile contexts.
+ * - `'console'` — the structured command console: header, transcript, composer
+ *   dock, and (when room allows) the surface panel. Best for full-screen.
+ * - `'auto'` — *(default)* start as an orb; graduate to a console when the
+ *   container is wide enough **and** the user has revealed text. See the module
+ *   docs for the exact rule.
+ */
+export type RealtimeChromeMode = 'orb' | 'console' | 'auto';
+/**
+ * Identifies a control the user invoked. Emitted by the widget's `ControlInvoked`
+ * output so a host can observe (or react to) any control — even one it has hidden
+ * via inputs and re-rendered itself. Extend the union as new controls are added.
+ */
+export type RealtimeControlId = 'mute' | 'captions' | 'type' | 'end' | 'minimize' | 'surface' | 'gear' | 'reveal-text' | 'pure-audio' | 'density';
+/**
+ * The connection lifecycle states the widget cares about for layout decisions.
+ * Mirrors the widget's runtime `RealtimeConnectionState`; duplicated as a string
+ * union here so this module stays import-free of the Angular component.
+ */
+export type RealtimeUiConnectionState = 'connecting' | 'listening' | 'speaking' | 'thinking' | 'idle' | 'error';
+/**
+ * The default container width (px) at or above which `'auto'` chrome is *allowed*
+ * to graduate from orb to console — provided the user has also revealed text.
+ * Chosen so a typical 390px chat overlay stays an orb, while a half-screen or
+ * full-screen surface can become a console. Override per-host via
+ * {@link RealtimeUiInputs.consoleBreakpointPx}.
+ */
+export declare const REALTIME_CONSOLE_BREAKPOINT_DEFAULT = 560;
+/**
+ * Consumer-facing configuration for the realtime widget — every field is a
+ * declarative switch a host can set via an `@Input()`. **All fields are
+ * optional**; omitted fields fall back to {@link DEFAULT_REALTIME_UI_INPUTS},
+ * which reproduces the widget's historical behaviour. This is the surface that
+ * lets the chat overlay slim the widget down, a full-screen route open it up,
+ * and unexpected hosts (kiosks, demos, embeds) compose their own variant.
+ *
+ * A `false` here is a **hard disable** — it removes the affordance regardless of
+ * what the disclosure model or runtime state would otherwise permit. A `true`
+ * means "allow it"; the affordance still only appears when it's also *earned* by
+ * the runtime (e.g. a surface panel only renders once a channel actually exists).
+ */
+export interface RealtimeUiInputs {
+    /** Which chrome to render. Default `'auto'`. */
+    chrome?: RealtimeChromeMode;
+    /**
+     * In `'auto'` chrome, the container width (px) at/above which the widget may
+     * graduate to a console (still gated on text being revealed). Default
+     * {@link REALTIME_CONSOLE_BREAKPOINT_DEFAULT}.
+     */
+    consoleBreakpointPx?: number;
+    /**
+     * Force compact spacing/typography regardless of size — useful for dense
+     * mobile sheets. Default `false` (the widget infers compactness from width).
+     */
+    compact?: boolean;
+    /**
+     * Fade non-essential controls when the session is idle (orb chrome only), for
+     * a cinematic feel. Default `true`.
+     */
+    autoHideControls?: boolean;
+    /**
+     * May the user reveal the transcript at all? When `false`, the widget is a
+     * pure voice orb with no path to text (and therefore never graduates to a
+     * console in `'auto'` mode). Default `true`.
+     */
+    allowTextReveal?: boolean;
+    /** Show the captions toggle. Default `true`. */
+    showCaptionsControl?: boolean;
+    /** Show the density picker inside the gear menu. Default `true`. */
+    showDensityPicker?: boolean;
+    /** Show the minimize control (collapse the call without ending it). Default `true`. */
+    showMinimize?: boolean;
+    /** Show the end-call control. Default `true`. (Hosts that own their own end button may hide it.) */
+    showEnd?: boolean;
+    /**
+     * Show the right-hand surface panel (whiteboard / browser / interactive
+     * channels). Default `true`. Only renders in console chrome and once a panel
+     * is actually earned.
+     */
+    showSurfacePanel?: boolean;
+    /** Show the channel strip (active interactive channels). Default `true`. */
+    showChannels?: boolean;
+    /** Show the Activity rail/tab (delegations, artifacts timeline). Default `true`. */
+    showActivityRail?: boolean;
+    /**
+     * Show developer affordances ("open session / open run" links, dev-only
+     * panels). Default `true`, but still additionally gated by the per-session
+     * dev-mode toggle, so this is a hard *ceiling*, not a force-on.
+     */
+    showDevLinks?: boolean;
+    /** Allow drag-to-resize of the surface panel. Default `true`. */
+    allowResize?: boolean;
+}
+/**
+ * The complete, defaulted input set. Spreading this over a partial
+ * {@link RealtimeUiInputs} yields a fully-populated config; the resolver does
+ * exactly that, so callers never deal with `undefined`.
+ */
+export declare const DEFAULT_REALTIME_UI_INPUTS: Required<RealtimeUiInputs>;
+/**
+ * Live runtime facts the widget feeds into the resolver. These are *observed*,
+ * not configured — they come from the disclosure model, a `ResizeObserver`, and
+ * the session/channel state. Pure data so the resolver stays testable.
+ */
+export interface RealtimeUiSignals {
+    /** Current width of the widget's container, in px (from a `ResizeObserver`). */
+    containerWidthPx: number;
+    /**
+     * Has the user revealed text this session? (i.e. tapped "show the
+     * conversation" / engaged the composer — disclosure level ≥ 1.) This is the
+     * intent half of the auto orb↔console rule.
+     */
+    textRevealed: boolean;
+    /** Disclosure model says a transcript may be shown. */
+    disclosureShowThread: boolean;
+    /** Disclosure model says the composer/text dock may be shown. */
+    disclosureShowComposer: boolean;
+    /** Disclosure model says a surface panel may be shown. */
+    disclosureShowPanel: boolean;
+    /** Disclosure model says the gear/settings menu may be shown. */
+    disclosureShowGear: boolean;
+    /** A surface/channel actually exists to populate the panel. */
+    surfacePanelEarned: boolean;
+    /** ≥ 1 interactive channel is active. */
+    hasChannels: boolean;
+    /** ≥ 1 delegation/activity has occurred (Activity rail has content). */
+    hasActivity: boolean;
+    /** Per-session developer mode is on. */
+    devMode: boolean;
+    /** The widget is reviewing a past (recorded) session, not a live call. */
+    isReviewing: boolean;
+    /** A single channel surface is maximized (focus mode); the main column is hidden. */
+    channelFocus: boolean;
+    /** Current connection lifecycle state. */
+    connectionState: RealtimeUiConnectionState;
+}
+/**
+ * The resolved, render-ready view-model. Every field is a final boolean (or the
+ * effective chrome) — the template binds straight to these with no further
+ * logic. This is the single source of truth for "what is on screen right now".
+ */
+export interface ResolvedRealtimeUi {
+    /** The effective chrome after resolving `'auto'`. */
+    chrome: 'orb' | 'console';
+    /** Whether compact spacing/typography applies. */
+    compact: boolean;
+    /** True while connecting — hosts can show a single, size-independent loader. */
+    connecting: boolean;
+    /** The big ambient hero orb is the primary surface. */
+    showHero: boolean;
+    /** The transcript/thread is visible. */
+    showThread: boolean;
+    /** The text composer dock is visible. */
+    showComposer: boolean;
+    /** The right-hand surface panel is visible. */
+    showSurfacePanel: boolean;
+    /** The Activity tab/rail is available. */
+    showActivityTab: boolean;
+    /** The channel strip is visible. */
+    showChannelStrip: boolean;
+    /** The captions toggle is available. */
+    showCaptionsControl: boolean;
+    /** The density picker is available (inside the gear). */
+    showDensityPicker: boolean;
+    /** The gear/settings affordance is available. */
+    showGear: boolean;
+    /** Developer links/panels are available. */
+    showDevLinks: boolean;
+    /** The minimize control is available. */
+    showMinimize: boolean;
+    /** The end-call control is available. */
+    showEnd: boolean;
+    /** The surface panel may be drag-resized. */
+    allowResize: boolean;
+    /** The user has a path to reveal text. */
+    allowTextReveal: boolean;
+    /** Non-essential controls should auto-fade when idle. */
+    autoHideControls: boolean;
+}
+/**
+ * A safe, dependency-free baseline {@link RealtimeUiSignals}. Use this to seed a
+ * resolved view-model **before** the component's runtime dependencies (the
+ * disclosure model, the session state, the `ResizeObserver`) exist — e.g. in a
+ * field initializer. It describes a freshly-connecting widget at zero width with
+ * nothing earned yet, so the first paint is a calm orb until `recomputeUi()`
+ * runs with real signals. Never read `this` to build the first value.
+ */
+export declare const DEFAULT_REALTIME_UI_SIGNALS: RealtimeUiSignals;
+/**
+ * Resolve the consumer config + live signals into a render-ready view-model.
+ *
+ * Pure and deterministic: same inputs ⇒ same output, no side effects, no clock,
+ * no DOM. Safe to call on every change-detection pass and trivial to unit test.
+ *
+ * The resolution order is:
+ *  1. fill defaults,
+ *  2. decide the effective {@link RealtimeChromeMode} (the orb↔console rule),
+ *  3. for each affordance, AND the consumer's switch with the runtime gate.
+ *
+ * @param inputs  consumer configuration (partial; defaults fill the rest)
+ * @param signals live runtime facts
+ * @returns the fully-resolved {@link ResolvedRealtimeUi}
+ *
+ * @example Chat overlay (lean, ambient):
+ * ```ts
+ * resolveRealtimeUi(
+ *   { chrome: 'auto', showSurfacePanel: false, showActivityRail: false, showDevLinks: false },
+ *   signals
+ * );
+ * ```
+ *
+ * @example Full-screen route (rich console):
+ * ```ts
+ * resolveRealtimeUi({ chrome: 'auto', consoleBreakpointPx: 480 }, wideSignals);
+ * ```
+ */
+export declare function resolveRealtimeUi(inputs: RealtimeUiInputs | null | undefined, signals: RealtimeUiSignals): ResolvedRealtimeUi;
+//# sourceMappingURL=realtime-ui-config.d.ts.map

package/dist/lib/components/realtime/realtime-ui-config.d.ts.map

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