@tuturuuu/ui 0.37.2 → 0.39.0

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## [0.39.0](https://github.com/tutur3u/platform/compare/ui-v0.38.0...ui-v0.39.0) (2026-10-09)
+
+
+### Features
+
+* **docs:** expand platform guides, enforce SEO, and pause inactive runtimes ([#6085](https://github.com/tutur3u/platform/issues/6085)) ([df7a159](https://github.com/tutur3u/platform/commit/df7a159e9c657fee4f6e0b593c776d6887b2ae11))
+* **meet:** simplify the in-call document toolbar ([6020a1e](https://github.com/tutur3u/platform/commit/6020a1eddfc4f8cab9179daf1feb126f9dfc0501)) ([#5918](https://github.com/tutur3u/platform/issues/5918)) ([fa358e7](https://github.com/tutur3u/platform/commit/fa358e76517e5bc9793caf72658738d9bf2b42d6))
+
+
+### Bug Fixes
+
+* **calendar:** stabilize civil dates and today rendering ([c1abdf0](https://github.com/tutur3u/platform/commit/c1abdf0df75c0a02cc00c37b7a0a5e55c862bf89)) ([#5950](https://github.com/tutur3u/platform/issues/5950)) ([5a00326](https://github.com/tutur3u/platform/commit/5a00326171bec65ec7210de161dd5272bfda22b2))
+* **finance:** bound subscription schedules and block invalid inventory ([f4163bf](https://github.com/tutur3u/platform/commit/f4163bf6697316a06a8b2d3922d9664937dd6940)) ([#5990](https://github.com/tutur3u/platform/issues/5990)) ([f2096f6](https://github.com/tutur3u/platform/commit/f2096f6e20d27dd998a03d11c7b0769d7f06bb2e))
+* **finance:** expose safe invoice history recovery ([8a53d36](https://github.com/tutur3u/platform/commit/8a53d367d6888e592a0d64f760d47234d858bd73)) ([#6034](https://github.com/tutur3u/platform/issues/6034)) ([fd65a3d](https://github.com/tutur3u/platform/commit/fd65a3db6f7472771374192ab07f5a97c6fcaee8))
+* **finance:** fence customer search to verified actor scope ([416d710](https://github.com/tutur3u/platform/commit/416d710961a509c06637ac2a93878f24ae0a03ae)) ([#6031](https://github.com/tutur3u/platform/issues/6031)) ([1d5a023](https://github.com/tutur3u/platform/commit/1d5a023d917ab75e19f575dec51a03be841763bc))
+* **finance:** fence invoice create completion to admitted draft ([5b1cd6f](https://github.com/tutur3u/platform/commit/5b1cd6ff9e228002ceee9d2d347e7a2f5bf61b03)) ([#6023](https://github.com/tutur3u/platform/issues/6023)) ([2e7f99f](https://github.com/tutur3u/platform/commit/2e7f99ffd26d2e877e6e8567c3873bffa6bdcf45))
+* **finance:** fence invoice PNG export lifetimes ([7d21df4](https://github.com/tutur3u/platform/commit/7d21df4d3301a388e6fa2823f68fb25d0c71d1c4)) ([#6038](https://github.com/tutur3u/platform/issues/6038)) ([4a5365a](https://github.com/tutur3u/platform/commit/4a5365ae1a6d28ef142bdc904695491475a740d3))
+* **finance:** isolate customer groups by actor lifetime ([d20c9d5](https://github.com/tutur3u/platform/commit/d20c9d53d23e5ce0ad6c94199d202cd30e522694)) ([#6028](https://github.com/tutur3u/platform/issues/6028)) ([c8f712c](https://github.com/tutur3u/platform/commit/c8f712cfd590b29b2d271cbf6a75895142427a52))
+* **finance:** isolate subscription context by actor lifetime ([55f09f2](https://github.com/tutur3u/platform/commit/55f09f2a86f1956cdad5ddd28bb01a2ae92a0dad)) ([#6024](https://github.com/tutur3u/platform/issues/6024)) ([42e96b9](https://github.com/tutur3u/platform/commit/42e96b93ce1a4ebad8c7fb877bfdecd7d0451bed))
+* **finance:** keep invoice templates usable with invalid dates ([2d4bc6d](https://github.com/tutur3u/platform/commit/2d4bc6d9f3cf0b7a1377b71a59f8efb581e3170e)) ([#6040](https://github.com/tutur3u/platform/issues/6040)) ([c84bb36](https://github.com/tutur3u/platform/commit/c84bb36369c941b67be8ca9be62fe076d34e957a))
+* **finance:** reconcile attendance summary with current main ([fb00e6e](https://github.com/tutur3u/platform/commit/fb00e6ef4373adc1b6b9107f9bba883c101c3438))
+* **finance:** retain history with unrenderable dates ([95b8513](https://github.com/tutur3u/platform/commit/95b851336bedc480d3e10fba6cea1e3a2c047ff1)) ([#6035](https://github.com/tutur3u/platform/issues/6035)) ([ad0a0d3](https://github.com/tutur3u/platform/commit/ad0a0d3720f560cfe0a8baec1c2b30c1e77c273d))
+* **finance:** scope invoice history to account lifetime ([7fb93ef](https://github.com/tutur3u/platform/commit/7fb93efe2d60f17be5a936067b3141b0330fa0ab)) ([#6033](https://github.com/tutur3u/platform/issues/6033)) ([9dc373a](https://github.com/tutur3u/platform/commit/9dc373abef6838d3fe9cb2c511559d883a63be42))
+* **finance:** stabilize attendance calendar status summaries ([0c22684](https://github.com/tutur3u/platform/commit/0c22684245e101a79e2b3c37b7304e71427eccc8)) ([#6075](https://github.com/tutur3u/platform/issues/6075)) ([0789e90](https://github.com/tutur3u/platform/commit/0789e9091d7218ac6341a2843f43b554839da454))
+* **finance:** tolerate denied invoice preference storage ([0b17e29](https://github.com/tutur3u/platform/commit/0b17e297eae859dac01016e002397cb3a4d0d0ac)) ([#6003](https://github.com/tutur3u/platform/issues/6003)) ([56fa042](https://github.com/tutur3u/platform/commit/56fa04277bad4e3b57cc87be66952cf8ae28c44c))
+* **mobile:** integrate Assistant and Secrets shell coverage ([141ae72](https://github.com/tutur3u/platform/commit/141ae72cab1c5cb1604dfc654fdc5ff666dc0037))
+
+## [0.38.0](https://github.com/tutur3u/platform/compare/ui-v0.37.2...ui-v0.38.0) (2026-10-04)
+
+
+### Features
+
+* **calendar:** support full Google color choices and scoped edits ([#5661](https://github.com/tutur3u/platform/issues/5661)) ([8cafac5](https://github.com/tutur3u/platform/commit/8cafac53438b504eafa8bcc8213d18448e4a17bc))
+* **education:** add personal to do destinations to Teach and Learn ([9587942](https://github.com/tutur3u/platform/commit/9587942deeebcb6aca3a774f4289178771bcabd6))
+* **education:** add personal To do in Teach and Learn ([#5785](https://github.com/tutur3u/platform/issues/5785)) ([0a5e302](https://github.com/tutur3u/platform/commit/0a5e302fa9b09c140c717751005bbda23a1dc0b1))
+
+
+### Bug Fixes
+
+* **calendar:** gate uncertain creation retries on durable capability ([4a0a088](https://github.com/tutur3u/platform/commit/4a0a0883ddfff464be0880afd13758908e65203f))
+* **calendar:** recover edited drafts and align provider color parity ([d97142a](https://github.com/tutur3u/platform/commit/d97142abe22188b6a31a4a6b0e7b3a97d35d07f5))
+* **finance:** authenticate exchange rates with satellite sessions ([33368f1](https://github.com/tutur3u/platform/commit/33368f1c00f86f71b4a66702899af262a90122e2)) ([#5760](https://github.com/tutur3u/platform/issues/5760)) ([759b1e5](https://github.com/tutur3u/platform/commit/759b1e52f8867aced2d64288af43b861d5ebccdc))
+* **identity:** integrate main and order unapplied creator migrations ([5512e24](https://github.com/tutur3u/platform/commit/5512e2414abaa0c78b68cbdd3186a1d4bab861e7))
+* **notifications:** preserve Colab polling policy ([ed09b9d](https://github.com/tutur3u/platform/commit/ed09b9ddaabd9b1865ca11e0459f23b0141137df))
+* **ui:** close workspace popover without callback ([b0693b8](https://github.com/tutur3u/platform/commit/b0693b869721b9333d81d791554864291bec769d))
+* **ui:** default browser workspace selectors to dropdowns ([9a8da02](https://github.com/tutur3u/platform/commit/9a8da02ceb7c03ee7eb05fb6cdc729144da6192a))
+* **ui:** refine workspace dropdown recovery and viewport bounds ([06eeee7](https://github.com/tutur3u/platform/commit/06eeee77a26c1fc632907b72a5e0218d5d3fb49d))
+* **web:** restore anchored workspace dropdown ([2df0661](https://github.com/tutur3u/platform/commit/2df0661f911eaec319cacca5d29242804d0e76ee))
+* **web:** restore standard workspace dropdown ([#5739](https://github.com/tutur3u/platform/issues/5739)) ([f84ae74](https://github.com/tutur3u/platform/commit/f84ae741f2abab2a21aadfacda56bd7eba623466))
+
+
+### Performance Improvements
+
+* **notifications:** reduce idle API polling ([32ee541](https://github.com/tutur3u/platform/commit/32ee5410e51d900698a06724b440b63df363fee9)) ([#5773](https://github.com/tutur3u/platform/issues/5773)) ([55089e0](https://github.com/tutur3u/platform/commit/55089e06ed6728f4bd6543787dcae48de3cfd734))
+
 ## [0.37.2](https://github.com/tutur3u/platform/compare/ui-v0.37.1...ui-v0.37.2) (2026-10-02)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuturuuu/ui",
-  "version": "0.37.2",
+  "version": "0.39.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -87,13 +87,14 @@
     "@tiptap/pm": "3.31.3",
     "@tiptap/react": "3.31.3",
     "@tiptap/starter-kit": "3.31.3",
-    "@tuturuuu/ai": "0.16.1",
+    "@tuturuuu/ai": "0.18.0",
     "@tuturuuu/apis": "0.13.0",
     "@tuturuuu/hooks": "0.1.2",
     "@tuturuuu/icons": "0.1.1",
-    "@tuturuuu/internal-api": "0.48.0",
+    "@tuturuuu/internal-api": "0.50.0",
+    "@tuturuuu/realtime": "0.10.1",
     "@tuturuuu/supabase": "0.5.2",
-    "@tuturuuu/utils": "0.33.3",
+    "@tuturuuu/utils": "0.35.0",
     "@types/debug": "^4.1.13",
     "browser-image-compression": "^2.0.2",
     "class-variance-authority": "^0.7.1",
@@ -114,7 +115,7 @@
     "lodash": "4.18.1",
     "moment": "^2.30.1",
     "motion": "^13.2.0",
-    "next": "^16.3.5",
+    "next": "^16.4.0",
     "next-intl": "^4.14.4",
     "next-themes": "^0.4.6",
     "nuqs": "^2.10.1",
@@ -154,7 +155,7 @@
     "@tanstack/react-table": "^9.2.4",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
-    "@tuturuuu/types": "0.33.1",
+    "@tuturuuu/types": "0.34.0",
     "@tuturuuu/typescript-config": "0.1.2",
     "@types/html2canvas": "^1.0.0",
     "@types/lodash": "^4.17.25",
@@ -179,6 +180,7 @@
     "@tanstack/react-table": "^9.0.0"
   },
   "exports": {
+    "./custom/education-todo": "./src/components/ui/custom/education-todo.tsx",
     "./globals.css": "./src/globals.css",
     "./marketing": "./src/components/ui/marketing/index.ts",
     "./postcss.config": "./postcss.config.mjs",
@@ -497,7 +499,8 @@
     "./custom/satellite-notification-popover": "./src/components/ui/custom/satellite-notification-popover.tsx",
     "./custom/notification-runtime": "./src/components/ui/custom/notification-runtime.tsx",
     "./finance/invoices/query-invalidation": "./src/components/ui/finance/invoices/query-invalidation.ts",
-    "./finance/shared/charts/use-finance-confidential-visibility": "./src/components/ui/finance/shared/charts/use-finance-confidential-visibility.ts"
+    "./finance/shared/charts/use-finance-confidential-visibility": "./src/components/ui/finance/shared/charts/use-finance-confidential-visibility.ts",
+    "./text-editor/collaboration-carets": "./src/components/ui/text-editor/collaboration-carets.ts"
   },
   "packageManager": "bun@1.4.1"
 }

package/src/components/ui/custom/__tests__/workspace-picker-content.test.tsx

@@ -3,6 +3,7 @@ import type { InternalApiWorkspaceSummary } from '@tuturuuu/types';
 import { describe, expect, it, vi } from 'vitest';
 import type { useWorkspaceVisibility } from '../../../../hooks/use-workspace-visibility';
 import { Dialog } from '../../dialog';
+import { Popover, PopoverTrigger } from '../../popover';
 import { WorkspacePickerContent } from '../workspace-picker-content';
 
 vi.mock('next-intl', () => ({ useTranslations: () => (key: string) => key }));
@@ -179,3 +180,88 @@ describe('workspace sheet rendered identities', () => {
     );
   });
 });
+
+describe('workspace browser dropdown', () => {
+  it('keeps search and Hidden recovery in an anchored scrolling dropdown', async () => {
+    const onSelect = vi.fn();
+    const onDefault = vi.fn();
+    const onCreate = vi.fn();
+    const state = visibility({ hiddenIds: [other.id] });
+    render(
+      <Popover defaultOpen>
+        <PopoverTrigger>Choose workspace</PopoverTrigger>
+        <WorkspacePickerContent
+          presentation="dropdown"
+          workspaces={[one, other]}
+          visibility={state}
+          onSelect={onSelect}
+          onDefault={onDefault}
+          onCreate={onCreate}
+        />
+      </Popover>
+    );
+    const dropdown = screen.getByRole('dialog', { name: 'workspaces' });
+    expect(dropdown).toHaveAttribute('data-slot', 'popover-content');
+    expect(dropdown).not.toHaveClass('inset-0');
+    expect(dropdown).not.toHaveClass('h-dvh');
+    expect(dropdown).toHaveClass(
+      'max-h-[min(32rem,var(--radix-popover-content-available-height))]'
+    );
+    expect(dropdown).toHaveClass('overflow-hidden', 'flex-col');
+    const input = screen.getByRole('textbox', { name: 'search_workspace' });
+    const row = screen.getByRole('button', { name: 'Repeated name PRO' });
+    expect(row.closest('.overflow-y-auto')).not.toBeNull();
+    expect(screen.queryByText('Another workspace')).toBeNull();
+    fireEvent.click(row);
+    expect(onSelect).toHaveBeenCalledWith(one);
+    fireEvent.click(screen.getByRole('button', { name: 'default_workspace' }));
+    expect(onDefault).toHaveBeenCalledWith(one.id);
+    const create = screen.getByRole('button', {
+      name: 'create_workspace_action',
+    });
+    const createFooter = create.parentElement;
+    expect(createFooter).not.toHaveClass('absolute');
+    fireEvent.click(create);
+    expect(onCreate).toHaveBeenCalledOnce();
+    fireEvent.change(input, { target: { value: 'missing' } });
+    expect(
+      screen.queryByRole('button', { name: 'Repeated name PRO' })
+    ).toBeNull();
+    fireEvent.click(screen.getByRole('button', { name: 'hidden_workspaces' }));
+    expect(input).toHaveValue('');
+    expect(dropdown).toHaveAccessibleName('hidden_workspaces');
+    expect(createFooter).toHaveClass('hidden');
+    fireEvent.click(
+      screen.getByRole('button', {
+        name: 'restore_workspace: Another workspace',
+      })
+    );
+    expect(state.setHidden).toHaveBeenCalledWith(other.id, false);
+    expect(onSelect).toHaveBeenCalledTimes(1);
+    fireEvent.keyDown(dropdown, { key: 'Escape' });
+    await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
+  });
+});
+
+it.each([false, true])(
+  'closes its popover with an optional callback: %s',
+  async (withCallback) => {
+    const onClose = vi.fn();
+    render(
+      <Popover defaultOpen>
+        <PopoverTrigger>Choose workspace</PopoverTrigger>
+        <WorkspacePickerContent
+          presentation="dropdown"
+          workspaces={[one]}
+          visibility={visibility()}
+          onSelect={vi.fn()}
+          onDefault={vi.fn()}
+          onClose={withCallback ? onClose : undefined}
+        />
+      </Popover>
+    );
+    fireEvent.click(screen.getByRole('button', { name: 'close' }));
+    await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
+    expect(onClose).toHaveBeenCalledTimes(withCallback ? 1 : 0);
+  }
+);

package/src/components/ui/custom/education-todo.test.tsx

@@ -0,0 +1,131 @@
+import { fireEvent, render, screen } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { EducationTodo } from './education-todo';
+
+const state = vi.hoisted(() => ({
+  query: vi.fn(),
+  refetch: vi.fn(),
+  error: false,
+}));
+vi.mock('@tanstack/react-query', () => ({
+  useQuery: (options: unknown) => {
+    state.query(options);
+    return {
+      isError: state.error,
+      isPending: false,
+      refetch: state.refetch,
+      data: {
+        count: 30,
+        totalPages: 2,
+        data: [
+          {
+            id: 'done',
+            title: 'Completed synthetic work',
+            courseId: 'course',
+            completed: true,
+          },
+          {
+            id: 'open',
+            title: 'Open synthetic work',
+            courseId: 'course',
+            completed: false,
+          },
+        ],
+      },
+    };
+  },
+}));
+vi.mock('@tuturuuu/internal-api/teach', () => ({ listEducationTodo: vi.fn() }));
+const translate = (key: string) => key;
+describe('personal education work controls', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    state.error = false;
+  });
+  it('separates actor caches, paginates and resets page on category switch', () => {
+    const { rerender } = render(
+      <EducationTodo
+        app="learn"
+        wsId="workspace"
+        actorId="actor-one"
+        t={translate}
+      />
+    );
+    expect(state.query).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        queryKey: [
+          'education-todo',
+          'learn',
+          'workspace',
+          'actor-one',
+          'tutoring',
+          1,
+        ],
+      })
+    );
+    fireEvent.click(screen.getByRole('button', { name: 'next' }));
+    expect(state.query).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        queryKey: [
+          'education-todo',
+          'learn',
+          'workspace',
+          'actor-one',
+          'tutoring',
+          2,
+        ],
+      })
+    );
+    fireEvent.click(screen.getByRole('button', { name: 'assignments' }));
+    expect(screen.queryByText('Completed synthetic work')).toBeNull();
+    expect(screen.getByText('Open synthetic work')).toBeTruthy();
+    expect(state.query).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        queryKey: [
+          'education-todo',
+          'learn',
+          'workspace',
+          'actor-one',
+          'assignments',
+          1,
+        ],
+      })
+    );
+    fireEvent.click(screen.getByRole('checkbox'));
+    expect(screen.getByText('Completed synthetic work')).toBeTruthy();
+    rerender(
+      <EducationTodo
+        app="learn"
+        wsId="workspace"
+        actorId="actor-two"
+        t={translate}
+      />
+    );
+    expect(state.query).toHaveBeenLastCalledWith(
+      expect.objectContaining({
+        queryKey: [
+          'education-todo',
+          'learn',
+          'workspace',
+          'actor-two',
+          'assignments',
+          1,
+        ],
+      })
+    );
+  });
+  it('offers retry on errors without rendering stale assigned rows', () => {
+    state.error = true;
+    render(
+      <EducationTodo
+        app="teach"
+        wsId="workspace"
+        actorId="actor"
+        t={translate}
+      />
+    );
+    expect(screen.queryByText('Open synthetic work')).toBeNull();
+    fireEvent.click(screen.getByRole('button', { name: 'retry' }));
+    expect(state.refetch).toHaveBeenCalledOnce();
+  });
+});

package/src/components/ui/custom/education-todo.tsx

@@ -0,0 +1,191 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import {
+  BookOpen,
+  CalendarCheck,
+  CheckCheck,
+  ClipboardList,
+} from '@tuturuuu/icons';
+import {
+  type EducationTodoItem,
+  type EducationTodoKind,
+  listEducationTodo,
+} from '@tuturuuu/internal-api/teach';
+import { Button } from '@tuturuuu/ui/button';
+import { Checkbox } from '@tuturuuu/ui/checkbox';
+import Link from 'next/link';
+import { useState } from 'react';
+
+const kinds = ['tutoring', 'assignments', 'lessons', 'tests'] as const;
+const icons = {
+  tutoring: CalendarCheck,
+  assignments: ClipboardList,
+  lessons: BookOpen,
+  tests: ClipboardList,
+};
+function itemHref(
+  app: 'learn' | 'teach',
+  wsId: string,
+  kind: EducationTodoKind,
+  row: EducationTodoItem
+) {
+  if (kind === 'tutoring' || !row.courseId) return null;
+  if (kind === 'tests')
+    return `/${wsId}/courses/${row.courseId}${app === 'learn' ? `/tests/${row.id}` : ''}`;
+  if (kind === 'assignments')
+    return `/${wsId}/assignments${app === 'teach' ? `?course=${row.courseId}` : ''}`;
+  return `/${wsId}/courses/${row.courseId}${app === 'teach' ? `/${row.id}` : ''}`;
+}
+
+export function EducationTodo({
+  app,
+  wsId,
+  actorId,
+  t,
+}: {
+  app: 'learn' | 'teach';
+  wsId: string;
+  actorId: string;
+  t: (key: string, values?: Record<string, string | number>) => string;
+}) {
+  const [kind, setKind] = useState<EducationTodoKind>('tutoring');
+  const [page, setPage] = useState(1);
+  const [showCompleted, setShowCompleted] = useState(false);
+  const query = useQuery({
+    queryKey: ['education-todo', app, wsId, actorId, kind, page],
+    queryFn: () => listEducationTodo(app, wsId, { kind, page }),
+  });
+  const rows = (query.data?.data ?? []).filter(
+    (row) => showCompleted || !row.completed
+  );
+  return (
+    <main className="mx-auto max-w-5xl space-y-5 p-5 md:p-8">
+      <header className="space-y-2">
+        <h1 className="font-semibold text-3xl">{t('title')}</h1>
+        <p className="max-w-2xl text-muted-foreground">
+          {t(app === 'learn' ? 'learnDescription' : 'teachDescription')}
+        </p>
+      </header>
+      <nav aria-label={t('categories')} className="flex flex-wrap gap-2">
+        {kinds.map((value) => {
+          const Icon = icons[value];
+          return (
+            <Button
+              key={value}
+              variant={kind === value ? 'default' : 'outline'}
+              aria-pressed={kind === value}
+              onClick={() => {
+                setKind(value);
+                setPage(1);
+              }}
+            >
+              <Icon className="size-4" />
+              {t(value)}
+            </Button>
+          );
+        })}
+      </nav>
+      {kind !== 'tutoring' && app === 'learn' ? (
+        <label className="flex items-center gap-2 text-sm">
+          <Checkbox
+            checked={showCompleted}
+            onCheckedChange={(value) => setShowCompleted(value === true)}
+          />
+          {t('showCompleted')}
+        </label>
+      ) : null}
+      {query.isError ? (
+        <div role="alert" className="space-y-3 rounded-xl border p-5">
+          <p>{t('error')}</p>
+          <Button onClick={() => void query.refetch()} variant="outline">
+            {t('retry')}
+          </Button>
+        </div>
+      ) : query.isPending ? (
+        <p role="status">{t('loading')}</p>
+      ) : (
+        <>
+          <p className="text-muted-foreground text-sm">
+            {t(app === 'learn' ? 'assignedCount' : 'pendingCount', {
+              count: query.data?.count ?? 0,
+            })}
+          </p>
+          <ul className="space-y-3">
+            {rows.map((row) => {
+              const href = itemHref(app, wsId, kind, row);
+              return (
+                <li
+                  key={row.id}
+                  className="flex flex-wrap items-center justify-between gap-4 rounded-xl border bg-card p-4"
+                >
+                  <div className="min-w-0 space-y-1">
+                    <h2 className="line-clamp-3 break-words font-medium">
+                      {row.title ||
+                        t(kind === 'tutoring' ? 'tutoring' : 'untitled')}
+                    </h2>
+                    {row.participantName ? (
+                      <p className="text-muted-foreground text-sm">
+                        {t(app === 'teach' ? 'student' : 'teacher')}:{' '}
+                        {row.participantName}
+                      </p>
+                    ) : null}
+                    {row.date ? (
+                      <p className="text-muted-foreground text-sm">
+                        {row.date}
+                        {row.startTime ? ` · ${row.startTime.slice(0, 5)}` : ''}
+                        {row.durationMinutes
+                          ? ` · ${t('minutes', { count: row.durationMinutes })}`
+                          : ''}
+                      </p>
+                    ) : null}
+                    {row.completed ? (
+                      <p className="flex items-center gap-1 text-muted-foreground text-sm">
+                        <CheckCheck className="size-4" />
+                        {t('completed')}
+                      </p>
+                    ) : null}
+                  </div>
+                  {href ? (
+                    <Button asChild size="sm" variant="outline">
+                      <Link href={href}>{t('open')}</Link>
+                    </Button>
+                  ) : null}
+                </li>
+              );
+            })}
+          </ul>
+          {!rows.length ? (
+            <p className="rounded-xl border border-dashed p-6 text-muted-foreground">
+              {t((query.data?.count ?? 0) ? 'emptyPage' : 'empty')}
+            </p>
+          ) : null}
+          {(query.data?.totalPages ?? 0) > 1 ? (
+            <nav
+              aria-label={t('pages')}
+              className="flex items-center justify-between gap-3"
+            >
+              <Button
+                disabled={page === 1}
+                onClick={() => setPage((value) => value - 1)}
+                variant="outline"
+              >
+                {t('previous')}
+              </Button>
+              <span className="text-sm">
+                {t('page', { page, total: query.data?.totalPages ?? 0 })}
+              </span>
+              <Button
+                disabled={page >= (query.data?.totalPages ?? 0)}
+                onClick={() => setPage((value) => value + 1)}
+                variant="outline"
+              >
+                {t('next')}
+              </Button>
+            </nav>
+          ) : null}
+        </>
+      )}
+    </main>
+  );
+}

package/src/components/ui/custom/satellite-notification-polling.test.tsx

@@ -0,0 +1,61 @@
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { cleanup, render } from '@testing-library/react';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { NotificationRuntime } from './notification-runtime';
+import SatelliteNotificationPopover from './satellite-notification-popover';
+
+const { unread, list } = vi.hoisted(() => ({ unread: vi.fn(), list: vi.fn() }));
+vi.mock('@tuturuuu/ui/hooks/use-notifications', () => ({
+  useUnreadCount: unread,
+  useInfiniteNotifications: list,
+  useNotificationSubscription: vi.fn(),
+  useMarkAllAsRead: () => ({ mutate: vi.fn(), isPending: false }),
+  useUpdateNotification: () => ({ mutate: vi.fn(), isPending: false }),
+  dedupeNotifications: () => [],
+}));
+vi.mock('./notification-list', () => ({ NotificationList: () => null }));
+describe('satellite freshness policy', () => {
+  afterEach(() => {
+    cleanup();
+    vi.clearAllMocks();
+  });
+  it.each([
+    [undefined, 120_000],
+    [30_000, 30_000],
+  ])(
+    'uses the default or an explicit app polling interval',
+    (pollIntervalMs, expected) => {
+      unread.mockReturnValue({ data: 0 });
+      list.mockReturnValue({ data: { pages: [] }, isLoading: false });
+      render(
+        <QueryClientProvider client={new QueryClient()}>
+          <NotificationRuntime
+            value={{
+              params: { wsId: 'personal' },
+              pathname: '/',
+              router: { push: vi.fn(), refresh: vi.fn() },
+              Link: ({ children }) => <span>{children}</span>,
+              realtime: false,
+            }}
+          >
+            <SatelliteNotificationPopover
+              userId="actor"
+              pollIntervalMs={pollIntervalMs}
+              noNotificationsText="Empty"
+              notificationsText="Notifications"
+              viewAllText="View all"
+              markAsReadText="Read"
+              markAsUnreadText="Unread"
+            />
+          </NotificationRuntime>
+        </QueryClientProvider>
+      );
+      expect(unread.mock.calls[0]?.[1].refetchInterval).toBe(expected);
+      expect(
+        list.mock.calls.every(
+          ([options]) => options.refetchInterval === expected
+        )
+      ).toBe(true);
+    }
+  );
+});

package/src/components/ui/custom/satellite-notification-popover.tsx

@@ -22,10 +22,13 @@ import { NotificationPopoverTriggerButton } from './notification-popover-trigger
 import { useNotificationRuntime } from './notification-runtime';
 
 dayjs.extend(relativeTime);
+const NOTIFICATION_POLL_INTERVAL_MS = 2 * 60_000;
 type TabType = 'inbox' | 'archive';
 
 export interface NotificationPopoverClientProps {
   userId?: string;
+  /** Optional app-specific freshness policy for non-subscription consumers. */
+  pollIntervalMs?: number;
   noNotificationsText: string;
   notificationsText: string;
   viewAllText: string;
@@ -63,6 +66,7 @@ function isValidWorkspaceFilterId(value: unknown): value is string {
 
 export default function SatelliteNotificationPopover({
   userId,
+  pollIntervalMs = NOTIFICATION_POLL_INTERVAL_MS,
   noNotificationsText,
   notificationsText,
   viewAllText,
@@ -98,7 +102,7 @@ export default function SatelliteNotificationPopover({
   const { data: unreadCount = 0 } = useUnreadCount(wsIdForFiltering, {
     cacheScope: userId,
     enabled: Boolean(userId),
-    refetchInterval: realtime ? undefined : 30_000,
+    refetchInterval: realtime ? undefined : pollIntervalMs,
   });
 
   // Infinite scroll for inbox (unread) and archive (read)
@@ -107,7 +111,7 @@ export default function SatelliteNotificationPopover({
     wsId: wsIdForFiltering,
     unreadOnly: true,
     pageSize: 15,
-    refetchInterval: realtime ? undefined : 30_000,
+    refetchInterval: realtime ? undefined : pollIntervalMs,
     enabled: Boolean(userId) && open && activeTab === 'inbox',
   });
 
@@ -116,7 +120,7 @@ export default function SatelliteNotificationPopover({
     wsId: wsIdForFiltering,
     readOnly: true,
     pageSize: 15,
-    refetchInterval: realtime ? undefined : 30_000,
+    refetchInterval: realtime ? undefined : pollIntervalMs,
     enabled: Boolean(userId) && open && activeTab === 'archive',
   });