@memberjunction/ng-conversations 5.40.2 → 5.41.0

package/dist/lib/components/realtime/realtime-disclosure.js

@@ -0,0 +1,188 @@
+import { Subject } from 'rxjs';
+/** UserInfoEngine settings key for the persisted milestones (versioned shape). */
+export const REALTIME_UX_PREF_KEY = 'mj.realtimeVoice.uxMilestones.v1';
+/** The highest disclosure level. */
+export const REALTIME_UX_MAX_LEVEL = 4;
+/** Completed-call count at which the `auto` base promotes to the full power console. */
+export const REALTIME_UX_PRO_CALLS = 3;
+/** The level each session event raises the volatile session level to. */
+const EVENT_LEVELS = {
+    text: 1,
+    engaged: 2,
+    channel: 3,
+    power: REALTIME_UX_MAX_LEVEL
+};
+/** A brand-new user's milestones: nothing earned, auto density. */
+export function DefaultUxMilestones() {
+    return { Level: 0, Calls: 0, Density: 'auto' };
+}
+/** Clamps a candidate level into the valid 0–{@link REALTIME_UX_MAX_LEVEL} band. */
+export function ClampUxLevel(level) {
+    if (!Number.isFinite(level)) {
+        return 0;
+    }
+    return Math.min(REALTIME_UX_MAX_LEVEL, Math.max(0, Math.round(level)));
+}
+/**
+ * Parses a persisted milestones payload. TOLERANT: anything missing/malformed falls back
+ * to {@link DefaultUxMilestones} (field-wise) — a bad preference must never break the call UX.
+ */
+export function ParseUxMilestones(raw) {
+    const defaults = DefaultUxMilestones();
+    if (!raw) {
+        return defaults;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object') {
+            return defaults;
+        }
+        const density = parsed.density;
+        return {
+            Level: typeof parsed.level === 'number' ? ClampUxLevel(parsed.level) : defaults.Level,
+            Calls: typeof parsed.calls === 'number' && Number.isFinite(parsed.calls)
+                ? Math.max(0, Math.round(parsed.calls))
+                : defaults.Calls,
+            Density: density === 'simple' || density === 'standard' || density === 'pro' || density === 'auto'
+                ? density
+                : defaults.Density
+        };
+    }
+    catch {
+        return defaults;
+    }
+}
+/** Serializes milestones for persistence (lower-cased keys, versionless — the key carries v1). */
+export function SerializeUxMilestones(m) {
+    return JSON.stringify({ level: ClampUxLevel(m.Level), calls: Math.max(0, m.Calls), density: m.Density });
+}
+/**
+ * The BASE disclosure level a fresh session starts at:
+ *  - manual density overrides win outright (`simple` → 0, `standard` → 2, `pro` → 4);
+ *  - `auto` follows the earned ratchet, promoted to the full console once the user has
+ *    completed {@link REALTIME_UX_PRO_CALLS} calls.
+ */
+export function EffectiveBaseLevel(m) {
+    switch (m.Density) {
+        case 'simple': return 0;
+        case 'standard': return 2;
+        case 'pro': return REALTIME_UX_MAX_LEVEL;
+        default:
+            return ClampUxLevel(Math.max(m.Level, m.Calls >= REALTIME_UX_PRO_CALLS ? REALTIME_UX_MAX_LEVEL : 0));
+    }
+}
+/**
+ * The milestones to persist when a live call ends: the call count increments and the
+ * earned level ratchets up to whatever the session reached — never below 1 (a completed
+ * first call earns the text thread by default next time), never down.
+ */
+export function RatchetedMilestones(m, sessionLevel) {
+    return {
+        Level: ClampUxLevel(Math.max(m.Level, sessionLevel, 1)),
+        Calls: Math.max(0, m.Calls) + 1,
+        Density: m.Density
+    };
+}
+/**
+ * The volatile + persisted disclosure state for ONE overlay instance. The overlay loads
+ * it from UserInfoEngine at construction, calls {@link Raise} as session events land,
+ * derives every visibility gate from the getters, and persists {@link RatchetOnSessionEnd}'s
+ * result when the call ends.
+ */
+export class RealtimeDisclosureModel {
+    /** The persisted cross-session milestones (replaced immutably on change). */
+    Milestones = DefaultUxMilestones();
+    /** The CURRENT session's volatile level — max(base, raised events). */
+    SessionLevel = 0;
+    /** Emits after every change so the owning component can mark for check. */
+    Changed$ = new Subject();
+    /** Loads persisted milestones (tolerant) and resets the session level to the base. */
+    Load(raw) {
+        this.Milestones = ParseUxMilestones(raw);
+        this.SessionLevel = EffectiveBaseLevel(this.Milestones);
+        this.Changed$.next();
+    }
+    /** Resets the volatile session level to the base — call at every fresh session start. */
+    BeginSession() {
+        const base = EffectiveBaseLevel(this.Milestones);
+        if (this.SessionLevel !== base) {
+            this.SessionLevel = base;
+            this.Changed$.next();
+        }
+    }
+    /**
+     * RAISES the session level for an event (never lowers it).
+     * @returns `true` when the level actually changed.
+     */
+    Raise(event) {
+        const target = EVENT_LEVELS[event];
+        if (this.SessionLevel >= target) {
+            return false;
+        }
+        this.SessionLevel = target;
+        this.Changed$.next();
+        return true;
+    }
+    /**
+     * EXPLICIT step back down to the pure-audio surface (level 0) for THIS session —
+     * the inverse door of the hero's "Show the conversation" / T-to-type reveals. Volatile
+     * only: the cross-session milestones ratchet is untouched (use the gear's `simple`
+     * density to make pure audio the durable default). Raising is one-way for CONTENT;
+     * the USER may always walk back down.
+     */
+    ReturnToPureAudio() {
+        if (this.SessionLevel === 0) {
+            return;
+        }
+        this.SessionLevel = 0;
+        this.Changed$.next();
+    }
+    /**
+     * Applies the gear's manual density override. Takes effect immediately — `simple`
+     * returns even a mid-call console to the day-one surface (content tabs keep their
+     * content; only the chrome retracts). The caller persists the serialized milestones.
+     */
+    SetDensity(density) {
+        if (this.Milestones.Density === density) {
+            return;
+        }
+        this.Milestones = { ...this.Milestones, Density: density };
+        this.SessionLevel = EffectiveBaseLevel(this.Milestones);
+        this.Changed$.next();
+    }
+    /**
+     * Ratchets + replaces the milestones for a completed call and returns the serialized
+     * payload for persistence. The session level is left as-is (the overlay is about to
+     * close or re-begin).
+     */
+    RatchetOnSessionEnd() {
+        this.Milestones = RatchetedMilestones(this.Milestones, this.SessionLevel);
+        return SerializeUxMilestones(this.Milestones);
+    }
+    // ── Visibility gates (live mode; review mode bypasses disclosure entirely) ──
+    /** Level 1+: the caption thread (and the captions control) are visible. */
+    get ShowThread() {
+        return this.SessionLevel >= 1;
+    }
+    /**
+     * Level 2+ POWER-CHROME milestone (app-bar End pill, gear, channel strip). NOTE: the
+     * composer dock itself is NOT level-forced — it is the overlay's per-session, user-owned
+     * Open toggle (the strip's Type control / T opens it; the dock's hide control closes it).
+     */
+    get ShowComposer() {
+        return this.SessionLevel >= 2;
+    }
+    /** Level 2+: the surface panel exists (content arrival forces this via 'engaged'/'channel'). */
+    get ShowPanel() {
+        return this.SessionLevel >= 2;
+    }
+    /** Level 2+: the channel strip + the app-bar gear (density escape hatch lives there). */
+    get ShowGear() {
+        return this.SessionLevel >= 2;
+    }
+    /** Level 4: developer affordances are offered by default (gear popover still gates them). */
+    get PowerLevel() {
+        return this.SessionLevel >= REALTIME_UX_MAX_LEVEL;
+    }
+}
+//# sourceMappingURL=realtime-disclosure.js.map

