@blogmcp/community 0.1.0 → 0.3.0

package/dist/core/onboarding.d.ts

@@ -1,7 +1,15 @@
-import { type AgeBand, type CommunityClient, type CommunityFailure, type CommunityRule, type CurrentLegalText, type MyState } from '@blogmcp/sdk/community';
-import type { Lang } from './i18n';
+import { type AgeBand, type Art9ConsentLayout, type Art9Refusal, type CommunityClient, type CommunityFailure, type CommunityRule, type CurrentLegalText, type MyState } from '@blogmcp/sdk/community';
+import type { Lang, TextRef } from './i18n';
 export type OnboardingStep = 'age' | 'rules' | 'art9' | 'profile';
 export type OnboardingPhase = 'loading' | 'ready' | 'sending' | 'done' | 'failed' | 'refused';
+/** One consent of the art. 9 step: a controller the text names (or the tenant, when it names none) and its tick. */
+export interface Art9Consent {
+    /** The controller's registry ref from the text's `bodyJson`; empty for the tenant of a text that names none. */
+    readonly entity: string;
+    /** The name the reader sees; empty for the tenant of a text that names none (the step's own sentence then). */
+    readonly label: string;
+    accepted: boolean;
+}
 export interface OnboardingState {
     /** `refused`: the age band is below the minimum — nothing was stored, the reader may go on reading. */
     phase: OnboardingPhase;
@@ -12,10 +20,24 @@ export interface OnboardingState {
     rules: CommunityRule[];
     art9Text: CurrentLegalText | null;
     art9Paragraphs: string[];
+    /** me/get's `settings.art9ConsentLayout` (absent: `joint`). */
+    art9Layout: Art9ConsentLayout;
+    /** me/get's `settings.art9Refusal` (absent: `read_only`). */
+    art9Refusal: Art9Refusal;
+    /**
+     * The consents the step asks for, each ticked on its own: one under `joint` (or a text naming fewer than two
+     * controllers), the text's two controllers under `split`. Empty while there is no art. 9 text.
+     */
+    art9Controllers: Art9Consent[];
+    /** The reader chose „Nesouhlasím" (only where the refusal is offered). */
+    art9Refused: boolean;
+    /** The me/onboard kb-api took carried the refusal (the done note says what it leaves). */
+    art9RefusedSent: boolean;
     /** The member accepted an older rules text; this one asks again. */
     reconsent: boolean;
     ageBand: AgeBand | null;
     rulesAccepted: boolean;
+    /** Every consent of the step ticked (setting it ticks or unticks them all). */
     art9Accepted: boolean;
     displayName: string;
     handle: string;
@@ -37,6 +59,15 @@ export interface OnboardingModel {
     back(): void;
     suggestedHandle(): string | null;
     hasFieldError(field: string): boolean;
+    /**
+     * The tenant takes a refusal of the art. 9 consent here (`art9Refusal = public_write`, not the give-consent flow): the
+     * step's lede then does not make writing depend on the consent (community.md §9.8 q8, art. 9(2)(a) — freely given).
+     */
+    refusalOffered(): boolean;
+    /** The art. 9 step offers „Nesouhlasím" (`art9Refusal = public_write`, never in the give-consent flow). */
+    canRefuse(): boolean;
+    /** „Nesouhlasím": the step is answered without the consent; the next step, or — on the last one — `me/onboard`. */
+    refuse(): Promise<void>;
 }
 export interface OnboardingOptions {
     client: Pick<CommunityClient, 'me' | 'legal'>;
@@ -47,6 +78,22 @@ export interface OnboardingOptions {
     onSignIn(): void;
     /** The age band was below the tenant's minimum (AGE_BELOW_MINIMUM): kb-api kept nothing, the element keeps this. */
     onRefused?(minAge: number): void;
+    /**
+     * The give-consent flow („Moje komunita", M2 T9): the art. 9 step is asked also when `needs` does not name it — a
+     * member who refused it, or has not given it, where the tenant asks for it — and no refusal is offered.
+     */
+    offerArt9?: boolean;
+    /**
+     * M3 (m3-contracts.md §3.1 step 5, U14): a forum write needs the art. 9 consent whatever the tenant's
+     * `require_art9_consent` says, so the step is asked whenever the consent is not in force — me/get names no
+     * `art9_consent` need (and may report the consent as null) where the tenant does not ask for it elsewhere. A refusal
+     * is offered as for the discussion (`art9Refusal = public_write`), and a member who refused there is not asked again.
+     */
+    forceArt9?: boolean;
     signal?: AbortSignal;
 }
+/** kb-api's issue code for a refusal the tenant does not take (`art9Refusal = read_only`, §3.8). */
+export declare const ART9_REFUSAL_READ_ONLY = "art9_refusal_read_only";
+/** The sentence a refusal of the onboarding shows: a refused refusal says the consent is needed to write. */
+export declare function onboardingFailureText(failure: Pick<CommunityFailure, 'code' | 'until' | 'fields' | 'issueCodes'>, lang: Lang): TextRef;
 export declare function createOnboarding(o: OnboardingOptions): OnboardingModel;

package/dist/core/outcomes.d.ts

@@ -20,7 +20,8 @@ export declare const COUNTDOWN_MAX_S = 120;
  *   - `onboard`  the inline onboarding opens (ONBOARDING_REQUIRED);
  *   - `reload`   the discussion is read again (the viewer's state changed: a sanction, a session);
  *   - `notMoved` the discussion does not take writes yet: one sentence instead of the composer;
- *   - `hide`     discussions are switched off: the element renders nothing;
+ *   - `hide`     discussions are switched off: the element renders nothing (`realtimeOff`: only live updates are —
+ *                the element keeps polling and never hides the discussion for it);
  *   - `retry`    nothing was decided (no answer, the ledger): the same write may go again as it is;
  *   - `show`     anything else: the sentence, the text stays for the author to change.
  */

package/dist/core/panel.d.ts

@@ -1,5 +1,16 @@
+/**
+ * `<blogmcp-my-community>`'s brain (m1-contracts.md §7.4, §8.3, §10.4; community.md §5): the reader's
+ * „Moje komunita" — the statements of reasons about their content (the art. 17(3) fields, the appeal within
+ * its window, an open appeal's state), their reports, their notifications, the art. 9 consent's withdrawal (and,
+ * M2 T9, a refused one given after all — the onboarding's art. 9 step, opened here), their blocks, the export (a JSON download) and the profile's deletion with its grace and cancel.
+ *
+ * With a decision id it shows that one statement (the host's statement page). With a notifier's receipt it
+ * shows that notice's status and appeal — `notices/status`, `notices/appeal`: no session needed for that.
+ */
+import { type ShallowRef } from 'vue';
 import { type AppealItem, type BlockEntry, type CommunityClient, type CommunityFailure, type DecisionSummary, type MemberExport, type MyState, type NoticeStatus, type NotificationItem, type ReportItem, type Statement } from '@blogmcp/sdk/community';
-import type { TextRef } from './i18n';
+import { type TextRef } from './i18n';
+import { type OnboardingModel } from './onboarding';
 export type LoadPhase = 'idle' | 'loading' | 'ready' | 'failed';
 export interface AppealDraft {
     body: string;
@@ -48,6 +59,8 @@ export interface PanelUi {
 }
 export interface PanelController {
     readonly state: PanelUi;
+    /** The give-consent flow (the onboarding's art. 9 step), while it is open. */
+    readonly consent: ShallowRef<OnboardingModel | null>;
     /** The member's sections (me/get and the lists). */
     loadMember(): Promise<void>;
     loadStatement(decisionId: string): Promise<void>;
@@ -59,6 +72,9 @@ export interface PanelController {
     fileNoticeAppeal(): Promise<void>;
     withdrawNoticeAppeal(): Promise<void>;
     withdrawConsent(): Promise<boolean>;
+    /** A refused art. 9 consent (`acceptances.art9Refused`): opens its step to give it after all. */
+    giveConsent(): void;
+    closeConsent(): void;
     unblock(memberId: string): Promise<void>;
     editProfile(): void;
     cancelProfile(): void;

package/dist/core/profile.d.ts

@@ -0,0 +1,45 @@
+import { type CommunityClient, type CommunityFailure, type CommunityMessageKey, type CommunityRule, type ForumCategoryRef, type KnownAuthor } from '@blogmcp/sdk/community';
+export type LoadPhase = 'idle' | 'loading' | 'ready' | 'failed' | 'signIn' | 'notFound';
+export interface ProfileUi {
+    phase: LoadPhase;
+    failure: CommunityFailure | null;
+    author: KnownAuthor | null;
+    memberSince: string | null;
+    bio: string | null;
+    /** The trust level's catalogue key (`trust.<n>`), or null for a label this SDK does not know. */
+    trustKey: CommunityMessageKey | null;
+    /**
+     * M3 (m3-contracts.md §3.5, §4.5; D-M3-7): the categories the member moderates now — „Moderátor" names this
+     * appointment on the profile, never a trust level; kb-api sends it to a forum member only (else none).
+     */
+    moderates: ForumCategoryRef[];
+}
+export interface ProfileController {
+    readonly state: ProfileUi;
+    load(handle: string): Promise<void>;
+    dispose(): void;
+}
+/** A handle as an attribute may give it (`@jana_n`, `Jana_N`): lower case, without the `@`; null for none. */
+export declare function handleOf(value: unknown): string | null;
+export declare function createProfile(o: {
+    client: CommunityClient;
+}): ProfileController;
+export interface WelcomeUi {
+    phase: 'idle' | 'loading' | 'ready';
+    rules: CommunityRule[];
+    /** The rules could not be read: the page still links them. */
+    rulesFailed: boolean;
+    /** The signed-in member's handle (the profile link), or null for a visitor and a reader who never joined. */
+    handle: string | null;
+    /** Nobody is signed in: the sign-in link takes the profile link's place. */
+    visitor: boolean;
+}
+export interface WelcomeController {
+    readonly state: WelcomeUi;
+    load(): Promise<void>;
+    dispose(): void;
+}
+export declare function createWelcome(o: {
+    client: CommunityClient;
+    lang: string;
+}): WelcomeController;

package/dist/core/push.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The browser's half of web push (m2-contracts.md §3.4): the one module of the elements that touches the service
+ * worker and the PushManager (test/closed-paths.spec.ts lets `serviceWorker` appear here and nowhere else).
+ *
+ * The worker is registered only from `<blogmcp-member-settings>`, on the member's click („Zapnout upozornění"),
+ * never on page load; the worker's script is the host's route (`sw-path`, default `<site-base>/sw.js`, served from
+ * `@blogmcp/sdk/community/sw`). The subscription's keys go to kb-api through the SDK client only.
+ *
+ * Feature checks read the browser's globals on call (never on import), so a server render and a test can swap them.
+ */
+import { type PushUserAgentClass } from '@blogmcp/sdk/community';
+/** What the browser can do about push, in the order the settings element asks. */
+export type PushSupport = 
+/** Facebook's or Instagram's in-app browser: „Otevřít v prohlížeči" with the page's URL instead. */
+'inApp'
+/** iOS outside an installed web app (`navigator.standalone !== true`): the install guide instead. */
+ | 'iosInstall'
+/** No service worker, PushManager or Notification: one sentence. */
+ | 'unsupported' | 'supported';
+/** The navigator as far as push reads it (Safari's `standalone` included). */
+interface PushNavigator {
+    readonly userAgent?: string;
+    readonly platform?: string;
+    readonly maxTouchPoints?: number;
+    readonly standalone?: boolean;
+    readonly serviceWorker?: ServiceWorkerContainer;
+}
+/**
+ * iOS (an iPhone, an iPod, an iPad — which reports itself as a Mac with a touch screen): its browsers take web push
+ * only from a website installed to the home screen. A layout hint, never sent anywhere but as `userAgentClass`.
+ */
+export declare function isIos(n?: PushNavigator | null): boolean;
+/** What `me/push/subscribe` is told this browser is (a class, never the user agent itself). */
+export declare function userAgentClass(n?: PushNavigator | null): PushUserAgentClass;
+/** What this browser can do about push (the in-app browser first, then iOS outside the home screen). */
+export declare function pushSupport(): PushSupport;
+/** The browser's notification permission (`default` where there is no Notification API). */
+export declare function notificationPermission(): NotificationPermission;
+/** Ask for the permission (only on the member's click); `denied` where it cannot be asked. */
+export declare function requestNotificationPermission(): Promise<NotificationPermission>;
+/** The worker's registration for this page (null where none is registered or it cannot be asked). */
+export declare function currentRegistration(): Promise<ServiceWorkerRegistration | null>;
+/** Register the host's worker script (the member's click). Throws what the browser throws. */
+export declare function registerWorker(swPath: string): Promise<ServiceWorkerRegistration>;
+/** The browser's current subscription of a registration, or null. */
+export declare function currentSubscription(reg: ServiceWorkerRegistration | null): Promise<PushSubscription | null>;
+/** base64url (the VAPID public key `me/push/vapid` sends) → the bytes `applicationServerKey` takes; null when malformed. */
+export declare function base64UrlBytes(value: string): Uint8Array | null;
+/** A subscription as `me/push/subscribe` takes it (`toJSON()`'s endpoint and keys), or null when one is missing. */
+export declare function subscriptionInput(sub: PushSubscription): {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+} | null;
+export interface StoredPush {
+    readonly memberId: string;
+    readonly keyId: string;
+}
+export declare function storedPush(): StoredPush | null;
+export declare function storePush(value: StoredPush | null): void;
+export {};

package/dist/core/realtime.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The discussion's live updates (m2-contracts.md §3.5, §3.10): `<blogmcp-discussion>` (and M3 `<blogmcp-topic>`) takes a
+ * `realtime` PROPERTY —
+ * the session factory of `@blogmcp/sdk/community/realtime`, which the HOST imports and passes:
+ *
+ *   import { createRealtimeSession } from '@blogmcp/sdk/community/realtime'
+ *   mountDiscussion({ articleId, realtime: createRealtimeSession })   // or el.realtime = createRealtimeSession
+ *
+ * The element calls it with its own client and discussion store after the first `discussions/list`, and `stop()`s
+ * the session when it unmounts. The element never imports the realtime entry (nor `centrifuge`): a site that passes no
+ * factory ships no socket code, and the discussion polls (`pollDiscussionHead`) as before.
+ *
+ * The types here are the factory's shape as far as the element uses it, so `createRealtimeSession` fits as it is.
+ */
+import type { CommunityClient, DiscussionStore, TopicStore } from '@blogmcp/sdk/community';
+/** `connecting`, `live`, `polling` (live updates are off or the server cut the socket for good), `stopped`. */
+export type DiscussionRealtimeMode = 'connecting' | 'live' | 'polling' | 'stopped' | (string & {});
+/** What the element calls the factory with. */
+export interface DiscussionRealtimeOptions {
+    client: CommunityClient;
+    store: DiscussionStore;
+    /** The discussion's language, for the session's re-reads. */
+    languageCode: string;
+    /** Whether the discussion is seen now (the fallback polls only then). */
+    visible: () => boolean;
+    /** The element's poll interval, for the session's fallback poller (absent: the SDK's default). */
+    pollIntervalMs?: number;
+    onMode: (mode: DiscussionRealtimeMode) => void;
+}
+/** A running session, as far as the element uses it. */
+export interface DiscussionRealtimeSession {
+    readonly mode: DiscussionRealtimeMode;
+    stop(): void;
+}
+/** `createRealtimeSession` of `@blogmcp/sdk/community/realtime`, or any function of its shape. */
+export type DiscussionRealtime = (options: DiscussionRealtimeOptions) => DiscussionRealtimeSession;
+/**
+ * M3 (m3-contracts.md §3.5, §5.3): what `<blogmcp-topic>` calls the same factory with — the topic's store
+ * (`createTopicStore`) in place of a discussion's; `createRealtimeSession` takes both, re-reads a topic with
+ * `forum/topics/get` and falls back to `forum/topics/head`.
+ */
+export interface TopicRealtimeOptions extends Omit<DiscussionRealtimeOptions, 'store'> {
+    store: TopicStore;
+}
+/** `createRealtimeSession`, as `<blogmcp-topic>`'s `realtime` property takes it. */
+export type TopicRealtime = (options: TopicRealtimeOptions) => DiscussionRealtimeSession;

package/dist/core/settings.d.ts

@@ -0,0 +1,53 @@
+import { type CommunityClient, type CommunityFailure, type MemberSettings, type ModuleInfo } from '@blogmcp/sdk/community';
+import type { TextRef } from './i18n';
+import { type PushSupport } from './push';
+/** The six switches, in the order the page shows them. */
+export declare const SETTING_KEYS: readonly ["notifyReply", "notifyMention", "notifyTopic", "pushEnabled", "digestEmail", "quietHours"];
+export type SettingKey = (typeof SETTING_KEYS)[number];
+export type SettingsPhase = 'idle' | 'loading' | 'ready' | 'failed' | 'signIn';
+/** This browser's push: off, on, or on its way (`busy`), and what the page tells the member about it. */
+export interface PushUi {
+    support: PushSupport;
+    /** `checking` until the browser's own subscription was looked at. */
+    status: 'checking' | 'off' | 'on' | 'busy';
+    /** `denied` the browser's permission; `refused` kb-api's (pushRefused); `reset` switch it on again. */
+    note: 'denied' | 'refused' | 'reset' | null;
+    failure: CommunityFailure | null;
+}
+export interface DigestUi {
+    /** An unsubscribe link brought the member here: the button is offered. */
+    offered: boolean;
+    sending: boolean;
+    outcome: 'unsubscribed' | 'staleLink' | null;
+    failure: CommunityFailure | null;
+}
+export interface SettingsUi {
+    phase: SettingsPhase;
+    failure: CommunityFailure | null;
+    module: ModuleInfo | null;
+    settings: MemberSettings | null;
+    saving: Partial<Record<SettingKey, boolean>>;
+    push: PushUi;
+    digest: DigestUi;
+    announcement: TextRef | null;
+    announceId: number;
+}
+export interface MemberSettingsController {
+    readonly state: SettingsUi;
+    load(): Promise<void>;
+    toggle(key: SettingKey, value: boolean): Promise<void>;
+    /** Whether this browser's push block is shown (the module's feature; never for a visitor). */
+    pushShown(): boolean;
+    enablePush(): Promise<void>;
+    disablePush(): Promise<void>;
+    unsubscribeDigest(): Promise<void>;
+    dispose(): void;
+}
+export interface MemberSettingsOptions {
+    client: CommunityClient;
+    /** The host's worker script (`<site-base>/sw.js`). */
+    swPath: string;
+    /** The digest's unsubscribe token this page's address carried (read and cleared by the element), or null. */
+    digestToken: string | null;
+}
+export declare function createMemberSettings(o: MemberSettingsOptions): MemberSettingsController;

package/dist/core/text.d.ts

@@ -5,11 +5,24 @@ export type TextSegment = {
     readonly kind: 'link';
     readonly text: string;
     readonly href: string;
+}
+/** M2: an `@handle` with the link to the member's profile page on the host's own site (never a member's URL). */
+ | {
+    readonly kind: 'mention';
+    readonly text: string;
+    readonly href: string;
 };
 /** The rel every link to what a member wrote carries (user-generated, no referrer, no opener). */
 export declare const UGC_LINK_REL = "nofollow ugc noopener noreferrer";
 /** A member's text as text runs and links. */
 export declare function linkify(text: string): TextSegment[];
+/**
+ * A member's text as text runs, web-address links and `@handle` mentions (m2-contracts.md §3.3: „the element renders
+ * `@handle` as text with a link to `/u/{handle}`"). The mentions are the SDK's (kb-api's token rule), found only in the
+ * text between addresses — an address's `/@x` stays part of its link; `profileHref` builds the host's profile page
+ * (profilePath) and a handle it gives no page for stays text. Joining every segment's `text` gives the body back.
+ */
+export declare function linkifyWithMentions(text: string, profileHref: ((handle: string) => string | null) | null): TextSegment[];
 /** Characters in code points, as kb-api counts a body (after NFC and trimming). */
 export declare function codePointLength(text: string): number;
 /** A body as kb-api will measure it: NFC, trimmed. */

package/dist/core/topic.d.ts

@@ -0,0 +1,47 @@
+import { type CaseCategory, type CommunityFailure, type CommunityRule, type DiscussionMessage, type ForumCategory } from '@blogmcp/sdk/community';
+import { type TopicThreadController, type TopicThreadControllerOptions } from './discussion';
+import { type FollowController } from './follow';
+import type { TextRef } from './i18n';
+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 declare function createTopicController(o: TopicThreadControllerOptions): TopicController;

package/dist/element.d.ts

@@ -1,6 +1,19 @@
 export declare const DISCUSSION_ELEMENT_TAG = "blogmcp-discussion";
 export declare const NOTICE_FORM_ELEMENT_TAG = "blogmcp-notice-form";
 export declare const MY_COMMUNITY_ELEMENT_TAG = "blogmcp-my-community";
+/** M2 (m2-contracts.md §3.10). */
+export declare const NOTIFICATION_CENTRE_ELEMENT_TAG = "blogmcp-notification-centre";
+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;
@@ -14,6 +27,17 @@ export interface DefineCommunityElementsOptions {
         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;
     };
 }
 /** Register `<blogmcp-discussion>` (once; later calls are no-ops). Browser only. */
@@ -22,5 +46,27 @@ export declare function defineDiscussionElement(opts?: DefineCommunityElementOpt
 export declare function defineNoticeFormElement(opts?: DefineCommunityElementOptions): void;
 /** Register `<blogmcp-my-community>` (once). Browser only. */
 export declare function defineMyCommunityElement(opts?: DefineCommunityElementOptions): void;
-/** Register all three (once). Browser only. */
+/** Register `<blogmcp-notification-centre>` (once). Browser only. */
+export declare function defineNotificationCentreElement(opts?: DefineCommunityElementOptions): void;
+/** Register `<blogmcp-badge>` (once). Browser only. */
+export declare function defineBadgeElement(opts?: DefineCommunityElementOptions): void;
+/** Register `<blogmcp-member-settings>` (once). Browser only. */
+export declare function defineMemberSettingsElement(opts?: DefineCommunityElementOptions): void;
+/** Register `<blogmcp-profile>` (once). Browser only. */
+export declare function defineProfileElement(opts?: DefineCommunityElementOptions): void;
+/** Register `<blogmcp-welcome>` (once). Browser only. */
+export declare function defineWelcomeElement(opts?: DefineCommunityElementOptions): void;
+/** 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,8 +1,12 @@
 /**
- * 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';
-export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, VERSION };
+export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, mountNotificationCentre, mountBadge, mountMemberSettings, mountProfile, mountWelcome, mountForum, mountForumCategory, mountTopic, mountForumSearch, mountFollowButton, mountForumModeration, VERSION, };

package/dist/index.d.ts

@@ -7,14 +7,31 @@
  *   - `<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>`;
  *   - `@blogmcp/community/global` — one `<script>` for sites without a bundler.
  */
-export { defineCommunityElements, defineDiscussionElement, defineNoticeFormElement, defineMyCommunityElement, DISCUSSION_ELEMENT_TAG, NOTICE_FORM_ELEMENT_TAG, MY_COMMUNITY_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 { 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, 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,22 +1,72 @@
-import { A, k, D, M, N, g, h, j, i, d, a, c, b, m, f, e, p } from "./chunks/mount-DzjwnHyx.js";
-const VERSION = "0.1.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 {
-  A as AVATAR_PRESETS,
-  k as DEFAULT_API_BASE,
+  ab as AVATAR_PRESETS,
+  B as BADGE_ELEMENT_TAG,
+  S as BADGE_INTERVAL_MS,
+  ac as DEFAULT_API_BASE,
   D as DISCUSSION_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,
+  p as NOTIFICATION_CENTRE_ELEMENT_TAG,
+  P as PROFILE_ELEMENT_TAG,
+  V as SETTING_KEYS,
+  T as TOPIC_ELEMENT_TAG,
   VERSION,
-  g as createDiscussionController,
-  h as createNoticeForm,
-  j as createOnboarding,
-  i as createPanel,
+  W as WELCOME_ELEMENT_TAG,
+  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,
-  m as mountDiscussion,
-  f as mountMyCommunity,
-  e as mountNoticeForm,
-  p as pickLang
+  e as defineNotificationCentreElement,
+  h as defineProfileElement,
+  l as defineTopicElement,
+  i as defineWelcomeElement,
+  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
 };