@beyondwork/docx-react-component 1.0.28 → 1.0.29

package/dist/runtime/document-runtime.d.cts

@@ -0,0 +1,231 @@
+import { aG as SelectionSnapshot, aH as CanonicalDocumentEnvelope, aI as TransactionMapping, aJ as EditorWarning, aK as CommentThreadRecord, af as ViewMode, aL as DocumentMode, aA as WorkspaceMode, aB as ZoomLevel, C as CaretAffinity, V as PageRegionHitTest, Q as LayoutMeasurement, E as EditorSessionState, P as PersistedEditorSnapshot, s as EditorError, G as ExportDocxOptions, H as ExportResult, ah as WordReviewEditorEvent, B as EditorWarning$1, aF as ProtectionSnapshot, X as RuntimeRenderSnapshot, q as EditorAnchorProjection, ai as WorkflowBlockedCommandReason, c as AddCommentParams, v as EditorStoryTarget, z as EditorViewStateSnapshot, U as PageLayoutSnapshot, n as DocumentNavigationSnapshot, aM as FieldSnapshot, aN as UpdateFieldsOptions, aO as UpdateFieldsResult, aP as TocRefreshOptions, aQ as TocRefreshResult, m as CompatibilityReport, at as WorkflowOverlay, ay as WorkflowScopeSnapshot, O as InteractionGuardSnapshot, ar as WorkflowMarkupSnapshot, M as HostAnnotationOverlay, N as HostAnnotationSnapshot, ak as WorkflowCandidateRangeOptions, aj as WorkflowCandidateRange } from '../public-types-CeMaDueh.cjs';
+import '../canonical-document-BLEbzL2J.cjs';
+
+interface CommandOrigin {
+    source: "keyboard" | "toolbar" | "context_menu" | "comment_panel" | "review_panel" | "api" | "runtime";
+    timestamp: string;
+}
+type EditorCommand = {
+    type: "selection.set";
+    selection: SelectionSnapshot;
+    origin?: CommandOrigin;
+} | {
+    type: "document.replace";
+    document: CanonicalDocumentEnvelope;
+    mapping?: TransactionMapping;
+    selection?: SelectionSnapshot;
+    protectionSelection?: SelectionSnapshot;
+    origin?: CommandOrigin;
+} | {
+    type: "text.insert";
+    text: string;
+    origin?: CommandOrigin;
+} | {
+    type: "text.delete-backward";
+    origin?: CommandOrigin;
+} | {
+    type: "text.delete-forward";
+    origin?: CommandOrigin;
+} | {
+    type: "text.insert-tab";
+    origin?: CommandOrigin;
+} | {
+    type: "text.insert-hard-break";
+    origin?: CommandOrigin;
+} | {
+    type: "paragraph.split";
+    origin?: CommandOrigin;
+} | {
+    type: "runtime.set-read-only";
+    readOnly: boolean;
+    origin?: CommandOrigin;
+} | {
+    type: "runtime.focus";
+    focused: boolean;
+    origin?: CommandOrigin;
+} | {
+    type: "warning.add";
+    warning: EditorWarning;
+    origin?: CommandOrigin;
+} | {
+    type: "warning.clear";
+    warningId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.add";
+    comment: CommentThreadRecord;
+    selection?: SelectionSnapshot;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.open";
+    commentId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.resolve";
+    commentId: string;
+    resolvedBy?: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.reopen";
+    commentId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.add-reply";
+    commentId: string;
+    body: string;
+    authorId?: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.edit-body";
+    commentId: string;
+    body: string;
+    origin?: CommandOrigin;
+} | {
+    type: "change.accept";
+    changeId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "change.reject";
+    changeId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "change.accept-all";
+    origin?: CommandOrigin;
+} | {
+    type: "change.reject-all";
+    origin?: CommandOrigin;
+} | {
+    type: "history.undo";
+    origin?: CommandOrigin;
+} | {
+    type: "history.redo";
+    origin?: CommandOrigin;
+};
+
+/**
+ * Runtime-owned view state — non-canonical interaction model.
+ *
+ * This module owns the editor's interaction and measurement state that is
+ * separate from the canonical document model. View state is never serialized
+ * into persisted snapshots or exported DOCX; it exists only while the editor
+ * session is live.
+ *
+ * Design boundaries:
+ * - Canonical document state lives in EditorState / CanonicalDocumentEnvelope.
+ * - View state is runtime-owned, non-canonical, non-exported.
+ * - Builds on Wave 35's activeStory and PageLayoutSnapshot model.
+ * - Runtime viewMode models editor posture ("editing" | "review" | "view").
+ * - Workspace mode and zoom are runtime-owned so hosts and the mounted shell
+ *   share one view-state contract.
+ */
+
+interface ViewState {
+    viewMode: ViewMode;
+    documentMode: DocumentMode;
+    workspaceMode: WorkspaceMode;
+    zoomLevel: ZoomLevel;
+    isFocused: boolean;
+    caretAffinity: CaretAffinity;
+    activePageRegion: PageRegionHitTest | null;
+    activeObjectFrame: LayoutMeasurement["objectFrame"] | null;
+}
+
+type Unsubscribe = () => void;
+type RuntimeReadySource = "docx" | "session" | "snapshot" | "datastore" | "canonical";
+type DocumentRuntimeEvent = (Omit<Extract<WordReviewEditorEvent, {
+    type: "ready";
+}>, "source"> & {
+    source: RuntimeReadySource;
+}) | Exclude<WordReviewEditorEvent, {
+    type: "ready";
+}>;
+type ActiveStoryTextCommand = Extract<EditorCommand, {
+    type: "text.insert";
+}> | Extract<EditorCommand, {
+    type: "text.delete-backward";
+}> | Extract<EditorCommand, {
+    type: "text.delete-forward";
+}> | Extract<EditorCommand, {
+    type: "text.insert-tab";
+}> | Extract<EditorCommand, {
+    type: "text.insert-hard-break";
+}> | Extract<EditorCommand, {
+    type: "paragraph.split";
+}>;
+interface DocumentRuntime {
+    subscribe(listener: () => void): Unsubscribe;
+    subscribeToEvents(listener: (event: DocumentRuntimeEvent) => void): Unsubscribe;
+    getRenderSnapshot(): RuntimeRenderSnapshot;
+    getCanonicalDocument(): CanonicalDocumentEnvelope;
+    getSourcePackage(): EditorSessionState["sourcePackage"] | undefined;
+    replaceText(text: string, target?: EditorAnchorProjection): void;
+    applyActiveStoryTextCommand(command: ActiveStoryTextCommand): void;
+    dispatch(command: EditorCommand): void;
+    emitBlockedCommand(command: string, reasons: WorkflowBlockedCommandReason[]): void;
+    undo(): void;
+    redo(): void;
+    focus(): void;
+    blur(): void;
+    setDefaultAuthorId?(authorId?: string): void;
+    addComment(params: AddCommentParams): string;
+    openComment(commentId: string): void;
+    resolveComment(commentId: string): void;
+    reopenComment(commentId: string): void;
+    addCommentReply(commentId: string, body: string, authorId?: string): void;
+    editCommentBody(commentId: string, body: string): void;
+    acceptChange(changeId: string): void;
+    rejectChange(changeId: string): void;
+    acceptAllChanges(): void;
+    rejectAllChanges(): void;
+    openStory(target: EditorStoryTarget): boolean;
+    closeStory(): void;
+    getActiveStory(): EditorStoryTarget;
+    getViewState(): EditorViewStateSnapshot;
+    setViewMode(mode: ViewMode): void;
+    setDocumentMode(mode: DocumentMode): void;
+    getProtectionSnapshot(): ProtectionSnapshot;
+    setWorkspaceMode(mode: WorkspaceMode): void;
+    setZoom(level: ZoomLevel): void;
+    getPageLayoutSnapshot(): PageLayoutSnapshot | null;
+    getDocumentNavigationSnapshot(): DocumentNavigationSnapshot;
+    getFieldSnapshot(): FieldSnapshot;
+    updateFields(options?: UpdateFieldsOptions): UpdateFieldsResult;
+    updateTableOfContents(options?: TocRefreshOptions): TocRefreshResult;
+    getSessionState(): EditorSessionState;
+    getPersistedSnapshot(): PersistedEditorSnapshot;
+    getCompatibilityReport(): CompatibilityReport;
+    getWarnings(): EditorWarning$1[];
+    exportDocx(options?: ExportDocxOptions): Promise<ExportResult>;
+    setWorkflowOverlay(overlay: WorkflowOverlay): void;
+    clearWorkflowOverlay(): void;
+    getWorkflowScopeSnapshot(): WorkflowScopeSnapshot | null;
+    getInteractionGuardSnapshot(): InteractionGuardSnapshot;
+    getWorkflowMarkupSnapshot(): WorkflowMarkupSnapshot;
+    setHostAnnotationOverlay(overlay: HostAnnotationOverlay): void;
+    clearHostAnnotationOverlay(): void;
+    getHostAnnotationSnapshot(): HostAnnotationSnapshot;
+    getWorkflowCandidateRanges(options?: WorkflowCandidateRangeOptions): WorkflowCandidateRange[];
+    replaceWorkflowMarkupText(markupId: string, text: string): void;
+}
+interface CreateDocumentRuntimeOptions {
+    documentId: string;
+    initialSessionState?: EditorSessionState;
+    initialSnapshot?: PersistedEditorSnapshot;
+    initialCanonicalDocument?: CanonicalDocumentEnvelope;
+    sourceLabel?: string;
+    sourceKind?: RuntimeReadySource;
+    readOnly?: boolean;
+    editorBuild?: string;
+    defaultAuthorId?: string;
+    fatalError?: EditorError;
+    clock?: () => string;
+    exportDocx?: (sessionState: EditorSessionState, options?: ExportDocxOptions) => Promise<ExportResult>;
+    onEvent?: (event: DocumentRuntimeEvent) => void;
+    onWarning?: (warning: EditorWarning$1) => void;
+    onError?: (error: EditorError) => void;
+    initialViewState?: Partial<ViewState>;
+    protectionSnapshot?: ProtectionSnapshot;
+}
+declare function createDocumentRuntime(options: CreateDocumentRuntimeOptions): DocumentRuntime;
+
+export { type ActiveStoryTextCommand, type CreateDocumentRuntimeOptions, type DocumentRuntime, type DocumentRuntimeEvent, type Unsubscribe, createDocumentRuntime };

