@blogmcp/community 0.1.0 → 0.3.0

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

@@ -1,19 +1,43 @@
 /// <reference path="./shims.d.ts" />
 /**
- * The three custom elements (Vue inside a shadow root each), m1-contracts.md §10.4:
+ * The custom elements (Vue inside a shadow root each), m1-contracts.md §10.4 and m2-contracts.md §3.10:
  *
- *   <blogmcp-discussion>    article-id, api-base, site-base, lang, sign-in-href, routes, poll-ms, nonce
- *   <blogmcp-notice-form>   api-base, site-base, lang, turnstile-site-key, target | article-id, routes, nonce
- *   <blogmcp-my-community>  api-base, site-base, lang, decision-id, routes, sign-in-href, nonce
+ *   <blogmcp-discussion>           article-id, api-base, site-base, lang, sign-in-href, routes, poll-ms, nonce
+ *                                  (+ the `realtime` property: a session factory the host passes, M2)
+ *   <blogmcp-notice-form>          api-base, site-base, lang, turnstile-site-key, target | article-id, routes, nonce
+ *   <blogmcp-my-community>         api-base, site-base, lang, decision-id, routes, sign-in-href, nonce
+ *   <blogmcp-notification-centre>  api-base, site-base, lang, routes, sign-in-href, nonce                       (M2)
+ *   <blogmcp-badge>                api-base, site-base, lang, routes, poll-ms, nonce                            (M2)
+ *   <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
  * `nonce` — read from the property, because a page with a CSP hides the attribute once it is connected.
  */
 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'
 
 /**
@@ -36,6 +60,19 @@ function ensureVueFeatureFlags(): void {
 export const DISCUSSION_ELEMENT_TAG = 'blogmcp-discussion'
 export const NOTICE_FORM_ELEMENT_TAG = 'blogmcp-notice-form'
 export const MY_COMMUNITY_ELEMENT_TAG = 'blogmcp-my-community'
+/** M2 (m2-contracts.md §3.10). */
+export const NOTIFICATION_CENTRE_ELEMENT_TAG = 'blogmcp-notification-centre'
+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. */
@@ -47,7 +84,22 @@ export interface DefineCommunityElementOptions {
 export interface DefineCommunityElementsOptions {
   /** CSP nonce for the elements' `<style>`. */
   nonce?: string
-  tags?: { discussion?: string; noticeForm?: string; myCommunity?: string }
+  tags?: {
+    discussion?: string
+    noticeForm?: string
+    myCommunity?: string
+    notificationCentre?: string
+    badge?: string
+    memberSettings?: string
+    profile?: string
+    welcome?: string
+    forum?: string
+    forumCategory?: string
+    topic?: string
+    forumSearch?: string
+    followButton?: string
+    forumModeration?: string
+  }
 }
 
 /** The element's own nonce: the property (a CSP hides the attribute once connected), else the attribute. */
@@ -101,9 +153,75 @@ export function defineMyCommunityElement(opts: DefineCommunityElementOptions = {
   define(opts.tag ?? MY_COMMUNITY_ELEMENT_TAG, MyCommunityView, opts.nonce)
 }
 
-/** Register all three (once). Browser only. */
+/** Register `<blogmcp-notification-centre>` (once). Browser only. */
+export function defineNotificationCentreElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? NOTIFICATION_CENTRE_ELEMENT_TAG, NotificationCentreView, opts.nonce)
+}
+
+/** Register `<blogmcp-badge>` (once). Browser only. */
+export function defineBadgeElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? BADGE_ELEMENT_TAG, BadgeView, opts.nonce)
+}
+
+/** Register `<blogmcp-member-settings>` (once). Browser only. */
+export function defineMemberSettingsElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? MEMBER_SETTINGS_ELEMENT_TAG, MemberSettingsView, opts.nonce)
+}
+
+/** Register `<blogmcp-profile>` (once). Browser only. */
+export function defineProfileElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? PROFILE_ELEMENT_TAG, ProfileView, opts.nonce)
+}
+
+/** Register `<blogmcp-welcome>` (once). Browser only. */
+export function defineWelcomeElement(opts: DefineCommunityElementOptions = {}): void {
+  define(opts.tag ?? WELCOME_ELEMENT_TAG, WelcomeView, opts.nonce)
+}
+
+/** 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 })
   defineMyCommunityElement({ tag: opts.tags?.myCommunity, nonce: opts.nonce })
+  defineNotificationCentreElement({ tag: opts.tags?.notificationCentre, nonce: opts.nonce })
+  defineBadgeElement({ tag: opts.tags?.badge, nonce: opts.nonce })
+  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,48 @@
 /**
- * The `<script>` build: registers `<blogmcp-discussion>`, `<blogmcp-notice-form>` and `<blogmcp-my-community>`
- * with the script tag's own CSP nonce, and exposes `window.BlogmcpCommunity`.
+ * The `<script>` build: registers every element — `<blogmcp-discussion>`, `<blogmcp-notice-form>`,
+ * `<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 { mountDiscussion, mountMyCommunity, mountNoticeForm } 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
 defineCommunityElements({ nonce: script?.nonce || undefined })
 
-export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, VERSION }
+export {
+  defineCommunityElements,
+  mountDiscussion,
+  mountMyCommunity,
+  mountNoticeForm,
+  mountNotificationCentre,
+  mountBadge,
+  mountMemberSettings,
+  mountProfile,
+  mountWelcome,
+  mountForum,
+  mountForumCategory,
+  mountTopic,
+  mountForumSearch,
+  mountFollowButton,
+  mountForumModeration,
+  VERSION,
+}

package/src/index.ts

@@ -7,6 +7,12 @@
  *   - `<blogmcp-discussion>`   the discussion under an article;
  *   - `<blogmcp-notice-form>`  the DSA notice form, for anyone;
  *   - `<blogmcp-my-community>` the reader's „Moje komunita", a statement page, a notifier's status page;
+ *   - 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>`;
@@ -17,14 +23,90 @@ export {
   defineDiscussionElement,
   defineNoticeFormElement,
   defineMyCommunityElement,
+  defineNotificationCentreElement,
+  defineBadgeElement,
+  defineMemberSettingsElement,
+  defineProfileElement,
+  defineWelcomeElement,
+  defineForumElement,
+  defineForumCategoryElement,
+  defineTopicElement,
+  defineForumSearchElement,
+  defineFollowButtonElement,
+  defineForumModerationElement,
   DISCUSSION_ELEMENT_TAG,
   NOTICE_FORM_ELEMENT_TAG,
   MY_COMMUNITY_ELEMENT_TAG,
+  NOTIFICATION_CENTRE_ELEMENT_TAG,
+  BADGE_ELEMENT_TAG,
+  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'
-export { mountDiscussion, mountNoticeForm, mountMyCommunity, type MountDiscussionOptions, type MountNoticeFormOptions, type MountMyCommunityOptions } from './mount'
-export { createDiscussionController, type DiscussionController, type DiscussionControllerOptions, type DiscussionUi, type ComposerMode, type Draft } from './core/discussion'
+export {
+  mountDiscussion,
+  mountNoticeForm,
+  mountMyCommunity,
+  mountNotificationCentre,
+  mountBadge,
+  mountMemberSettings,
+  mountProfile,
+  mountWelcome,
+  mountForum,
+  mountForumCategory,
+  mountTopic,
+  mountForumSearch,
+  mountFollowButton,
+  mountForumModeration,
+  type MountDiscussionOptions,
+  type MountNoticeFormOptions,
+  type MountMyCommunityOptions,
+  type MountNotificationCentreOptions,
+  type MountBadgeOptions,
+  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, 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'