@blogmcp/community 0.0.0-stage → 0.2.0

package/dist/core/panel.d.ts

@@ -0,0 +1,96 @@
+/**
+ * `<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 OnboardingModel } from './onboarding';
+export type LoadPhase = 'idle' | 'loading' | 'ready' | 'failed';
+export interface AppealDraft {
+    body: string;
+    sending: boolean;
+    failure: CommunityFailure | null;
+}
+export interface ProfileDraft {
+    displayName: string;
+    handle: string;
+    avatarPreset: string | null;
+    sending: boolean;
+    failure: CommunityFailure | null;
+    fields: string[];
+}
+export interface PanelUi {
+    /** The member's part: `signIn` when the session cannot act as a member (or there is none). */
+    phase: LoadPhase | 'signIn';
+    failure: CommunityFailure | null;
+    me: MyState | null;
+    notifications: NotificationItem[];
+    decisions: DecisionSummary[];
+    appeals: AppealItem[];
+    reports: ReportItem[];
+    blocks: BlockEntry[];
+    /** The statement the page opens (`decision-id`). */
+    statement: {
+        phase: LoadPhase | 'signIn';
+        value: Statement | null;
+        failure: CommunityFailure | null;
+        appeal: AppealDraft;
+    };
+    /** The notifier's part (`#t=` in the address). `missing`: a `#t=` that holds no receipt. */
+    notice: {
+        phase: LoadPhase | 'missing';
+        value: NoticeStatus | null;
+        failure: CommunityFailure | null;
+        appeal: AppealDraft;
+    };
+    profile: ProfileDraft | null;
+    /** The profile's deletion: its date once requested here (kb-api's MyState does not carry it). */
+    purgeAfter: string | null;
+    exporting: boolean;
+    busy: Record<string, boolean>;
+    announcement: TextRef | null;
+    announceId: number;
+}
+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>;
+    loadNotice(receipt: string | null): Promise<void>;
+    unreadCount(): number;
+    markAllRead(): Promise<void>;
+    fileAppeal(): Promise<void>;
+    withdrawAppeal(): Promise<void>;
+    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;
+    saveProfile(): Promise<void>;
+    /** `me/export` as a JSON file the browser saves (`save` does the download; tests pass their own). */
+    exportData(save: (data: MemberExport) => void): Promise<void>;
+    erase(): Promise<boolean>;
+    cancelErase(): Promise<void>;
+    /** The member asked for the deletion (here or before). */
+    erasing(): boolean;
+    appealLength(draft: AppealDraft): number;
+    canAppealWith(draft: AppealDraft): boolean;
+    dispose(): void;
+}
+export interface PanelOptions {
+    client: CommunityClient;
+    lang: string;
+}
+export declare function createPanel(o: PanelOptions): PanelController;

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

@@ -0,0 +1,5 @@
+/**
+ * The receipt this element's page carries: a string; `null` for a `#t=` that holds none (a cut link — "incomplete",
+ * never an older receipt of the tab); `undefined` when the page carries none for it.
+ */
+export declare function receiptForElement(owner: object | null): string | null | undefined;

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

