@blogmcp/community 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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;
+ *   - `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 { 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,22 @@
+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";
+export {
+  A as AVATAR_PRESETS,
+  k as DEFAULT_API_BASE,
+  D as DISCUSSION_ELEMENT_TAG,
+  M as MY_COMMUNITY_ELEMENT_TAG,
+  N as NOTICE_FORM_ELEMENT_TAG,
+  VERSION,
+  g as createDiscussionController,
+  h as createNoticeForm,
+  j as createOnboarding,
+  i as createPanel,
+  d as defineCommunityElements,
+  a as defineDiscussionElement,
+  c as defineMyCommunityElement,
+  b as defineNoticeFormElement,
+  m as mountDiscussion,
+  f as mountMyCommunity,
+  e as mountNoticeForm,
+  p as pickLang
+};

package/dist/mount.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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';
+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;
+}
+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;
+}
+/** 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;
+export {};

package/dist/react.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>` 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 { MountDiscussionOptions, MountMyCommunityOptions, MountNoticeFormOptions } from './mount';
+export type KbDiscussionProps = Omit<MountDiscussionOptions, 'container'>;
+export type KbNoticeFormProps = Omit<MountNoticeFormOptions, 'container'>;
+export type KbMyCommunityProps = Omit<MountMyCommunityOptions, 'container'>;
+export declare function KbDiscussion(props: KbDiscussionProps): ReactElement;
+export declare function KbNoticeForm(props: KbNoticeFormProps): ReactElement;
+export declare function KbMyCommunity(props: KbMyCommunityProps): ReactElement;
+export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions };

package/dist/react.js

@@ -0,0 +1,35 @@
+"use client";
+import { useRef, useEffect, createElement } from "react";
+const keyOf = (props) => JSON.stringify(props, (_k, v) => typeof v === "function" ? "[fn]" : v);
+function useMounted(kind, props, load) {
+  const host = useRef(null);
+  const latest = useRef(props);
+  latest.current = props;
+  const key = keyOf(props);
+  useEffect(() => {
+    let unmount = null;
+    let gone = false;
+    void load().then((mount) => {
+      if (!gone && host.current) unmount = mount({ ...latest.current, container: host.current });
+    });
+    return () => {
+      gone = true;
+      unmount?.();
+    };
+  }, [key]);
+  return createElement("div", { ref: host, "data-blogmcp-community": kind });
+}
+function KbDiscussion(props) {
+  return useMounted("discussion", props, async () => (await import("./chunks/mount-DzjwnHyx.js").then((n) => n.l)).mountDiscussion);
+}
+function KbNoticeForm(props) {
+  return useMounted("notice-form", props, async () => (await import("./chunks/mount-DzjwnHyx.js").then((n) => n.l)).mountNoticeForm);
+}
+function KbMyCommunity(props) {
+  return useMounted("my-community", props, async () => (await import("./chunks/mount-DzjwnHyx.js").then((n) => n.l)).mountMyCommunity);
+}
+export {
+  KbDiscussion,
+  KbMyCommunity,
+  KbNoticeForm
+};

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

