docblocks-react-ui 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # docblocks-react-ui
 
+## 0.3.1
+
+### Patch Changes
+
+- bb5df92: The standalone `DatabaseTable` now anchors the package's `--docblocks-*`
+  token scope over its own root (the `data-slot="docblocks/editor"` stand).
+  The token mapping is declared on the editor root over the shipped CSS,
+  and the standalone table renders outside any document — without the
+  scope the grid's token-driven utilities (the borders, the paddings, the
+  row's heights) stood unresolved over the consumer's page. The
+  `readOnly` stand sets the root's `data-readonly` attribute (the page
+  mode's `user-select`'s suppression parity).
+
+## 0.3.0
+
+### Minor Changes
+
+- 5f5ab54: The presence selection's visibility over the room stands grant-gated (the
+  privacy stand): the `EditorProvider`'s additive `presence` prop carries
+  the local user's identity (`userId` / the optional `name`) and the
+  optional `PresenceCrypto` cipher; the new `usePresenceSharing()` hook
+  drives the local grant — the session-state default is **off** (the
+  selection does not publish, only the light identity frame the roster
+  needs), and the consumer flips it to `everyone` (the plaintext wire
+  shape, the legacy stand) or to a targeted user-id list (the selection
+  publishes as opaque ciphertext entries, one per grant member — the
+  entries carry no target id, a recipient opens only the entry addressed
+  to it, an unaddressed peer sees the sharer's identity but never the
+  selection). The library orchestrates the publish gating, the receive's
+  decrypt, and the per-peer sequence guard over the async decrypt; the
+  cryptography and the sharing's UI are the consumer's stand (the package
+  ships no built-in control). A provider without the `presence` prop keeps
+  the legacy stand (the anonymous plaintext selection over the room).
+
+### Patch Changes
+
+- Updated dependencies [5971d30]
+  - docblocks-core@0.1.3
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -109,6 +109,7 @@ mention catalog). The full props list:
 | `accessLevel?`               | The consumer's user access level (default `editor`): `viewer` forces the `published` mode (the current state is never rendered to a reader).                                                                                                                                                                                           |
 | `mode?`                      | The document mode (default `edit`): `view` is a read-only live document; `published` renders the `publishedDoc` snapshot read-only.                                                                                                                                                                                                    |
 | `publishedDoc?`              | The published snapshot (a hydrated core `Doc`; must not change after mount — remount over `key` for a new snapshot). The consumer owns the publish action and the snapshot storage.                                                                                                                                                    |
+| `presence?`                  | The local user's presence identity + the selection-sharing cipher (see Presence sharing below). Without the prop the editor keeps the legacy stand (the anonymous plaintext selection, always shared over the room).                                                                                                                   |
 
 Two rules for the optional props:
 
@@ -256,6 +257,62 @@ function App() {
   `updatedAt`); staleness (dropping stale peers) is a consumer concern —
   the payload's `updatedAt` (Unix ms) is the only input.
 
+### Presence sharing
+
+The selection's visibility over the room is grant-gated (the privacy
+stand): with the `presence` prop the grant defaults to **off** — the
+selection does not publish, only the light identity frame (the roster). The
+consumer flips the grant through the hook (session state — not document
+data, not on the wire; it lives until the page reload or the provider's
+unmount):
+
+```tsx
+import { usePresenceSharing } from "docblocks-react-ui";
+
+function ShareControl() {
+  const { sharing, setSharing, peers } = usePresenceSharing();
+  // sharing: "off" | "everyone" | string[] (the local grant — the full
+  // information stands over the sharer's pane: what is shared, and to whom)
+  // setSharing(mode) — a no-op over the read-only modes; a targeted grant
+  // requires the presence prop's userId + crypto (the degraded stand
+  // stands a console warn, no crash)
+  // peers: { peerId, userId?, name?, updatedAt, selectionVisible }[] —
+  // the live roster (the identity frames are always published)
+  return <button onClick={() => setSharing(sharing === "off" ? "everyone" : "off")}>{sharing}</button>;
+}
+```
+
+The grant's modes:
+
+- **`off`** — the selection never publishes (the identity frame only).
+- **`everyone`** — the plaintext `selection` (the legacy wire shape — the
+  peers of any version render it).
+- **`[userId, …]`** (targeted) — the selection publishes as opaque
+  ciphertext entries (`selections`), one per grant member, produced by the
+  consumer's `PresenceCrypto` cipher. The entries carry **no target id**:
+  a recipient tries each entry with its own `decrypt`; an unaddressed peer
+  sees the sharer's identity in the roster but never the selection (and
+  never learns the audience).
+
+```ts
+interface PresenceCrypto {
+  /** One opaque entry per grant member (grant order; no target id inside). */
+  encrypt(selection: PresenceSelection, grant: string[]): Promise<string[]>;
+  /** Null when the entry is not addressed to the local user (or broken). */
+  decrypt(entry: string): Promise<PresenceSelection | null>;
+}
+```
+
+The library orchestrates (publish gating, the debounce, the per-peer
+sequence guard over the async decrypt, the roster) and renders the
+accepted selections through the existing overlay; the cryptography and
+the keys are the consumer's, and the sharing's UI (the toggle, the target
+picker, the indicator) is the consumer's stand over the hook — the package
+ships no built-in control. Without `crypto` the targeted mode degrades
+(the setter stands a no-op); `off` / `everyone` stand regardless. A
+provider **without** the `presence` prop keeps the legacy stand (the
+anonymous plaintext selection over the room — the 0.2.0 behavior).
+
 ### Blobs
 
 The document holds only an opaque blob key (`image.src`); the bytes live
@@ -372,7 +429,12 @@ function TablesSection({ bridge }: { bridge: DatabaseBridge }) {
   the optional `view` prop at mount); `onViewChange(patch)` receives one
   patch per change for the consumer's persistence (the controlled mode
   stands absent — the state is never external). `readOnly` gates the
-  editing's paths (the read-only block's parity).
+  editing's paths (the read-only block's parity). The component is
+  self-contained: it wraps itself in the package's i18n scope and anchors
+  the `--docblocks-*` token scope over its own root, so it themes
+  standalone over the consumer's page (the `dark` class over an ancestor
+  follows the shipped dark set — the package's `styles.css` import is the
+  only requirement).
 - `useTableList(bridge)` — `{ tables, loading, error, refresh, create,
 rename }`: the `listTables` catalog (the system tables stand out), the
   `createTable` / `renameTable` mutations (the fresh `operationId` per op;
@@ -525,6 +587,8 @@ value actually changes (the store's reference-stability contract):
   local state; `null` before the mount effect ran and after unmount).
 - `usePresence()` — the remote peers' ephemeral state (the selection +
   the `updatedAt` per peer).
