@blogmcp/community 0.1.0 → 0.2.0

package/dist/core/attrs.d.ts

@@ -30,6 +30,25 @@ export interface CommunityRoutes {
      * becomes a link to it (m1-contracts.md §7.6). No default — without it the note stays text.
      */
     consultationPath?: string;
+    /**
+     * M2 (m2-contracts.md §3.10): a member's public profile; `{handle}` is the handle (`/komunita/u/{handle}`) — a
+     * template, as statementPath is. A mention in a message links to it.
+     */
+    profilePath?: string;
+    /** M2: the member's notification settings (where the digest's unsubscribe link lands with `#u=`). */
+    settingsPath?: string;
+    /** M2: the notification centre (the badge links to it). */
+    notificationsPath?: string;
+    /** M2: the welcome page after joining. */
+    welcomePath?: string;
+    /** M2: the discussions overview. */
+    discussionsPath?: string;
+    /**
+     * M2 T10: an article's page; `{slug}` is the article's slug (`/blog/articles/{slug}`, the storefront `/blog/{slug}`)
+     * — a template, as profilePath is. The notification centre links a reply's or a mention's message on it (the
+     * message's anchor in the fragment). No default: without it those rows stay unlinked.
+     */
+    articlePath?: string;
 }
 /** A path on the host's own site (the SDK's links.ts rule). */
 export declare function isSitePath(path: unknown): path is string;