@@ -0,0 +1,11 @@
+import type { KnownAuthor } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    author: KnownAuthor | {
+        kind: 'member';
+        memberId: string | null;
+        displayName: string | null;
+        avatarPreset: string | null;
+    };
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,20 @@
+import type { CommunityMessageKey } from '@blogmcp/sdk/community';
+import type { TextParams } from '../core/i18n';
+type __VLS_Props = {
+    title: CommunityMessageKey;
+    explain?: CommunityMessageKey;
+    explainParams?: TextParams;
+    confirm: CommunityMessageKey;
+    cancel?: CommunityMessageKey;
+    danger?: boolean;
+    busy?: boolean;
+    fallbackFocus?: () => HTMLElement | null;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    confirm: () => any;
+    cancel: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onConfirm?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,33 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+declare const _default: import("vue").DefineComponent<{
+    articleId?: string;
+    /** The host's relative base (default `${siteBase}/api/community`). */
+    apiBase?: string;
+    /** The path the site is served under (`/blog` on a managed blog): its proxy and its pages, as the defaults. */
+    siteBase?: string;
+    lang?: string;
+    /** The site's sign-in page; the current path goes in its fragment. */
+    signInHref?: string;
+    /** JSON (or an object): `statementPath`, `myCommunityPath`, `rulesPath`, `reportPath`, `noticesPath`. */
+    routes?: string | Record<string, unknown>;
+    /** Head poll interval in ms (default 20 000; 0 = off). */
+    pollMs?: number;
+    /** A replacement transport (a property, never an attribute): tests, a signing transport later. */
+    transport?: CommunityTransport;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    articleId?: string;
+    /** The host's relative base (default `${siteBase}/api/community`). */
+    apiBase?: string;
+    /** The path the site is served under (`/blog` on a managed blog): its proxy and its pages, as the defaults. */
+    siteBase?: string;
+    lang?: string;
+    /** The site's sign-in page; the current path goes in its fragment. */
+    signInHref?: string;
+    /** JSON (or an object): `statementPath`, `myCommunityPath`, `rulesPath`, `reportPath`, `noticesPath`. */
+    routes?: string | Record<string, unknown>;
+    /** Head poll interval in ms (default 20 000; 0 = off). */
+    pollMs?: number;
+    /** A replacement transport (a property, never an attribute): tests, a signing transport later. */
+    transport?: CommunityTransport;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,5 @@
+type __VLS_Props = {
+    text: string | null;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,24 @@
+import type { Draft } from '../core/discussion';
+type __VLS_Props = {
+    draft: Draft;
+    kind: 'new' | 'reply' | 'edit';
+    /** Seconds the draft still waits (the controller's clock). */
+    wait: number;
+    replyingTo?: string | null;
+    /** The host's rules page. */
+    rulesHref?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    focus: () => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    confirm: (code: string, checked: boolean) => any;
+    submit: () => any;
+    cancel: () => any;
+    confirmed: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onConfirm?: ((code: string, checked: boolean) => any) | undefined;
+    onSubmit?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onConfirmed?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,6 @@
+import { type DiscussionMessage } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    message: DiscussionMessage;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,10 @@
+import type { MenuItem } from './types';
+type __VLS_Props = {
+    items: MenuItem[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (id: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((id: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,16 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    apiBase?: string;
+    /** The path the site is served under (`/blog`): its proxy and its pages, as the defaults. */
+    siteBase?: string;
+    lang?: string;
+    /** Opens this statement (the host's statement page). */
+    decisionId?: string;
+    /** JSON (or an object): `statementPath`, `myCommunityPath`, `rulesPath`, `reportPath`, `noticesPath`. */
+    routes?: string | Record<string, unknown>;
+    /** The site's sign-in page, for a reader without a session. */
+    signInHref?: string;
+    transport?: CommunityTransport;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,26 @@
+import { type CommunityTransport } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    apiBase?: string;
+    /** The path the site is served under (`/blog`): its proxy and its pages, as the defaults. */
+    siteBase?: string;
+    lang?: string;
+    turnstileSiteKey?: string;
+    /** JSON (or an object): `{ conversationId, seq }`, `{ memberId }`, `{ handle }` or `{ articleId }`. */
+    target?: string | Record<string, unknown>;
+    articleId?: string;
+    /** JSON (or an object): `noticesPath` (the status page), `rulesPath`. */
+    routes?: string | Record<string, unknown>;
+    transport?: CommunityTransport;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    turnstile?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,15 @@
+import { type NoticeStatus } from '@blogmcp/sdk/community';
+import type { AppealDraft } from '../core/panel';
+type __VLS_Props = {
+    notice: NoticeStatus;
+    appeal: AppealDraft;
+    withdrawing: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    appeal: () => any;
+    withdraw: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAppeal?: (() => any) | undefined;
+    onWithdraw?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,11 @@
+import type { OnboardingModel } from '../core/onboarding';
+type __VLS_Props = {
+    model: OnboardingModel;
+    rulesHref: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    cancel: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,13 @@
+import type { ReactionSummary } from '@blogmcp/sdk/community';
+type __VLS_Props = {
+    reactionSet: readonly string[];
+    summary: ReactionSummary;
+    interactive: boolean;
+    busy: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    react: (emoji: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReact?: ((emoji: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,15 @@
+import type { ReportDraft } from '../core/discussion';
+type __VLS_Props = {
+    report: ReportDraft;
+    myCommunityHref: string;
+    rulesHref?: string;
+    fallbackFocus?: () => HTMLElement | null;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    submit: () => any;
+    close: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSubmit?: (() => any) | undefined;
+    onClose?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,15 @@
+import { type Statement } from '@blogmcp/sdk/community';
+import type { AppealDraft } from '../core/panel';
+type __VLS_Props = {
+    statement: Statement;
+    appeal: AppealDraft;
+    withdrawing: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    appeal: () => any;
+    withdraw: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAppeal?: (() => any) | undefined;
+    onWithdraw?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/ui/context.d.ts

@@ -0,0 +1,21 @@
+/**
+ * What the components of one element share: the language and its texts (`t` reads the catalogue through
+ * `communityMessage` and nothing else), ids unique to the element, and the dialog's focus handling.
+ */
+import { type Ref } from 'vue';
+import type { Lang, TextRef, Translate } from '../core/i18n';
+export interface TextContext {
+    lang: Ref<Lang>;
+    t: Translate;
+    /** A TextRef (a controller's outcome) as text. */
+    text(ref: TextRef | null | undefined): string;
+}
+export declare function provideText(lang: Ref<Lang>): TextContext;
+export declare function useText(): TextContext;
+/** An id unique on the page (ids live in each element's shadow root, but the labels reference them). */
+export declare function uid(prefix: string): string;
+/**
+ * A native `<dialog>` opened modally while the component lives: the top layer, Esc, the focus kept
+ * inside — and returned to where it was (or to `fallback` when that is gone, e.g. a deleted message's menu).
+ */
+export declare function useModal(dialog: Ref<HTMLDialogElement | null>, onCancel: () => void, fallback?: () => HTMLElement | null): void;

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

@@ -0,0 +1,19 @@
+/** What the discussion's components share: the controller, the host's routes, what the reader opened. */
+import { type ComputedRef } from 'vue';
+import type { DiscussionController } from '../core/discussion';
+import type { routesWithDefaults } from '../core/attrs';
+export interface DiscussionContext {
+    ctl: DiscussionController;
+    routes: ComputedRef<ReturnType<typeof routesWithDefaults>>;
+    /** Messages of a blocked author the reader opened anyway. */
+    opened: Set<number>;
+    /** Translated messages the reader reads in the original. */
+    originals: Set<number>;
+    /** Top-level messages whose every reply the reader asked to see. */
+    allReplies: Set<number>;
+    /** Where the focus goes when the element it came from is gone (a deleted message). */
+    focusHeading(): HTMLElement | null;
+    deleteMessage(seq: number): void;
+}
+export declare function provideDiscussion(ctx: DiscussionContext): void;
+export declare function useDiscussion(): DiscussionContext;

package/dist/ui/types.d.ts

@@ -0,0 +1,7 @@
+/** One action of a message's menu: a button, or a link (the notice page for a reader without a session). */
+export interface MenuItem {
+    id: string;
+    label: string;
+    href?: string;
+    danger?: boolean;
+}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/vue.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `<KbDiscussion>`, `<KbNoticeForm>`, `<KbMyCommunity>` for Vue / Nuxt: each mounts its element on the
+ * client, after hydration, and removes it on unmount. Each renders one empty `<div>` as the mount point —
+ * nothing else, on the server or the client — so the element sits where the component does and the page's
+ * markup is otherwise the site's alone.
+ *
+ *   <KbDiscussion :article-id="article.id" :sign-in-href="localePath('/login')" />
+ *
+ * A site served under a path names it: `site-base="/blog"` on a managed blog (its proxy is `/blog/api/community`;
+ * the host's own `/api/` there is kb-api, which no element may call).
+ */
+import { type PropType } from 'vue';
+import type { CommunityTransport } from '@blogmcp/sdk/community';
+import type { CommunityRoutes } from './core/attrs';
+import type { MountDiscussionOptions, MountMyCommunityOptions, MountNoticeFormOptions } from './mount';
+export declare const KbDiscussion: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    articleId: {
+        type: StringConstructor;
+        required: true;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    pollMs: NumberConstructor;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    articleId: {
+        type: StringConstructor;
+        required: true;
+    };
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    pollMs: NumberConstructor;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbNoticeForm: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    target: PropType<MountNoticeFormOptions["target"]>;
+    articleId: StringConstructor;
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    turnstileSiteKey: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    target: PropType<MountNoticeFormOptions["target"]>;
+    articleId: StringConstructor;
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    turnstileSiteKey: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const KbMyCommunity: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    decisionId: StringConstructor;
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    decisionId: StringConstructor;
+    apiBase: StringConstructor;
+    siteBase: StringConstructor;
+    lang: StringConstructor;
+    signInHref: StringConstructor;
+    routes: PropType<CommunityRoutes>;
+    nonce: StringConstructor;
+    transport: PropType<CommunityTransport>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export type { MountDiscussionOptions, MountNoticeFormOptions, MountMyCommunityOptions, CommunityRoutes };