package/dist/lib/components/realtime/realtime-disclosure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-disclosure.js","sourceRoot":"","sources":["../../../../src/lib/components/realtime/realtime-disclosure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAoD/B,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;AAEvE,oCAAoC;AACpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,yEAAyE;AACzE,MAAM,YAAY,GAA4C;IAC5D,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,qBAAqB;CAC7B,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACjD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAA8B;IAC9D,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmE,CAAC;QACjG,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,OAAO;YACL,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK;YACrF,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;gBACtE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvC,CAAC,CAAC,QAAQ,CAAC,KAAK;YAClB,OAAO,EAAE,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM;gBAChG,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,QAAQ,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CAAC,CAAuB;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAuB;IACxD,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACxB,KAAK,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1B,KAAK,KAAK,CAAC,CAAC,OAAO,qBAAqB,CAAC;QACzC;YACE,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAuB,EAAE,YAAoB;IAC/E,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAClC,6EAA6E;IACtE,UAAU,GAAyB,mBAAmB,EAAE,CAAC;IAEhE,uEAAuE;IAChE,YAAY,GAAG,CAAC,CAAC;IAExB,2EAA2E;IAC3D,QAAQ,GAAG,IAAI,OAAO,EAAQ,CAAC;IAE/C,sFAAsF;IAC/E,IAAI,CAAC,GAA8B;QACxC,IAAI,CAAC,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,yFAAyF;IAClF,YAAY;QACjB,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAA8B;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACI,iBAAiB;QACtB,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,OAA0B;QAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC3D,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,mBAAmB;QACxB,IAAI,CAAC,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1E,OAAO,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,+EAA+E;IAE/E,2EAA2E;IAC3E,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,gGAAgG;IAChG,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,yFAAyF;IACzF,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,6FAA6F;IAC7F,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,YAAY,IAAI,qBAAqB,CAAC;IACpD,CAAC;CACF","sourcesContent":["import { Subject } from 'rxjs';\n\n/**\n * @fileoverview PROGRESSIVE DISCLOSURE model for the realtime call overlay — the\n * framework-free engine behind the \"console that grows with you\" UX\n * (`plans/realtime/mockups/redesign-a-progressive.html`).\n *\n * The overlay starts as PURE AUDIO (a breathing orb, three controls, no text) and\n * reveals surfaces along two axes:\n *\n *  - **Content-driven (within a session, panel-only)** — the ONE auto-reveal is a\n *    channel's first agent activity (e.g. the first whiteboard write): the surface panel\n *    opens as a peek with that tab focused, while the left column stays exactly as it\n *    was (pure audio included). Everything else announces itself without grabbing:\n *    finished artifacts land as glowing unfocused tabs; delegations are narrated aloud.\n *  - **Capability-driven (across sessions, ratcheted)** — the thread text, composer,\n *    gear and other chrome unlock as the user demonstrates depth (or asks: the hero's\n *    \"Show the conversation\", the T-to-type hotkey, the Details peek). Milestones persist\n *    per-user via UserInfoEngine under {@link REALTIME_UX_PREF_KEY}; once a control is\n *    earned it never auto-hides. The gear's Simple / Standard / Pro density control is\n *    the manual escape hatch, writing the same setting.\n *\n * ### Levels\n * | Level | Name        | Adds                                                      |\n * |-------|-------------|-----------------------------------------------------------|\n * | 0     | Pure audio  | hero orb · mute · Details peek · end — nothing to read    |\n * | 1     | Text        | caption thread + captions control + type-to-text hint     |\n * | 2     | Engaged     | surface panel · composer dock · channel strip · gear      |\n * | 3     | Channels    | channel tab revealed (board in play)                      |\n * | 4     | Power       | dev affordances default-available (gear popover unlocks)  |\n *\n * Kept free of Angular runtime imports (like `RealtimeSurfaceTabsModel`) so every rule\n * is unit-testable in isolation; the overlay component owns persistence (UserInfoEngine)\n * and subscribes {@link RealtimeDisclosureModel.Changed$} to re-render.\n */\n\n/** The user's manual interface-density override (the gear's escape hatch). */\nexport type RealtimeUxDensity = 'auto' | 'simple' | 'standard' | 'pro';\n\n/** Session events that RAISE the volatile disclosure level (never lower it). */\nexport type RealtimeDisclosureEvent = 'text' | 'engaged' | 'channel' | 'power';\n\n/** The per-user persisted disclosure milestones (the cross-session ratchet). */\nexport interface RealtimeUxMilestones {\n  /** Highest disclosure level EARNED across sessions (0–4). Never decreases. */\n  Level: number;\n  /** Completed live calls — promotes the auto base to power level at {@link REALTIME_UX_PRO_CALLS}. */\n  Calls: number;\n  /** Manual density override; `'auto'` follows the earned ratchet. */\n  Density: RealtimeUxDensity;\n}\n\n/** UserInfoEngine settings key for the persisted milestones (versioned shape). */\nexport const REALTIME_UX_PREF_KEY = 'mj.realtimeVoice.uxMilestones.v1';\n\n/** The highest disclosure level. */\nexport const REALTIME_UX_MAX_LEVEL = 4;\n\n/** Completed-call count at which the `auto` base promotes to the full power console. */\nexport const REALTIME_UX_PRO_CALLS = 3;\n\n/** The level each session event raises the volatile session level to. */\nconst EVENT_LEVELS: Record<RealtimeDisclosureEvent, number> = {\n  text: 1,\n  engaged: 2,\n  channel: 3,\n  power: REALTIME_UX_MAX_LEVEL\n};\n\n/** A brand-new user's milestones: nothing earned, auto density. */\nexport function DefaultUxMilestones(): RealtimeUxMilestones {\n  return { Level: 0, Calls: 0, Density: 'auto' };\n}\n\n/** Clamps a candidate level into the valid 0–{@link REALTIME_UX_MAX_LEVEL} band. */\nexport function ClampUxLevel(level: number): number {\n  if (!Number.isFinite(level)) {\n    return 0;\n  }\n  return Math.min(REALTIME_UX_MAX_LEVEL, Math.max(0, Math.round(level)));\n}\n\n/**\n * Parses a persisted milestones payload. TOLERANT: anything missing/malformed falls back\n * to {@link DefaultUxMilestones} (field-wise) — a bad preference must never break the call UX.\n */\nexport function ParseUxMilestones(raw: string | null | undefined): RealtimeUxMilestones {\n  const defaults = DefaultUxMilestones();\n  if (!raw) {\n    return defaults;\n  }\n  try {\n    const parsed = JSON.parse(raw) as { level?: unknown; calls?: unknown; density?: unknown } | null;\n    if (!parsed || typeof parsed !== 'object') {\n      return defaults;\n    }\n    const density = parsed.density;\n    return {\n      Level: typeof parsed.level === 'number' ? ClampUxLevel(parsed.level) : defaults.Level,\n      Calls: typeof parsed.calls === 'number' && Number.isFinite(parsed.calls)\n        ? Math.max(0, Math.round(parsed.calls))\n        : defaults.Calls,\n      Density: density === 'simple' || density === 'standard' || density === 'pro' || density === 'auto'\n        ? density\n        : defaults.Density\n    };\n  } catch {\n    return defaults;\n  }\n}\n\n/** Serializes milestones for persistence (lower-cased keys, versionless — the key carries v1). */\nexport function SerializeUxMilestones(m: RealtimeUxMilestones): string {\n  return JSON.stringify({ level: ClampUxLevel(m.Level), calls: Math.max(0, m.Calls), density: m.Density });\n}\n\n/**\n * The BASE disclosure level a fresh session starts at:\n *  - manual density overrides win outright (`simple` → 0, `standard` → 2, `pro` → 4);\n *  - `auto` follows the earned ratchet, promoted to the full console once the user has\n *    completed {@link REALTIME_UX_PRO_CALLS} calls.\n */\nexport function EffectiveBaseLevel(m: RealtimeUxMilestones): number {\n  switch (m.Density) {\n    case 'simple': return 0;\n    case 'standard': return 2;\n    case 'pro': return REALTIME_UX_MAX_LEVEL;\n    default:\n      return ClampUxLevel(Math.max(m.Level, m.Calls >= REALTIME_UX_PRO_CALLS ? REALTIME_UX_MAX_LEVEL : 0));\n  }\n}\n\n/**\n * The milestones to persist when a live call ends: the call count increments and the\n * earned level ratchets up to whatever the session reached — never below 1 (a completed\n * first call earns the text thread by default next time), never down.\n */\nexport function RatchetedMilestones(m: RealtimeUxMilestones, sessionLevel: number): RealtimeUxMilestones {\n  return {\n    Level: ClampUxLevel(Math.max(m.Level, sessionLevel, 1)),\n    Calls: Math.max(0, m.Calls) + 1,\n    Density: m.Density\n  };\n}\n\n/**\n * The volatile + persisted disclosure state for ONE overlay instance. The overlay loads\n * it from UserInfoEngine at construction, calls {@link Raise} as session events land,\n * derives every visibility gate from the getters, and persists {@link RatchetOnSessionEnd}'s\n * result when the call ends.\n */\nexport class RealtimeDisclosureModel {\n  /** The persisted cross-session milestones (replaced immutably on change). */\n  public Milestones: RealtimeUxMilestones = DefaultUxMilestones();\n\n  /** The CURRENT session's volatile level — max(base, raised events). */\n  public SessionLevel = 0;\n\n  /** Emits after every change so the owning component can mark for check. */\n  public readonly Changed$ = new Subject<void>();\n\n  /** Loads persisted milestones (tolerant) and resets the session level to the base. */\n  public Load(raw: string | null | undefined): void {\n    this.Milestones = ParseUxMilestones(raw);\n    this.SessionLevel = EffectiveBaseLevel(this.Milestones);\n    this.Changed$.next();\n  }\n\n  /** Resets the volatile session level to the base — call at every fresh session start. */\n  public BeginSession(): void {\n    const base = EffectiveBaseLevel(this.Milestones);\n    if (this.SessionLevel !== base) {\n      this.SessionLevel = base;\n      this.Changed$.next();\n    }\n  }\n\n  /**\n   * RAISES the session level for an event (never lowers it).\n   * @returns `true` when the level actually changed.\n   */\n  public Raise(event: RealtimeDisclosureEvent): boolean {\n    const target = EVENT_LEVELS[event];\n    if (this.SessionLevel >= target) {\n      return false;\n    }\n    this.SessionLevel = target;\n    this.Changed$.next();\n    return true;\n  }\n\n  /**\n   * EXPLICIT step back down to the pure-audio surface (level 0) for THIS session —\n   * the inverse door of the hero's \"Show the conversation\" / T-to-type reveals. Volatile\n   * only: the cross-session milestones ratchet is untouched (use the gear's `simple`\n   * density to make pure audio the durable default). Raising is one-way for CONTENT;\n   * the USER may always walk back down.\n   */\n  public ReturnToPureAudio(): void {\n    if (this.SessionLevel === 0) {\n      return;\n    }\n    this.SessionLevel = 0;\n    this.Changed$.next();\n  }\n\n  /**\n   * Applies the gear's manual density override. Takes effect immediately — `simple`\n   * returns even a mid-call console to the day-one surface (content tabs keep their\n   * content; only the chrome retracts). The caller persists the serialized milestones.\n   */\n  public SetDensity(density: RealtimeUxDensity): void {\n    if (this.Milestones.Density === density) {\n      return;\n    }\n    this.Milestones = { ...this.Milestones, Density: density };\n    this.SessionLevel = EffectiveBaseLevel(this.Milestones);\n    this.Changed$.next();\n  }\n\n  /**\n   * Ratchets + replaces the milestones for a completed call and returns the serialized\n   * payload for persistence. The session level is left as-is (the overlay is about to\n   * close or re-begin).\n   */\n  public RatchetOnSessionEnd(): string {\n    this.Milestones = RatchetedMilestones(this.Milestones, this.SessionLevel);\n    return SerializeUxMilestones(this.Milestones);\n  }\n\n  // ── Visibility gates (live mode; review mode bypasses disclosure entirely) ──\n\n  /** Level 1+: the caption thread (and the captions control) are visible. */\n  public get ShowThread(): boolean {\n    return this.SessionLevel >= 1;\n  }\n\n  /**\n   * Level 2+ POWER-CHROME milestone (app-bar End pill, gear, channel strip). NOTE: the\n   * composer dock itself is NOT level-forced — it is the overlay's per-session, user-owned\n   * Open toggle (the strip's Type control / T opens it; the dock's hide control closes it).\n   */\n  public get ShowComposer(): boolean {\n    return this.SessionLevel >= 2;\n  }\n\n  /** Level 2+: the surface panel exists (content arrival forces this via 'engaged'/'channel'). */\n  public get ShowPanel(): boolean {\n    return this.SessionLevel >= 2;\n  }\n\n  /** Level 2+: the channel strip + the app-bar gear (density escape hatch lives there). */\n  public get ShowGear(): boolean {\n    return this.SessionLevel >= 2;\n  }\n\n  /** Level 4: developer affordances are offered by default (gear popover still gates them). */\n  public get PowerLevel(): boolean {\n    return this.SessionLevel >= REALTIME_UX_MAX_LEVEL;\n  }\n}\n"]}