@blogmcp/community 0.2.0 → 0.3.0

package/dist/element.d.ts

@@ -7,6 +7,13 @@ export declare const BADGE_ELEMENT_TAG = "blogmcp-badge";
 export declare const MEMBER_SETTINGS_ELEMENT_TAG = "blogmcp-member-settings";
 export declare const PROFILE_ELEMENT_TAG = "blogmcp-profile";
 export declare 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 declare const FORUM_ELEMENT_TAG = "blogmcp-forum";
+export declare const FORUM_CATEGORY_ELEMENT_TAG = "blogmcp-forum-category";
+export declare const TOPIC_ELEMENT_TAG = "blogmcp-topic";
+export declare const FORUM_SEARCH_ELEMENT_TAG = "blogmcp-forum-search";
+export declare const FOLLOW_BUTTON_ELEMENT_TAG = "blogmcp-follow-button";
+export declare const FORUM_MODERATION_ELEMENT_TAG = "blogmcp-forum-moderation";
 export interface DefineCommunityElementOptions {
     /** Another tag name for the element. */
     tag?: string;
@@ -25,6 +32,12 @@ export interface DefineCommunityElementsOptions {
         memberSettings?: string;
         profile?: string;
         welcome?: string;
+        forum?: string;
+        forumCategory?: string;
+        topic?: string;
+        forumSearch?: string;
+        followButton?: string;
+        forumModeration?: string;
     };
 }
 /** Register `<blogmcp-discussion>` (once; later calls are no-ops). Browser only. */
