События между приложением и редактором

Внутренний API

События ниже ходят внутри окна настольного A4 между его оболочкой и редактором. В браузере, в вашем iframe и в чужой оболочке их нет: для встраивания используйте Rust Session Protocol или Интерфейс поверхности в браузере.

От приложения к редактору — 7 событий

onDocumentSessionSnapshot

onDocumentSessionSnapshot(callback: (snapshot: ShellDocumentSessionSnapshot) => void): () => void

Канал: fastdoc-shell:document-session-snapshot

onMenuCommand

onMenuCommand(callback: (command: MenuCommand) => void): () => void

Канал: fastdoc-shell:menu-command

onSaveBeforeClose

onSaveBeforeClose(callback: () => void): () => void

Канал: fastdoc-shell:save-before-close

onSaveBeforeCloseFailed

onSaveBeforeCloseFailed(callback: (payload: { message: string }) => void): () => void

Канал: fastdoc-shell:save-before-close-failed

onSaveBeforeDocumentSwitch

onSaveBeforeDocumentSwitch(callback: (request: { requestId: number }) => void): () => void

Канал: fastdoc-shell:save-before-document-switch

onStateChanged

onStateChanged(callback: (state: ShellBridgeState) => void): () => void

Канал: fastdoc-shell:state-changed

onSystemPaste

onSystemPaste(callback: (payload: SystemPastePayload) => void): () => void

Канал: fastdoc-shell:system-paste

От редактора к приложению — 11 событий

completeSaveBeforeClose

completeSaveBeforeClose(payload: { saved: boolean; message?: string | null }): void

Канал: fastdoc-shell:save-before-close-result

completeSaveBeforeDocumentSwitch

completeSaveBeforeDocumentSwitch(result: { requestId: number; saved: boolean; savedPath: string | null; errorMessage: string | null; }): void

Канал: fastdoc-shell:document-switch-save-result

notifyCanonicalEditDropped

notifyCanonicalEditDropped(payload: { code: string; requestId: string; commandType: string; }): void

Канал: fastdoc-shell:canonical-edit-dropped

notifyCurrentDocumentTruthViewerReady

notifyCurrentDocumentTruthViewerReady(payload: { availability: string; fixtureId: string | null; blockedStatesVisible: boolean; forbiddenClaimsVisible: boolean; unavailableStateVisible: boolean; genericFixtureListVisible: boolean; }): void

Канал: fastdoc-shell:current-document-truth-viewer-ready

notifyDocumentRendered

notifyDocumentRendered(renderedPath: string | null): void

Канал: fastdoc-shell:document-rendered

notifyEditKeyDropped

notifyEditKeyDropped(payload: { code: string; inputType: string; selectionShape: string; inputRoute: string; contextRefusal: string; pressIndex: number; }): void

Канал: fastdoc-shell:edit-key-dropped

notifyPageHydrationDropped

notifyPageHydrationDropped(payload: { code: string; stage: string }): void

Канал: fastdoc-shell:page-hydration-dropped

notifyPersistentSaveRefused

notifyPersistentSaveRefused(payload: { code: string; requestId: string; saveAs: boolean; }): void

Канал: fastdoc-shell:persistent-save-refused

notifyRendererReady

notifyRendererReady(): void

Канал: fastdoc-shell:renderer-ready

notifySmokeCheckpoint

notifySmokeCheckpoint(checkpoint: string, payload?: { screenshotDataUrl?: string | null; screenshots?: Array<{ name?: string | null; dataUrl?: string | null }>; telemetry?: unknown; reserveCyclesCompleted?: number; reserveElapsedMs?: number; reserveRichPayloadBytes?: number; }): void

Канал: fastdoc-shell:smoke-checkpoint

notifyUnsavedState

notifyUnsavedState(hasUnsavedChanges: boolean): void

Канал: fastdoc-shell:unsaved-state

Жизненный цикл подписки. Каждый метод on* возвращает функцию отписки — вызывайте её, когда убираете компонент или закрываете окно, иначе обработчики останутся висеть.