@blogmcp/community 0.2.0 → 0.3.0

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;

package/dist/vue.d.ts

@@ -1,6 +1,7 @@
 /**
- * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>` and (M2) `<KbNotificationCentre>`, `<KbBadge>`,
- * `<KbMemberSettings>`, `<KbProfile>`, `<KbWelcome>` for Vue / Nuxt: each mounts its element on the
+ * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>`, (M2) `<KbNotificationCentre>`, `<KbBadge>`,
+ * `<KbMemberSettings>`, `<KbProfile>`, `<KbWelcome>` and (M3) `<KbForum>`, `<KbForumCategory>`, `<KbTopic>`,
+ * `<KbForumSearch>`, `<KbFollowButton>`, `<KbForumModeration>` for Vue / Nuxt: each mounts its element on the
  * client, 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.
@@ -13,8 +14,8 @@
 import { type PropType } from 'vue';
 import type { CommunityTransport } from '@blogmcp/sdk/community';
 import type { CommunityRoutes } from './core/attrs';
-import type { DiscussionRealtime } from './core/realtime';
-import type { MountBadgeOptions, MountDiscussionOptions, MountMemberSettingsOptions, MountMyCommunityOptions, MountNoticeFormOptions, MountNotificationCentreOptions, MountProfileOptions, MountWelcomeOptions } from './mount';
+import type { DiscussionRealtime, TopicRealtime } from './core/realtime';
+import type { MountBadgeOptions, MountDiscussionOptions, MountFollowButtonOptions, MountForumCategoryOptions, MountForumModerationOptions, MountForumOptions, MountForumSearchOptions, MountMemberSettingsOptions, MountMyCommunityOptions, MountNoticeFormOptions, MountNotificationCentreOptions, MountProfileOptions, MountTopicOptions, MountWelcomeOptions } from './mount';
 export declare const KbDiscussion: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     articleId: {
         type: StringConstructor;
@@ -197,4 +198,162 @@ export declare const KbWelcome: import("vue").DefineComponent<import("vue").Extr
     nonce: StringConstructor;
     transport: PropType<CommunityTransport>;
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions, MountNotificationCentreOptions, MountBadgeOptions, MountMemberSettingsOptions, MountProfileOptions, MountWelcomeOptions, CommunityRoutes, DiscussionRealtime, };
+export declare const KbForum: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbForumCategory: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    slug: {
+        type: StringConstructor;
+        required: true;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    slug: {
+        type: StringConstructor;
+        required: true;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbTopic: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    conversationId: {
+        type: StringConstructor;
+        required: true;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    pollMs: NumberConstructor;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+    /** `createRealtimeSession` of `@blogmcp/sdk/community/realtime`. */
+    realtime: PropType<TopicRealtime>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    conversationId: {
+        type: StringConstructor;
+        required: true;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    pollMs: NumberConstructor;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+    /** `createRealtimeSession` of `@blogmcp/sdk/community/realtime`. */
+    realtime: PropType<TopicRealtime>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbForumSearch: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbFollowButton: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    targetKind: {
+        type: PropType<"conversation" | "category">;
+        required: true;
+    };
+    targetId: {
+        type: StringConstructor;
+        required: true;
+    };
+    following: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    targetKind: {
+        type: PropType<"conversation" | "category">;
+        required: true;
+    };
+    targetId: {
+        type: StringConstructor;
+        required: true;
+    };
+    following: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {
+    following: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbForumModeration: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    categoryId: StringConstructor;
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    categoryId: StringConstructor;
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions, MountNotificationCentreOptions, MountBadgeOptions, MountMemberSettingsOptions, MountProfileOptions, MountWelcomeOptions, MountForumOptions, MountForumCategoryOptions, MountTopicOptions, MountForumSearchOptions, MountFollowButtonOptions, MountForumModerationOptions, CommunityRoutes, DiscussionRealtime, TopicRealtime, };

package/dist/vue.js

@@ -47,7 +47,7 @@ const KbDiscussion = defineComponent({
     return useMount(
       "discussion",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountDiscussion
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountDiscussion
     );
   }
 });
