oasis-editor 0.0.65 → 0.0.67

package/dist/core/Editor.d.ts

@@ -3,14 +3,23 @@ import { CommandRegistry } from './commands/CommandRegistry.js';
 import { PluginUiRegistry } from './plugins/PluginUiRegistry.js';
 import { OasisEditor, OasisPlugin } from './plugin.js';
 
-export interface EditorOptions {
+/**
+ * Options accepted by the synchronous `new Editor(...)` path. Plugins are
+ * deliberately absent: they need async initialization and so are only valid via
+ * {@link Editor.create}. Encoding that in the type (rather than a runtime throw)
+ * makes the precondition checkable at compile time (L1).
+ */
+export interface SynchronousEditorOptions {
     doc?: EditorDocument;
-    plugins?: OasisPlugin[];
     keymaps?: Array<{
         key: string;
         command: string;
     }>;
 }
+/** Options accepted by the async {@link Editor.create} path, which adds plugins. */
+export interface EditorCreateOptions extends SynchronousEditorOptions {
+    plugins?: OasisPlugin[];
+}
 export declare class Editor implements OasisEditor {
     private stateStore;
     private setState;
@@ -18,8 +27,8 @@ export declare class Editor implements OasisEditor {
     private listeners;
     readonly commands: CommandRegistry;
     readonly ui: PluginUiRegistry;
-    constructor(options?: EditorOptions);
-    static create(options?: EditorOptions): Promise<Editor>;
+    constructor(options?: SynchronousEditorOptions);
+    static create(options?: EditorCreateOptions): Promise<Editor>;
     private initializeState;
     get state(): EditorState;
     dispatch(updater: (state: EditorState) => EditorState): void;

package/dist/core/assertNever.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Exhaustiveness guard for discriminated-union dispatch. Put a call to this in
+ * the `default` arm of a `switch` over a union (e.g. `EditorBlockNode.type`):
+ * if a new variant is added, every visitor that forgot to handle it becomes a
+ * compile error here instead of silently falling through and dropping data.
+ *
+ * This is intentionally a tiny local helper, not a global visitor registry —
+ * each pipeline keeps its own dispatch but gains compile-time exhaustiveness
+ * (O2).
+ */
+export declare function assertNever(value: never, label?: string): never;

package/dist/{index-DhCqxHGZ.js → index-CH7dSKgO.js}

@@ -2483,7 +2483,7 @@ function OasisEditorAppLazy(props = {}) {
     onCleanup(() => {
       cancelled = true;
     });
-    import("./OasisEditorApp-Bp4TNPC7.js").then((m) => {
+    import("./OasisEditorApp-KBzB35kG.js").then((m) => {
       cancelled = true;
       setProgress(1);
       setTimeout(() => setApp(() => m.OasisEditorApp), 180);
@@ -3353,11 +3353,21 @@ function getDocumentSectionsCanonical(document2) {
 function getDocumentSections(document2) {
   return getDocumentSectionsCanonical(document2);
 }
+function assertNever(value, label = "value") {
+  const tag = value && typeof value === "object" && "type" in value ? value.type : value;
+  throw new Error(`Unhandled ${label}: ${String(tag)}`);
+}
 function getBlockParagraphs(block) {
-  if (block.type === "paragraph") {
-    return [block];
+  switch (block.type) {
+    case "paragraph":
+      return [block];
+    case "table":
+      return block.rows.flatMap(
+        (row) => row.cells.flatMap((cell) => cell.blocks)
+      );
+    default:
+      return assertNever(block, "block");
   }
-  return block.rows.flatMap((row) => row.cells.flatMap((cell) => cell.blocks));
 }
 function flattenSectionZone(blocks) {
   return blocks ? blocks.flatMap(getBlockParagraphs) : [];
@@ -3418,37 +3428,41 @@ class DocumentIndexBuilder {
   }
   indexBlock(block, blockIndex, ctx) {
     let paraIndex = ctx.startIndex;
-    if (block.type === "paragraph") {
-      this.recordParagraph(
-        block,
-        {
-          sectionIndex: ctx.sectionIndex,
-          zone: ctx.zone,
-          paragraphIndexInSection: paraIndex,
-          footnoteId: ctx.footnoteId
-        },
-        null
-      );
-      return paraIndex + 1;
-    }
-    block.rows.forEach((row, rowIndex) => {
-      row.cells.forEach((cell, cellIndex) => {
-        cell.blocks.forEach((cp, cpIndex) => {
-          this.recordParagraph(
-            cp,
-            {
-              sectionIndex: ctx.sectionIndex,
-              zone: ctx.zone,
-              paragraphIndexInSection: paraIndex,
-              footnoteId: ctx.footnoteId
-            },
-            { blockIndex, rowIndex, cellIndex, paragraphIndex: cpIndex }
-          );
-          paraIndex += 1;
+    switch (block.type) {
+      case "paragraph":
+        this.recordParagraph(
+          block,
+          {
+            sectionIndex: ctx.sectionIndex,
+            zone: ctx.zone,
+            paragraphIndexInSection: paraIndex,
+            footnoteId: ctx.footnoteId
+          },
+          null
+        );
+        return paraIndex + 1;
+      case "table":
+        block.rows.forEach((row, rowIndex) => {
+          row.cells.forEach((cell, cellIndex) => {
+            cell.blocks.forEach((cp, cpIndex) => {
+              this.recordParagraph(
+                cp,
+                {
+                  sectionIndex: ctx.sectionIndex,
+                  zone: ctx.zone,
+                  paragraphIndexInSection: paraIndex,
+                  footnoteId: ctx.footnoteId
+                },
+                { blockIndex, rowIndex, cellIndex, paragraphIndex: cpIndex }
+              );
+              paraIndex += 1;
+            });
+          });
         });
-      });
-    });
-    return paraIndex;
+        return paraIndex;
+      default:
+        return assertNever(block, "block");
+    }
   }
   recordParagraph(paragraph, location, tableLocation) {
     this.index.set(paragraph.id, { paragraph, location, tableLocation });
@@ -4450,20 +4464,13 @@ class Editor {
     __publicField(this, "listeners", /* @__PURE__ */ new Map());
     __publicField(this, "commands", new CommandRegistry());
     __publicField(this, "ui", new PluginUiRegistry());
-    if (options.plugins && options.plugins.length > 0) {
-      throw new Error(
-        "Editor plugins must be initialized with Editor.create(...)."
-      );
-    }
     this.initializeState(options);
     this.pluginCollection = new PluginCollection(this, []);
   }
   static async create(options = {}) {
-    const editor = new Editor({ ...options, plugins: [] });
-    editor.pluginCollection = new PluginCollection(
-      editor,
-      options.plugins ?? []
-    );
+    const { plugins = [], ...syncOptions } = options;
+    const editor = new Editor(syncOptions);
+    editor.pluginCollection = new PluginCollection(editor, plugins);
     await editor.pluginCollection.initializeAll();
     return editor;
   }
@@ -13685,11 +13692,16 @@ function projectColumnTrackLayout(context2) {
     if (track.blocks.length > 0 && (sourceBlock.type === "paragraph" ? getEffectiveParagraphStyle(sourceBlock, styles).pageBreakBefore : (_a = sourceBlock.style) == null ? void 0 : _a.pageBreakBefore)) {
       track.flush();
     }
-    if (sourceBlock.type === "paragraph") {
-      paginateParagraphBlock(track, params, sourceBlock, nextBlock, index);
-      continue;
+    switch (sourceBlock.type) {
+      case "paragraph":
+        paginateParagraphBlock(track, params, sourceBlock, nextBlock, index);
+        break;
+      case "table":
+        paginateTableBlock(track, params, sourceBlock, index);
+        break;
+      default:
+        assertNever(sourceBlock, "block");
     }
-    paginateTableBlock(track, params, sourceBlock, index);
   }
   return track.finalize();
 }
@@ -35580,7 +35592,7 @@ function importDocxInWorker(buffer, options = {}) {
     const worker = new Worker(
       new URL(
         /* @vite-ignore */
-        "" + new URL("assets/importDocxWorker-BWyqey19.js", import.meta.url).href,
+        "" + new URL("assets/importDocxWorker-Bn1fun73.js", import.meta.url).href,
         import.meta.url
       ),
       {
@@ -39916,192 +39928,193 @@ const OASIS_MENU_ITEMS = {
   formatListsNumbered: "format_lists_numbered"
 };
 export {
-  iterateEndnoteReferenceRuns as $,
-  createEffect as A,
-  onCleanup as B,
-  buildCanvasLayoutSnapshot as C,
-  on as D,
+  EMU_PER_PT as $,
+  createSignal as A,
+  createEffect as B,
+  onCleanup as C,
+  buildCanvasLayoutSnapshot as D,
   EMU_PER_PX as E,
-  onMount as F,
-  debounce as G,
-  unwrap as H,
-  getDocumentParagraphs as I,
-  createEditorTableCell as J,
-  createEditorTableRow as K,
-  createEditorTable as L,
-  getDocumentSectionsCanonical as M,
-  createEditorDocument as N,
-  getPageContentWidth as O,
+  on as F,
+  onMount as G,
+  debounce as H,
+  unwrap as I,
+  getDocumentParagraphs as J,
+  createEditorTableCell as K,
+  createEditorTableRow as L,
+  createEditorTable as M,
+  getDocumentSectionsCanonical as N,
+  createEditorDocument as O,
   PT_PER_PX as P,
-  getDocumentPageSettings as Q,
-  getTableCellContentWidthForParagraph as R,
-  resolveResizedDimensions as S,
-  resolveImageSrc as T,
-  resolveTextBoxRenderHeight as U,
-  TWIPS_PER_POINT as V,
-  PX_PER_INCH as W,
-  TWIPS_PER_INCH as X,
-  resolveEffectiveParagraphStyle as Y,
-  resolveEffectiveTextStyleForParagraph as Z,
-  EMU_PER_PT as _,
+  getPageContentWidth as Q,
+  getDocumentPageSettings as R,
+  getTableCellContentWidthForParagraph as S,
+  resolveResizedDimensions as T,
+  resolveImageSrc as U,
+  resolveTextBoxRenderHeight as V,
+  TWIPS_PER_POINT as W,
+  PX_PER_INCH as X,
+  TWIPS_PER_INCH as Y,
+  resolveEffectiveParagraphStyle as Z,
+  resolveEffectiveTextStyleForParagraph as _,
   getParagraphLength as a,
-  resolveCommandRef as a$,
-  imageContentTypeDefaults as a0,
-  JSZip as a1,
-  imageExtensionFromMime as a2,
-  pxToPt as a3,
-  resolveFloatingObjectRect as a4,
-  getTextBoxFloatingGeometry as a5,
-  getPresetPathSegments as a6,
-  projectBlocksLayout as a7,
-  buildListLabels as a8,
-  textStyleToFontSizePt as a9,
-  resolveImporterForFile as aA,
-  createEditorStateFromDocument as aB,
-  getDocumentParagraphsCanonical as aC,
-  getToolbarStyleState as aD,
-  STANDARD_FONT_SIZES_PT as aE,
-  fontSizePxToPt as aF,
-  probeLocalFontFamilies as aG,
-  createInitialEditorState as aH,
-  parseFontSizePtToPx as aI,
-  formatFontSizePt as aJ,
-  underlineStyleToCssDecorationStyle as aK,
-  listKindForTag as aL,
-  isParagraphTag as aM,
-  collectInlineRuns as aN,
-  parseParagraphStyle as aO,
-  getCachedCanvasImage as aP,
-  getHeadingLevel as aQ,
-  preciseFontModeVersion as aR,
-  isPreciseFontModeEnabled as aS,
-  togglePreciseFontMode as aT,
-  nextFontSizePt as aU,
-  previousFontSizePt as aV,
-  fontSizePtToPx as aW,
-  createDefaultToolbarPreset as aX,
-  MenuRegistry as aY,
-  createToolbarRegistry as aZ,
-  Editor as a_,
-  PX_PER_POINT as aa,
-  DEFAULT_FONT_SIZE_PX as ab,
-  isDoubleUnderlineStyle as ac,
-  isWavyUnderlineStyle as ad,
-  underlineStyleLineWidthPx as ae,
-  underlineStyleDashArray as af,
-  resolveListLabel as ag,
-  getListLabelInset as ah,
-  getAlignedListLabelInset as ai,
-  getParagraphBorderInsets as aj,
-  buildSegmentTable as ak,
-  buildCanvasTableLayout as al,
-  normalizeFamily as am,
-  ROBOTO_FONT_FILES as an,
-  loadFontAsset as ao,
-  OFFICE_COMPAT_FONT_FAMILIES as ap,
-  buildSfnt as aq,
-  defaultFontDecoderRegistry as ar,
-  SfntFontProgram as as,
-  collectPdfFontFamilies as at,
-  projectDocumentLayout as au,
-  getPageHeaderZoneTop as av,
-  getPageBodyTop as aw,
-  getPageColumnRects as ax,
-  findFootnoteReference as ay,
-  FOOTNOTE_MARKER_GUTTER_PX as az,
+  Editor as a$,
+  iterateEndnoteReferenceRuns as a0,
+  imageContentTypeDefaults as a1,
+  JSZip as a2,
+  imageExtensionFromMime as a3,
+  pxToPt as a4,
+  resolveFloatingObjectRect as a5,
+  getTextBoxFloatingGeometry as a6,
+  getPresetPathSegments as a7,
+  projectBlocksLayout as a8,
+  buildListLabels as a9,
+  FOOTNOTE_MARKER_GUTTER_PX as aA,
+  resolveImporterForFile as aB,
+  createEditorStateFromDocument as aC,
+  getDocumentParagraphsCanonical as aD,
+  getToolbarStyleState as aE,
+  STANDARD_FONT_SIZES_PT as aF,
+  fontSizePxToPt as aG,
+  probeLocalFontFamilies as aH,
+  createInitialEditorState as aI,
+  parseFontSizePtToPx as aJ,
+  formatFontSizePt as aK,
+  underlineStyleToCssDecorationStyle as aL,
+  listKindForTag as aM,
+  isParagraphTag as aN,
+  collectInlineRuns as aO,
+  parseParagraphStyle as aP,
+  getCachedCanvasImage as aQ,
+  getHeadingLevel as aR,
+  preciseFontModeVersion as aS,
+  isPreciseFontModeEnabled as aT,
+  togglePreciseFontMode as aU,
+  nextFontSizePt as aV,
+  previousFontSizePt as aW,
+  fontSizePtToPx as aX,
+  createDefaultToolbarPreset as aY,
+  MenuRegistry as aZ,
+  createToolbarRegistry as a_,
+  textStyleToFontSizePt as aa,
+  PX_PER_POINT as ab,
+  DEFAULT_FONT_SIZE_PX as ac,
+  isDoubleUnderlineStyle as ad,
+  isWavyUnderlineStyle as ae,
+  underlineStyleLineWidthPx as af,
+  underlineStyleDashArray as ag,
+  resolveListLabel as ah,
+  getListLabelInset as ai,
+  getAlignedListLabelInset as aj,
+  getParagraphBorderInsets as ak,
+  buildSegmentTable as al,
+  buildCanvasTableLayout as am,
+  normalizeFamily as an,
+  ROBOTO_FONT_FILES as ao,
+  loadFontAsset as ap,
+  OFFICE_COMPAT_FONT_FAMILIES as aq,
+  buildSfnt as ar,
+  defaultFontDecoderRegistry as as,
+  SfntFontProgram as at,
+  collectPdfFontFamilies as au,
+  projectDocumentLayout as av,
+  getPageHeaderZoneTop as aw,
+  getPageBodyTop as ax,
+  getPageColumnRects as ay,
+  findFootnoteReference as az,
   createEditorRun as b,
-  FloatingActionButton as b$,
-  commandRefName as b0,
-  InlineShell as b1,
-  BalloonShell as b2,
-  DocumentShell as b3,
-  createMemo as b4,
-  getCaretRectFromSnapshot as b5,
-  getParagraphRectFromSnapshot as b6,
-  createComponent as b7,
-  CaretOverlay as b8,
-  Show as b9,
-  PluginUiHost as bA,
-  OasisEditorEditor as bB,
-  perfTimer as bC,
-  OasisBrandMark as bD,
-  setPreciseFontPreference as bE,
-  setWelcomeSeen as bF,
-  enablePreciseFontMode as bG,
-  createOasisEditorClient as bH,
-  createEditorZoom as bI,
-  startLongTaskObserver as bJ,
-  installGlobalReport as bK,
-  applyStoredPreciseFontPreference as bL,
-  getWelcomeSeen as bM,
-  isLocalFontAccessSupported as bN,
-  EDITOR_SCROLL_PADDING_PX as bO,
-  Toolbar as bP,
-  OasisEditorLoading as bQ,
-  I18nProvider as bR,
-  createEditorLogger as bS,
-  createTranslator as bT,
-  registerDomStatsSurface as bU,
-  Button as bV,
-  Checkbox as bW,
-  ColorPicker as bX,
-  CommandRegistry as bY,
-  DEFAULT_PALETTE as bZ,
-  DialogFooter as b_,
-  createRenderEffect as ba,
-  style as bb,
-  setAttribute as bc,
-  setStyleProperty as bd,
-  memo as be,
-  template as bf,
-  useI18n as bg,
-  insert as bh,
-  use as bi,
-  addEventListener as bj,
-  Dialog as bk,
-  delegateEvents as bl,
-  className as bm,
-  For as bn,
-  UNDERLINE_STYLE_OPTIONS as bo,
-  Tabs as bp,
-  measureParagraphMinContentWidthPx as bq,
-  getEditableBlocksForZone as br,
-  findParagraphLocation as bs,
-  createSectionBoundaryParagraph as bt,
-  normalizePageSettings as bu,
-  DEFAULT_EDITOR_PAGE_SETTINGS as bv,
-  markStart as bw,
-  markEnd as bx,
-  getParagraphEntries as by,
-  getParagraphById as bz,
+  DialogFooter as b$,
+  resolveCommandRef as b0,
+  commandRefName as b1,
+  InlineShell as b2,
+  BalloonShell as b3,
+  DocumentShell as b4,
+  createMemo as b5,
+  getCaretRectFromSnapshot as b6,
+  getParagraphRectFromSnapshot as b7,
+  createComponent as b8,
+  CaretOverlay as b9,
+  getParagraphById as bA,
+  PluginUiHost as bB,
+  OasisEditorEditor as bC,
+  perfTimer as bD,
+  OasisBrandMark as bE,
+  setPreciseFontPreference as bF,
+  setWelcomeSeen as bG,
+  enablePreciseFontMode as bH,
+  createOasisEditorClient as bI,
+  createEditorZoom as bJ,
+  startLongTaskObserver as bK,
+  installGlobalReport as bL,
+  applyStoredPreciseFontPreference as bM,
+  getWelcomeSeen as bN,
+  isLocalFontAccessSupported as bO,
+  EDITOR_SCROLL_PADDING_PX as bP,
+  Toolbar as bQ,
+  OasisEditorLoading as bR,
+  I18nProvider as bS,
+  createEditorLogger as bT,
+  createTranslator as bU,
+  registerDomStatsSurface as bV,
+  Button as bW,
+  Checkbox as bX,
+  ColorPicker as bY,
+  CommandRegistry as bZ,
+  DEFAULT_PALETTE as b_,
+  Show as ba,
+  createRenderEffect as bb,
+  style as bc,
+  setAttribute as bd,
+  setStyleProperty as be,
+  memo as bf,
+  template as bg,
+  useI18n as bh,
+  insert as bi,
+  use as bj,
+  addEventListener as bk,
+  Dialog as bl,
+  delegateEvents as bm,
+  className as bn,
+  For as bo,
+  UNDERLINE_STYLE_OPTIONS as bp,
+  Tabs as bq,
+  measureParagraphMinContentWidthPx as br,
+  getEditableBlocksForZone as bs,
+  findParagraphLocation as bt,
+  createSectionBoundaryParagraph as bu,
+  normalizePageSettings as bv,
+  DEFAULT_EDITOR_PAGE_SETTINGS as bw,
+  markStart as bx,
+  markEnd as by,
+  getParagraphEntries as bz,
   createEditorParagraphFromRuns as c,
-  GridPicker as c0,
-  IconButton as c1,
-  Menu as c2,
-  OASIS_BUILTIN_COMMANDS as c3,
-  OASIS_MENU_ITEMS as c4,
-  OASIS_TOOLBAR_ITEMS as c5,
-  OasisEditorAppLazy as c6,
-  OasisEditorContainer as c7,
-  PluginCollection as c8,
-  Popover as c9,
-  RIBBON_TABS as ca,
-  Select as cb,
-  SelectField as cc,
-  Separator as cd,
-  SidePanel as ce,
-  SidePanelBody as cf,
-  SidePanelFooter as cg,
-  SidePanelHeader as ch,
-  SplitButton as ci,
-  TextField as cj,
-  Button$1 as ck,
-  buildRibbonTabDefinitions as cl,
-  createEditorCommandBus as cm,
-  createOasisEditor as cn,
-  createOasisEditorContainer as co,
-  mount as cp,
-  registerToolbarRenderer as cq,
+  FloatingActionButton as c0,
+  GridPicker as c1,
+  IconButton as c2,
+  Menu as c3,
+  OASIS_BUILTIN_COMMANDS as c4,
+  OASIS_MENU_ITEMS as c5,
+  OASIS_TOOLBAR_ITEMS as c6,
+  OasisEditorAppLazy as c7,
+  OasisEditorContainer as c8,
+  PluginCollection as c9,
+  Popover as ca,
+  RIBBON_TABS as cb,
+  Select as cc,
+  SelectField as cd,
+  Separator as ce,
+  SidePanel as cf,
+  SidePanelBody as cg,
+  SidePanelFooter as ch,
+  SidePanelHeader as ci,
+  SplitButton as cj,
+  TextField as ck,
+  Button$1 as cl,
+  buildRibbonTabDefinitions as cm,
+  createEditorCommandBus as cn,
+  createOasisEditor as co,
+  createOasisEditorContainer as cp,
+  mount as cq,
+  registerToolbarRenderer as cr,
   getDocumentSections as d,
   createEditorStyledRun as e,
   getParagraphText as f,
@@ -40115,14 +40128,14 @@ export {
   normalizeSelection as n,
   isSelectionCollapsed as o,
   positionToParagraphOffset as p,
-  createEditorParagraph as q,
-  getBlockParagraphs as r,
-  createEditorFootnote as s,
-  createFootnoteReferenceRun as t,
-  renumberFootnotes as u,
-  iterateFootnoteReferenceRuns as v,
-  getFootnoteDisplayMarker as w,
-  findParagraphTableLocation as x,
-  buildTableCellLayout as y,
-  createSignal as z
+  assertNever as q,
+  createEditorParagraph as r,
+  getBlockParagraphs as s,
+  createEditorFootnote as t,
+  createFootnoteReferenceRun as u,
+  renumberFootnotes as v,
+  iterateFootnoteReferenceRuns as w,
+  getFootnoteDisplayMarker as x,
+  findParagraphTableLocation as y,
+  buildTableCellLayout as z
 };