docblocks-react-ui 0.1.1 → 0.3.0

package/dist/{index-D6_ysSmQ.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
 /**
@@ -669,12 +669,11 @@ interface UseDatabaseTable {
     rowId: string;
     cells: Record<string, unknown>;
   }>): Promise<void>;
-  /** The mixed paste (the spec's paste batch): the visible rows' updates
-   *  (from the active row down) + the overflow's creates — ONE `batchRows`
-   *  (one transaction, one undo entry; the inverse = the updates' restore
-   *  + the created rows' deletion). The updates stand the optimistic
-   *  apply; the creates stand over the post-commit refresh. Returns the
-   *  created rows' ids. */
+  /** The mixed paste: the visible rows' updates (from the active row down)
+   *  + the overflow's creates — ONE `batchRows` (one transaction, one undo
+   *  entry; the inverse = the updates' restore + the created rows'
+   *  deletion). The updates stand the optimistic apply; the creates stand
+   *  over the post-commit refresh. Returns the created rows' ids. */
   pasteRows(input: {
     updates: Array<{
       rowId: string;
@@ -718,6 +717,129 @@ interface UseDatabaseTable {
  */
 declare function useDatabaseTable(bridge: DatabaseBridge, tableId: string, filter?: DatabaseFilterPayload): UseDatabaseTable;
 //#endregion
+//#region src/database/standalone/models.d.ts
+/**
+ * The database table's view settings — the standalone's `DatabaseTable`
+ * stand over the block's view attrs: the `filter`, the `columnOrder`, the
+ * `hiddenColumns`, the `columnWidths`, and the legacy `name` (the display
+ * stands the bridge's table name, as over the block — the `name` attr is
+ * the persistence's parity, not a display override). The schema's
+ * `views` / `viewType` attrs stand out of the UI's v1 (the view's kinds
+ * are unrendered).
+ */
+interface DatabaseTableView {
+  /** The display name's legacy parity (the bridge's table name stands the display). */
+  name?: string;
+  /** The applied filter (the block's `filter` attr's payload shape). */
+  filter?: DatabaseFilterPayload;
+  /** The visible columns' order (the drag's committed stand). */
+  columnOrder?: string[];
+  /** The hidden columns' ids (the column menu's toggle stand). */
+  hiddenColumns?: string[];
+  /** The columns' widths (px, over the `columnOrder` positions). */
+  columnWidths?: number[];
+}
+/** The `useTableList`'s return: the catalog's read projection + the create / rename's mutations. */
+interface UseTableList {
+  /** The catalog's tables (the system tables stand absent); `null` until the first successful read. */
+  tables: TableRef[] | null;
+  /** The catalog read's in-flight stand. */
+  loading: boolean;
+  /** The catalog read's last error (the `BridgeError` stand — the create / rename's failures stand their promises' rejects). */
+  error: BridgeError | null;
+  /** The catalog's re-read (the manual's stand — the contract's catalog stands no push). */
+  refresh: () => Promise<void>;
+  /** The `createTable`'s mutation (the fresh's `operationId` per op; rejects with the `BridgeError`). Resolves the created table's ref. */
+  create: (name: string) => Promise<TableRef>;
+  /** The `renameTable`'s mutation (the fresh's `operationId` per op; rejects with the `BridgeError`). */
+  rename: (tableId: string, name: string) => Promise<void>;
+}
+//#endregion
+//#region src/database/standalone/DatabaseTable.d.ts
+interface DatabaseTableProps {
+  /** The consumer's bridge (the table's truth). */
+  bridge: DatabaseBridge;
+  /** The bridge's table id (the `TableRef.id` over the `listTables`'s catalog). */
+  tableId: string;
+  /** The read-only's stand: the grid's data stands rendered, the editing's paths stand off (the block's read-only's parity). */
+  readOnly?: boolean;
+  /** The initial view's state (the consumer's persistence's seed; the mount's stand only — the controlled's mode stands absent). */
+  view?: Partial<DatabaseTableView>;
+  /** The view's change's hook (the persistence's stand; the patch = the changed's attrs only). */
+  onViewChange?: (patch: Partial<DatabaseTableView>) => void;
+}
+/**
+ * The standalone's database table: the live grid over the bridge's table
+ * id — the same `useDatabaseTable`'s data stand as the document block
+ * (the schema + the rows + the live events + the optimistic cell's layer),
+ * rendered outside any document (the consumer's own page / panel). The
+ * view's settings stand the internal's state (seeded from the `view`
+ * prop) + the consumer's persistence over the `onViewChange`'s patch
+ * (one patch per change, as the block's `updateBlock` stand). The i18n's
+ * scope stands self-contained (the package's instance — the same's stand
+ * as the consumer-placed components).
+ */
+declare function DatabaseTable({ bridge, tableId, readOnly, view, onViewChange }: DatabaseTableProps): import("react").JSX.Element;
+//#endregion
+//#region src/database/standalone/use-table-list.d.ts
+/**
+ * The table catalog's hook (the standalone's stand): the consumer's
+ * `DatabaseBridge`'s catalog read (`listTables` — the system tables stand
+ * absent) + the `createTable` / `renameTable` mutations (the fresh's
+ * `operationId` per op over `newMutationContext`). The catalog's truth
+ * stands in the bridge — the hook's state is the read projection,
+ * re-read over the own's successful mutations (the auto's stand) + the
+ * manual's `refresh` (the contract's catalog stands no push — the
+ * per-table's events stand over the `useDatabaseTable`'s subscription).
+ * The create / rename's failures stand their promises' rejects (the
+ * `BridgeError` stand) — the `error` state is the catalog read's own.
+ */
+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 = {
@@ -794,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
@@ -808,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). */
@@ -859,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). */
@@ -899,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 {
   /**
@@ -1041,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
@@ -1072,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 { TableEnvelopeBase as $, DomainEvent as A, ProtocolCapability as B, BridgeColumnAnnotation as C, CellValueParse as D, CellMap as E, MutationContext as F, Revision as G, ProtocolLimits as H, MutationReceipt as I, SortInput as J, RowPage as K, OperationStatus as L, FilterInput as M, Id as N, Column as O, IsoInstant as P, TableDescription as Q, PageQuery as R, BridgeColumn as S, BridgeValueInput as T, QueryOperator as U, ProtocolDescriptor as V, QuerySemantics as W, SubscriptionObserver as X, SubscriptionHandle as Y, SubscriptionStatus as Z, UseDatabaseTable as _, EditorContextValue as a, BridgeErrorCode as at, FilterBuilder as b, EmbedSandboxPolicy as c, toBridgeError as ct, PdfPreview as d, BlobStore as dt, TableEvent as et, PdfPreviewProps as f, BlobSubtype as ft, DatabaseTableRow as g, DatabaseTablePhase as h, AccessLevel as i, BridgeError as it, FilterConditionInput as j, DatabaseBridge as k, MentionEntry as l, BlobMeta as lt, useDatabaseTable as m, createMemoryBlobStore as mt, DEFAULT_EMBED_SANDBOX as n, TableSnapshot as nt, EditorMode as o, isBridgeError as ot, SyncEmbedResolver as p, blobSubtypeOf as pt, RowWire as q, EditorProvider as r, BRIDGE_ERROR_CODES as rt, EditorProviderProps as s, isBridgeErrorCode as st, useEditorContext as t, TableRef as tt, MentionProvider as u, BlobRef as ut, emptyFilter as v, BridgeTableDescription as w, BatchOp as x, filterIsComplete as y, PageSnapshot 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,6 +1,5 @@
 import { n as BlockRendererMap, r as BlockRendererProps, t as BlockRenderer } from "./index-YJcgf8Hh.mjs";
-import { n as EditorView, t as Editor } from "./Editor-DT7RkRXf.mjs";
-import { $ as TableEnvelopeBase, A as DomainEvent, B as ProtocolCapability, C as BridgeColumnAnnotation, D as CellValueParse, E as CellMap, F as MutationContext, G as Revision, H as ProtocolLimits, I as MutationReceipt, J as SortInput, K as RowPage, L as OperationStatus, M as FilterInput, N as Id, O as Column, P as IsoInstant, Q as TableDescription, R as PageQuery, S as BridgeColumn, T as BridgeValueInput, U as QueryOperator, V as ProtocolDescriptor, W as QuerySemantics, X as SubscriptionObserver, Y as SubscriptionHandle, Z as SubscriptionStatus, _ as UseDatabaseTable, a as EditorContextValue, at as BridgeErrorCode, b as FilterBuilder, c as EmbedSandboxPolicy, ct as toBridgeError, d as PdfPreview, dt as BlobStore, et as TableEvent, f as PdfPreviewProps, ft as BlobSubtype, g as DatabaseTableRow, h as DatabaseTablePhase, i as AccessLevel, it as BridgeError, j as FilterConditionInput, k as DatabaseBridge, l as MentionEntry, lt as BlobMeta, m as useDatabaseTable, mt as createMemoryBlobStore, n as DEFAULT_EMBED_SANDBOX, nt as TableSnapshot, o as EditorMode, ot as isBridgeError, p as SyncEmbedResolver, pt as blobSubtypeOf, q as RowWire, r as EditorProvider, rt as BRIDGE_ERROR_CODES, s as EditorProviderProps, st as isBridgeErrorCode, t as useEditorContext, tt as TableRef, u as MentionProvider, ut as BlobRef, v as emptyFilter, w as BridgeTableDescription, x as BatchOp, y as filterIsComplete, z as PageSnapshot } from "./index-D6_ysSmQ.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";
@@ -14,6 +13,41 @@ import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
 import * as SelectPrimitive from "@radix-ui/react-select";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+//#region src/Editor.d.ts
+/**
+ * The document's view mode: the page flow (the root's children in reading
+ * order) or the canvas (the page as a miniature rectangle plus the surface
+ * elements on one canvas). View state — switching writes nothing to the
+ * data (like the selection).
+ */
+type EditorView = "page" | "canvas";
+interface EditorProps {
+  view?: EditorView;
+  /** The format toolbar's color palette (the default six colors). */
+  formatPalette?: readonly string[];
+}
+/**
+ * The document's editor: the root is the editor's focus/keyboard scope
+ * (the undo/redo hotkeys only fire for keys targeted inside it), and the
+ * root block context is provided for every entry (the entry list's
+ * siblings, and the entry root's sequence container as the gestures'
+ * command parent — a subtree entry root is a page block, structurally
+ * childless, so its commands target the container of its sequence, not
+ * itself).
+ *
+ * The `view` prop selects the rendering: "page" (default) is the flat page
+ * sequence — every page block is its own `Reorder.Item` row (the nesting is
+ * the block's `indent` attr; a list item's marker is a rendered label per
+ * row), the top-level rows render through `AnimatePresence` (`sync`), and
+ * the drag-reorder is pure framer `Reorder` (one drag = one range move of
+ * the dragged block's derived subtree — see the `motion` segment);
+ * "canvas" renders the document's page as a page miniature and the
+ * root-level surfaces' elements on one canvas (see CanvasView). The
+ * `formatPalette` prop overrides the floating format toolbar's color
+ * palette.
+ */
+declare function Editor({ view, formatPalette }: EditorProps): import("react").JSX.Element;
+//#endregion
 //#region src/database/bridge/annotation.d.ts
 /** The standard PostgreSQL type names per operator / input group. The contract
  *  is type-agnostic — this is the package's DEFAULT catalog; a non-standard
@@ -61,13 +95,17 @@ declare function isDatabaseBridge(candidate: unknown): candidate is DatabaseBrid
 declare function validateProtocolDescriptor(descriptor: ProtocolDescriptor): Set<ProtocolCapability>;
 //#endregion
 //#region src/database/use-database-table/utils.d.ts
-/** The cell-value equality (null / undefined stand as the empty cell). */
+/** The cell-value equality (null / undefined stand as the empty cell).
+ *  The composite value (the multi-select's array) stands the element-wise
+ *  stand: the same content over a fresh array instance is NOT a change
+ *  (the identity stand would commit the no-op and push the undo entry). */
 declare function cellValueEqual(current: unknown, next: unknown): boolean;
 /** The write's context: the fresh client-issued operation id (a UUID,
  *  unique within the retention) + the issue time. Every user action stands
  *  a fresh `operationId` — the id is never reused across logical
- *  operations, and a failed write is reconciled by the SAME id (the
- *  bridge's idempotency), never a silent new one. */
+ *  operations. The lost response's reconciliation (the write's fate) is
+ *  the consumer's stand over the bridge's `getOperationStatus`; the UI's
+ *  convergence is the rebaseline (the next snapshot / the envelope). */
 declare function newMutationContext(): MutationContext;
 //#endregion
 //#region src/canvas/text-fonts.d.ts
@@ -112,7 +150,9 @@ declare const SHAPE_FONT_OPTIONS: readonly [{
 declare const SHAPE_FONT_STACKS: Record<string, string>;
 //#endregion
 //#region src/DocHeader.d.ts
-declare function DocHeader({ doc, view, onViewChange, accessLevel, mode, onModeChange, publishedDoc }: {
+/** The header's props (the consumer's state: the doc's stand, the view and
+ *  the mode's switchers — the consumer owns the view / the mode's state). */
+interface DocHeaderProps {
   /** The headless document (the consumer's own stand: the live doc over the editor's stand, the published snapshot over the viewer's stand — the reader's browser never holds the live document). */
   doc?: Doc;
   view: EditorView;
@@ -125,7 +165,13 @@ declare function DocHeader({ doc, view, onViewChange, accessLevel, mode, onModeC
   onModeChange?: (mode: EditorMode) => void;
   /** The published snapshot (the meta's source over the published's stand; the "Published"'s option stands disabled over its absence). */
   publishedDoc?: Doc | null;
-}): import("react").JSX.Element;
+}
+/** The header's i18n scope: the package's instance stands the provider's seat
+ *  over the panel (the consumer places the header outside the editor — the
+ *  editor's own scope never reaches it). A consumer-wrapped subtree stands
+ *  the same instance nested — the provider is a plain context, the render
+ *  is unchanged. */
+declare function DocHeader(props: DocHeaderProps): import("react").JSX.Element;
 //#endregion
 //#region src/hooks.d.ts
 /** The headless document owned by the nearest EditorProvider. */
@@ -147,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;
 /**
@@ -240,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" | "destructive" | "custom" | "secondary" | "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;
@@ -251,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" | "destructive" | "secondary" | "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> & {
@@ -385,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, type DatabaseTablePhase, type DatabaseTableRow, 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, 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, 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 };