@book.dev/ui 1.60.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Eliot Lim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/EmojiGrid-xK5mPJPo.js

@@ -0,0 +1,205 @@
+import { J as e, Mt as t, i as n, n as r, t as i } from "./lucideIcons-B6pmC-WQ.js";
+import { useMemo as a, useRef as o, useState as s } from "react";
+import { Fragment as c, jsx as l, jsxs as u } from "react/jsx-runtime";
+import { search as d } from "node-emoji";
+//#region src/lib/emoji.ts
+function f(e, t = 8) {
+	let n = e.trim().toLowerCase();
+	return n ? d(n).slice().sort((e, t) => p(e.name, n) - p(t.name, n)).slice(0, t) : [];
+}
+function p(e, t) {
+	return e === t ? 0 : e.startsWith(t) ? 1 : 2;
+}
+//#endregion
+//#region src/lib/emojiData.ts
+var m = [
+	{
+		id: "smileys",
+		icon: "😀",
+		emojis: /* @__PURE__ */ "😀.😃.😄.😁.😆.😅.🤣.😂.🙂.🙃.😉.😊.😇.🥰.😍.🤩.😘.😗.😚.😙.😋.😛.😜.🤪.😝.🤑.🤗.🤭.🤫.🤔.🤐.🤨.😐.😑.😶.😏.😒.🙄.😬.😌.😔.😪.🤤.😴.😷.🤒.🤕.🤧.🥵.🥶.🥴.😵.🤯.🤠.🥳.😎.🤓.🧐.😕.😟.🙁.😮.😯.😲.😳.🥺.😦.😨.😰.😥.😢.😭.😱.😖.😣.😞.😓.😩.😫.😤.😡.😠.🤬.😈.👿.💀.💩.🤡.👻.👽.🤖.😺.😸.😻.😼.🙀".split(".")
+	},
+	{
+		id: "people",
+		icon: "👋",
+		emojis: /* @__PURE__ */ "👋.🤚.🖐️.✋.🖖.👌.🤏.✌️.🤞.🤟.🤘.🤙.👈.👉.👆.👇.☝️.👍.👎.✊.👊.🤛.🤜.👏.🙌.👐.🤲.🤝.🙏.✍️.💪.🦾.🧠.👀.👁️.👂.👃.👄.👶.🧒.👦.👧.🧑.👨.👩.🧓.👴.👵.🙇.🙆.🙅.💁.🙋.🤦.🤷.👮.🕵️.💂.👷.🤴.👸.🧑‍🎓.🧑‍🏫.🧑‍💻.🧑‍🔬.🧑‍🎨.🧑‍🚀.🧑‍🚒.🦸.🦹.🧙.🧚.👼.🎅.🤶.💃.🕺.👯.🚶.🏃.🧗.🏌️.🏄.🚴".split(".")
+	},
+	{
+		id: "nature",
+		icon: "🐶",
+		emojis: /* @__PURE__ */ "🐶.🐱.🐭.🐹.🐰.🦊.🐻.🐼.🐨.🐯.🦁.🐮.🐷.🐸.🐵.🐔.🐧.🐦.🐤.🦆.🦅.🦉.🦇.🐺.🐗.🐴.🦄.🐝.🐛.🦋.🐌.🐞.🐜.🦗.🕷️.🦂.🐢.🐍.🦎.🦖.🦕.🐙.🦑.🦐.🦀.🐡.🐠.🐟.🐬.🐳.🐋.🦈.🐊.🐅.🐆.🦓.🦍.🐘.🦏.🐪.🐫.🦒.🐃.🐄.🐎.🐖.🐏.🐑.🐐.🦌.🐕.🐈.🌵.🎄.🌲.🌳.🌴.🌱.🌿.☘️.🍀.🎍.🍂.🍁.🍄.🌾.💐.🌷.🌹.🌺.🌸.🌼.🌻.🌞.🌝.🌛.⭐.🌟.✨.⚡.☄️.🔥.🌈.☀️.⛅.☁️.❄️.💧".split(".")
+	},
+	{
+		id: "food",
+		icon: "🍎",
+		emojis: /* @__PURE__ */ "🍏.🍎.🍐.🍊.🍋.🍌.🍉.🍇.🍓.🫐.🍈.🍒.🍑.🥭.🍍.🥥.🥝.🍅.🍆.🥑.🥦.🥬.🥒.🌶️.🌽.🥕.🧄.🧅.🥔.🍠.🥐.🍞.🥖.🥨.🧀.🥚.🍳.🧈.🥞.🧇.🥓.🥩.🍗.🍖.🌭.🍔.🍟.🍕.🥪.🌮.🌯.🥙.🍜.🍲.🍛.🍣.🍱.🥟.🍤.🍙.🍚.🍘.🍥.🥠.🍢.🍡.🍧.🍨.🍦.🥧.🧁.🍰.🎂.🍮.🍭.🍬.🍫.🍿.🍩.🍪.🌰.🥜.🍯.🥛.☕.🍵.🧃.🥤.🍶.🍺.🍻.🥂.🍷.🥃.🍸.🍹".split(".")
+	},
+	{
+		id: "activity",
+		icon: "⚽",
+		emojis: /* @__PURE__ */ "⚽.🏀.🏈.⚾.🥎.🎾.🏐.🏉.🥏.🎱.🏓.🏸.🥅.🏒.🏑.🥍.🏏.⛳.🏹.🎣.🥊.🥋.🎽.⛸️.🥌.🛷.🎿.⛷️.🏂.🏋️.🤼.🤸.⛹️.🤾.🏌️.🏇.🧘.🏄.🏊.🤽.🚣.🧗.🚵.🚴.🏆.🥇.🥈.🥉.🏅.🎖️.🏵️.🎗️.🎫.🎟️.🎪.🤹.🎭.🎨.🎬.🎤.🎧.🎼.🎹.🥁.🎷.🎺.🎸.🪕.🎻.🎲.♟️.🎯.🎳.🎮.🎰.🧩.🎈.🎉.🎊.🎁.🎀.🪅.🎏.🎐".split(".")
+	},
+	{
+		id: "travel",
+		icon: "🚀",
+		emojis: /* @__PURE__ */ "🚗.🚕.🚙.🚌.🚎.🏎️.🚓.🚑.🚒.🚐.🚚.🚛.🚜.🛴.🚲.🛵.🏍️.🚨.🚔.🚍.🚘.🚖.🚡.🚠.🚟.🚃.🚋.🚞.🚝.🚄.🚅.🚈.🚂.🚆.🚇.🚊.🚉.✈️.🛫.🛬.🛩️.💺.🛰️.🚀.🛸.🚁.🛶.⛵.🚤.🛥️.🛳️.⛴️.🚢.⚓.🚧.⛽.🚏.🗺️.🗿.🗽.🗼.🏰.🏯.🏟️.🎡.🎢.🎠.⛲.⛱️.🏖️.🏝️.🏜️.🌋.⛰️.🏔️.🗻.🏕️.⛺.🏠.🏡.🏘️.🏚️.🏗️.🏭.🏢.🏬.🏣.🏤.🏥.🏦.🏨.🏪.🏫.🏩.💒.🏛️.⛪.🕌.🕍.🛕.🌃.🌆.🌇.🌉.🌁.🌐.🗾.🧭".split(".")
+	},
+	{
+		id: "objects",
+		icon: "💡",
+		emojis: /* @__PURE__ */ "⌚.📱.💻.⌨️.🖥️.🖨️.🖱️.💽.💾.💿.📀.🎥.📷.📸.📹.📼.🔍.🔎.🕯️.💡.🔦.🏮.📔.📕.📖.📗.📘.📙.📚.📓.📒.📃.📜.📄.📰.🗞️.📑.🔖.🏷️.💰.💴.💵.💶.💷.💸.💳.🧾.✉️.📧.📨.📩.📤.📥.📦.📫.📪.📬.📭.📮.✏️.✒️.🖋️.🖊️.🖌️.🖍️.📝.💼.📁.📂.🗂️.📅.📆.🗒️.🗓️.📇.📈.📉.📊.📋.📌.📍.📎.🖇️.📏.📐.✂️.🗃️.🗄️.🗑️.🔒.🔓.🔏.🔐.🔑.🗝️.🔨.🪓.⛏️.⚒️.🛠️.🗡️.⚔️.🔧.🔩.⚙️.🧰.🧲.⚗️.🧪.🧫.🧬.🔬.🔭.📡.💉.🩺.💊.🩹.🚪.🛏️".split(".")
+	},
+	{
+		id: "symbols",
+		icon: "❤️",
+		emojis: /* @__PURE__ */ "❤️.🧡.💛.💚.💙.💜.🖤.🤍.🤎.💔.❣️.💕.💞.💓.💗.💖.💘.💝.💟.☮️.✝️.☪️.🕉️.☸️.✡️.🔯.🕎.☯️.☦️.⛎.♈.♉.♊.♋.♌.♍.♎.♏.♐.♑.♒.♓.🆔.⚛️.🉑.☢️.☣️.📴.✅.❌.❎.➕.➖.➗.✖️.♾️.‼️.⁉️.❓.❔.❕.❗.〰️.⚠️.🚸.🔱.⚜️.🔰.♻️.✳️.❇️.⭐.🌟.💫.⭕.🔴.🟠.🟡.🟢.🔵.🟣.🟤.⚫.⚪.🔺.🔻.🔸.🔹.🔶.🔷.🔳.🔲.▪️.▫️.◼️.◻️.🏁.🚩.🎌.🏴.🏳️.🏳️‍🌈.🔔.🔕.🎵.🎶.💬.💭".split(".")
+	}
+];
+Array.from(new Set(m.flatMap((e) => e.emojis)));
+//#endregion
+//#region src/lib/iconRecents.ts
+var h = "openbook.iconRecents", g = 24;
+function _() {
+	if (typeof localStorage > "u") return [];
+	try {
+		let e = localStorage.getItem(h), t = e ? JSON.parse(e) : [];
+		return Array.isArray(t) ? t.filter((e) => typeof e == "string").slice(0, g) : [];
+	} catch {
+		return [];
+	}
+}
+function v(e) {
+	if (!(typeof localStorage > "u" || !e)) try {
+		let t = [e, ..._().filter((t) => t !== e)].slice(0, g);
+		localStorage.setItem(h, JSON.stringify(t));
+	} catch {}
+}
+//#endregion
+//#region src/components/EmojiGrid.tsx
+function y({ value: t, onPick: n }) {
+	let { t: r } = e(), [i, a] = s(t?.startsWith("lucide:") ? "icon" : "emoji"), [c, d] = s(""), f = o(_()).current;
+	return /* @__PURE__ */ u("div", {
+		className: "flex h-[372px] w-[332px] flex-col bg-popover text-popover-foreground",
+		children: [
+			/* @__PURE__ */ u("div", {
+				className: "flex items-center gap-1 p-2 pb-1.5",
+				children: [/* @__PURE__ */ l(b, {
+					active: i === "emoji",
+					onClick: () => a("emoji"),
+					label: r("emoji.tabEmoji")
+				}), /* @__PURE__ */ l(b, {
+					active: i === "icon",
+					onClick: () => a("icon"),
+					label: r("emoji.tabIcons")
+				})]
+			}),
+			/* @__PURE__ */ l("div", {
+				className: "px-2 pb-2",
+				children: /* @__PURE__ */ l("input", {
+					autoFocus: !0,
+					value: c,
+					onChange: (e) => d(e.target.value),
+					placeholder: r(i === "emoji" ? "emoji.searchEmoji" : "emoji.searchIcons"),
+					className: "h-8 w-full rounded-md border border-input bg-background px-2.5 text-sm outline-hidden placeholder:text-muted-foreground focus-visible:ring-2 focus-visible:ring-ring",
+					"aria-label": r("emoji.search")
+				})
+			}),
+			/* @__PURE__ */ l("div", {
+				className: "min-h-0 flex-1 overflow-y-auto px-2 pb-2",
+				children: l(i === "emoji" ? w : E, {
+					query: c,
+					recents: f,
+					current: t,
+					onPick: (e) => {
+						v(e), n(e);
+					}
+				})
+			})
+		]
+	});
+}
+function b({ active: e, onClick: n, label: r }) {
+	return /* @__PURE__ */ l("button", {
+		type: "button",
+		onClick: n,
+		className: t("flex-1 cursor-pointer rounded-md px-2.5 py-1 text-sm font-medium transition-colors", e ? "bg-accent text-accent-foreground" : "text-muted-foreground hover:bg-hover"),
+		children: r
+	});
+}
+function x({ children: e }) {
+	return /* @__PURE__ */ l("div", {
+		className: "sticky top-0 z-10 bg-popover px-1 pb-1 pt-1.5 text-xs font-medium uppercase tracking-wide text-muted-foreground/70",
+		children: e
+	});
+}
+var S = "grid grid-cols-8 gap-0.5";
+function C({ glyph: e, active: n, onPick: r }) {
+	return /* @__PURE__ */ l("button", {
+		type: "button",
+		onClick: () => r(e),
+		className: t("flex h-9 w-9 items-center justify-center rounded-md text-[20px] leading-none transition-colors hover:bg-hover", n && "bg-accent ring-1 ring-primary"),
+		title: e,
+		children: e
+	});
+}
+function w({ query: t, recents: r, current: i, onPick: o }) {
+	let { t: s } = e(), d = a(() => t.trim() ? f(t, 64).map((e) => e.emoji) : null, [t]), p = r.filter((e) => !e.startsWith(n));
+	return d ? d.length === 0 ? /* @__PURE__ */ l(D, { text: s("emoji.noResults") }) : /* @__PURE__ */ l("div", {
+		className: S,
+		children: d.map((e, t) => /* @__PURE__ */ l(C, {
+			glyph: e,
+			active: e === i,
+			onPick: o
+		}, `${e}-${t}`))
+	}) : /* @__PURE__ */ u(c, { children: [p.length > 0 && /* @__PURE__ */ u("section", { children: [/* @__PURE__ */ l(x, { children: s("emoji.recent") }), /* @__PURE__ */ l("div", {
+		className: S,
+		children: p.map((e, t) => /* @__PURE__ */ l(C, {
+			glyph: e,
+			active: e === i,
+			onPick: o
+		}, `r-${e}-${t}`))
+	})] }), m.map((e) => /* @__PURE__ */ u("section", { children: [/* @__PURE__ */ l(x, { children: s(`emoji.cat.${e.id}`) }), /* @__PURE__ */ l("div", {
+		className: S,
+		children: e.emojis.map((t, n) => /* @__PURE__ */ l(C, {
+			glyph: t,
+			active: t === i,
+			onPick: o
+		}, `${e.id}-${t}-${n}`))
+	})] }, e.id))] });
+}
+function T({ name: e, active: r, onPick: a }) {
+	let o = i[e];
+	return o ? /* @__PURE__ */ l("button", {
+		type: "button",
+		onClick: () => a(`${n}${e}`),
+		className: t("flex h-9 w-9 items-center justify-center rounded-md text-foreground transition-colors hover:bg-hover", r && "bg-accent ring-1 ring-primary"),
+		title: e,
+		"aria-label": e,
+		children: /* @__PURE__ */ l(o, { className: "h-[18px] w-[18px]" })
+	}) : null;
+}
+function E({ query: t, recents: o, current: s, onPick: d }) {
+	let { t: f } = e(), p = t.trim().toLowerCase(), m = a(() => p ? r.filter((e) => e.toLowerCase().includes(p)) : r, [p]), h = s?.startsWith("lucide:") ? s.slice(n.length) : void 0, g = o.filter((e) => e.startsWith(n)).map((e) => e.slice(n.length)).filter((e) => i[e]);
+	return m.length === 0 ? /* @__PURE__ */ l(D, { text: f("emoji.noResults") }) : /* @__PURE__ */ u(c, { children: [!p && g.length > 0 && /* @__PURE__ */ u("section", { children: [/* @__PURE__ */ l(x, { children: f("emoji.recent") }), /* @__PURE__ */ l("div", {
+		className: S,
+		children: g.map((e, t) => /* @__PURE__ */ l(T, {
+			name: e,
+			active: e === h,
+			onPick: d
+		}, `r-${e}-${t}`))
+	})] }), /* @__PURE__ */ u("section", { children: [!p && /* @__PURE__ */ l(x, { children: f("emoji.tabIcons") }), /* @__PURE__ */ l("div", {
+		className: S,
+		children: m.map((e) => /* @__PURE__ */ l(T, {
+			name: e,
+			active: e === h,
+			onPick: d
+		}, e))
+	})] })] });
+}
+function D({ text: e }) {
+	return /* @__PURE__ */ l("div", {
+		className: "flex h-24 items-center justify-center text-sm text-muted-foreground",
+		children: e
+	});
+}
+//#endregion
+export { y as default };

