@book.dev/ui 1.60.0

package/dist/layouts/DefaultLayout.d.ts

@@ -0,0 +1,4 @@
+export interface DefaultLayoutProps {
+    children: React.ReactNode;
+}
+export default function DefaultLayout(props: DefaultLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/layouts/index.d.ts

@@ -0,0 +1 @@
+export { default as DefaultLayout } from './DefaultLayout';

package/dist/lib/__tests__/accountClient.test.d.ts

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

package/dist/lib/__tests__/backlinks.test.d.ts

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

package/dist/lib/__tests__/backupBundle.test.d.ts

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

package/dist/lib/__tests__/blockExport.test.d.ts

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

package/dist/lib/__tests__/blockModel.test.d.ts

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

package/dist/lib/__tests__/databaseFormula.test.d.ts

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

package/dist/lib/__tests__/databaseTypes.test.d.ts

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

package/dist/lib/__tests__/favorites.test.d.ts

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

package/dist/lib/__tests__/homePage.test.d.ts

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

package/dist/lib/__tests__/hud.test.d.ts

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

package/dist/lib/__tests__/icons.test.d.ts

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

package/dist/lib/__tests__/mixedContent.test.d.ts

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

package/dist/lib/__tests__/pageAppearance.test.d.ts

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

package/dist/lib/__tests__/pageIcon.test.d.ts

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

package/dist/lib/__tests__/pageLayout.test.d.ts

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

package/dist/lib/__tests__/pageSaveStatus.test.d.ts

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

package/dist/lib/__tests__/pageTheme.test.d.ts

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

package/dist/lib/__tests__/parentGrouping.test.d.ts

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

package/dist/lib/__tests__/pluginSdk.test.d.ts

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

package/dist/lib/__tests__/recents.test.d.ts

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

package/dist/lib/__tests__/relations.test.d.ts

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

package/dist/lib/__tests__/templates.test.d.ts

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

package/dist/lib/__tests__/textMerge.test.d.ts

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

package/dist/lib/__tests__/themes.test.d.ts

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

package/dist/lib/__tests__/treeMove.test.d.ts

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

package/dist/lib/aiBridge.d.ts

@@ -0,0 +1,67 @@
+import type * as Y from 'yjs';
+import type { AgentProposal, StoredSuggestion } from '@book.dev/sdk';
+/**
+ * Bridge between the (provider-less) block editor and the app's AI client —
+ * the same singleton pattern as `pageLinks`. The app installs it once
+ * (DefaultLayout); editor slash items consult `ready` to decide whether to
+ * appear and call through for completions / task breakdowns.
+ *
+ * The bridge also owns the agent's WRITE path. Write tools never mutate; the
+ * agent returns a PROPOSED change set, the AgentPanel shows it for approval,
+ * and on approve the bridge applies it. Two application paths:
+ *
+ *  1. CRDT path — when a live block editor for the target page has registered
+ *     its Y.Doc (via {@link registerBlockEditorDoc}), the change is applied in
+ *     ONE Y transaction (origin 'local') so it's undoable and broadcasts live,
+ *     exactly like a kit click or a streamed token.
+ *  2. Server fallback — otherwise the change is applied through the data client
+ *     (savePage / updateRow). A live editor on that page merges it (CRDT union)
+ *     on its next server push.
+ *
+ * Keeping the editor-doc handle in a singleton (rather than coupling the agent
+ * to React) mirrors how `aiBridge.complete` already streams tokens into the
+ * editor's CRDT without the agent knowing about React at all.
+ */
+export interface ProposalApplyResult {
+    applied: number;
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+export interface AiBridgeImpl {
+    /** Engine is configured and was ready at the last status poll. */
+    ready: () => boolean;
+    complete: (text: string, onToken: (token: string) => void) => Promise<string>;
+    tasks: (goal: string, context?: string) => Promise<string[]>;
+    /** Apply an approved set of agent proposals. */
+    applyProposals: (proposals: AgentProposal[]) => Promise<ProposalApplyResult>;
+    /**
+     * Apply one accepted suggestion to the document — the same CRDT-first /
+     * savePage-fallback path as {@link applyProposals}, keyed off the suggestion's
+     * `payload.applyKind`. Throws on failure (the caller keeps the suggestion open).
+     */
+    applySuggestion: (suggestion: StoredSuggestion) => Promise<void>;
+}
+/**
+ * Convert a persisted suggestion back into the {@link AgentProposal} shape the
+ * editor-bridge apply path understands. The suggestion's `payload` carries the
+ * original write-tool kind as `applyKind`, so applying an AI suggestion and a
+ * human suggestion go through identical code.
+ */
+export declare const suggestionToProposal: (s: StoredSuggestion) => AgentProposal;
+/** A mounted block editor registers its live doc. Returns an unregister fn. */
+export declare const registerBlockEditorDoc: (pageId: string, doc: Y.Doc) => (() => void);
+/** The live editor doc for a page, when one is currently mounted. */
+export declare const getBlockEditorDoc: (pageId: string | undefined) => Y.Doc | null;
+/** Reverse lookup: the page id a live editor doc is registered under, if any. */
+export declare const getPageIdForDoc: (doc: Y.Doc) => string | null;
+export declare const setAiBridge: (next: AiBridgeImpl | null) => void;
+export declare const subscribeAiBridge: (cb: () => void) => (() => void);
+export declare const aiBridge: {
+    ready: () => boolean;
+    complete: (text: string, onToken: (token: string) => void) => Promise<string>;
+    tasks: (goal: string, context?: string) => Promise<string[]>;
+    applyProposals: (proposals: AgentProposal[]) => Promise<ProposalApplyResult>;
+    applySuggestion: (suggestion: StoredSuggestion) => Promise<void>;
+};

package/dist/lib/aiFeatures.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-feature surfacing for AI entry points. Not everyone wants AI front and
+ * centre, so each AI feature can be set to:
+ *   - `recommended` — shown up front in menus (the default),
+ *   - `enabled`     — present but only surfaced once the user searches for it,
+ *   - `disabled`    — removed from menus entirely.
+ *
+ * The setting lives in the user preferences blob (see {@link
+ * providers/PreferencesProvider}); menus read it through {@link
+ * readFeatureVisibility}, which works outside React too (the block editor mounts
+ * its own root), mirroring how favourites/recents read localStorage directly.
+ */
+import type { TKey } from '@/i18n';
+export type FeatureVisibility = 'recommended' | 'enabled' | 'disabled';
+/** An AI entry point the user can dial up or down. `id` matches the command /
+ *  slash-item id so each surface gates the right item. */
+export interface AiFeatureDef {
+    id: string;
+    /** i18n key for the label shown in Settings → AI → Features. */
+    labelKey: TKey;
+}
+export declare const AI_FEATURES: AiFeatureDef[];
+export declare const isAiFeature: (id: string) => boolean;
+export declare const DEFAULT_FEATURE_VISIBILITY: FeatureVisibility;
+/** A feature's visibility, read straight from persisted preferences (defaults
+ *  to `recommended`). Safe to call outside React and during SSR. */
+export declare function readFeatureVisibility(id: string): FeatureVisibility;
+/** Whether an item with this visibility shows, given whether the user is
+ *  searching: recommended → always; enabled → only while searching; disabled →
+ *  never. */
+export declare function featureShown(vis: FeatureVisibility, searching: boolean): boolean;

package/dist/lib/aiSettingsNav.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A tiny bridge between the Settings nav rail and the AI settings panel. The
+ * nav's per-provider sub-items call {@link focusAiProvider}; the AI panel (which
+ * owns the provider accordions) registers a handler that expands the matching
+ * accordion and scrolls it into view. Mirrors the kitPanel / reviewPane bridges
+ * — it lets two sibling components coordinate without threading state through the
+ * settings shell.
+ *
+ * If the AI panel isn't mounted yet (the sub-item was clicked from another tab),
+ * the request is held and replayed when the panel registers.
+ */
+export type AiProviderFocus = (provider: string) => void;
+export declare function focusAiProvider(provider: string): void;
+export declare function registerAiProviderFocus(fn: AiProviderFocus | null): void;

package/dist/lib/backupBundle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure helpers for the restore flow: validate a backup file, list the top-level
+ * pages to offer as restore targets, and expand a selection of those into the
+ * full set of pages + databases to send to the server (so a selected page always
+ * brings its subtree, its hosted database, and that database's rows).
+ */
+import { type SpaceBackup, type StoredDatabase, type StoredPage } from '@book.dev/sdk';
+export declare function parseBackup(text: string): SpaceBackup;
+/**
+ * The pages to show in the restore checklist: top-level documents — not database
+ * rows, and not nested under another page that's also in the bundle.
+ */
+export declare function bundleRoots(bundle: SpaceBackup): StoredPage[];
+/**
+ * Expand selected root ids into the closure to import: each selected page plus
+ * its descendants, the databases those pages host, and those databases' rows.
+ */
+export declare function closure(bundle: SpaceBackup, rootIds: Iterable<string>): {
+    pages: StoredPage[];
+    databases: StoredDatabase[];
+};
+/** How many of the closure's pages already exist in the current space (by id). */
+export declare function overwriteCount(pages: StoredPage[], existingIds: Set<string>): number;

package/dist/lib/bookFolderTransfer.d.ts

@@ -0,0 +1,15 @@
+import type { BookFolderFile } from '@book.dev/sdk';
+/**
+ * Export `files` to a folder the user picks (Chromium) or, failing that, a
+ * downloaded `.zip` named from `suggestedName`. Resolves a summary, or `null` if
+ * the user cancelled the directory picker.
+ */
+export declare function exportBookFolderInBrowser(files: BookFolderFile[], suggestedName: string): Promise<{
+    location: string;
+    count: number;
+} | null>;
+/**
+ * Import a book folder: read a user-picked directory (Chromium) or unzip a
+ * user-picked `.zip` (fallback). Resolves the files, or `null` if cancelled.
+ */
+export declare function importBookFolderInBrowser(): Promise<BookFolderFile[] | null>;

package/dist/lib/download.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Trigger a client-side file download for a Blob via a temporary `<a download>`.
+ * Works in the browser; on the desktop (WKWebView/Tauri) a programmatic download
+ * may need the Tauri fs/dialog plugin — verify on the real app.
+ */
+export declare function downloadBlob(filename: string, blob: Blob): void;
+/** Download a UTF-8 text file (markdown, html, json) with the given MIME type. */
+export declare function downloadText(filename: string, text: string, mime?: string): void;
+/** A filesystem-safe slug for a page title, for export filenames. */
+export declare function safeFilename(name: string | null | undefined, fallback?: string): string;

package/dist/lib/editorChrome.d.ts

@@ -0,0 +1,14 @@
+/** Turn off autocorrect/autocapitalize/spellcheck on a verbatim field. */
+export declare function disableAutocorrect(el: Element): void;
+/**
+ * If the block/slash popover is open with nothing focused, nudge EditorJS's
+ * Flipper (which listens for ArrowDown on `document`) to focus the first
+ * selectable item, so the user can press Enter to insert it. No-op otherwise.
+ */
+export declare function preselectFirstPopoverItem(holder: HTMLElement): void;
+/**
+ * Install the enhancements on a holder. Runs once, then on every relevant DOM
+ * mutation (new blocks, popover open/filter) and whenever the page list changes
+ * (mention titles). Returns a disposer.
+ */
+export declare function installEditorChrome(holder: HTMLElement): () => void;

package/dist/lib/emoji.d.ts

@@ -0,0 +1,10 @@
+export interface EmojiMatch {
+    emoji: string;
+    name: string;
+}
+/**
+ * Search emoji by shortcode/name for the inline `:` picker (offline — node-emoji
+ * bundles its dataset). Results are ranked so a name that *starts with* the query
+ * comes before a mere substring match, then trimmed to `limit`.
+ */
+export declare function searchEmojis(query: string, limit?: number): EmojiMatch[];

package/dist/lib/emojiData.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Curated emoji set for the in-house icon picker's *browse* view, grouped into
+ * the familiar categories. This is intentionally a sensible subset (the common
+ * page-icon emoji), not the full Unicode set — it keeps the picker fast, calm,
+ * and zero-dependency. The long tail is reachable through the search box, which
+ * queries the full `node-emoji` dataset (see {@link components/EmojiGrid}).
+ *
+ * All glyphs are native Unicode (no sprites / network), so they render with the
+ * platform font in both web and the desktop WKWebView.
+ */
+export interface EmojiCategory {
+    /** Stable id (also the i18n key suffix `emoji.cat.<id>`). */
+    id: string;
+    /** A representative glyph for the category-nav button. */
+    icon: string;
+    emojis: string[];
+}
+export declare const EMOJI_CATEGORIES: EmojiCategory[];
+/** A flat, de-duplicated list of every curated glyph (used for "recents" seeding
+ *  and as a fallback browse list). */
+export declare const ALL_CURATED_EMOJIS: string[];

package/dist/lib/emojiPicker.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A tiny singleton bridge to the one app-wide emoji grid picker. Any call site —
+ * React component or **vanilla** EditorJS block tool (which has no provider tree,
+ * cf. `lib/pageLinks.ts`) — opens the picker anchored at a screen rect and gets a
+ * callback when an emoji is chosen. The `<EmojiPickerHost>` mounted at the app
+ * shell renders the actual picker over this state.
+ */
+export interface EmojiPickerAnchor {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+interface EmojiPickerState {
+    open: boolean;
+    anchor: EmojiPickerAnchor | null;
+    value: string;
+    onPick: ((emoji: string) => void) | null;
+}
+declare class EmojiPickerBridge {
+    private state;
+    private readonly listeners;
+    subscribe: (cb: () => void) => (() => void);
+    getState: () => EmojiPickerState;
+    private set;
+    /** Open the picker anchored at `anchor` (a DOMRect-like), reporting picks to `onPick`. */
+    open: (anchor: EmojiPickerAnchor, value: string, onPick: (emoji: string) => void) => void;
+    close: () => void;
+}
+export declare const emojiPicker: EmojiPickerBridge;
+export {};

package/dist/lib/favorites.d.ts

@@ -0,0 +1,11 @@
+/** Pure: toggle `id`'s membership, newest pinned first. */
+export declare function toggleFavoriteId(list: string[], id: string): string[];
+/** The current favourites, in pinned order. */
+export declare const readFavorites: () => string[];
+export declare const isFavorite: (id: string) => boolean;
+/** Pin/unpin a page. */
+export declare const toggleFavorite: (id: string) => void;
+/** Drop a page from favourites (e.g. when it's deleted). No-op if absent. */
+export declare const removeFavorite: (id: string) => void;
+/** Subscribe to favourite changes. Returns an unsubscribe fn. */
+export declare const subscribeFavorites: (cb: () => void) => (() => void);

package/dist/lib/homePage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The Home view — a pseudo-page. It lives in the window model, the URL
+ * (`?page=home`) and history like any page id, so back/forward, tabs and
+ * deep links all work; the document area just renders the Home screen for
+ * it instead of fetching a document.
+ */
+export declare const HOME_PAGE_ID = "home";
+/**
+ * The dataflow split-pane mode — another pseudo-page: `?split=flow` shows
+ * the PRIMARY page's reactive graph instead of a second document.
+ */
+export declare const FLOW_PANE_ID = "flow";
+/**
+ * The block-settings split-pane mode — a pseudo-page that hosts the "Expand"
+ * view of an interactive block's configuration. Reuses the side pane rather
+ * than a separate drawer; the live config fields portal into it (see
+ * `blockeditor/kit/kitPanel.ts`). Ephemeral — never persisted to the URL.
+ */
+export declare const CONFIG_PANE_ID = "config";
+/**
+ * The page-customisation split-pane mode — a pseudo-page hosting a page's
+ * appearance + typeface controls (accent, neutrals, intensities, primary /
+ * secondary fonts). Like {@link CONFIG_PANE_ID} it reuses the side pane rather
+ * than a popover, and is ephemeral — never persisted to the URL. The page it
+ * targets is tracked in `lib/pageCustomise.ts`.
+ */
+export declare const CUSTOMISE_PANE_ID = "customise";
+/**
+ * The Review split-pane mode — a pseudo-page hosting the suggestions + comments
+ * review surface for a page (open suggestions with before→after diffs, accept /
+ * reject, and threaded rich-text comments). Like {@link CONFIG_PANE_ID} it
+ * reuses the side pane and is ephemeral — never persisted to the URL. The page
+ * it targets is tracked in `lib/reviewPane.ts`.
+ */
+export declare const REVIEW_PANE_ID = "review";
+/**
+ * The Assistant split-pane mode — a pseudo-page hosting the workspace agent chat.
+ * Like {@link REVIEW_PANE_ID} it reuses the side pane (rather than a separate
+ * docked panel) and is ephemeral — never persisted to the URL.
+ */
+export declare const AGENT_PANE_ID = "agent";
+/** Which Home widgets are shown. All on by default; configurable per device. */
+export interface HomeWidgets {
+    actions: boolean;
+    recents: boolean;
+    favorites: boolean;
+    edited: boolean;
+}
+export declare const DEFAULT_HOME_WIDGETS: HomeWidgets;
+export declare function readHomeWidgets(): HomeWidgets;
+export declare function writeHomeWidgets(widgets: HomeWidgets): void;
+/** The greeting key for an hour of the day (5–12 morning, 12–18 afternoon). */
+export declare function greetingKey(hour: number): 'morning' | 'afternoon' | 'evening';

package/dist/lib/hud.d.ts

@@ -0,0 +1,70 @@
+/** The settings sidebar: three sections, each with its sub-screens, in order.
+ *  Preferences = how the app behaves and looks; Account = who you are
+ *  (identity first); Workspace = this workspace's server and capabilities. */
+export declare const SETTINGS_SECTIONS: readonly [{
+    readonly id: "preferences";
+    readonly tabs: readonly ["general", "appearance", "customisation"];
+}, {
+    readonly id: "account";
+    readonly tabs: readonly ["profile", "signup", "signin", "support"];
+}, {
+    readonly id: "workspace";
+    readonly tabs: readonly ["connection", "integrations", "extensions", "ai", "admin"];
+}];
+export type SettingsSectionId = (typeof SETTINGS_SECTIONS)[number]['id'];
+/** Settings panels, flattened in display order (derived from the sections). */
+export declare const SETTINGS_TABS: ("appearance" | "ai" | "extensions" | "general" | "profile" | "customisation" | "connection" | "integrations" | "admin" | "signup" | "signin" | "support")[];
+export type SettingsTab = (typeof SETTINGS_SECTIONS)[number]['tabs'][number];
+/** The first sub-screen — the default when nothing (valid) is persisted. */
+export declare const DEFAULT_SETTINGS_TAB: SettingsTab;
+/** How the settings screen is presented. */
+export type SettingsMode = 'modal' | 'fullscreen';
+/** How a page is presented: an immersive full-screen deck, or the presenter
+ *  console (current + next slide, speaker notes, timer). */
+export type PresentMode = 'fullscreen' | 'presenter';
+export declare const isSettingsTab: (value: unknown) => value is SettingsTab;
+/**
+ * Resolve a persisted tab id to a current one: map renamed legacy ids
+ * (`server`→`connection`, `backup`→`admin`) and fall back to the default for
+ * anything no longer a valid tab, so an old `settings.tab` never dead-ends.
+ */
+export declare const normalizeTab: (value: unknown) => SettingsTab;
+export interface HudProps {
+    commandPalette: {
+        open: boolean;
+    };
+    settings: {
+        open: boolean;
+        /** Whether settings show as a centered modal or fill the viewport. */
+        mode: SettingsMode;
+        /** The currently selected settings panel. */
+        tab: SettingsTab;
+    };
+    present: {
+        open: boolean;
+        /** Immersive full-screen deck, or the presenter console. */
+        mode: PresentMode;
+        /** The page being presented. */
+        pageId: string | null;
+    };
+    sideNav: {
+        open: boolean;
+        docked: boolean;
+    };
+    trash: {
+        open: boolean;
+    };
+    templates: {
+        open: boolean;
+    };
+    ai: {
+        open: boolean;
+    };
+    agent: {
+        open: boolean;
+    };
+}
+export declare const HudDefault: HudProps;
+export declare const HUD_STORAGE_KEY = "hud";
+export declare const loadHudStorage: () => HudProps;
+export declare const saveHudStorage: (hud: HudProps) => void;

package/dist/lib/iconRecents.d.ts

@@ -0,0 +1,3 @@
+export declare function readIconRecents(): string[];
+/** Move `value` to the front of the recents list (deduped), capped at {@link MAX}. */
+export declare function pushIconRecent(value: string): void;

package/dist/lib/iconValue.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure helpers for page-icon *values* — no React, no `lucide-react` import — so
+ * text-only consumers (HTML/Markdown export, mention labels) can reason about an
+ * icon string without pulling the icon component registry into their bundle.
+ *
+ * A page icon is either a native emoji glyph (e.g. `"📄"`) or a curated Lucide
+ * icon serialized as `"lucide:<Name>"`. Rendering to pixels lives in
+ * {@link components/PageIcon}; resolving to a component lives in
+ * {@link lib/lucideIcons}.
+ */
+export declare const LUCIDE_PREFIX = "lucide:";
+/** Whether an icon value refers to a Lucide icon (vs. an emoji glyph). */
+export declare const isLucideIcon: (value: string | null | undefined) => boolean;
+/**
+ * A plain-text rendering of an icon value. Emoji glyphs pass through; Lucide
+ * icons have no text form, so they collapse to an empty string (callers should
+ * treat that as "no icon" rather than printing the `lucide:` ref literally).
+ */
+export declare const pageIconToText: (value: string | null | undefined) => string;

package/dist/lib/lucideIcons.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The curated set of Lucide icons offered by the icon picker and rendered for
+ * `lucide:<Name>` page icons (see {@link components/PageIcon}).
+ *
+ * We import a hand-picked subset explicitly rather than the whole `lucide-react`
+ * package (~1,500 icons) so the always-loaded bundle stays small and the picker
+ * shows a tidy, useful gallery instead of an overwhelming wall. The registry is
+ * the single extension point: add names here to grow the set, and later icon
+ * *sources* (custom uploads, other libraries) can sit beside it behind the same
+ * `lucide:`-style prefix scheme (#5).
+ */
+import { type LucideIcon } from 'lucide-react';
+import { LUCIDE_PREFIX, isLucideIcon } from '@/lib/iconValue';
+export { LUCIDE_PREFIX, isLucideIcon };
+/** Name → component, in a deliberate, roughly-themed display order. Each icon
+ *  appears exactly once; the key is the value persisted as `lucide:<key>`. */
+export declare const LUCIDE_ICONS: Record<string, LucideIcon>;
+/** The picker's display order. */
+export declare const LUCIDE_ICON_NAMES: string[];
+/** Resolve a `lucide:Name` value (or a bare `Name`) to its component, or null. */
+export declare function lucideIconFor(value: string): LucideIcon | null;

package/dist/lib/openDocs.d.ts

@@ -0,0 +1,5 @@
+import type * as Y from 'yjs';
+export declare function registerOpenDoc(pageId: string, doc: Y.Doc): () => void;
+export declare const openDoc: (pageId: string | null | undefined) => Y.Doc | undefined;
+/** Fires when a doc is registered/removed (not on edits — subscribe to the doc). */
+export declare const subscribeOpenDocs: (cb: () => void) => (() => void);

package/dist/lib/pageActions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cross-cutting page actions that several surfaces (context menus, the command
+ * palette, the sidebar) trigger, but which act on UI that lives elsewhere in the
+ * tree — so they go through the window/clipboard rather than React props.
+ */
+/** Build a shareable deep link to a page (`?page=<id>`), no split. */
+export declare function pageLinkUrl(pageId: string): string;
+/** Copy arbitrary text to the clipboard. Resolves to whether it worked. */
+export declare function copyText(text: string): Promise<boolean>;
+/** Copy a page's deep link to the clipboard. Resolves to whether it worked. */
+export declare function copyPageLink(pageId: string): Promise<boolean>;
+/** Ask the editor showing `pageId` to focus its title field for renaming. */
+export declare function requestRenamePage(pageId: string): void;
+/** If a rename is pending for `pageId`, claim it (clears the flag). */
+export declare function consumePendingRename(pageId: string): boolean;
+/** Subscribe to rename requests. Returns an unsubscribe fn. */
+export declare function onRenamePageRequest(cb: (pageId: string) => void): () => void;

package/dist/lib/pageAppearance.d.ts

@@ -0,0 +1,20 @@
+export type AppearanceFacet = 'theme' | 'cover' | 'fonts' | 'fullWidth';
+export declare const subscribePageAppearance: (cb: () => void) => (() => void);
+export interface AppearanceBackend {
+    /** Persist one facet to the page document (`null` clears it). */
+    persist: (pageId: string, propertyKey: string, value: unknown) => void;
+    /** Fetch a page's stored properties and hydrate the cache. */
+    load: (pageId: string) => void;
+}
+export declare function setAppearanceBackend(b: AppearanceBackend | null): void;
+/**
+ * Replace a page's cached appearance from its stored `properties`. Idempotent
+ * and reference-stable: a facet whose JSON is unchanged keeps its old object so
+ * `useSyncExternalStore` doesn't loop. Lifts any legacy localStorage value into
+ * the document the first time a page is seen without stored appearance.
+ */
+export declare function hydratePageAppearance(pageId: string, properties: Record<string, unknown> | null | undefined): void;
+export declare function readAppearanceFacet<T>(pageId: string, facet: AppearanceFacet): T | null;
+export declare function writeAppearanceFacet(pageId: string, facet: AppearanceFacet, value: unknown): void;
+/** React-subscribe to one page's facet; re-renders when it changes. */
+export declare function useAppearanceFacet<T>(pageId: string, facet: AppearanceFacet): T | null;

package/dist/lib/pageCover.d.ts

@@ -0,0 +1,21 @@
+export type PageCover = {
+    kind: 'gradient';
+    css: string;
+} | {
+    kind: 'image';
+    url: string;
+    position?: number;
+};
+/** Curated gradient covers — tasteful in both light and dark, no image needed. */
+export declare const COVER_GRADIENTS: ReadonlyArray<{
+    id: string;
+    css: string;
+}>;
+/** Subscribe to cover changes (any page). Returns an unsubscribe fn. */
+export declare const subscribePageCover: (cb: () => void) => (() => void);
+/** The cover stored for a page, or `null` when none is set. */
+export declare function readPageCover(pageId: string): PageCover | null;
+/** Persist (or, with `null`, clear) a page's cover. */
+export declare function writePageCover(pageId: string, cover: PageCover | null): void;
+/** React-subscribe to one page's cover; re-renders when it changes. */
+export declare function usePageCover(pageId: string): PageCover | null;

package/dist/lib/pageCustomise.d.ts

@@ -0,0 +1,6 @@
+/** Subscribe to target changes. Returns an unsubscribe fn. */
+export declare const subscribePageCustomise: (cb: () => void) => (() => void);
+/** The page currently being customised in the side pane, or `null`. */
+export declare const getPageCustomiseTarget: () => string | null;
+/** Point the customisation side pane at a page (does not open the pane itself). */
+export declare function setPageCustomiseTarget(pageId: string | null): void;

package/dist/lib/pageDocActions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Bridge between the open page documents and the shell: a document registers
+ * its export/delete capabilities here (keyed by page id), and the nav-bar
+ * page menu renders whatever the *current* page can do. A module singleton,
+ * like the plugin command registry — the shell and the documents never hold
+ * references to each other.
+ */
+export type ExportKind = 'md' | 'pdf-paged' | 'pdf-continuous' | 'pdf-slides' | 'html' | 'html-slides' | 'plugin';
+export interface PageDocActions {
+    /** Which export formats this document offers (order = menu order). */
+    exportKinds: ExportKind[];
+    runExport: (kind: ExportKind) => void | Promise<void>;
+    /** Move the page to the trash (confirms per user preference). */
+    deletePage?: () => void | Promise<void>;
+}
+export declare function registerPageDocActions(pageId: string, actions: PageDocActions): () => void;
+export declare const pageDocActions: (pageId: string | null | undefined) => PageDocActions | undefined;
+export declare const subscribePageDocActions: (cb: () => void) => (() => void);
+/** Monotonic change counter — pair with useSyncExternalStore. */
+export declare const pageDocActionsVersion: () => number;