superdoc 2.24.0-next.8 → 2.24.0

package/dist/document-api/src/types/sd-props.d.ts

@@ -1,10 +1,4 @@
-/**
- * SDM/1 property models: run, paragraph, table, list, image, drawing props.
- *
- * These define the direct formatting ("authored") property bags carried by
- * style-bearing nodes. Resolved/provenance fields are separate concerns
- * populated at read time by the style-engine.
- */
+import { ST_HIGHLIGHT_VALUES } from '../inline-semantics/token-sets.js';
 export type SDThemeFontRef = 'majorAscii' | 'majorHAnsi' | 'majorEastAsia' | 'majorBidi' | 'minorAscii' | 'minorHAnsi' | 'minorEastAsia' | 'minorBidi';
 export interface SDRunFonts {
     ascii?: string;
@@ -34,7 +28,7 @@ export type SDColorRef = {
 } | {
     model: 'auto';
 };
-export type SDHighlightColor = 'black' | 'blue' | 'cyan' | 'green' | 'magenta' | 'red' | 'yellow' | 'white' | 'darkBlue' | 'darkCyan' | 'darkGreen' | 'darkMagenta' | 'darkRed' | 'darkYellow' | 'darkGray' | 'lightGray' | 'none';
+export type SDHighlightColor = (typeof ST_HIGHLIGHT_VALUES)[number];
 export type SDUnderlineStyle = 'none' | 'single' | 'words' | 'double' | 'thick' | 'dotted' | 'dottedHeavy' | 'dash' | 'dashedHeavy' | 'dashLong' | 'dashLongHeavy' | 'dotDash' | 'dashDotHeavy' | 'dotDotDash' | 'dashDotDotHeavy' | 'wave' | 'wavyHeavy' | 'wavyDouble';
 export interface SDUnderline {
     style?: SDUnderlineStyle;
@@ -47,7 +41,9 @@ export interface SDShading {
 }
 export interface SDRunBorder {
     style?: string;
+    /** Line width in points. */
     width?: number;
+    /** Spacing from the content in points. */
     space?: number;
     color?: SDColorRef;
     frame?: boolean;
@@ -186,10 +182,31 @@ export type SDTableWidth = {
 } | {
     kind: 'none';
 };
+/** Table border lines; `width` and `space` in points. */
+export interface SDTableBorders {
+    top?: SDRunBorder;
+    right?: SDRunBorder;
+    bottom?: SDRunBorder;
+    left?: SDRunBorder;
+    start?: SDRunBorder;
+    end?: SDRunBorder;
+    insideH?: SDRunBorder;
+    insideV?: SDRunBorder;
+}
+/** Cell padding in points. */
+export interface SDCellPadding {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    start?: number;
+    end?: number;
+}
 export interface SDTableProps {
     width?: SDTableWidth;
     layout?: 'fixed' | 'autofit';
     alignment?: 'left' | 'center' | 'right' | 'inside' | 'outside';
+    /** Normalized CSS-like edge borders retained for document and fragment compatibility. */
     borders?: {
         top?: string;
         right?: string;
@@ -198,28 +215,51 @@ export interface SDTableProps {
         insideH?: string;
         insideV?: string;
     };
+    /** Leading-edge indent in points. */
+    indent?: number;
+    /** Spacing between cells in points. */
+    cellSpacing?: number;
+    /** Default cell padding in points. */
+    cellPadding?: SDCellPadding;
+    shading?: SDShading;
+    /** Right-to-left visual column order (`w:bidiVisual`). */
+    bidiVisual?: boolean;
+}
+/** Table formatting authored on a table style. Borders are structured lines, not strings. */
+export interface SDTableStyleProps extends Omit<SDTableProps, 'borders'> {
+    borders?: SDTableBorders;
 }
 export interface SDRowProps {
     /** Minimum row height in points. */
     minHeight?: number;
     cantSplit?: boolean;
+    /** Repeat this row as a header row on each page (`w:tblHeader`). */
+    repeatHeader?: boolean;
+}
+/** Cell border lines; `width` and `space` in points. */
+export interface SDCellBorders extends SDTableBorders {
+    /** Diagonal from top-left to bottom-right. */
+    tl2br?: SDRunBorder;
+    /** Diagonal from top-right to bottom-left. */
+    tr2bl?: SDRunBorder;
 }
 export interface SDCellProps {
     verticalAlign?: 'top' | 'center' | 'bottom';
     shading?: SDColorRef;
     /** Cell padding in points. */
-    padding?: {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
+    padding?: SDCellPadding;
+    /** Normalized CSS-like edge borders, such as `'single 1pt #000000'` or `'none'`. */
     borders?: {
         top?: string;
         right?: string;
         bottom?: string;
         left?: string;
     };
+    noWrap?: boolean;
+}
+/** Cell formatting authored on a table style. Borders are structured lines, not strings. */
+export interface SDTableStyleCellProps extends Omit<SDCellProps, 'borders'> {
+    borders?: SDCellBorders;
 }
 export interface SDImageProps {
     alignment?: 'left' | 'center' | 'right';

package/dist/document-api/src/types/sd-styles.d.ts

@@ -1,20 +1,69 @@
-import { SDRunProps, SDParagraphProps, SDTableProps, SDThemeColorName } from './sd-props.js';
+import { SDParagraphProps, SDRowProps, SDRunProps, SDTableProps, SDTableStyleProps, SDTableStyleCellProps, SDThemeColorName } from './sd-props.js';
+import { SDResolvedProvenance } from './sd-objects.js';
 export interface SDStyleBase<TProps> {
     name?: string;
     basedOn?: string;
     next?: string;
     linked?: string;
+    /** Properties authored on this style, with theme references left raw. */
     props?: TProps;
+    /** Cascaded values (basedOn chain, docDefaults, theme). Present with `includeResolved`. */
+    resolved?: Partial<TProps>;
+    /** Where each resolved value came from. Present with `includeProvenance`. */
+    provenance?: SDResolvedProvenance<TProps>;
+}
+export interface SDParagraphStyleDef extends SDStyleBase<SDParagraphProps> {
+    /** Run properties authored on this paragraph style (`w:rPr`). */
+    runProps?: SDRunProps;
+    /** Cascaded run values for text in this paragraph style. Present with `includeResolved`. */
+    resolvedRun?: Partial<SDRunProps>;
+    /** Where each resolved run value came from. Present with `includeProvenance`. */
+    runProvenance?: SDResolvedProvenance<SDRunProps>;
 }
-export type SDParagraphStyleDef = SDStyleBase<SDParagraphProps>;
 export type SDCharacterStyleDef = SDStyleBase<SDRunProps>;
-export type SDTableStyleDef = SDStyleBase<SDTableProps>;
+/** Table regions that a table style can format conditionally (`w:tblStylePr/@w:type`). */
+export type SDTableStyleRegion = 'wholeTable' | 'firstRow' | 'lastRow' | 'firstCol' | 'lastCol' | 'band1Vert' | 'band2Vert' | 'band1Horz' | 'band2Horz' | 'neCell' | 'nwCell' | 'seCell' | 'swCell';
+/** Formatting a table style applies to one region, as authored. */
+export interface SDTableStyleFormatting {
+    table?: SDTableStyleProps;
+    row?: SDRowProps;
+    cell?: SDTableStyleCellProps;
+    paragraph?: SDParagraphProps;
+    run?: SDRunProps;
+}
+export interface SDTableStyleDef extends SDStyleBase<SDTableStyleProps> {
+    /** Row defaults (`w:trPr`). */
+    rowProps?: SDRowProps;
+    /** Cell defaults (`w:tcPr`). */
+    cellProps?: SDTableStyleCellProps;
+    /** Paragraph formatting for text in the table (`w:pPr`). */
+    paragraphProps?: SDParagraphProps;
+    /** Run formatting for text in the table (`w:rPr`). */
+    runProps?: SDRunProps;
+    /**
+     * Conditional formatting per table region (`w:tblStylePr`), as authored.
+     * `resolved` / `provenance` cover table-level props only; regions are not cascaded.
+     */
+    conditional?: Partial<Record<SDTableStyleRegion, SDTableStyleFormatting>>;
+    /** Rows per horizontal band (`w:tblStyleRowBandSize`). */
+    rowBandSize?: number;
+    /** Columns per vertical band (`w:tblStyleColBandSize`). */
+    columnBandSize?: number;
+}
 export interface SDStyles {
     paragraph?: Record<string, SDParagraphStyleDef>;
     character?: Record<string, SDCharacterStyleDef>;
     table?: Record<string, SDTableStyleDef>;
 }
+/** Theme color roles that `w:clrSchemeMapping` maps onto theme color slots. */
+export type SDThemeColorRole = 'bg1' | 't1' | 'bg2' | 't2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hyperlink' | 'followedHyperlink';
 export interface SDTheme {
+    /**
+     * `document` when read from the package theme part; `fallback` when the part is
+     * missing or unreadable and the default Office theme stands in (see diagnostics).
+     */
+    source?: 'document' | 'fallback';
+    /** Six-digit hex colors without `#`, matching `SDColorRef` rgb values. */
     colorScheme: Record<SDThemeColorName, string>;
     fontScheme?: {
         major?: {
@@ -28,9 +77,15 @@ export interface SDTheme {
             complexScript?: string;
         };
     };
+    /** From `w:settings/w:clrSchemeMapping`; absent when the document declares none. */
+    colorSchemeMapping?: Partial<Record<SDThemeColorRole, SDThemeColorName>>;
 }
 export interface SDDocDefaults {
     run?: SDRunProps;
     paragraph?: SDParagraphProps;
     table?: SDTableProps;
+    /** `run` with theme references resolved. Present with `includeResolved`. */
+    resolvedRun?: Partial<SDRunProps>;
+    /** `paragraph` with theme references resolved. Present with `includeResolved`. */
+    resolvedParagraph?: Partial<SDParagraphProps>;
 }

package/dist/document-api/src/types/table-operations.types.d.ts

@@ -133,6 +133,7 @@ export type TableCreateLocation = TableAnchorLocation
  */
 export interface TableMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     table?: TableAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }
@@ -154,6 +155,7 @@ export interface CreateTableInput {
 }
 export interface CreateTableSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     table: TableAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }

package/dist/style.css

@@ -2348,34 +2348,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-f53aafe0] {
+.superdoc[data-v-38ecd481] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-f53aafe0] {
+.right-sidebar[data-v-38ecd481] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-f53aafe0] {
+.floating-comments[data-v-38ecd481] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-f53aafe0] {
+.superdoc__layers[data-v-38ecd481] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-f53aafe0] {
+.superdoc__document[data-v-38ecd481] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-f53aafe0] {
+.superdoc__sub-document[data-v-38ecd481] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-f53aafe0] {
+.superdoc__selection-layer[data-v-38ecd481] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2386,13 +2386,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-f53aafe0] {
+.superdoc__whiteboard-layer[data-v-38ecd481] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-f53aafe0] {
+.superdoc__temp-selection[data-v-38ecd481] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-f53aafe0] {
+.superdoc__right-sidebar[data-v-38ecd481] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2400,7 +2400,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-f53aafe0] {
+.superdoc__compact-comment-popover[data-v-38ecd481] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2409,14 +2409,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-f53aafe0] {
+.tools[data-v-38ecd481] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-f53aafe0] {
+.tools-item[data-v-38ecd481] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2427,10 +2427,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-f53aafe0] {
+.tools-item i[data-v-38ecd481] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-f53aafe0] {
+.superdoc__tools-icon[data-v-38ecd481] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2445,22 +2445,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-f53aafe0] {
+.superdoc .superdoc__layers[data-v-38ecd481] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-f53aafe0] {
+.superdoc__sub-document[data-v-38ecd481] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-f53aafe0] {
+.superdoc__right-sidebar[data-v-38ecd481] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-f53aafe0] {
+.ai-writer-container[data-v-38ecd481] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2476,10 +2476,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-f53aafe0] {
+.ai-tool > svg[data-v-38ecd481] {
   fill: transparent;
 }
-.ai-tool[data-v-f53aafe0]::before {
+.ai-tool[data-v-38ecd481]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2500,7 +2500,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-f53aafe0]:hover::before {
+.ai-tool[data-v-38ecd481]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/style.layered.css

@@ -2348,34 +2348,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-f53aafe0] {
+.superdoc[data-v-38ecd481] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-f53aafe0] {
+.right-sidebar[data-v-38ecd481] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-f53aafe0] {
+.floating-comments[data-v-38ecd481] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-f53aafe0] {
+.superdoc__layers[data-v-38ecd481] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-f53aafe0] {
+.superdoc__document[data-v-38ecd481] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-f53aafe0] {
+.superdoc__sub-document[data-v-38ecd481] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-f53aafe0] {
+.superdoc__selection-layer[data-v-38ecd481] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2386,13 +2386,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-f53aafe0] {
+.superdoc__whiteboard-layer[data-v-38ecd481] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-f53aafe0] {
+.superdoc__temp-selection[data-v-38ecd481] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-f53aafe0] {
+.superdoc__right-sidebar[data-v-38ecd481] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2400,7 +2400,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-f53aafe0] {
+.superdoc__compact-comment-popover[data-v-38ecd481] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2409,14 +2409,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-f53aafe0] {
+.tools[data-v-38ecd481] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-f53aafe0] {
+.tools-item[data-v-38ecd481] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2427,10 +2427,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-f53aafe0] {
+.tools-item i[data-v-38ecd481] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-f53aafe0] {
+.superdoc__tools-icon[data-v-38ecd481] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2445,22 +2445,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-f53aafe0] {
+.superdoc .superdoc__layers[data-v-38ecd481] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-f53aafe0] {
+.superdoc__sub-document[data-v-38ecd481] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-f53aafe0] {
+.superdoc__right-sidebar[data-v-38ecd481] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-f53aafe0] {
+.ai-writer-container[data-v-38ecd481] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2476,10 +2476,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-f53aafe0] {
+.ai-tool > svg[data-v-38ecd481] {
   fill: transparent;
 }
-.ai-tool[data-v-f53aafe0]::before {
+.ai-tool[data-v-38ecd481]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2500,7 +2500,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-f53aafe0]:hover::before {
+.ai-tool[data-v-38ecd481]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/superdoc/src/core/editor-runtime/v2/v2-session-shortcut-routes.d.ts

@@ -45,6 +45,8 @@ export interface CreateV2SessionShortcutRoutesDeps {
     resolveToolbarElement: () => HTMLElement | null | undefined;
     /** Resolve the live public Document API facade, or null when unavailable. */
     getDocumentApi: () => ReferenceDocumentApi | null | undefined;
+    /** Scope each first-party mutation after its asynchronous list has resolved. */
+    runReferenceMutation?: (memberPath: 'toc.update' | 'fields.rebuild' | 'index.rebuild', input: unknown) => unknown;
     /**
      * The built-in page-number command. When present, the PAGE shortcut runs it,
      * so the shortcut and the toolbar control insert and place the caret the same way.

package/dist/superdoc.cjs

@@ -304,7 +304,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.24.0-next.8";
+		return "2.24.0";
 	} catch {
 		return "unknown";
 	}
@@ -21117,9 +21117,10 @@ function createV2SessionShortcutRoutes(deps) {
 			handled: false,
 			reason: "document-api-unavailable"
 		};
-		let ran = runListThenApply(doc.toc?.list, doc.toc?.update);
-		ran = runListThenApply(doc.fields?.list, doc.fields?.rebuild) || ran;
-		ran = runListThenApply(doc.index?.list, doc.index?.rebuild) || ran;
+		const apply = (memberPath, mutation) => isFn(mutation) ? (input) => deps.runReferenceMutation ? deps.runReferenceMutation(memberPath, input) : mutation(input) : void 0;
+		let ran = runListThenApply(doc.toc?.list, apply("toc.update", doc.toc?.update));
+		ran = runListThenApply(doc.fields?.list, apply("fields.rebuild", doc.fields?.rebuild)) || ran;
+		ran = runListThenApply(doc.index?.list, apply("index.rebuild", doc.index?.rebuild)) || ran;
 		return ran ? true : {
 			handled: false,
 			reason: "field-update-workflow-unavailable"
@@ -22488,7 +22489,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				console.warn("[SuperDoc] v2 session-shortcut unbind failed", err);
 			}
 		};
-		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi }) => {
+		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi, firstPartyCommandMutation }) => {
 			if (!documentId) return;
 			clearV2SessionShortcutBinding(documentId);
 			if (typeof bindSessionShortcuts !== "function") return;
@@ -22496,6 +22497,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				routes: createV2SessionShortcutRoutes({
 					resolveToolbarElement: () => proxy.$superdoc?.toolbar?.toolbarContainer ?? null,
 					getDocumentApi: () => documentApi ?? null,
+					...firstPartyCommandMutation ? { runReferenceMutation: (memberPath, input) => firstPartyCommandMutation.run(memberPath, [input]) } : {},
 					pageNumberCommand: {
 						isEnabled: () => getSuperDocUI()?.commands.get("page-number-insert").getState().enabled === true,
 						execute: () => {
@@ -23002,7 +23004,8 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			installV2SessionShortcutBinding({
 				documentId,
 				bindSessionShortcuts,
-				documentApi
+				documentApi,
+				firstPartyCommandMutation
 			});
 			if (collaborationProvider && resolveDocumentV2Collaboration(getDocument(documentId)).state === "valid") onEditorCollaborationReady({ editor: facade });
 			if (pageMetrics && pageLayout) syncV2RulerActiveEditor();
@@ -24817,7 +24820,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-f53aafe0"]]);
+}, [["__scopeId", "data-v-38ecd481"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46621,7 +46624,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.24.0-next.8";
+		this.version = "2.24.0";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -302,7 +302,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.24.0-next.8";
+		return "2.24.0";
 	} catch {
 		return "unknown";
 	}
@@ -21084,9 +21084,10 @@ function createV2SessionShortcutRoutes(deps) {
 			handled: false,
 			reason: "document-api-unavailable"
 		};
-		let ran = runListThenApply(doc.toc?.list, doc.toc?.update);
-		ran = runListThenApply(doc.fields?.list, doc.fields?.rebuild) || ran;
-		ran = runListThenApply(doc.index?.list, doc.index?.rebuild) || ran;
+		const apply = (memberPath, mutation) => isFn(mutation) ? (input) => deps.runReferenceMutation ? deps.runReferenceMutation(memberPath, input) : mutation(input) : void 0;
+		let ran = runListThenApply(doc.toc?.list, apply("toc.update", doc.toc?.update));
+		ran = runListThenApply(doc.fields?.list, apply("fields.rebuild", doc.fields?.rebuild)) || ran;
+		ran = runListThenApply(doc.index?.list, apply("index.rebuild", doc.index?.rebuild)) || ran;
 		return ran ? true : {
 			handled: false,
 			reason: "field-update-workflow-unavailable"
@@ -22447,7 +22448,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				console.warn("[SuperDoc] v2 session-shortcut unbind failed", err);
 			}
 		};
-		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi }) => {
+		const installV2SessionShortcutBinding = ({ documentId, bindSessionShortcuts, documentApi, firstPartyCommandMutation }) => {
 			if (!documentId) return;
 			clearV2SessionShortcutBinding(documentId);
 			if (typeof bindSessionShortcuts !== "function") return;
@@ -22455,6 +22456,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				routes: createV2SessionShortcutRoutes({
 					resolveToolbarElement: () => proxy.$superdoc?.toolbar?.toolbarContainer ?? null,
 					getDocumentApi: () => documentApi ?? null,
+					...firstPartyCommandMutation ? { runReferenceMutation: (memberPath, input) => firstPartyCommandMutation.run(memberPath, [input]) } : {},
 					pageNumberCommand: {
 						isEnabled: () => getSuperDocUI()?.commands.get("page-number-insert").getState().enabled === true,
 						execute: () => {
@@ -22961,7 +22963,8 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			installV2SessionShortcutBinding({
 				documentId,
 				bindSessionShortcuts,
-				documentApi
+				documentApi,
+				firstPartyCommandMutation
 			});
 			if (collaborationProvider && resolveDocumentV2Collaboration(getDocument(documentId)).state === "valid") onEditorCollaborationReady({ editor: facade });
 			if (pageMetrics && pageLayout) syncV2RulerActiveEditor();
@@ -24776,7 +24779,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-f53aafe0"]]);
+}, [["__scopeId", "data-v-38ecd481"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46550,7 +46553,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.24.0-next.8";
+		this.version = "2.24.0";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];