package/dist/blockeditor/BlockEditor.d.ts

@@ -0,0 +1,68 @@
+import React from 'react';
+import type * as Y from 'yjs';
+import { type BlockMap, type BlockType } from './model';
+import { type SlashState } from './SlashMenu';
+import { type BlockEditorController } from './useBlockEditor';
+import type { InlineAttrs } from './model';
+/**
+ * The block editor root: renders the block tree, owns the transient UI
+ * (slash menu, inline toolbar, drag state, block selection), and routes
+ * structural keyboard commands. Pure UI — all document state lives in the
+ * Y.Doc handed in by the caller.
+ */
+/** Shared UI surface text blocks call into (menus, formatting, drag). */
+export interface EditorUI {
+    slash: SlashState;
+    mention: SlashState;
+    spellcheck: boolean;
+    openSlash(blockId: string, anchorOffset: number): void;
+    updateSlash(caret: number): void;
+    closeSlash(): void;
+    slashKey(key: string): void;
+    openMention(blockId: string, anchorOffset: number): void;
+    updateMention(caret: number): void;
+    closeMention(): void;
+    mentionKey(key: string): void;
+    toggleFormat(key: keyof InlineAttrs, value?: string): void;
+    scheduleToolbar(): void;
+}
+export type DropRegion = 'above' | 'below' | 'left' | 'right';
+interface DragState {
+    id: string;
+    over: {
+        id: string;
+        region: DropRegion;
+    } | null;
+}
+export declare const BlockEditor: React.FC<{
+    doc: Y.Doc;
+    readOnly?: boolean;
+    ariaLabel?: string;
+    /** Widen the content column to the container (page "full width" mode). */
+    fullWidth?: boolean;
+    /** Trim the tall click-to-append bottom padding (pages with content below
+     *  the editor, e.g. a hosted database view). */
+    compact?: boolean;
+    /** Spellcheck text blocks while typing (user preference). */
+    spellcheck?: boolean;
+    /** The page hosting this editor — powers the "New page/database" commands. */
+    pageId?: string;
+}>;
+export interface RowShared {
+    editor: BlockEditorController;
+    ui: EditorUI;
+    drag: DragState | null;
+    setDrag: React.Dispatch<React.SetStateAction<DragState | null>>;
+    performDrop: (sourceId: string, targetId: string, region: DropRegion) => void;
+    computeRegion: (e: React.DragEvent | React.PointerEvent, el: HTMLElement, allowSides: boolean) => DropRegion;
+    depth: number;
+    /** Type of the block whose children these rows are (null at the root) — a
+     *  side-drop is offered at the root and inside columns (to create / grow a
+     *  columns layout), but not inside groups or tables. */
+    container: BlockType | null;
+}
+/** One block row: hover gutter (add + drag handle), drop targeting, dispatch. */
+export declare const BlockRow: React.FC<RowShared & {
+    block: BlockMap;
+}>;
+export default BlockEditor;

