superdoc 2.18.1-next.2 → 2.18.1-next.4

package/dist/chunks/{create-super-doc-ui-B-Zlfpi_.es.js → create-super-doc-ui-C3HDE1IE.es.js}

@@ -9632,6 +9632,31 @@ function createSuperDocUI(options) {
 				};
 			}
 		},
+		placeAroundContentControl: async (input) => {
+			if (!getEditor()) return {
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.notReady
+			};
+			const resolved = getSelectionApplyHelper();
+			if (!("helper" in resolved)) return {
+				ok: false,
+				reason: resolved.reason
+			};
+			if (typeof resolved.helper.placeAroundContentControl !== "function") return {
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.hostCapabilityUnavailable
+			};
+			try {
+				const result = await resolved.helper.placeAroundContentControl(input);
+				recompute();
+				return normalizeHostSelectionApplyResult(result);
+			} catch {
+				return {
+					ok: false,
+					reason: SUPERDOC_UI_REASONS.targetUnresolved
+				};
+			}
+		},
 		getAnchorRect: (input) => {
 			const host = getHost();
 			if (typeof host?.getSelectionAnchorRect === "function") {

package/dist/chunks/{create-super-doc-ui-DpNGRfzi.cjs → create-super-doc-ui-Gxk1m05U.cjs}

@@ -9632,6 +9632,31 @@ function createSuperDocUI(options) {
 				};
 			}
 		},