@@ -42,7 +61,8 @@ export declare function parseRoutes(value: unknown): CommunityRoutes;
  */
 export declare function siteBaseOf(value: unknown): string | null;
 /**
- * The pages with the managed blog's defaults filled in under the site's base (statementPath stays a template).
+ * 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).
  * A page the host or the tenant names is its own full path.
  */
 export declare function routesWithDefaults(routes: CommunityRoutes, tenant?: {
@@ -55,6 +75,12 @@ export declare function routesWithDefaults(routes: CommunityRoutes, tenant?: {
     reportPath: string;
     noticesPath: string;
     consultationPath: string | null;
+    profilePath: string;
+    settingsPath: string;
+    notificationsPath: string;
+    welcomePath: string;
+    discussionsPath: string;
+    articlePath: string | null;
 };
 /** A notice target of one of kb-api's four shapes, or null (the form then has nothing to report). */
 export declare function parseTarget(value: unknown): NoticeTarget | null;

package/dist/core/badge.d.ts

@@ -0,0 +1,30 @@
+import { type CommunityClient } from '@blogmcp/sdk/community';
+/** The badge's poll (the contract's 60 s). */
+export declare const BADGE_INTERVAL_MS = 60000;
+/** A count above it reads `99+`. */
+export declare const BADGE_MAX = 99;
+export interface BadgeUi {
+    /** `hidden`: nothing to show (a visitor, no member, a dark module, or not decided yet). */
+    phase: 'pending' | 'hidden' | 'shown';
+    count: number;
+}
+export interface BadgeController {
+    readonly state: BadgeUi;
+    start(): Promise<void>;
+    /** Read the count now (coalesced with one on its way). */
+    refresh(): Promise<void>;
+    dispose(): void;
+}
+export interface BadgeOptions {
+    client: CommunityClient;
+    /**
+     * Default 60 s, and never more often (a smaller value above 0 reads as 60 s: the contract's rate per open tab);
+     * 0 or less = no poll (the count is read once and on visibility).
+     */
+    intervalMs?: number;
+    /** Whether the page is visible now (default: document.visibilityState). */
+    visible?: () => boolean;
+}
+/** The count as the badge shows it. */
+export declare const badgeText: (count: number) => string;
+export declare function createBadge(o: BadgeOptions): BadgeController;

package/dist/core/centre.d.ts

@@ -0,0 +1,28 @@
+import { type CommunityClient, type CommunityFailure, type NotificationItem } from '@blogmcp/sdk/community';
+import type { TextRef } from './i18n';
+export type CentrePhase = 'idle' | 'loading' | 'ready' | 'failed' | 'signIn';
+export interface CentreUi {
+    phase: CentrePhase;
+    failure: CommunityFailure | null;
+    /** Known codes only (a code a newer kb-api sends is skipped, never shown raw). */
+    items: NotificationItem[];
+    nextCursor: string | null;
+    unreadOnly: boolean;
+    loadingMore: boolean;
+    busy: Record<string, boolean>;
+    announcement: TextRef | null;
+    announceId: number;
+}
+export interface NotificationCentreController {
+    readonly state: CentreUi;
+    load(): Promise<void>;
+    loadMore(): Promise<void>;
+    setUnreadOnly(on: boolean): Promise<void>;
+    markRead(id: string): Promise<void>;
+    markAllRead(): Promise<void>;
+    unread(): number;
+    dispose(): void;
+}
+export declare function createNotificationCentre(o: {
+    client: CommunityClient;
+}): NotificationCentreController;

package/dist/core/digest-token.d.ts

@@ -0,0 +1,2 @@
+/** The token this element's page carries, or null (none, or a cut link). */
+export declare function digestTokenForElement(owner: object | null): string | null;

package/dist/core/discussion.d.ts

@@ -10,6 +10,7 @@ import { type ShallowRef } from 'vue';
 import { type CaseCategory, type CommunityClient, type CommunityFailure, type CommunityRule, type DiscussionMessage, type DiscussionState, type DiscussionStore, type MyState, type ReactionTarget, type ViewerNeeds } from '@blogmcp/sdk/community';
 import type { Lang, TextRef } from './i18n';
 import { type OnboardingModel } from './onboarding';
+import type { DiscussionRealtime } from './realtime';
 export type DiscussionPhase = 'loading' | 'ready' | 'failed' | 'hidden';
 /** One composer's text and what happened to it. */
 export interface Draft {
@@ -52,9 +53,13 @@ export interface ReportDraft {
  * onboarding waits); `ageRefused` (the age band declared in it was below the minimum: reading only, the
  * onboarding is not offered again); `sanction` (a restriction, suspension or ban in effect); `notMoved` (the
  * discussion takes no writes yet — one sentence); `restricted` (the member is read-only or deleting their
- * profile); `pending` (being decided).
+ * profile); `braked` (M2: the community is paused — `me/get`'s `module.brake`, or a write refused BRAKED: reading
+ * goes on, every member write waits — one sentence); `pending` (being decided).
+ *
+ * A module that is `read_only` changes nothing here (m2-contracts.md §3.1: the discussions under articles keep
+ * taking writes; only live updates, push and the Pro surfaces stop) — the discussion polls instead of a socket.
  */
-export type ComposerMode = 'write' | 'signIn' | 'onboarding' | 'ageRefused' | 'sanction' | 'notMoved' | 'restricted' | 'pending';
+export type ComposerMode = 'write' | 'signIn' | 'onboarding' | 'ageRefused' | 'sanction' | 'notMoved' | 'restricted' | 'braked' | 'pending';
 export interface DiscussionUi {
     phase: DiscussionPhase;
     /** Why the first load failed (`failed`). */
@@ -65,8 +70,8 @@ export interface DiscussionUi {
     /** A head poll saw messages the page does not show yet. */
     newMessages: boolean;
     me: MyState | null;
-    /** What a write or the member's state taught: no writes yet, or none for this member. */
-    block: 'notMoved' | 'restricted' | null;
+    /** What a write or the member's state taught: no writes yet, none for this member, or a pause (BRAKED). */
+    block: 'notMoved' | 'restricted' | 'braked' | null;
     composer: Draft;
     inline: InlineDraft | null;
     report: ReportDraft | null;
@@ -82,6 +87,16 @@ export interface DiscussionUi {
      * (§7.4.2), so the element does: the onboarding is not offered again while it lives.
      */
     refusedAge: number | null;
+    /**
+     * M2 T9: the onboarding just finished with the art. 9 consent refused (`public_write`): the composer says once,
+     * in view, what the refusal leaves (writing in the public discussion). Not kept beyond this element.
+     */
+    art9RefusedNote: boolean;
+    /**
+     * M2 (§3.5): the live updates' session fell back to polling (live updates are off here, or the server cut the
+     * socket for good — 4501): the discussion says so once and keeps polling; it never opens the socket again itself.
+     */
+    realtimeOff: boolean;
 }
 export interface DiscussionControllerOptions {
     client: CommunityClient;
@@ -96,6 +111,11 @@ export interface DiscussionControllerOptions {
     refusedAge?: number | null;
     /** The onboarding's age band was refused: the element keeps it for its next discussions. */
     onAgeRefused?(minAge: number): void;
+    /**
+     * M2 (§3.5, §3.10): the host's live-updates session factory (`createRealtimeSession` of
+     * `@blogmcp/sdk/community/realtime`). Absent: the head poll, as before.
+     */
+    realtime?: DiscussionRealtime | null;
 }
 export interface DiscussionController {
     readonly state: DiscussionUi;
@@ -135,10 +155,21 @@ export interface DiscussionController {
     openReport(m: DiscussionMessage): void;
     closeReport(): void;
     submitReport(): Promise<void>;
-    beginOnboarding(): void;
+    /**
+     * The onboarding inline; `offerArt9` asks the art. 9 consent also of a member who refused it (`public_write`, M2 T9) —
+     * the give-consent link on their own message held until the consent.
+     */
+    beginOnboarding(options?: {
+        offerArt9?: boolean;
+    }): void;
     cancelOnboarding(): void;
     /** Seconds a draft still waits (0 when it may go). */
     waitLeft(draft: Draft): number;
+    /**
+     * M2 T10: the distinct `@handle`s one message of the viewer may carry (me/get's `caps.mentionsPerMessage`), or null
+     * when nothing is known to limit it (no member yet, an older kb-api, a module whose mentions notify nobody).
+     */
+    mentionCap(): number | null;
     dispose(): void;
 }
 export declare function createDiscussionController(o: DiscussionControllerOptions): DiscussionController;

package/dist/core/format.d.ts

@@ -5,6 +5,13 @@
 import { type Lang } from './i18n';
 /** An ISO timestamp as a date (and time); '' for anything that is no date. */
 export declare function formatDate(lang: Lang, iso: string | null | undefined, withTime?: boolean): string;
+/**
+ * A month as `profile/get`'s `memberSince` gives it (`YYYY-MM`, UTC) in the reader's language, in the form a date
+ * takes inside a sentence („Členem od října 2026", "Member since October 2026"): Intl formats the first of the month
+ * and the day is left out — a month on its own would be the nominative („říjen"). The value as it came when Intl has
+ * no words, '' for anything that is no month.
+ */
+export declare function formatMonth(lang: Lang, ym: string | null | undefined): string;
 /** Whether an ISO timestamp lies in the past (an appeal window, a sanction's end). */
 export declare function isPast(iso: string | null | undefined, now?: number): boolean;
 /**

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,15 @@ 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;
     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,40 @@
+import { type CommunityClient, type CommunityFailure, type CommunityMessageKey, type CommunityRule, 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;
+}
+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,35 @@
+/**
+ * The discussion's live updates (m2-contracts.md §3.5, §3.10): `<blogmcp-discussion>` 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 } 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;

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

@@ -1,6 +1,12 @@
 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";
 export interface DefineCommunityElementOptions {
     /** Another tag name for the element. */
     tag?: string;
@@ -14,6 +20,11 @@ export interface DefineCommunityElementsOptions {
         discussion?: string;
         noticeForm?: string;
         myCommunity?: string;
+        notificationCentre?: string;
+        badge?: string;
+        memberSettings?: string;
+        profile?: string;
+        welcome?: string;
     };
 }
 /** Register `<blogmcp-discussion>` (once; later calls are no-ops). Browser only. */
@@ -22,5 +33,15 @@ 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;
+/** Register all eight (once). Browser only. */
 export declare function defineCommunityElements(opts?: DefineCommunityElementsOptions): void;

package/dist/global.d.ts

@@ -1,8 +1,11 @@
 /**
- * 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>` 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.
  */
 import { defineCommunityElements } from './element';
-import { mountDiscussion, mountMyCommunity, mountNoticeForm } from './mount';
+import { mountBadge, mountDiscussion, mountMemberSettings, mountMyCommunity, mountNoticeForm, mountNotificationCentre, mountProfile, mountWelcome } from './mount';
 import { VERSION } from './version';
-export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, VERSION };
+export { defineCommunityElements, mountDiscussion, mountMyCommunity, mountNoticeForm, mountNotificationCentre, mountBadge, mountMemberSettings, mountProfile, mountWelcome, VERSION, };

package/dist/index.d.ts

@@ -7,13 +7,21 @@
  *   - `<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);
  *   - `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 { 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 { 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 { createNoticeForm, type NoticeFormController, type NoticeFormOptions, type NoticeFormUi } from './core/notice';
 export { createPanel, type PanelController, type PanelOptions, type PanelUi } from './core/panel';