package/dist/blockeditor/CodeBlockView.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { type BlockMap } from './model';
+import type { BlockEditorController } from './useBlockEditor';
+import type { EditorUI } from './BlockEditor';
+/**
+ * The code block, unified with live computation (the old formula block): a
+ * toolbar with show/hide · run · copy, and a ⚙ that opens the same settings
+ * popover every kit block uses — variable name, language, and the *live* toggle.
+ * Live = the code evaluates over the document's reactive scope (inputs + every
+ * named live block above it) and publishes under a name later live blocks,
+ * charts, status lights and formulas can reference. Off = an ordinary snippet,
+ * whose name (if any) is a *filename* — name one `openbook.json` and the page
+ * becomes an exportable plugin (see plugins/pagePlugin.ts).
+ */
+export declare const CodeBlockView: React.FC<{
+    block: BlockMap;
+    editor: BlockEditorController;
+    ui: EditorUI;
+}>;

package/dist/blockeditor/InlineToolbar.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { InlineAttrs } from './model';
+/**
+ * The floating formatting toolbar shown over a non-collapsed text selection.
+ * Buttons use mousedown + preventDefault so the document selection survives
+ * the click (the toolbar lives outside the contenteditable).
+ */
+export interface ToolbarState {
+    left: number;
+    top: number;
+    active: Partial<Record<keyof InlineAttrs, boolean>>;
+}
+export declare const InlineToolbar: React.FC<{
+    state: ToolbarState;
+    onToggle: (key: keyof InlineAttrs, value?: string) => void;
+    /** Set (or, with `null`, clear) a colour on the selection. */
+    onColor: (key: 'tc' | 'hl', token: string | null) => void;
+}>;