@@ -43,5 +56,17 @@ export declare function defineMemberSettingsElement(opts?: DefineCommunityElemen
 export declare function defineProfileElement(opts?: DefineCommunityElementOptions): void;
 /** Register `<blogmcp-welcome>` (once). Browser only. */
 export declare function defineWelcomeElement(opts?: DefineCommunityElementOptions): void;
-/** Register all eight (once). Browser only. */
+/** M3: register `<blogmcp-forum>` (once). Browser only. */
+export declare function defineForumElement(opts?: DefineCommunityElementOptions): void;
+/** M3: register `<blogmcp-forum-category>` (once). Browser only. */
+export declare function defineForumCategoryElement(opts?: DefineCommunityElementOptions): void;
+/** M3: register `<blogmcp-topic>` (once). Browser only. */
+export declare function defineTopicElement(opts?: DefineCommunityElementOptions): void;
+/** M3: register `<blogmcp-forum-search>` (once). Browser only. */
+export declare function defineForumSearchElement(opts?: DefineCommunityElementOptions): void;
+/** M3: register `<blogmcp-follow-button>` (once). Browser only. */
+export declare function defineFollowButtonElement(opts?: DefineCommunityElementOptions): void;
+/** M3: register `<blogmcp-forum-moderation>` (once). Browser only. */
+export declare function defineForumModerationElement(opts?: DefineCommunityElementOptions): void;
+/** Register all fourteen (once). Browser only. */
 export declare function defineCommunityElements(opts?: DefineCommunityElementsOptions): void;

package/dist/global.d.ts

@@ -1,11 +1,12 @@
 /**
  * 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';
-export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, mountNotificationCentre, mountBadge, mountMemberSettings, mountProfile, mountWelcome, VERSION, };
+export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, mountNotificationCentre, mountBadge, mountMemberSettings, mountProfile, mountWelcome, mountForum, mountForumCategory, mountTopic, mountForumSearch, mountFollowButton, mountForumModeration, VERSION, };

package/dist/index.d.ts

@@ -10,19 +10,28 @@
  *   - 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>`;
  *   - `@blogmcp/community/global` — one `<script>` for sites without a bundler.
  */
-export { defineCommunityElements, defineDiscussionElement, defineNoticeFormElement, defineMyCommunityElement, defineNotificationCentreElement, defineBadgeElement, defineMemberSettingsElement, defineProfileElement, defineWelcomeElement, 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, type DefineCommunityElementOptions, type DefineCommunityElementsOptions, } from './element';
-export { mountDiscussion, mountNoticeForm, mountMyCommunity, mountNotificationCentre, mountBadge, mountMemberSettings, mountProfile, mountWelcome, type MountDiscussionOptions, type MountNoticeFormOptions, type MountMyCommunityOptions, type MountNotificationCentreOptions, type MountBadgeOptions, type MountMemberSettingsOptions, type MountProfileOptions, type MountWelcomeOptions, } from './mount';
+export { defineCommunityElements, 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, 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 } 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';
+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';

package/dist/index.js

@@ -1,45 +1,72 @@
-import { H, B, w, I, D, k, M, N, j, P, S, W, v, u, A, x, C, t, F, E, y, z, f, d, a, g, c, b, e, h, i, p, m, q, n, l, o, r, s, G } from "./chunks/mount-WadUnaTa.js";
-const VERSION = "0.2.0";
+import { ab, B, S, ac, D, t, r, F, u, s, q, M, N, p, P, V, T, W, R, Q, a0, Z, a5, $, U, a6, a7, O, a9, a8, X, a2, a1, _, Y, f, d, a, n, k, j, o, m, g, c, b, e, h, l, i, z, v, K, G, H, L, J, A, x, w, y, C, I, E, aa, a3, a4 } from "./chunks/mount--2_V2q3M.js";
+const VERSION = "0.3.0";
 export {
-  H as AVATAR_PRESETS,
+  ab as AVATAR_PRESETS,
   B as BADGE_ELEMENT_TAG,
-  w as BADGE_INTERVAL_MS,
-  I as DEFAULT_API_BASE,
+  S as BADGE_INTERVAL_MS,
+  ac as DEFAULT_API_BASE,
   D as DISCUSSION_ELEMENT_TAG,
-  k as MEMBER_SETTINGS_ELEMENT_TAG,
+  t as FOLLOW_BUTTON_ELEMENT_TAG,
+  r as FORUM_CATEGORY_ELEMENT_TAG,
+  F as FORUM_ELEMENT_TAG,
+  u as FORUM_MODERATION_ELEMENT_TAG,
+  s as FORUM_SEARCH_ELEMENT_TAG,
+  q as MEMBER_SETTINGS_ELEMENT_TAG,
   M as MY_COMMUNITY_ELEMENT_TAG,
   N as NOTICE_FORM_ELEMENT_TAG,
-  j as NOTIFICATION_CENTRE_ELEMENT_TAG,
+  p as NOTIFICATION_CENTRE_ELEMENT_TAG,
   P as PROFILE_ELEMENT_TAG,
-  S as SETTING_KEYS,
+  V as SETTING_KEYS,
+  T as TOPIC_ELEMENT_TAG,
   VERSION,
   W as WELCOME_ELEMENT_TAG,
-  v as badgeText,
-  u as createBadge,
-  A as createDiscussionController,
-  x as createMemberSettings,
-  C as createNoticeForm,
-  t as createNotificationCentre,
-  F as createOnboarding,
-  E as createPanel,
-  y as createProfile,
-  z as createWelcome,
+  R as badgeText,
+  Q as createBadge,
+  a0 as createCategory,
+  Z as createDiscussionController,
+  a5 as createFollow,
+  $ as createForum,
+  U as createMemberSettings,
+  a6 as createModeration,
+  a7 as createNoticeForm,
+  O as createNotificationCentre,
+  a9 as createOnboarding,
+  a8 as createPanel,
+  X as createProfile,
+  a2 as createSearch,
+  a1 as createTopicController,
+  _ as createTopicThreadController,
+  Y as createWelcome,
   f as defineBadgeElement,
   d as defineCommunityElements,
   a as defineDiscussionElement,
+  n as defineFollowButtonElement,
+  k as defineForumCategoryElement,
+  j as defineForumElement,
+  o as defineForumModerationElement,
+  m as defineForumSearchElement,
   g as defineMemberSettingsElement,
   c as defineMyCommunityElement,
   b as defineNoticeFormElement,
   e as defineNotificationCentreElement,
   h as defineProfileElement,
+  l as defineTopicElement,
   i as defineWelcomeElement,
-  p as mountBadge,
-  m as mountDiscussion,
-  q as mountMemberSettings,
-  n as mountMyCommunity,
-  l as mountNoticeForm,
-  o as mountNotificationCentre,
-  r as mountProfile,
-  s as mountWelcome,
-  G as pickLang
+  z as mountBadge,
+  v as mountDiscussion,
+  K as mountFollowButton,
+  G as mountForum,
+  H as mountForumCategory,
+  L as mountForumModeration,
+  J as mountForumSearch,
+  A as mountMemberSettings,
+  x as mountMyCommunity,
+  w as mountNoticeForm,
+  y as mountNotificationCentre,
+  C as mountProfile,
+  I as mountTopic,
+  E as mountWelcome,
+  aa as pickLang,
+  a3 as queryFromHash,
+  a4 as searchLink
 };

package/dist/mount.d.ts

@@ -7,7 +7,7 @@
  */
 import type { CommunityTransport } from '@blogmcp/sdk/community';
 import type { CommunityRoutes } from './core/attrs';
-import type { DiscussionRealtime } from './core/realtime';
+import type { DiscussionRealtime, TopicRealtime } from './core/realtime';
 interface CommonMountOptions {
     /** The host's relative base (default `/api/community` under `siteBase`): its proxy or BFF. Never kb-api's URL. */
     apiBase?: string;
@@ -86,6 +86,43 @@ export interface MountWelcomeOptions extends CommonMountOptions {
     /** The site's sign-in page (a visitor's link in the profile's place). */
     signInHref?: string;
 }
+/** M3 (m3-contracts.md §5.3): the forum's index — its categories, their latest topics, the search box. */
+export interface MountForumOptions extends CommonMountOptions {
+    /** The site's sign-in page (the members-only sentence's link for a visitor). */
+    signInHref?: string;
+}
+/** M3: one category's page — its topics, its follow button, the new-topic composer. */
+export interface MountForumCategoryOptions extends CommonMountOptions {
+    /** The category's slug. */
+    slug: string;
+    signInHref?: string;
+}
+/** M3: one topic's page — the discussion's view over the topic, with its header. */
+export interface MountTopicOptions extends CommonMountOptions {
+    /** The topic's conversation id. */
+    conversationId: string;
+    signInHref?: string;
+    /** Head poll interval in ms (default 20 000; 0 = off). */
+    pollMs?: number;
+    /** Live updates — `createRealtimeSession` of `@blogmcp/sdk/community/realtime` (the host imports it). Absent: the head poll. */
+    realtime?: TopicRealtime;
+}
+/** M3: the forum's search. */
+export interface MountForumSearchOptions extends CommonMountOptions {
+    signInHref?: string;
+}
+/** M3: a follow button — a topic or an article discussion (`conversation`) or a category, by its id. */
+export interface MountFollowButtonOptions extends CommonMountOptions {
+    targetKind: 'conversation' | 'category';
+    targetId: string;
+    /** Whether the member follows it, when the host knows (absent: the member's follows are read). */
+    following?: boolean;
+}
+/** M3: a category moderator's queue (renders nothing for a member who moderates nothing). */
+export interface MountForumModerationOptions extends CommonMountOptions {
+    /** Narrow the queue to one of the moderator's categories. */
+    categoryId?: string;
+}
 /** Mount `<blogmcp-discussion>`; returns the function that removes it. */
 export declare function mountDiscussion(o: MountDiscussionOptions): () => void;
 /** Mount `<blogmcp-notice-form>`; returns the function that removes it. */
@@ -102,4 +139,16 @@ export declare function mountMemberSettings(o?: MountMemberSettingsOptions): ()
 export declare function mountProfile(o: MountProfileOptions): () => void;
 /** Mount `<blogmcp-welcome>`; returns the function that removes it. */
 export declare function mountWelcome(o?: MountWelcomeOptions): () => void;
+/** M3: mount `<blogmcp-forum>`; returns the function that removes it. */
+export declare function mountForum(o?: MountForumOptions): () => void;
+/** M3: mount `<blogmcp-forum-category>`; returns the function that removes it. */
+export declare function mountForumCategory(o: MountForumCategoryOptions): () => void;
+/** M3: mount `<blogmcp-topic>`; returns the function that removes it. */
+export declare function mountTopic(o: MountTopicOptions): () => void;
+/** M3: mount `<blogmcp-forum-search>`; returns the function that removes it. */
+export declare function mountForumSearch(o?: MountForumSearchOptions): () => void;
+/** M3: mount `<blogmcp-follow-button>`; returns the function that removes it. */
+export declare function mountFollowButton(o: MountFollowButtonOptions): () => void;
+/** M3: mount `<blogmcp-forum-moderation>`; returns the function that removes it. */
+export declare function mountForumModeration(o?: MountForumModerationOptions): () => void;
 export {};

package/dist/react.d.ts

@@ -1,6 +1,7 @@
 /**
- * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>` and (M2) `<KbNotificationCentre>`, `<KbBadge>`,
- * `<KbMemberSettings>`, `<KbProfile>`, `<KbWelcome>` for React (18 and 19, Next.js App Router included — this
+ * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>`, (M2) `<KbNotificationCentre>`, `<KbBadge>`,
+ * `<KbMemberSettings>`, `<KbProfile>`, `<KbWelcome>` and (M3) `<KbForum>`, `<KbForumCategory>`, `<KbTopic>`,
+ * `<KbForumSearch>`, `<KbFollowButton>`, `<KbForumModeration>` for React (18 and 19, Next.js App Router included — this
  * module is a client component): each mounts its element after hydration and removes it on unmount. Each
  * renders one empty `<div>` as the mount point — nothing else, on the server or the client — so the element
  * sits where the component does and the page's markup is otherwise the site's alone.
@@ -8,7 +9,7 @@
  *   <KbDiscussion articleId={article.id} apiBase="/api/community" signInHref={`/sign-in#${pathname}`} />
  */
 import { type ReactElement } from 'react';
-import type { MountBadgeOptions, MountDiscussionOptions, MountMemberSettingsOptions, MountMyCommunityOptions, MountNoticeFormOptions, MountNotificationCentreOptions, MountProfileOptions, MountWelcomeOptions } from './mount';
+import type { MountBadgeOptions, MountDiscussionOptions, MountFollowButtonOptions, MountForumCategoryOptions, MountForumModerationOptions, MountForumOptions, MountForumSearchOptions, MountMemberSettingsOptions, MountMyCommunityOptions, MountNoticeFormOptions, MountNotificationCentreOptions, MountProfileOptions, MountTopicOptions, MountWelcomeOptions } from './mount';
 export type KbDiscussionProps = Omit<MountDiscussionOptions, 'container'>;
 export type KbNoticeFormProps = Omit<MountNoticeFormOptions, 'container'>;
 export type KbMyCommunityProps = Omit<MountMyCommunityOptions, 'container'>;
@@ -17,6 +18,12 @@ export type KbBadgeProps = Omit<MountBadgeOptions, 'container'>;
 export type KbMemberSettingsProps = Omit<MountMemberSettingsOptions, 'container'>;
 export type KbProfileProps = Omit<MountProfileOptions, 'container'>;
 export type KbWelcomeProps = Omit<MountWelcomeOptions, 'container'>;
+export type KbForumProps = Omit<MountForumOptions, 'container'>;
+export type KbForumCategoryProps = Omit<MountForumCategoryOptions, 'container'>;
+export type KbTopicProps = Omit<MountTopicOptions, 'container'>;
+export type KbForumSearchProps = Omit<MountForumSearchOptions, 'container'>;
+export type KbFollowButtonProps = Omit<MountFollowButtonOptions, 'container'>;
+export type KbForumModerationProps = Omit<MountForumModerationOptions, 'container'>;
 export declare function KbDiscussion(props: KbDiscussionProps): ReactElement;
 export declare function KbNoticeForm(props: KbNoticeFormProps): ReactElement;
 export declare function KbMyCommunity(props: KbMyCommunityProps): ReactElement;
@@ -25,4 +32,10 @@ export declare function KbBadge(props: KbBadgeProps): ReactElement;
 export declare function KbMemberSettings(props: KbMemberSettingsProps): ReactElement;
 export declare function KbProfile(props: KbProfileProps): ReactElement;
 export declare function KbWelcome(props: KbWelcomeProps): ReactElement;
-export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions, MountNotificationCentreOptions, MountBadgeOptions, MountMemberSettingsOptions, MountProfileOptions, MountWelcomeOptions, };
+export declare function KbForum(props: KbForumProps): ReactElement;
+export declare function KbForumCategory(props: KbForumCategoryProps): ReactElement;
+export declare function KbTopic(props: KbTopicProps): ReactElement;
+export declare function KbForumSearch(props: KbForumSearchProps): ReactElement;
+export declare function KbFollowButton(props: KbFollowButtonProps): ReactElement;
+export declare function KbForumModeration(props: KbForumModerationProps): ReactElement;
+export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions, MountNotificationCentreOptions, MountBadgeOptions, MountMemberSettingsOptions, MountProfileOptions, MountWelcomeOptions, MountForumOptions, MountForumCategoryOptions, MountTopicOptions, MountForumSearchOptions, MountFollowButtonOptions, MountForumModerationOptions, };

