@memberjunction/ng-conversations 5.40.2 → 5.41.0

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

@@ -0,0 +1,173 @@
+import { EventEmitter, OnInit, OnDestroy } from '@angular/core';
+import { UserInfo } from '@memberjunction/core';
+import { RealtimeSessionState } from './realtime-session-state';
+import { ChannelOnboardingDetails } from './channels/base-realtime-channel-client';
+import { RealtimeSurfaceTabsModel, RealtimeSurfaceTab, RealtimeChannelTabRegistration } from './realtime-surface-tabs.model';
+import { ParsedDelegationArtifact } from '../../services/delegation-result-parser';
+import * as i0 from "@angular/core";
+/**
+ * The call overlay's TABBED SURFACE PANEL (the right panel) — per the approved
+ * `plans/realtime/mockups/whiteboard.html` mockup:
+ *
+ *  - **Activity** — always the first tab; hosts the existing
+ *    {@link RealtimeActivityRailComponent} unchanged (in `Embedded` mode, since this panel
+ *    owns the chrome + collapse).
+ *  - **One tab per artifact** produced by delegated runs: when a delegation result carries
+ *    artifacts, a tab is auto-opened, FOCUSED, and briefly flashed violet. The pane reuses
+ *    the standard `mj-artifact-viewer-panel` (read-only embed: no header/tabs/actions),
+ *    loading by ArtifactID — the latest version, i.e. the one the run just produced.
+ *  - **Channel tabs** — rendered ONLY once a channel registers via
+ *    {@link RegisterChannelTab}. The overlay shell registers one per registry-resolved
+ *    {@link BaseRealtimeChannelClient} plugin; the pane creates the plugin's surface
+ *    component dynamically (via `mj-realtime-channel-pane`). Until a registration supplies
+ *    a plugin (or legacy template), the pane shows the "coming online…" placeholder;
+ *    re-registering the same key swaps the real surface in.
+ *
+ * Panes are kept ALIVE while hidden (CSS `display:none`, mirroring the mockup's
+ * `.s-pane.active`) so switching tabs never reloads an artifact or resets the rail.
+ * The whole panel collapses to a slim strip via the chevron at the tab strip's end —
+ * the collapse-to-strip behavior that used to live on the rail, lifted to the panel.
+ *
+ * SIZING IS EXTERNAL: the overlay shell hosts this panel in a fixed-width flex item
+ * and owns the width (user drag via the resize handle + persisted preference +
+ * default tiers). This panel just fills it and REPORTS the layout signals the shell sizes from:
+ * {@link CollapsedChange} (slim-strip toggle) and {@link WideChanged} (a content tab
+ * is focused → the default width tier widens).
+ */
+export declare class RealtimeSurfaceTabsComponent implements OnInit, OnDestroy {
+    /** How long a just-arrived tab keeps its violet flash highlight. */
+    private static readonly FlashDurationMs;
+    /** Shared live-session state, owned by the overlay shell (feeds the Activity rail). */
+    State: RealtimeSessionState;
+    /** 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: boolean;
+    /** The signed-in user, threaded to the artifact viewer panel. */
+    CurrentUser: UserInfo | null;
+    /** The active environment id, threaded to the artifact viewer panel. */
+    EnvironmentID: string;
+    /** Re-emitted from the Activity rail's dev "Open run" links. */
+    OpenRunRequested: EventEmitter<string>;
+    /**
+     * Emitted when the panel toggles between expanded and the slim collapsed strip —
+     * the overlay shell resizes this panel's split area to the strip width.
+     */
+    CollapsedChange: EventEmitter<boolean>;
+    /**
+     * Emitted when {@link IsWide} flips (a content tab gained / lost focus) — the
+     * overlay shell widens the panel's DEFAULT split-area size while wide (only when
+     * the user has never dragged an explicit width).
+     */
+    WideChanged: EventEmitter<boolean>;
+    /** 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;
+    /** Artifact version ids already turned into tabs (guards the State rescan). */
+    private tabbedVersionIds;
+    private flashTimer;
+    private subs;
+    private lastWide;
+    private cdr;
+    /**
+     * The channel whose first-run intro is currently being shown (its `ChannelName`), or `null`
+     * when no intro is up. Set when the user opens a channel tab they've never seen the intro
+     * for; cleared on dismiss. Only one intro shows at a time (the active channel's).
+     */
+    private onboardingChannelName;
+    /** The intro content for {@link onboardingChannelName}, mirrored for the template binding. */
+    OnboardingContent: ChannelOnboardingDetails | null;
+    /** The currently focused tab. */
+    get ActiveTab(): RealtimeSurfaceTab;
+    /** Wide presentation when a content tab (artifact / channel) is focused. */
+    get IsWide(): boolean;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Toggle the panel between expanded and slim-collapsed. */
+    ToggleCollapsed(): void;
+    /** Collapse-state transitions funnel through here so the shell always hears about them. */
+    private setCollapsed;
+    /** Emits {@link WideChanged} when the wide tier flips (content tab focus / collapse). */
+    private syncWide;
+    /** track fn for the @for over tabs. */
+    TrackTab(index: number, tab: RealtimeSurfaceTab): string;
+    /**
+     * Focuses (opening if needed) the tab for an artifact — the "View →" affordance target
+     * on done delegation cards and rail entries. Expands the panel if it was collapsed.
+     */
+    FocusArtifact(artifact: ParsedDelegationArtifact): void;
+    /**
+     * Registers (or updates) an interactive-channel tab — one per registry-resolved channel
+     * plugin, forwarded from `RealtimeSessionOverlayComponent.RegisterChannelTab`.
+     */
+    RegisterChannelTab(registration: RealtimeChannelTabRegistration): void;
+    /**
+     * AUTO-REVEALS a channel surface the moment the agent first acts on it: expands the
+     * panel if collapsed, focuses the channel's tab and flashes it violet — so the user
+     * discovers the whiteboard (or any channel) exists the instant it comes alive,
+     * instead of having to find the tab themselves. No-op for unknown keys.
+     */
+    RevealChannel(key: string): void;
+    /**
+     * Removes a tab from the panel (Activity is irremovable; focus falls back to Activity —
+     * see {@link RealtimeSurfaceTabsModel.RemoveTab}). Used by the overlay shell on a
+     * review→live continuation whose live channel set resolved WITHOUT the channel a stale
+     * review tab represents (e.g. no Whiteboard channel → drop the read-only review board tab).
+     *
+     * @returns `true` when a tab was removed.
+     */
+    RemoveTab(key: string): boolean;
+    /**
+     * Registers an artifact tab WITHOUT stealing focus (default) — the SESSION REVIEW /
+     * resume-carryover path, where a reviewed session's (and its prior legs') history
+     * artifacts are surfaced as tabs the user can visit, as opposed to the live
+     * auto-open-on-arrival behavior. Idempotent per artifact version; the registered tab
+     * survives the review→live transition (tabs are never cleared on resume).
+     */
+    RegisterArtifactTab(artifact: ParsedDelegationArtifact, focus?: boolean): void;
+    /** On session-state changes: open tabs for newly-arrived artifacts, then re-render. */
+    private onStateChanged;
+    /** On model changes: schedule the flash clear, report a wide-tier flip, re-render. */
+    private onModelChanged;
+    /**
+     * 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
+     * which this user hasn't dismissed before. Re-runs on every model change so switching away
+     * from a channel tab tears the intro down (only the active channel's intro is ever up).
+     */
+    private evaluateOnboarding;
+    /**
+     * Dismisses the current channel intro: marks that channel seen for this user (persisted via
+     * `UserInfoEngine`, debounced — NOT localStorage) and hides the panel so it never re-appears.
+     */
+    DismissOnboarding(): void;
+    /** Reads the per-user seen-map and reports whether this channel's intro has been dismissed. */
+    private HasSeenOnboarding;
+    /** Persists `channelName` into the per-user seen-map (merge + debounced save). */
+    private markOnboardingSeen;
+    /** Reads + parses the per-user seen-map setting (tolerant: malformed / unset → empty map). */
+    private readOnboardingSeen;
+    /**
+     * Scans the session's delegation cards for artifacts that don't have a tab yet and
+     * adds one per artifact — UNFOCUSED, with the brief violet flash plus the persistent
+     * unseen glow. Per product direction a finished artifact never steals the screen
+     * (only the agent's first channel activity auto-reveals); the glowing tab is the
+     * invitation, the user opens it when they want it.
+     */
+    private syncArtifactTabs;
+    /**
+     * Focuses the FIRST tab in the strip — channels lead, so a Details peek lands on the
+     * marquee surface (e.g. the Whiteboard) when one exists, else on Activity.
+     */
+    FocusFirstTab(): void;
+    /** 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; }; }, { "OpenRunRequested": "OpenRunRequested"; "CollapsedChange": "CollapsedChange"; "WideChanged": "WideChanged"; }, never, never, true, never>;
+}
+//# sourceMappingURL=realtime-surface-tabs.component.d.ts.map

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

@@ -0,0 +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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"}