@beyondwork/docx-react-component 1.0.81 → 1.0.82

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.81",
+  "version": "1.0.82",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
   "type": "module",
   "sideEffects": [

package/src/api/public-types.ts

@@ -5614,7 +5614,8 @@ export interface WordReviewEditorProps {
    * Optional host-callback extension bag for workspace command chrome.
    * The default `<WordReviewEditor />` path now mounts
    * `TwWorkspaceChromeHost` with product-backed commands for formatting,
-   * paragraph/list actions, comments, and table insertion/structure.
+   * paragraph/list/style/font/color actions, search/navigation host
+   * delegation, comments, and table insertion/structure.
    * Supplying this bag overrides or extends those defaults for host-owned
    * actions such as custom table properties, hyperlink handling, or
    * object metadata. Actions without a wired callback are hidden from

package/src/api/v3/_runtime-handle.ts

@@ -43,6 +43,7 @@ export type RuntimeApiHandle = Pick<
   DocumentRuntime,
   // Session + export (runtime.document family)
   | "getSessionState"
+  | "setDocumentMode"
   | "exportDocx"
   | "getCompatibilityReport"
   | "getWarnings"
@@ -54,6 +55,7 @@ export type RuntimeApiHandle = Pick<
   | "findAllText"
   // Review (runtime.review family)
   | "getReviewWorkSnapshot"
+  | "getSuggestionsSnapshot"
   | "acceptChange"
   | "rejectChange"
   | "resolveComment"
@@ -136,6 +138,7 @@ export type RuntimeApiHandle = Pick<
  */
 export const RUNTIME_API_HANDLE_SHAPE_CHECK: Record<keyof RuntimeApiHandle, true> = {
   getSessionState: true,
+  setDocumentMode: true,
   exportDocx: true,
   getCompatibilityReport: true,
   getWarnings: true,
@@ -143,6 +146,7 @@ export const RUNTIME_API_HANDLE_SHAPE_CHECK: Record<keyof RuntimeApiHandle, true
   getCanonicalDocument: true,
   findAllText: true,
   getReviewWorkSnapshot: true,
+  getSuggestionsSnapshot: true,
   acceptChange: true,
   rejectChange: true,
   resolveComment: true,

package/src/api/v3/runtime/document.ts

@@ -1,14 +1,16 @@
 /**
  * @endStateApi v3 — `runtime.document` family.
  *
- * See docs/reference/public-api.md § runtime.document. Three functions:
+ * See docs/reference/public-api.md § runtime.document.
  * `load` (partial — runtime pre-load is the caller's responsibility; v3
- * exposes a re-mount semantic later), `export` (live; delegates to
- * `runtime.exportDocx`), `validate` (partial; read live, write mock).
+ * exposes a re-mount semantic later), `getMode` / `setMode` (live;
+ * delegates to the runtime view-state posture), `export` (live; delegates
+ * to `runtime.exportDocx`), `validate` (partial; read live, write mock).
  */
 
 import type { RuntimeApiHandle } from "../_runtime-handle.ts";
 import type {
+  DocumentMode,
   EditorError,
   ExportDocxOptions,
   ExportResult,
@@ -88,6 +90,42 @@ export const loadMetadata: ApiV3FnMetadata = {
     "§Runtime API § runtime.document.load. Graduation (2026-04-22, post-eb7d14fa): `live` via direct delegation to `loadDocxSessionAsync` (src/session/import/loader.ts). Returns a PersistedEditorSnapshot the caller can pass to DocxSession.reopenFromSnapshot or persist for later rehydrate. Note per arch §R8 Option B: v3 does NOT construct the receiving DocumentRuntime — that's the caller's job via createDocumentRuntime(initialSessionState).",
 };
 
+/* ================================================================== */
+/*  mode                                                              */
+/* ================================================================== */
+
+export const getModeMetadata: ApiV3FnMetadata = {
+  name: "runtime.document.getMode",
+  status: "live",
+  sourceLayer: "runtime-core",
+  liveEvidence: {
+    runnerTest: "test/api/v3/create-accepts-handle.test.ts",
+    commit: "refactor-03-tracked-changes-v1-api-adapter",
+  },
+  uxIntent: { uiVisible: false, expectsUxResponse: "none" },
+  agentMetadata: { readOrMutate: "read", boundedScope: "document", auditCategory: "document-mode" },
+  stateClass: "C-local",
+  persistsTo: "none",
+  rwdReference:
+    "§Runtime API § runtime.document.getMode. Live adapter over the runtime render snapshot's DocumentMode; suggesting remains the tracked-change authoring posture.",
+};
+
+export const setModeMetadata: ApiV3FnMetadata = {
+  name: "runtime.document.setMode",
+  status: "live",
+  sourceLayer: "runtime-core",
+  liveEvidence: {
+    runnerTest: "test/api/v3/create-accepts-handle.test.ts",
+    commit: "refactor-03-tracked-changes-v1-api-adapter",
+  },
+  uxIntent: { uiVisible: true, expectsUxResponse: "surface-refresh", expectedDelta: "document mode changes" },
+  agentMetadata: { readOrMutate: "mutate", boundedScope: "document", auditCategory: "document-mode" },
+  stateClass: "C-local",
+  persistsTo: "none",
+  rwdReference:
+    "§Runtime API § runtime.document.setMode. Live adapter over runtime.setDocumentMode(); mode 'suggesting' is the v3 entry to tracked-change authoring.",
+};
+
 /* ================================================================== */
 /*  export                                                            */
 /* ================================================================== */
@@ -196,6 +234,26 @@ export function createDocumentFamily(runtime: RuntimeApiHandle) {
       return result;
     },
 
+    getMode(): DocumentMode {
+      // @endStateApi — live. Reads the runtime view-state posture that
+      // render snapshots already expose.
+      return runtime.getRenderSnapshot().documentMode;
+    },
+
+    setMode(mode: DocumentMode): void {
+      // @endStateApi — live. Delegates to the runtime's document-mode
+      // setter; `suggesting` is the tracked-change authoring posture.
+      runtime.setDocumentMode(mode);
+      emitUxResponse(runtime, {
+        apiFn: setModeMetadata.name,
+        intent: setModeMetadata.uxIntent.expectedDelta ?? "",
+        mockOrLive: "live",
+        uiVisible: true,
+        expectedDelta: setModeMetadata.uxIntent.expectedDelta,
+        actualDelta: { kind: "surface-refresh", payload: { mode } },
+      });
+    },
+
     async export(options?: ExportDocxOptions): Promise<ExportResult> {
       // @endStateApi — live. Delegates to the shipped runtime export path.
       const result = await runtime.exportDocx(options);

package/src/api/v3/runtime/review.ts

@@ -1,14 +1,15 @@
 /**
  * @endStateApi v3 — `runtime.review` family.
  *
- * getComments (live) / getChanges (live) / acceptChange (live) /
- * resolveComment (live).
+ * getComments (live) / getChanges (live) / getSuggestions (live) /
+ * acceptChange (live) / rejectChange (live) / resolveComment (live).
  */
 
 import type { RuntimeApiHandle } from "../_runtime-handle.ts";
 import type { ApiV3FnMetadata } from "../_layer-metadata.ts";
 import type {
   CommentSidebarThreadSnapshot,
+  SuggestionsSnapshot,
   TrackedChangeEntrySnapshot,
 } from "../../public-types.ts";
 import { emitUxResponse } from "../_ux-response.ts";
@@ -51,6 +52,22 @@ export const getChangesMetadata: ApiV3FnMetadata = {
   rwdReference: "§Runtime API § runtime.review.getChanges",
 };
 
+export const getSuggestionsMetadata: ApiV3FnMetadata = {
+  name: "runtime.review.getSuggestions",
+  status: "live",
+  sourceLayer: "workflow-review",
+  liveEvidence: {
+    runnerTest: "test/api/v3/create-accepts-handle.test.ts",
+    commit: "refactor-03-tracked-changes-v1-api-adapter",
+  },
+  uxIntent: { uiVisible: false, expectsUxResponse: "none" },
+  agentMetadata: { readOrMutate: "read", boundedScope: "document", auditCategory: "review-read" },
+  stateClass: "A-canonical",
+  persistsTo: "canonical",
+  rwdReference:
+    "§Runtime API § runtime.review.getSuggestions. Live adapter over runtime.getSuggestionsSnapshot(); semantic suggestion readback is grouped by the runtime, not by v3.",
+};
+
 export const acceptChangeMetadata: ApiV3FnMetadata = {
   name: "runtime.review.acceptChange",
   status: "live",
@@ -70,6 +87,23 @@ export const acceptChangeMetadata: ApiV3FnMetadata = {
   rwdReference: "§Runtime API § runtime.review.acceptChange",
 };
 
+export const rejectChangeMetadata: ApiV3FnMetadata = {
+  name: "runtime.review.rejectChange",
+  status: "live",
+  sourceLayer: "workflow-review",
+  liveEvidence: {
+    runnerTest: "test/api/v3/create-accepts-handle.test.ts",
+    commit: "refactor-03-tracked-changes-v1-api-adapter",
+  },
+  uxIntent: { uiVisible: true, expectsUxResponse: "inline-change", expectedDelta: "change mark disappears and text restores" },
+  agentMetadata: { readOrMutate: "mutate", boundedScope: "scope", auditCategory: "change-reject" },
+  stateClass: "A-canonical",
+  persistsTo: "canonical",
+  broadcastsVia: "crdt",
+  rwdReference:
+    "§Runtime API § runtime.review.rejectChange. Live adapter over runtime.rejectChange; mirrors acceptChange for individual tracked-change review.",
+};
+
 export const resolveCommentMetadata: ApiV3FnMetadata = {
   name: "runtime.review.resolveComment",
   status: "live",
@@ -100,6 +134,12 @@ export function createReviewFamily(runtime: RuntimeApiHandle) {
       return runtime.getRenderSnapshot().trackedChanges.revisions;
     },
 
+    getSuggestions(): SuggestionsSnapshot {
+      // @endStateApi — live. Delegates to the runtime's semantic
+      // suggestion grouping rather than regrouping raw revisions here.
+      return runtime.getSuggestionsSnapshot();
+    },
+
     acceptChange(changeId: string): void {
       // @endStateApi — live. Delegates.
       runtime.acceptChange(changeId);
@@ -113,6 +153,19 @@ export function createReviewFamily(runtime: RuntimeApiHandle) {
       });
     },
 
+    rejectChange(changeId: string): void {
+      // @endStateApi — live. Delegates.
+      runtime.rejectChange(changeId);
+      emitUxResponse(runtime, {
+        apiFn: rejectChangeMetadata.name,
+        intent: rejectChangeMetadata.uxIntent.expectedDelta ?? "",
+        mockOrLive: "live",
+        uiVisible: true,
+        expectedDelta: rejectChangeMetadata.uxIntent.expectedDelta,
+        actualDelta: { kind: "inline-change", payload: { changeId } },
+      });
+    },
+
     resolveComment(commentId: string): void {
       // @endStateApi — live.
       runtime.resolveComment(commentId);

package/src/io/normalize/normalize-text.ts

@@ -671,7 +671,10 @@ function normalizeDrawingFrameNode(
     const filename = packagePartName.slice(packagePartName.lastIndexOf("/") + 1) || "image.bin";
     state.media.items[node.content.mediaId] = {
       mediaId: node.content.mediaId,
-      contentType: existingMediaItem?.contentType ?? "application/octet-stream",
+      contentType:
+        node.content.contentType ??
+        existingMediaItem?.contentType ??
+        "application/octet-stream",
       filename,
       packagePartName,
       relationshipId: node.content.blipRef,

package/src/io/ooxml/parse-drawing.ts

@@ -188,8 +188,12 @@ function resolveContent(
           const partPath = normalizePartPath(
             resolveRelationshipTarget(opts.sourcePartPath ?? "/word/document.xml", rel),
           );
+          const mediaPart = opts.mediaParts?.get(partPath);
           pic.packagePartName = partPath;
           pic.mediaId = `media:${partPath.slice(1)}`;
+          if (mediaPart?.contentType) {
+            pic.contentType = mediaPart.contentType;
+          }
         }
         // F4.1 — preserve outer drawing XML for lossless round-trip serialization
         pic.rawXml = rawXml;

package/src/model/canonical-document.ts

@@ -1922,6 +1922,8 @@ export interface PictureContent {
   mediaId?: string;
   /** Absolute package path for media catalog lookup. */
   packagePartName?: string;
+  /** MIME resolved from the OPC media part, when known. */
+  contentType?: string;
   srcRect?: { top: number; bottom: number; left: number; right: number };
   stretch?: boolean;
   /**

package/src/ui/WordReviewEditor.tsx

@@ -3341,13 +3341,40 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         onToggleItalic: commands.onToggleItalic,
         onToggleUnderline: commands.onToggleUnderline,
         onToggleStrikethrough: commands.onToggleStrikethrough,
+        onSetParagraphStyle: (styleId) => {
+          const resolvedStyleId = resolveProductParagraphStyleId(styleCatalog, styleId);
+          if (!resolvedStyleId) {
+            activeRuntime.emitBlockedCommand("setParagraphStyle", [{
+              code: "unsupported_surface",
+              message: `${styleId} is not available in this document's style catalog.`,
+            }]);
+            return;
+          }
+          commands.onSetParagraphStyle?.(resolvedStyleId);
+        },
+        onSetFontFamily: commands.onSetFontFamily,
+        onSetFontSize: commands.onSetFontSize,
+        onSetTextColor: commands.onSetTextColor,
+        onSetHighlightColor: commands.onSetHighlightColor,
         onToggleBulletedList: commands.onToggleBulletedList,
         onToggleNumberedList: commands.onToggleNumberedList,
         onOutdent: commands.onOutdent,
         onIndent: commands.onIndent,
         onSetAlignment: (alignment) => commands.onSetAlignment?.(alignment),
+        onInsertPageBreak: commands.onInsertPageBreak,
+        onInsertSectionBreak: (type) => commands.onInsertSectionBreak?.(type),
         onInsertTable: commands.onInsertTable,
         onAddComment: commands.onAddComment,
+        onFindRequested: onFindRequested
+          ? () => onFindRequested({ selectionText: "", selectionRange: snapshot.selection })
+          : undefined,
+        onReplaceRequested: onReplaceRequested
+          ? () => onReplaceRequested({ selectionText: "", selectionRange: snapshot.selection })
+          : undefined,
+        onPrintRequested,
+        onGoToRequested: onGoToRequested
+          ? () => onGoToRequested({ selectionText: "", selectionRange: snapshot.selection })
+          : undefined,
         onInsertRowAbove: commands.onAddRowBefore,
         onInsertRowBelow: commands.onAddRowAfter,
         onInsertColumnBefore: commands.onAddColumnBefore,
@@ -3362,7 +3389,17 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
       return editorActionHost
         ? { ...defaultHost, ...editorActionHost }
         : defaultHost;
-    }, [activeRuntime, commands, editorActionHost]);
+    }, [
+      activeRuntime,
+      commands,
+      editorActionHost,
+      onFindRequested,
+      onGoToRequested,
+      onPrintRequested,
+      onReplaceRequested,
+      snapshot.selection,
+      styleCatalog,
+    ]);
 
     const harnessShowUnsupportedPreviews = readHarnessDebugPortsFlag(__harnessDebugPorts, "unsupportedObjectPreviews");
     const effectiveShowUnsupportedPreviews = computeEffectiveShowUnsupportedPreviews({
@@ -4574,6 +4611,39 @@ function createSelectionToolbarStyleBadge(
   return { label: styleEntry.displayName };
 }
 
+function resolveProductParagraphStyleId(
+  styleCatalog: StyleCatalogSnapshot,
+  requestedStyleId: string,
+): string | null {
+  switch (requestedStyleId) {
+    case "Heading1":
+      return resolveHeadingShortcutStyleId(styleCatalog, 1);
+    case "Heading2":
+      return resolveHeadingShortcutStyleId(styleCatalog, 2);
+    case "Heading3":
+      return resolveHeadingShortcutStyleId(styleCatalog, 3);
+    case "Normal": {
+      const defaultStyle = styleCatalog.paragraphs.find((entry) => entry.isDefault);
+      if (defaultStyle) return defaultStyle.styleId;
+      break;
+    }
+    default:
+      break;
+  }
+
+  const requestedToken = normalizeProductStyleToken(requestedStyleId);
+  const match = styleCatalog.paragraphs.find(
+    (entry) =>
+      normalizeProductStyleToken(entry.styleId) === requestedToken ||
+      normalizeProductStyleToken(entry.displayName) === requestedToken,
+  );
+  return match?.styleId ?? null;
+}
+
+function normalizeProductStyleToken(value: string): string {
+  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+
 function createSelectionToolbarListBadge(
   viewState: ReturnType<WordReviewEditorRuntime["getViewState"]>,
 ): SelectionToolbarModel["badges"][number] | null {

package/src/ui-tailwind/chrome/editor-action-registry.ts

@@ -24,6 +24,8 @@ import type { EditorChromeMode } from "../../api/v3/ui/chrome-composition";
 import type { ContextMenuGroupId } from "./tw-context-menu";
 import type { ShortcutKey } from "./tw-shortcut-hint";
 
+type ProductSectionBreakType = "nextPage" | "continuous" | "evenPage" | "oddPage";
+
 /**
  * Target kinds roughly mirror DESIGN-EDITOR.md §4 "Local context" cells.
  * A contextmenu event resolves its target to one (or more) of these
@@ -80,6 +82,11 @@ export interface EditorActionHostCallbacks {
   readonly onToggleItalic?: () => void;
   readonly onToggleUnderline?: () => void;
   readonly onToggleStrikethrough?: () => void;
+  readonly onSetParagraphStyle?: (styleId: string) => void;
+  readonly onSetFontFamily?: (fontFamily: string) => void;
+  readonly onSetFontSize?: (fontSize: number) => void;
+  readonly onSetTextColor?: (color: string) => void;
+  readonly onSetHighlightColor?: (color: string | null) => void;
   readonly onToggleBulletedList?: () => void;
   readonly onToggleNumberedList?: () => void;
   readonly onOutdent?: () => void;
@@ -87,9 +94,18 @@ export interface EditorActionHostCallbacks {
   readonly onSetAlignment?: (
     alignment: "left" | "center" | "right" | "justify",
   ) => void;
+  readonly onInsertPageBreak?: () => void;
+  readonly onInsertSectionBreak?: (type: ProductSectionBreakType) => void;
   readonly onInsertTable?: () => void;
+  readonly onInsertImage?: () => void;
   readonly onAddComment?: () => void;
 
+  // Search / app-level host-delegated commands
+  readonly onFindRequested?: () => void;
+  readonly onReplaceRequested?: () => void;
+  readonly onPrintRequested?: () => void;
+  readonly onGoToRequested?: () => void;
+
   // Tracked-change operations (suggestion target)
   readonly onAcceptSuggestion?: () => void;
   readonly onRejectSuggestion?: () => void;
@@ -134,6 +150,7 @@ export interface EditorActionHostCallbacks {
 export interface EditorAction {
   readonly id: string;
   readonly label: string;
+  readonly description?: string;
   readonly shortcut?: readonly ShortcutKey[];
   readonly group: ContextMenuGroupId;
   /** Targets for which this action is relevant. */
@@ -167,6 +184,7 @@ export interface EditorAction {
 function mk<K extends keyof EditorActionHostCallbacks>(opts: {
   id: string;
   label: string;
+  description?: string;
   shortcut?: readonly ShortcutKey[];
   group: ContextMenuGroupId;
   targetKinds: readonly TargetKind[];
@@ -178,6 +196,7 @@ function mk<K extends keyof EditorActionHostCallbacks>(opts: {
   return {
     id: opts.id,
     label: opts.label,
+    ...(opts.description ? { description: opts.description } : {}),
     ...(opts.shortcut ? { shortcut: opts.shortcut } : {}),
     group: opts.group,
     targetKinds: new Set(opts.targetKinds),
@@ -211,6 +230,7 @@ function mk<K extends keyof EditorActionHostCallbacks>(opts: {
 function mkArg<A, K extends keyof EditorActionHostCallbacks>(opts: {
   id: string;
   label: string;
+  description?: string;
   shortcut?: readonly ShortcutKey[];
   group: ContextMenuGroupId;
   targetKinds: readonly TargetKind[];
@@ -222,6 +242,7 @@ function mkArg<A, K extends keyof EditorActionHostCallbacks>(opts: {
   return {
     id: opts.id,
     label: opts.label,
+    ...(opts.description ? { description: opts.description } : {}),
     ...(opts.shortcut ? { shortcut: opts.shortcut } : {}),
     group: opts.group,
     targetKinds: new Set(opts.targetKinds),
@@ -239,6 +260,41 @@ function mkArg<A, K extends keyof EditorActionHostCallbacks>(opts: {
   };
 }
 
+/**
+ * Build an important command that should remain visible as a disabled
+ * row when the host/runtime has not wired the implementation yet. Use
+ * sparingly for product-signpost commands such as Insert Image or
+ * Replace; most callback-less registry rows should stay hidden.
+ */
+function mkImportant<K extends keyof EditorActionHostCallbacks>(opts: {
+  id: string;
+  label: string;
+  description: string;
+  shortcut?: readonly ShortcutKey[];
+  group: ContextMenuGroupId;
+  targetKinds: readonly TargetKind[];
+  modes?: readonly EditorChromeMode[];
+  callback: K;
+}): EditorAction {
+  return {
+    id: opts.id,
+    label: opts.label,
+    description: opts.description,
+    ...(opts.shortcut ? { shortcut: opts.shortcut } : {}),
+    group: opts.group,
+    targetKinds: new Set(opts.targetKinds),
+    ...(opts.modes ? { modes: new Set(opts.modes) } : {}),
+    when: (ctx) =>
+      typeof ctx.host[opts.callback] === "function" ? true : "disabled",
+    run: (ctx) => {
+      const fn = ctx.host[opts.callback] as (() => void) | undefined;
+      if (!fn) return;
+      fn();
+      ctx.dismiss();
+    },
+  };
+}
+
 export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
   // -------- History --------
   mk({
@@ -341,6 +397,105 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     targetKinds: ["plain-text", "table-cell"],
     callback: "onToggleStrikethrough",
   }),
+  mkArg<string, "onSetParagraphStyle">({
+    id: "style-normal",
+    label: "Normal text",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetParagraphStyle",
+    payload: "Normal",
+  }),
+  mkArg<string, "onSetParagraphStyle">({
+    id: "style-heading-1",
+    label: "Heading 1",
+    shortcut: ["Mod", "Alt", "1"],
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetParagraphStyle",
+    payload: "Heading1",
+  }),
+  mkArg<string, "onSetParagraphStyle">({
+    id: "style-heading-2",
+    label: "Heading 2",
+    shortcut: ["Mod", "Alt", "2"],
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetParagraphStyle",
+    payload: "Heading2",
+  }),
+  mkArg<string, "onSetParagraphStyle">({
+    id: "style-heading-3",
+    label: "Heading 3",
+    shortcut: ["Mod", "Alt", "3"],
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetParagraphStyle",
+    payload: "Heading3",
+  }),
+  mkArg<string, "onSetFontFamily">({
+    id: "font-family-aptos",
+    label: "Font: Aptos",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetFontFamily",
+    payload: "Aptos",
+  }),
+  mkArg<string, "onSetFontFamily">({
+    id: "font-family-calibri",
+    label: "Font: Calibri",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetFontFamily",
+    payload: "Calibri",
+  }),
+  mkArg<number, "onSetFontSize">({
+    id: "font-size-11",
+    label: "Font size: 11",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetFontSize",
+    payload: 11,
+  }),
+  mkArg<number, "onSetFontSize">({
+    id: "font-size-12",
+    label: "Font size: 12",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetFontSize",
+    payload: 12,
+  }),
+  mkArg<string, "onSetTextColor">({
+    id: "text-color-black",
+    label: "Text color: Black",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetTextColor",
+    payload: "#000000",
+  }),
+  mkArg<string, "onSetTextColor">({
+    id: "text-color-accent",
+    label: "Text color: Accent",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetTextColor",
+    payload: "#1F6B4F",
+  }),
+  mkArg<string | null, "onSetHighlightColor">({
+    id: "highlight-yellow",
+    label: "Highlight: Yellow",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetHighlightColor",
+    payload: "#FFF2A8",
+  }),
+  mkArg<string | null, "onSetHighlightColor">({
+    id: "highlight-clear",
+    label: "Clear highlight",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetHighlightColor",
+    payload: null,
+  }),
   mk({
     id: "list-bulleted",
     label: "Bulleted list",
@@ -401,6 +556,31 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     callback: "onSetAlignment",
     payload: "justify",
   }),
+  mk({
+    id: "insert-page-break",
+    label: "Insert page break",
+    shortcut: ["Mod", "Enter"],
+    group: "misc",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onInsertPageBreak",
+  }),
+  mkArg<ProductSectionBreakType, "onInsertSectionBreak">({
+    id: "insert-section-break-next-page",
+    label: "Insert section break",
+    description: "Next page section break",
+    group: "misc",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onInsertSectionBreak",
+    payload: "nextPage",
+  }),
+  mkImportant({
+    id: "insert-image",
+    label: "Insert image…",
+    description: "Needs a host file picker before it can run.",
+    group: "misc",
+    targetKinds: [],
+    callback: "onInsertImage",
+  }),
   mk({
     id: "insert-table",
     label: "Insert table",
@@ -416,6 +596,46 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     callback: "onAddComment",
   }),
 
+  // -------- Search / navigation / app-level commands --------
+  // Empty targetKinds keeps these out of right-click local menus. The
+  // global command palette still projects them from the shared registry.
+  mkImportant({
+    id: "find",
+    label: "Find…",
+    description: "Host search panel is not wired.",
+    shortcut: ["Mod", "F"],
+    group: "misc",
+    targetKinds: [],
+    callback: "onFindRequested",
+  }),
+  mkImportant({
+    id: "replace",
+    label: "Replace…",
+    description: "Host replace panel is not wired.",
+    shortcut: ["Ctrl", "H"],
+    group: "misc",
+    targetKinds: [],
+    callback: "onReplaceRequested",
+  }),
+  mkImportant({
+    id: "go-to",
+    label: "Go to…",
+    description: "Host navigation panel is not wired.",
+    shortcut: ["Ctrl", "G"],
+    group: "misc",
+    targetKinds: [],
+    callback: "onGoToRequested",
+  }),
+  mkImportant({
+    id: "print",
+    label: "Print…",
+    description: "Host print/export flow is not wired.",
+    shortcut: ["Mod", "P"],
+    group: "misc",
+    targetKinds: [],
+    callback: "onPrintRequested",
+  }),
+
   // -------- Suggestion / tracked change --------
   mk({
     id: "accept-suggestion",