package/dist/react.js

@@ -20,36 +20,60 @@ function useMounted(kind, props, load) {
   return createElement("div", { ref: host, "data-blogmcp-community": kind });
 }
 function KbDiscussion(props) {
-  return useMounted("discussion", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountDiscussion);
+  return useMounted("discussion", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountDiscussion);
 }
 function KbNoticeForm(props) {
-  return useMounted("notice-form", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountNoticeForm);
+  return useMounted("notice-form", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountNoticeForm);
 }
 function KbMyCommunity(props) {
-  return useMounted("my-community", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountMyCommunity);
+  return useMounted("my-community", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountMyCommunity);
 }
 function KbNotificationCentre(props) {
-  return useMounted("notification-centre", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountNotificationCentre);
+  return useMounted("notification-centre", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountNotificationCentre);
 }
 function KbBadge(props) {
-  return useMounted("badge", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountBadge);
+  return useMounted("badge", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountBadge);
 }
 function KbMemberSettings(props) {
-  return useMounted("member-settings", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountMemberSettings);
+  return useMounted("member-settings", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountMemberSettings);
 }
 function KbProfile(props) {
-  return useMounted("profile", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountProfile);
+  return useMounted("profile", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountProfile);
 }
 function KbWelcome(props) {
-  return useMounted("welcome", props, async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountWelcome);
+  return useMounted("welcome", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountWelcome);
+}
+function KbForum(props) {
+  return useMounted("forum", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForum);
+}
+function KbForumCategory(props) {
+  return useMounted("forum-category", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForumCategory);
+}
+function KbTopic(props) {
+  return useMounted("topic", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountTopic);
+}
+function KbForumSearch(props) {
+  return useMounted("forum-search", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForumSearch);
+}
+function KbFollowButton(props) {
+  return useMounted("follow-button", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountFollowButton);
+}
+function KbForumModeration(props) {
+  return useMounted("forum-moderation", props, async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForumModeration);
 }
 export {
   KbBadge,
   KbDiscussion,
+  KbFollowButton,
+  KbForum,
+  KbForumCategory,
+  KbForumModeration,
+  KbForumSearch,
   KbMemberSettings,
   KbMyCommunity,
   KbNoticeForm,
   KbNotificationCentre,
   KbProfile,
+  KbTopic,
   KbWelcome
 };

