@beyondwork/docx-react-component 1.0.0 → 1.0.1

package/dist/tailwind.d.cts

@@ -0,0 +1,323 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { ReactNode, FocusEventHandler, KeyboardEvent } from 'react';
+import { R as RuntimeRenderSnapshot, d as CommentSidebarSnapshot, I as TrackedChangesSnapshot, i as CompatibilityPanelSnapshot, q as EditorWarning, f as CommentSidebarThreadSnapshot, T as TrackedChangeEntrySnapshot, p as EditorUser, y as SelectionSnapshot, z as SurfaceBlockSnapshot, B as SurfaceInlineSegment } from './public-types-DqCURAz8.cjs';
+
+/**
+ * Session capabilities derived from the runtime snapshot.
+ *
+ * All fields are computed from `RuntimeRenderSnapshot` — no local component
+ * state. The UI reads these to decide what controls to enable/disable, what
+ * chrome to show, and what mode the editor is in.
+ */
+interface SessionCapabilities {
+    /** Current lifecycle phase of the editor session. */
+    phase: "loading" | "ready" | "diagnostics" | "error";
+    /** Effective editor mode after accounting for runtime state. */
+    mode: "editing" | "review" | "read-only-diagnostics";
+    canUndo: boolean;
+    canRedo: boolean;
+    canEdit: boolean;
+    canAddComment: boolean;
+    canExport: boolean;
+    canAcceptChange: boolean;
+    canRejectChange: boolean;
+    canAcceptAll: boolean;
+    canRejectAll: boolean;
+    /** Whether the review rail should be visible by default. */
+    reviewRailVisible: boolean;
+    /** Whether tracked changes exist in the document (display toggle is meaningful). */
+    trackChangesSupported: boolean;
+    exportBlocked: boolean;
+    preserveOnlyCount: number;
+    unsupportedFatalCount: number;
+    /** Total count of health issues (preserve-only + unsupported-fatal + warnings). */
+    healthIssueCount: number;
+    isDirty: boolean;
+    isReady: boolean;
+    hasFatalError: boolean;
+}
+/**
+ * Derive UI capabilities from the runtime snapshot and requested review mode.
+ *
+ * This is a pure function with no side effects. Call it on every render to
+ * get the current capability state.
+ */
+declare function deriveCapabilities(snapshot: RuntimeRenderSnapshot, reviewMode: "editing" | "review"): SessionCapabilities;
+
+interface CommentDecorationModel {
+    threads: CommentDecorationThread[];
+    activeCommentId?: string;
+}
+interface CommentDecorationThread {
+    commentId: string;
+    from: number;
+    to: number;
+    status: CommentSidebarSnapshot["threads"][number]["status"];
+    isActive: boolean;
+}
+interface CommentRangeState {
+    hasComments: boolean;
+    hasOpen: boolean;
+    hasResolved: boolean;
+    hasActive: boolean;
+    count: number;
+    overlapping: CommentDecorationThread[];
+}
+declare function createCommentDecorationModel(snapshot?: CommentSidebarSnapshot): CommentDecorationModel | undefined;
+declare function getCommentRangeState(model: CommentDecorationModel | undefined, from: number, to: number): CommentRangeState;
+type MarkupDisplay = "clean" | "simple" | "all";
+declare function getCommentHighlightClass(model: CommentDecorationModel | undefined, from: number, to: number, markupDisplay?: MarkupDisplay): string;
+
+type ReviewRailTab = "comments" | "changes";
+interface TwReviewRailProps {
+    activeTab: ReviewRailTab;
+    currentUserId?: string;
+    comments: CommentSidebarSnapshot;
+    trackedChanges: TrackedChangesSnapshot;
+    compatibility: CompatibilityPanelSnapshot;
+    warnings: EditorWarning[];
+    markupDisplay: MarkupDisplay;
+    activeCommentId?: string;
+    activeRevisionId?: string;
+    onActiveTabChange: (tab: ReviewRailTab) => void;
+    onOpenComment?: (thread: CommentSidebarThreadSnapshot) => void;
+    onResolveComment?: (commentId: string) => void;
+    onReopenComment?: (commentId: string) => void;
+    onAddReply?: (commentId: string, body: string) => void;
+    onEditBody?: (commentId: string, body: string) => void;
+    onOpenRevision?: (revision: TrackedChangeEntrySnapshot) => void;
+    onAcceptRevision?: (revisionId: string) => void;
+    onRejectRevision?: (revisionId: string) => void;
+    onAcceptAllChanges?: () => void;
+    onRejectAllChanges?: () => void;
+}
+declare function TwReviewRail(props: TwReviewRailProps): react_jsx_runtime.JSX.Element;
+
+type ViewMode = "canvas" | "document";
+interface TwToolbarProps {
+    sourceLabel?: string;
+    capabilities?: SessionCapabilities;
+    compatibility?: CompatibilityPanelSnapshot;
+    warnings?: EditorWarning[];
+    viewMode: ViewMode;
+    /** Display toggle for tracked change decorations (not a runtime mutation toggle). */
+    showTrackedChanges: boolean;
+    onUndo: () => void;
+    onRedo: () => void;
+    onAddComment: () => void;
+    onExport: () => void;
+    onViewModeChange: (value: ViewMode) => void;
+    onShowTrackedChangesChange: (show: boolean) => void;
+}
+declare function TwToolbar(props: TwToolbarProps): react_jsx_runtime.JSX.Element;
+
+interface TwReviewWorkspaceProps {
+    snapshot: RuntimeRenderSnapshot;
+    currentUserId?: string;
+    capabilities?: SessionCapabilities;
+    reviewMode?: "editing" | "review";
+    document: ReactNode;
+    viewMode: ViewMode;
+    activeRailTab: ReviewRailTab;
+    activeCommentId?: string;
+    activeRevisionId?: string;
+    showTrackedChanges: boolean;
+    selectionPreview?: string | null;
+    onViewModeChange: (value: ViewMode) => void;
+    onActiveRailTabChange: (value: ReviewRailTab) => void;
+    onShowTrackedChangesChange: (show: boolean) => void;
+    onUndo: () => void;
+    onRedo: () => void;
+    onAddComment: () => void;
+    onExport: () => void;
+    onOpenComment: (thread: CommentSidebarThreadSnapshot) => void;
+    onResolveComment: (commentId: string) => void;
+    onReopenComment?: (commentId: string) => void;
+    onAddReply?: (commentId: string, body: string) => void;
+    onEditBody?: (commentId: string, body: string) => void;
+    onOpenRevision: (revision: TrackedChangeEntrySnapshot) => void;
+    onAcceptRevision: (revisionId: string) => void;
+    onRejectRevision: (revisionId: string) => void;
+    onAcceptAllChanges: () => void;
+    onRejectAllChanges: () => void;
+}
+declare function TwReviewWorkspace(props: TwReviewWorkspaceProps): react_jsx_runtime.JSX.Element;
+
+interface TwEditorSurfaceProps {
+    currentUser: EditorUser;
+    snapshot: RuntimeRenderSnapshot;
+    reviewMode: "editing" | "review";
+    markupDisplay: MarkupDisplay;
+    activeRevisionId?: string;
+    /** When false, revision decorations are suppressed in the document surface. */
+    showTrackedChanges?: boolean;
+    onFocus: FocusEventHandler<HTMLDivElement>;
+    onBlur: FocusEventHandler<HTMLDivElement>;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onInsertText?: (text: string) => void;
+    onDeleteBackward?: () => void;
+    onDeleteForward?: () => void;
+    onInsertTab?: () => void;
+    onInsertHardBreak?: () => void;
+    onSplitParagraph?: () => void;
+    onCommentActivated?: (commentId: string) => void;
+    onRevisionActivated?: (revisionId: string) => void;
+}
+declare function TwEditorSurface(props: TwEditorSurfaceProps): react_jsx_runtime.JSX.Element;
+
+interface RevisionDecorationModel {
+    revisions: RevisionDecorationEntry[];
+}
+interface RevisionDecorationEntry {
+    revisionId: string;
+    from: number;
+    to: number;
+    kind: TrackedChangeEntrySnapshot["kind"];
+    status: TrackedChangeEntrySnapshot["status"];
+    actionability: TrackedChangeEntrySnapshot["actionability"];
+    isActive: boolean;
+}
+interface RevisionRangeState {
+    hasChanges: boolean;
+    hasInsertions: boolean;
+    hasDeletions: boolean;
+    hasActive: boolean;
+    count: number;
+    overlapping: RevisionDecorationEntry[];
+}
+declare function createRevisionDecorationModel(snapshot?: TrackedChangesSnapshot, activeRevisionId?: string): RevisionDecorationModel | undefined;
+declare function getRevisionRangeState(model: RevisionDecorationModel | undefined, from: number, to: number): RevisionRangeState;
+declare function getRevisionHighlightClass(model: RevisionDecorationModel | undefined, from: number, to: number, markupDisplay?: MarkupDisplay): string;
+declare function shouldHideInCleanMode(model: RevisionDecorationModel | undefined, from: number, to: number): boolean;
+
+interface TwParagraphBlockProps {
+    block: Extract<SurfaceBlockSnapshot, {
+        kind: "paragraph";
+    }>;
+    selection: SelectionSnapshot;
+    markupDisplay: MarkupDisplay;
+    commentDecorations?: CommentDecorationModel;
+    revisionDecorations?: RevisionDecorationModel;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onCommentActivated?: (commentId: string) => void;
+    onRevisionActivated?: (revisionId: string) => void;
+}
+declare function TwParagraphBlock(props: TwParagraphBlockProps): react_jsx_runtime.JSX.Element;
+
+interface TwOpaqueBlockProps {
+    block: Extract<SurfaceBlockSnapshot, {
+        kind: "opaque_block";
+    }>;
+    selection: SelectionSnapshot;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+}
+declare function TwOpaqueBlock(props: TwOpaqueBlockProps): react_jsx_runtime.JSX.Element;
+
+interface TwSegmentViewProps {
+    segment: SurfaceInlineSegment;
+    selection: SelectionSnapshot;
+    markupDisplay: MarkupDisplay;
+    commentDecorations?: CommentDecorationModel;
+    revisionDecorations?: RevisionDecorationModel;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onCommentActivated?: (commentId: string) => void;
+    onRevisionActivated?: (revisionId: string) => void;
+}
+declare function TwSegmentView(props: TwSegmentViewProps): react_jsx_runtime.JSX.Element | null;
+
+interface TwInlineTokenProps {
+    segment: SurfaceInlineSegment;
+    selection: SelectionSnapshot;
+    markupDisplay: MarkupDisplay;
+    commentDecorations?: CommentDecorationModel;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+}
+declare function TwInlineToken(props: TwInlineTokenProps): react_jsx_runtime.JSX.Element | null;
+
+declare function renderTwCaret(selection: SelectionSnapshot, position: number): react_jsx_runtime.JSX.Element | null;
+
+interface TwCommentSidebarProps {
+    comments: CommentSidebarSnapshot;
+    activeCommentId?: string;
+    currentUserId?: string;
+    onOpenComment?: (thread: CommentSidebarThreadSnapshot) => void;
+    onResolveComment?: (commentId: string) => void;
+    onReopenComment?: (commentId: string) => void;
+    onAddReply?: (commentId: string, body: string) => void;
+    onEditBody?: (commentId: string, body: string) => void;
+}
+declare function TwCommentSidebar(props: TwCommentSidebarProps): react_jsx_runtime.JSX.Element;
+
+interface TwRevisionSidebarProps {
+    trackedChanges: TrackedChangesSnapshot;
+    markupDisplay: MarkupDisplay;
+    activeRevisionId?: string;
+    onOpenRevision?: (revision: TrackedChangeEntrySnapshot) => void;
+    onAcceptRevision?: (revisionId: string) => void;
+    onRejectRevision?: (revisionId: string) => void;
+    onAcceptAllChanges?: () => void;
+    onRejectAllChanges?: () => void;
+}
+declare function TwRevisionSidebar(props: TwRevisionSidebarProps): react_jsx_runtime.JSX.Element;
+
+interface TwHealthPanelProps {
+    compatibility: CompatibilityPanelSnapshot;
+    warnings: EditorWarning[];
+}
+declare function TwHealthPanel(props: TwHealthPanelProps): react_jsx_runtime.JSX.Element;
+
+interface TwToolbarIconButtonProps {
+    icon: React.ComponentType<{
+        className?: string;
+    }>;
+    label: string;
+    disabled?: boolean;
+    active?: boolean;
+    emphasis?: boolean;
+    onClick?: () => void;
+}
+declare function TwToolbarIconButton(props: TwToolbarIconButtonProps): react_jsx_runtime.JSX.Element;
+
+interface TwStatusBarProps {
+    isDirty: boolean;
+    isExportBlocked: boolean;
+    preserveOnlyCount: number;
+    commentCount: number;
+    changeCount: number;
+    sessionId: string;
+}
+declare function TwStatusBar(props: TwStatusBarProps): react_jsx_runtime.JSX.Element;
+
+interface TwAlertBannerProps {
+    snapshot: RuntimeRenderSnapshot;
+    preserveOnlyCount: number;
+}
+declare function TwAlertBanner(props: TwAlertBannerProps): react_jsx_runtime.JSX.Element | null;
+
+interface TwSelectionToolbarProps {
+    selectionPreview: string;
+    readOnly: boolean;
+    onAddComment?: () => void;
+}
+declare function TwSelectionToolbar(props: TwSelectionToolbarProps): react_jsx_runtime.JSX.Element;
+
+interface EditorKeyboardCallbacks {
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onInsertText?: (text: string) => void;
+    onDeleteBackward?: () => void;
+    onDeleteForward?: () => void;
+    onInsertTab?: () => void;
+    onInsertHardBreak?: () => void;
+    onSplitParagraph?: () => void;
+}
+interface EditorKeyboardContext {
+    selection: SelectionSnapshot;
+    storySize: number;
+    canEdit: boolean;
+}
+declare function createEditorKeyboardHandler(context: EditorKeyboardContext, callbacks: EditorKeyboardCallbacks): (event: KeyboardEvent<HTMLDivElement>) => void;
+
+declare function createSelectionSnapshot(anchor: number, head?: number): SelectionSnapshot;
+declare function selectionTouchesRange(selection: SelectionSnapshot, from: number, to: number): boolean;
+
+export { type CommentDecorationModel, type EditorKeyboardCallbacks, type EditorKeyboardContext, type MarkupDisplay, type ReviewRailTab, type RevisionDecorationModel, type SessionCapabilities, TwAlertBanner, TwCommentSidebar, TwEditorSurface, type TwEditorSurfaceProps, TwHealthPanel, TwInlineToken, TwOpaqueBlock, TwParagraphBlock, TwReviewRail, type TwReviewRailProps, TwReviewWorkspace, type TwReviewWorkspaceProps, TwRevisionSidebar, TwSegmentView, TwSelectionToolbar, TwStatusBar, TwToolbar, TwToolbarIconButton, type TwToolbarProps, type ViewMode, createCommentDecorationModel, createEditorKeyboardHandler, createRevisionDecorationModel, createSelectionSnapshot, deriveCapabilities, getCommentHighlightClass, getCommentRangeState, getRevisionHighlightClass, getRevisionRangeState, renderTwCaret, selectionTouchesRange, shouldHideInCleanMode };

