@beyondwork/docx-react-component 1.0.29 → 1.0.30

package/src/ui/browser-export.ts

@@ -0,0 +1,52 @@
+import type { ExportDelivery, ExportResult } from "../api/public-types";
+
+export function withExportDelivery(
+  result: ExportResult,
+  delivery: ExportDelivery,
+): ExportResult {
+  return {
+    ...result,
+    delivery,
+  };
+}
+
+export function downloadExportResult(result: ExportResult): ExportResult {
+  const delivery = canDownloadInBrowser()
+    ? triggerBrowserDownload(result)
+    : {
+        mode: "exported-bytes-only" as const,
+      };
+  return withExportDelivery(result, delivery);
+}
+
+function canDownloadInBrowser(): boolean {
+  return (
+    typeof window !== "undefined" &&
+    typeof document !== "undefined" &&
+    typeof URL !== "undefined" &&
+    typeof URL.createObjectURL === "function" &&
+    typeof URL.revokeObjectURL === "function" &&
+    typeof Blob !== "undefined"
+  );
+}
+
+function triggerBrowserDownload(result: ExportResult): ExportDelivery {
+  const blob = new Blob([Uint8Array.from(result.bytes)], { type: result.mimeType });
+  const objectUrl = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = objectUrl;
+  link.download = result.fileName;
+  link.rel = "noopener";
+  link.style.display = "none";
+  document.body?.appendChild(link);
+  try {
+    link.click();
+  } finally {
+    link.remove();
+    URL.revokeObjectURL(objectUrl);
+  }
+
+  return {
+    mode: "downloaded",
+  };
+}

package/src/ui/comments/README.md

@@ -0,0 +1,3 @@
+# Comments UI
+
+Comment markers, thread navigation, and sidebar thread views belong here.

package/src/ui/compatibility/README.md

@@ -0,0 +1,3 @@
+# Compatibility UI
+
+Compatibility reports, preserve-only warnings, and unsupported-content summaries belong here.

package/src/ui/editor-command-bag.ts

@@ -0,0 +1,127 @@
+import { useMemo, useRef } from "react";
+
+import type {
+  CommentSidebarThreadSnapshot,
+  FormattingAlignment,
+  HeaderFooterLinkPatch,
+  InsertImageOptions,
+  SectionBreakType,
+  SectionLayoutPatch,
+  SectionPageNumberingPatch,
+  TrackedChangeEntrySnapshot,
+  ZoomLevel,
+  WorkspaceMode,
+} from "../api/public-types.ts";
+import type { ReviewRailTab } from "../ui-tailwind/review/tw-review-rail.tsx";
+
+type CommandHandler = (...args: any[]) => unknown;
+
+export interface EditorCommandBag {
+  onWorkspaceModeChange(value: WorkspaceMode): void;
+  onZoomChange?(level: ZoomLevel): void;
+  onActiveRailTabChange(value: ReviewRailTab): void;
+  onShowTrackedChangesChange(show: boolean): void;
+  onUndo(): void;
+  onRedo(): void;
+  onSetParagraphStyle?(styleId: string): void;
+  onToggleBold?(): void;
+  onToggleItalic?(): void;
+  onToggleUnderline?(): void;
+  onSetSelectionTextColor?(color: string): void;
+  onSetSelectionHighlightColor?(color: string | null): void;
+  onToggleStrikethrough?(): void;
+  onToggleSuperscript?(): void;
+  onToggleSubscript?(): void;
+  onSetFontFamily?(fontFamily: string): void;
+  onSetFontSize?(fontSize: number): void;
+  onSetTextColor?(color: string): void;
+  onSetHighlightColor?(color: string | null): void;
+  onSetAlignment?(alignment: FormattingAlignment): void;
+  onToggleBulletedList?(): void;
+  onToggleNumberedList?(): void;
+  onOutdent?(): void;
+  onIndent?(): void;
+  onAddComment(): void;
+  onInsertPageBreak?(): void;
+  onInsertTable?(): void;
+  onInsertSectionBreak?(type: SectionBreakType): void;
+  onInsertImage?(options: InsertImageOptions): void;
+  onSetTableStyle?(styleId: string): void;
+  onAddRowBefore?(): void;
+  onAddRowAfter?(): void;
+  onAddColumnBefore?(): void;
+  onAddColumnAfter?(): void;
+  onDeleteRow?(): void;
+  onDeleteColumn?(): void;
+  onDeleteTable?(): void;
+  onMergeCells?(): void;
+  onSplitCell?(): void;
+  onSetCellBackground?(color: string): void;
+  onSetImageLayout?(
+    mediaId: string,
+    dimensions: { widthEmu: number; heightEmu: number },
+  ): void;
+  onSetImageFrame?(
+    mediaId: string,
+    offsets: { horizontalOffsetEmu?: number; verticalOffsetEmu?: number },
+  ): void;
+  onDeleteSectionBreak?(sectionIndex: number): void;
+  onUpdateSectionLayout?(sectionIndex: number, patch: SectionLayoutPatch): void;
+  onSetSectionPageNumbering?(
+    sectionIndex: number,
+    patch: SectionPageNumberingPatch | null,
+  ): void;
+  onSetHeaderFooterLink?(
+    sectionIndex: number,
+    patch: HeaderFooterLinkPatch,
+  ): 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;
+  onCloseStory?(): void;
+  onOpenHeaderStory?(): void;
+  onOpenFooterStory?(): void;
+  onSetParagraphIndentation?(indentation: {
+    left?: number;
+    right?: number;
+    firstLine?: number;
+    hanging?: number;
+  }): void;
+  onSetParagraphTabStops?(
+    tabStops: Array<{ pos: number; val?: string; leader?: string }>,
+  ): void;
+  onRestartNumbering?(): void;
+  onContinueNumbering?(): void;
+  onUpdateFields?(): void;
+  onUpdateTableOfContents?(): void;
+  onGoToPreviousReviewItem?(): void;
+  onGoToNextReviewItem?(): void;
+  onMarkSectionForReview?(): string | null;
+  onNavigateHeading?(headingId: string): void;
+}
+
+export function useCommandBag<T extends object>(commands: T): T {
+  const commandsRef = useRef(commands);
+  commandsRef.current = commands;
+
+  return useMemo(() => {
+    const stableBag: Partial<T> = {};
+
+    for (const key of Object.keys(commands) as Array<keyof T>) {
+      stableBag[key] = ((...args: unknown[]) => {
+        const handler = commandsRef.current[key] as CommandHandler | undefined;
+        return handler?.(...args);
+      }) as T[typeof key];
+    }
+
+    return stableBag as T;
+  }, []);
+}