@@ -0,0 +1,35 @@
+export type TextSegment = {
+    readonly kind: 'text';
+    readonly text: string;
+} | {
+    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. */
+export declare function normalizeBody(text: string): string;
+/**
+ * The paragraphs of the tenant's own legal text (`legal/current`'s `body` is HTML with anchors) as plain
+ * text, for the art. 9 consent step: tags are dropped and entities decoded AFTER that, so nothing in the
+ * text is ever parsed as markup again. String work only — no HTML parser, no live DOM.
+ */
+export declare function htmlToParagraphs(html: string): string[];

package/dist/core/turnstile.d.ts

@@ -0,0 +1,33 @@
+export declare const TURNSTILE_SCRIPT_SRC = "https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit";
+interface TurnstileRenderOptions {
+    sitekey: string;
+    action?: string;
+    language?: string;
+    appearance?: 'always' | 'execute' | 'interaction-only';
+    callback?: (token: string) => void;
+    'expired-callback'?: () => void;
+    'error-callback'?: () => void;
+    'timeout-callback'?: () => void;
+}
+export interface TurnstileApi {
+    render(el: HTMLElement, options: TurnstileRenderOptions): string;
+    reset(widgetId: string): void;
+    remove(widgetId: string): void;
+}
+/** One `<script>` per page however many forms mount; a failed load may be tried again later. */
+export declare function loadTurnstile(nonce?: string): Promise<TurnstileApi>;
+export interface TurnstileWidget {
+    /** A fresh token (the last one is spent). */
+    reset(): void;
+    remove(): void;
+}
+export interface RenderTurnstileOptions {
+    siteKey: string;
+    language: string;
+    /** A new token, or null when it expired or failed (the form cannot be sent until a new one comes). */
+    onToken(token: string | null): void;
+    nonce?: string;
+}
+/** The widget in `container`; rejects when the script cannot load (an ad blocker, the network). */
+export declare function renderTurnstile(container: HTMLElement, o: RenderTurnstileOptions): Promise<TurnstileWidget>;
+export {};

package/dist/element.d.ts

@@ -0,0 +1,47 @@
+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;
+    /** CSP nonce for the element's `<style>` (else each element's own `nonce`). */
+    nonce?: string;
+}
+export interface DefineCommunityElementsOptions {
+    /** CSP nonce for the elements' `<style>`. */
+    nonce?: string;
+    tags?: {
+        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. */
+export declare function defineDiscussionElement(opts?: DefineCommunityElementOptions): void;
+/** Register `<blogmcp-notice-form>` (once). Browser only. */
+export declare function defineNoticeFormElement(opts?: DefineCommunityElementOptions): void;
+/** Register `<blogmcp-my-community>` (once). Browser only. */
+export declare function defineMyCommunityElement(opts?: DefineCommunityElementOptions): void;
+/** 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

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @blogmcp/community — the community's elements for a site's own pages (m1-contracts.md §10.4; docs: "Add
+ * discussions to your frontend"), over `@blogmcp/sdk/community`. Every element talks to the HOST's relative
+ * base (`api-base`; default `/api/community` under the site's `site-base`: a headless site's BFF from
+ * `@blogmcp/sdk/community/server`, or with `site-base="/blog"` a managed blog's own proxy), never to kb-api directly.
+ *
+ *   - `<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, 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';
+export { createOnboarding, type OnboardingModel, type OnboardingOptions, type OnboardingStep } from './core/onboarding';
+export { pickLang, type Lang } from './core/i18n';
+export { AVATAR_PRESETS, type AvatarPreset } from './core/avatars';
+export { DEFAULT_API_BASE } from './core/client';
+export type { CommunityRoutes } from './core/attrs';
+export { VERSION } from './version';

package/dist/index.js

@@ -0,0 +1,45 @@
+import { H, B, w, I, D, k, M, N, j, P, S, W, v, u, A, x, C, t, F, E, y, z, f, d, a, g, c, b, e, h, i, p, m, q, n, l, o, r, s, G } from "./chunks/mount-WadUnaTa.js";
+const VERSION = "0.2.0";
+export {
+  H as AVATAR_PRESETS,
+  B as BADGE_ELEMENT_TAG,
+  w as BADGE_INTERVAL_MS,
+  I as DEFAULT_API_BASE,
+  D as DISCUSSION_ELEMENT_TAG,
+  k as MEMBER_SETTINGS_ELEMENT_TAG,
+  M as MY_COMMUNITY_ELEMENT_TAG,
+  N as NOTICE_FORM_ELEMENT_TAG,
+  j as NOTIFICATION_CENTRE_ELEMENT_TAG,
+  P as PROFILE_ELEMENT_TAG,
+  S as SETTING_KEYS,
+  VERSION,
+  W as WELCOME_ELEMENT_TAG,
+  v as badgeText,
+  u as createBadge,
+  A as createDiscussionController,
+  x as createMemberSettings,
+  C as createNoticeForm,
+  t as createNotificationCentre,
+  F as createOnboarding,
+  E as createPanel,
+  y as createProfile,
+  z as createWelcome,
+  f as defineBadgeElement,
+  d as defineCommunityElements,
+  a as defineDiscussionElement,
+  g as defineMemberSettingsElement,
+  c as defineMyCommunityElement,
+  b as defineNoticeFormElement,
+  e as defineNotificationCentreElement,
+  h as defineProfileElement,
+  i as defineWelcomeElement,
+  p as mountBadge,
+  m as mountDiscussion,
+  q as mountMemberSettings,
+  n as mountMyCommunity,
+  l as mountNoticeForm,
+  o as mountNotificationCentre,
+  r as mountProfile,
+  s as mountWelcome,
+  G as pickLang
+};

package/dist/mount.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Put an element on the page from code: what the Vue and React wrappers do, and what any other framework can
+ * call from its client-side mount hook. The element is defined first, so it is created already upgraded (no
+ * upgrade of an unknown element later, which some DOMs never run), and every attribute and property is set
+ * BEFORE it connects, so it mounts with them; the returned function removes the element again (its poll and
+ * requests stop with it).
+ */
+import type { CommunityTransport } from '@blogmcp/sdk/community';
+import type { CommunityRoutes } from './core/attrs';
+import type { DiscussionRealtime } from './core/realtime';
+interface CommonMountOptions {
+    /** The host's relative base (default `/api/community` under `siteBase`): its proxy or BFF. Never kb-api's URL. */
+    apiBase?: string;
+    /**
+     * The path the site is served under (`/blog` on a managed blog, whose host's own `/api/` is kb-api): the default
+     * api-base and the default pages are taken under it. A page or base the host names itself is used as it is.
+     */
+    siteBase?: string;
+    /** `cs` or `en` (`sk` reads Czech); default the page's `<html lang>`. */
+    lang?: string;
+    /** The host's community pages (statements, the panel, the rules, the notice form, a notifier's status). */
+    routes?: CommunityRoutes;
+    /** CSP nonce for the element's stylesheet (and the Turnstile script). */
+    nonce?: string;
+    /** A replacement transport (tests; a signing transport later). */
+    transport?: CommunityTransport;
+    /** Where the element goes; default `document.body`. */
+    container?: Element;
+}
+export interface MountDiscussionOptions extends CommonMountOptions {
+    articleId: string;
+    /** The site's sign-in page; the current path is put in its fragment. */
+    signInHref?: string;
+    /** Head poll interval in ms (default 20 000; 0 = off). */
+    pollMs?: number;
+    /**
+     * M2: live updates — `createRealtimeSession` of `@blogmcp/sdk/community/realtime` (the host imports it; the element
+     * never does). Absent: the head poll.
+     */
+    realtime?: DiscussionRealtime;
+}
+export interface MountNoticeFormOptions extends CommonMountOptions {
+    /** What is reported: a message, a member (by id or handle) or an article. */
+    target?: {
+        conversationId: string;
+        seq: number;
+    } | {
+        memberId: string;
+    } | {
+        handle: string;
+    } | {
+        articleId: string;
+    };
+    /** Or the article (when `target` is absent). */
+    articleId?: string;
+    /** The site's Turnstile site key; without it no widget renders (kb-api then decides alone). */
+    turnstileSiteKey?: string;
+}
+export interface MountMyCommunityOptions extends CommonMountOptions {
+    /** Open this statement of reasons (the host's statement page). */
+    decisionId?: string;
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+export interface MountNotificationCentreOptions extends CommonMountOptions {
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+export interface MountBadgeOptions extends CommonMountOptions {
+    /** The unread count's poll in ms (default 60 000; 0 = once, and when the page is shown again). */
+    pollMs?: number;
+}
+export interface MountMemberSettingsOptions extends CommonMountOptions {
+    /** The host's service worker route (default `<site-base>/sw.js`, served from `@blogmcp/sdk/community/sw`). */
+    swPath?: string;
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+export interface MountProfileOptions extends CommonMountOptions {
+    /** The member's handle. */
+    handle: string;
+    /** The site's sign-in page. */
+    signInHref?: string;
+}
+export interface MountWelcomeOptions extends CommonMountOptions {
+    /** The site's sign-in page (a visitor's link in the profile's place). */
+    signInHref?: string;
+}
+/** Mount `<blogmcp-discussion>`; returns the function that removes it. */
+export declare function mountDiscussion(o: MountDiscussionOptions): () => void;
+/** Mount `<blogmcp-notice-form>`; returns the function that removes it. */
+export declare function mountNoticeForm(o: MountNoticeFormOptions): () => void;
+/** Mount `<blogmcp-my-community>`; returns the function that removes it. */
+export declare function mountMyCommunity(o?: MountMyCommunityOptions): () => void;
+/** Mount `<blogmcp-notification-centre>`; returns the function that removes it. */
+export declare function mountNotificationCentre(o?: MountNotificationCentreOptions): () => void;
+/** Mount `<blogmcp-badge>`; returns the function that removes it. */
+export declare function mountBadge(o?: MountBadgeOptions): () => void;
+/** Mount `<blogmcp-member-settings>`; returns the function that removes it. */
+export declare function mountMemberSettings(o?: MountMemberSettingsOptions): () => void;
+/** Mount `<blogmcp-profile>`; returns the function that removes it. */
+export declare function mountProfile(o: MountProfileOptions): () => void;
+/** Mount `<blogmcp-welcome>`; returns the function that removes it. */
+export declare function mountWelcome(o?: MountWelcomeOptions): () => void;
+export {};

package/dist/react.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>` and (M2) `<KbNotificationCentre>`, `<KbBadge>`,
+ * `<KbMemberSettings>`, `<KbProfile>`, `<KbWelcome>` for React (18 and 19, Next.js App Router included — this
+ * module is a client component): each mounts its element after hydration and removes it on unmount. Each
+ * renders one empty `<div>` as the mount point — nothing else, on the server or the client — so the element
+ * sits where the component does and the page's markup is otherwise the site's alone.
+ *
+ *   <KbDiscussion articleId={article.id} apiBase="/api/community" signInHref={`/sign-in#${pathname}`} />
+ */
+import { type ReactElement } from 'react';
+import type { MountBadgeOptions, MountDiscussionOptions, MountMemberSettingsOptions, MountMyCommunityOptions, MountNoticeFormOptions, MountNotificationCentreOptions, MountProfileOptions, MountWelcomeOptions } from './mount';
+export type KbDiscussionProps = Omit<MountDiscussionOptions, 'container'>;
+export type KbNoticeFormProps = Omit<MountNoticeFormOptions, 'container'>;
+export type KbMyCommunityProps = Omit<MountMyCommunityOptions, 'container'>;
+export type KbNotificationCentreProps = Omit<MountNotificationCentreOptions, 'container'>;
+export type KbBadgeProps = Omit<MountBadgeOptions, 'container'>;
+export type KbMemberSettingsProps = Omit<MountMemberSettingsOptions, 'container'>;
+export type KbProfileProps = Omit<MountProfileOptions, 'container'>;
+export type KbWelcomeProps = Omit<MountWelcomeOptions, 'container'>;
+export declare function KbDiscussion(props: KbDiscussionProps): ReactElement;
+export declare function KbNoticeForm(props: KbNoticeFormProps): ReactElement;
+export declare function KbMyCommunity(props: KbMyCommunityProps): ReactElement;
+export declare function KbNotificationCentre(props: KbNotificationCentreProps): ReactElement;
+export declare function KbBadge(props: KbBadgeProps): ReactElement;
+export declare function KbMemberSettings(props: KbMemberSettingsProps): ReactElement;
+export declare function KbProfile(props: KbProfileProps): ReactElement;
+export declare function KbWelcome(props: KbWelcomeProps): ReactElement;
+export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions, MountNotificationCentreOptions, MountBadgeOptions, MountMemberSettingsOptions, MountProfileOptions, MountWelcomeOptions, };