package/dist/blockeditor/LinkPicker.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { type PageLinkResult } from '@/lib/pageLinks';
+/**
+ * The page/database link picker: a small search popover that the "Link to
+ * page" / "Link to database" slash commands open. It searches existing pages
+ * (optionally only those hosting a database) through the {@link pageLinks}
+ * bridge — the same source the EditorJS `@`-mention uses — so it works whether
+ * or not the editor sits inside the navigation provider. Picking inserts an
+ * inline page-link mention where the command was typed.
+ */
+export declare const LinkPicker: React.FC<{
+    kind: 'page' | 'database';
+    anchorEl: HTMLElement | null;
+    onPick: (result: PageLinkResult) => void;
+    onClose: () => void;
+}>;

package/dist/blockeditor/MentionMenu.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { type PageLinkResult } from '@/lib/pageLinks';
+import type { SlashState } from './SlashMenu';
+import type { BlockEditorController } from './useBlockEditor';
+export declare const MentionMenu: React.FC<{
+    state: SlashState;
+    editor: BlockEditorController;
+    anchorEl: HTMLElement | null;
+    onClose: () => void;
+    /** Insert a page mention chip at the offset where "@" was typed. */
+    onMentionPage: (blockId: string, anchorOffset: number, page: PageLinkResult) => void;
+    /** Insert plain text (a date or a person name) at that offset. */
+    onInsertText: (blockId: string, anchorOffset: number, text: string) => void;
+}>;