+		placeAroundContentControl: async (input) => {
+			if (!getEditor()) return {
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.notReady
+			};
+			const resolved = getSelectionApplyHelper();
+			if (!("helper" in resolved)) return {
+				ok: false,
+				reason: resolved.reason
+			};
+			if (typeof resolved.helper.placeAroundContentControl !== "function") return {
+				ok: false,
+				reason: SUPERDOC_UI_REASONS.hostCapabilityUnavailable
+			};
+			try {
+				const result = await resolved.helper.placeAroundContentControl(input);
+				recompute();
+				return normalizeHostSelectionApplyResult(result);
+			} catch {
+				return {
+					ok: false,
+					reason: SUPERDOC_UI_REASONS.targetUnresolved
+				};
+			}
+		},
 		getAnchorRect: (input) => {
 			const host = getHost();
 			if (typeof host?.getSelectionAnchorRect === "function") {

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.18.1-next.2",
+	superdocVersion: "2.18.1-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.18.1-next.2",
+	superdocVersion: "2.18.1-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/metadata/anchored-metadata.types.d.ts

@@ -1,6 +1,7 @@
 import { AdapterMutationFailure } from '../types/adapter-result.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 import { SelectionTarget, TextTarget } from '../types/address.js';
+import { StoryLocator } from '../types/story.types.js';
 /**
  * Stable opaque identifier for an anchored-metadata entry. Lives in the
  * anchor SDT's `w:tag` (ECMA-376 Part 1 §17.5.2.34) and links the anchor
@@ -97,9 +98,15 @@ export interface AnchoredMetadataListInput {
     limit?: number;
     offset?: number;
 }
-export interface AnchoredMetadataGetInput {
+export type AnchoredMetadataGetInput = {
     id: AnchoredMetadataId;
-}
+} & ({
+    contentControlId?: never;
+    story?: never;
+} | {
+    contentControlId: string;
+    story: StoryLocator;
+});
 export interface AnchoredMetadataUpdateInput {
     id: AnchoredMetadataId;
     /**
@@ -111,9 +118,7 @@ export interface AnchoredMetadataUpdateInput {
 export interface AnchoredMetadataRemoveInput {
     id: AnchoredMetadataId;
 }
-export interface AnchoredMetadataResolveInput {
-    id: AnchoredMetadataId;
-}
+export type AnchoredMetadataResolveInput = AnchoredMetadataGetInput;
 /**
  * Light view of an entry returned by `list()`. Carries identity and the
  * package coordinates of its backing storage part, but NOT the payload —

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DpNGRfzi.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Gxk1m05U.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B-Zlfpi_.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C3HDE1IE.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DpNGRfzi.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Gxk1m05U.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B-Zlfpi_.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C3HDE1IE.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DpNGRfzi.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Gxk1m05U.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { i as BUILT_IN_COMMAND_IDS, s as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-B-Zlfpi_.es.js";
+import { i as BUILT_IN_COMMAND_IDS, s as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C3HDE1IE.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/public/ui/types.d.ts

@@ -1,4 +1,4 @@
-import { CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, EntityAddress, TextAddress, TextTarget, ScrollIntoViewInput, ScrollIntoViewOutput, SelectionInfo, SelectionTarget, Receipt, ReceiptFailureCode, ContentControlInfo, StyleCatalogItem, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult } from '../../../../document-api/src/index.js';
+import { CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, EntityAddress, TextAddress, TextTarget, ScrollIntoViewInput, ScrollIntoViewOutput, SelectionInfo, SelectionTarget, Receipt, ReceiptFailureCode, ContentControlInfo, ContentControlTarget, StyleCatalogItem, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult } from '../../../../document-api/src/index.js';
 import { PartialBrowserDocumentApi } from '../browser-document-api.js';
 import { ExportParams } from '../export-types.js';
 import { DocumentReplacementResult } from '../document-replacement.js';
@@ -30,7 +30,7 @@ import { BuiltInCommandId } from './commands.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from '../../../../document-api/src/index.js';
+export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
 export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';
@@ -810,6 +810,16 @@ export interface SelectionHandle extends SnapshotSubscribable<SelectionSlice> {
      * Fails closed with a stable reason when the host cannot honor the target.
      */
     apply(target: SelectionTarget): WorkflowActionResult;
+    /**
+     * Place the browser caret before or after a live inline content control.
+     * Placement does not edit the document or create an undo entry.
+     */
+    placeAroundContentControl(input: {
+        target: ContentControlTarget & {
+            kind: 'inline';
+        };
+        edge: 'before' | 'after';
+    }): Promise<WorkflowActionResult>;
     /** Resolve a painted anchor rect for the current selection, when available. */
     getAnchorRect(input?: {
         placement?: 'start' | 'end' | 'center';

package/dist/superdoc/src/public/ui.d.cts

@@ -21,6 +21,7 @@ import type { ContentControlInfo as __Cjs_ContentControlInfo } from './ui.js' wi
 import type { ContentControlsHandle as __Cjs_ContentControlsHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { ContentControlsListResult as __Cjs_ContentControlsListResult } from './ui.js' with { "resolution-mode": "import" };
 import type { ContentControlsSlice as __Cjs_ContentControlsSlice } from './ui.js' with { "resolution-mode": "import" };
+import type { ContentControlTarget as __Cjs_ContentControlTarget } from './ui.js' with { "resolution-mode": "import" };
 import type { ContentControlViewportAddress as __Cjs_ContentControlViewportAddress } from './ui.js' with { "resolution-mode": "import" };
 import type { ContextMenuHandle as __Cjs_ContextMenuHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { ContextMenuItem as __Cjs_ContextMenuItem } from './ui.js' with { "resolution-mode": "import" };
@@ -135,6 +136,7 @@ export type { __Cjs_ContentControlInfo as ContentControlInfo };
 export type { __Cjs_ContentControlsHandle as ContentControlsHandle };
 export type { __Cjs_ContentControlsListResult as ContentControlsListResult };
 export type { __Cjs_ContentControlsSlice as ContentControlsSlice };
+export type { __Cjs_ContentControlTarget as ContentControlTarget };
 export type { __Cjs_ContentControlViewportAddress as ContentControlViewportAddress };
 export type { __Cjs_ContextMenuHandle as ContextMenuHandle };
 export type { __Cjs_ContextMenuItem as ContextMenuItem };

package/dist/superdoc/src/public/ui.d.ts

@@ -26,4 +26,4 @@
 export { createSuperDocUI } from './ui/create-super-doc-ui.js';
 export { shallowEqual } from './ui/equality.js';
 export { BUILT_IN_COMMAND_IDS } from './ui/commands.js';
-export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from './ui/types.js';
+export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from './ui/types.js';

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DpNGRfzi.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-Gxk1m05U.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-D8mAFF-r.cjs");
@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.18.1-next.2";
+		return "2.18.1-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -45750,7 +45750,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.18.1-next.2";
+		this.version = "2.18.1-next.4";
 		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

@@ -1,6 +1,6 @@
 import { i as __toESM$2 } from "./chunks/rolldown-runtime-0pSA04fp.es.js";
 import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
-import { a as applyV2CommentInvalidationFromMutation, c as DOM_CLASS_NAMES, d as recordInteraction, l as closeInteractionHistory, n as executeFirstPartyCommandAsync, o as getV2TrackedChangeMutationImpact, r as registerFirstPartyCommandMutation, t as createSuperDocUI, u as createInteractionHistory } from "./chunks/create-super-doc-ui-B-Zlfpi_.es.js";
+import { a as applyV2CommentInvalidationFromMutation, c as DOM_CLASS_NAMES, d as recordInteraction, l as closeInteractionHistory, n as executeFirstPartyCommandAsync, o as getV2TrackedChangeMutationImpact, r as registerFirstPartyCommandMutation, t as createSuperDocUI, u as createInteractionHistory } from "./chunks/create-super-doc-ui-C3HDE1IE.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-BzJ3CyxR.es.js";
@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.18.1-next.2";
+		return "2.18.1-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -45681,7 +45681,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.18.1-next.2";
+		this.version = "2.18.1-next.4";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];