+- `usePresenceSharing()` — the selection-sharing grant (the session state
+  - the setter + the live roster; see Presence sharing).
 - `useMeta()` — the document meta (the reference is replaced only when
   the title changed).
 - `useEditorContext()` — the whole provider context (the store, the

package/dist/{Editor-YAlRhGNW.mjs → Editor-BvKqUGXH.mjs}

@@ -1116,6 +1116,45 @@ function usePresence() {
 	const { store } = useEditorContext();
 	return useStore(store, (state) => state.presence);
 }
+/**
+* The presence sharing's session state (per provider instance): the local
+* grant (the default "off" — the privacy stand), the grant's setter (a
+* no-op over the read-only stand), and the live roster of the connected
+* peers (the identity frames are always present, the selection only over
+* the grant it stands shared).
+*/
+function usePresenceSharing() {
+	const { store, viewMode, presence: presenceConfig } = useEditorContext();
+	const sharing = useStore(store, (state) => state.sharing);
+	const setSharing = useStore(store, (state) => state.setSharing);
+	const presence = useStore(store, (state) => state.presence);
+	const peers = useMemo(() => presence.map((peer) => ({
+		peerId: peer.peerId,
+		userId: peer.userId,
+		name: peer.name,
+		updatedAt: peer.updatedAt,
+		selectionVisible: peer.selection !== null
+	})), [presence]);
+	const setSharingRef = useRef(setSharing);
+	setSharingRef.current = setSharing;
+	return useMemo(() => ({
+		sharing,
+		setSharing: (mode) => {
+			if (viewMode) return;
+			if (Array.isArray(mode) && (presenceConfig === null || presenceConfig.userId === void 0 || presenceConfig.crypto === void 0)) {
+				console.warn("docblocks-react-ui: the targeted presence sharing requires the presence prop's userId and crypto — the grant stands off.");
+				return;
+			}
+			setSharingRef.current(mode);
+		},
+		peers
+	}), [
+		sharing,
+		viewMode,
+		peers,
+		presenceConfig
+	]);
+}
 /** The document meta; the reference is replaced only when the title changed. */
 function useMeta() {
 	const { store } = useEditorContext();
@@ -11410,6 +11449,293 @@ function useSlashMenu(rootRef) {
 	};
 }
 //#endregion
+//#region src/presence/utils.ts
+/** Deterministic hue (0–359) from the peer id (pure function, no peer state). */
+function peerHue(peerId) {
+	let hash = 0;
+	for (let i = 0; i < peerId.length; i++) hash = hash * 31 + peerId.charCodeAt(i) >>> 0;
+	return hash % 360;
+}
+/** The caret endpoints a peer's wire selection draws; a range draws range boxes instead. */
+function caretPointsOf(selection) {
+	if (selection === null) return [];
+	if ("blockId" in selection) return [{
+		blockId: selection.blockId,
+		offset: selection.offset
+	}];
+	return [];
+}
+/**
+* The per-chain-block segments of a peer's range selection: the from block's
+* tail, the middle text blocks in full, the to block's head. Chain blocks
+* missing from the store (stale presence — the remote selection points at a
+* removed block) are skipped leniently, and the offsets clamp to the current
+* block lengths.
+*/
+function rangeSegmentsOf(selection, doc, blocks) {
+	if (selection === null || !("from" in selection)) return [];
+	const chain = selection.blocks ?? (selection.from.blockId === selection.to.blockId ? [selection.from.blockId] : [selection.from.blockId, selection.to.blockId]);
+	const segments = [];
+	for (const blockId of chain) {
+		if (blocks[blockId] === void 0) continue;
+		const length = doc.getTextLength(blockId);
+		const from = blockId === selection.from.blockId ? selection.from.offset : 0;
+		const to = blockId === selection.to.blockId ? Math.min(selection.to.offset, length) : length;
+		if (from >= to || from >= length) continue;
+		segments.push({
+			blockId,
+			from,
+			to
+		});
+	}
+	return segments;
+}
+/**
+* The client rects of a segment inside the block element, relative to the
+* root's rect. Environments without layout (jsdom — no getClientRects)
+* yield no rects, so a missing rect maps to a single zero box.
+*/
+function rangeRects(root, block, from, to) {
+	const rootRect = root.getBoundingClientRect();
+	const start = locatePosition(block, from);
+	const end = locatePosition(block, to);
+	const range = document.createRange();
+	range.setStart(start.node, start.offset);
+	range.setEnd(end.node, end.offset);
+	if (typeof range.getClientRects !== "function") return [];
+	return Array.from(range.getClientRects()).map((rect) => ({
+		left: rect.left - rootRect.left,
+		top: rect.top - rootRect.top,
+		width: rect.width,
+		height: rect.height
+	}));
+}
+/**
+* The client rect of a collapsed range at the flat offset inside the
+* block element, relative to the root's rect. Environments without layout
+* (jsdom — no getClientRects) yield zero rects, so a missing rect maps to 0.
+*/
+function caretGeometry(root, block, offset) {
+	const position = locatePosition(block, offset);
+	const range = document.createRange();
+	range.setStart(position.node, position.offset);
+	range.collapse(true);
+	let rect;
+	if (typeof range.getClientRects === "function") {
+		const rects = range.getClientRects();
+		rect = rects.length > 0 ? rects[0] : void 0;
+	}
+	const rootRect = root.getBoundingClientRect();
+	return {
+		left: rect !== void 0 ? rect.left - rootRect.left : 0,
+		top: rect !== void 0 ? rect.top - rootRect.top : 0,
+		height: rect !== void 0 ? rect.height : 0
+	};
+}
+//#endregion
+//#region src/presence/PresenceCaretOverlay.tsx
+/** Renders remote peers' selections as absolutely positioned boxes over
+* the editor root — a pure view of the presence slice (it never
+* mutates). A caret selection draws a caret bar; a range selection
+* (cross-block included) draws its highlight boxes — one per client rect
+* of each chain-block segment. The boxes are recomputed on presence
+* changes, on block snapshot changes (text shifts the pixels), and on
+* window resize; a peer whose block is not rendered (removed, unknown
+* type) draws nothing. The structural classes of the overlay boxes (the
+* per-peer hue comes from the inline --docblocks-presence-hue property,
+* the geometry from the inline layout properties): the caret bar is the
+* fixed width token; the range highlight is a softened box of the same
+* hue. */
+/**
+* The block ids a peer's selection references (the caret's block, the
+* range's endpoints + the chain blocks). The overlay stands no boxes over
+* the other blocks — those stand out of its subscription.
+*/
+function peerBlockIdsOf(presence) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const peer of presence) {
+		const selection = peer.selection;
+		if (selection === null) continue;
+		if ("blockId" in selection) ids.add(selection.blockId);
+		else if ("from" in selection) {
+			ids.add(selection.from.blockId);
+			ids.add(selection.to.blockId);
+			for (const id of selection.blocks ?? []) ids.add(id);
+		}
+	}
+	return [...ids].sort();
+}
+/** The peer-referenced blocks' snapshots (the absent ones stand dropped). The ids come from the remote presence frames — the open-key stand: `__proto__` stands the own property (no prototype reassignment over the derived map). */
+function peerBlocksOf(presence, blocks) {
+	const next = {};
+	for (const id of peerBlockIdsOf(presence)) {
+		const block = blocks[id];
+		if (block !== void 0) Object.defineProperty(next, id, {
+			value: block,
+			enumerable: true,
+			writable: true,
+			configurable: true
+		});
+	}
+	return next;
+}
+/**
+* The structural classes of the overlay boxes (the per-peer hue comes
+* from the inline --docblocks-presence-hue property, the geometry from
+* the inline layout properties). The caret bar is the fixed width token;
+* the range highlight is a softened box of the same hue.
+*/
+const CARET_CLASS = "pointer-events-none absolute w-(--docblocks-presence-caret-width) bg-[hsl(var(--docblocks-presence-hue,200)_var(--docblocks-presence-caret-saturation)_var(--docblocks-presence-caret-lightness))]";
+const RANGE_CLASS = "pointer-events-none absolute rounded-[2px] bg-[hsl(var(--docblocks-presence-hue,200)_var(--docblocks-presence-caret-saturation)_var(--docblocks-presence-caret-lightness)/var(--docblocks-presence-range-opacity))]";
+function PresenceCaretOverlay({ rootRef }) {
+	const { store, doc } = useEditorContext();
+	const presence = useStore(store, (state) => state.presence);
+	const peerIdsKeyRef = useRef("");
+	const peerBlocksCacheRef = useRef(null);
+	const peerBlocks = useStore(store, (state) => {
+		if (state.presence.length === 0) return null;
+		const ids = peerBlockIdsOf(state.presence);
+		const key = ids.join("\0");
+		const cache = peerBlocksCacheRef.current;
+		if (key === peerIdsKeyRef.current && cache !== null) {
+			let unchanged = true;
+			for (const id of ids) if (cache[id] !== state.blocks[id]) {
+				unchanged = false;
+				break;
+			}
+			if (unchanged) return cache;
+		}
+		const next = peerBlocksOf(state.presence, state.blocks);
+		peerIdsKeyRef.current = key;
+		peerBlocksCacheRef.current = next;
+		return next;
+	});
+	const [boxes, setBoxes] = useState([]);
+	useLayoutEffect(() => {
+		const root = rootRef.current;
+		if (root === null) return;
+		const recompute = () => {
+			const next = [];
+			for (const peer of presence) {
+				for (const point of caretPointsOf(peer.selection)) {
+					const block = root.querySelector(`[data-block-id="${CSS.escape(point.blockId)}"][data-slot="docblocks/block-content"]`) ?? root.querySelector(`[data-block-id="${CSS.escape(point.blockId)}"]`);
+					if (block === null) continue;
+					next.push({
+						key: `${peer.peerId}:caret:${point.blockId}:${point.offset}`,
+						peerId: peer.peerId,
+						slot: "docblocks/presence-caret",
+						...caretGeometry(root, block, point.offset)
+					});
+				}
+				for (const segment of rangeSegmentsOf(peer.selection, doc, peerBlocks ?? {})) {
+					const block = root.querySelector(`[data-block-id="${CSS.escape(segment.blockId)}"][data-slot="docblocks/block-content"]`);
+					if (block === null) continue;
+					const rects = rangeRects(root, block, segment.from, segment.to);
+					(rects.length > 0 ? rects : [{
+						left: 0,
+						top: 0,
+						width: 0,
+						height: 0
+					}]).forEach((rect, index) => {
+						next.push({
+							key: `${peer.peerId}:range:${segment.blockId}:${segment.from}-${segment.to}:${index}`,
+							peerId: peer.peerId,
+							slot: "docblocks/presence-range",
+							blockId: segment.blockId,
+							...rect
+						});
+					});
+				}
+			}
+			setBoxes((prev) => JSON.stringify(prev) === JSON.stringify(next) ? prev : next);
+		};
+		let frame = 0;
+		const scheduleRecompute = () => {
+			cancelAnimationFrame(frame);
+			frame = requestAnimationFrame(() => {
+				frame = 0;
+				recompute();
+			});
+		};
+		recompute();
+		scheduleRecompute();
+		window.addEventListener("resize", scheduleRecompute);
+		return () => {
+			cancelAnimationFrame(frame);
+			window.removeEventListener("resize", scheduleRecompute);
+		};
+	}, [
+		presence,
+		peerBlocks,
+		doc,
+		rootRef
+	]);
+	return /* @__PURE__ */ jsx(Fragment$1, { children: boxes.map((box) => /* @__PURE__ */ jsx("span", {
+		"data-slot": box.slot,
+		"data-peer": box.peerId,
+		"data-range-block": box.blockId,
+		className: box.slot === "docblocks/presence-caret" ? CARET_CLASS : RANGE_CLASS,
+		style: {
+			"--docblocks-presence-hue": peerHue(box.peerId),
+			left: box.left,
+			top: box.top,
+			height: box.height,
+			...box.width !== void 0 ? { width: box.width } : null
+		}
+	}, box.key)) });
+}
+//#endregion
+//#region src/presence/sharing.ts
+/**
+* Build the awareness payload of one publish. Returns null when the grant
+* is targeted over no cipher (the caller keeps the previous payload — the
+* degradation stands, no crash, no partial publish).
+*/
+async function buildPresencePayload(params) {
+	const { selection, sharing, viewMode, identity, crypto, seq, updatedAt } = params;
+	const payload = {
+		updatedAt,
+		seq
+	};
+	if (identity.userId !== void 0) payload.userId = identity.userId;
+	if (identity.name !== void 0) payload.name = identity.name;
+	if (viewMode || selection === null) {
+		payload.selection = null;
+		return payload;
+	}
+	if (sharing === "off") {
+		payload.selection = identity.userId === void 0 ? selection : null;
+		return payload;
+	}
+	if (sharing === "everyone") {
+		payload.selection = selection;
+		return payload;
+	}
+	if (crypto === null) return null;
+	payload.selection = null;
+	payload.selections = await crypto.encrypt(selection, sharing);
+	return payload;
+}
+/**
+* Resolve one received peer's selection: the plaintext one (the everyone /
+* legacy stand) stands as is; a targeted stand resolves to the first entry
+* the local cipher opens (the entries carry no target id, so every entry
+* is tried); without a cipher a targeted selection never stands (the
+* peer's identity frame still lists it in the roster).
+*/
+async function resolvePeerSelection(params) {
+	const { peer, crypto } = params;
+	if (peer.selection !== null) return peer;
+	if (peer.selections !== void 0 && crypto !== null && peer.selections.length > 0) {
+		const selection = (await Promise.all(peer.selections.map((entry) => crypto.decrypt(entry)))).find((value) => value !== null) ?? null;
+		return {
+			...peer,
+			selection
+		};
+	}
+	return peer;
+}
+//#endregion
 //#region src/state/utils.ts
 /** The editor store's projection utils: the known-type blocks filter
 * (the store's projection holds only known-type blocks — an unknown-type
@@ -11534,9 +11860,11 @@ function createEditorStore(doc, rootId) {
 		selection: { kind: "none" },
 		collapsedIds: [],
 		presence: [],
+		sharing: "off",
 		canvasClipboard: null,
 		applyChange,
 		setPresence: (peers) => store.setState({ presence: peers }),
+		setSharing: (mode) => store.setState({ sharing: mode }),
 		setSelection: (selection) => store.setState({ selection }),
 		setCollapsed: (id, collapsed) => {
 			const ids = store.getState().collapsedIds;
@@ -11616,7 +11944,7 @@ function publishedStandKey(doc) {
 * its own. Safe under StrictMode double-mount: the cleanup detaches every
 * subscription and destroys the view between the two mounts.
 */