package/dist/blockeditor/PresentBlocks.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import * as Y from 'yjs';
+import { type BlockMap } from './model';
+/**
+ * Render a list of blocks from a page's live doc, read-only but with interactive
+ * widgets still operable — the surface Present mode uses for slides, the next-
+ * slide preview, and the speaker-notes panel.
+ *
+ * It reuses the editor's {@link BlockRow} (every block type, widgets, reactivity)
+ * inside a locked {@link KitLockContext}: `BlockBody` makes text and structure
+ * read-only while widgets carrying `interactive` (the default) stay live.
+ * Reactivity is doc-global (`computeScope` reads the doc), so charts and formulas
+ * track widget changes across the whole deck. Editing chrome (gutters, the kit
+ * gear, slash) is hidden by `.ob-present` CSS.
+ */
+export declare const PresentBlocks: React.FC<{
+    doc: Y.Doc;
+    blocks: BlockMap[];
+    className?: string;
+}>;
+export default PresentBlocks;

package/dist/blockeditor/RichTextEditor.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { TextRun } from './model';
+export interface RichTextEditorProps {
+    /** Current value as runs. Re-seeds the surface only when `seed` changes. */
+    value: TextRun[];
+    onChange: (runs: TextRun[]) => void;
+    readOnly?: boolean;
+    placeholder?: string;
+    ariaLabel?: string;
+    /**
+     * Identity token: the surface re-renders its HTML from `value` whenever this
+     * changes (e.g. bump it to clear the composer after posting a comment). When
+     * stable, the DOM stays the source of truth while editing.
+     */
+    seed?: string | number;
+}
+export declare const RichTextEditor: React.FC<RichTextEditorProps>;
+/** TextRun[] → simple inline HTML (b/i/u/links) for the editable surface. */
+export declare function runsToHtml(runs: TextRun[]): string;
+/** Read a contentEditable surface back into TextRun[] (b/i/u/links survive). */
+export declare function domToRuns(root: HTMLElement): TextRun[];
+/** Whether a runs array has any visible text (for "post" button enablement). */
+export declare const runsHaveText: (runs: TextRun[]) => boolean;
+/** Render runs to read-only inline HTML for displaying a posted comment. */
+export declare const RichTextView: React.FC<{
+    runs: TextRun[];
+    className?: string;
+}>;
+export default RichTextEditor;