package/dist/runtime/document-runtime.d.ts

@@ -0,0 +1,231 @@
+import { aG as SelectionSnapshot, aH as CanonicalDocumentEnvelope, aI as TransactionMapping, aJ as EditorWarning, aK as CommentThreadRecord, af as ViewMode, aL as DocumentMode, aA as WorkspaceMode, aB as ZoomLevel, C as CaretAffinity, V as PageRegionHitTest, Q as LayoutMeasurement, E as EditorSessionState, P as PersistedEditorSnapshot, s as EditorError, G as ExportDocxOptions, H as ExportResult, ah as WordReviewEditorEvent, B as EditorWarning$1, aF as ProtectionSnapshot, X as RuntimeRenderSnapshot, q as EditorAnchorProjection, ai as WorkflowBlockedCommandReason, c as AddCommentParams, v as EditorStoryTarget, z as EditorViewStateSnapshot, U as PageLayoutSnapshot, n as DocumentNavigationSnapshot, aM as FieldSnapshot, aN as UpdateFieldsOptions, aO as UpdateFieldsResult, aP as TocRefreshOptions, aQ as TocRefreshResult, m as CompatibilityReport, at as WorkflowOverlay, ay as WorkflowScopeSnapshot, O as InteractionGuardSnapshot, ar as WorkflowMarkupSnapshot, M as HostAnnotationOverlay, N as HostAnnotationSnapshot, ak as WorkflowCandidateRangeOptions, aj as WorkflowCandidateRange } from '../public-types-7ZL_94cz.js';
+import '../canonical-document-BLEbzL2J.js';
+
+interface CommandOrigin {
+    source: "keyboard" | "toolbar" | "context_menu" | "comment_panel" | "review_panel" | "api" | "runtime";
+    timestamp: string;
+}
+type EditorCommand = {
+    type: "selection.set";
+    selection: SelectionSnapshot;
+    origin?: CommandOrigin;
+} | {
+    type: "document.replace";
+    document: CanonicalDocumentEnvelope;
+    mapping?: TransactionMapping;
+    selection?: SelectionSnapshot;
+    protectionSelection?: SelectionSnapshot;
+    origin?: CommandOrigin;
+} | {
+    type: "text.insert";
+    text: string;
+    origin?: CommandOrigin;
+} | {
+    type: "text.delete-backward";
+    origin?: CommandOrigin;
+} | {
+    type: "text.delete-forward";
+    origin?: CommandOrigin;
+} | {
+    type: "text.insert-tab";
+    origin?: CommandOrigin;
+} | {
+    type: "text.insert-hard-break";
+    origin?: CommandOrigin;
+} | {
+    type: "paragraph.split";
+    origin?: CommandOrigin;
+} | {
+    type: "runtime.set-read-only";
+    readOnly: boolean;
+    origin?: CommandOrigin;
+} | {
+    type: "runtime.focus";
+    focused: boolean;
+    origin?: CommandOrigin;
+} | {
+    type: "warning.add";
+    warning: EditorWarning;
+    origin?: CommandOrigin;
+} | {
+    type: "warning.clear";
+    warningId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.add";
+    comment: CommentThreadRecord;
+    selection?: SelectionSnapshot;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.open";
+    commentId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.resolve";
+    commentId: string;
+    resolvedBy?: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.reopen";
+    commentId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.add-reply";
+    commentId: string;
+    body: string;
+    authorId?: string;
+    origin?: CommandOrigin;
+} | {
+    type: "comment.edit-body";
+    commentId: string;
+    body: string;
+    origin?: CommandOrigin;
+} | {
+    type: "change.accept";
+    changeId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "change.reject";
+    changeId: string;
+    origin?: CommandOrigin;
+} | {
+    type: "change.accept-all";
+    origin?: CommandOrigin;
+} | {
+    type: "change.reject-all";
+    origin?: CommandOrigin;
+} | {
+    type: "history.undo";
+    origin?: CommandOrigin;
+} | {
+    type: "history.redo";
+    origin?: CommandOrigin;
+};
+
+/**
+ * Runtime-owned view state — non-canonical interaction model.
+ *
+ * This module owns the editor's interaction and measurement state that is
+ * separate from the canonical document model. View state is never serialized
+ * into persisted snapshots or exported DOCX; it exists only while the editor
+ * session is live.
+ *
+ * Design boundaries:
+ * - Canonical document state lives in EditorState / CanonicalDocumentEnvelope.
+ * - View state is runtime-owned, non-canonical, non-exported.
+ * - Builds on Wave 35's activeStory and PageLayoutSnapshot model.
+ * - Runtime viewMode models editor posture ("editing" | "review" | "view").
+ * - Workspace mode and zoom are runtime-owned so hosts and the mounted shell
+ *   share one view-state contract.
+ */
+
+interface ViewState {
+    viewMode: ViewMode;
+    documentMode: DocumentMode;
+    workspaceMode: WorkspaceMode;
+    zoomLevel: ZoomLevel;
+    isFocused: boolean;
+    caretAffinity: CaretAffinity;
+    activePageRegion: PageRegionHitTest | null;
+    activeObjectFrame: LayoutMeasurement["objectFrame"] | null;
+}
+
+type Unsubscribe = () => void;
+type RuntimeReadySource = "docx" | "session" | "snapshot" | "datastore" | "canonical";
+type DocumentRuntimeEvent = (Omit<Extract<WordReviewEditorEvent, {
+    type: "ready";
+}>, "source"> & {
+    source: RuntimeReadySource;
+}) | Exclude<WordReviewEditorEvent, {
+    type: "ready";
+}>;
+type ActiveStoryTextCommand = Extract<EditorCommand, {
+    type: "text.insert";
+}> | Extract<EditorCommand, {
+    type: "text.delete-backward";
+}> | Extract<EditorCommand, {
+    type: "text.delete-forward";
+}> | Extract<EditorCommand, {
+    type: "text.insert-tab";
+}> | Extract<EditorCommand, {
+    type: "text.insert-hard-break";
+}> | Extract<EditorCommand, {
+    type: "paragraph.split";
+}>;
+interface DocumentRuntime {
+    subscribe(listener: () => void): Unsubscribe;
+    subscribeToEvents(listener: (event: DocumentRuntimeEvent) => void): Unsubscribe;
+    getRenderSnapshot(): RuntimeRenderSnapshot;
+    getCanonicalDocument(): CanonicalDocumentEnvelope;
+    getSourcePackage(): EditorSessionState["sourcePackage"] | undefined;
+    replaceText(text: string, target?: EditorAnchorProjection): void;
+    applyActiveStoryTextCommand(command: ActiveStoryTextCommand): void;
+    dispatch(command: EditorCommand): void;
+    emitBlockedCommand(command: string, reasons: WorkflowBlockedCommandReason[]): void;
+    undo(): void;
+    redo(): void;
+    focus(): void;
+    blur(): void;
+    setDefaultAuthorId?(authorId?: string): void;
+    addComment(params: AddCommentParams): string;
+    openComment(commentId: string): void;
+    resolveComment(commentId: string): void;
+    reopenComment(commentId: string): void;
+    addCommentReply(commentId: string, body: string, authorId?: string): void;
+    editCommentBody(commentId: string, body: string): void;
+    acceptChange(changeId: string): void;
+    rejectChange(changeId: string): void;
+    acceptAllChanges(): void;
+    rejectAllChanges(): void;
+    openStory(target: EditorStoryTarget): boolean;
+    closeStory(): void;
+    getActiveStory(): EditorStoryTarget;
+    getViewState(): EditorViewStateSnapshot;
+    setViewMode(mode: ViewMode): void;
+    setDocumentMode(mode: DocumentMode): void;
+    getProtectionSnapshot(): ProtectionSnapshot;
+    setWorkspaceMode(mode: WorkspaceMode): void;
+    setZoom(level: ZoomLevel): void;
+    getPageLayoutSnapshot(): PageLayoutSnapshot | null;
+    getDocumentNavigationSnapshot(): DocumentNavigationSnapshot;
+    getFieldSnapshot(): FieldSnapshot;
+    updateFields(options?: UpdateFieldsOptions): UpdateFieldsResult;
+    updateTableOfContents(options?: TocRefreshOptions): TocRefreshResult;
+    getSessionState(): EditorSessionState;
+    getPersistedSnapshot(): PersistedEditorSnapshot;
+    getCompatibilityReport(): CompatibilityReport;
+    getWarnings(): EditorWarning$1[];
+    exportDocx(options?: ExportDocxOptions): Promise<ExportResult>;
+    setWorkflowOverlay(overlay: WorkflowOverlay): void;
+    clearWorkflowOverlay(): void;
+    getWorkflowScopeSnapshot(): WorkflowScopeSnapshot | null;
+    getInteractionGuardSnapshot(): InteractionGuardSnapshot;
+    getWorkflowMarkupSnapshot(): WorkflowMarkupSnapshot;
+    setHostAnnotationOverlay(overlay: HostAnnotationOverlay): void;
+    clearHostAnnotationOverlay(): void;
+    getHostAnnotationSnapshot(): HostAnnotationSnapshot;
+    getWorkflowCandidateRanges(options?: WorkflowCandidateRangeOptions): WorkflowCandidateRange[];
+    replaceWorkflowMarkupText(markupId: string, text: string): void;
+}
+interface CreateDocumentRuntimeOptions {
+    documentId: string;
+    initialSessionState?: EditorSessionState;
+    initialSnapshot?: PersistedEditorSnapshot;
+    initialCanonicalDocument?: CanonicalDocumentEnvelope;
+    sourceLabel?: string;
+    sourceKind?: RuntimeReadySource;
+    readOnly?: boolean;
+    editorBuild?: string;
+    defaultAuthorId?: string;
+    fatalError?: EditorError;
+    clock?: () => string;
+    exportDocx?: (sessionState: EditorSessionState, options?: ExportDocxOptions) => Promise<ExportResult>;
+    onEvent?: (event: DocumentRuntimeEvent) => void;
+    onWarning?: (warning: EditorWarning$1) => void;
+    onError?: (error: EditorError) => void;
+    initialViewState?: Partial<ViewState>;
+    protectionSnapshot?: ProtectionSnapshot;
+}
+declare function createDocumentRuntime(options: CreateDocumentRuntimeOptions): DocumentRuntime;
+
+export { type ActiveStoryTextCommand, type CreateDocumentRuntimeOptions, type DocumentRuntime, type DocumentRuntimeEvent, type Unsubscribe, createDocumentRuntime };

