@blogmcp/community 0.2.0 → 0.3.0

package/src/core/realtime.ts

@@ -1,5 +1,6 @@
 /**
- * The discussion's live updates (m2-contracts.md §3.5, §3.10): `<blogmcp-discussion>` takes a `realtime` PROPERTY —
+ * The discussion's live updates (m2-contracts.md §3.5, §3.10): `<blogmcp-discussion>` (and M3 `<blogmcp-topic>`) takes a
+ * `realtime` PROPERTY —
  * the session factory of `@blogmcp/sdk/community/realtime`, which the HOST imports and passes:
  *
  *   import { createRealtimeSession } from '@blogmcp/sdk/community/realtime'
@@ -11,7 +12,7 @@
  *
  * The types here are the factory's shape as far as the element uses it, so `createRealtimeSession` fits as it is.
  */
-import type { CommunityClient, DiscussionStore } from '@blogmcp/sdk/community'
+import type { CommunityClient, DiscussionStore, TopicStore } from '@blogmcp/sdk/community'
 
 /** `connecting`, `live`, `polling` (live updates are off or the server cut the socket for good), `stopped`. */
 export type DiscussionRealtimeMode = 'connecting' | 'live' | 'polling' | 'stopped' | (string & {})
@@ -37,3 +38,15 @@ export interface DiscussionRealtimeSession {
 
 /** `createRealtimeSession` of `@blogmcp/sdk/community/realtime`, or any function of its shape. */
 export type DiscussionRealtime = (options: DiscussionRealtimeOptions) => DiscussionRealtimeSession
+
+/**
+ * M3 (m3-contracts.md §3.5, §5.3): what `<blogmcp-topic>` calls the same factory with — the topic's store
+ * (`createTopicStore`) in place of a discussion's; `createRealtimeSession` takes both, re-reads a topic with
+ * `forum/topics/get` and falls back to `forum/topics/head`.
+ */
+export interface TopicRealtimeOptions extends Omit<DiscussionRealtimeOptions, 'store'> {
+  store: TopicStore
+}
+
+/** `createRealtimeSession`, as `<blogmcp-topic>`'s `realtime` property takes it. */
+export type TopicRealtime = (options: TopicRealtimeOptions) => DiscussionRealtimeSession

package/src/core/topic.ts

@@ -0,0 +1,234 @@
+/**
+ * `<blogmcp-topic conversation-id>`'s brain (m3-contracts.md §3.1–§3.5, §4.5, §5.3): the topic's thread — the
+ * discussion's brain over the SDK's topic store (createTopicThreadController: the composer, replies, edits with the
+ * title of the opening post, reactions, reports, blocks, the onboarding, the brakes, live updates or the head poll) —
+ * and what the topic has of its own:
+ *
+ *   - its header (title, state, pin, category) from `forum/topics/get`, a title read through topicTitleOf (deleted, or
+ *     withheld from this viewer);
+ *   - the follow button (the topic's `following`; `me/follows/set` by its conversation id);
+ *   - for a moderator of its category (`viewer.moderator`): close or reopen it, pin or unpin it, move it into another
+ *     category they moderate, and on a message — remove it (a rule and the facts; the statement comes back) or pass it to
+ *     the team (`moderation/escalate`, a category of the illegal line). kb-api re-checks the appointment on every call:
+ *     a refusal is `notFound`, and the topic is read again.
+ */
+import { reactive } from 'vue'
+import {
+  ESCALATION_CATEGORIES,
+  communityRulesOf,
+  isCategoryModerator,
+  type CaseCategory,
+  type CommunityCallOptions,
+  type CommunityClient,
+  type CommunityFailure,
+  type CommunityRule,
+  type DiscussionMessage,
+  type ForumCategory,
+  type Topic,
+} from '@blogmcp/sdk/community'
+import { createTopicThreadController, type TopicThreadController, type TopicThreadControllerOptions } from './discussion'
+import { createFollow, type FollowController } from './follow'
+import type { TextRef } from './i18n'
+import { failureText } from './outcomes'
+import { codePointLength, normalizeBody } from './text'
+
+/** The facts of a moderator's removal, as an appeal's text (kb-api's `facts` limit is its own; the composer's is safe). */
+const FACTS_MAX = 4000
+
+export type ModeratorDialogKind = 'remove' | 'escalate' | 'move'
+
+/** A moderator's open dialog: a message's removal or escalation, or the topic's move. */
+export interface ModeratorDialog {
+  kind: ModeratorDialogKind
+  /** The message (remove, escalate). */
+  seq: number | null
+  ruleId: string
+  facts: string
+  category: CaseCategory | ''
+  categoryId: string
+  sending: boolean
+  failure: CommunityFailure | null
+  /** A removal's statement of reasons, as kb-api rendered it. */
+  statement: string | null
+  done: boolean
+}
+
+export interface TopicExtrasUi {
+  /** The rules of the tenant's current rules text (a moderator's removal cites one), once read. */
+  rules: CommunityRule[] | null
+  /** The categories a moderator may move the topic into (theirs, but this one), once read. */
+  moveTargets: ForumCategory[] | null
+  dialog: ModeratorDialog | null
+  busy: Record<string, boolean>
+  announcement: TextRef | null
+  announceId: number
+}
+
+export interface TopicController {
+  readonly thread: TopicThreadController
+  readonly follow: FollowController | null
+  readonly extras: TopicExtrasUi
+  start(): Promise<void>
+  /** The viewer moderates the topic's category (kb-api's `viewer.moderator`, me/get's appointments beside it). */
+  isModerator(): boolean
+  /** A moderator's message actions apply (another member's live message). */
+  canModerate(m: DiscussionMessage): boolean
+  setState(state: 'open' | 'locked'): Promise<void>
+  setPinned(pinned: boolean): Promise<void>
+  openDialog(kind: ModeratorDialogKind, seq?: number | null): void
+  closeDialog(): void
+  submitDialog(): Promise<void>
+  dispose(): void
+}
+
+export function createTopicController(o: TopicThreadControllerOptions): TopicController {
+  const { client, lang } = o
+  const conversationId = o.conversationId.toLowerCase()
+  const thread = createTopicThreadController(o)
+  const abort = new AbortController()
+  const call: CommunityCallOptions = { signal: abort.signal }
+  let disposed = false
+  const follow: FollowController | null = createFollow({ client, target: { conversationId }, lang })
+
+  const extras = reactive<TopicExtrasUi>({ rules: null, moveTargets: null, dialog: null, busy: {}, announcement: null, announceId: 0 }) as TopicExtrasUi
+
+  const announce = (text: TextRef): void => {
+    extras.announcement = text
+    extras.announceId += 1
+  }
+
+  const topic = () => thread.state.thread.topic
+
+  // The follow button follows the header: a re-read (another tab, a resync) may change it.
+  let lastFollowing: boolean | null = null
+  const unsubscribe = thread.store.subscribe((s) => {
+    const following = s.topic?.following
+    if (typeof following !== 'boolean' || following === lastFollowing) return
+    if (lastFollowing === null && follow && follow.state.phase === 'idle') void follow.load(following)
+    else follow?.sync(following)
+    lastFollowing = following
+  })
+
+  function isModerator(): boolean {
+    const t = topic()
+    if (!t?.category) return false
+    return thread.state.thread.viewer.moderator === true || (thread.state.me !== null && isCategoryModerator(thread.state.me, t.category.id))
+  }
+
+  const canModerate = (m: DiscussionMessage): boolean =>
+    isModerator() && !thread.isOwn(m) && !m.pending && m.seq > 0 && m.body !== null && m.state !== 'deleted' && m.author.kind === 'member'
+
+  /** A moderator's change answered the topic: the store takes the header; a refusal reads the topic again. */
+  async function topicChange(key: string, run: () => Promise<{ ok: true; value: { topic: Topic } } | CommunityFailure>): Promise<void> {
+    if (extras.busy[key]) return
+    extras.busy[key] = true
+    const r = await run()
+    delete extras.busy[key]
+    if (disposed) return
+    if (r.ok) {
+      thread.store.applyTopic(r.value.topic)
+      announce({ key: 'moderation.done' })
+      return
+    }
+    announce(failureText(r, lang))
+    // The appointment or the topic changed under the page (kb-api's notFound): what is true now.
+    if (r.code === 'notFound') void thread.refresh()
+  }
+
+  async function loadRules(): Promise<void> {
+    if (extras.rules !== null) return
+    const r = await client.legal.current({ kind: 'rules', locale: lang }, call)
+    if (!disposed && r.ok) extras.rules = communityRulesOf(r.value.bodyJson)
+  }
+
+  async function loadMoveTargets(): Promise<void> {
+    if (extras.moveTargets !== null) return
+    const r = await client.forum.categories.list(call)
+    if (disposed || !r.ok) return
+    const here = topic()?.category?.id
+    const me = thread.state.me
+    extras.moveTargets = r.value.categories.filter((c) => c.kind === 'topics' && c.id !== here && me !== null && isCategoryModerator(me, c.id))
+  }
+
+  return {
+    thread,
+    follow,
+    extras,
+    async start() {
+      await thread.start()
+    },
+    isModerator,
+    canModerate,
+    setState: (state) => topicChange(`state:${state}`, () => client.moderation.setTopicState({ conversationId, state }, call)),
+    setPinned: (pinned) => topicChange(`pin:${pinned}`, () => client.moderation.pinTopic({ conversationId, pinned }, call)),
+    openDialog(kind, seq = null) {
+      extras.dialog = { kind, seq, ruleId: '', facts: '', category: '', categoryId: '', sending: false, failure: null, statement: null, done: false }
+      if (kind === 'remove') void loadRules()
+      if (kind === 'move') void loadMoveTargets()
+    },
+    closeDialog() {
+      extras.dialog = null
+    },
+    async submitDialog() {
+      const d = extras.dialog
+      if (!d || d.sending || d.done) return
+      if (d.kind === 'move') {
+        if (d.categoryId === '') return
+        d.sending = true
+        const r = await client.moderation.moveTopic({ conversationId, categoryId: d.categoryId }, call)
+        d.sending = false
+        if (disposed) return
+        if (r.ok) {
+          thread.store.applyTopic(r.value.topic)
+          extras.dialog = null
+          extras.moveTargets = null
+          announce({ key: 'moderation.done' })
+          return
+        }
+        d.failure = r
+        return
+      }
+      const m = d.seq === null ? null : thread.state.thread.messages.flatMap((x) => [x, ...x.replies]).find((x) => x.seq === d.seq)
+      if (!m) return
+      if (d.kind === 'escalate') {
+        if (d.category === '' || !ESCALATION_CATEGORIES.includes(d.category)) return
+        d.sending = true
+        const r = await client.moderation.escalate({ conversationId, seq: m.seq, category: d.category }, call)
+        d.sending = false
+        if (disposed) return
+        if (r.ok) {
+          d.done = true
+          announce({ key: 'moderation.escalated' })
+          return
+        }
+        d.failure = r
+        if (r.code === 'notFound') void thread.refresh()
+        return
+      }
+      // remove: a rule of the current rules text and the facts, as the statement will state them.
+      const facts = normalizeBody(d.facts)
+      if (d.ruleId === '' || facts === '' || codePointLength(facts) > FACTS_MAX) return
+      d.sending = true
+      const r = await client.moderation.remove({ conversationId, seq: m.seq, ruleId: d.ruleId, facts, locale: lang }, call)
+      d.sending = false
+      if (disposed) return
+      if (r.ok) {
+        d.done = true
+        d.statement = r.value.statement
+        announce({ key: 'moderation.removed' })
+        void thread.refresh()
+        return
+      }
+      d.failure = r
+      if (r.code === 'notFound') void thread.refresh()
+    },
+    dispose() {
+      if (disposed) return
+      disposed = true
+      abort.abort()
+      unsubscribe()
+      follow?.dispose()
+      thread.dispose()
+    },
+  }
+}

package/src/element.ts

@@ -11,6 +11,13 @@
  *   <blogmcp-member-settings>      api-base, site-base, lang, sw-path, routes, sign-in-href, nonce              (M2)
  *   <blogmcp-profile>              handle, api-base, site-base, lang, routes, sign-in-href, nonce               (M2)
  *   <blogmcp-welcome>              api-base, site-base, lang, routes, sign-in-href, nonce                       (M2)
+ *   <blogmcp-forum>                api-base, site-base, lang, routes, sign-in-href, nonce                       (M3)
+ *   <blogmcp-forum-category>       slug, api-base, site-base, lang, routes, sign-in-href, nonce                 (M3)
+ *   <blogmcp-topic>                conversation-id, api-base, site-base, lang, routes, sign-in-href, poll-ms,
+ *                                  nonce (+ the `realtime` property, as the discussion's)                      (M3)
+ *   <blogmcp-forum-search>         api-base, site-base, lang, routes, sign-in-href, nonce                       (M3)
+ *   <blogmcp-follow-button>        target-kind, target-id, following, api-base, site-base, lang, nonce          (M3)
+ *   <blogmcp-forum-moderation>     category-id, api-base, site-base, lang, routes, nonce                        (M3)
  *
  * Each carries ONE inline stylesheet in its shadow root, with the CSP nonce honoured: the one given when the
  * elements are defined (the script build passes `document.currentScript.nonce`), else the element's own
@@ -19,11 +26,17 @@
 import { defineCustomElement, type Component } from 'vue'
 import BadgeView from './ui/BadgeView.vue'
 import DiscussionView from './ui/DiscussionView.vue'
+import FollowButtonView from './ui/FollowButtonView.vue'
+import ForumCategoryView from './ui/ForumCategoryView.vue'
+import ForumModerationView from './ui/ForumModerationView.vue'
+import ForumSearchView from './ui/ForumSearchView.vue'
+import ForumView from './ui/ForumView.vue'
 import MemberSettingsView from './ui/MemberSettingsView.vue'
 import MyCommunityView from './ui/MyCommunityView.vue'
 import NoticeFormView from './ui/NoticeFormView.vue'
 import NotificationCentreView from './ui/NotificationCentreView.vue'
 import ProfileView from './ui/ProfileView.vue'
+import TopicView from './ui/TopicView.vue'
 import WelcomeView from './ui/WelcomeView.vue'
 import css from './ui/styles.css?inline'
 
@@ -53,6 +66,13 @@ export const BADGE_ELEMENT_TAG = 'blogmcp-badge'
 export const MEMBER_SETTINGS_ELEMENT_TAG = 'blogmcp-member-settings'
 export const PROFILE_ELEMENT_TAG = 'blogmcp-profile'
 export const WELCOME_ELEMENT_TAG = 'blogmcp-welcome'
+/** M3 (m3-contracts.md §5.3): the forum's elements — they live here, not in the SDK (A33). */
+export const FORUM_ELEMENT_TAG = 'blogmcp-forum'
+export const FORUM_CATEGORY_ELEMENT_TAG = 'blogmcp-forum-category'
+export const TOPIC_ELEMENT_TAG = 'blogmcp-topic'
+export const FORUM_SEARCH_ELEMENT_TAG = 'blogmcp-forum-search'
+export const FOLLOW_BUTTON_ELEMENT_TAG = 'blogmcp-follow-button'
+export const FORUM_MODERATION_ELEMENT_TAG = 'blogmcp-forum-moderation'
 
 export interface DefineCommunityElementOptions {
   /** Another tag name for the element. */
@@ -73,6 +93,12 @@ export interface DefineCommunityElementsOptions {
     memberSettings?: string
     profile?: string
     welcome?: string
+    forum?: string
+    forumCategory?: string
+    topic?: string
+    forumSearch?: string
+    followButton?: string
+    forumModeration?: string
   }
 }
 
@@ -152,7 +178,37 @@ export function defineWelcomeElement(opts: DefineCommunityElementOptions = {}):
   define(opts.tag ?? WELCOME_ELEMENT_TAG, WelcomeView, opts.nonce)
 }
 
-/** Register all eight (once). Browser only. */
+/** M3: register `<blogmcp-forum>` (once). Browser only. */
+export function defineForumElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? FORUM_ELEMENT_TAG, ForumView, opts.nonce)
+}
+
+/** M3: register `<blogmcp-forum-category>` (once). Browser only. */
+export function defineForumCategoryElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? FORUM_CATEGORY_ELEMENT_TAG, ForumCategoryView, opts.nonce)
+}
+
+/** M3: register `<blogmcp-topic>` (once). Browser only. */
+export function defineTopicElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? TOPIC_ELEMENT_TAG, TopicView, opts.nonce)
+}
+
+/** M3: register `<blogmcp-forum-search>` (once). Browser only. */
+export function defineForumSearchElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? FORUM_SEARCH_ELEMENT_TAG, ForumSearchView, opts.nonce)
+}
+
+/** M3: register `<blogmcp-follow-button>` (once). Browser only. */
+export function defineFollowButtonElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? FOLLOW_BUTTON_ELEMENT_TAG, FollowButtonView, opts.nonce)
+}
+
+/** M3: register `<blogmcp-forum-moderation>` (once). Browser only. */
+export function defineForumModerationElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? FORUM_MODERATION_ELEMENT_TAG, ForumModerationView, opts.nonce)
+}
+
+/** Register all fourteen (once). Browser only. */
 export function defineCommunityElements(opts: DefineCommunityElementsOptions = {}): void {
   defineDiscussionElement({ tag: opts.tags?.discussion, nonce: opts.nonce })
   defineNoticeFormElement({ tag: opts.tags?.noticeForm, nonce: opts.nonce })
@@ -162,4 +218,10 @@ export function defineCommunityElements(opts: DefineCommunityElementsOptions = {
   defineMemberSettingsElement({ tag: opts.tags?.memberSettings, nonce: opts.nonce })
   defineProfileElement({ tag: opts.tags?.profile, nonce: opts.nonce })
   defineWelcomeElement({ tag: opts.tags?.welcome, nonce: opts.nonce })
+  defineForumElement({ tag: opts.tags?.forum, nonce: opts.nonce })
+  defineForumCategoryElement({ tag: opts.tags?.forumCategory, nonce: opts.nonce })
+  defineTopicElement({ tag: opts.tags?.topic, nonce: opts.nonce })
+  defineForumSearchElement({ tag: opts.tags?.forumSearch, nonce: opts.nonce })
+  defineFollowButtonElement({ tag: opts.tags?.followButton, nonce: opts.nonce })
+  defineForumModerationElement({ tag: opts.tags?.forumModeration, nonce: opts.nonce })
 }

package/src/global.ts

@@ -1,12 +1,28 @@
 /**
  * The `<script>` build: registers every element — `<blogmcp-discussion>`, `<blogmcp-notice-form>`,
- * `<blogmcp-my-community>` and (M2) `<blogmcp-notification-centre>`, `<blogmcp-badge>`, `<blogmcp-member-settings>`,
- * `<blogmcp-profile>`, `<blogmcp-welcome>` — with the script tag's own CSP nonce, and exposes
- * `window.BlogmcpCommunity`. Live updates are not in it: a site that wants them bundles `@blogmcp/sdk/community/realtime`
- * and sets the discussion's `realtime` property.
+ * `<blogmcp-my-community>`, (M2) `<blogmcp-notification-centre>`, `<blogmcp-badge>`, `<blogmcp-member-settings>`,
+ * `<blogmcp-profile>`, `<blogmcp-welcome>` and (M3) `<blogmcp-forum>`, `<blogmcp-forum-category>`, `<blogmcp-topic>`,
+ * `<blogmcp-forum-search>`, `<blogmcp-follow-button>`, `<blogmcp-forum-moderation>` — with the script tag's own CSP
+ * nonce, and exposes `window.BlogmcpCommunity`. Live updates are not in it: a site that wants them bundles
+ * `@blogmcp/sdk/community/realtime` and sets the discussion's (or the topic's) `realtime` property.
  */
 import { defineCommunityElements } from './element'
-import { mountBadge, mountDiscussion, mountMemberSettings, mountMyCommunity, mountNoticeForm, mountNotificationCentre, mountProfile, mountWelcome } from './mount'
+import {
+  mountBadge,
+  mountDiscussion,
+  mountFollowButton,
+  mountForum,
+  mountForumCategory,
+  mountForumModeration,
+  mountForumSearch,
+  mountMemberSettings,
+  mountMyCommunity,
+  mountNoticeForm,
+  mountNotificationCentre,
+  mountProfile,
+  mountTopic,
+  mountWelcome,
+} from './mount'
 import { VERSION } from './version'
 
 const script = typeof document !== 'undefined' ? (document.currentScript as HTMLScriptElement | null) : null
@@ -22,5 +38,11 @@ export {
   mountMemberSettings,
   mountProfile,
   mountWelcome,
+  mountForum,
+  mountForumCategory,
+  mountTopic,
+  mountForumSearch,
+  mountFollowButton,
+  mountForumModeration,
   VERSION,
 }

package/src/index.ts

@@ -10,6 +10,9 @@
  *   - M2: `<blogmcp-notification-centre>` the notifications, `<blogmcp-badge>` the header's unread count,
  *     `<blogmcp-member-settings>` the switches, push and the digest's unsubscribe, `<blogmcp-profile>` a member's
  *     public profile, `<blogmcp-welcome>` the welcome page; the discussion's `realtime` property (live updates);
+ *   - M3, the forum: `<blogmcp-forum>` its index, `<blogmcp-forum-category slug>` a category, `<blogmcp-topic
+ *     conversation-id>` a topic (the discussion's view, with its `realtime` property), `<blogmcp-forum-search>`,
+ *     `<blogmcp-follow-button target-kind target-id>`, `<blogmcp-forum-moderation>` a category moderator's queue;
  *   - `defineCommunityElements()` and one `define…Element()` each — the custom elements;
  *   - `mountDiscussion(…)`, `mountNoticeForm(…)`, `mountMyCommunity(…)` — mount one from code;
  *   - `@blogmcp/community/vue`, `@blogmcp/community/react` — `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>`;
@@ -25,6 +28,12 @@ export {
   defineMemberSettingsElement,
   defineProfileElement,
   defineWelcomeElement,
+  defineForumElement,
+  defineForumCategoryElement,
+  defineTopicElement,
+  defineForumSearchElement,
+  defineFollowButtonElement,
+  defineForumModerationElement,
   DISCUSSION_ELEMENT_TAG,
   NOTICE_FORM_ELEMENT_TAG,
   MY_COMMUNITY_ELEMENT_TAG,
@@ -33,6 +42,12 @@ export {
   MEMBER_SETTINGS_ELEMENT_TAG,
   PROFILE_ELEMENT_TAG,
   WELCOME_ELEMENT_TAG,
+  FORUM_ELEMENT_TAG,
+  FORUM_CATEGORY_ELEMENT_TAG,
+  TOPIC_ELEMENT_TAG,
+  FORUM_SEARCH_ELEMENT_TAG,
+  FOLLOW_BUTTON_ELEMENT_TAG,
+  FORUM_MODERATION_ELEMENT_TAG,
   type DefineCommunityElementOptions,
   type DefineCommunityElementsOptions,
 } from './element'
@@ -45,6 +60,12 @@ export {
   mountMemberSettings,
   mountProfile,
   mountWelcome,
+  mountForum,
+  mountForumCategory,
+  mountTopic,
+  mountForumSearch,
+  mountFollowButton,
+  mountForumModeration,
   type MountDiscussionOptions,
   type MountNoticeFormOptions,
   type MountMyCommunityOptions,
@@ -53,13 +74,39 @@ export {
   type MountMemberSettingsOptions,
   type MountProfileOptions,
   type MountWelcomeOptions,
+  type MountForumOptions,
+  type MountForumCategoryOptions,
+  type MountTopicOptions,
+  type MountForumSearchOptions,
+  type MountFollowButtonOptions,
+  type MountForumModerationOptions,
 } from './mount'
 export { createNotificationCentre, type NotificationCentreController, type CentreUi } from './core/centre'
 export { createBadge, badgeText, BADGE_INTERVAL_MS, type BadgeController, type BadgeOptions, type BadgeUi } from './core/badge'
 export { createMemberSettings, SETTING_KEYS, type MemberSettingsController, type MemberSettingsOptions, type SettingsUi, type SettingKey } from './core/settings'
 export { createProfile, createWelcome, type ProfileController, type WelcomeController } from './core/profile'
-export type { DiscussionRealtime, DiscussionRealtimeOptions, DiscussionRealtimeSession, DiscussionRealtimeMode } from './core/realtime'
-export { createDiscussionController, type DiscussionController, type DiscussionControllerOptions, type DiscussionUi, type ComposerMode, type Draft } from './core/discussion'
+export type { DiscussionRealtime, DiscussionRealtimeOptions, DiscussionRealtimeSession, DiscussionRealtimeMode, TopicRealtime, TopicRealtimeOptions } from './core/realtime'
+export {
+  createDiscussionController,
+  createTopicThreadController,
+  type DiscussionController,
+  type DiscussionControllerOptions,
+  type DiscussionUi,
+  type ComposerMode,
+  type Draft,
+  type ThreadController,
+  type ThreadState,
+  type ThreadUi,
+  type TopicThreadController,
+  type TopicThreadControllerOptions,
+} from './core/discussion'
+// M3: the forum's brains (framework-free but for Vue's reactivity, as the others), for a host that renders its own view.
+export { createForum, type ForumController, type ForumUi } from './core/forum'
+export { createCategory, type CategoryController, type CategoryUi, type TopicDraft } from './core/forum-category'
+export { createTopicController, type TopicController, type ModeratorDialog } from './core/topic'
+export { createSearch, queryFromHash, searchLink, type SearchController, type SearchUi } from './core/forum-search'
+export { createFollow, type FollowController, type FollowUi } from './core/follow'
+export { createModeration, type ModerationController, type ModerationUi } from './core/moderation'
 export { createNoticeForm, type NoticeFormController, type NoticeFormOptions, type NoticeFormUi } from './core/notice'
 export { createPanel, type PanelController, type PanelOptions, type PanelUi } from './core/panel'
 export { createOnboarding, type OnboardingModel, type OnboardingOptions, type OnboardingStep } from './core/onboarding'