package/dist/blockeditor/SlashMenu.d.ts

@@ -0,0 +1,49 @@
+import React from 'react';
+import type { BlockEditorController } from './useBlockEditor';
+type IconComp = React.ComponentType<{
+    className?: string;
+}>;
+/**
+ * The “/” command menu: filters as the user keeps typing after the slash,
+ * arrow keys + Enter pick (keys are forwarded from the focused text block via
+ * `state.keyEvent` so the caret never leaves the document), and applying a
+ * command removes the typed “/query” before transforming or inserting.
+ */
+export interface SlashState {
+    open: boolean;
+    blockId: string;
+    /** Offset of the '/' character inside the block's text. */
+    anchorOffset: number;
+    query: string;
+    index: number;
+    keyEvent?: {
+        key: string;
+        n: number;
+    };
+}
+/** Slash-menu categories, in display order. */
+export type SlashGroup = 'pages' | 'basic' | 'interactive' | 'extensions' | 'ai';
+interface SlashItem {
+    id: string;
+    label: string;
+    hint: string;
+    keywords: string;
+    group: SlashGroup;
+    apply: (editor: BlockEditorController, blockId: string) => void;
+    /** When set, the command opens the link picker instead of applying inline. */
+    picker?: 'page' | 'database';
+    icon?: IconComp;
+}
+export declare const SLASH_ITEMS: SlashItem[];
+export declare const SlashMenu: React.FC<{
+    state: SlashState;
+    editor: BlockEditorController;
+    anchorEl: HTMLElement | null;
+    rootEl: HTMLElement | null;
+    onClose: () => void;
+    /** The page hosting this editor — enables the "New page/database" commands. */
+    pageId?: string;
+    /** Open the link picker for a "Link to page/database" command. */
+    onLink?: (kind: 'page' | 'database', blockId: string, anchorOffset: number) => void;
+}>;
+export {};

