@blogmcp/community 0.1.0 → 0.3.0

package/dist/mount.d.ts

@@ -7,6 +7,7 @@
  */
 import type { CommunityTransport } from '@blogmcp/sdk/community';
 import type { CommunityRoutes } from './core/attrs';
+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;
@@ -32,6 +33,11 @@ export interface MountDiscussionOptions extends CommonMountOptions {
     signInHref?: string;
     /** Head poll interval in ms (default 20 000; 0 = off). */
     pollMs?: number;
+    /**
+     * M2: live updates — `createRealtimeSession` of `@blogmcp/sdk/community/realtime` (the host imports it; the element
+     * never does). Absent: the head poll.
+     */
+    realtime?: DiscussionRealtime;
 }
 export interface MountNoticeFormOptions extends CommonMountOptions {
     /** What is reported: a message, a member (by id or handle) or an article. */
@@ -56,10 +62,93 @@ export interface MountMyCommunityOptions extends CommonMountOptions {
     /** The site's sign-in page. */
     signInHref?: string;
 }
+export interface MountNotificationCentreOptions extends CommonMountOptions {
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+export interface MountBadgeOptions extends CommonMountOptions {
+    /** The unread count's poll in ms (default 60 000; 0 = once, and when the page is shown again). */
+    pollMs?: number;
+}
+export interface MountMemberSettingsOptions extends CommonMountOptions {
+    /** The host's service worker route (default `<site-base>/sw.js`, served from `@blogmcp/sdk/community/sw`). */
+    swPath?: string;
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+export interface MountProfileOptions extends CommonMountOptions {
+    /** The member's handle. */
+    handle: string;
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+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. */
 export declare function mountNoticeForm(o: MountNoticeFormOptions): () => void;
 /** Mount `<blogmcp-my-community>`; returns the function that removes it. */
 export declare function mountMyCommunity(o?: MountMyCommunityOptions): () => void;
+/** Mount `<blogmcp-notification-centre>`; returns the function that removes it. */
+export declare function mountNotificationCentre(o?: MountNotificationCentreOptions): () => void;
+/** Mount `<blogmcp-badge>`; returns the function that removes it. */
+export declare function mountBadge(o?: MountBadgeOptions): () => void;
+/** Mount `<blogmcp-member-settings>`; returns the function that removes it. */
+export declare function mountMemberSettings(o?: MountMemberSettingsOptions): () => void;
+/** Mount `<blogmcp-profile>`; returns the function that removes it. */
+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,5 +1,7 @@
 /**
- * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>` 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.
@@ -7,11 +9,33 @@
  *   <KbDiscussion articleId={article.id} apiBase="/api/community" signInHref={`/sign-in#${pathname}`} />
  */
 import { type ReactElement } from 'react';
-import type { MountDiscussionOptions, MountMyCommunityOptions, MountNoticeFormOptions } 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'>;
+export type KbNotificationCentreProps = Omit<MountNotificationCentreOptions, 'container'>;
+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;
-export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions };
+export declare function KbNotificationCentre(props: KbNotificationCentreProps): ReactElement;
+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 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,16 +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-DzjwnHyx.js").then((n) => n.l)).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-DzjwnHyx.js").then((n) => n.l)).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-DzjwnHyx.js").then((n) => n.l)).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--2_V2q3M.js").then((n) => n.ad)).mountNotificationCentre);
+}
+function KbBadge(props) {
+  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--2_V2q3M.js").then((n) => n.ad)).mountMemberSettings);
+}
+function KbProfile(props) {
+  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--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
+  KbNoticeForm,
+  KbNotificationCentre,
+  KbProfile,
+  KbTopic,
+  KbWelcome
 };

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