@@ -68,7 +68,7 @@ const KbNoticeForm = defineComponent({
     return useMount(
       "notice-form",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountNoticeForm
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountNoticeForm
     );
   }
 });
@@ -88,7 +88,7 @@ const KbMyCommunity = defineComponent({
     return useMount(
       "my-community",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountMyCommunity
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountMyCommunity
     );
   }
 });
@@ -107,7 +107,7 @@ const KbNotificationCentre = defineComponent({
     return useMount(
       "notification-centre",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountNotificationCentre
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountNotificationCentre
     );
   }
 });
@@ -126,7 +126,7 @@ const KbBadge = defineComponent({
     return useMount(
       "badge",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountBadge
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountBadge
     );
   }
 });
@@ -146,7 +146,7 @@ const KbMemberSettings = defineComponent({
     return useMount(
       "member-settings",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountMemberSettings
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountMemberSettings
     );
   }
 });
@@ -166,7 +166,7 @@ const KbProfile = defineComponent({
     return useMount(
       "profile",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountProfile
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountProfile
     );
   }
 });
@@ -185,17 +185,143 @@ const KbWelcome = defineComponent({
     return useMount(
       "welcome",
       () => defined({ ...props }),
-      async () => (await import("./chunks/mount-WadUnaTa.js").then((n) => n.J)).mountWelcome
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountWelcome
+    );
+  }
+});
+const KbForum = defineComponent({
+  name: "KbForum",
+  props: {
+    apiBase: String,
+    siteBase: String,
+    lang: String,
+    signInHref: String,
+    routes: Object,
+    nonce: String,
+    transport: Function
+  },
+  setup(props) {
+    return useMount(
+      "forum",
+      () => defined({ ...props }),
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForum
+    );
+  }
+});
+const KbForumCategory = defineComponent({
+  name: "KbForumCategory",
+  props: {
+    slug: { type: String, required: true },
+    apiBase: String,
+    siteBase: String,
+    lang: String,
+    signInHref: String,
+    routes: Object,
+    nonce: String,
+    transport: Function
+  },
+  setup(props) {
+    return useMount(
+      "forum-category",
+      () => defined({ ...props }),
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForumCategory
+    );
+  }
+});
+const KbTopic = defineComponent({
+  name: "KbTopic",
+  props: {
+    conversationId: { type: String, required: true },
+    apiBase: String,
+    siteBase: String,
+    lang: String,
+    signInHref: String,
+    routes: Object,
+    pollMs: Number,
+    nonce: String,
+    transport: Function,
+    /** `createRealtimeSession` of `@blogmcp/sdk/community/realtime`. */
+    realtime: Function
+  },
+  setup(props) {
+    return useMount(
+      "topic",
+      () => defined({ ...props }),
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountTopic
+    );
+  }
+});
+const KbForumSearch = defineComponent({
+  name: "KbForumSearch",
+  props: {
+    apiBase: String,
+    siteBase: String,
+    lang: String,
+    signInHref: String,
+    routes: Object,
+    nonce: String,
+    transport: Function
+  },
+  setup(props) {
+    return useMount(
+      "forum-search",
+      () => defined({ ...props }),
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountForumSearch
+    );
+  }
+});
+const KbFollowButton = defineComponent({
+  name: "KbFollowButton",
+  props: {
+    targetKind: { type: String, required: true },
+    targetId: { type: String, required: true },
+    following: { type: Boolean, default: void 0 },
+    apiBase: String,
+    siteBase: String,
+    lang: String,
+    nonce: String,
+    transport: Function
+  },
+  setup(props) {
+    return useMount(
+      "follow-button",
+      () => defined({ ...props }),
+      async () => (await import("./chunks/mount--2_V2q3M.js").then((n) => n.ad)).mountFollowButton
+    );
+  }
+});
+const KbForumModeration = defineComponent({
+  name: "KbForumModeration",
+  props: {
+    categoryId: String,
+    apiBase: String,
+    siteBase: String,
+    lang: String,
+    routes: Object,
+    nonce: String,
+    transport: Function
+  },
+  setup(props) {
+    return useMount(
+      "forum-moderation",
+      () => defined({ ...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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogmcp/community",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Community elements for your own site: the discussion under an article, the DSA notice form and the reader's „My community” panel. Custom elements + Vue/React wrappers + a script build, over @blogmcp/sdk/community.",
   "type": "module",
   "publishConfig": {
@@ -42,8 +42,8 @@
     "postpack": "node ../../scripts/pack-dist-types.mjs postpack"
   },
   "dependencies": {
-    "@blogmcp/sanitize": "^0.10.0",
-    "@blogmcp/sdk": "^0.10.0",
+    "@blogmcp/sanitize": "^0.11.0",
+    "@blogmcp/sdk": "^0.11.0",
     "vue": "^3.5.0"
   },
   "peerDependencies": {

package/src/core/attrs.ts

@@ -50,6 +50,17 @@ export interface CommunityRoutes {
    * message's anchor in the fragment). No default: without it those rows stay unlinked.
    */
   articlePath?: string
+  /** M3 (m3-contracts.md §5.1, D-M3-12): the forum — its categories, their latest topics, the search box. */
+  forumPath?: string
+  /** M3: a category's page; `{slug}` is the category's slug (`/komunita/c/{slug}`) — a template, as profilePath is. */
+  categoryPath?: string
+  /**
+   * M3: a topic's page; `{id}` is its conversation id (`/komunita/t/{id}`) — a template; a message's anchor goes in the
+   * fragment (`#bcm-msg-<seq>`, topicMessageLink).
+   */
+  topicPath?: string
+  /** M3: the forum's search (the forum's search box goes there with the query in the fragment, `#q=…`). */
+  searchPath?: string
 }
 
 const ROUTE_KEYS = [
@@ -65,6 +76,10 @@ const ROUTE_KEYS = [
   'welcomePath',
   'discussionsPath',
   'articlePath',
+  'forumPath',
+  'categoryPath',
+  'topicPath',
+  'searchPath',
 ] as const
 
 /** A path on the host's own site (the SDK's links.ts rule). */
@@ -109,8 +124,8 @@ export function siteBaseOf(value: unknown): string | null {
 }
 
 /**
- * The pages with the managed blog's defaults filled in under the site's base (statementPath and profilePath stay
- * templates; articlePath, a template too, has no default).
+ * The pages with the managed blog's defaults filled in under the site's base (statementPath, profilePath, M3's
+ * categoryPath and topicPath stay templates; articlePath, a template too, has no default).
  * A page the host or the tenant names is its own full path.
  */
 export function routesWithDefaults(
@@ -132,6 +147,11 @@ export function routesWithDefaults(
     welcomePath: routes.welcomePath ?? `${siteBase}${COMMUNITY_ROUTES.welcome}`,
     discussionsPath: routes.discussionsPath ?? `${siteBase}${COMMUNITY_ROUTES.discussions}`,
     articlePath: routes.articlePath ?? null,
+    // M3 (§5.1): the forum's pages — categoryPath and topicPath are templates (`{slug}`, `{id}`).
+    forumPath: routes.forumPath ?? `${siteBase}${COMMUNITY_ROUTES.forum}`,
+    categoryPath: routes.categoryPath ?? `${siteBase}${COMMUNITY_ROUTES.category}`,
+    topicPath: routes.topicPath ?? `${siteBase}${COMMUNITY_ROUTES.topic}`,
+    searchPath: routes.searchPath ?? `${siteBase}${COMMUNITY_ROUTES.search}`,
   }
 }