package/dist/blockeditor/TextBlockView.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { type BlockMap } from './model';
+import type { BlockEditorController } from './useBlockEditor';
+import type { EditorUI } from './BlockEditor';
+export declare const TextBlockView: React.FC<{
+    block: BlockMap;
+    editor: BlockEditorController;
+    ui: EditorUI;
+}>;

package/dist/blockeditor/__tests__/LinkPicker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/__tests__/SlashMenu.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/__tests__/aiApply.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/__tests__/groupLock.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/__tests__/highlight.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/__tests__/mergeUp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/__tests__/present.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockeditor/aiBlocks.d.ts

@@ -0,0 +1,9 @@
+import type { BlockEditorController } from './useBlockEditor';
+export interface AiSlashItem {
+    id: string;
+    label: string;
+    hint: string;
+    keywords: string;
+    apply: (editor: BlockEditorController, blockId: string) => void;
+}
+export declare function aiSlashItems(): AiSlashItem[];

package/dist/blockeditor/colors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The shared editor colour palette — a small set of named tints used for both
+ * block colours (background `bg` / text `fg` props) and inline text runs
+ * (highlight `hl` / text-colour `tc` attributes). Tokens (not raw hex) are
+ * stored in the document and rendered as CSS classes (`obe-fg-*`, `obe-bg-*`,
+ * `obe-hl-*`), so every colour adapts to light and dark themes via index.css.
+ */
+export interface ColorToken {
+    id: string;
+    label: string;
+}
+export declare const COLOR_TOKENS: readonly ColorToken[];
+/** Whether `v` is one of the known palette tokens (guards class names). */
+export declare const isColorToken: (v: string | undefined | null) => v is string;
+/**
+ * Concrete light-theme hex for each token — used by the **exports** (HTML/PDF),
+ * which are self-contained and can't reference the editor's theme-adaptive CSS
+ * classes. `fg` colours text (`tc`); `hl` tints a highlight (`hl`).
+ */
+export declare const COLOR_EXPORT_HEX: Record<string, {
+    fg: string;
+    hl: string;
+}>;