package/dist/tailwind.d.ts

@@ -0,0 +1,323 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { ReactNode, FocusEventHandler, KeyboardEvent } from 'react';
+import { R as RuntimeRenderSnapshot, d as CommentSidebarSnapshot, I as TrackedChangesSnapshot, i as CompatibilityPanelSnapshot, q as EditorWarning, f as CommentSidebarThreadSnapshot, T as TrackedChangeEntrySnapshot, p as EditorUser, y as SelectionSnapshot, z as SurfaceBlockSnapshot, B as SurfaceInlineSegment } from './public-types-DqCURAz8.js';
+
+/**
+ * Session capabilities derived from the runtime snapshot.
+ *
+ * All fields are computed from `RuntimeRenderSnapshot` — no local component
+ * state. The UI reads these to decide what controls to enable/disable, what
+ * chrome to show, and what mode the editor is in.
+ */
+interface SessionCapabilities {
+    /** Current lifecycle phase of the editor session. */
+    phase: "loading" | "ready" | "diagnostics" | "error";
+    /** Effective editor mode after accounting for runtime state. */
+    mode: "editing" | "review" | "read-only-diagnostics";
+    canUndo: boolean;
+    canRedo: boolean;
+    canEdit: boolean;
+    canAddComment: boolean;
+    canExport: boolean;
+    canAcceptChange: boolean;
+    canRejectChange: boolean;
+    canAcceptAll: boolean;
+    canRejectAll: boolean;
+    /** Whether the review rail should be visible by default. */
+    reviewRailVisible: boolean;
+    /** Whether tracked changes exist in the document (display toggle is meaningful). */
+    trackChangesSupported: boolean;
+    exportBlocked: boolean;
+    preserveOnlyCount: number;
+    unsupportedFatalCount: number;
+    /** Total count of health issues (preserve-only + unsupported-fatal + warnings). */
+    healthIssueCount: number;
+    isDirty: boolean;
+    isReady: boolean;
+    hasFatalError: boolean;
+}
+/**
+ * Derive UI capabilities from the runtime snapshot and requested review mode.
+ *
+ * This is a pure function with no side effects. Call it on every render to
+ * get the current capability state.
+ */
+declare function deriveCapabilities(snapshot: RuntimeRenderSnapshot, reviewMode: "editing" | "review"): SessionCapabilities;
+
+interface CommentDecorationModel {
+    threads: CommentDecorationThread[];
+    activeCommentId?: string;
+}
+interface CommentDecorationThread {
+    commentId: string;
+    from: number;
+    to: number;
+    status: CommentSidebarSnapshot["threads"][number]["status"];
+    isActive: boolean;
+}
+interface CommentRangeState {
+    hasComments: boolean;
+    hasOpen: boolean;
+    hasResolved: boolean;
+    hasActive: boolean;
+    count: number;
+    overlapping: CommentDecorationThread[];
+}
+declare function createCommentDecorationModel(snapshot?: CommentSidebarSnapshot): CommentDecorationModel | undefined;
+declare function getCommentRangeState(model: CommentDecorationModel | undefined, from: number, to: number): CommentRangeState;
+type MarkupDisplay = "clean" | "simple" | "all";
+declare function getCommentHighlightClass(model: CommentDecorationModel | undefined, from: number, to: number, markupDisplay?: MarkupDisplay): string;
+
+type ReviewRailTab = "comments" | "changes";
+interface TwReviewRailProps {
+    activeTab: ReviewRailTab;
+    currentUserId?: string;
+    comments: CommentSidebarSnapshot;
+    trackedChanges: TrackedChangesSnapshot;
+    compatibility: CompatibilityPanelSnapshot;
+    warnings: EditorWarning[];
+    markupDisplay: MarkupDisplay;
+    activeCommentId?: string;
+    activeRevisionId?: string;
+    onActiveTabChange: (tab: ReviewRailTab) => void;
+    onOpenComment?: (thread: CommentSidebarThreadSnapshot) => void;
+    onResolveComment?: (commentId: string) => void;
+    onReopenComment?: (commentId: string) => void;
+    onAddReply?: (commentId: string, body: string) => void;
+    onEditBody?: (commentId: string, body: string) => void;
+    onOpenRevision?: (revision: TrackedChangeEntrySnapshot) => void;
+    onAcceptRevision?: (revisionId: string) => void;
+    onRejectRevision?: (revisionId: string) => void;
+    onAcceptAllChanges?: () => void;
+    onRejectAllChanges?: () => void;
+}
+declare function TwReviewRail(props: TwReviewRailProps): react_jsx_runtime.JSX.Element;
+
+type ViewMode = "canvas" | "document";
+interface TwToolbarProps {
+    sourceLabel?: string;
+    capabilities?: SessionCapabilities;
+    compatibility?: CompatibilityPanelSnapshot;
+    warnings?: EditorWarning[];
+    viewMode: ViewMode;
+    /** Display toggle for tracked change decorations (not a runtime mutation toggle). */
+    showTrackedChanges: boolean;
+    onUndo: () => void;
+    onRedo: () => void;
+    onAddComment: () => void;
+    onExport: () => void;
+    onViewModeChange: (value: ViewMode) => void;
+    onShowTrackedChangesChange: (show: boolean) => void;
+}
+declare function TwToolbar(props: TwToolbarProps): react_jsx_runtime.JSX.Element;
+
+interface TwReviewWorkspaceProps {
+    snapshot: RuntimeRenderSnapshot;
+    currentUserId?: string;
+    capabilities?: SessionCapabilities;
+    reviewMode?: "editing" | "review";
+    document: ReactNode;
+    viewMode: ViewMode;
+    activeRailTab: ReviewRailTab;
+    activeCommentId?: string;
+    activeRevisionId?: string;
+    showTrackedChanges: boolean;
+    selectionPreview?: string | null;
+    onViewModeChange: (value: ViewMode) => void;
+    onActiveRailTabChange: (value: ReviewRailTab) => void;
+    onShowTrackedChangesChange: (show: boolean) => void;
+    onUndo: () => void;
+    onRedo: () => void;
+    onAddComment: () => void;
+    onExport: () => void;
+    onOpenComment: (thread: CommentSidebarThreadSnapshot) => void;
+    onResolveComment: (commentId: string) => void;
+    onReopenComment?: (commentId: string) => void;
+    onAddReply?: (commentId: string, body: string) => void;
+    onEditBody?: (commentId: string, body: string) => void;
+    onOpenRevision: (revision: TrackedChangeEntrySnapshot) => void;
+    onAcceptRevision: (revisionId: string) => void;
+    onRejectRevision: (revisionId: string) => void;
+    onAcceptAllChanges: () => void;
+    onRejectAllChanges: () => void;
+}
+declare function TwReviewWorkspace(props: TwReviewWorkspaceProps): react_jsx_runtime.JSX.Element;
+
+interface TwEditorSurfaceProps {
+    currentUser: EditorUser;
+    snapshot: RuntimeRenderSnapshot;
+    reviewMode: "editing" | "review";
+    markupDisplay: MarkupDisplay;
+    activeRevisionId?: string;
+    /** When false, revision decorations are suppressed in the document surface. */
+    showTrackedChanges?: boolean;
+    onFocus: FocusEventHandler<HTMLDivElement>;
+    onBlur: FocusEventHandler<HTMLDivElement>;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onInsertText?: (text: string) => void;
+    onDeleteBackward?: () => void;
+    onDeleteForward?: () => void;
+    onInsertTab?: () => void;
+    onInsertHardBreak?: () => void;
+    onSplitParagraph?: () => void;
+    onCommentActivated?: (commentId: string) => void;
+    onRevisionActivated?: (revisionId: string) => void;
+}
+declare function TwEditorSurface(props: TwEditorSurfaceProps): react_jsx_runtime.JSX.Element;
+
+interface RevisionDecorationModel {
+    revisions: RevisionDecorationEntry[];
+}
+interface RevisionDecorationEntry {
+    revisionId: string;
+    from: number;
+    to: number;
+    kind: TrackedChangeEntrySnapshot["kind"];
+    status: TrackedChangeEntrySnapshot["status"];
+    actionability: TrackedChangeEntrySnapshot["actionability"];
+    isActive: boolean;
+}
+interface RevisionRangeState {
+    hasChanges: boolean;
+    hasInsertions: boolean;
+    hasDeletions: boolean;
+    hasActive: boolean;
+    count: number;
+    overlapping: RevisionDecorationEntry[];
+}
+declare function createRevisionDecorationModel(snapshot?: TrackedChangesSnapshot, activeRevisionId?: string): RevisionDecorationModel | undefined;
+declare function getRevisionRangeState(model: RevisionDecorationModel | undefined, from: number, to: number): RevisionRangeState;
+declare function getRevisionHighlightClass(model: RevisionDecorationModel | undefined, from: number, to: number, markupDisplay?: MarkupDisplay): string;
+declare function shouldHideInCleanMode(model: RevisionDecorationModel | undefined, from: number, to: number): boolean;
+
+interface TwParagraphBlockProps {
+    block: Extract<SurfaceBlockSnapshot, {
+        kind: "paragraph";
+    }>;
+    selection: SelectionSnapshot;
+    markupDisplay: MarkupDisplay;
+    commentDecorations?: CommentDecorationModel;
+    revisionDecorations?: RevisionDecorationModel;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onCommentActivated?: (commentId: string) => void;
+    onRevisionActivated?: (revisionId: string) => void;
+}
+declare function TwParagraphBlock(props: TwParagraphBlockProps): react_jsx_runtime.JSX.Element;
+
+interface TwOpaqueBlockProps {
+    block: Extract<SurfaceBlockSnapshot, {
+        kind: "opaque_block";
+    }>;
+    selection: SelectionSnapshot;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+}
+declare function TwOpaqueBlock(props: TwOpaqueBlockProps): react_jsx_runtime.JSX.Element;
+
+interface TwSegmentViewProps {
+    segment: SurfaceInlineSegment;
+    selection: SelectionSnapshot;
+    markupDisplay: MarkupDisplay;
+    commentDecorations?: CommentDecorationModel;
+    revisionDecorations?: RevisionDecorationModel;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onCommentActivated?: (commentId: string) => void;
+    onRevisionActivated?: (revisionId: string) => void;
+}
+declare function TwSegmentView(props: TwSegmentViewProps): react_jsx_runtime.JSX.Element | null;
+
+interface TwInlineTokenProps {
+    segment: SurfaceInlineSegment;
+    selection: SelectionSnapshot;
+    markupDisplay: MarkupDisplay;
+    commentDecorations?: CommentDecorationModel;
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+}
+declare function TwInlineToken(props: TwInlineTokenProps): react_jsx_runtime.JSX.Element | null;
+
+declare function renderTwCaret(selection: SelectionSnapshot, position: number): react_jsx_runtime.JSX.Element | null;
+
+interface TwCommentSidebarProps {
+    comments: CommentSidebarSnapshot;
+    activeCommentId?: string;
+    currentUserId?: string;
+    onOpenComment?: (thread: CommentSidebarThreadSnapshot) => void;
+    onResolveComment?: (commentId: string) => void;
+    onReopenComment?: (commentId: string) => void;
+    onAddReply?: (commentId: string, body: string) => void;
+    onEditBody?: (commentId: string, body: string) => void;
+}
+declare function TwCommentSidebar(props: TwCommentSidebarProps): react_jsx_runtime.JSX.Element;
+
+interface TwRevisionSidebarProps {
+    trackedChanges: TrackedChangesSnapshot;
+    markupDisplay: MarkupDisplay;
+    activeRevisionId?: string;
+    onOpenRevision?: (revision: TrackedChangeEntrySnapshot) => void;
+    onAcceptRevision?: (revisionId: string) => void;
+    onRejectRevision?: (revisionId: string) => void;
+    onAcceptAllChanges?: () => void;
+    onRejectAllChanges?: () => void;
+}
+declare function TwRevisionSidebar(props: TwRevisionSidebarProps): react_jsx_runtime.JSX.Element;
+
+interface TwHealthPanelProps {
+    compatibility: CompatibilityPanelSnapshot;
+    warnings: EditorWarning[];
+}
+declare function TwHealthPanel(props: TwHealthPanelProps): react_jsx_runtime.JSX.Element;
+
+interface TwToolbarIconButtonProps {
+    icon: React.ComponentType<{
+        className?: string;
+    }>;
+    label: string;
+    disabled?: boolean;
+    active?: boolean;
+    emphasis?: boolean;
+    onClick?: () => void;
+}
+declare function TwToolbarIconButton(props: TwToolbarIconButtonProps): react_jsx_runtime.JSX.Element;
+
+interface TwStatusBarProps {
+    isDirty: boolean;
+    isExportBlocked: boolean;
+    preserveOnlyCount: number;
+    commentCount: number;
+    changeCount: number;
+    sessionId: string;
+}
+declare function TwStatusBar(props: TwStatusBarProps): react_jsx_runtime.JSX.Element;
+
+interface TwAlertBannerProps {
+    snapshot: RuntimeRenderSnapshot;
+    preserveOnlyCount: number;
+}
+declare function TwAlertBanner(props: TwAlertBannerProps): react_jsx_runtime.JSX.Element | null;
+
+interface TwSelectionToolbarProps {
+    selectionPreview: string;
+    readOnly: boolean;
+    onAddComment?: () => void;
+}
+declare function TwSelectionToolbar(props: TwSelectionToolbarProps): react_jsx_runtime.JSX.Element;
+
+interface EditorKeyboardCallbacks {
+    onSelectionChange?: (selection: SelectionSnapshot) => void;
+    onInsertText?: (text: string) => void;
+    onDeleteBackward?: () => void;
+    onDeleteForward?: () => void;
+    onInsertTab?: () => void;
+    onInsertHardBreak?: () => void;
+    onSplitParagraph?: () => void;
+}
+interface EditorKeyboardContext {
+    selection: SelectionSnapshot;
+    storySize: number;
+    canEdit: boolean;
+}
+declare function createEditorKeyboardHandler(context: EditorKeyboardContext, callbacks: EditorKeyboardCallbacks): (event: KeyboardEvent<HTMLDivElement>) => void;
+
+declare function createSelectionSnapshot(anchor: number, head?: number): SelectionSnapshot;
+declare function selectionTouchesRange(selection: SelectionSnapshot, from: number, to: number): boolean;
+
+export { type CommentDecorationModel, type EditorKeyboardCallbacks, type EditorKeyboardContext, type MarkupDisplay, type ReviewRailTab, type RevisionDecorationModel, type SessionCapabilities, TwAlertBanner, TwCommentSidebar, TwEditorSurface, type TwEditorSurfaceProps, TwHealthPanel, TwInlineToken, TwOpaqueBlock, TwParagraphBlock, TwReviewRail, type TwReviewRailProps, TwReviewWorkspace, type TwReviewWorkspaceProps, TwRevisionSidebar, TwSegmentView, TwSelectionToolbar, TwStatusBar, TwToolbar, TwToolbarIconButton, type TwToolbarProps, type ViewMode, createCommentDecorationModel, createEditorKeyboardHandler, createRevisionDecorationModel, createSelectionSnapshot, deriveCapabilities, getCommentHighlightClass, getCommentRangeState, getRevisionHighlightClass, getRevisionRangeState, renderTwCaret, selectionTouchesRange, shouldHideInCleanMode };