oasis-editor 0.0.27 → 0.0.29

package/dist/{OasisEditorApp-TgBKJPpl.js → OasisEditorApp-D0fgzHt5.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { n as normalizeSelection, g as getParagraphs, c as createEditorParagraphFromRuns, a as getParagraphLength, b as createEditorRun, d as getDocumentSections, e as createEditorStyledRun, f as getParagraphText, h as getActiveZone, i as getActiveSectionIndex, p as positionToParagraphOffset, j as paragraphOffsetToPosition, k as clampPosition, l as findParagraphIndex, m as createCollapsedSelection, o as isSelectionCollapsed, q as createEditorParagraph, r as getBlockParagraphs, s as findParagraphTableLocation, t as buildTableCellLayout, u as createEditorTableCell, v as createEditorTable, w as createEditorTableRow, x as underlineStyleToCssDecorationStyle, y as resolveImageSrc, z as createEditorFootnote, A as createFootnoteReferenceRun, B as renumberFootnotes, C as iterateFootnoteReferenceRuns, D as getFootnoteDisplayMarker, E as createSignal, F as createEffect, G as onCleanup, H as buildCanvasLayoutSnapshot, I as on, J as onMount, K as debounce, L as unwrap, M as getDocumentParagraphs, N as getDocumentSectionsCanonical, O as createEditorDocument, P as getPageContentWidth, Q as getDocumentPageSettings, R as getTableCellContentWidthForParagraph, S as resolveResizedDimensions, T as resolveTextBoxRenderHeight, U as resolveEffectiveParagraphStyle, V as resolveEffectiveTextStyleForParagraph, W as iterateEndnoteReferenceRuns, X as JSZip, Y as imageContentTypeDefaults, Z as imageExtensionFromMime, _ as pxToPt$1, $ as buildSegmentTable, a0 as buildCanvasTableLayout, a1 as resolveFloatingObjectRect, a2 as getTextBoxFloatingGeometry, a3 as getPresetPathSegments, a4 as projectBlocksLayout, a5 as textStyleToFontSizePt, a6 as PX_PER_POINT, a7 as DEFAULT_FONT_SIZE_PX, a8 as isDoubleUnderlineStyle, a9 as isWavyUnderlineStyle, aa as underlineStyleLineWidthPx, ab as underlineStyleDashArray, ac as getListLabelInset, ad as getParagraphBorderInsets, ae as normalizeFamily, af as ROBOTO_FONT_FILES, ag as loadFontAsset, ah as OFFICE_COMPAT_FONT_FAMILIES, ai as buildSfnt, aj as defaultFontDecoderRegistry, ak as SfntFontProgram, al as collectPdfFontFamilies, am as projectDocumentLayout, an as getPageHeaderZoneTop, ao as getPageBodyTop, ap as getPageColumnRects, aq as findFootnoteReference, ar as FOOTNOTE_MARKER_GUTTER_PX, as as resolveImporterForFile, at as createEditorStateFromDocument, au as getDocumentParagraphsCanonical, av as getToolbarStyleState, aw as STANDARD_FONT_SIZES_PT, ax as fontSizePxToPt, ay as probeLocalFontFamilies, az as createInitialEditorState, aA as parseFontSizePtToPx, aB as formatFontSizePt, aC as listKindForTag, aD as isParagraphTag, aE as collectInlineRuns, aF as parseParagraphStyle, aG as t, aH as preciseFontModeVersion, aI as isPreciseFontModeEnabled, aJ as togglePreciseFontMode, aK as nextFontSizePt, aL as previousFontSizePt, aM as fontSizePtToPx, aN as createDefaultToolbarPreset, aO as defaultMenuItems, aP as MenuRegistry, aQ as createToolbarRegistry, aR as Editor, aS as resolveCommandRef, aT as commandRefName, aU as InlineShell, aV as BalloonShell, aW as DocumentShell, aX as createMemo, aY as getCaretRectFromSnapshot, aZ as getParagraphRectFromSnapshot, a_ as createComponent, a$ as CaretOverlay, b0 as Show, b1 as createRenderEffect, b2 as style, b3 as setAttribute, b4 as setStyleProperty, b5 as memo, b6 as template, b7 as insert, b8 as use, b9 as addEventListener, ba as Dialog, bb as delegateEvents, bc as className, bd as For, be as UNDERLINE_STYLE_OPTIONS, bf as Tabs, bg as measureParagraphMinContentWidthPx, bh as getEditableBlocksForZone, bi as findParagraphLocation, bj as createSectionBoundaryParagraph, bk as normalizePageSettings, bl as DEFAULT_EDITOR_PAGE_SETTINGS, bm as markStart, bn as markEnd, bo as getParagraphEntries, bp as getParagraphById, bq as PluginUiHost, br as OasisEditorEditor, bs as perfTimer, bt as OasisBrandMark, bu as setPreciseFontPreference, bv as setWelcomeSeen, bw as enablePreciseFontMode, bx as createOasisEditorClient, by as setLocale, bz as createEditorZoom, bA as startLongTaskObserver, bB as installGlobalReport, bC as applyStoredPreciseFontPreference, bD as getWelcomeSeen, bE as isLocalFontAccessSupported, bF as EDITOR_SCROLL_PADDING_PX, bG as Toolbar, bH as OasisEditorLoading, bI as createEditorLogger, bJ as getCachedCanvasImage, bK as registerDomStatsSurface } from "./index-BaKkmGAh.js";
+import { n as normalizeSelection, g as getParagraphs, c as createEditorParagraphFromRuns, a as getParagraphLength, b as createEditorRun, d as getDocumentSections, e as createEditorStyledRun, f as getParagraphText, h as getActiveZone, i as getActiveSectionIndex, p as positionToParagraphOffset, j as paragraphOffsetToPosition, k as clampPosition, l as findParagraphIndex, m as createCollapsedSelection, o as isSelectionCollapsed, q as createEditorParagraph, r as getBlockParagraphs, s as findParagraphTableLocation, t as buildTableCellLayout, u as createEditorTableCell, v as createEditorTable, w as createEditorTableRow, x as underlineStyleToCssDecorationStyle, y as resolveImageSrc, z as createEditorFootnote, A as createFootnoteReferenceRun, B as renumberFootnotes, C as iterateFootnoteReferenceRuns, D as getFootnoteDisplayMarker, E as createSignal, F as createEffect, G as onCleanup, H as buildCanvasLayoutSnapshot, I as on, J as onMount, K as debounce, L as unwrap, M as getDocumentParagraphs, N as getDocumentSectionsCanonical, O as createEditorDocument, P as getPageContentWidth, Q as getDocumentPageSettings, R as getTableCellContentWidthForParagraph, S as resolveResizedDimensions, T as resolveTextBoxRenderHeight, U as resolveEffectiveParagraphStyle, V as resolveEffectiveTextStyleForParagraph, W as iterateEndnoteReferenceRuns, X as JSZip, Y as imageContentTypeDefaults, Z as imageExtensionFromMime, _ as pxToPt$1, $ as buildSegmentTable, a0 as buildCanvasTableLayout, a1 as resolveFloatingObjectRect, a2 as getTextBoxFloatingGeometry, a3 as getPresetPathSegments, a4 as projectBlocksLayout, a5 as textStyleToFontSizePt, a6 as PX_PER_POINT, a7 as DEFAULT_FONT_SIZE_PX, a8 as isDoubleUnderlineStyle, a9 as isWavyUnderlineStyle, aa as underlineStyleLineWidthPx, ab as underlineStyleDashArray, ac as getListLabelInset, ad as getParagraphBorderInsets, ae as normalizeFamily, af as ROBOTO_FONT_FILES, ag as loadFontAsset, ah as OFFICE_COMPAT_FONT_FAMILIES, ai as buildSfnt, aj as defaultFontDecoderRegistry, ak as SfntFontProgram, al as collectPdfFontFamilies, am as projectDocumentLayout, an as getPageHeaderZoneTop, ao as getPageBodyTop, ap as getPageColumnRects, aq as findFootnoteReference, ar as FOOTNOTE_MARKER_GUTTER_PX, as as resolveImporterForFile, at as createEditorStateFromDocument, au as getDocumentParagraphsCanonical, av as getToolbarStyleState, aw as STANDARD_FONT_SIZES_PT, ax as fontSizePxToPt, ay as probeLocalFontFamilies, az as createInitialEditorState, aA as parseFontSizePtToPx, aB as formatFontSizePt, aC as listKindForTag, aD as isParagraphTag, aE as collectInlineRuns, aF as parseParagraphStyle, aG as t, aH as getHeadingLevel, aI as preciseFontModeVersion, aJ as isPreciseFontModeEnabled, aK as togglePreciseFontMode, aL as nextFontSizePt, aM as previousFontSizePt, aN as fontSizePtToPx, aO as createDefaultToolbarPreset, aP as defaultMenuItems, aQ as MenuRegistry, aR as createToolbarRegistry, aS as Editor, aT as resolveCommandRef, aU as commandRefName, aV as InlineShell, aW as BalloonShell, aX as DocumentShell, aY as createMemo, aZ as getCaretRectFromSnapshot, a_ as getParagraphRectFromSnapshot, a$ as createComponent, b0 as CaretOverlay, b1 as Show, b2 as createRenderEffect, b3 as style, b4 as setAttribute, b5 as setStyleProperty, b6 as memo, b7 as template, b8 as insert, b9 as use, ba as addEventListener, bb as Dialog, bc as delegateEvents, bd as className, be as For, bf as UNDERLINE_STYLE_OPTIONS, bg as Tabs, bh as measureParagraphMinContentWidthPx, bi as getEditableBlocksForZone, bj as findParagraphLocation, bk as createSectionBoundaryParagraph, bl as normalizePageSettings, bm as DEFAULT_EDITOR_PAGE_SETTINGS, bn as markStart, bo as markEnd, bp as getParagraphEntries, bq as getParagraphById, br as PluginUiHost, bs as OasisEditorEditor, bt as perfTimer, bu as OasisBrandMark, bv as setPreciseFontPreference, bw as setWelcomeSeen, bx as enablePreciseFontMode, by as createOasisEditorClient, bz as setLocale, bA as createEditorZoom, bB as startLongTaskObserver, bC as installGlobalReport, bD as applyStoredPreciseFontPreference, bE as getWelcomeSeen, bF as isLocalFontAccessSupported, bG as EDITOR_SCROLL_PADDING_PX, bH as Toolbar, bI as OasisEditorLoading, bJ as createEditorLogger, bK as getCachedCanvasImage, bL as registerDomStatsSurface } from "./index-CMOt03WH.js";
 function getSelectedObjectRun(state, predicate) {
   const normalized = normalizeSelection(state);
   if (normalized.isCollapsed || normalized.startIndex !== normalized.endIndex || normalized.endParagraphOffset - normalized.startParagraphOffset !== 1) {
@@ -7753,8 +7753,8 @@ const WORD_NS$1 = "http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 const PACKAGE_REL_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
 const OFFICE_REL_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 const WORD14_NS = "http://schemas.microsoft.com/office/word/2010/wordml";
-const TWIPS_PER_INCH = 1440;
-const PX_PER_INCH = 96;
+const TWIPS_PER_INCH$1 = 1440;
+const PX_PER_INCH$1 = 96;
 const TWIPS_PER_POINT = 20;
 function escapeXml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
@@ -7763,19 +7763,19 @@ function pxToTwips(value, fallback) {
   if (!Number.isFinite(value)) {
     return fallback;
   }
-  return Math.max(0, Math.round(value / PX_PER_INCH * TWIPS_PER_INCH));
+  return Math.max(0, Math.round(value / PX_PER_INCH$1 * TWIPS_PER_INCH$1));
 }
 function toTwips(value) {
   if (value === void 0 || value === null || !Number.isFinite(value)) {
     return null;
   }
-  return Math.round(value / PX_PER_INCH * TWIPS_PER_INCH);
+  return Math.round(value / PX_PER_INCH$1 * TWIPS_PER_INCH$1);
 }
 function toHalfPoints(value) {
   if (value === void 0 || value === null || !Number.isFinite(value)) {
     return null;
   }
-  return Math.round(value / PX_PER_INCH * 72 * 2);
+  return Math.round(value / PX_PER_INCH$1 * 72 * 2);
 }
 function pointsToTwips(value) {
   if (value === void 0 || value === null || !Number.isFinite(value)) {
@@ -40911,6 +40911,171 @@ function createEditorContextMenuClipboard(deps) {
     programmaticPaste
   };
 }
+const DEFAULT_TOC_MAX_LEVEL = 3;
+const TOC_INSTRUCTION = ' TOC \\o "1-3" \\h \\z \\u ';
+const PX_TO_PT = 72 / 96;
+const TWIPS_PER_INCH = 1440;
+const PX_PER_INCH = 96;
+const twipsToPx = (twips) => Math.round(twips / TWIPS_PER_INCH * PX_PER_INCH);
+function collectTocHeadings(state, maxLevel = DEFAULT_TOC_MAX_LEVEL) {
+  var _a;
+  const headings = [];
+  for (const paragraph of getDocumentParagraphs(state.document)) {
+    const level = getHeadingLevel((_a = paragraph.style) == null ? void 0 : _a.styleId);
+    if (level === null || level > maxLevel) continue;
+    const text = getParagraphText(paragraph).trim();
+    if (!text) continue;
+    headings.push({ id: paragraph.id, level, text });
+  }
+  return headings;
+}
+function makeRun(partial) {
+  const run = createEditorRun(partial.text ?? "");
+  return { ...run, ...partial, id: run.id };
+}
+function makeParagraph(runs, style2) {
+  const paragraph = createEditorParagraph("");
+  paragraph.runs = runs;
+  if (style2) paragraph.style = style2;
+  return paragraph;
+}
+function buildEntryParagraph(heading, pageNumber, rightTabPositionPt) {
+  const pageLabel = pageNumber !== void 0 ? String(pageNumber) : "";
+  const run = makeRun({ text: `${heading.text}	${pageLabel}` });
+  const style2 = {
+    tabs: [{ position: rightTabPositionPt, type: "right", leader: "dot" }],
+    spacingAfter: twipsToPx(40),
+    indentLeft: twipsToPx((heading.level - 1) * 397)
+  };
+  return makeParagraph([run], style2);
+}
+function rightTabPositionForSection(section) {
+  const { width, margins } = section.pageSettings;
+  const contentWidthPx = Math.max(0, width - margins.left - margins.right);
+  return Math.round(contentWidthPx * PX_TO_PT * 100) / 100;
+}
+function buildStartMarkerParagraph() {
+  return makeParagraph([
+    makeRun({ text: "", fieldChar: { kind: "begin" } }),
+    makeRun({ text: "", fieldInstruction: TOC_INSTRUCTION }),
+    makeRun({ text: "", fieldChar: { kind: "separate" } })
+  ]);
+}
+function buildEndMarkerParagraph() {
+  return makeParagraph([makeRun({ text: "", fieldChar: { kind: "end" } })]);
+}
+function buildTocBlocks(headings, resolvePage, rightTabPositionPt) {
+  const entries = headings.map(
+    (heading) => buildEntryParagraph(heading, resolvePage(heading.id), rightTabPositionPt)
+  );
+  return [buildStartMarkerParagraph(), ...entries, buildEndMarkerParagraph()];
+}
+function replaceSectionBlocks(state, sectionIndex, nextBlocks, selectionParagraph) {
+  const sections = getDocumentSections(state.document);
+  const section = sections[sectionIndex];
+  if (!section) return state;
+  const nextSections = [...sections];
+  nextSections[sectionIndex] = { ...section, blocks: nextBlocks };
+  return {
+    ...state,
+    document: { ...state.document, sections: nextSections },
+    selection: withSelection(paragraphOffsetToPosition(selectionParagraph, 0))
+  };
+}
+function insertTableOfContents(state, resolvePage = () => void 0, maxLevel = DEFAULT_TOC_MAX_LEVEL) {
+  const zone = getActiveZone(state);
+  if (zone !== "main") return state;
+  const sectionIndex = getActiveSectionIndex(state);
+  const sections = getDocumentSections(state.document);
+  const section = sections[sectionIndex];
+  if (!section) return state;
+  const headings = collectTocHeadings(state, maxLevel);
+  const tocBlocks = buildTocBlocks(
+    headings,
+    resolvePage,
+    rightTabPositionForSection(section)
+  );
+  const focus = clampPosition(state, state.selection.focus);
+  const blockIndex = section.blocks.findIndex((block) => {
+    if (block.id === focus.paragraphId) return true;
+    if (block.type === "paragraph") return false;
+    return getBlockParagraphs(block).some((p) => p.id === focus.paragraphId);
+  });
+  const insertAt = blockIndex === -1 ? section.blocks.length : blockIndex + 1;
+  const nextBlocks = [
+    ...section.blocks.slice(0, insertAt),
+    ...tocBlocks,
+    ...section.blocks.slice(insertAt)
+  ];
+  return replaceSectionBlocks(state, sectionIndex, nextBlocks, tocBlocks[0]);
+}
+function findTocRegion(blocks) {
+  var _a, _b, _c;
+  let depth = 0;
+  let instruction = "";
+  let separateBlockIndex = -1;
+  let beginBlockIndex = -1;
+  let isToc = false;
+  for (let i = 0; i < blocks.length; i += 1) {
+    const block = blocks[i];
+    if (block.type !== "paragraph") continue;
+    for (const run of block.runs) {
+      if (((_a = run.fieldChar) == null ? void 0 : _a.kind) === "begin") {
+        depth += 1;
+        if (depth === 1) {
+          beginBlockIndex = i;
+          instruction = "";
+          isToc = false;
+          separateBlockIndex = -1;
+        }
+      } else if (depth === 1 && run.fieldInstruction !== void 0) {
+        instruction += run.fieldInstruction;
+        if (/\bTOC\b/i.test(instruction)) isToc = true;
+      } else if (((_b = run.fieldChar) == null ? void 0 : _b.kind) === "separate") {
+        if (depth === 1) separateBlockIndex = i;
+      } else if (((_c = run.fieldChar) == null ? void 0 : _c.kind) === "end") {
+        if (depth === 1) {
+          if (isToc) {
+            return {
+              startBlockIndex: separateBlockIndex >= 0 ? separateBlockIndex : beginBlockIndex,
+              endBlockIndex: i
+            };
+          }
+        }
+        depth = Math.max(0, depth - 1);
+      }
+    }
+  }
+  return null;
+}
+function updateTableOfContents(state, resolvePage = () => void 0, maxLevel = DEFAULT_TOC_MAX_LEVEL) {
+  const sectionIndex = getActiveSectionIndex(state);
+  const sections = getDocumentSections(state.document);
+  const section = sections[sectionIndex];
+  if (!section) return state;
+  const region = findTocRegion(section.blocks);
+  if (!region) return state;
+  const headings = collectTocHeadings(state, maxLevel);
+  const entries = headings.map(
+    (heading) => buildEntryParagraph(
+      heading,
+      resolvePage(heading.id),
+      rightTabPositionForSection(section)
+    )
+  );
+  const nextBlocks = [
+    ...section.blocks.slice(0, region.startBlockIndex + 1),
+    ...entries,
+    ...section.blocks.slice(region.endBlockIndex)
+  ];
+  const selectionParagraph = entries[0] ?? section.blocks[region.startBlockIndex];
+  return replaceSectionBlocks(
+    state,
+    sectionIndex,
+    nextBlocks,
+    selectionParagraph
+  );
+}
 function createCommandBuilder(isCommandEnabled) {
   return (name, execute, state) => ({
     execute,
@@ -41452,6 +41617,19 @@ function createEditorEssentialsRuntimePlugin(options) {
     undo: () => (options.historyActions.performUndo(), true),
     redo: () => (options.historyActions.performRedo(), true)
   };
+  const buildTocPageResolver = (state) => {
+    const layout = projectDocumentLayout(state.document);
+    const pageByParagraph = /* @__PURE__ */ new Map();
+    for (const page of layout.pages) {
+      for (const block of page.blocks) {
+        const paragraphId = block.paragraphId;
+        if (paragraphId && !pageByParagraph.has(paragraphId)) {
+          pageByParagraph.set(paragraphId, page.index + 1);
+        }
+      }
+    }
+    return (headingId) => pageByParagraph.get(headingId);
+  };
   const essentialsFormatting = {
     selectAll: () => {
       const paragraphs = getDocumentParagraphs(options.state().document);
@@ -41472,6 +41650,20 @@ function createEditorEssentialsRuntimePlugin(options) {
       return true;
     },
     insertFootnote: () => (options.commandsController.applyInsertFootnoteCommand(), true),
+    insertTableOfContents: () => {
+      options.applyTransactionalState(
+        (current) => insertTableOfContents(current, buildTocPageResolver(current))
+      );
+      options.focusInput();
+      return true;
+    },
+    updateTableOfContents: () => {
+      options.applyTransactionalState(
+        (current) => updateTableOfContents(current, buildTocPageResolver(current))
+      );
+      options.focusInput();
+      return true;
+    },
     pastePlainText: () => {
       options.forcePlainTextPaste.set(true);
       options.focusInput();

package/dist/core/commands/builtinCommands.d.ts

@@ -1,2 +1,2 @@
-export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "pastePlainText", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "insertTable"];
+export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "insertTable"];
 export type OasisBuiltinCommand = (typeof OASIS_BUILTIN_COMMANDS)[number];

package/dist/core/commands/tableOfContents.d.ts

@@ -0,0 +1,32 @@
+import { EditorState } from '../model.js';
+
+/** Default TOC scope: outline levels 1–3, matching Word's `TOC \o "1-3"`. */
+export declare const DEFAULT_TOC_MAX_LEVEL = 3;
+/** A heading captured for a TOC entry. */
+export interface TocHeading {
+    id: string;
+    level: number;
+    text: string;
+}
+/** Page number resolver: heading paragraph id → printed page number. */
+export type TocPageNumberResolver = (headingId: string) => number | undefined;
+/**
+ * Collect heading paragraphs (levels 1..maxLevel) in document order. Headings
+ * are detected case-insensitively via {@link getHeadingLevel}, so both the
+ * editor's own `heading1` and Word's imported `Heading1` styles qualify.
+ */
+export declare function collectTocHeadings(state: EditorState, maxLevel?: number): TocHeading[];
+/**
+ * Insert a generated table of contents after the block holding the caret.
+ * Operates on section blocks (not the flattened paragraph list) so it is safe
+ * in documents containing tables.
+ */
+export declare function insertTableOfContents(state: EditorState, resolvePage?: TocPageNumberResolver, maxLevel?: number): EditorState;
+/**
+ * Regenerate the entries of an existing TOC field from the current headings,
+ * preserving the field's begin/instruction/separate and end markers. Returns
+ * the unchanged state when no TOC field is present.
+ */
+export declare function updateTableOfContents(state: EditorState, resolvePage?: TocPageNumberResolver, maxLevel?: number): EditorState;
+/** Whether a TOC field exists in the active section (for menu enablement). */
+export declare function hasTableOfContents(state: EditorState): boolean;

package/dist/core/headings.d.ts

@@ -6,4 +6,12 @@ export interface OutlineItem {
     text: string;
     anchor: string;
 }
+/**
+ * Resolve the heading level (1-9) of a paragraph style id, or null if the style
+ * is not a heading. Case-insensitive and tolerant of an optional space, so it
+ * matches both the editor's own convention (`heading1`) and Word's imported
+ * style ids (`Heading1`, `Heading 1`). Keeping detection here means imported
+ * `styleId`s round-trip unchanged on export.
+ */
+export declare function getHeadingLevel(styleId: string | undefined): number | null;
 export declare function outlineFrom(doc: EditorDocument): OutlineItem[];

package/dist/i18n/locales/en.d.ts

@@ -412,6 +412,8 @@ export declare const en: {
     "menu.view.outline": string;
     "menu.view.fullscreen": string;
     "menu.insert": string;
+    "menu.insert.toc": string;
+    "menu.insert.updateToc": string;
     "menu.layout": string;
     "menu.format": string;
     "menu.format.align": string;

package/dist/i18n/locales/pt-BR.d.ts

@@ -412,6 +412,8 @@ export declare const ptBR: {
     "menu.view.outline": string;
     "menu.view.fullscreen": string;
     "menu.insert": string;
+    "menu.insert.toc": string;
+    "menu.insert.updateToc": string;
     "menu.layout": string;
     "menu.format": string;
     "menu.format.align": string;