-function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blobStore, databaseBridge, syncEmbedResolver, pdfPreview, mentionProvider, embedSandbox, rootBlockId, commandPalettePlaceholder, accessLevel, mode, publishedDoc, children }) {
+function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blobStore, databaseBridge, syncEmbedResolver, pdfPreview, mentionProvider, embedSandbox, rootBlockId, commandPalettePlaceholder, accessLevel, mode, publishedDoc, presence, children }) {
 	const rootId = rootBlockId ?? doc.meta.id;
 	const [store] = useState(() => createEditorStore(doc, rootId));
 	const docRef = useRef(doc);
@@ -11626,6 +11954,10 @@ function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blob
 	const effectiveAccessLevel = accessLevel ?? parentContext?.accessLevel ?? "editor";
 	const effectiveMode = effectiveAccessLevel === "viewer" ? "published" : mode ?? parentContext?.mode ?? "edit";
 	const editingStandRef = useRef(effectiveMode === "edit");
+	const presenceRef = useRef(presence);
+	presenceRef.current = presence;
+	const viewModeRef = useRef(effectiveMode !== "edit");
+	viewModeRef.current = effectiveMode !== "edit";
 	useEffect(() => {
 		if (docRef.current !== doc) throw new Error("EditorProvider: the doc instance must not change after mount.");
 		docRef.current = doc;
@@ -11663,21 +11995,54 @@ function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blob
 	useEffect(() => {
 		if (provider === void 0) return;
 		let lastPeers = "";
-		const unsubscribeAwareness = provider.onAwareness((peers) => {
-			const serialized = JSON.stringify(peers);
+		const latest = /* @__PURE__ */ new Map();
+		let generation = 0;
+		const unsubscribeAwareness = provider.onAwareness((rawPeers) => {
+			const serialized = JSON.stringify(rawPeers);
 			if (serialized === lastPeers) return;
 			lastPeers = serialized;
-			store.getState().setPresence(peers);
+			const rawIds = new Set(rawPeers.map((peer) => peer.peerId));
+			for (const id of [...latest.keys()]) if (!rawIds.has(id)) latest.delete(id);
+			for (const peer of rawPeers) {
+				const prev = latest.get(peer.peerId);
+				if (peer.seq !== void 0 && prev?.seq !== void 0 && peer.seq < prev.seq) continue;
+				latest.set(peer.peerId, peer);
+			}
+			const gen = ++generation;
+			const crypto = presenceRef.current?.crypto ?? null;
+			const input = [...latest.values()];
+			(async () => {
+				const resolved = [];
+				for (const peer of input) resolved.push(await resolvePeerSelection({
+					peer,
+					crypto
+				}));
+				if (gen !== generation) return;
+				store.getState().setPresence(resolved);
+			})();
 		});
 		return () => unsubscribeAwareness();
 	}, [provider, store]);
 	useEffect(() => {
 		if (provider === void 0) return;
+		let seq = 0;
+		let publishToken = 0;
 		const publish = (selection) => {
-			provider.setAwareness({
-				selection: presenceSelectionOf(selection),
-				updatedAt: Date.now()
-			});
+			const token = ++publishToken;
+			const sharing = store.getState().sharing;
+			(async () => {
+				const payload = await buildPresencePayload({
+					selection: presenceSelectionOf(selection),
+					sharing,
+					viewMode: viewModeRef.current,
+					identity: presenceRef.current ?? {},
+					crypto: presenceRef.current?.crypto ?? null,
+					seq: ++seq,
+					updatedAt: Date.now()
+				});
+				if (token !== publishToken || payload === null) return;
+				provider.setAwareness(payload);
+			})();
 		};
 		let timer;
 		const queue = (selection) => {
@@ -11687,28 +12052,29 @@ function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blob
 				publish(selection);
 			}, 50);
 		};
-		const publishNoneNow = () => {
+		const publishNow = (selection) => {
 			if (timer !== void 0) {
 				clearTimeout(timer);
 				timer = void 0;
 			}
-			publish({ kind: "none" });
-		};
-		const publishCurrentNow = () => {
-			if (timer !== void 0) return;
-			publish(store.getState().selection);
+			publish(selection);
 		};
 		const unsubscribe = store.subscribe((state, prev) => {
 			if (state.selection !== prev.selection) queue(state.selection);
+			if (state.sharing !== prev.sharing) publish(store.getState().selection);
 		});
-		window.addEventListener("blur", publishNoneNow);
-		window.addEventListener("beforeunload", publishNoneNow);
-		window.addEventListener("focus", publishCurrentNow);
+		const onBlur = () => publishNow({ kind: "none" });
+		const onFocus = () => {
+			if (timer !== void 0) return;
+			publishNow(store.getState().selection);
+		};
+		window.addEventListener("blur", onBlur);
+		window.addEventListener("beforeunload", onBlur);
+		window.addEventListener("focus", onFocus);
 		return () => {
 			unsubscribe();
-			window.removeEventListener("blur", publishNoneNow);
-			window.removeEventListener("beforeunload", publishNoneNow);
-			window.removeEventListener("focus", publishCurrentNow);
+			window.removeEventListener("blur", onBlur);
+			window.removeEventListener("beforeunload", onBlur);
 			if (timer !== void 0) clearTimeout(timer);
 		};
 	}, [provider, store]);
@@ -11737,7 +12103,8 @@ function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blob
 			commandPalettePlaceholder: commandPalettePlaceholder ?? parent?.commandPalettePlaceholder ?? "Type '/' for commands",
 			accessLevel: effectiveAccessLevel,
 			mode: effectiveMode,
-			viewMode: effectiveMode !== "edit"
+			viewMode: effectiveMode !== "edit",
+			presence: presence ?? null
 		};
 	}, [
 		store,
@@ -11753,7 +12120,8 @@ function EditorProviderStand({ doc, provider, blockRenderers, blobResolver, blob
 		mentionProvider,
 		embedSandbox,
 		effectiveAccessLevel,
-		effectiveMode
+		effectiveMode,
+		presence
 	]);
 	const inheritedPublishedStand = parentContext !== null && parentContext.mode === "published";
 	const rendered = effectiveAccessLevel === "viewer" && parentContext === null ? children : effectiveMode === "published" ? publishedDoc !== void 0 && publishedDoc !== null ? /* @__PURE__ */ jsx(EditorProvider, {
@@ -28570,242 +28938,6 @@ function useMotionDrag({ doc, rootBlockId, store, rootRef, rowKeys, nodesById })
 	};
 }
 //#endregion
-//#region src/presence/utils.ts
-/** Deterministic hue (0–359) from the peer id (pure function, no peer state). */
-function peerHue(peerId) {
-	let hash = 0;
-	for (let i = 0; i < peerId.length; i++) hash = hash * 31 + peerId.charCodeAt(i) >>> 0;
-	return hash % 360;
-}
-/** The caret endpoints a peer's wire selection draws; a range draws range boxes instead. */
-function caretPointsOf(selection) {
-	if (selection === null) return [];
-	if ("blockId" in selection) return [{
-		blockId: selection.blockId,
-		offset: selection.offset
-	}];
-	return [];
-}
-/**
-* The per-chain-block segments of a peer's range selection: the from block's
-* tail, the middle text blocks in full, the to block's head. Chain blocks
-* missing from the store (stale presence — the remote selection points at a
-* removed block) are skipped leniently, and the offsets clamp to the current
-* block lengths.
-*/
-function rangeSegmentsOf(selection, doc, blocks) {
-	if (selection === null || !("from" in selection)) return [];
-	const chain = selection.blocks ?? (selection.from.blockId === selection.to.blockId ? [selection.from.blockId] : [selection.from.blockId, selection.to.blockId]);
-	const segments = [];
-	for (const blockId of chain) {
-		if (blocks[blockId] === void 0) continue;
-		const length = doc.getTextLength(blockId);
-		const from = blockId === selection.from.blockId ? selection.from.offset : 0;
-		const to = blockId === selection.to.blockId ? Math.min(selection.to.offset, length) : length;
-		if (from >= to || from >= length) continue;
-		segments.push({
-			blockId,
-			from,
-			to
-		});
-	}
-	return segments;
-}
-/**
-* The client rects of a segment inside the block element, relative to the
-* root's rect. Environments without layout (jsdom — no getClientRects)
-* yield no rects, so a missing rect maps to a single zero box.
-*/
-function rangeRects(root, block, from, to) {
-	const rootRect = root.getBoundingClientRect();
-	const start = locatePosition(block, from);
-	const end = locatePosition(block, to);
-	const range = document.createRange();
-	range.setStart(start.node, start.offset);
-	range.setEnd(end.node, end.offset);
-	if (typeof range.getClientRects !== "function") return [];
-	return Array.from(range.getClientRects()).map((rect) => ({
-		left: rect.left - rootRect.left,
-		top: rect.top - rootRect.top,
-		width: rect.width,
-		height: rect.height
-	}));
-}
-/**
-* The client rect of a collapsed range at the flat offset inside the
-* block element, relative to the root's rect. Environments without layout
-* (jsdom — no getClientRects) yield zero rects, so a missing rect maps to 0.
-*/
-function caretGeometry(root, block, offset) {
-	const position = locatePosition(block, offset);
-	const range = document.createRange();
-	range.setStart(position.node, position.offset);
-	range.collapse(true);
-	let rect;
-	if (typeof range.getClientRects === "function") {
-		const rects = range.getClientRects();
-		rect = rects.length > 0 ? rects[0] : void 0;
-	}
-	const rootRect = root.getBoundingClientRect();
-	return {
-		left: rect !== void 0 ? rect.left - rootRect.left : 0,
-		top: rect !== void 0 ? rect.top - rootRect.top : 0,
-		height: rect !== void 0 ? rect.height : 0
-	};
-}
-//#endregion
-//#region src/presence/PresenceCaretOverlay.tsx
-/** Renders remote peers' selections as absolutely positioned boxes over
-* the editor root — a pure view of the presence slice (it never
-* mutates). A caret selection draws a caret bar; a range selection
-* (cross-block included) draws its highlight boxes — one per client rect
-* of each chain-block segment. The boxes are recomputed on presence
-* changes, on block snapshot changes (text shifts the pixels), and on
-* window resize; a peer whose block is not rendered (removed, unknown
-* type) draws nothing. The structural classes of the overlay boxes (the
-* per-peer hue comes from the inline --docblocks-presence-hue property,
-* the geometry from the inline layout properties): the caret bar is the
-* fixed width token; the range highlight is a softened box of the same
-* hue. */
-/**
-* The block ids a peer's selection references (the caret's block, the
-* range's endpoints + the chain blocks). The overlay stands no boxes over
-* the other blocks — those stand out of its subscription.
-*/
-function peerBlockIdsOf(presence) {
-	const ids = /* @__PURE__ */ new Set();
-	for (const peer of presence) {
-		const selection = peer.selection;
-		if (selection === null) continue;
-		if ("blockId" in selection) ids.add(selection.blockId);
-		else if ("from" in selection) {
-			ids.add(selection.from.blockId);
-			ids.add(selection.to.blockId);
-			for (const id of selection.blocks ?? []) ids.add(id);
-		}
-	}
-	return [...ids].sort();
-}
-/** The peer-referenced blocks' snapshots (the absent ones stand dropped). The ids come from the remote presence frames — the open-key stand: `__proto__` stands the own property (no prototype reassignment over the derived map). */
-function peerBlocksOf(presence, blocks) {
-	const next = {};
-	for (const id of peerBlockIdsOf(presence)) {
-		const block = blocks[id];
-		if (block !== void 0) Object.defineProperty(next, id, {
-			value: block,
-			enumerable: true,
-			writable: true,
-			configurable: true
-		});
-	}
-	return next;
-}
-/**
-* The structural classes of the overlay boxes (the per-peer hue comes
-* from the inline --docblocks-presence-hue property, the geometry from
-* the inline layout properties). The caret bar is the fixed width token;
-* the range highlight is a softened box of the same hue.
-*/
-const CARET_CLASS = "pointer-events-none absolute w-(--docblocks-presence-caret-width) bg-[hsl(var(--docblocks-presence-hue,200)_var(--docblocks-presence-caret-saturation)_var(--docblocks-presence-caret-lightness))]";
-const RANGE_CLASS = "pointer-events-none absolute rounded-[2px] bg-[hsl(var(--docblocks-presence-hue,200)_var(--docblocks-presence-caret-saturation)_var(--docblocks-presence-caret-lightness)/var(--docblocks-presence-range-opacity))]";
-function PresenceCaretOverlay({ rootRef }) {
-	const { store, doc } = useEditorContext();
-	const presence = useStore(store, (state) => state.presence);
-	const peerIdsKeyRef = useRef("");
-	const peerBlocksCacheRef = useRef(null);
-	const peerBlocks = useStore(store, (state) => {
-		if (state.presence.length === 0) return null;
-		const ids = peerBlockIdsOf(state.presence);
-		const key = ids.join("\0");
-		const cache = peerBlocksCacheRef.current;
-		if (key === peerIdsKeyRef.current && cache !== null) {
-			let unchanged = true;
-			for (const id of ids) if (cache[id] !== state.blocks[id]) {
-				unchanged = false;
-				break;
-			}
-			if (unchanged) return cache;
-		}
-		const next = peerBlocksOf(state.presence, state.blocks);
-		peerIdsKeyRef.current = key;
-		peerBlocksCacheRef.current = next;
-		return next;
-	});
-	const [boxes, setBoxes] = useState([]);
-	useLayoutEffect(() => {
-		const root = rootRef.current;
-		if (root === null) return;
-		const recompute = () => {
-			const next = [];
-			for (const peer of presence) {
-				for (const point of caretPointsOf(peer.selection)) {
-					const block = root.querySelector(`[data-block-id="${CSS.escape(point.blockId)}"][data-slot="docblocks/block-content"]`) ?? root.querySelector(`[data-block-id="${CSS.escape(point.blockId)}"]`);
-					if (block === null) continue;
-					next.push({
-						key: `${peer.peerId}:caret:${point.blockId}:${point.offset}`,
-						peerId: peer.peerId,
-						slot: "docblocks/presence-caret",
-						...caretGeometry(root, block, point.offset)
-					});
-				}
-				for (const segment of rangeSegmentsOf(peer.selection, doc, peerBlocks ?? {})) {
-					const block = root.querySelector(`[data-block-id="${CSS.escape(segment.blockId)}"][data-slot="docblocks/block-content"]`);
-					if (block === null) continue;
-					const rects = rangeRects(root, block, segment.from, segment.to);
-					(rects.length > 0 ? rects : [{
-						left: 0,
-						top: 0,
-						width: 0,
-						height: 0
-					}]).forEach((rect, index) => {
-						next.push({
-							key: `${peer.peerId}:range:${segment.blockId}:${segment.from}-${segment.to}:${index}`,
-							peerId: peer.peerId,
-							slot: "docblocks/presence-range",
-							blockId: segment.blockId,
-							...rect
-						});
-					});
-				}
-			}
-			setBoxes((prev) => JSON.stringify(prev) === JSON.stringify(next) ? prev : next);
-		};
-		let frame = 0;
-		const scheduleRecompute = () => {
-			cancelAnimationFrame(frame);
-			frame = requestAnimationFrame(() => {
-				frame = 0;
-				recompute();
-			});
-		};
-		recompute();
-		scheduleRecompute();
-		window.addEventListener("resize", scheduleRecompute);
-		return () => {
-			cancelAnimationFrame(frame);
-			window.removeEventListener("resize", scheduleRecompute);
-		};
-	}, [
-		presence,
-		peerBlocks,
-		doc,
-		rootRef
-	]);
-	return /* @__PURE__ */ jsx(Fragment$1, { children: boxes.map((box) => /* @__PURE__ */ jsx("span", {
-		"data-slot": box.slot,
-		"data-peer": box.peerId,
-		"data-range-block": box.blockId,
-		className: box.slot === "docblocks/presence-caret" ? CARET_CLASS : RANGE_CLASS,
-		style: {
-			"--docblocks-presence-hue": peerHue(box.peerId),
-			left: box.left,
-			top: box.top,
-			height: box.height,
-			...box.width !== void 0 ? { width: box.width } : null
-		}
-	}, box.key)) });
-}
-//#endregion
 //#region src/Editor.tsx
 /**
 * The document's editor: the root is the editor's focus/keyboard scope
@@ -28947,4 +29079,4 @@ function Editor({ view = "page", formatPalette = FORMAT_PALETTE }) {
 	});
 }
 //#endregion
-export { PopoverHeader as $, SelectTrigger as A, isBridgeErrorCode as At, DropdownMenuRadioGroup as B, useMeta as Bt, SelectContent as C, BASELINE_CAPABILITIES as Ct, SelectScrollDownButton as D, BRIDGE_ERROR_CODES as Dt, SelectLabel as E, validateProtocolDescriptor as Et, DropdownMenuContent as F, columnAnnotation as Ft, DropdownMenuSubContent as G, INLINE_CODE_CLASS as Gt, DropdownMenuSeparator as H, useSelection as Ht, DropdownMenuGroup as I, ScrollArea as It, Separator as J, createMemoryBlobStore as Jt, DropdownMenuSubTrigger as K, renderRuns as Kt, DropdownMenuItem as L, Input as Lt, Label as M, conditionMatches as Mt, DropdownMenu as N, parseCellValue as Nt, SelectScrollUpButton as O, BridgeError as Ot, DropdownMenuCheckboxItem as P, TEXT_TYPES as Pt, PopoverDescription as Q, DropdownMenuLabel as R, useBlock as Rt, Select as S, AlertTitle as St, SelectItem as T, isDatabaseBridge as Tt, DropdownMenuShortcut as U, useSelectionView as Ut, DropdownMenuRadioItem as V, usePresence as Vt, DropdownMenuSub as W, useText as Wt, PopoverAnchor as X, Popover as Y, PopoverContent as Z, FilterBuilder as _, BareSelect as _t, SHAPE_FONT_STACKS as a, CardAction as at, Skeleton as b, Alert as bt, textOf as c, CardFooter as ct, useEditorContext as d, Pen as dt, PopoverTitle as et, DEFAULT_EMBED_SANDBOX as f, Eye as ft, newMutationContext as g, buttonVariants as gt, cellValueEqual as h, Button as ht, SHAPE_FONT_OPTIONS as i, Card as it, SelectValue as j, toBridgeError as jt, SelectSeparator as k, isBridgeError as kt, markToggleAction as l, CardHeader as lt, useDatabaseTable as m, BookOpen as mt, childrenSlot as n, DocblocksI18nProvider as nt, FORMAT_PALETTE as o, CardContent as ot, GridBody as p, CodeXml as pt, DropdownMenuTrigger as q, blobSubtypeOf as qt, CodeHeader as r, Checkbox as rt, TextBlock as s, CardDescription as st, Editor as t, PopoverTrigger as tt, EditorProvider as u, CardTitle as ut, emptyFilter as v, Badge as vt, SelectGroup as w, PROTOCOL_VERSION as wt, SegmentSelector as x, AlertDescription as xt, filterIsComplete as y, badgeVariants as yt, DropdownMenuPortal as z, useDoc as zt };
+export { PopoverHeader as $, SelectTrigger as A, isBridgeErrorCode as At, DropdownMenuRadioGroup as B, useMeta as Bt, SelectContent as C, BASELINE_CAPABILITIES as Ct, SelectScrollDownButton as D, BRIDGE_ERROR_CODES as Dt, SelectLabel as E, validateProtocolDescriptor as Et, DropdownMenuContent as F, columnAnnotation as Ft, DropdownMenuSubContent as G, useText as Gt, DropdownMenuSeparator as H, usePresenceSharing as Ht, DropdownMenuGroup as I, ScrollArea as It, Separator as J, blobSubtypeOf as Jt, DropdownMenuSubTrigger as K, INLINE_CODE_CLASS as Kt, DropdownMenuItem as L, Input as Lt, Label as M, conditionMatches as Mt, DropdownMenu as N, parseCellValue as Nt, SelectScrollUpButton as O, BridgeError as Ot, DropdownMenuCheckboxItem as P, TEXT_TYPES as Pt, PopoverDescription as Q, DropdownMenuLabel as R, useBlock as Rt, Select as S, AlertTitle as St, SelectItem as T, isDatabaseBridge as Tt, DropdownMenuShortcut as U, useSelection as Ut, DropdownMenuRadioItem as V, usePresence as Vt, DropdownMenuSub as W, useSelectionView as Wt, PopoverAnchor as X, Popover as Y, createMemoryBlobStore as Yt, PopoverContent as Z, FilterBuilder as _, BareSelect as _t, SHAPE_FONT_STACKS as a, CardAction as at, Skeleton as b, Alert as bt, textOf as c, CardFooter as ct, useEditorContext as d, Pen as dt, PopoverTitle as et, DEFAULT_EMBED_SANDBOX as f, Eye as ft, newMutationContext as g, buttonVariants as gt, cellValueEqual as h, Button as ht, SHAPE_FONT_OPTIONS as i, Card as it, SelectValue as j, toBridgeError as jt, SelectSeparator as k, isBridgeError as kt, markToggleAction as l, CardHeader as lt, useDatabaseTable as m, BookOpen as mt, childrenSlot as n, DocblocksI18nProvider as nt, FORMAT_PALETTE as o, CardContent as ot, GridBody as p, CodeXml as pt, DropdownMenuTrigger as q, renderRuns as qt, CodeHeader as r, Checkbox as rt, TextBlock as s, CardDescription as st, Editor as t, PopoverTrigger as tt, EditorProvider as u, CardTitle as ut, emptyFilter as v, Badge as vt, SelectGroup as w, PROTOCOL_VERSION as wt, SegmentSelector as x, AlertDescription as xt, filterIsComplete as y, badgeVariants as yt, DropdownMenuPortal as z, useDoc as zt };

package/dist/{index-DOKS86aH.d.mts → index-DG0lJy_t.d.mts}

@@ -1,6 +1,6 @@
 import { n as BlockRendererMap } from "./index-YJcgf8Hh.mjs";
 import { ComponentType, ReactNode } from "react";
-import { Block, BlockContent, BlockId, BlockType, CanvasTextAttrs, Change, ConnectorAttrs, DatabaseFilterPayload, Doc, DocMeta, Geometry, PresenceState, Selection, SelectionView, ShapeAttrs, SyncEmbedRef, SyncProvider } from "docblocks-core";
+import { Block, BlockContent, BlockId, BlockType, CanvasTextAttrs, Change, ConnectorAttrs, DatabaseFilterPayload, Doc, DocMeta, Geometry, PresenceSelection, PresenceState, Selection, SelectionView, ShapeAttrs, SyncEmbedRef, SyncProvider } from "docblocks-core";
 import { StoreApi } from "zustand/vanilla";
 //#region src/blob-store.d.ts
 /**
@@ -796,6 +796,50 @@ declare function DatabaseTable({ bridge, tableId, readOnly, view, onViewChange }
  */
 declare function useTableList(bridge: DatabaseBridge): UseTableList;
 //#endregion
+//#region src/presence/models.d.ts
+/** The local selection's sharing grant: no sharing, sharing over the whole
+ *  room (plaintext), or a targeted user-id list (encrypted per target). */
+type PresenceSharingMode = "off" | "everyone" | string[];
+/**
+ * The consumer's selection cipher (the privacy's stand): the library
+ * orchestrates the publish/receive pipeline and the consumer brings the
+ * keys. An entry is an opaque string — the algorithm is the consumer's
+ * choice.
+ */
+interface PresenceCrypto {
+  /**
+   * Encrypt the local selection for the grant: one opaque entry per target
+   * (grant order; no target id inside an entry — the recipient tries each
+   * entry with its own `decrypt`).
+   */
+  encrypt(selection: PresenceSelection, grant: string[]): Promise<string[]>;
+  /** Try to decrypt a received entry for the local user. Null when the entry is not addressed to the local user. */
+  decrypt(entry: string): Promise<PresenceSelection | null>;
+}
+/** One live roster entry: the peer's identity and whether its selection stands visible to the local user. */
+interface PresencePeer {
+  peerId: string;
+  userId?: string;
+  name?: string;
+  updatedAt: number;
+  /** True when the peer's selection is accepted locally (decrypted, everyone, or legacy plaintext). */
+  selectionVisible: boolean;
+}
+/** The presence sharing's session state (per EditorProvider instance). */
+interface PresenceSharing {
+  /** The local grant (session state; the default "off"; not persisted, not on the wire). */
+  sharing: PresenceSharingMode;
+  /** Set the local grant. A no-op over the read-only modes. */
+  setSharing: (mode: PresenceSharingMode) => void;
+  /** The live roster of the connected peers (the identity frames are always published). */
+  peers: PresencePeer[];
+}
+/** The presence identity's wire payload: the stable user id + the optional display label. */
+interface PresenceIdentity {
+  userId?: string;
+  name?: string;
+}
+//#endregion
 //#region src/canvas/clipboard.d.ts
 /** The one copied canvas item (the deep data; the ids stand the originals). */
 type ClipboardItem = {
@@ -872,6 +916,12 @@ interface EditorState {
   collapsedIds: BlockId[];
   /** Remote peers' ephemeral state; a separate slice for the same reason. */
   presence: PresenceState[];
+  /**
+   * The local selection's sharing grant (session state per provider
+   * instance; the default "off" — not document data, never on the wire).
+   * A separate slice so a grant change never re-renders blocks.
+   */
+  sharing: PresenceSharingMode;
   /**
    * The canvas clipboard: the deep copy of
    * the copied canvas items — the view state per editor (not doc data, no
@@ -886,6 +936,8 @@ interface EditorActions {
   applyChange: (change: Change) => void;
   /** Replaces the presence slice. */
   setPresence: (peers: PresenceState[]) => void;
+  /** Sets the local sharing grant. */
+  setSharing: (mode: PresenceSharingMode) => void;
   /** Replaces the selection slice. */
   setSelection: (selection: Selection) => void;
   /** Sets the collapsed state of one list item (view state, no doc command). */
@@ -937,6 +989,27 @@ interface MentionProvider {
 interface SelectionRef {
   view: SelectionView | null;
 }
+/**
+ * The local user's presence identity and the selection-sharing cipher
+ * (consumer session state — never document data). Without `userId` the
+ * peer is unaddressable: targeted sharing stands unavailable (the roster
+ * still lists the peer by its transport-level `peerId`). Without `crypto`
+ * the grant degrades to "off" / "everyone" (a targeted grant is a no-op).
+ */
+interface PresenceConfig {
+  /** The stable user id — the addressable identity on the wire. */
+  userId: string;
+  /** The roster display label (optional). */
+  name?: string;
+  /**
+   * The selection cipher (the targeted's stand): the local selection is
+   * encrypted per target for a targeted grant, and a received ciphertext
+   * entry is decrypted with the local user's keys. Opaque strings
+   * throughout — the algorithm is the consumer's choice. Without it, only
+   * "off" / "everyone" are available.
+   */
+  crypto?: PresenceCrypto;
+}
 /** The consumer's user access level: the available document modes. "viewer" is locked to the published's view (the current state is never rendered); "editor" (the default) may edit and view. Session state — not document data, never on the wire. */
 type AccessLevel = "viewer" | "editor";
 /** The document's mode (consumer-controlled view state, like the page/canvas `view`): "edit" (the default) is the live document editable; "view" is the live document read-only (the current state, still syncing); "published" is the `publishedDoc`'s snapshot read-only (static). */
@@ -977,6 +1050,8 @@ interface EditorContextValue {
   mode: EditorMode;
   /** True over the non-edit modes ("view" / "published"): every editing surface gates off (the read-only stand). */
   viewMode: boolean;
+  /** The presence identity + cipher (the provider's `presence` prop); null when none was supplied (the legacy's anonymous stand). */
+  presence: PresenceConfig | null;
 }
 interface EditorProviderProps {
   /**
@@ -1119,6 +1194,22 @@ interface EditorProviderProps {
    * inherits the enclosing value, like the resolvers.
    */
   commandPalettePlaceholder?: string;
+  /**
+   * Optional presence identity + the selection-sharing cipher (consumer
+   * session state, never document data): the local user's stable `userId`
+   * (the addressable identity on the wire), the optional roster label, and
+   * the optional `PresenceCrypto` cipher (without it a targeted grant
+   * degrades to "off" / "everyone": the hook's setter stands a no-op over
+   * a targeted grant without the identity or the cipher). With the prop
+   * the selection sharing grant is session state
+   * driven through `usePresenceSharing()` (the default "off" — the
+   * privacy stand); without it the provider keeps the legacy stand (the
+   * anonymous plaintext selection — always shared over the room).
+   *
+   * Like the other customization values, the value is read per render:
+   * pass a stable reference.
+   */
+  presence?: PresenceConfig;
   children: ReactNode;
 }
 //#endregion
@@ -1150,4 +1241,4 @@ declare const DEFAULT_EMBED_SANDBOX = "allow-scripts allow-forms allow-popups";
 /** Read the per-instance editor context; throws outside an EditorProvider. */
 declare function useEditorContext(): EditorContextValue;
 //#endregion
-export { SortInput as $, BridgeValueInput as A, MutationContext as B, emptyFilter as C, BridgeColumn as D, BatchOp as E, DomainEvent as F, ProtocolCapability as G, OperationStatus as H, FilterConditionInput as I, QueryOperator as J, ProtocolDescriptor as K, FilterInput as L, CellValueParse as M, Column as N, BridgeColumnAnnotation as O, DatabaseBridge as P, RowWire as Q, Id as R, UseDatabaseTable as S, FilterBuilder as T, PageQuery as U, MutationReceipt as V, PageSnapshot as W, Revision as X, QuerySemantics as Y, RowPage as Z, DatabaseTableView as _, BlobSubtype as _t, EditorContextValue as a, TableEvent as at, DatabaseTablePhase as b, EmbedSandboxPolicy as c, BRIDGE_ERROR_CODES as ct, PdfPreview as d, isBridgeError as dt, SubscriptionHandle as et, PdfPreviewProps as f, isBridgeErrorCode as ft, DatabaseTableProps as g, BlobStore as gt, DatabaseTable as h, BlobRef as ht, AccessLevel as i, TableEnvelopeBase as it, CellMap as j, BridgeTableDescription as k, MentionEntry as l, BridgeError as lt, useTableList as m, BlobMeta as mt, DEFAULT_EMBED_SANDBOX as n, SubscriptionStatus as nt, EditorMode as o, TableRef as ot, SyncEmbedResolver as p, toBridgeError as pt, ProtocolLimits as q, EditorProvider as r, TableDescription as rt, EditorProviderProps as s, TableSnapshot as st, useEditorContext as t, SubscriptionObserver as tt, MentionProvider as u, BridgeErrorCode as ut, UseTableList as v, blobSubtypeOf as vt, filterIsComplete as w, DatabaseTableRow as x, useDatabaseTable as y, createMemoryBlobStore as yt, IsoInstant as z };
+export { ProtocolLimits as $, filterIsComplete as A, DatabaseBridge as B, DatabaseTableView as C, BlobSubtype as Ct, DatabaseTableRow as D, DatabaseTablePhase as E, BridgeTableDescription as F, IsoInstant as G, FilterConditionInput as H, BridgeValueInput as I, OperationStatus as J, MutationContext as K, CellMap as L, BatchOp as M, BridgeColumn as N, UseDatabaseTable as O, BridgeColumnAnnotation as P, ProtocolDescriptor as Q, CellValueParse as R, DatabaseTableProps as S, BlobStore as St, useDatabaseTable as T, createMemoryBlobStore as Tt, FilterInput as U, DomainEvent as V, Id as W, PageSnapshot as X, PageQuery as Y, ProtocolCapability as Z, PresencePeer as _, isBridgeError as _t, EditorContextValue as a, SortInput as at, useTableList as b, BlobMeta as bt, EmbedSandboxPolicy as c, SubscriptionStatus as ct, PdfPreview as d, TableEvent as dt, QueryOperator as et, PdfPreviewProps as f, TableRef as ft, PresenceIdentity as g, BridgeErrorCode as gt, PresenceCrypto as h, BridgeError as ht, AccessLevel as i, RowWire as it, FilterBuilder as j, emptyFilter as k, MentionEntry as l, TableDescription as lt, SyncEmbedResolver as m, BRIDGE_ERROR_CODES as mt, DEFAULT_EMBED_SANDBOX as n, Revision as nt, EditorMode as o, SubscriptionHandle as ot, PresenceConfig as p, TableSnapshot as pt, MutationReceipt as q, EditorProvider as r, RowPage as rt, EditorProviderProps as s, SubscriptionObserver as st, useEditorContext as t, QuerySemantics as tt, MentionProvider as u, TableEnvelopeBase as ut, PresenceSharing as v, isBridgeErrorCode as vt, UseTableList as w, blobSubtypeOf as wt, DatabaseTable as x, BlobRef as xt, PresenceSharingMode as y, toBridgeError as yt, Column as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { n as BlockRendererMap, r as BlockRendererProps, t as BlockRenderer } from "./index-YJcgf8Hh.mjs";
-import { $ as SortInput, A as BridgeValueInput, B as MutationContext, C as emptyFilter, D as BridgeColumn, E as BatchOp, F as DomainEvent, G as ProtocolCapability, H as OperationStatus, I as FilterConditionInput, J as QueryOperator, K as ProtocolDescriptor, L as FilterInput, M as CellValueParse, N as Column, O as BridgeColumnAnnotation, P as DatabaseBridge, Q as RowWire, R as Id, S as UseDatabaseTable, T as FilterBuilder, U as PageQuery, V as MutationReceipt, W as PageSnapshot, X as Revision, Y as QuerySemantics, Z as RowPage, _ as DatabaseTableView, _t as BlobSubtype, a as EditorContextValue, at as TableEvent, b as DatabaseTablePhase, c as EmbedSandboxPolicy, ct as BRIDGE_ERROR_CODES, d as PdfPreview, dt as isBridgeError, et as SubscriptionHandle, f as PdfPreviewProps, ft as isBridgeErrorCode, g as DatabaseTableProps, gt as BlobStore, h as DatabaseTable, ht as BlobRef, i as AccessLevel, it as TableEnvelopeBase, j as CellMap, k as BridgeTableDescription, l as MentionEntry, lt as BridgeError, m as useTableList, mt as BlobMeta, n as DEFAULT_EMBED_SANDBOX, nt as SubscriptionStatus, o as EditorMode, ot as TableRef, p as SyncEmbedResolver, pt as toBridgeError, q as ProtocolLimits, r as EditorProvider, rt as TableDescription, s as EditorProviderProps, st as TableSnapshot, t as useEditorContext, tt as SubscriptionObserver, u as MentionProvider, ut as BridgeErrorCode, v as UseTableList, vt as blobSubtypeOf, w as filterIsComplete, x as DatabaseTableRow, y as useDatabaseTable, yt as createMemoryBlobStore, z as IsoInstant } from "./index-DOKS86aH.mjs";
+import { $ as ProtocolLimits, A as filterIsComplete, B as DatabaseBridge, C as DatabaseTableView, Ct as BlobSubtype, D as DatabaseTableRow, E as DatabaseTablePhase, F as BridgeTableDescription, G as IsoInstant, H as FilterConditionInput, I as BridgeValueInput, J as OperationStatus, K as MutationContext, L as CellMap, M as BatchOp, N as BridgeColumn, O as UseDatabaseTable, P as BridgeColumnAnnotation, Q as ProtocolDescriptor, R as CellValueParse, S as DatabaseTableProps, St as BlobStore, T as useDatabaseTable, Tt as createMemoryBlobStore, U as FilterInput, V as DomainEvent, W as Id, X as PageSnapshot, Y as PageQuery, Z as ProtocolCapability, _ as PresencePeer, _t as isBridgeError, a as EditorContextValue, at as SortInput, b as useTableList, bt as BlobMeta, c as EmbedSandboxPolicy, ct as SubscriptionStatus, d as PdfPreview, dt as TableEvent, et as QueryOperator, f as PdfPreviewProps, ft as TableRef, g as PresenceIdentity, gt as BridgeErrorCode, h as PresenceCrypto, ht as BridgeError, i as AccessLevel, it as RowWire, j as FilterBuilder, k as emptyFilter, l as MentionEntry, lt as TableDescription, m as SyncEmbedResolver, mt as BRIDGE_ERROR_CODES, n as DEFAULT_EMBED_SANDBOX, nt as Revision, o as EditorMode, ot as SubscriptionHandle, p as PresenceConfig, pt as TableSnapshot, q as MutationReceipt, r as EditorProvider, rt as RowPage, s as EditorProviderProps, st as SubscriptionObserver, t as useEditorContext, tt as QuerySemantics, u as MentionProvider, ut as TableEnvelopeBase, v as PresenceSharing, vt as isBridgeErrorCode, w as UseTableList, wt as blobSubtypeOf, x as DatabaseTable, xt as BlobRef, y as PresenceSharingMode, yt as toBridgeError, z as Column } from "./index-DG0lJy_t.mjs";
 import * as React from "react";
 import { ComponentType, ReactNode } from "react";
 import { Block, BlockId, BlockType, Doc, DocMeta, PresenceState, Selection, SelectionView, SyncEmbedRef, TextRun } from "docblocks-core";
@@ -193,6 +193,14 @@ declare function useText(id: BlockId): string;
 declare function useSelection(): Selection;
 /** Remote peers' ephemeral state; a separate slice for the same reason. */
 declare function usePresence(): PresenceState[];
+/**
+ * The presence sharing's session state (per provider instance): the local
+ * grant (the default "off" — the privacy stand), the grant's setter (a
+ * no-op over the read-only stand), and the live roster of the connected
+ * peers (the identity frames are always present, the selection only over
+ * the grant it stands shared).
+ */
+declare function usePresenceSharing(): PresenceSharing;
 /** The document meta; the reference is replaced only when the title changed. */
 declare function useMeta(): DocMeta;
 /**
@@ -286,7 +294,7 @@ declare function AlertDescription({ className, ...props }: React.ComponentProps<
 //#endregion
 //#region src/shared/ui/Badge.d.ts
 declare const badgeVariants: (props?: ({
-  variant?: "default" | "destructive" | "outline" | "secondary" | "custom" | null | undefined;
+  variant?: "default" | "custom" | "secondary" | "destructive" | "outline" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
   asChild?: boolean;
@@ -297,7 +305,7 @@ declare function BareSelect({ className, children, ...props }: React.ComponentPr
 //#endregion
 //#region src/shared/ui/Button.d.ts
 declare const buttonVariants: (props?: ({
-  variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+  variant?: "link" | "default" | "secondary" | "destructive" | "outline" | "ghost" | null | undefined;
   size?: "default" | "icon" | "sm" | "lg" | "xl" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, type, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
@@ -431,4 +439,4 @@ declare function TooltipContent({ className, sideOffset, children, ...props }: R
 //#region src/shared/ui/cn.d.ts
 declare function cn(...inputs: ClassValue[]): string;
 //#endregion
-export { type AccessLevel, Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, type BatchOp, type BlobMeta, type BlobRef, type BlobStore, type BlobSubtype, type BlockRenderer, type BlockRendererMap, type BlockRendererProps, type BridgeColumn, type BridgeColumnAnnotation, BridgeError, type BridgeErrorCode, type BridgeTableDescription, type BridgeValueInput, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellMap, type CellValueParse, Checkbox, type Column, DEFAULT_EMBED_SANDBOX, type DatabaseBridge, DatabaseTable, type DatabaseTablePhase, type DatabaseTableProps, type DatabaseTableRow, type DatabaseTableView, DocHeader, type DomainEvent, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, type EditorContextValue, type EditorMode, EditorProvider, type EditorProviderProps, type EditorView, type EmbedSandboxPolicy, FORMAT_PALETTE, FilterBuilder, type FilterConditionInput, type FilterInput, type FormatMark, type Id, Input, type IsoInstant, Label, MONO_FONT_STACK, type MentionEntry, type MentionProvider, type MutationContext, type MutationReceipt, type OperationStatus, PROTOCOL_VERSION, type PageQuery, type PageSnapshot, type PdfPreview, type PdfPreviewProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, type ProtocolCapability, type ProtocolDescriptor, type ProtocolLimits, type QueryOperator, type QuerySemantics, type Revision, type RowPage, type RowWire, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, type SortInput, type SubscriptionHandle, type SubscriptionObserver, type SubscriptionStatus, type SyncEmbedRef, type SyncEmbedResolver, TEXT_TYPES, type TableDescription, type TableEnvelopeBase, type TableEvent, type TableRef, type TableSnapshot, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, type UseDatabaseTable, type UseTableList, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, useSelection, useSelectionView, useTableList, useText, validateProtocolDescriptor };
+export { type AccessLevel, Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, type BatchOp, type BlobMeta, type BlobRef, type BlobStore, type BlobSubtype, type BlockRenderer, type BlockRendererMap, type BlockRendererProps, type BridgeColumn, type BridgeColumnAnnotation, BridgeError, type BridgeErrorCode, type BridgeTableDescription, type BridgeValueInput, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellMap, type CellValueParse, Checkbox, type Column, DEFAULT_EMBED_SANDBOX, type DatabaseBridge, DatabaseTable, type DatabaseTablePhase, type DatabaseTableProps, type DatabaseTableRow, type DatabaseTableView, DocHeader, type DomainEvent, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, type EditorContextValue, type EditorMode, EditorProvider, type EditorProviderProps, type EditorView, type EmbedSandboxPolicy, FORMAT_PALETTE, FilterBuilder, type FilterConditionInput, type FilterInput, type FormatMark, type Id, Input, type IsoInstant, Label, MONO_FONT_STACK, type MentionEntry, type MentionProvider, type MutationContext, type MutationReceipt, type OperationStatus, PROTOCOL_VERSION, type PageQuery, type PageSnapshot, type PdfPreview, type PdfPreviewProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, type PresenceConfig, type PresenceCrypto, type PresenceIdentity, type PresencePeer, type PresenceSharing, type PresenceSharingMode, type ProtocolCapability, type ProtocolDescriptor, type ProtocolLimits, type QueryOperator, type QuerySemantics, type Revision, type RowPage, type RowWire, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, type SortInput, type SubscriptionHandle, type SubscriptionObserver, type SubscriptionStatus, type SyncEmbedRef, type SyncEmbedResolver, TEXT_TYPES, type TableDescription, type TableEnvelopeBase, type TableEvent, type TableRef, type TableSnapshot, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, type UseDatabaseTable, type UseTableList, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, usePresenceSharing, useSelection, useSelectionView, useTableList, useText, validateProtocolDescriptor };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as PopoverHeader, A as SelectTrigger, At as isBridgeErrorCode, B as DropdownMenuRadioGroup, Bt as useMeta, C as SelectContent, Ct as BASELINE_CAPABILITIES, D as SelectScrollDownButton, Dt as BRIDGE_ERROR_CODES, E as SelectLabel, Et as validateProtocolDescriptor, F as DropdownMenuContent, Ft as columnAnnotation, G as DropdownMenuSubContent, H as DropdownMenuSeparator, Ht as useSelection, I as DropdownMenuGroup, It as ScrollArea, J as Separator, Jt as createMemoryBlobStore, K as DropdownMenuSubTrigger, Kt as renderRuns, L as DropdownMenuItem, Lt as Input, M as Label, Mt as conditionMatches, N as DropdownMenu, Nt as parseCellValue, O as SelectScrollUpButton, Ot as BridgeError, P as DropdownMenuCheckboxItem, Pt as TEXT_TYPES, Q as PopoverDescription, R as DropdownMenuLabel, Rt as useBlock, S as Select, St as AlertTitle, T as SelectItem, Tt as isDatabaseBridge, U as DropdownMenuShortcut, Ut as useSelectionView, V as DropdownMenuRadioItem, Vt as usePresence, W as DropdownMenuSub, Wt as useText, X as PopoverAnchor, Y as Popover, Z as PopoverContent, _ as FilterBuilder, _t as BareSelect, a as SHAPE_FONT_STACKS, at as CardAction, b as Skeleton, bt as Alert, ct as CardFooter, d as useEditorContext, dt as Pen, et as PopoverTitle, f as DEFAULT_EMBED_SANDBOX, ft as Eye, g as newMutationContext, gt as buttonVariants, h as cellValueEqual, ht as Button, i as SHAPE_FONT_OPTIONS, it as Card, j as SelectValue, jt as toBridgeError, k as SelectSeparator, kt as isBridgeError, l as markToggleAction, lt as CardHeader, m as useDatabaseTable, mt as BookOpen, nt as DocblocksI18nProvider, o as FORMAT_PALETTE, ot as CardContent, p as GridBody, q as DropdownMenuTrigger, qt as blobSubtypeOf, rt as Checkbox, st as CardDescription, t as Editor, tt as PopoverTrigger, u as EditorProvider, ut as CardTitle, v as emptyFilter, vt as Badge, w as SelectGroup, wt as PROTOCOL_VERSION, x as SegmentSelector, xt as AlertDescription, y as filterIsComplete, yt as badgeVariants, z as DropdownMenuPortal, zt as useDoc } from "./Editor-YAlRhGNW.mjs";
+import { $ as PopoverHeader, A as SelectTrigger, At as isBridgeErrorCode, B as DropdownMenuRadioGroup, Bt as useMeta, C as SelectContent, Ct as BASELINE_CAPABILITIES, D as SelectScrollDownButton, Dt as BRIDGE_ERROR_CODES, E as SelectLabel, Et as validateProtocolDescriptor, F as DropdownMenuContent, Ft as columnAnnotation, G as DropdownMenuSubContent, Gt as useText, H as DropdownMenuSeparator, Ht as usePresenceSharing, I as DropdownMenuGroup, It as ScrollArea, J as Separator, Jt as blobSubtypeOf, K as DropdownMenuSubTrigger, L as DropdownMenuItem, Lt as Input, M as Label, Mt as conditionMatches, N as DropdownMenu, Nt as parseCellValue, O as SelectScrollUpButton, Ot as BridgeError, P as DropdownMenuCheckboxItem, Pt as TEXT_TYPES, Q as PopoverDescription, R as DropdownMenuLabel, Rt as useBlock, S as Select, St as AlertTitle, T as SelectItem, Tt as isDatabaseBridge, U as DropdownMenuShortcut, Ut as useSelection, V as DropdownMenuRadioItem, Vt as usePresence, W as DropdownMenuSub, Wt as useSelectionView, X as PopoverAnchor, Y as Popover, Yt as createMemoryBlobStore, Z as PopoverContent, _ as FilterBuilder, _t as BareSelect, a as SHAPE_FONT_STACKS, at as CardAction, b as Skeleton, bt as Alert, ct as CardFooter, d as useEditorContext, dt as Pen, et as PopoverTitle, f as DEFAULT_EMBED_SANDBOX, ft as Eye, g as newMutationContext, gt as buttonVariants, h as cellValueEqual, ht as Button, i as SHAPE_FONT_OPTIONS, it as Card, j as SelectValue, jt as toBridgeError, k as SelectSeparator, kt as isBridgeError, l as markToggleAction, lt as CardHeader, m as useDatabaseTable, mt as BookOpen, nt as DocblocksI18nProvider, o as FORMAT_PALETTE, ot as CardContent, p as GridBody, q as DropdownMenuTrigger, qt as renderRuns, rt as Checkbox, st as CardDescription, t as Editor, tt as PopoverTrigger, u as EditorProvider, ut as CardTitle, v as emptyFilter, vt as Badge, w as SelectGroup, wt as PROTOCOL_VERSION, x as SegmentSelector, xt as AlertDescription, y as filterIsComplete, yt as badgeVariants, z as DropdownMenuPortal, zt as useDoc } from "./Editor-BvKqUGXH.mjs";
 import { c as cn, o as preventDefault } from "./constants-D4FTL0ph.mjs";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -406,16 +406,20 @@ function DatabaseTable({ bridge, tableId, readOnly = false, view, onViewChange }
 		}));
 		if (onViewChange !== void 0) onViewChange(typed);
 	}, [onViewChange]);
-	return /* @__PURE__ */ jsx(DocblocksI18nProvider, { children: /* @__PURE__ */ jsx(GridBody, {
-		bridge,
-		tableId,
-		filter: viewState.filter,
-		columnOrder: viewState.columnOrder,
-		hiddenColumns: viewState.hiddenColumns,
-		columnWidths: viewState.columnWidths,
-		onViewChange: handleViewChange,
-		readColumnOrder: () => viewRef.current.columnOrder,
-		readOnly
+	return /* @__PURE__ */ jsx(DocblocksI18nProvider, { children: /* @__PURE__ */ jsx("div", {
+		"data-slot": "docblocks/editor",
+		"data-readonly": readOnly ? "true" : void 0,
+		children: /* @__PURE__ */ jsx(GridBody, {
+			bridge,
+			tableId,
+			filter: viewState.filter,
+			columnOrder: viewState.columnOrder,
+			hiddenColumns: viewState.hiddenColumns,
+			columnWidths: viewState.columnWidths,
+			onViewChange: handleViewChange,
+			readColumnOrder: () => viewRef.current.columnOrder,
+			readOnly
+		})
 	}) });
 }
 //#endregion
@@ -748,4 +752,4 @@ const UI_FONT_STACK = "'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif
 */
 const MONO_FONT_STACK = "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
 //#endregion
-export { Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, BridgeError, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, DEFAULT_EMBED_SANDBOX, DatabaseTable, DocHeader, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, EditorProvider, FORMAT_PALETTE, FilterBuilder, Input, Label, MONO_FONT_STACK, PROTOCOL_VERSION, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, TEXT_TYPES, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, useSelection, useSelectionView, useTableList, useText, validateProtocolDescriptor };
+export { Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, BridgeError, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, DEFAULT_EMBED_SANDBOX, DatabaseTable, DocHeader, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, EditorProvider, FORMAT_PALETTE, FilterBuilder, Input, Label, MONO_FONT_STACK, PROTOCOL_VERSION, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, TEXT_TYPES, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, usePresenceSharing, useSelection, useSelectionView, useTableList, useText, validateProtocolDescriptor };

package/dist/mermaid/index.mjs

@@ -1,4 +1,4 @@
-import { Gt as INLINE_CODE_CLASS, St as AlertTitle, b as Skeleton, bt as Alert, c as textOf, d as useEditorContext, ft as Eye, n as childrenSlot, pt as CodeXml, r as CodeHeader, s as TextBlock, x as SegmentSelector, xt as AlertDescription } from "../Editor-YAlRhGNW.mjs";
+import { Kt as INLINE_CODE_CLASS, St as AlertTitle, b as Skeleton, bt as Alert, c as textOf, d as useEditorContext, ft as Eye, n as childrenSlot, pt as CodeXml, r as CodeHeader, s as TextBlock, x as SegmentSelector, xt as AlertDescription } from "../Editor-BvKqUGXH.mjs";
 import { n as TriangleAlert } from "../constants-D4FTL0ph.mjs";
 import { t as LoaderCircle } from "../LoaderCircle-AGVFE4IP.mjs";
 import { useEffect, useRef, useState } from "react";

package/dist/pdf/index.d.mts

@@ -1,4 +1,4 @@
-import { f as PdfPreviewProps } from "../index-DOKS86aH.mjs";
+import { f as PdfPreviewProps } from "../index-DG0lJy_t.mjs";
 //#region src/pdf/PdfFirstPage.d.ts
 declare function PdfFirstPage({ id, url, name }: PdfPreviewProps): import("react").JSX.Element;
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docblocks-react-ui",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "React rendering + editing layer for docblocks: hooks, block renderers, caret/selection, keyboard, clipboard.",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "docblocks-core": "^0.1.2",
+    "docblocks-core": "^0.1.3",
     "framer-motion": "^11.0.0 || ^12.0.0 || ^13.0.0 || ^14.0.0",
     "mermaid": "^12.0.0",
     "pdfjs-dist": "^6.0.0",