package/dist/runtime/document-runtime.js

@@ -0,0 +1,21 @@
+import {
+  createDocumentRuntime
+} from "../chunk-KD2QRQPY.js";
+import "../chunk-UZXBISGO.js";
+import "../chunk-QDAQ4CJU.js";
+import "../chunk-CN3XMECL.js";
+import "../chunk-KZUG5KFQ.js";
+import "../chunk-GBVOWFIK.js";
+import "../chunk-KLMXQVYK.js";
+import "../chunk-EILUG3VB.js";
+import "../chunk-2FJS5GZM.js";
+import "../chunk-2S7W4KFO.js";
+import "../chunk-SWKWQZXM.js";
+import "../chunk-5FN54NDH.js";
+import "../chunk-EBI3BX6U.js";
+import "../chunk-RMH72RZI.js";
+import "../chunk-TLCEAQDQ.js";
+export {
+  createDocumentRuntime
+};
+//# sourceMappingURL=document-runtime.js.map

package/dist/runtime/document-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/structural-helpers-CilgOVhh.d.cts

@@ -0,0 +1,10 @@
+import { aH as CanonicalDocumentEnvelope, aG as SelectionSnapshot, aI as TransactionMapping } from './public-types-CeMaDueh.cjs';
+
+interface StructuralMutationResult {
+    changed: boolean;
+    document: CanonicalDocumentEnvelope;
+    selection: SelectionSnapshot;
+    mapping?: TransactionMapping;
+}
+
+export type { StructuralMutationResult as S };

package/dist/structural-helpers-q0Gd-eBN.d.ts

@@ -0,0 +1,10 @@
+import { aH as CanonicalDocumentEnvelope, aG as SelectionSnapshot, aI as TransactionMapping } from './public-types-7ZL_94cz.js';
+
+interface StructuralMutationResult {
+    changed: boolean;
+    document: CanonicalDocumentEnvelope;
+    selection: SelectionSnapshot;
+    mapping?: TransactionMapping;
+}
+
+export type { StructuralMutationResult as S };