package/dist/ui/FollowButtonView.vue.d.ts

@@ -0,0 +1,17 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    /** `conversation` (a topic, an article discussion) or `category`. */
+    targetKind?: string;
+    /** The conversation's or the category's id. */
+    targetId?: string;
+    /** `true` / `false` when the host knows whether the member follows it (absent: the member's follows are read). */
+    following?: string | boolean;
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    transport?: CommunityTransport;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    following: string | boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/FollowToggle.vue.d.ts

@@ -0,0 +1,6 @@
+import type { FollowController } from '../core/follow';
+type __VLS_Props = {
+    ctl: FollowController;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/ForumCategoryView.vue.d.ts

@@ -0,0 +1,13 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    /** The category's slug (`les-a-sber`). */
+    slug?: string;
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    routes?: string | Record<string, unknown>;
+    signInHref?: string;
+    transport?: CommunityTransport;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/ForumModerationView.vue.d.ts

@@ -0,0 +1,12 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    /** Narrow the queue to one of the moderator's categories (its id). */
+    categoryId?: string;
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    routes?: string | Record<string, unknown>;
+    transport?: CommunityTransport;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/ForumNotices.vue.d.ts

@@ -0,0 +1,7 @@
+import type { MyState } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    me: MyState | null;
+    now?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/ForumSearchView.vue.d.ts

@@ -0,0 +1,11 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    routes?: string | Record<string, unknown>;
+    signInHref?: string;
+    transport?: CommunityTransport;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/ForumView.vue.d.ts

@@ -0,0 +1,12 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    /** JSON (or an object): the host's pages — `forumPath`, `categoryPath`, `topicPath`, `searchPath`, `rulesPath`, … */
+    routes?: string | Record<string, unknown>;
+    signInHref?: string;
+    transport?: CommunityTransport;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/MembersOnly.vue.d.ts

@@ -0,0 +1,15 @@
+import { type CommunityClient, type CommunityFailure } from '@blogmcp/sdk/community';
+import type { Lang } from '../core/i18n';
+type __VLS_Props = {
+    failure: CommunityFailure | null;
+    client: CommunityClient;
+    lang: Lang;
+    signInHref?: string;
+    rulesHref: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    joined: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onJoined?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/MessageComposer.vue.d.ts

@@ -1,7 +1,11 @@
 import type { Draft } from '../core/discussion';
 type __VLS_Props = {
-    draft: Draft;
-    kind: 'new' | 'reply' | 'edit';
+    /** M3: `title` (a string) asks for a topic's title too; null or absent: no title. */
+    draft: Draft & {
+        title?: string | null;
+    };
+    /** M3: `topic` — a new topic (the title and its opening post). */
+    kind: 'new' | 'reply' | 'edit' | 'topic';
     /** Seconds the draft still waits (the controller's clock). */
     wait: number;
     replyingTo?: string | null;

package/dist/ui/MessageMenu.vue.d.ts

@@ -1,6 +1,8 @@
 import type { MenuItem } from './types';
+/** M3: the toggle's own text (a topic's moderator menu); absent: „Další akce". */
 type __VLS_Props = {
     items: MenuItem[];
+    label?: string;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     select: (id: string) => any;

package/dist/ui/ModeratorDialog.vue.d.ts

@@ -0,0 +1,11 @@
+import type { TopicController } from '../core/topic';
+type __VLS_Props = {
+    ctl: TopicController;
+    fallbackFocus?: () => HTMLElement | null;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/TopicRow.vue.d.ts

@@ -0,0 +1,10 @@
+import { type KnownTopicItem } from '@blogmcp/sdk/community';
+import type { FollowController } from '../core/follow';
+type __VLS_Props = {
+    item: KnownTopicItem;
+    topicHref: string;
+    articleHref?: string | null;
+    follow?: FollowController | null;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/TopicView.vue.d.ts

@@ -0,0 +1,32 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+import type { TopicRealtime } from '../core/realtime';
+declare const _default: import("vue").DefineComponent<{
+    /** The topic's conversation id. */
+    conversationId?: string;
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    signInHref?: string;
+    /** JSON (or an object): the host's pages — `forumPath`, `categoryPath`, `topicPath`, `rulesPath`, `myCommunityPath`, … */
+    routes?: string | Record<string, unknown>;
+    /** Head poll interval in ms (default 20 000; 0 = off). */
+    pollMs?: number;
+    transport?: CommunityTransport;
+    /** Live updates — `createRealtimeSession` of `@blogmcp/sdk/community/realtime`, a property. Absent: the head poll. */
+    realtime?: TopicRealtime;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    /** The topic's conversation id. */
+    conversationId?: string;
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    signInHref?: string;
+    /** JSON (or an object): the host's pages — `forumPath`, `categoryPath`, `topicPath`, `rulesPath`, `myCommunityPath`, … */
+    routes?: string | Record<string, unknown>;
+    /** Head poll interval in ms (default 20 000; 0 = off). */
+    pollMs?: number;
+    transport?: CommunityTransport;
+    /** Live updates — `createRealtimeSession` of `@blogmcp/sdk/community/realtime`, a property. Absent: the head poll. */
+    realtime?: TopicRealtime;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/context.d.ts

@@ -3,6 +3,7 @@
  * `communityMessage` and nothing else), ids unique to the element, and the dialog's focus handling.
  */
 import { type Ref } from 'vue';
+import { type CommunityMessageKey } from '@blogmcp/sdk/community';
 import type { Lang, TextRef, Translate } from '../core/i18n';
 export interface TextContext {
     lang: Ref<Lang>;
@@ -10,7 +11,12 @@ export interface TextContext {
     /** A TextRef (a controller's outcome) as text. */
     text(ref: TextRef | null | undefined): string;
 }
-export declare function provideText(lang: Ref<Lang>): TextContext;
+/**
+ * The element's texts. `words` (M3) maps a key the shared components name to another key of the catalogue — a topic's
+ * thread reads the discussion's components with the forum's words (`composer.label` → `forumText.composer.label`, a
+ * post, not a comment) — and a plural key maps by its name without the suffix.
+ */
+export declare function provideText(lang: Ref<Lang>, words?: Readonly<Partial<Record<CommunityMessageKey, CommunityMessageKey>>>): TextContext;
 export declare function useText(): TextContext;
 /** An id unique on the page (ids live in each element's shadow root, but the labels reference them). */
 export declare function uid(prefix: string): string;