feat(calls): toast the fork's screenshare reminders (EC #39)

io.lotus.screenshare_notice → "Screen sharing stopped — the shared window
was closed.", "Your screen share is showing nothing — the shared window
may be minimised or hidden.", and a sticky "Still sharing?" after 30 min
with nobody else in the call (fork ≥ 0.25.0-lotus.12).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PPmy3tPq869XDW4njjVaKA

.gitea/workflows/ci.yml

@@ -132,11 +132,27 @@ jobs:
     if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/lotus' }}
     runs-on: ubuntu-latest
     steps:
+      # [matrix #9] Debounce: a Tauri build takes ~30 min on the shared runner,
+      # so at most one bump per DEBOUNCE_MIN. Commits that land inside the
+      # window are picked up by cinny-desktop's nightly catch-up workflow (or a
+      # manual dispatch of it) — the desktop cadence no longer tracks every web
+      # commit. The bump is also skipped when nothing changed.
       - name: Bump cinny submodule
         env:
           TOKEN: ${{ secrets.RELEASE_TOKEN }}
+          DEBOUNCE_MIN: '60'
         run: |
           CINNY_SHA="${{ github.sha }}"
+          LAST=$(curl -fsSL -H "Authorization: token $TOKEN" \
+            "https://code.lotusguild.org/api/v1/repos/LotusGuild/cinny-desktop/commits?sha=main&limit=1&stat=false&verification=false&files=false" \
+            | python3 -c 'import sys,json; c=json.load(sys.stdin); print(c[0]["commit"]["committer"]["date"] if c else "")' 2>/dev/null || true)
+          if [ -n "$LAST" ]; then
+            AGE=$(python3 -c "import sys,datetime; d=datetime.datetime.fromisoformat(sys.argv[1].replace('Z','+00:00')); print(int((datetime.datetime.now(datetime.timezone.utc)-d).total_seconds()//60))" "$LAST")
+            if [ "$AGE" -lt "$DEBOUNCE_MIN" ]; then
+              echo "Last desktop bump was ${AGE} min ago (< ${DEBOUNCE_MIN}); skipping — the nightly catch-up will pick this up."
+              exit 0
+            fi
+          fi
           git clone "https://x-access-token:$TOKEN@code.lotusguild.org/LotusGuild/cinny-desktop.git" desktop
           cd desktop
           git config user.email "ci@lotusguild.org"

LOTUS_REFERENCE.md