@@ -0,0 +1,13 @@
+import type { CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    /** JSON (or an object): `notificationsPath` (where the badge links). */
+    routes?: string | Record<string, unknown>;
+    /** The poll in ms (default 60 000, never less; 0 = read once and when the page is shown again). */
+    pollMs?: number;
+    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/DiscussionView.vue.d.ts

@@ -1,4 +1,5 @@
 import { type CommunityTransport } from '@blogmcp/sdk/community';
+import type { DiscussionRealtime } from '../core/realtime';
 declare const _default: import("vue").DefineComponent<{
     articleId?: string;
     /** The host's relative base (default `${siteBase}/api/community`). */
@@ -14,6 +15,11 @@ declare const _default: import("vue").DefineComponent<{
     pollMs?: number;
     /** A replacement transport (a property, never an attribute): tests, a signing transport later. */
     transport?: CommunityTransport;
+    /**
+     * M2: live updates — the host's session factory (`createRealtimeSession` of `@blogmcp/sdk/community/realtime`), a
+     * property, never an attribute. Absent: the head poll.
+     */
+    realtime?: DiscussionRealtime;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
     articleId?: string;
     /** The host's relative base (default `${siteBase}/api/community`). */
@@ -29,5 +35,10 @@ declare const _default: import("vue").DefineComponent<{
     pollMs?: number;
     /** A replacement transport (a property, never an attribute): tests, a signing transport later. */
     transport?: CommunityTransport;
+    /**
+     * M2: live updates — the host's session factory (`createRealtimeSession` of `@blogmcp/sdk/community/realtime`), a
+     * property, never an attribute. Absent: the head poll.
+     */
+    realtime?: DiscussionRealtime;
 }> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

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/LinkedText.vue.d.ts

@@ -1,5 +1,6 @@
 type __VLS_Props = {
     text: string | null;
+    profilePath?: string | 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/MemberSettingsView.vue.d.ts

@@ -0,0 +1,13 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    apiBase?: string;
+    siteBase?: string;
+    lang?: string;
+    /** The host's service worker script (default `<site-base>/sw.js`): served from @blogmcp/sdk/community/sw. */
+    swPath?: 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/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,12 +1,18 @@
 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;
     /** The host's rules page. */
     rulesHref?: string;
+    /** M2 T10: the distinct mentions one message may carry; null or absent: no limit known here. */
+    mentionsMax?: number | null;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
     focus: () => void | undefined;

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/NotificationCentreView.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): `statementPath`, `myCommunityPath`, `settingsPath`, `articlePath`, … */
+    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/OnboardingSteps.vue.d.ts

@@ -1,4 +1,4 @@
-import type { OnboardingModel } from '../core/onboarding';
+import { type OnboardingModel } from '../core/onboarding';
 type __VLS_Props = {
     model: OnboardingModel;
     rulesHref: string;

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

@@ -0,0 +1,13 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    /** The member's handle (`jana_n`, an `@` in front is fine). */
+    handle?: 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/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/WelcomeView.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): `rulesPath`, `discussionsPath`, `settingsPath`, `profilePath`. */
+    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/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;

package/dist/ui/discussion-context.d.ts

@@ -1,9 +1,14 @@
-/** What the discussion's components share: the controller, the host's routes, what the reader opened. */
+/**
+ * What the discussion's components share: the controller, the host's routes, what the reader opened — M3: under a
+ * topic too (`<blogmcp-topic>` provides its thread's controller, and the moderator's items of a message's menu).
+ */
 import { type ComputedRef } from 'vue';
-import type { DiscussionController } from '../core/discussion';
+import type { DiscussionMessage } from '@blogmcp/sdk/community';
+import type { ThreadController } from '../core/discussion';
 import type { routesWithDefaults } from '../core/attrs';
+import type { MenuItem } from './types';
 export interface DiscussionContext {
-    ctl: DiscussionController;
+    ctl: ThreadController;
     routes: ComputedRef<ReturnType<typeof routesWithDefaults>>;
     /** Messages of a blocked author the reader opened anyway. */
     opened: Set<number>;
@@ -14,6 +19,9 @@ export interface DiscussionContext {
     /** Where the focus goes when the element it came from is gone (a deleted message). */
     focusHeading(): HTMLElement | null;
     deleteMessage(seq: number): void;
+    /** M3: more items of a message's menu (a category moderator's), and what picking one does. */
+    extraMenu?(m: DiscussionMessage): MenuItem[];
+    onExtraMenu?(id: string, m: DiscussionMessage): void;
 }
 export declare function provideDiscussion(ctx: DiscussionContext): void;
 export declare function useDiscussion(): DiscussionContext;