@superdoc-dev/mcp 0.12.0-next.36 → 0.12.0-next.38

package/dist/index.js

@@ -50479,7 +50479,7 @@ var init_remark_gfm_BUJjZJLy_es = __esm(() => {
   emptyOptions2 = {};
 });
 
-// ../../packages/superdoc/dist/chunks/SuperConverter-Bdmhv7BA.es.js
+// ../../packages/superdoc/dist/chunks/SuperConverter-DVjSc-AY.es.js
 function getExtensionConfigField(extension$1, field, context = { name: "" }) {
   const fieldValue = extension$1.config[field];
   if (typeof fieldValue === "function")
@@ -52051,6 +52051,26 @@ function validateClearDirection(input) {
   assertParagraphTarget(input, "format.paragraph.clearDirection");
   assertNoUnknownFields(input, CLEAR_DIRECTION_KEYS, "format.paragraph.clearDirection");
 }
+function validateSetNumbering(input) {
+  const op = "format.paragraph.setNumbering";
+  assertParagraphTarget(input, op);
+  assertNoUnknownFields(input, SET_NUMBERING_KEYS, op);
+  const rec = input;
+  if (rec.numId === undefined)
+    throw new DocumentApiValidationError("INVALID_INPUT", `${op} requires a numId field.`);
+  if (typeof rec.numId !== "number" || !Number.isInteger(rec.numId) || rec.numId < 1)
+    throw new DocumentApiValidationError("INVALID_INPUT", `${op} numId must be a positive integer (numId 0 is the no-numbering sentinel). Got ${JSON.stringify(rec.numId)}.`, {
+      field: "numId",
+      value: rec.numId
+    });
+  if (rec.level !== undefined) {
+    if (typeof rec.level !== "number" || !Number.isInteger(rec.level) || rec.level < 0 || rec.level > 8)
+      throw new DocumentApiValidationError("INVALID_INPUT", `${op} level must be an integer 0-8. Got ${JSON.stringify(rec.level)}.`, {
+        field: "level",
+        value: rec.level
+      });
+  }
+}
 function executeParagraphsSetStyle(adapter, input, options) {
   validateSetStyle(input);
   return adapter.setStyle(input, normalizeMutationOptions(options));
@@ -52148,6 +52168,10 @@ function executeParagraphsClearDirection(adapter, input, options) {
   validateClearDirection(input);
   return adapter.clearDirection(input, normalizeMutationOptions(options));
 }
+function executeParagraphsSetNumbering(adapter, input, options) {
+  validateSetNumbering(input);
+  return adapter.setNumbering(input, normalizeMutationOptions(options));
+}
 function getPropertyDefinition(key, channel) {
   return PROPERTY_INDEX.get(`${channel}:${key}`);
 }
@@ -54956,6 +54980,7 @@ function buildDispatchTable(api2) {
     "format.paragraph.setMarkRunProps": (input, options) => api2.format.paragraph.setMarkRunProps(input, options),
     "format.paragraph.setDirection": (input, options) => api2.format.paragraph.setDirection(input, options),
     "format.paragraph.clearDirection": (input, options) => api2.format.paragraph.clearDirection(input, options),
+    "format.paragraph.setNumbering": (input, options) => api2.format.paragraph.setNumbering(input, options),
     "styles.apply": (input, options) => api2.styles.apply(input, options),
     "templates.apply": (input, options) => api2.templates.apply(input, options),
     "create.paragraph": (input, options) => api2.create.paragraph(input, options),
@@ -57958,6 +57983,9 @@ function createDocumentApi(adapters) {
         },
         clearDirection(input, options) {
           return executeParagraphsClearDirection(adapters.paragraphs, input, options);
+        },
+        setNumbering(input, options) {
+          return executeParagraphsSetNumbering(adapters.paragraphs, input, options);
         }
       }
     },
@@ -90857,8 +90885,13 @@ function buildFallbackBlockNodeId(nodeType, pos, path2) {
 }
 function isListItem(attrs) {
   const numbering = attrs?.paragraphProperties?.numberingProperties;
-  if (numbering && (numbering.numId != null || numbering.ilvl != null))
-    return true;
+  if (numbering) {
+    const numId = toFiniteNumber(numbering.numId);
+    if (numId != null && numId !== 0)
+      return true;
+    if (numId == null && numbering.ilvl != null)
+      return true;
+  }
   const listRendering = attrs?.listRendering;
   if (listRendering?.markerText)
     return true;
@@ -98874,7 +98907,7 @@ var isRegExp = (value) => {
   tracked: false,
   carrier: runAttributeCarrier(runPropertyKey ?? key),
   schema
-}), INLINE_PROPERTY_REGISTRY, INLINE_PROPERTY_KEY_SET, INLINE_PROPERTY_BY_KEY, UNDERLINE_OBJECT_ALLOWED_KEYS, SHADING_ALLOWED_KEYS, BORDER_ALLOWED_KEYS, FIT_TEXT_ALLOWED_KEYS, LANG_ALLOWED_KEYS, RFONTS_ALLOWED_KEYS, EAST_ASIAN_LAYOUT_ALLOWED_KEYS, STYLISTIC_SET_ALLOWED_KEYS, VERT_ALIGN_VALUES, PROPERTY_VALIDATOR_MAP, TABLE_COLOR_PATTERN, PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, PARAGRAPH_BLOCK_TYPES, SET_STYLE_KEYS, CLEAR_STYLE_KEYS, RESET_DIRECT_FORMATTING_KEYS, SET_ALIGNMENT_KEYS, CLEAR_ALIGNMENT_KEYS, SET_INDENTATION_KEYS, CLEAR_INDENTATION_KEYS, SET_SPACING_KEYS, CLEAR_SPACING_KEYS, SET_KEEP_OPTIONS_KEYS, SET_OUTLINE_LEVEL_KEYS, SET_FLOW_OPTIONS_KEYS, SET_TAB_STOP_KEYS, CLEAR_TAB_STOP_KEYS, CLEAR_ALL_TAB_STOPS_KEYS, SET_BORDER_KEYS, CLEAR_BORDER_KEYS, SET_SHADING_KEYS, CLEAR_SHADING_KEYS, SET_MARK_RUN_PROPS_KEYS, MARK_RUN_PROPS_FIELD_KEYS, MARK_RUN_COLOR_REF_KEYS, MARK_RUN_FONTS_KEYS, MARK_RUN_LANG_KEYS, MARK_RUN_UNDERLINE_KEYS, MARK_RUN_SHADING_KEYS, MARK_RUN_BORDER_KEYS, MARK_RUN_COLOR_MODE_VALUES, MARK_RUN_VERTICAL_ALIGN_VALUES, SET_DIRECTION_KEYS, CLEAR_DIRECTION_KEYS, ST_ON_OFF_ON_VALUES, ST_ON_OFF_OFF_VALUES, ST_UNDERLINE_VALUES, ST_UNDERLINE_VALUE_SET, ST_VERTICAL_ALIGN_RUN, ST_EM, ST_TEXT_ALIGNMENT, ST_TEXT_DIRECTION, ST_TEXTBOX_TIGHT_WRAP, ST_TEXT_TRANSFORM, ST_JUSTIFICATION, FONT_FAMILY_SCHEMA, COLOR_SCHEMA, SPACING_SCHEMA, INDENT_SCHEMA, UNDERLINE_SCHEMA, BORDER_PROPERTIES_SCHEMA, SHADING_SCHEMA, LANG_SCHEMA, EAST_ASIAN_LAYOUT_SCHEMA, FIT_TEXT_SCHEMA, NUMBERING_PROPERTIES_SCHEMA, FRAME_PR_SCHEMA, PARAGRAPH_BORDERS_SCHEMA, TAB_STOP_SCHEMA, PROPERTY_REGISTRY, ALLOWED_KEYS_BY_CHANNEL, PROPERTY_INDEX, EXCLUDED_KEYS, INPUT_ALLOWED_KEYS, TARGET_ALLOWED_KEYS, OPTIONS_ALLOWED_KEYS, VALID_CHANNELS, Z_ORDER_RELATIVE_HEIGHT_MAX = 4294967295, CAPABILITY_REASON_CODES, VALID_EDGE_VALUES, VALID_EDGE_NODE_TYPES, VALID_DOCUMENT_EDGES, VALID_REF_BOUNDARIES, VALID_ANCHOR_KINDS, RESOLVE_RANGE_ALLOWED_KEYS, SELECTION_CURRENT_ALLOWED_KEYS, CREATE_COMMENT_ALLOWED_KEYS, TRACKED_CHANGE_COMMENT_TARGET_ALLOWED_KEYS, TEXT_SEARCH_COMMENT_TARGET_ALLOWED_KEYS, PATCH_COMMENT_ALLOWED_KEYS, STYLE_APPLY_INPUT_ALLOWED_KEYS, INLINE_ALIAS_INPUT_ALLOWED_KEYS, DELETE_INPUT_ALLOWED_KEYS, VALID_BEHAVIORS, CONTENT_KIND_SET, INLINE_KIND_SET, LEGACY_TOP_LEVEL_TYPES, TEXT_INSERT_ALLOWED_KEYS, STRUCTURAL_INSERT_ALLOWED_KEYS, VALID_INSERT_TYPES, LIST_KINDS, LIST_INSERT_POSITIONS, JOIN_DIRECTIONS, MUTATION_SCOPES, LEVEL_ALIGNMENTS, TRAILING_CHARACTERS, LIST_PRESET_IDS, VALID_BLOCK_NODE_TYPES$1, VALID_LIST_KINDS, VALID_INSERT_POSITIONS, VALID_JOIN_DIRECTIONS, VALID_MUTATION_SCOPES, VALID_LEVEL_ALIGNMENTS, VALID_TRAILING_CHARACTERS, VALID_LIST_PRESETS, VALID_CONTINUITY_VALUES, VALID_SEQUENCE_MODES, VALID_LIST_CREATE_MODES, VALID_V2_LIST_BLOCK_NODE_TYPES, TEXT_REPLACE_ALLOWED_KEYS, STRUCTURAL_REPLACE_ALLOWED_KEYS, VALID_HEADING_LEVELS, SECTION_BREAK_TYPES$1, SECTION_BREAK_REPRESENTATIONS, SUPPORTED_DELETE_NODE_TYPES, REJECTED_DELETE_NODE_TYPES, VALID_BLOCK_NODE_TYPES, BODY_STORY_LOCATOR, PARAGRAPH_SHAPE_TYPES, PLAN_EXECUTE_UNSUPPORTED_OPERATION_IDS, SNAPSHOT_VERSIONS, PAYLOAD_VERSIONS, VALID_STYLE_OPTION_FLAGS, VALID_APPLY_TO_VALUES, VALID_BORDER_EDGE_KEYS, HEADER_FOOTER_KINDS$1, HEADER_FOOTER_VARIANTS$1, DEFAULT_SECTIONS_LIST_LIMIT = 250, SECTION_BREAK_TYPES, SECTION_ORIENTATIONS, SECTION_VERTICAL_ALIGNS, SECTION_DIRECTIONS, HEADER_FOOTER_KINDS, HEADER_FOOTER_VARIANTS, LINE_NUMBER_RESTARTS, PAGE_NUMBER_FORMATS, PAGE_NUMBER_CHAPTER_SEPARATORS, PAGE_BORDER_DISPLAYS, PAGE_BORDER_OFFSET_FROM_VALUES, PAGE_BORDER_Z_ORDER_VALUES, VALID_WRAP_TYPES, VALID_WRAP_SIDES, VALID_IMAGE_SIZE_UNITS, VALID_TOC_UPDATE_MODES, EDIT_ENTRY_PATCH_ALLOWED_KEYS, PATCH_FIELDS, CONTENT_CONTROL_TYPES, LOCK_MODES, CONTENT_CONTROL_APPEARANCES, VALID_NODE_KINDS, VALID_LOCK_MODES$1, VALID_CC_TYPES, VALID_CC_APPEARANCES, VALID_CONTENT_FORMATS, VALID_RAW_PATCH_OPS, VALID_SET_MODES, VALID_CREATE_LOCATION_KINDS, DEFAULT_PROTECTION_STATE, ADAPTER_GATED_PREFIXES, _buffers, _defaultCollectionId = null, _nextCollectionId = 1, generateV2HandlerEntity = (handlerName, translator$220) => ({
+}), INLINE_PROPERTY_REGISTRY, INLINE_PROPERTY_KEY_SET, INLINE_PROPERTY_BY_KEY, UNDERLINE_OBJECT_ALLOWED_KEYS, SHADING_ALLOWED_KEYS, BORDER_ALLOWED_KEYS, FIT_TEXT_ALLOWED_KEYS, LANG_ALLOWED_KEYS, RFONTS_ALLOWED_KEYS, EAST_ASIAN_LAYOUT_ALLOWED_KEYS, STYLISTIC_SET_ALLOWED_KEYS, VERT_ALIGN_VALUES, PROPERTY_VALIDATOR_MAP, TABLE_COLOR_PATTERN, PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, PARAGRAPH_BLOCK_TYPES, SET_STYLE_KEYS, CLEAR_STYLE_KEYS, RESET_DIRECT_FORMATTING_KEYS, SET_ALIGNMENT_KEYS, CLEAR_ALIGNMENT_KEYS, SET_INDENTATION_KEYS, CLEAR_INDENTATION_KEYS, SET_SPACING_KEYS, CLEAR_SPACING_KEYS, SET_KEEP_OPTIONS_KEYS, SET_OUTLINE_LEVEL_KEYS, SET_FLOW_OPTIONS_KEYS, SET_TAB_STOP_KEYS, CLEAR_TAB_STOP_KEYS, CLEAR_ALL_TAB_STOPS_KEYS, SET_BORDER_KEYS, CLEAR_BORDER_KEYS, SET_SHADING_KEYS, CLEAR_SHADING_KEYS, SET_MARK_RUN_PROPS_KEYS, MARK_RUN_PROPS_FIELD_KEYS, MARK_RUN_COLOR_REF_KEYS, MARK_RUN_FONTS_KEYS, MARK_RUN_LANG_KEYS, MARK_RUN_UNDERLINE_KEYS, MARK_RUN_SHADING_KEYS, MARK_RUN_BORDER_KEYS, MARK_RUN_COLOR_MODE_VALUES, MARK_RUN_VERTICAL_ALIGN_VALUES, SET_DIRECTION_KEYS, SET_NUMBERING_KEYS, CLEAR_DIRECTION_KEYS, ST_ON_OFF_ON_VALUES, ST_ON_OFF_OFF_VALUES, ST_UNDERLINE_VALUES, ST_UNDERLINE_VALUE_SET, ST_VERTICAL_ALIGN_RUN, ST_EM, ST_TEXT_ALIGNMENT, ST_TEXT_DIRECTION, ST_TEXTBOX_TIGHT_WRAP, ST_TEXT_TRANSFORM, ST_JUSTIFICATION, FONT_FAMILY_SCHEMA, COLOR_SCHEMA, SPACING_SCHEMA, INDENT_SCHEMA, UNDERLINE_SCHEMA, BORDER_PROPERTIES_SCHEMA, SHADING_SCHEMA, LANG_SCHEMA, EAST_ASIAN_LAYOUT_SCHEMA, FIT_TEXT_SCHEMA, NUMBERING_PROPERTIES_SCHEMA, FRAME_PR_SCHEMA, PARAGRAPH_BORDERS_SCHEMA, TAB_STOP_SCHEMA, PROPERTY_REGISTRY, ALLOWED_KEYS_BY_CHANNEL, PROPERTY_INDEX, EXCLUDED_KEYS, INPUT_ALLOWED_KEYS, TARGET_ALLOWED_KEYS, OPTIONS_ALLOWED_KEYS, VALID_CHANNELS, Z_ORDER_RELATIVE_HEIGHT_MAX = 4294967295, CAPABILITY_REASON_CODES, VALID_EDGE_VALUES, VALID_EDGE_NODE_TYPES, VALID_DOCUMENT_EDGES, VALID_REF_BOUNDARIES, VALID_ANCHOR_KINDS, RESOLVE_RANGE_ALLOWED_KEYS, SELECTION_CURRENT_ALLOWED_KEYS, CREATE_COMMENT_ALLOWED_KEYS, TRACKED_CHANGE_COMMENT_TARGET_ALLOWED_KEYS, TEXT_SEARCH_COMMENT_TARGET_ALLOWED_KEYS, PATCH_COMMENT_ALLOWED_KEYS, STYLE_APPLY_INPUT_ALLOWED_KEYS, INLINE_ALIAS_INPUT_ALLOWED_KEYS, DELETE_INPUT_ALLOWED_KEYS, VALID_BEHAVIORS, CONTENT_KIND_SET, INLINE_KIND_SET, LEGACY_TOP_LEVEL_TYPES, TEXT_INSERT_ALLOWED_KEYS, STRUCTURAL_INSERT_ALLOWED_KEYS, VALID_INSERT_TYPES, LIST_KINDS, LIST_INSERT_POSITIONS, JOIN_DIRECTIONS, MUTATION_SCOPES, LEVEL_ALIGNMENTS, TRAILING_CHARACTERS, LIST_PRESET_IDS, VALID_BLOCK_NODE_TYPES$1, VALID_LIST_KINDS, VALID_INSERT_POSITIONS, VALID_JOIN_DIRECTIONS, VALID_MUTATION_SCOPES, VALID_LEVEL_ALIGNMENTS, VALID_TRAILING_CHARACTERS, VALID_LIST_PRESETS, VALID_CONTINUITY_VALUES, VALID_SEQUENCE_MODES, VALID_LIST_CREATE_MODES, VALID_V2_LIST_BLOCK_NODE_TYPES, TEXT_REPLACE_ALLOWED_KEYS, STRUCTURAL_REPLACE_ALLOWED_KEYS, VALID_HEADING_LEVELS, SECTION_BREAK_TYPES$1, SECTION_BREAK_REPRESENTATIONS, SUPPORTED_DELETE_NODE_TYPES, REJECTED_DELETE_NODE_TYPES, VALID_BLOCK_NODE_TYPES, BODY_STORY_LOCATOR, PARAGRAPH_SHAPE_TYPES, PLAN_EXECUTE_UNSUPPORTED_OPERATION_IDS, SNAPSHOT_VERSIONS, PAYLOAD_VERSIONS, VALID_STYLE_OPTION_FLAGS, VALID_APPLY_TO_VALUES, VALID_BORDER_EDGE_KEYS, HEADER_FOOTER_KINDS$1, HEADER_FOOTER_VARIANTS$1, DEFAULT_SECTIONS_LIST_LIMIT = 250, SECTION_BREAK_TYPES, SECTION_ORIENTATIONS, SECTION_VERTICAL_ALIGNS, SECTION_DIRECTIONS, HEADER_FOOTER_KINDS, HEADER_FOOTER_VARIANTS, LINE_NUMBER_RESTARTS, PAGE_NUMBER_FORMATS, PAGE_NUMBER_CHAPTER_SEPARATORS, PAGE_BORDER_DISPLAYS, PAGE_BORDER_OFFSET_FROM_VALUES, PAGE_BORDER_Z_ORDER_VALUES, VALID_WRAP_TYPES, VALID_WRAP_SIDES, VALID_IMAGE_SIZE_UNITS, VALID_TOC_UPDATE_MODES, EDIT_ENTRY_PATCH_ALLOWED_KEYS, PATCH_FIELDS, CONTENT_CONTROL_TYPES, LOCK_MODES, CONTENT_CONTROL_APPEARANCES, VALID_NODE_KINDS, VALID_LOCK_MODES$1, VALID_CC_TYPES, VALID_CC_APPEARANCES, VALID_CONTENT_FORMATS, VALID_RAW_PATCH_OPS, VALID_SET_MODES, VALID_CREATE_LOCATION_KINDS, DEFAULT_PROTECTION_STATE, ADAPTER_GATED_PREFIXES, _buffers, _defaultCollectionId = null, _nextCollectionId = 1, generateV2HandlerEntity = (handlerName, translator$220) => ({
   handlerName,
   handler: (params) => {
     const { nodes } = params;
@@ -109140,7 +109173,10 @@ var isRegExp = (value) => {
     abstractId
   };
 }, hasListDefinition = (editor, numId, ilvl) => {
-  const { definitions, abstracts } = editor.converter.numbering;
+  const numbering = editor?.converter?.numbering;
+  if (!numbering)
+    return false;
+  const { definitions, abstracts } = numbering;
   const numDef = definitions[numId];
   if (!numDef)
     return false;
@@ -118444,7 +118480,7 @@ Docs: https://docs.superdoc.dev/getting-started/fonts`);
       state.kern = kernNode.attributes["w:val"];
   }
 }, SuperConverter;
-var init_SuperConverter_Bdmhv7BA_es = __esm(() => {
+var init_SuperConverter_DVjSc_AY_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
@@ -121474,6 +121510,11 @@ var init_SuperConverter_Bdmhv7BA_es = __esm(() => {
     "direction",
     "alignmentPolicy"
   ]);
+  SET_NUMBERING_KEYS = new Set([
+    "target",
+    "numId",
+    "level"
+  ]);
   CLEAR_DIRECTION_KEYS = new Set(["target"]);
   ST_ON_OFF_ON_VALUES = new Set([
     "true",
@@ -147448,7 +147489,7 @@ var init_SuperConverter_Bdmhv7BA_es = __esm(() => {
   };
 });
 
-// ../../packages/superdoc/dist/chunks/create-headless-toolbar-VA4azb5D.es.js
+// ../../packages/superdoc/dist/chunks/create-headless-toolbar-DYtdH4mX.es.js
 function parseSizeUnit(val = "0") {
   const length = val.toString() || "0";
   const value = Number.parseFloat(length);
@@ -149336,7 +149377,7 @@ function executeTextSelector(editor, index2, query, diagnostics, options = {}) {
       total: 0
     };
   const search2 = requireEditorCommand(editor.commands?.search, "find (search)");
-  const searchModel = options.searchModel ?? "visible";
+  const searchModel = options.searchModel ?? (selector.includeDeletedText ? "raw" : "visible");
   const textOffsetOptions = { textModel: searchModel };
   pattern.lastIndex = 0;
   const rawResult = search2(pattern, {
@@ -150751,6 +150792,56 @@ function paragraphsSetFlowOptionsWrapper(editor, input, options) {
     return result;
   }, options);
 }
+function numberedSubtype(nodeType) {
+  return nodeType === "heading" ? "heading" : "listItem";
+}
+function buildNumberedTarget(editor, candidate, fallback) {
+  const originalType = candidate.nodeType;
+  const subtype = numberedSubtype(originalType);
+  const withStory = (nodeType, nodeId) => ({
+    kind: "block",
+    nodeType,
+    nodeId,
+    ...fallback.story ? { story: fallback.story } : {}
+  });
+  if (subtype === originalType)
+    return withStory(subtype, candidate.nodeId);
+  const resolved = getBlockIndex(editor).candidates.find((c) => c.pos === candidate.pos);
+  if (resolved && PARAGRAPH_NODE_TYPES.has(resolved.nodeType))
+    return withStory(resolved.nodeType, resolved.nodeId);
+  return fallback;
+}
+function paragraphsSetNumberingWrapper(editor, input, options) {
+  rejectTrackedMode("format.paragraph.setNumbering", options);
+  const candidate = resolveParagraphBlock(editor, input.target);
+  const numId = input.numId;
+  const level = input.level ?? 0;
+  if (!ListHelpers.hasListDefinition(editor, numId, level))
+    throw new DocumentApiAdapterError("INVALID_TARGET", `No numbering definition resolves for numId ${numId} at level ${level}.`, {
+      numId,
+      level
+    });
+  if (options?.dryRun)
+    return successResult(input.target);
+  if (executeDomainCommand(editor, () => {
+    const node2 = editor.state.doc.nodeAt(candidate.pos);
+    if (!node2)
+      return false;
+    const existing = node2.attrs.paragraphProperties?.numberingProperties;
+    if (existing && toFiniteNumber(existing.numId) === numId && (toFiniteNumber(existing.ilvl) ?? 0) === level)
+      return false;
+    const tr = editor.state.tr;
+    updateNumberingProperties({
+      numId,
+      ilvl: level
+    }, node2, candidate.pos, editor, tr);
+    editor.dispatch(tr);
+    clearIndexCache(editor);
+    return true;
+  }, { expectedRevision: options?.expectedRevision }).steps[0]?.effect !== "changed")
+    return noOpResult("format.paragraph.setNumbering");
+  return successResult(buildNumberedTarget(editor, candidate, input.target));
+}
 function paragraphsSetTabStopWrapper(editor, input, options) {
   rejectTrackedMode("format.paragraph.setTabStop", options);
   return mutateParagraphProperties(editor, resolveParagraphBlock(editor, input.target), "format.paragraph.setTabStop", input.target, (pPr) => {
@@ -158141,9 +158232,9 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, MARK_KEYS, STEP_OP_CATALOG_UNFROZEN, PU
     }
   };
 };
-var init_create_headless_toolbar_VA4azb5D_es = __esm(() => {
+var init_create_headless_toolbar_DYtdH4mX_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
-  init_SuperConverter_Bdmhv7BA_es();
+  init_SuperConverter_DVjSc_AY_es();
   init_jszip_C49i9kUs_es();
   init_uuid_B2wVPhPi_es();
   init_constants_D9qj59G2_es();
@@ -213758,7 +213849,7 @@ var init_remark_gfm_DCND_V_3_es = __esm(() => {
   init_remark_gfm_BUJjZJLy_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-C3y2aHWQ.es.js
+// ../../packages/superdoc/dist/chunks/src-DrsB0vrP.es.js
 function deleteProps(obj, propOrProps) {
   const props = typeof propOrProps === "string" ? [propOrProps] : propOrProps;
   const removeNested = (target, pathParts, index2 = 0) => {
@@ -229527,8 +229618,9 @@ function queryMatchAdapter(editor, input2) {
     throw planError("INVALID_INPUT", `limit/offset are not valid when require is "${require$1}"`);
   const isTextSelector = input2.select.type === "text";
   const effectiveResolved = hasStyleCascade && isTextSelector;
+  const { includeDeletedText: _stripped, ...textSelectWithoutDeleted } = isTextSelector ? input2.select : {};
   const result = findLegacyAdapter(storyEditor, {
-    select: input2.select,
+    select: isTextSelector ? textSelectWithoutDeleted : input2.select,
     within: input2.within,
     includeNodes: input2.includeNodes,
     limit: isTextSelector ? undefined : input2.limit,
@@ -235081,6 +235173,19 @@ function resolveBlockFontSizePt(styleCtx, styleId$1) {
     return styleCtx.docDefaultsFontSizeHp / 2;
   return OOXML_DEFAULT_FONT_SIZE_PT;
 }
+function extractBlockNumbering(node2) {
+  const attrs = node2.attrs;
+  const numbering = attrs?.paragraphProperties?.numberingProperties ?? attrs?.numberingProperties;
+  if (!numbering)
+    return;
+  const numId = toFiniteNumber(numbering.numId);
+  if (numId === undefined || numId === 0)
+    return;
+  return {
+    numId,
+    level: toFiniteNumber(numbering.ilvl) ?? 0
+  };
+}
 function extractBlockFormatting(node2, styleCtx) {
   const pProps = node2.attrs.paragraphProperties;
   const styleId$1 = pProps?.styleId ?? null;
@@ -235205,6 +235310,7 @@ function blocksListWrapper(editor, input2) {
     blocks: paged.map((candidate, i3) => {
       const textLength = computeTextContentLength(candidate.node);
       const fullText = input2?.includeText ? extractBlockText$1(candidate.node) : undefined;
+      const numbering = extractBlockNumbering(candidate.node);
       const ref$1 = textLength > 0 ? encodeV4Ref({
         v: 4,
         rev,
@@ -235226,6 +235332,7 @@ function blocksListWrapper(editor, input2) {
         ...fullText !== undefined ? { text: fullText } : {},
         isEmpty: textLength === 0,
         ...extractBlockFormatting(candidate.node, styleCtx),
+        ...numbering ? { paragraphNumbering: numbering } : {},
         ...ref$1 ? { ref: ref$1 } : {}
       };
     }),
@@ -251694,7 +251801,8 @@ function assembleDocumentApiAdapters(editor) {
       clearShading: (input2, options) => paragraphsClearShadingWrapper(editor, input2, options),
       setMarkRunProps: () => capabilityUnavailable("format.paragraph.setMarkRunProps is only available on v2-backed sessions."),
       setDirection: (input2, options) => paragraphsSetDirectionWrapper(editor, input2, options),
-      clearDirection: (input2, options) => paragraphsClearDirectionWrapper(editor, input2, options)
+      clearDirection: (input2, options) => paragraphsClearDirectionWrapper(editor, input2, options),
+      setNumbering: (input2, options) => paragraphsSetNumberingWrapper(editor, input2, options)
     },
     trackChanges: {
       list: (input2) => trackChangesListWrapper(editor, input2),
@@ -288448,32 +288556,39 @@ var Node$13 = class Node$14 {
     const ranges = searchIndex.offsetRangeToDocRanges(indexMatch.start, indexMatch.end);
     if (ranges.length === 0)
       continue;
-    const matchTexts = ranges.map((r$1) => doc$12.textBetween(r$1.from, r$1.to));
-    const matchText = typeof indexMatch.text === "string" ? indexMatch.text : matchTexts.join("");
-    const match$1 = {
+    const matchText = typeof indexMatch.text === "string" ? indexMatch.text : ranges.map((r$1) => doc$12.textBetween(r$1.from, r$1.to)).join("");
+    matches2.push({
       from: ranges[0].from,
       to: ranges[ranges.length - 1].to,
       text: matchText,
       id: v4_default(),
       ranges,
       trackerIds: []
-    };
-    if (positionTracker?.trackMany) {
-      const trackedRanges = ranges.map((range, rangeIndex) => ({
-        from: range.from,
-        to: range.to,
-        spec: {
-          type: SEARCH_POSITION_TRACKER_TYPE,
-          metadata: { rangeIndex }
-        }
-      }));
-      const trackerIds = positionTracker.trackMany(trackedRanges);
-      if (trackerIds.length > 0) {
-        match$1.trackerIds = trackerIds;
-        match$1.id = trackerIds[0];
-      }
+    });
+  }
+  if (positionTracker?.trackMany && matches2.length > 0) {
+    const allTrackedRanges = [];
+    for (const match$1 of matches2)
+      match$1.ranges.forEach((range, rangeIndex) => {
+        allTrackedRanges.push({
+          from: range.from,
+          to: range.to,
+          spec: {
+            type: SEARCH_POSITION_TRACKER_TYPE,
+            metadata: { rangeIndex }
+          }
+        });
+      });
+    const allIds = positionTracker.trackMany(allTrackedRanges);
+    if (allIds.length !== allTrackedRanges.length)
+      throw new Error(`Search position tracker returned ${allIds.length} ids for ${allTrackedRanges.length} ranges; expected one id per range.`);
+    let offset$1 = 0;
+    for (const match$1 of matches2) {
+      const count = match$1.ranges.length;
+      match$1.trackerIds = allIds.slice(offset$1, offset$1 + count);
+      match$1.id = match$1.trackerIds[0];
+      offset$1 += count;
     }
-    matches2.push(match$1);
   }
   return matches2;
 }, resolveMatchSelectionRange = (match$1, positionTracker) => {
@@ -312575,13 +312690,13 @@ menclose::after {
     return;
   console.log(...args$1);
 }, HEADER_FOOTER_INIT_BUDGET_MS = 200, MAX_ZOOM_WARNING_THRESHOLD = 10, MAX_SELECTION_RECTS_PER_USER = 100, SEMANTIC_RESIZE_DEBOUNCE_MS = 120, MIN_SEMANTIC_CONTENT_WIDTH_PX = 1, GLOBAL_PERFORMANCE, PresentationEditor, ICONS, TEXTS, tableActionsOptions, TRACKED_MARK_NAMES;
-var init_src_C3y2aHWQ_es = __esm(() => {
+var init_src_DrsB0vrP_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
-  init_SuperConverter_Bdmhv7BA_es();
+  init_SuperConverter_DVjSc_AY_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
   init_uuid_B2wVPhPi_es();
-  init_create_headless_toolbar_VA4azb5D_es();
+  init_create_headless_toolbar_DYtdH4mX_es();
   init_constants_D9qj59G2_es();
   init_unified_BDuVPlMu_es();
   init_remark_gfm_BUJjZJLy_es();
@@ -313951,6 +314066,21 @@ var init_src_C3y2aHWQ_es = __esm(() => {
       referenceDocPath: "format/paragraph/clear-direction.mdx",
       referenceGroup: "format.paragraph"
     },
+    "format.paragraph.setNumbering": {
+      memberPath: "format.paragraph.setNumbering",
+      description: "Attach numbering (numId + level) to an existing paragraph or heading so it joins a numbered sequence. Numbering is a paragraph property; the node and its style are otherwise unchanged, though any direct paragraph indent is cleared so the numbering level controls indentation. Direct edits only; tracked mode is unsupported.",
+      expectedResult: "Returns a ParagraphMutationResult; reports NO_OP if the block already carries this numbering. On a successful apply, resolution.target reflects the post-mutation address (a numbered plain paragraph re-resolves to listItem; a heading stays a heading); a dryRun returns the input target.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: T_PARAGRAPH_MUTATION
+      }),
+      referenceDocPath: "format/paragraph/set-numbering.mdx",
+      referenceGroup: "format.paragraph"
+    },
     "lists.list": {
       memberPath: "lists.list",
       description: "List all list nodes in the document, optionally filtered by scope.",
@@ -354805,11 +354935,11 @@ function print() { __p += __j.call(arguments, '') }
   ]);
 });
 
-// ../../packages/superdoc/dist/chunks/create-super-doc-ui-Bi5_b_W1.es.js
+// ../../packages/superdoc/dist/chunks/create-super-doc-ui-D8ibpwMt.es.js
 var DEFAULT_TEXT_ALIGN_OPTIONS, DEFAULT_LINE_HEIGHT_OPTIONS, DEFAULT_ZOOM_OPTIONS, DEFAULT_DOCUMENT_MODE_OPTIONS, DEFAULT_FONT_SIZE_OPTIONS, headlessToolbarConstants, MOD_ALIASES, ALT_ALIASES, CTRL_ALIASES, SHIFT_ALIASES, BUILTIN_CONTEXT_MENU_GROUPS, BUILTIN_GROUP_ORDER, RESERVED_PROXY_PROPERTY_NAMES, ALL_TOOLBAR_COMMAND_IDS, EMPTY_ACTIVE_IDS, FONT_SIZE_OPTIONS;
-var init_create_super_doc_ui_Bi5_b_W1_es = __esm(() => {
-  init_SuperConverter_Bdmhv7BA_es();
-  init_create_headless_toolbar_VA4azb5D_es();
+var init_create_super_doc_ui_D8ibpwMt_es = __esm(() => {
+  init_SuperConverter_DVjSc_AY_es();
+  init_create_headless_toolbar_DYtdH4mX_es();
   DEFAULT_TEXT_ALIGN_OPTIONS = [
     {
       label: "Left",
@@ -355100,15 +355230,15 @@ var init_zipper_BxRAi0_5_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_C3y2aHWQ_es();
-  init_SuperConverter_Bdmhv7BA_es();
+  init_src_DrsB0vrP_es();
+  init_SuperConverter_DVjSc_AY_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
-  init_create_headless_toolbar_VA4azb5D_es();
+  init_create_headless_toolbar_DYtdH4mX_es();
   init_constants_D9qj59G2_es();
   init_unified_BDuVPlMu_es();
   init_DocxZipper_BzS208BW_es();
-  init_create_super_doc_ui_Bi5_b_W1_es();
+  init_create_super_doc_ui_D8ibpwMt_es();
   init_ui_CGB3qmy3_es();
   init_eventemitter3_UwU_CLPU_es();
   init_errors_C_DoKMoN_es();
@@ -355306,8 +355436,13 @@ var init_block_identity_renaming = __esm(() => {
 // ../../packages/super-editor/src/editors/v1/document-api-adapters/helpers/node-address-resolver.ts
 function isListItem3(attrs) {
   const numbering = attrs?.paragraphProperties?.numberingProperties;
-  if (numbering && (numbering.numId != null || numbering.ilvl != null))
-    return true;
+  if (numbering) {
+    const numId = toFiniteNumber2(numbering.numId);
+    if (numId != null && numId !== 0)
+      return true;
+    if (numId == null && numbering.ilvl != null)
+      return true;
+  }
   const listRendering = attrs?.listRendering;
   if (listRendering?.markerText)
     return true;
@@ -358336,6 +358471,21 @@ More content with **bold** and *italic*.`
       referenceDocPath: "format/paragraph/clear-direction.mdx",
       referenceGroup: "format.paragraph"
     },
+    "format.paragraph.setNumbering": {
+      memberPath: "format.paragraph.setNumbering",
+      description: "Attach numbering (numId + level) to an existing paragraph or heading so it joins a numbered sequence. Numbering is a paragraph property; the node and its style are otherwise unchanged, though any direct paragraph indent is cleared so the numbering level controls indentation. Direct edits only; tracked mode is unsupported.",
+      expectedResult: "Returns a ParagraphMutationResult; reports NO_OP if the block already carries this numbering. On a successful apply, resolution.target reflects the post-mutation address (a numbered plain paragraph re-resolves to listItem; a heading stays a heading); a dryRun returns the input target.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: T_PARAGRAPH_MUTATION2
+      }),
+      referenceDocPath: "format/paragraph/set-numbering.mdx",
+      referenceGroup: "format.paragraph"
+    },
     "lists.list": {
       memberPath: "lists.list",
       description: "List all list nodes in the document, optionally filtered by scope.",
@@ -363330,6 +363480,23 @@ function validateClearDirection2(input2) {
   assertParagraphTarget2(input2, "format.paragraph.clearDirection");
   assertNoUnknownFields2(input2, CLEAR_DIRECTION_KEYS2, "format.paragraph.clearDirection");
 }
+function validateSetNumbering2(input2) {
+  const op = "format.paragraph.setNumbering";
+  assertParagraphTarget2(input2, op);
+  assertNoUnknownFields2(input2, SET_NUMBERING_KEYS2, op);
+  const rec = input2;
+  if (rec.numId === undefined) {
+    throw new DocumentApiValidationError3("INVALID_INPUT", `${op} requires a numId field.`);
+  }
+  if (typeof rec.numId !== "number" || !Number.isInteger(rec.numId) || rec.numId < 1) {
+    throw new DocumentApiValidationError3("INVALID_INPUT", `${op} numId must be a positive integer (numId 0 is the no-numbering sentinel). Got ${JSON.stringify(rec.numId)}.`, { field: "numId", value: rec.numId });
+  }
+  if (rec.level !== undefined) {
+    if (typeof rec.level !== "number" || !Number.isInteger(rec.level) || rec.level < 0 || rec.level > 8) {
+      throw new DocumentApiValidationError3("INVALID_INPUT", `${op} level must be an integer 0-8. Got ${JSON.stringify(rec.level)}.`, { field: "level", value: rec.level });
+    }
+  }
+}
 function executeParagraphsSetStyle2(adapter, input2, options) {
   validateSetStyle2(input2);
   return adapter.setStyle(input2, normalizeMutationOptions2(options));
@@ -363428,7 +363595,11 @@ function executeParagraphsClearDirection2(adapter, input2, options) {
   validateClearDirection2(input2);
   return adapter.clearDirection(input2, normalizeMutationOptions2(options));
 }
-var PARAGRAPH_BLOCK_TYPES2, SET_STYLE_KEYS2, CLEAR_STYLE_KEYS2, RESET_DIRECT_FORMATTING_KEYS2, SET_ALIGNMENT_KEYS2, CLEAR_ALIGNMENT_KEYS2, SET_INDENTATION_KEYS2, CLEAR_INDENTATION_KEYS2, SET_SPACING_KEYS2, CLEAR_SPACING_KEYS2, SET_KEEP_OPTIONS_KEYS2, SET_OUTLINE_LEVEL_KEYS2, SET_FLOW_OPTIONS_KEYS2, SET_TAB_STOP_KEYS2, CLEAR_TAB_STOP_KEYS2, CLEAR_ALL_TAB_STOPS_KEYS2, SET_BORDER_KEYS2, CLEAR_BORDER_KEYS2, SET_SHADING_KEYS2, CLEAR_SHADING_KEYS2, SET_MARK_RUN_PROPS_KEYS2, MARK_RUN_PROPS_FIELD_KEYS2, MARK_RUN_COLOR_REF_KEYS2, MARK_RUN_FONTS_KEYS2, MARK_RUN_LANG_KEYS2, MARK_RUN_UNDERLINE_KEYS2, MARK_RUN_SHADING_KEYS2, MARK_RUN_BORDER_KEYS2, MARK_RUN_COLOR_MODE_VALUES2, MARK_RUN_VERTICAL_ALIGN_VALUES2, SET_DIRECTION_KEYS2, CLEAR_DIRECTION_KEYS2;
+function executeParagraphsSetNumbering2(adapter, input2, options) {
+  validateSetNumbering2(input2);
+  return adapter.setNumbering(input2, normalizeMutationOptions2(options));
+}
+var PARAGRAPH_BLOCK_TYPES2, SET_STYLE_KEYS2, CLEAR_STYLE_KEYS2, RESET_DIRECT_FORMATTING_KEYS2, SET_ALIGNMENT_KEYS2, CLEAR_ALIGNMENT_KEYS2, SET_INDENTATION_KEYS2, CLEAR_INDENTATION_KEYS2, SET_SPACING_KEYS2, CLEAR_SPACING_KEYS2, SET_KEEP_OPTIONS_KEYS2, SET_OUTLINE_LEVEL_KEYS2, SET_FLOW_OPTIONS_KEYS2, SET_TAB_STOP_KEYS2, CLEAR_TAB_STOP_KEYS2, CLEAR_ALL_TAB_STOPS_KEYS2, SET_BORDER_KEYS2, CLEAR_BORDER_KEYS2, SET_SHADING_KEYS2, CLEAR_SHADING_KEYS2, SET_MARK_RUN_PROPS_KEYS2, MARK_RUN_PROPS_FIELD_KEYS2, MARK_RUN_COLOR_REF_KEYS2, MARK_RUN_FONTS_KEYS2, MARK_RUN_LANG_KEYS2, MARK_RUN_UNDERLINE_KEYS2, MARK_RUN_SHADING_KEYS2, MARK_RUN_BORDER_KEYS2, MARK_RUN_COLOR_MODE_VALUES2, MARK_RUN_VERTICAL_ALIGN_VALUES2, SET_DIRECTION_KEYS2, SET_NUMBERING_KEYS2, CLEAR_DIRECTION_KEYS2;
 var init_paragraphs = __esm(() => {
   init_errors5();
   init_validation_primitives();
@@ -363520,6 +363691,7 @@ var init_paragraphs = __esm(() => {
   MARK_RUN_COLOR_MODE_VALUES2 = ["rgb", "theme", "auto"];
   MARK_RUN_VERTICAL_ALIGN_VALUES2 = ["baseline", "superscript", "subscript"];
   SET_DIRECTION_KEYS2 = new Set(["target", "direction", "alignmentPolicy"]);
+  SET_NUMBERING_KEYS2 = new Set(["target", "numId", "level"]);
   CLEAR_DIRECTION_KEYS2 = new Set(["target"]);
 });
 
@@ -364825,7 +364997,7 @@ function refConfigSchemas() {
     failure: refFailureSchema
   };
 }
-var trackChangeTypeValues, nodeTypeValues, blockNodeTypeValues, deletableBlockNodeTypeValues, inlineNodeTypeValues, knownTargetKindValues, SHARED_DEFS, rangeSchema, positionSchema, inlineAnchorSchema, targetKindSchema, textAddressSchema, textTargetSchema, commentTrackedChangeTargetSchema, textSearchCommentTargetSchema, blockNodeAddressSchema, deletableBlockNodeAddressSchema, tableAddressSchema, tableRowAddressSchema, tableCellAddressSchema, tableOrCellAddressSchema, paragraphAddressSchema, headingAddressSchema, listItemAddressSchema, listsV2BlockTargetSchema, paragraphTargetSchema, sectionAddressSchema, inlineNodeAddressSchema, nodeAddressSchema, commentAddressSchema, trackedChangeAddressSchema, entityAddressSchema, selectionTargetSchema, commentTrackedChangeLinkSchema, targetLocatorSchema, deleteBehaviorSchema, resolvedHandleSchema, pageInfoSchema, receiptSuccessSchema, commentsCreateSuccessSchema, textMutationRangeSchema, textMutationResolutionSchema, textMutationSuccessSchema, matchRunSchema, matchBlockSchema, storyLocatorSchema, markRunColorRefSchema, markRunFontsSchema, markRunLanguagesSchema, markRunUnderlineSchema, markRunShadingSchema, markRunBorderSchema, markRunPropsSchema, trackChangeRefSchema, createParagraphSuccessSchema, createHeadingSuccessSchema, headingLevelSchema, listsInsertSuccessSchema, listsMutateItemSuccessSchema, listsExitSuccessSchema, nodeSummarySchema, nodeInfoSchema, matchContextSchema, unknownNodeDiagnosticSchema, textSelectorSchema, nodeSelectorSchema, selectorShorthandSchema, sdTextSelectorSchema, sdNodeSelectorSchema, sdSelectorSchema, sdReadOptionsSchema, sdFindInputSchema, sdNodeResultSchema, sdFindResultSchema, sdMutationResolutionSchema, sdMutationSuccessSchema, documentInfoCountsSchema, documentInfoOutlineItemSchema, documentInfoCapabilitiesSchema, documentStyleInfoSchema, documentStylesSchema, documentDefaultsSchema, documentInfoSchema, listKindSchema, listInsertPositionSchema, listItemInfoSchema, listItemDomainItemSchema, listsListResultSchema, sectionBreakTypeSchema, sectionOrientationSchema, sectionVerticalAlignSchema, sectionDirectionSchema, sectionHeaderFooterKindSchema, sectionHeaderFooterVariantSchema, sectionLineNumberRestartSchema, sectionPageNumberFormatSchema, sectionRangeDomainSchema, sectionPageMarginsSchema, sectionHeaderFooterMarginsSchema, sectionPageSetupSchema, sectionColumnsSchema, sectionLineNumberingSchema, sectionPageNumberingSchema, sectionHeaderFooterRefsSchema, sectionBorderSpecSchema, sectionPageBordersSchema, sectionInfoSchema, sectionResolvedHandleSchema, sectionDomainItemSchema, sectionsListResultSchema, sectionMutationSuccessSchema, documentMutationSuccessSchema, paragraphMutationTargetSchema, paragraphMutationSuccessSchema, createSectionBreakSuccessSchema, commentInfoSchema, commentDomainItemSchema, commentsListResultSchema, trackChangeWordRevisionIdsSchema, trackChangeSourceIdsSchema, trackChangeBroadTypeEnum, trackChangeGroupingEnum, trackChangeCanonicalizationKindEnum, trackChangeAddressKindEnum, trackChangeSourcePlatformEnum, trackChangeReplacementSideSchema, trackChangeReplacementSchema, trackChangeOverlapRelationshipSchema, trackChangeOverlapLayerSchema, trackChangeOverlapInfoSchema, trackChangeFormattingSnapshotSchema, trackChangeTargetSchema, trackChangeSnapshotSchema, trackChangeInfoSchema, trackChangeDomainItemSchema, trackChangesListResultSchema, reviewDecideRangeTargetOptions, historyActionCollaborationSchema, capabilityReasonCodeSchema, capabilityReasonsSchema, capabilityFlagSchema, operationRuntimeCapabilitySchema, operationCapabilitiesSchema, inlinePropertyCapabilitySchema, inlinePropertyCapabilitiesByKeySchema, formatCapabilitiesSchema, planEngineCapabilitiesSchema, capabilitiesOutputSchema, strictEmptyObjectSchema, tableBorderColorPattern, tableBorderSpecSchema, nullableTableBorderSpecSchema, sdFragmentSchema, placementSchema, nestingPolicySchema, insertInputSchema, tableLocatorSchema, cellLocatorSchema, cellOrTableScopedCellLocatorSchema, tableOrCellLocatorSchema, mergeRangeLocatorSchema, tableCreateLocationSchema, tableMutationSuccessSchema, createTableSuccessSchema, tableMutationFailureCodes, tableMutationFailureSchema, tableMutationResultSchema, createTableResultSchema, historyActionSuccessSchema, historyActionFailureSchema, formatInlineAliasOperationSchemas, tocMutationFailureCodes, tocMutationFailureSchema, tocMutationSuccessSchema, tocEntryMutationFailureCodes, tocEntryMutationFailureSchema, tocEntryMutationSuccessSchema, hyperlinkTargetSchema, hyperlinkReadPropertiesSchema, hyperlinkDestinationSchema, hyperlinkSpecSchema, hyperlinkPatchSchema, hyperlinkDomainSchema, hyperlinkMutationSuccessSchema, hyperlinkMutationFailureCodes, hyperlinkMutationFailureSchema, hyperlinkInfoSchema, contentControlTargetSchema, contentControlMutationSuccessSchema, contentControlMutationFailureSchema, ccListResultSchema, ccInfoSchema, refListQueryProperties, refListQuerySchema, discoveryOutputSchema, receiptFailureSchema, refFailureSchema, bookmarkAddressSchema, bookmarkMutation, customXmlPartTargetSchema, customXmlPartMutation, customXmlPartCreateMutation, anchoredMetadataAttachMutation, anchoredMetadataMutation, footnoteAddressSchema, footnoteConfigScopeSchema, footnoteNumberingSchema, footnoteMutation, footnoteConfig, crossRefAddressSchema, crossRefTargetSchema, crossRefDisplaySchema, crossRefMutation, indexAddressSchema, indexEntryAddressSchema, indexConfigSchema, indexEntryDataSchema, indexEntryPatchSchema, indexMutation, indexEntryMutation, captionAddressSchema, captionMutation, captionConfig, fieldAddressSchema, fieldMutation, citationAddressSchema, citationSourceAddressSchema, bibliographyAddressSchema, citationMutation, citationSourceMutation, bibliographyMutation, citationPersonSchema, citationSourceFieldsSchema, tocCreateLocationSchema, authoritiesAddressSchema, authorityEntryAddressSchema, authoritiesConfigSchema, authorityEntryDataSchema, authorityEntryPatchSchema, authoritiesMutation, authorityEntryMutation, diffCoverageSchema, diffSummarySchema, diffSnapshotSchema, diffPayloadSchema, diffApplyResultSchema, operationSchemas;
+var trackChangeTypeValues, nodeTypeValues, blockNodeTypeValues, deletableBlockNodeTypeValues, inlineNodeTypeValues, knownTargetKindValues, SHARED_DEFS, rangeSchema, positionSchema, inlineAnchorSchema, targetKindSchema, textAddressSchema, textTargetSchema, commentTrackedChangeTargetSchema, textSearchCommentTargetSchema, blockNodeAddressSchema, deletableBlockNodeAddressSchema, tableAddressSchema, tableRowAddressSchema, tableCellAddressSchema, tableOrCellAddressSchema, paragraphAddressSchema, headingAddressSchema, listItemAddressSchema, listsV2BlockTargetSchema, paragraphTargetSchema, sectionAddressSchema, inlineNodeAddressSchema, nodeAddressSchema, commentAddressSchema, trackedChangeAddressSchema, entityAddressSchema, selectionTargetSchema, commentTrackedChangeLinkSchema, targetLocatorSchema, deleteBehaviorSchema, resolvedHandleSchema, pageInfoSchema, receiptSuccessSchema, commentsCreateSuccessSchema, textMutationRangeSchema, textMutationResolutionSchema, textMutationSuccessSchema, matchRunSchema, matchBlockSchema, storyLocatorSchema, markRunColorRefSchema, markRunFontsSchema, markRunLanguagesSchema, markRunUnderlineSchema, markRunShadingSchema, markRunBorderSchema, markRunPropsSchema, trackChangeRefSchema, createParagraphSuccessSchema, createHeadingSuccessSchema, headingLevelSchema, listsInsertSuccessSchema, listsMutateItemSuccessSchema, listsExitSuccessSchema, nodeSummarySchema, nodeInfoSchema, matchContextSchema, unknownNodeDiagnosticSchema, textSelectorSchema, planTextSelectorSchema, nodeSelectorSchema, selectorShorthandSchema, sdTextSelectorSchema, sdNodeSelectorSchema, sdSelectorSchema, sdReadOptionsSchema, sdFindInputSchema, sdNodeResultSchema, sdFindResultSchema, sdMutationResolutionSchema, sdMutationSuccessSchema, documentInfoCountsSchema, documentInfoOutlineItemSchema, documentInfoCapabilitiesSchema, documentStyleInfoSchema, documentStylesSchema, documentDefaultsSchema, documentInfoSchema, listKindSchema, listInsertPositionSchema, listItemInfoSchema, listItemDomainItemSchema, listsListResultSchema, sectionBreakTypeSchema, sectionOrientationSchema, sectionVerticalAlignSchema, sectionDirectionSchema, sectionHeaderFooterKindSchema, sectionHeaderFooterVariantSchema, sectionLineNumberRestartSchema, sectionPageNumberFormatSchema, sectionRangeDomainSchema, sectionPageMarginsSchema, sectionHeaderFooterMarginsSchema, sectionPageSetupSchema, sectionColumnsSchema, sectionLineNumberingSchema, sectionPageNumberingSchema, sectionHeaderFooterRefsSchema, sectionBorderSpecSchema, sectionPageBordersSchema, sectionInfoSchema, sectionResolvedHandleSchema, sectionDomainItemSchema, sectionsListResultSchema, sectionMutationSuccessSchema, documentMutationSuccessSchema, paragraphMutationTargetSchema, paragraphMutationSuccessSchema, createSectionBreakSuccessSchema, commentInfoSchema, commentDomainItemSchema, commentsListResultSchema, trackChangeWordRevisionIdsSchema, trackChangeSourceIdsSchema, trackChangeBroadTypeEnum, trackChangeGroupingEnum, trackChangeCanonicalizationKindEnum, trackChangeAddressKindEnum, trackChangeSourcePlatformEnum, trackChangeReplacementSideSchema, trackChangeReplacementSchema, trackChangeOverlapRelationshipSchema, trackChangeOverlapLayerSchema, trackChangeOverlapInfoSchema, trackChangeFormattingSnapshotSchema, trackChangeTargetSchema, trackChangeSnapshotSchema, trackChangeInfoSchema, trackChangeDomainItemSchema, trackChangesListResultSchema, reviewDecideRangeTargetOptions, historyActionCollaborationSchema, capabilityReasonCodeSchema, capabilityReasonsSchema, capabilityFlagSchema, operationRuntimeCapabilitySchema, operationCapabilitiesSchema, inlinePropertyCapabilitySchema, inlinePropertyCapabilitiesByKeySchema, formatCapabilitiesSchema, planEngineCapabilitiesSchema, capabilitiesOutputSchema, strictEmptyObjectSchema, tableBorderColorPattern, tableBorderSpecSchema, nullableTableBorderSpecSchema, sdFragmentSchema, placementSchema, nestingPolicySchema, insertInputSchema, tableLocatorSchema, cellLocatorSchema, cellOrTableScopedCellLocatorSchema, tableOrCellLocatorSchema, mergeRangeLocatorSchema, tableCreateLocationSchema, tableMutationSuccessSchema, createTableSuccessSchema, tableMutationFailureCodes, tableMutationFailureSchema, tableMutationResultSchema, createTableResultSchema, historyActionSuccessSchema, historyActionFailureSchema, formatInlineAliasOperationSchemas, tocMutationFailureCodes, tocMutationFailureSchema, tocMutationSuccessSchema, tocEntryMutationFailureCodes, tocEntryMutationFailureSchema, tocEntryMutationSuccessSchema, hyperlinkTargetSchema, hyperlinkReadPropertiesSchema, hyperlinkDestinationSchema, hyperlinkSpecSchema, hyperlinkPatchSchema, hyperlinkDomainSchema, hyperlinkMutationSuccessSchema, hyperlinkMutationFailureCodes, hyperlinkMutationFailureSchema, hyperlinkInfoSchema, contentControlTargetSchema, contentControlMutationSuccessSchema, contentControlMutationFailureSchema, ccListResultSchema, ccInfoSchema, refListQueryProperties, refListQuerySchema, discoveryOutputSchema, receiptFailureSchema, refFailureSchema, bookmarkAddressSchema, bookmarkMutation, customXmlPartTargetSchema, customXmlPartMutation, customXmlPartCreateMutation, anchoredMetadataAttachMutation, anchoredMetadataMutation, footnoteAddressSchema, footnoteConfigScopeSchema, footnoteNumberingSchema, footnoteMutation, footnoteConfig, crossRefAddressSchema, crossRefTargetSchema, crossRefDisplaySchema, crossRefMutation, indexAddressSchema, indexEntryAddressSchema, indexConfigSchema, indexEntryDataSchema, indexEntryPatchSchema, indexMutation, indexEntryMutation, captionAddressSchema, captionMutation, captionConfig, fieldAddressSchema, fieldMutation, citationAddressSchema, citationSourceAddressSchema, bibliographyAddressSchema, citationMutation, citationSourceMutation, bibliographyMutation, citationPersonSchema, citationSourceFieldsSchema, tocCreateLocationSchema, authoritiesAddressSchema, authorityEntryAddressSchema, authoritiesConfigSchema, authorityEntryDataSchema, authorityEntryPatchSchema, authoritiesMutation, authorityEntryMutation, diffCoverageSchema, diffSummarySchema, diffSnapshotSchema, diffPayloadSchema, diffApplyResultSchema, operationSchemas;
 var init_schemas4 = __esm(() => {
   init_command_catalog();
   init_types4();
@@ -365431,6 +365603,20 @@ var init_schemas4 = __esm(() => {
     hint: { type: "string" }
   }, ["message"]);
   textSelectorSchema = objectSchema({
+    type: { const: "text", description: "Must be 'text' for text pattern search." },
+    pattern: {
+      type: "string",
+      description: "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
+    },
+    mode: {
+      enum: ["contains", "regex"],
+      description: "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
+    },
+    caseSensitive: { type: "boolean", description: "Case-sensitive matching. Default: false." },
+    wholeWord: { type: "boolean", description: "Require word-boundary matches. Default: false." },
+    includeDeletedText: { type: "boolean", description: "When true, includes text from pending tracked deletions. Default: false." }
+  }, ["type", "pattern"]);
+  planTextSelectorSchema = objectSchema({
     type: { const: "text", description: "Must be 'text' for text pattern search." },
     pattern: {
       type: "string",
@@ -365459,7 +365645,8 @@ var init_schemas4 = __esm(() => {
     pattern: { type: "string" },
     mode: { enum: ["contains", "regex"] },
     caseSensitive: { type: "boolean" },
-    wholeWord: { type: "boolean" }
+    wholeWord: { type: "boolean" },
+    includeDeletedText: { type: "boolean" }
   }, ["type", "pattern"]);
   sdNodeSelectorSchema = objectSchema({
     type: { const: "node" },
@@ -366916,6 +367103,15 @@ var init_schemas4 = __esm(() => {
             color: { type: "string", description: "Text color when explicitly set (e.g. '#000000')." },
             alignment: { type: "string", description: "Paragraph alignment." },
             headingLevel: { type: "number", description: "Heading level (1-6)." },
+            paragraphNumbering: {
+              type: "object",
+              description: "Numbering reference (numId + level) for numbered blocks, including numbered headings. Absent for non-numbered blocks.",
+              properties: {
+                numId: { type: "number" },
+                level: { type: "number" }
+              },
+              additionalProperties: false
+            },
             ref: {
               type: "string",
               description: "Ref handle for this block. Pass directly to superdoc_format or superdoc_edit ref param. Only present for non-empty blocks."
@@ -367305,6 +367501,16 @@ var init_schemas4 = __esm(() => {
       success: paragraphMutationSuccessSchema,
       failure: paragraphMutationFailureSchemaFor("format.paragraph.clearDirection")
     },
+    "format.paragraph.setNumbering": {
+      input: objectSchema({
+        target: paragraphTargetSchema,
+        numId: { type: "integer", minimum: 1 },
+        level: { type: "integer", minimum: 0, maximum: 8 }
+      }, ["target", "numId"]),
+      output: paragraphMutationResultSchemaFor("format.paragraph.setNumbering"),
+      success: paragraphMutationSuccessSchema,
+      failure: paragraphMutationFailureSchemaFor("format.paragraph.setNumbering")
+    },
     "styles.apply": (() => {
       const runInputSchema = objectSchema({
         target: objectSchema({ scope: { const: "docDefaults" }, channel: { const: "run" } }, ["scope", "channel"]),
@@ -368473,7 +368679,12 @@ var init_schemas4 = __esm(() => {
         commentId: { type: "string" },
         text: { type: "string", description: "Updated comment text." },
         target: {
-          oneOf: [textAddressSchema, selectionTargetSchema, commentTrackedChangeTargetSchema, textSearchCommentTargetSchema],
+          oneOf: [
+            textAddressSchema,
+            selectionTargetSchema,
+            commentTrackedChangeTargetSchema,
+            textSearchCommentTargetSchema
+          ],
           description: "New anchor for the comment. Accepts a plain TextAddress, a SelectionTarget {kind:'selection', start, end}, a TextSearchCommentTarget {text, story?}, or a TrackedChangeCommentTarget, with or without kind, that names a logical tracked-change id as a convenience re-anchor target ."
         },
         status: {
@@ -368617,7 +368828,7 @@ var init_schemas4 = __esm(() => {
         in: storyLocatorSchema,
         select: {
           description: "Search selector. Use {type:'text', pattern:'...'} for text search or {type:'node', nodeType:'paragraph'|'heading'|...} for node search.",
-          oneOf: [textSelectorSchema, nodeSelectorSchema]
+          oneOf: [planTextSelectorSchema, nodeSelectorSchema]
         },
         within: {
           ...blockNodeAddressSchema,
@@ -368659,7 +368870,7 @@ var init_schemas4 = __esm(() => {
     ...(() => {
       const selectWhereSchema = objectSchema({
         by: { const: "select", type: "string" },
-        select: { oneOf: [textSelectorSchema, nodeSelectorSchema] },
+        select: { oneOf: [planTextSelectorSchema, nodeSelectorSchema] },
         within: blockNodeAddressSchema,
         require: { enum: ["first", "exactlyOne", "all"] }
       }, ["by", "select", "require"]);
@@ -368684,7 +368895,7 @@ var init_schemas4 = __esm(() => {
         oneOf: [
           objectSchema({
             by: { const: "select", type: "string" },
-            select: { oneOf: [textSelectorSchema, nodeSelectorSchema] },
+            select: { oneOf: [planTextSelectorSchema, nodeSelectorSchema] },
             within: blockNodeAddressSchema,
             require: { enum: ["first", "exactlyOne"] }
           }, ["by", "select", "require"]),
@@ -368695,7 +368906,7 @@ var init_schemas4 = __esm(() => {
       };
       const assertWhereSchema = objectSchema({
         by: { const: "select", type: "string" },
-        select: { oneOf: [textSelectorSchema, nodeSelectorSchema] },
+        select: { oneOf: [planTextSelectorSchema, nodeSelectorSchema] },
         within: blockNodeAddressSchema
       }, ["by", "select"]);
       const replacementBlockSchema = objectSchema({ text: { type: "string" } }, ["text"]);
@@ -370362,7 +370573,10 @@ var init_schemas4 = __esm(() => {
     "footnotes.insert": {
       input: {
         oneOf: [
-          objectSchema({ at: textTargetSchema, type: { enum: ["footnote", "endnote"] }, content: { type: "string" } }, ["type", "content"]),
+          objectSchema({ at: textTargetSchema, type: { enum: ["footnote", "endnote"] }, content: { type: "string" } }, [
+            "type",
+            "content"
+          ]),
           objectSchema({
             at: textTargetSchema,
             type: { enum: ["footnote", "endnote"] },
@@ -373185,7 +373399,10 @@ function executeListsSetLevelLayout2(adapter, input2, options) {
 }
 function validateV2BlockTarget2(value, field, operationName) {
   if (!isRecord4(value)) {
-    throw new DocumentApiValidationError3("INVALID_TARGET", `${operationName} ${field} must be an object.`, { field, value });
+    throw new DocumentApiValidationError3("INVALID_TARGET", `${operationName} ${field} must be an object.`, {
+      field,
+      value
+    });
   }
   const v = value;
   if (v.kind !== "block") {
@@ -373220,7 +373437,10 @@ function executeListsApply2(adapter, input2, options) {
   validateV2BlockTarget2(input2.target, "target", "lists.apply");
   requireEnum2(input2.seed, "seed", VALID_LIST_KINDS2, "lists.apply");
   if (input2.reuseNumId !== undefined && typeof input2.reuseNumId !== "string") {
-    throw new DocumentApiValidationError3("INVALID_INPUT", "lists.apply reuseNumId must be a string when provided.", { field: "reuseNumId", value: input2.reuseNumId });
+    throw new DocumentApiValidationError3("INVALID_INPUT", "lists.apply reuseNumId must be a string when provided.", {
+      field: "reuseNumId",
+      value: input2.reuseNumId
+    });
   }
   optionalInteger2(input2.ilvl, "ilvl", "lists.apply");
   if (!adapter.apply)
@@ -373711,7 +373931,9 @@ function validateBlockNodeAddressParagraph2(address2, operationLabel, field) {
 }
 function validateBlocksSplitInput2(input2) {
   if (!input2 || typeof input2 !== "object") {
-    throw new DocumentApiValidationError3("INVALID_INPUT", "blocks.split requires an input object.", { fields: ["input"] });
+    throw new DocumentApiValidationError3("INVALID_INPUT", "blocks.split requires an input object.", {
+      fields: ["input"]
+    });
   }
   validateBlockNodeAddressParagraph2(input2.target, "blocks.split", "target");
   if (typeof input2.offset !== "number" || !Number.isInteger(input2.offset) || input2.offset < 0) {
@@ -373720,19 +373942,25 @@ function validateBlocksSplitInput2(input2) {
 }
 function validateBlocksMergeInput2(input2) {
   if (!input2 || typeof input2 !== "object") {
-    throw new DocumentApiValidationError3("INVALID_INPUT", "blocks.merge requires an input object.", { fields: ["input"] });
+    throw new DocumentApiValidationError3("INVALID_INPUT", "blocks.merge requires an input object.", {
+      fields: ["input"]
+    });
   }
   validateBlockNodeAddressParagraph2(input2.first, "blocks.merge", "first");
   validateBlockNodeAddressParagraph2(input2.second, "blocks.merge", "second");
 }
 function validateBlocksMoveInput2(input2) {
   if (!input2 || typeof input2 !== "object") {
-    throw new DocumentApiValidationError3("INVALID_INPUT", "blocks.move requires an input object.", { fields: ["input"] });
+    throw new DocumentApiValidationError3("INVALID_INPUT", "blocks.move requires an input object.", {
+      fields: ["input"]
+    });
   }
   validateBlockNodeAddressParagraph2(input2.source, "blocks.move", "source");
   validateBlockNodeAddressParagraph2(input2.destination, "blocks.move", "destination");
   if (input2.placement !== "before" && input2.placement !== "after") {
-    throw new DocumentApiValidationError3("INVALID_INPUT", 'blocks.move placement must be "before" or "after".', { fields: ["placement"] });
+    throw new DocumentApiValidationError3("INVALID_INPUT", 'blocks.move placement must be "before" or "after".', {
+      fields: ["placement"]
+    });
   }
 }
 function unavailableBlocksResult2(operationName) {
@@ -374164,6 +374392,7 @@ function buildDispatchTable2(api2) {
     "format.paragraph.setMarkRunProps": (input2, options) => api2.format.paragraph.setMarkRunProps(input2, options),
     "format.paragraph.setDirection": (input2, options) => api2.format.paragraph.setDirection(input2, options),
     "format.paragraph.clearDirection": (input2, options) => api2.format.paragraph.clearDirection(input2, options),
+    "format.paragraph.setNumbering": (input2, options) => api2.format.paragraph.setNumbering(input2, options),
     "styles.apply": (input2, options) => api2.styles.apply(input2, options),
     "templates.apply": (input2, options) => api2.templates.apply(input2, options),
     "create.paragraph": (input2, options) => api2.create.paragraph(input2, options),
@@ -374811,10 +375040,7 @@ function createPlanApi2(invoke) {
 var PLAN_EXECUTE_UNSUPPORTED_OPERATION_IDS2;
 var init_plan = __esm(() => {
   init_errors5();
-  PLAN_EXECUTE_UNSUPPORTED_OPERATION_IDS2 = new Set([
-    "plan.execute",
-    "templates.apply"
-  ]);
+  PLAN_EXECUTE_UNSUPPORTED_OPERATION_IDS2 = new Set(["plan.execute", "templates.apply"]);
 });
 
 // ../../packages/document-api/dist/diff/diff.js
@@ -377591,6 +377817,9 @@ function createDocumentApi2(adapters) {
         },
         clearDirection(input2, options) {
           return executeParagraphsClearDirection2(adapters.paragraphs, input2, options);
+        },
+        setNumbering(input2, options) {
+          return executeParagraphsSetNumbering2(adapters.paragraphs, input2, options);
         }
       }
     },
@@ -406935,7 +407164,7 @@ function executeTextSelector2(editor, index2, query2, diagnostics, options = {})
   if (!pattern)
     return { matches: [], total: 0 };
   const search4 = requireEditorCommand2(editor.commands?.search, "find (search)");
-  const searchModel = options.searchModel ?? "visible";
+  const searchModel = options.searchModel ?? (selector.includeDeletedText ? "raw" : "visible");
   const textOffsetOptions = { textModel: searchModel };
   pattern.lastIndex = 0;
   const rawResult = search4(pattern, {
@@ -408072,8 +408301,9 @@ function queryMatchAdapter2(editor, input2) {
   }
   const isTextSelector = input2.select.type === "text";
   const effectiveResolved = hasStyleCascade && isTextSelector;
+  const { includeDeletedText: _stripped, ...textSelectWithoutDeleted } = isTextSelector ? input2.select : {};
   const query2 = {
-    select: input2.select,
+    select: isTextSelector ? textSelectWithoutDeleted : input2.select,
     within: input2.within,
     includeNodes: input2.includeNodes,
     limit: isTextSelector ? undefined : input2.limit,
@@ -471749,7 +471979,10 @@ var generateNewListDefinition3 = ({
     abstractId
   };
 }, hasListDefinition2 = (editor, numId, ilvl) => {
-  const { definitions, abstracts } = editor.converter.numbering;
+  const numbering = editor?.converter?.numbering;
+  if (!numbering)
+    return false;
+  const { definitions, abstracts } = numbering;
   const numDef = definitions[numId];
   if (!numDef)
     return false;
@@ -474081,6 +474314,55 @@ function paragraphsSetFlowOptionsWrapper2(editor, input2, options) {
     return result;
   }, options);
 }
+function numberedSubtype2(nodeType) {
+  return nodeType === "heading" ? "heading" : "listItem";
+}
+function buildNumberedTarget2(editor, candidate, fallback) {
+  const originalType = candidate.nodeType;
+  const subtype = numberedSubtype2(originalType);
+  const withStory = (nodeType, nodeId) => ({
+    kind: "block",
+    nodeType,
+    nodeId,
+    ...fallback.story ? { story: fallback.story } : {}
+  });
+  if (subtype === originalType)
+    return withStory(subtype, candidate.nodeId);
+  const resolved = getBlockIndex2(editor).candidates.find((c) => c.pos === candidate.pos);
+  if (resolved && PARAGRAPH_NODE_TYPES2.has(resolved.nodeType)) {
+    return withStory(resolved.nodeType, resolved.nodeId);
+  }
+  return fallback;
+}
+function paragraphsSetNumberingWrapper2(editor, input2, options) {
+  rejectTrackedMode2("format.paragraph.setNumbering", options);
+  const candidate = resolveParagraphBlock2(editor, input2.target);
+  const numId = input2.numId;
+  const level = input2.level ?? 0;
+  if (!ListHelpers2.hasListDefinition(editor, numId, level)) {
+    throw new DocumentApiAdapterError3("INVALID_TARGET", `No numbering definition resolves for numId ${numId} at level ${level}.`, { numId, level });
+  }
+  if (options?.dryRun)
+    return successResult2(input2.target);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const node4 = editor.state.doc.nodeAt(candidate.pos);
+    if (!node4)
+      return false;
+    const existing = node4.attrs.paragraphProperties?.numberingProperties;
+    if (existing && toFiniteNumber2(existing.numId) === numId && (toFiniteNumber2(existing.ilvl) ?? 0) === level) {
+      return false;
+    }
+    const tr = editor.state.tr;
+    updateNumberingProperties2({ numId, ilvl: level }, node4, candidate.pos, editor, tr);
+    editor.dispatch(tr);
+    clearIndexCache2(editor);
+    return true;
+  }, { expectedRevision: options?.expectedRevision });
+  if (receipt2.steps[0]?.effect !== "changed") {
+    return noOpResult2("format.paragraph.setNumbering");
+  }
+  return successResult2(buildNumberedTarget2(editor, candidate, input2.target));
+}
 function paragraphsSetTabStopWrapper2(editor, input2, options) {
   rejectTrackedMode2("format.paragraph.setTabStop", options);
   const candidate = resolveParagraphBlock2(editor, input2.target);
@@ -474200,6 +474482,8 @@ var init_paragraphs_wrappers = __esm(() => {
   init_mutation_helpers();
   init_plan_wrappers();
   init_resolvedPropertiesCache();
+  init_changeListLevel();
+  init_list_numbering_helpers();
   PARAGRAPH_NODE_TYPES2 = new Set(["paragraph", "heading", "listItem"]);
   DIRECT_FORMATTING_MARK_NAMES2 = new Set([
     "textStyle",
@@ -488677,6 +488961,17 @@ function resolveBlockFontSizePt2(styleCtx, styleId3) {
     return styleCtx.docDefaultsFontSizeHp / 2;
   return OOXML_DEFAULT_FONT_SIZE_PT2;
 }
+function extractBlockNumbering2(node4) {
+  const attrs = node4.attrs;
+  const numbering = attrs?.paragraphProperties?.numberingProperties ?? attrs?.numberingProperties;
+  if (!numbering)
+    return;
+  const numId = toFiniteNumber2(numbering.numId);
+  if (numId === undefined || numId === 0)
+    return;
+  const level = toFiniteNumber2(numbering.ilvl) ?? 0;
+  return { numId, level };
+}
 function extractBlockFormatting2(node4, styleCtx) {
   const pProps = node4.attrs.paragraphProperties;
   const styleId3 = pProps?.styleId ?? null;
@@ -488798,6 +489093,7 @@ function blocksListWrapper2(editor, input2) {
   const blocks2 = paged.map((candidate, i4) => {
     const textLength = computeTextContentLength2(candidate.node);
     const fullText = input2?.includeText ? extractBlockText2(candidate.node) : undefined;
+    const numbering = extractBlockNumbering2(candidate.node);
     const ref3 = textLength > 0 ? encodeV4Ref2({
       v: 4,
       rev,
@@ -488815,6 +489111,7 @@ function blocksListWrapper2(editor, input2) {
       ...fullText !== undefined ? { text: fullText } : {},
       isEmpty: textLength === 0,
       ...extractBlockFormatting2(candidate.node, styleCtx),
+      ...numbering ? { paragraphNumbering: numbering } : {},
       ...ref3 ? { ref: ref3 } : {}
     };
   });
@@ -512365,7 +512662,8 @@ function assembleDocumentApiAdapters2(editor) {
       clearShading: (input2, options) => paragraphsClearShadingWrapper2(editor, input2, options),
       setMarkRunProps: () => capabilityUnavailable("format.paragraph.setMarkRunProps is only available on v2-backed sessions."),
       setDirection: (input2, options) => paragraphsSetDirectionWrapper2(editor, input2, options),
-      clearDirection: (input2, options) => paragraphsClearDirectionWrapper2(editor, input2, options)
+      clearDirection: (input2, options) => paragraphsClearDirectionWrapper2(editor, input2, options),
+      setNumbering: (input2, options) => paragraphsSetNumberingWrapper2(editor, input2, options)
     },
     trackChanges: {
       list: (input2) => trackChangesListWrapper2(editor, input2),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/mcp",
-  "version": "0.12.0-next.36",
+  "version": "0.12.0-next.38",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -19,9 +19,9 @@
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",
     "typescript": "^5.9.2",
-    "@superdoc/document-api": "0.1.0-alpha.0",
     "superdoc": "1.41.0",
-    "@superdoc/super-editor": "0.0.1"
+    "@superdoc/super-editor": "0.0.1",
+    "@superdoc/document-api": "0.1.0-alpha.0"
   },
   "publishConfig": {
     "access": "public"