@@ -79,7 +79,7 @@ Fork = `LotusGuild/element-call` (branch `lotus`, upstream base **v0.25.0** sinc
 
 **Toolchain (upstream-driven, accepted 2026-09):** Node ≥ 22.13 (`.node-version` = 24) and **pnpm 11**, installed directly (`npm i -g pnpm@<packageManager version>`, currently 11.21.0) — **not** via `corepack enable`: `matrix-js-sdk` is a git dependency pnpm builds from source, and its own devEngines pins pnpm 11.9.0; a corepack-shimmed pnpm refuses to switch for that nested install and `pnpm install` fails (fork CI run #1854). pnpm 10 rejects the lockfile and Node 20 cannot build. Lint is **oxlint + oxfmt** (upstream dropped eslint/prettier in v0.25.0): `pnpm lint` (tsc + oxlint + knip) and `pnpm format:check` / `pnpm format`. `matrix-js-sdk` is pinned to a `matrix-org/matrix-js-sdk#develop` commit in the lockfile, as upstream ships it. Fork CI (`.gitea/workflows/ci.yml`) hard-gates lint + format + `pnpm test:unit` before build, with `concurrency: cancel-in-progress`.
 
-**Publish a new version (CI on tag push; needs the `NPM_PUBLISH_TOKEN` org secret):** the published version is derived from the git tag — bump `embedded/web/package.json` (currently `0.25.0-lotus.10`, published by CI; the secret is `NPM_PUBLISH_TOKEN`, names starting `GITEA_` are reserved), push `lotus`, then `git push lotus v0.25.0-lotus.1`; the `publish` job builds and publishes to the Gitea registry. Always push (never delete) the annotated `vX.Y.Z-lotus.N` tag for every published version. Then in cinny bump the `@lotusguild/element-call-embedded` pin (currently `0.25.0-lotus.10`) → `npm install` → build. Manual fallback: `pnpm run build:embedded && cd embedded/web && npm version <ver> --no-git-tag-version && npm publish`.
+**Publish a new version (CI on tag push; needs the `NPM_PUBLISH_TOKEN` org secret):** the published version is derived from the git tag — bump `embedded/web/package.json` (currently `0.25.0-lotus.11`, published by CI; the secret is `NPM_PUBLISH_TOKEN`, names starting `GITEA_` are reserved), push `lotus`, then `git push lotus v0.25.0-lotus.1`; the `publish` job builds and publishes to the Gitea registry. Always push (never delete) the annotated `vX.Y.Z-lotus.N` tag for every published version. Then in cinny bump the `@lotusguild/element-call-embedded` pin (currently `0.25.0-lotus.11`) → `npm install` → build. Manual fallback: `pnpm run build:embedded && cd embedded/web && npm version <ver> --no-git-tag-version && npm publish`.
 
 **`io.lotus.*` widget actions** (add new toWidget actions to the enum + `LOTUS_TO_WIDGET_ACTIONS` in `src/lotus/lotusActions.ts`; only send AFTER call-join or a 10s timeout fires):
 

README.md

@@ -196,7 +196,7 @@ The dev server defaults to **port 8080** (`vite.config.js`); if 8080 is already
 ### 🔱 Element Call fork ("Lotus Call") — LIVE
 
 Voice/video channels embed **Element Call**, which is now our **self-built fork**
-(`@lotusguild/element-call-embedded` `0.25.0-lotus.10`, upstream base v0.25.0, source at
+(`@lotusguild/element-call-embedded` `0.25.0-lotus.11`, upstream base v0.25.0, source at
 `LotusGuild/element-call`), published to our private Gitea npm registry and served
 same-origin. We no longer depend on the upstream prebuilt bundle, so in-call
 behavior is editable source instead of fragile DOM/widget hacks.

package-lock.json

@@ -81,7 +81,7 @@
       },
       "devDependencies": {
         "@axe-core/playwright": "4.13.0",
-        "@lotusguild/element-call-embedded": "0.25.0-lotus.10",
+        "@lotusguild/element-call-embedded": "0.25.0-lotus.11",
         "@playwright/test": "1.63.0",
         "@rollup/plugin-inject": "5.0.5",
         "@rollup/plugin-wasm": "6.2.2",
@@ -2695,9 +2695,9 @@
       "integrity": "sha512-dfLbk+PwWvFzSxwk3n5ySL0hfBog779o8h68wK/7/APo/7cgyWp5jcXockbxdk5kFRkbeXWm4Fbi9FrdN381sA=="
     },
     "node_modules/@lotusguild/element-call-embedded": {
-      "version": "0.25.0-lotus.10",
-      "resolved": "https://code.lotusguild.org/api/packages/LotusGuild/npm/%40lotusguild%2Felement-call-embedded/-/0.25.0-lotus.10/element-call-embedded-0.25.0-lotus.10.tgz",
-      "integrity": "sha512-39uopZBENq07CaYm+hS/dpCmpN+bqRwTkl1nAOG67acBrUeakhdhOYDZR6e34qypuop1WqqanZ2Zo9kHEULsEQ==",
+      "version": "0.25.0-lotus.11",
+      "resolved": "https://code.lotusguild.org/api/packages/LotusGuild/npm/%40lotusguild%2Felement-call-embedded/-/0.25.0-lotus.11/element-call-embedded-0.25.0-lotus.11.tgz",
+      "integrity": "sha512-wLsVsEBLZ4UjhAdLhhk5BmAap1kZ4x8KKirOm2Ie+DbtM34GCv30oUFmQnUmVdO4by3EQAmNK+v+vYyIwq4DOg==",
       "dev": true
     },
     "node_modules/@matrix-org/matrix-sdk-crypto-wasm": {

package.json

@@ -108,7 +108,7 @@
   },
   "devDependencies": {
     "@axe-core/playwright": "4.13.0",
-    "@lotusguild/element-call-embedded": "0.25.0-lotus.10",
+    "@lotusguild/element-call-embedded": "0.25.0-lotus.11",
     "@playwright/test": "1.63.0",
     "@rollup/plugin-inject": "5.0.5",
     "@rollup/plugin-wasm": "6.2.2",

src/app/components/CallEmbedProvider.tsx

@@ -50,6 +50,7 @@ import { useCallPolicyRevokedToast } from '../hooks/useCallPolicyRevokedToast';
 import { useCallEndedToast } from '../hooks/useCallEndedToast';
 import { useCallRejoin } from '../hooks/useCallRejoin';
 import { usePttHaptics } from '../hooks/usePttHaptics';
+import { useScreenshareNotices } from '../hooks/useScreenshareNotices';
 import { useCallAnnouncements } from '../hooks/useCallAnnouncements';
 import { useMutedTalkWarning } from '../hooks/useMutedTalkWarning';
 import { callAnnouncementAtom } from '../state/callAnnouncement';
@@ -748,6 +749,7 @@ function CallUtils({ embed, joined }: { embed: CallEmbed; joined: boolean }) {
   useCallJoinLeaveSounds(embed);
   useCallPolicyRevokedToast(embed, joined);
   useCallEndedToast(embed);
+  useScreenshareNotices(embed);
   usePttHaptics();
   useCallAnnouncements(embed, joined);
   useMutedTalkWarning(embed, joined);

src/app/hooks/useScreenshareNotices.ts

@@ -0,0 +1,48 @@
+import { useEffect } from 'react';
+import { useSetAtom } from 'jotai';
+import { Icons } from 'folds';
+import { CallEmbed } from '../plugins/call';
+import { toastQueueAtom } from '../state/toast';
+
+export type ScreenshareNoticeKind = 'ended' | 'no-frames' | 'alone';
+
+export const describeScreenshareNotice = (kind: ScreenshareNoticeKind): string | undefined => {
+  switch (kind) {
+    case 'ended':
+      return 'Screen sharing stopped — the shared window was closed.';
+    case 'no-frames':
+      return 'Your screen share is showing nothing — the shared window may be minimised or hidden.';
+    case 'alone':
+      return "Still sharing? You've been sharing your screen for 30 minutes with nobody else in the call.";
+    default:
+      return undefined;
+  }
+};
+
+/**
+ * [Gitea EC#39] Toast the fork's io.lotus.screenshare_notice: shared window
+ * closed, no frames for a while, or a long share with nobody watching.
+ */
+export function useScreenshareNotices(embed: CallEmbed): void {
+  const setToast = useSetAtom(toastQueueAtom);
+  useEffect(
+    () =>
+      embed.listenAction<{ data?: { kind?: ScreenshareNoticeKind } }>(
+        'io.lotus.screenshare_notice',
+        (evt) => {
+          const body = describeScreenshareNotice(evt.detail?.data?.kind as ScreenshareNoticeKind);
+          if (!body) return;
+          setToast({
+            id: `screenshare-${evt.detail?.data?.kind}-${Date.now()}`,
+            iconSrc: Icons.ScreenShare,
+            displayName: 'Screen share',
+            body,
+            roomName: embed.room.name ?? 'Voice call',
+            roomId: embed.roomId,
+            sticky: evt.detail?.data?.kind === 'alone',
+          });
+        },
+      ),
+    [embed, setToast],
+  );
+}

src/app/utils/mathParse.test.ts

@@ -81,3 +81,18 @@ test('block and inline mixed with text', () => {
     { type: 'text', value: ' ok' },
   ]);
 });
+
+test('math inside a backtick code span stays literal text (#194 P4-4)', () => {
+  assert.deepEqual(splitMathSegments('inline `$y^2$` here'), [
+    { type: 'text', value: 'inline `$y^2$` here' },
+  ]);
+  assert.deepEqual(splitMathSegments('``$a$`` and $b$'), [
+    { type: 'text', value: '``$a$`` and ' },
+    { type: 'inline', value: 'b' },
+  ]);
+  // An unclosed backtick is just a character.
+  assert.deepEqual(splitMathSegments('tick ` then $c$'), [
+    { type: 'text', value: 'tick ` then ' },
+    { type: 'inline', value: 'c' },
+  ]);
+});

src/app/utils/mathParse.ts

@@ -88,6 +88,23 @@ export const splitMathSegments = (text: string): MathSegment[] => {
   };
 
   while (i < text.length) {
+    // Backtick code spans are literal: `$x$` inside them must stay text so
+    // markdown's inline code wins (a run of N backticks closes with N).
+    if (text[i] === '`') {
+      let ticks = 0;
+      while (text[i + ticks] === '`') ticks += 1;
+      const fence = '`'.repeat(ticks);
+      const close = text.indexOf(fence, i + ticks);
+      if (close !== -1) {
+        buffer += text.slice(i, close + ticks);
+        i = close + ticks;
+        continue;
+      }
+      buffer += fence;
+      i += ticks;
+      continue;
+    }
+
     // Escaped dollar: consume `\$` and emit a literal `$` as text.
     if (text[i] === '\\' && text[i + 1] === '$') {
       buffer += '$';