package/dist/blockeditor/exportBlocks.d.ts

@@ -0,0 +1,25 @@
+import type { BlockJSON } from './model';
+import { type ExportCell } from './kit/scope';
+/** Render block JSON to clean semantic HTML (one string, no wrapper). */
+export declare function blocksToHtml(blocks: BlockJSON[]): string;
+/** Render block JSON to GitHub-flavoured Markdown. */
+export declare function blocksToMarkdown(blocks: BlockJSON[]): string;
+interface EditorJsOut {
+    blocks: Array<{
+        id?: string;
+        type: string;
+        data: Record<string, unknown>;
+    }>;
+    values: Array<[string, unknown]>;
+    names: Array<[string, string]>;
+}
+export declare function blocksToEditorJs(blocks: BlockJSON[], computed?: Map<string, ExportCell>): EditorJsOut;
+/** Snapshot-level normalization: pages written by the block editor project
+ *  into the EditorJS shape; everything else passes through untouched. Export
+ *  entry points call this so mixed trees (an EditorJS parent linking block
+ *  subpages, or vice versa) export every page faithfully. */
+export declare function blockSnapshotToEditorJs<T extends {
+    editor?: string;
+    blockdoc?: unknown;
+}>(snapshot: T): T;
+export {};

package/dist/blockeditor/highlight.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Lightweight, dependency-free syntax highlighting for code blocks.
+ *
+ * The editor owns the contenteditable DOM imperatively (see richtext.ts): the
+ * rendered HTML's character stream has to stay an exact image of the Y.Text
+ * string, because a caret is just "the number of characters before it". So the
+ * highlighter only ever *wraps* runs in `<span>` — it never adds, drops, or
+ * reorders a character — and newlines stay `<br>` (which the caret mapping
+ * counts as one char). Tokenising is deliberately approximate: one pass of a
+ * few regexes over a broad keyword union. A mis-tinted identifier is harmless;
+ * a shifted caret is not.
+ */
+/**
+ * Escape text for `innerHTML` so it round-trips the browser's own serializer:
+ * `&`, `<`, `>` and U+00A0 are escaped and newlines become `<br>`, but quotes
+ * are left alone. Browsers do *not* entity-escape quotes inside text content,
+ * so escaping them here would make our generated HTML differ from `el.innerHTML`
+ * on every render — which, on a caret-less re-render (a live recompute, an
+ * autosave), would needlessly rewrite the DOM and drop the caret to the start.
+ */
+export declare function escapeText(s: string): string;
+/** Escape a value destined for a double-quoted HTML attribute. */
+export declare function escapeAttr(s: string): string;
+/** Render `src` to highlighted HTML whose character stream equals `src` exactly. */
+export declare function highlightCode(src: string, language?: string): string;

package/dist/blockeditor/index.d.ts

@@ -0,0 +1,8 @@
+export { BlockEditor } from './BlockEditor';
+export { useBlockEditor } from './useBlockEditor';
+export { connectBroadcast, type BroadcastConnection, type PresencePeer } from './provider';
+export { createDoc, createSeededDoc, decodeSnapshot, docToJSON, encodeSnapshot, migrateEditorJs, rootBlocks, type BlockDocSnapshot, type BlockJSON, type BlockType, } from './model';
+export { registerCustomBlock, getCustomBlock, type CustomBlockDef, type CustomBlockProps } from './registry';
+export { registerReactiveBlocks } from './reactiveBlocks';
+export { registerArtifactKit } from './kit';
+export { blocksToHtml, blocksToMarkdown } from './exportBlocks';