@beyondwork/docx-react-component 1.0.0 → 1.0.1

package/dist/public-types-DqCURAz8.d.cts

@@ -0,0 +1,1152 @@
+type Position = number;
+type Assoc = -1 | 1;
+interface DocRange$1 {
+    from: Position;
+    to: Position;
+}
+interface BoundaryAssoc$1 {
+    start: Assoc;
+    end: Assoc;
+}
+interface RangeAnchor {
+    kind: "range";
+    range: DocRange$1;
+    assoc: BoundaryAssoc$1;
+}
+interface NodeAnchor {
+    kind: "node";
+    at: Position;
+    assoc: Assoc;
+}
+interface DetachedAnchor {
+    kind: "detached";
+    lastKnownRange: DocRange$1;
+    reason: "deleted" | "invalidatedByStructureChange" | "importAmbiguity";
+}
+type EditorAnchorProjection$1 = RangeAnchor | NodeAnchor | DetachedAnchor;
+
+declare const CDS_SCHEMA_VERSION: "cds/1.0.0";
+declare const PERSISTED_EDITOR_SNAPSHOT_VERSION: "persisted-editor-snapshot/1";
+declare const COMPATIBILITY_REPORT_VERSION: "compatibility-report/1";
+type PersistedEditorSnapshotVersion = typeof PERSISTED_EDITOR_SNAPSHOT_VERSION;
+type CompatibilityReportVersion = typeof COMPATIBILITY_REPORT_VERSION;
+type UUID = string;
+type ISO8601DateTime = string;
+
+interface CanonicalDocument {
+    schemaVersion: typeof CDS_SCHEMA_VERSION;
+    docId: UUID;
+    createdAt: ISO8601DateTime;
+    updatedAt: ISO8601DateTime;
+    metadata: DocumentMetadata;
+    styles: StylesCatalog;
+    numbering: NumberingCatalog;
+    media: MediaCatalog;
+    content: DocumentNode;
+    review: ReviewStore;
+    preservation: PreservationStore;
+    diagnostics: DiagnosticStore;
+    subParts?: SubPartsCatalog;
+}
+interface DocumentMetadata {
+    title?: string;
+    subject?: string;
+    description?: string;
+    language?: string;
+    keywords?: string[];
+    category?: string;
+    customProperties: Record<string, string>;
+}
+interface StylesCatalog {
+    paragraphs: Record<string, ParagraphStyleDefinition>;
+    characters: Record<string, CharacterStyleDefinition>;
+    tables: Record<string, TableStyleDefinition>;
+    latentStyles?: Record<string, LatentStyleDefinition>;
+}
+interface ParagraphStyleDefinition {
+    styleId: string;
+    basedOn?: string;
+    nextStyle?: string;
+    displayName: string;
+    kind: "paragraph";
+    isDefault: boolean;
+}
+interface CharacterStyleDefinition {
+    styleId: string;
+    basedOn?: string;
+    displayName: string;
+    kind: "character";
+    isDefault: boolean;
+}
+interface TableStyleDefinition {
+    styleId: string;
+    basedOn?: string;
+    displayName: string;
+    kind: "table";
+    isDefault: boolean;
+}
+interface LatentStyleDefinition {
+    name: string;
+    locked?: boolean;
+    semiHidden?: boolean;
+    unhideWhenUsed?: boolean;
+    qFormat?: boolean;
+    uiPriority?: number;
+}
+interface NumberingCatalog {
+    abstractDefinitions: Record<string, AbstractNumberingDefinition>;
+    instances: Record<string, NumberingInstance>;
+}
+interface AbstractNumberingDefinition {
+    abstractNumberingId: string;
+    levels: NumberingLevelDefinition[];
+}
+interface NumberingLevelDefinition {
+    level: number;
+    format: string;
+    text: string;
+    startAt?: number;
+    paragraphStyleId?: string;
+}
+interface NumberingInstance {
+    numberingInstanceId: string;
+    abstractNumberingId: string;
+    overrides: NumberingLevelOverride[];
+}
+interface NumberingLevelOverride {
+    level: number;
+    startAt?: number;
+}
+interface MediaCatalog {
+    items: Record<string, MediaItem>;
+}
+interface MediaItem {
+    mediaId: string;
+    contentType: string;
+    filename: string;
+    relationshipId?: string;
+    packagePartName: string;
+    altText?: string;
+}
+type HeaderFooterVariant = "default" | "first" | "even";
+interface HeaderDocument {
+    variant: HeaderFooterVariant;
+    partPath: string;
+    relationshipId: string;
+    blocks: BlockNode[];
+}
+interface FooterDocument {
+    variant: HeaderFooterVariant;
+    partPath: string;
+    relationshipId: string;
+    blocks: BlockNode[];
+}
+interface FootnoteDefinition {
+    noteId: string;
+    kind: "footnote" | "endnote";
+    blocks: BlockNode[];
+}
+interface FootnoteCollection {
+    footnotes: Record<string, FootnoteDefinition>;
+    endnotes: Record<string, FootnoteDefinition>;
+}
+interface ThemeColorScheme {
+    name: string;
+    colors: Record<string, string>;
+}
+interface ThemeFontScheme {
+    name: string;
+    majorFont?: string;
+    minorFont?: string;
+}
+interface ThemeDefinition {
+    name?: string;
+    colorScheme?: ThemeColorScheme;
+    fontScheme?: ThemeFontScheme;
+}
+interface SubPartsCatalog {
+    headers: HeaderDocument[];
+    footers: FooterDocument[];
+    footnoteCollection?: FootnoteCollection;
+    theme?: ThemeDefinition;
+}
+interface FootnoteRefNode {
+    type: "footnote_ref";
+    noteId: string;
+    noteKind: "footnote" | "endnote";
+}
+type DocumentNode = DocumentRootNode | ParagraphNode | TableNode | TableRowNode | TableCellNode | SdtNode | CustomXmlNode | AltChunkNode | TextNode | HardBreakNode | TabNode | ColumnBreakNode | SymbolNode | HyperlinkNode | ImageNode | FieldNode | BookmarkStartNode | BookmarkEndNode | SectionBreakNode | OpaqueInlineNode | OpaqueBlockNode | FootnoteRefNode | ChartPreviewNode | SmartArtPreviewNode | ShapeNode | WordArtNode | VmlShapeNode;
+interface DocumentRootNode {
+    type: "doc";
+    children: BlockNode[];
+}
+type BlockNode = ParagraphNode | TableNode | SdtNode | CustomXmlNode | AltChunkNode | SectionBreakNode | OpaqueBlockNode;
+interface ParagraphSpacing {
+    before?: number;
+    after?: number;
+    line?: number;
+    lineRule?: "auto" | "exact" | "atLeast";
+}
+interface ParagraphIndentation {
+    left?: number;
+    right?: number;
+    firstLine?: number;
+    hanging?: number;
+}
+interface TabStop {
+    position: number;
+    align: "left" | "center" | "right" | "decimal" | "bar" | "clear";
+    leader?: "none" | "dot" | "hyphen" | "underscore" | "heavy" | "middleDot";
+}
+interface ParagraphBorders {
+    top?: BorderSpec;
+    left?: BorderSpec;
+    bottom?: BorderSpec;
+    right?: BorderSpec;
+    bar?: BorderSpec;
+    between?: BorderSpec;
+}
+interface ParagraphShading {
+    fill?: string;
+    color?: string;
+    val?: string;
+}
+interface ParagraphNode {
+    type: "paragraph";
+    styleId?: string;
+    numbering?: {
+        numberingInstanceId: string;
+        level: number;
+    };
+    alignment?: "left" | "center" | "right" | "both" | "distribute";
+    spacing?: ParagraphSpacing;
+    indentation?: ParagraphIndentation;
+    tabStops?: TabStop[];
+    keepNext?: boolean;
+    keepLines?: boolean;
+    outlineLevel?: number;
+    pageBreakBefore?: boolean;
+    widowControl?: boolean;
+    borders?: ParagraphBorders;
+    shading?: ParagraphShading;
+    bidi?: boolean;
+    suppressLineNumbers?: boolean;
+    cnfStyle?: string;
+    children: InlineNode[];
+}
+interface BorderSpec {
+    value?: string;
+    size?: number;
+    space?: number;
+    color?: string;
+}
+interface TableBorders {
+    top?: BorderSpec;
+    left?: BorderSpec;
+    bottom?: BorderSpec;
+    right?: BorderSpec;
+    insideH?: BorderSpec;
+    insideV?: BorderSpec;
+}
+interface TableCellBorders {
+    top?: BorderSpec;
+    left?: BorderSpec;
+    bottom?: BorderSpec;
+    right?: BorderSpec;
+    insideH?: BorderSpec;
+    insideV?: BorderSpec;
+}
+interface TableWidth {
+    value: number;
+    type: "dxa" | "auto" | "pct" | "nil";
+}
+interface CellShading {
+    fill?: string;
+    color?: string;
+    val?: string;
+}
+interface TableCellMargins {
+    top?: number;
+    left?: number;
+    bottom?: number;
+    right?: number;
+}
+interface TableLook {
+    val?: string;
+    firstRow?: boolean;
+    lastRow?: boolean;
+    firstColumn?: boolean;
+    lastColumn?: boolean;
+    noHBand?: boolean;
+    noVBand?: boolean;
+}
+interface TableNode {
+    type: "table";
+    styleId?: string;
+    propertiesXml?: string;
+    gridColumns: number[];
+    rows: TableRowNode[];
+    width?: TableWidth;
+    alignment?: "left" | "center" | "right";
+    borders?: TableBorders;
+    cellMargins?: TableCellMargins;
+    tblLook?: TableLook;
+}
+interface TableRowNode {
+    type: "table_row";
+    propertiesXml?: string;
+    cells: TableCellNode[];
+    height?: number;
+    heightRule?: "auto" | "atLeast" | "exact";
+    isHeader?: boolean;
+}
+interface TableCellNode {
+    type: "table_cell";
+    propertiesXml?: string;
+    gridSpan?: number;
+    verticalMerge?: "restart" | "continue";
+    children: BlockNode[];
+    width?: TableWidth;
+    borders?: TableCellBorders;
+    shading?: CellShading;
+    verticalAlign?: "top" | "center" | "bottom";
+}
+interface SdtNode {
+    type: "sdt";
+    properties: {
+        sdtType?: string;
+        alias?: string;
+        tag?: string;
+        lock?: string;
+        propertiesXml?: string;
+    };
+    children: BlockNode[];
+}
+interface CustomXmlNode {
+    type: "custom_xml";
+    uri?: string;
+    element?: string;
+    children: BlockNode[];
+}
+interface AltChunkNode {
+    type: "alt_chunk";
+    relationshipId: string;
+}
+interface FieldNode {
+    type: "field";
+    fieldType: "simple" | "complex";
+    instruction: string;
+    children: InlineNode[];
+}
+interface BookmarkStartNode {
+    type: "bookmark_start";
+    bookmarkId: string;
+    name: string;
+}
+interface BookmarkEndNode {
+    type: "bookmark_end";
+    bookmarkId: string;
+}
+interface SectionBreakNode {
+    type: "section_break";
+    propertiesXml?: string;
+}
+type InlineNode = TextNode | HardBreakNode | TabNode | HyperlinkNode | ImageNode | FieldNode | BookmarkStartNode | BookmarkEndNode | OpaqueInlineNode | FootnoteRefNode | ChartPreviewNode | SmartArtPreviewNode | ShapeNode | WordArtNode | VmlShapeNode;
+interface TextNode {
+    type: "text";
+    text: string;
+    marks?: TextMark[];
+}
+type TextMark = {
+    type: "bold";
+} | {
+    type: "italic";
+} | {
+    type: "underline";
+} | {
+    type: "strikethrough";
+} | {
+    type: "doubleStrikethrough";
+} | {
+    type: "vanish";
+} | {
+    type: "lang";
+    val: string;
+} | {
+    type: "backgroundColor";
+    color: string;
+} | {
+    type: "charSpacing";
+    val: number;
+} | {
+    type: "kerning";
+    val: number;
+} | {
+    type: "emboss";
+} | {
+    type: "imprint";
+} | {
+    type: "shadow";
+} | {
+    type: "position";
+    val: number;
+} | {
+    type: "textFill";
+    xml: string;
+};
+interface HardBreakNode {
+    type: "hard_break";
+}
+interface ColumnBreakNode {
+    type: "column_break";
+}
+interface TabNode {
+    type: "tab";
+}
+interface SymbolNode {
+    type: "symbol";
+    char: string;
+    font?: string;
+    marks?: TextMark[];
+}
+interface HyperlinkNode {
+    type: "hyperlink";
+    href: string;
+    children: Array<TextNode | HardBreakNode | ColumnBreakNode | TabNode | SymbolNode>;
+}
+interface ImageNode {
+    type: "image";
+    mediaId: string;
+    altText?: string;
+    placementXml?: string;
+    display?: "inline" | "floating";
+    floating?: FloatingImageProperties;
+}
+interface FloatingImageProperties {
+    horizontalPosition?: FloatingAxisPosition;
+    verticalPosition?: FloatingAxisPosition;
+    wrap?: "none" | "square" | "tight" | "through" | "topAndBottom";
+    behindDoc?: boolean;
+    layoutInCell?: boolean;
+    allowOverlap?: boolean;
+}
+interface FloatingAxisPosition {
+    relativeFrom?: string;
+    align?: string;
+    offset?: number;
+}
+interface OpaqueInlineNode {
+    type: "opaque_inline";
+    fragmentId: string;
+    warningId: string;
+}
+/**
+ * Read-only preview of a chart (c:chart). The original drawing XML is stored in
+ * rawXml for lossless round-trip export. If a fallback image was present in
+ * mc:AlternateContent it is referenced by previewMediaId.
+ */
+interface ChartPreviewNode {
+    type: "chart_preview";
+    previewMediaId?: string;
+    rawXml: string;
+}
+/**
+ * Read-only preview of a SmartArt diagram (dgm:*). The original drawing XML is
+ * stored in rawXml for lossless round-trip export.
+ */
+interface SmartArtPreviewNode {
+    type: "smartart_preview";
+    previewMediaId?: string;
+    rawXml: string;
+}
+/**
+ * Read-only rendering of a wps:wsp WordprocessingShape. Text content is
+ * extracted for display. The original drawing XML is preserved in rawXml.
+ */
+interface ShapeNode {
+    type: "shape";
+    text?: string;
+    geometry?: string;
+    rawXml: string;
+}
+/**
+ * Read-only rendering of WordArt — a wps:wsp shape with a text-geometry preset.
+ * Text is extracted for display. The original drawing XML is preserved in rawXml.
+ */
+interface WordArtNode {
+    type: "wordart";
+    text: string;
+    geometry?: string;
+    rawXml: string;
+}
+/**
+ * Read-only rendering of a VML shape (v:shape, v:rect, v:textbox) from a w:pict
+ * element. Text is extracted for display. The original w:pict XML is preserved
+ * in rawXml for lossless round-trip export.
+ */
+interface VmlShapeNode {
+    type: "vml_shape";
+    text?: string;
+    shapeType?: string;
+    rawXml: string;
+}
+interface OpaqueBlockNode {
+    type: "opaque_block";
+    fragmentId: string;
+    warningId: string;
+}
+interface DocRange {
+    from: number;
+    to: number;
+}
+interface BoundaryAssoc {
+    start: -1 | 1;
+    end: -1 | 1;
+}
+type CanonicalAnchor = {
+    kind: "range";
+    range: DocRange;
+    assoc: BoundaryAssoc;
+} | {
+    kind: "node";
+    at: number;
+    assoc: -1 | 1;
+} | {
+    kind: "detached";
+    lastKnownRange: DocRange;
+    reason: "deleted" | "invalidatedByStructureChange" | "importAmbiguity";
+};
+interface ReviewStore {
+    comments: Record<string, CommentThread>;
+    revisions: Record<string, RevisionRecord>;
+}
+interface CommentThread {
+    commentId: string;
+    status: "open" | "resolved" | "detached";
+    anchor: CanonicalAnchor;
+    createdAt: ISO8601DateTime;
+    createdBy?: string;
+    authorId?: string;
+    body?: string;
+    entries?: CommentEntry[];
+    resolution?: CommentResolution;
+    resolvedAt?: ISO8601DateTime;
+    warningIds: string[];
+    isResolved?: boolean;
+    metadata?: CommentThreadMetadata;
+}
+interface CommentEntry {
+    entryId: string;
+    authorId: string;
+    createdAt: ISO8601DateTime;
+    body: string;
+    metadata?: CommentEntryMetadata;
+}
+interface CommentEntryMetadata {
+    ooxmlCommentId?: string;
+    paraId?: string;
+    parentParaId?: string;
+    durableId?: string;
+    initials?: string;
+}
+interface CommentResolution {
+    resolvedAt: ISO8601DateTime;
+    resolvedBy: string;
+}
+interface CommentThreadMetadata {
+    source?: "runtime" | "import";
+    rootOoxmlCommentId?: string;
+    rootParaId?: string;
+}
+interface RevisionPropertyChangeData {
+    xmlTag: "pPrChange" | "sectPrChange" | "tblPrChange" | "rPrChange";
+    beforeXml: string;
+}
+interface RevisionMoveData {
+    moveId: string;
+    direction: "from" | "to";
+}
+interface RevisionRecord {
+    changeId: string;
+    kind: "insertion" | "deletion" | "formatting" | "move" | "property-change";
+    anchor: CanonicalAnchor;
+    authorId?: string;
+    createdAt: ISO8601DateTime;
+    warningIds?: string[];
+    metadata?: RevisionMetadataRecord;
+    status: "open" | "accepted" | "rejected" | "detached";
+}
+interface RevisionMetadataRecord {
+    source?: "runtime" | "import";
+    preserveOnlyReason?: string;
+    importedRevisionForm?: "run-insertion" | "run-deletion" | "paragraph-insertion" | "paragraph-deletion";
+    originalRevisionType?: string;
+    ooxmlRevisionId?: string;
+    propertyChangeData?: RevisionPropertyChangeData;
+    moveData?: RevisionMoveData;
+}
+interface PreservationStore {
+    opaqueFragments: Record<string, OpaqueFragmentRecord>;
+    packageParts: Record<string, PreservedPackagePart>;
+}
+interface OpaqueFragmentRecord {
+    fragmentId: string;
+    payloadKind: "xml-subtree" | "package-part";
+    payloadReference: string;
+    featureClass: "preserve-only";
+    lastKnownRange: DocRange;
+    warningId: string;
+    packagePartName?: string;
+    relationshipId?: string;
+}
+interface PreservedPackagePart {
+    packagePartName: string;
+    contentType: string;
+    relationshipIds: string[];
+}
+interface DiagnosticStore {
+    warnings: DiagnosticWarningEntry[];
+    errors: DiagnosticErrorEntry[];
+}
+interface DiagnosticWarningEntry {
+    diagnosticId: string;
+    warningId: string;
+    source: "import" | "runtime" | "review" | "preservation" | "validation" | "export";
+    message: string;
+}
+interface DiagnosticErrorEntry {
+    diagnosticId: string;
+    code: "load_failed" | "export_failed" | "package_corrupt" | "validation_failed" | "datastore_failed" | "internal_invariant";
+    message: string;
+    isFatal: boolean;
+    source: "import" | "runtime" | "validation" | "datastore" | "export";
+}
+
+type EditorWarningCode$2 = "unsupported_ooxml_preserved" | "unsupported_ooxml_locked" | "import_normalized" | "export_roundtrip_risk" | "comment_anchor_detached" | "revision_anchor_detached" | "large_document_degraded" | "font_substitution" | "image_missing";
+interface EditorWarning$2 {
+    warningId: string;
+    code: EditorWarningCode$2;
+    severity: "info" | "warning";
+    message: string;
+    source: "import" | "runtime" | "review" | "preservation" | "validation" | "export";
+    affectedAnchor?: Record<string, unknown>;
+    featureEntryId?: string;
+    details?: Record<string, unknown>;
+}
+type EditorErrorCode$1 = "import_failed" | "export_failed" | "package_corrupt" | "validation_failed" | "datastore_failed" | "internal_invariant";
+interface EditorError$2 {
+    errorId: string;
+    code: EditorErrorCode$1;
+    message: string;
+    isFatal: boolean;
+    source: "import" | "runtime" | "validation" | "datastore" | "export";
+    details?: Record<string, unknown>;
+}
+type CompatibilityFeatureClass$2 = "supported-roundtrip" | "preserve-only" | "unsupported-fatal";
+interface CompatibilityFeatureEntry$2 {
+    featureEntryId: string;
+    featureKey: string;
+    featureClass: CompatibilityFeatureClass$2;
+    message: string;
+    affectedAnchor?: Record<string, unknown>;
+    details?: Record<string, unknown>;
+}
+interface CompatibilityReport$2 {
+    reportVersion: CompatibilityReportVersion;
+    generatedAt: ISO8601DateTime;
+    blockExport: boolean;
+    featureEntries: CompatibilityFeatureEntry$2[];
+    warnings: EditorWarning$2[];
+    errors: EditorError$2[];
+}
+interface PersistedEditorSnapshot$2 {
+    snapshotVersion: PersistedEditorSnapshotVersion;
+    schemaVersion: typeof CDS_SCHEMA_VERSION;
+    documentId: string;
+    docId: string;
+    createdAt: ISO8601DateTime;
+    updatedAt: ISO8601DateTime;
+    savedAt: ISO8601DateTime;
+    editorBuild: string;
+    canonicalDocument: CanonicalDocument;
+    compatibility: CompatibilityReport$2;
+    warningLog: EditorWarning$2[];
+}
+
+type EditorWarningCode$1 = "unsupported_ooxml_preserved" | "unsupported_ooxml_locked" | "import_normalized" | "export_roundtrip_risk" | "comment_anchor_detached" | "revision_anchor_detached" | "large_document_degraded" | "font_substitution" | "image_missing";
+interface EditorWarning$1 {
+    warningId: string;
+    code: EditorWarningCode$1;
+    severity: "info" | "warning";
+    message: string;
+    source: "import" | "runtime" | "review" | "preservation" | "validation" | "export";
+    affectedAnchor?: EditorAnchorProjection$1;
+    featureEntryId?: string;
+    details?: Record<string, unknown>;
+}
+interface EditorError$1 {
+    errorId: string;
+    code: "import_failed" | "export_failed" | "package_corrupt" | "validation_failed" | "datastore_failed" | "internal_invariant";
+    message: string;
+    isFatal: boolean;
+    source: "import" | "runtime" | "validation" | "datastore" | "export";
+    details?: Record<string, unknown>;
+}
+type CompatibilityFeatureClass$1 = "supported-roundtrip" | "preserve-only" | "unsupported-fatal";
+interface CompatibilityFeatureEntry$1 {
+    featureEntryId: string;
+    featureKey: string;
+    featureClass: CompatibilityFeatureClass$1;
+    message: string;
+    affectedAnchor?: EditorAnchorProjection$1;
+    details?: Record<string, unknown>;
+}
+interface CompatibilityReport$1 {
+    reportVersion: "compatibility-report/1";
+    generatedAt: string;
+    blockExport: boolean;
+    featureEntries: CompatibilityFeatureEntry$1[];
+    warnings: EditorWarning$1[];
+    errors: EditorError$1[];
+}
+type CanonicalDocumentEnvelope = CanonicalDocument;
+interface PersistedEditorSnapshot$1 extends Omit<PersistedEditorSnapshot$2, "canonicalDocument" | "compatibility" | "warningLog"> {
+    canonicalDocument: CanonicalDocumentEnvelope;
+    compatibility: CompatibilityReport$1;
+    warningLog: EditorWarning$1[];
+}
+
+type ExternalDocumentSource = {
+    kind: "docx";
+    bytes: Uint8Array | ArrayBuffer;
+    sourceLabel?: string;
+} | {
+    kind: "snapshot";
+    snapshot: PersistedEditorSnapshot;
+    sourceLabel?: string;
+};
+interface EditorUser {
+    userId: string;
+    displayName: string;
+    email?: string;
+    avatarUrl?: string;
+}
+type EditorAnchorProjection = {
+    kind: "range";
+    from: number;
+    to: number;
+    assoc: {
+        start: -1 | 1;
+        end: -1 | 1;
+    };
+} | {
+    kind: "node";
+    at: number;
+    assoc: -1 | 1;
+} | {
+    kind: "detached";
+    lastKnownRange: {
+        from: number;
+        to: number;
+    };
+    reason: "deleted" | "invalidatedByStructureChange" | "importAmbiguity";
+};
+interface SelectionSnapshot {
+    anchor: number;
+    head: number;
+    isCollapsed: boolean;
+    activeRange: EditorAnchorProjection;
+}
+interface DocumentStats {
+    storyLength: number;
+    commentCount: number;
+    revisionCount: number;
+    opaqueFragmentCount: number;
+}
+interface CommentSidebarSnapshot {
+    activeCommentId?: string;
+    openCommentIds: string[];
+    resolvedCommentIds: string[];
+    detachedCommentIds: string[];
+    totalCount: number;
+    threads: CommentSidebarThreadSnapshot[];
+}
+interface CommentSidebarThreadEntrySnapshot {
+    entryId: string;
+    authorId: string;
+    body: string;
+    createdAt: string;
+}
+interface CommentSidebarThreadSnapshot {
+    commentId: string;
+    status: "open" | "resolved" | "detached";
+    anchor: EditorAnchorProjection;
+    excerpt: string;
+    entryCount: number;
+    entries: CommentSidebarThreadEntrySnapshot[];
+    createdAt: string;
+    createdBy: string;
+    warningCount: number;
+    anchorLabel: string;
+    isActive: boolean;
+    resolvedAt?: string;
+    resolvedBy?: string;
+}
+interface TrackedChangeEntrySnapshot {
+    revisionId: string;
+    kind: "insertion" | "deletion" | "formatting" | "move" | "property-change";
+    label: string;
+    status: "active" | "accepted" | "rejected" | "detached";
+    actionability: "actionable" | "preserve-only";
+    importedRevisionForm?: "run-insertion" | "run-deletion" | "paragraph-insertion" | "paragraph-deletion";
+    anchor: EditorAnchorProjection;
+    anchorLabel: string;
+    createdAt: string;
+    authorId: string;
+    warningCount: number;
+    canAccept: boolean;
+    canReject: boolean;
+    preserveOnlyReason?: string;
+    excerpt?: string;
+    detail?: string;
+}
+interface TrackedChangesSnapshot {
+    pendingChangeIds: string[];
+    acceptedChangeIds: string[];
+    rejectedChangeIds: string[];
+    detachedChangeIds: string[];
+    actionableChangeIds: string[];
+    preserveOnlyChangeIds: string[];
+    totalCount: number;
+    revisions: TrackedChangeEntrySnapshot[];
+}
+type SurfaceTextMark = "bold" | "italic" | "underline" | "strikethrough";
+type SurfaceInlineSegment = {
+    segmentId: string;
+    kind: "text";
+    from: number;
+    to: number;
+    text: string;
+    marks?: SurfaceTextMark[];
+    hyperlinkHref?: string;
+} | {
+    segmentId: string;
+    kind: "tab" | "hard_break";
+    from: number;
+    to: number;
+    hyperlinkHref?: string;
+} | {
+    segmentId: string;
+    kind: "image";
+    from: number;
+    to: number;
+    mediaId: string;
+    altText?: string;
+    state: "editable" | "missing";
+    display?: "inline" | "floating";
+    detail?: string;
+} | {
+    segmentId: string;
+    kind: "opaque_inline";
+    from: number;
+    to: number;
+    fragmentId: string;
+    warningId: string;
+    label: string;
+    detail: string;
+    state: "locked-preserve-only";
+};
+interface SurfaceTableCellSnapshot {
+    gridSpan: number;
+    verticalMerge: "restart" | "continue" | null;
+    colspan: number;
+    rowspan: number;
+    content: SurfaceBlockSnapshot[];
+}
+interface SurfaceTableRowSnapshot {
+    cells: SurfaceTableCellSnapshot[];
+}
+type SurfaceBlockSnapshot = {
+    blockId: string;
+    kind: "paragraph";
+    from: number;
+    to: number;
+    styleId?: string;
+    numbering?: {
+        numberingInstanceId: string;
+        level: number;
+    };
+    segments: SurfaceInlineSegment[];
+} | {
+    blockId: string;
+    kind: "table";
+    from: number;
+    to: number;
+    styleId?: string;
+    gridColumns: number[];
+    rows: SurfaceTableRowSnapshot[];
+} | {
+    blockId: string;
+    kind: "sdt_block";
+    from: number;
+    to: number;
+    sdtType?: string;
+    alias?: string;
+    tag?: string;
+    lock?: string;
+    children: SurfaceBlockSnapshot[];
+} | {
+    blockId: string;
+    kind: "opaque_block";
+    from: number;
+    to: number;
+    fragmentId: string;
+    warningId: string;
+    label: string;
+    detail: string;
+    state: "locked-preserve-only";
+};
+interface EditorSurfaceSnapshot {
+    storySize: number;
+    plainText: string;
+    blocks: SurfaceBlockSnapshot[];
+    lockedFragmentIds: string[];
+}
+type EditorWarningCode = "unsupported_ooxml_preserved" | "unsupported_ooxml_locked" | "import_normalized" | "export_roundtrip_risk" | "comment_anchor_detached" | "revision_anchor_detached" | "large_document_degraded" | "font_substitution" | "image_missing";
+interface EditorWarning {
+    warningId: string;
+    code: EditorWarningCode;
+    severity: "info" | "warning";
+    message: string;
+    source: "import" | "runtime" | "review" | "preservation" | "validation" | "export";
+    affectedAnchor?: EditorAnchorProjection;
+    featureEntryId?: string;
+    details?: Record<string, unknown>;
+}
+type EditorErrorCode = "import_failed" | "export_failed" | "package_corrupt" | "validation_failed" | "datastore_failed" | "internal_invariant";
+interface EditorError {
+    errorId: string;
+    code: EditorErrorCode;
+    message: string;
+    isFatal: boolean;
+    source: "import" | "runtime" | "validation" | "datastore" | "export";
+    details?: Record<string, unknown>;
+}
+type CompatibilityFeatureClass = "supported-roundtrip" | "preserve-only" | "unsupported-fatal";
+interface CompatibilityFeatureEntry {
+    featureEntryId: string;
+    featureKey: string;
+    featureClass: CompatibilityFeatureClass;
+    message: string;
+    affectedAnchor?: EditorAnchorProjection;
+    details?: Record<string, unknown>;
+}
+interface CompatibilityReport {
+    reportVersion: "compatibility-report/1";
+    generatedAt: string;
+    blockExport: boolean;
+    featureEntries: CompatibilityFeatureEntry[];
+    warnings: EditorWarning[];
+    errors: EditorError[];
+}
+interface CompatibilityPanelSnapshot {
+    blockExport: boolean;
+    blockExportReasons: string[];
+    warningCount: number;
+    errorCount: number;
+    featureEntries: CompatibilityFeatureEntry[];
+}
+interface CommandStateSnapshot {
+    canUndo: boolean;
+    canRedo: boolean;
+    readOnly: boolean;
+}
+interface RuntimeRenderSnapshot {
+    documentId: string;
+    sessionId: string;
+    sourceLabel?: string;
+    revisionToken: string;
+    isReady: boolean;
+    isDirty: boolean;
+    readOnly: boolean;
+    selection: SelectionSnapshot;
+    documentStats: DocumentStats;
+    comments: CommentSidebarSnapshot;
+    trackedChanges: TrackedChangesSnapshot;
+    compatibility: CompatibilityPanelSnapshot;
+    warnings: EditorWarning[];
+    fatalError?: EditorError;
+    commandState: CommandStateSnapshot;
+    surface?: EditorSurfaceSnapshot;
+}
+interface PersistedEditorSnapshot {
+    snapshotVersion: PersistedEditorSnapshot$1["snapshotVersion"];
+    schemaVersion: PersistedEditorSnapshot$1["schemaVersion"];
+    documentId: string;
+    docId: string;
+    createdAt: string;
+    updatedAt: string;
+    savedAt: string;
+    editorBuild: string;
+    canonicalDocument: PersistedEditorSnapshot$1["canonicalDocument"];
+    compatibility: CompatibilityReport;
+    warningLog: EditorWarning[];
+}
+interface AddCommentParams {
+    anchor?: EditorAnchorProjection;
+    body?: string;
+    authorId?: string;
+}
+interface ExportDocxOptions {
+    fileName?: string;
+    reason?: string;
+}
+interface ExportResult {
+    bytes: Uint8Array;
+    mimeType: string;
+    fileName: string;
+}
+type AutosaveState = {
+    status: "idle";
+} | {
+    status: "saving";
+} | {
+    status: "saved";
+    savedAt: string;
+} | {
+    status: "error";
+    error: EditorError;
+};
+interface AutosaveConfig {
+    enabled?: boolean;
+    debounceMs?: number;
+}
+type WordReviewEditorEvent = {
+    type: "ready";
+    documentId: string;
+    sessionId: string;
+    source: "docx" | "snapshot" | "datastore" | "canonical";
+    stats: DocumentStats;
+    compatibility: CompatibilityReport;
+} | {
+    type: "dirty_changed";
+    documentId: string;
+    isDirty: boolean;
+} | {
+    type: "selection_changed";
+    documentId: string;
+    selection: SelectionSnapshot;
+} | {
+    type: "comment_added";
+    documentId: string;
+    commentId: string;
+    anchor: EditorAnchorProjection;
+} | {
+    type: "comment_resolved";
+    documentId: string;
+    commentId: string;
+} | {
+    type: "change_accepted";
+    documentId: string;
+    changeId: string;
+} | {
+    type: "change_rejected";
+    documentId: string;
+    changeId: string;
+} | {
+    type: "warning_added";
+    documentId: string;
+    warning: EditorWarning;
+} | {
+    type: "warning_cleared";
+    documentId: string;
+    warningId: string;
+    code: EditorWarningCode;
+} | {
+    type: "error";
+    documentId: string;
+    error: EditorError;
+} | {
+    type: "autosave_state";
+    documentId: string;
+    state: AutosaveState;
+} | {
+    type: "snapshot_saved";
+    documentId: string;
+    snapshot: PersistedEditorSnapshot;
+    isAutosave: boolean;
+} | {
+    type: "export_completed";
+    documentId: string;
+    result: ExportResult;
+};
+interface LoadResult {
+    source?: ExternalDocumentSource;
+}
+interface SaveSnapshotParams {
+    documentId: string;
+    snapshot: PersistedEditorSnapshot;
+    isAutosave: boolean;
+}
+interface SaveSnapshotResult {
+    savedAt: string;
+}
+interface SaveExportParams {
+    documentId: string;
+    result: ExportResult;
+}
+interface SaveExportResult {
+    savedAt: string;
+}
+interface EditorTelemetryEvent {
+    type: string;
+    documentId: string;
+    detail?: Record<string, unknown>;
+}
+interface EditorDatastoreAdapter {
+    load(params: {
+        documentId: string;
+    }): Promise<LoadResult>;
+    saveSnapshot(params: SaveSnapshotParams): Promise<SaveSnapshotResult>;
+    saveExport(params: SaveExportParams): Promise<SaveExportResult>;
+    logEvent?(event: EditorTelemetryEvent): void;
+}
+interface WordReviewEditorRef {
+    focus(): void;
+    blur(): void;
+    undo(): void;
+    redo(): void;
+    addComment(params: AddCommentParams): string;
+    openComment(commentId: string): void;
+    resolveComment(commentId: string): void;
+    reopenComment(commentId: string): void;
+    addCommentReply(commentId: string, body: string): void;
+    editCommentBody(commentId: string, body: string): void;
+    acceptChange(changeId: string): void;
+    rejectChange(changeId: string): void;
+    acceptAllChanges(): void;
+    rejectAllChanges(): void;
+    exportDocx(options?: ExportDocxOptions): Promise<ExportResult>;
+    getSnapshot(): PersistedEditorSnapshot;
+    getCompatibilityReport(): CompatibilityReport;
+    getWarnings(): EditorWarning[];
+}
+interface WordReviewEditorProps {
+    documentId: string;
+    currentUser: EditorUser;
+    initialDocx?: Uint8Array | ArrayBuffer;
+    initialSnapshot?: PersistedEditorSnapshot;
+    initialSourceLabel?: string;
+    externalDocumentRevision?: string;
+    externalDocSource?: ExternalDocumentSource;
+    readOnly?: boolean;
+    reviewMode?: "editing" | "review";
+    markupDisplay?: "clean" | "simple" | "all";
+    datastore?: EditorDatastoreAdapter;
+    autosave?: AutosaveConfig;
+    onEvent?: (event: WordReviewEditorEvent) => void;
+    onWarning?: (warning: EditorWarning) => void;
+    onError?: (error: EditorError) => void;
+}
+
+export type { AddCommentParams as A, SurfaceInlineSegment as B, CommandStateSnapshot as C, DocumentStats as D, EditorAnchorProjection as E, SurfaceTableCellSnapshot as F, SurfaceTableRowSnapshot as G, SurfaceTextMark as H, TrackedChangesSnapshot as I, WordReviewEditorEvent as J, LoadResult as L, PersistedEditorSnapshot as P, RuntimeRenderSnapshot as R, SaveExportParams as S, TrackedChangeEntrySnapshot as T, WordReviewEditorProps as W, WordReviewEditorRef as a, AutosaveConfig as b, AutosaveState as c, CommentSidebarSnapshot as d, CommentSidebarThreadEntrySnapshot as e, CommentSidebarThreadSnapshot as f, CompatibilityFeatureClass as g, CompatibilityFeatureEntry as h, CompatibilityPanelSnapshot as i, CompatibilityReport as j, EditorDatastoreAdapter as k, EditorError as l, EditorErrorCode as m, EditorSurfaceSnapshot as n, EditorTelemetryEvent as o, EditorUser as p, EditorWarning as q, EditorWarningCode as r, ExportDocxOptions as s, ExportResult as t, ExternalDocumentSource as u, SaveExportResult as v, SaveSnapshotParams as w, SaveSnapshotResult as x, SelectionSnapshot as y, SurfaceBlockSnapshot as z };